From c61784411988d36d9bbd93cd3a97e773990af342 Mon Sep 17 00:00:00 2001 From: yehudah Date: Mon, 25 Nov 2019 08:22:35 +0000 Subject: Adding a folder --- Postman/Phpmailer/PostsmtpMailer.php | 125 + .../PostmanAbstractAuthenticationManager.php | 171 + .../Postman-Auth/PostmanAuthenticationManager.php | 18 + .../PostmanAuthenticationManagerFactory.php | 58 + .../PostmanGoogleAuthenticationManager.php | 122 + .../PostmanMicrosoftAuthenticationManager.php | 107 + .../PostmanNonOAuthAuthenticationManager.php | 46 + .../PostmanStateIdMissingException.php | 8 + .../PostmanYahooAuthenticationManager.php | 136 + .../PostmanConfigurationController.php | 948 +++ .../PostmanImportableConfiguration.php | 580 ++ .../PostmanRegisterConfigurationSettings.php | 535 ++ .../Postman-Configuration/PostmanSmtpDiscovery.php | 237 + .../Postman-Configuration/postman_manual_config.js | 104 + Postman/Postman-Configuration/postman_wizard.js | 599 ++ .../Postman-Connectivity-Test/Postman-PortTest.php | 286 + .../PostmanConnectivityTestController.php | 336 + .../Postman-Connectivity-Test/postman_port_test.js | 336 + .../PHP/effectiveTLDs.inc.php | 6484 ++++++++++++++++++++ .../PHP/regDomain.class.php | 120 + .../PHP/regDomain.inc.php | 62 + .../PHP/test-regDomain.php | 51 + .../registered-domain-libs-master/README.txt | 56 + .../generateEffectiveTLDs.php | 213 + Postman/Postman-Controller/PostmanAdminPointer.php | 111 + .../PostmanDashboardWidgetController.php | 161 + .../PostmanManageConfigurationAjaxHandler.php | 59 + .../PostmanWelcomeController.php | 222 + .../PostmanDiagnosticTestController.php | 288 + .../Postman-Diagnostic-Test/postman_diagnostics.js | 19 + .../PostmanEmailLogController.php | 480 ++ .../Postman-Email-Log/PostmanEmailLogPostType.php | 51 + .../Postman-Email-Log/PostmanEmailLogService.php | 359 ++ Postman/Postman-Email-Log/PostmanEmailLogView.php | 462 ++ Postman/Postman-Mail/PostmanContactForm7.php | 42 + .../Postman-Mail/PostmanDefaultModuleTransport.php | 166 + Postman/Postman-Mail/PostmanEmailAddress.php | 95 + .../PostmanGmailApiModuleTransport.php | 261 + .../PostmanGmailApiModuleZendMailTransport.php | 278 + Postman/Postman-Mail/PostmanMailEngine.php | 14 + Postman/Postman-Mail/PostmanMailgunMailEngine.php | 271 + Postman/Postman-Mail/PostmanMailgunTransport.php | 267 + Postman/Postman-Mail/PostmanMandrillMailEngine.php | 238 + Postman/Postman-Mail/PostmanMandrillTransport.php | 280 + Postman/Postman-Mail/PostmanMessage.php | 824 +++ Postman/Postman-Mail/PostmanModuleTransport.php | 758 +++ Postman/Postman-Mail/PostmanMyMailConnector.php | 223 + Postman/Postman-Mail/PostmanSendGridMailEngine.php | 259 + Postman/Postman-Mail/PostmanSendGridTransport.php | 231 + .../Postman-Mail/PostmanSmtpModuleTransport.php | 594 ++ Postman/Postman-Mail/PostmanTransportRegistry.php | 253 + Postman/Postman-Mail/PostmanWooCommerce.php | 152 + Postman/Postman-Mail/PostmanZendMailEngine.php | 249 + ...ostmanZendMailTransportConfigurationFactory.php | 133 + Postman/Postman-Mail/Zend-1.12.10/Exception.php | 96 + Postman/Postman-Mail/Zend-1.12.10/Loader.php | 343 ++ .../Zend-1.12.10/Loader/Autoloader.php | 589 ++ Postman/Postman-Mail/Zend-1.12.10/Mail.php | 1291 ++++ .../Postman-Mail/Zend-1.12.10/Mail/Exception.php | 37 + Postman/Postman-Mail/Zend-1.12.10/Mail/Message.php | 112 + .../Zend-1.12.10/Mail/Message/File.php | 96 + .../Zend-1.12.10/Mail/Message/Interface.php | 55 + .../Postman-Mail/Zend-1.12.10/Mail/Part/File.php | 198 + .../Zend-1.12.10/Mail/Part/Interface.php | 136 + .../Zend-1.12.10/Mail/Protocol/Abstract.php | 453 ++ .../Zend-1.12.10/Mail/Protocol/Exception.php | 39 + .../Zend-1.12.10/Mail/Protocol/Imap.php | 838 +++ .../Zend-1.12.10/Mail/Protocol/Pop3.php | 472 ++ .../Zend-1.12.10/Mail/Protocol/Smtp.php | 467 ++ .../Mail/Protocol/Smtp/Auth/Crammd5.php | 108 + .../Zend-1.12.10/Mail/Protocol/Smtp/Auth/Login.php | 98 + .../Mail/Protocol/Smtp/Auth/Oauth2.php | 78 + .../Zend-1.12.10/Mail/Protocol/Smtp/Auth/Plain.php | 96 + Postman/Postman-Mail/Zend-1.12.10/Mail/Storage.php | 39 + .../Zend-1.12.10/Mail/Storage/Abstract.php | 366 ++ .../Zend-1.12.10/Mail/Storage/Exception.php | 39 + .../Zend-1.12.10/Mail/Storage/Folder.php | 236 + .../Zend-1.12.10/Mail/Storage/Folder/Interface.php | 60 + .../Zend-1.12.10/Mail/Storage/Folder/Maildir.php | 265 + .../Zend-1.12.10/Mail/Storage/Folder/Mbox.php | 264 + .../Zend-1.12.10/Mail/Storage/Imap.php | 644 ++ .../Zend-1.12.10/Mail/Storage/Maildir.php | 475 ++ .../Zend-1.12.10/Mail/Storage/Mbox.php | 447 ++ .../Zend-1.12.10/Mail/Storage/Pop3.php | 328 + .../Mail/Storage/Writable/Interface.php | 108 + .../Zend-1.12.10/Mail/Storage/Writable/Maildir.php | 1049 ++++ .../Zend-1.12.10/Mail/Transport/Abstract.php | 350 ++ .../Zend-1.12.10/Mail/Transport/Exception.php | 39 + .../Zend-1.12.10/Mail/Transport/File.php | 134 + .../Zend-1.12.10/Mail/Transport/Sendmail.php | 220 + .../Zend-1.12.10/Mail/Transport/Smtp.php | 247 + Postman/Postman-Mail/Zend-1.12.10/Mime.php | 670 ++ Postman/Postman-Mail/Zend-1.12.10/Mime/Decode.php | 276 + .../Postman-Mail/Zend-1.12.10/Mime/Exception.php | 36 + Postman/Postman-Mail/Zend-1.12.10/Mime/Message.php | 305 + Postman/Postman-Mail/Zend-1.12.10/Mime/Part.php | 333 + Postman/Postman-Mail/Zend-1.12.10/Registry.php | 209 + Postman/Postman-Mail/Zend-1.12.10/Validate.php | 290 + .../Zend-1.12.10/Validate/Abstract.php | 483 ++ .../Postman-Mail/Zend-1.12.10/Validate/Alnum.php | 149 + .../Postman-Mail/Zend-1.12.10/Validate/Alpha.php | 149 + .../Postman-Mail/Zend-1.12.10/Validate/Barcode.php | 227 + .../Postman-Mail/Zend-1.12.10/Validate/Between.php | 224 + .../Zend-1.12.10/Validate/Callback.php | 173 + .../Postman-Mail/Zend-1.12.10/Validate/Ccnum.php | 112 + .../Zend-1.12.10/Validate/CreditCard.php | 319 + .../Postman-Mail/Zend-1.12.10/Validate/Date.php | 258 + .../Postman-Mail/Zend-1.12.10/Validate/Digits.php | 91 + .../Zend-1.12.10/Validate/EmailAddress.php | 574 ++ .../Zend-1.12.10/Validate/Exception.php | 34 + .../Postman-Mail/Zend-1.12.10/Validate/Float.php | 135 + .../Zend-1.12.10/Validate/GreaterThan.php | 124 + Postman/Postman-Mail/Zend-1.12.10/Validate/Hex.php | 72 + .../Zend-1.12.10/Validate/Hostname.php | 2359 +++++++ .../Zend-1.12.10/Validate/Hostname/Biz.php | 2917 +++++++++ .../Zend-1.12.10/Validate/Hostname/Cn.php | 2199 +++++++ .../Zend-1.12.10/Validate/Hostname/Com.php | 196 + .../Zend-1.12.10/Validate/Hostname/Jp.php | 739 +++ .../Postman-Mail/Zend-1.12.10/Validate/Iban.php | 250 + .../Zend-1.12.10/Validate/Identical.php | 164 + .../Postman-Mail/Zend-1.12.10/Validate/InArray.php | 204 + Postman/Postman-Mail/Zend-1.12.10/Validate/Int.php | 149 + .../Zend-1.12.10/Validate/Interface.php | 54 + Postman/Postman-Mail/Zend-1.12.10/Validate/Ip.php | 192 + .../Postman-Mail/Zend-1.12.10/Validate/Isbn.php | 278 + .../Zend-1.12.10/Validate/LessThan.php | 122 + .../Zend-1.12.10/Validate/NotEmpty.php | 279 + .../Zend-1.12.10/Validate/PostCode.php | 210 + .../Postman-Mail/Zend-1.12.10/Validate/Regex.php | 146 + .../Zend-1.12.10/Validate/StringLength.php | 263 + .../Postman-Mail/google-api-client/composer.json | 5 + .../Postman-Mail/google-api-client/composer.lock | 702 +++ .../google-api-client/vendor/autoload.php | 7 + .../vendor/composer/ClassLoader.php | 413 ++ .../google-api-client/vendor/composer/LICENSE | 433 ++ .../vendor/composer/autoload_classmap.php | 11 + .../vendor/composer/autoload_files.php | 13 + .../vendor/composer/autoload_namespaces.php | 11 + .../vendor/composer/autoload_psr4.php | 19 + .../vendor/composer/autoload_real.php | 59 + .../vendor/composer/installed.json | 709 +++ .../vendor/google/apiclient-services/.travis.yml | 15 + .../google/apiclient-services/CONTRIBUTING.md | 22 + .../vendor/google/apiclient-services/LICENSE | 203 + .../vendor/google/apiclient-services/README.md | 30 + .../vendor/google/apiclient-services/composer.json | 19 + .../vendor/google/apiclient-services/phpunit.xml | 11 + .../src/Google/Service/Gmail.php | 1136 ++++ .../src/Google/Service/Gmail/AutoForwarding.php | 48 + .../Service/Gmail/BatchDeleteMessagesRequest.php | 31 + .../Service/Gmail/BatchModifyMessagesRequest.php | 49 + .../src/Google/Service/Gmail/Draft.php | 46 + .../src/Google/Service/Gmail/Filter.php | 62 + .../src/Google/Service/Gmail/FilterAction.php | 49 + .../src/Google/Service/Gmail/FilterCriteria.php | 102 + .../src/Google/Service/Gmail/ForwardingAddress.php | 39 + .../src/Google/Service/Gmail/History.php | 111 + .../src/Google/Service/Gmail/HistoryLabelAdded.php | 47 + .../Google/Service/Gmail/HistoryLabelRemoved.php | 47 + .../Google/Service/Gmail/HistoryMessageAdded.php | 37 + .../Google/Service/Gmail/HistoryMessageDeleted.php | 37 + .../src/Google/Service/Gmail/ImapSettings.php | 57 + .../src/Google/Service/Gmail/Label.php | 118 + .../src/Google/Service/Gmail/LabelColor.php | 39 + .../Google/Service/Gmail/ListDraftsResponse.php | 56 + .../Google/Service/Gmail/ListFiltersResponse.php | 38 + .../Gmail/ListForwardingAddressesResponse.php | 38 + .../Google/Service/Gmail/ListHistoryResponse.php | 56 + .../Google/Service/Gmail/ListLabelsResponse.php | 38 + .../Google/Service/Gmail/ListMessagesResponse.php | 56 + .../Google/Service/Gmail/ListSendAsResponse.php | 38 + .../Google/Service/Gmail/ListSmimeInfoResponse.php | 38 + .../Google/Service/Gmail/ListThreadsResponse.php | 56 + .../src/Google/Service/Gmail/Message.php | 110 + .../src/Google/Service/Gmail/MessagePart.php | 97 + .../src/Google/Service/Gmail/MessagePartBody.php | 48 + .../src/Google/Service/Gmail/MessagePartHeader.php | 39 + .../Google/Service/Gmail/ModifyMessageRequest.php | 40 + .../Google/Service/Gmail/ModifyThreadRequest.php | 40 + .../src/Google/Service/Gmail/PopSettings.php | 39 + .../src/Google/Service/Gmail/Profile.php | 57 + .../src/Google/Service/Gmail/Resource/Users.php | 71 + .../Google/Service/Gmail/Resource/UsersDrafts.php | 130 + .../Google/Service/Gmail/Resource/UsersHistory.php | 61 + .../Google/Service/Gmail/Resource/UsersLabels.php | 120 + .../Service/Gmail/Resource/UsersMessages.php | 229 + .../Gmail/Resource/UsersMessagesAttachments.php | 44 + .../Service/Gmail/Resource/UsersSettings.php | 149 + .../Gmail/Resource/UsersSettingsFilters.php | 86 + .../Resource/UsersSettingsForwardingAddresses.php | 97 + .../Service/Gmail/Resource/UsersSettingsSendAs.php | 162 + .../Resource/UsersSettingsSendAsSmimeInfo.php | 115 + .../Google/Service/Gmail/Resource/UsersThreads.php | 135 + .../src/Google/Service/Gmail/SendAs.php | 109 + .../src/Google/Service/Gmail/SmimeInfo.php | 84 + .../src/Google/Service/Gmail/SmtpMsa.php | 66 + .../src/Google/Service/Gmail/Thread.php | 65 + .../src/Google/Service/Gmail/VacationSettings.php | 93 + .../src/Google/Service/Gmail/WatchRequest.php | 49 + .../src/Google/Service/Gmail/WatchResponse.php | 39 + .../vendor/google/apiclient/.gitattributes | 9 + .../vendor/google/apiclient/LICENSE | 203 + .../vendor/google/apiclient/README.md | 368 ++ .../vendor/google/apiclient/composer.json | 41 + .../apiclient/src/Google/AccessToken/Revoke.php | 78 + .../apiclient/src/Google/AccessToken/Verify.php | 272 + .../src/Google/AuthHandler/AuthHandlerFactory.php | 42 + .../src/Google/AuthHandler/Guzzle5AuthHandler.php | 99 + .../src/Google/AuthHandler/Guzzle6AuthHandler.php | 106 + .../vendor/google/apiclient/src/Google/Client.php | 1118 ++++ .../google/apiclient/src/Google/Collection.php | 100 + .../google/apiclient/src/Google/Exception.php | 20 + .../google/apiclient/src/Google/Http/Batch.php | 249 + .../apiclient/src/Google/Http/MediaFileUpload.php | 351 ++ .../google/apiclient/src/Google/Http/REST.php | 182 + .../vendor/google/apiclient/src/Google/Model.php | 317 + .../vendor/google/apiclient/src/Google/Service.php | 56 + .../apiclient/src/Google/Service/Exception.php | 68 + .../google/apiclient/src/Google/Service/README.md | 5 + .../apiclient/src/Google/Service/Resource.php | 296 + .../google/apiclient/src/Google/Task/Exception.php | 20 + .../google/apiclient/src/Google/Task/Retryable.php | 24 + .../google/apiclient/src/Google/Task/Runner.php | 281 + .../apiclient/src/Google/Utils/UriTemplate.php | 333 + .../google/apiclient/src/Google/autoload.php | 21 + .../vendor/google/auth/.editorconfig | 18 + .../google-api-client/vendor/google/auth/.php_cs | 54 + .../vendor/google/auth/.travis.yml | 32 + .../google-api-client/vendor/google/auth/COPYING | 202 + .../google-api-client/vendor/google/auth/LICENSE | 203 + .../google-api-client/vendor/google/auth/README.md | 150 + .../vendor/google/auth/autoload.php | 34 + .../vendor/google/auth/composer.json | 27 + .../auth/src/ApplicationDefaultCredentials.php | 173 + .../auth/src/Cache/InvalidArgumentException.php | 24 + .../vendor/google/auth/src/Cache/Item.php | 185 + .../google/auth/src/Cache/MemoryCacheItemPool.php | 154 + .../vendor/google/auth/src/CacheTrait.php | 83 + .../src/Credentials/AppIdentityCredentials.php | 159 + .../google/auth/src/Credentials/GCECredentials.php | 219 + .../google/auth/src/Credentials/IAMCredentials.php | 89 + .../src/Credentials/ServiceAccountCredentials.php | 177 + .../ServiceAccountJwtAccessCredentials.php | 131 + .../src/Credentials/UserRefreshCredentials.php | 110 + .../vendor/google/auth/src/CredentialsLoader.php | 210 + .../vendor/google/auth/src/FetchAuthTokenCache.php | 108 + .../google/auth/src/FetchAuthTokenInterface.php | 55 + .../auth/src/HttpHandler/Guzzle5HttpHandler.php | 128 + .../auth/src/HttpHandler/Guzzle6HttpHandler.php | 49 + .../auth/src/HttpHandler/HttpHandlerFactory.php | 47 + .../auth/src/Middleware/AuthTokenMiddleware.php | 126 + .../src/Middleware/ScopedAccessTokenMiddleware.php | 175 + .../auth/src/Middleware/SimpleMiddleware.php | 93 + .../vendor/google/auth/src/OAuth2.php | 1335 ++++ .../auth/src/Subscriber/AuthTokenSubscriber.php | 118 + .../src/Subscriber/ScopedAccessTokenSubscriber.php | 177 + .../auth/src/Subscriber/SimpleSubscriber.php | 90 + .../vendor/guzzlehttp/guzzle/CHANGELOG.md | 1264 ++++ .../vendor/guzzlehttp/guzzle/LICENSE | 19 + .../vendor/guzzlehttp/guzzle/README.md | 89 + .../vendor/guzzlehttp/guzzle/UPGRADING.md | 1203 ++++ .../vendor/guzzlehttp/guzzle/composer.json | 44 + .../vendor/guzzlehttp/guzzle/src/Client.php | 414 ++ .../guzzlehttp/guzzle/src/ClientInterface.php | 84 + .../guzzlehttp/guzzle/src/Cookie/CookieJar.php | 314 + .../guzzle/src/Cookie/CookieJarInterface.php | 84 + .../guzzlehttp/guzzle/src/Cookie/FileCookieJar.php | 90 + .../guzzle/src/Cookie/SessionCookieJar.php | 71 + .../guzzlehttp/guzzle/src/Cookie/SetCookie.php | 404 ++ .../guzzle/src/Exception/BadResponseException.php | 27 + .../guzzle/src/Exception/ClientException.php | 7 + .../guzzle/src/Exception/ConnectException.php | 37 + .../guzzle/src/Exception/GuzzleException.php | 4 + .../guzzle/src/Exception/RequestException.php | 217 + .../guzzle/src/Exception/SeekException.php | 27 + .../guzzle/src/Exception/ServerException.php | 7 + .../src/Exception/TooManyRedirectsException.php | 4 + .../guzzle/src/Exception/TransferException.php | 4 + .../guzzlehttp/guzzle/src/Handler/CurlFactory.php | 559 ++ .../guzzle/src/Handler/CurlFactoryInterface.php | 27 + .../guzzlehttp/guzzle/src/Handler/CurlHandler.php | 45 + .../guzzle/src/Handler/CurlMultiHandler.php | 197 + .../guzzlehttp/guzzle/src/Handler/EasyHandle.php | 92 + .../guzzlehttp/guzzle/src/Handler/MockHandler.php | 189 + .../vendor/guzzlehttp/guzzle/src/Handler/Proxy.php | 55 + .../guzzle/src/Handler/StreamHandler.php | 533 ++ .../vendor/guzzlehttp/guzzle/src/HandlerStack.php | 273 + .../guzzlehttp/guzzle/src/MessageFormatter.php | 182 + .../vendor/guzzlehttp/guzzle/src/Middleware.php | 254 + .../vendor/guzzlehttp/guzzle/src/Pool.php | 123 + .../guzzle/src/PrepareBodyMiddleware.php | 106 + .../guzzlehttp/guzzle/src/RedirectMiddleware.php | 237 + .../guzzlehttp/guzzle/src/RequestOptions.php | 255 + .../guzzlehttp/guzzle/src/RetryMiddleware.php | 112 + .../vendor/guzzlehttp/guzzle/src/TransferStats.php | 126 + .../vendor/guzzlehttp/guzzle/src/UriTemplate.php | 241 + .../vendor/guzzlehttp/guzzle/src/functions.php | 331 + .../guzzlehttp/guzzle/src/functions_include.php | 6 + .../vendor/guzzlehttp/promises/CHANGELOG.md | 65 + .../vendor/guzzlehttp/promises/LICENSE | 19 + .../vendor/guzzlehttp/promises/Makefile | 13 + .../vendor/guzzlehttp/promises/README.md | 504 ++ .../vendor/guzzlehttp/promises/composer.json | 34 + .../guzzlehttp/promises/src/AggregateException.php | 16 + .../promises/src/CancellationException.php | 9 + .../vendor/guzzlehttp/promises/src/Coroutine.php | 151 + .../vendor/guzzlehttp/promises/src/EachPromise.php | 229 + .../guzzlehttp/promises/src/FulfilledPromise.php | 82 + .../vendor/guzzlehttp/promises/src/Promise.php | 280 + .../guzzlehttp/promises/src/PromiseInterface.php | 93 + .../guzzlehttp/promises/src/PromisorInterface.php | 15 + .../guzzlehttp/promises/src/RejectedPromise.php | 87 + .../guzzlehttp/promises/src/RejectionException.php | 47 + .../vendor/guzzlehttp/promises/src/TaskQueue.php | 66 + .../guzzlehttp/promises/src/TaskQueueInterface.php | 25 + .../vendor/guzzlehttp/promises/src/functions.php | 457 ++ .../guzzlehttp/promises/src/functions_include.php | 6 + .../vendor/guzzlehttp/psr7/CHANGELOG.md | 110 + .../vendor/guzzlehttp/psr7/LICENSE | 19 + .../vendor/guzzlehttp/psr7/README.md | 739 +++ .../vendor/guzzlehttp/psr7/composer.json | 39 + .../vendor/guzzlehttp/psr7/src/AppendStream.php | 233 + .../vendor/guzzlehttp/psr7/src/BufferStream.php | 137 + .../vendor/guzzlehttp/psr7/src/CachingStream.php | 138 + .../vendor/guzzlehttp/psr7/src/DroppingStream.php | 42 + .../vendor/guzzlehttp/psr7/src/FnStream.php | 149 + .../vendor/guzzlehttp/psr7/src/InflateStream.php | 52 + .../vendor/guzzlehttp/psr7/src/LazyOpenStream.php | 39 + .../vendor/guzzlehttp/psr7/src/LimitStream.php | 155 + .../vendor/guzzlehttp/psr7/src/MessageTrait.php | 183 + .../vendor/guzzlehttp/psr7/src/MultipartStream.php | 153 + .../vendor/guzzlehttp/psr7/src/NoSeekStream.php | 22 + .../vendor/guzzlehttp/psr7/src/PumpStream.php | 165 + .../vendor/guzzlehttp/psr7/src/Request.php | 142 + .../vendor/guzzlehttp/psr7/src/Response.php | 132 + .../vendor/guzzlehttp/psr7/src/ServerRequest.php | 358 ++ .../vendor/guzzlehttp/psr7/src/Stream.php | 257 + .../guzzlehttp/psr7/src/StreamDecoratorTrait.php | 149 + .../vendor/guzzlehttp/psr7/src/StreamWrapper.php | 121 + .../vendor/guzzlehttp/psr7/src/UploadedFile.php | 316 + .../vendor/guzzlehttp/psr7/src/Uri.php | 702 +++ .../vendor/guzzlehttp/psr7/src/UriNormalizer.php | 216 + .../vendor/guzzlehttp/psr7/src/UriResolver.php | 219 + .../vendor/guzzlehttp/psr7/src/functions.php | 828 +++ .../guzzlehttp/psr7/src/functions_include.php | 6 + .../vendor/monolog/monolog/.php_cs | 59 + .../vendor/monolog/monolog/LICENSE | 19 + .../vendor/monolog/monolog/composer.json | 66 + .../monolog/monolog/src/Monolog/ErrorHandler.php | 230 + .../src/Monolog/Formatter/ChromePHPFormatter.php | 78 + .../src/Monolog/Formatter/ElasticaFormatter.php | 89 + .../src/Monolog/Formatter/FlowdockFormatter.php | 116 + .../src/Monolog/Formatter/FluentdFormatter.php | 85 + .../src/Monolog/Formatter/FormatterInterface.php | 36 + .../src/Monolog/Formatter/GelfMessageFormatter.php | 138 + .../src/Monolog/Formatter/HtmlFormatter.php | 141 + .../src/Monolog/Formatter/JsonFormatter.php | 208 + .../src/Monolog/Formatter/LineFormatter.php | 179 + .../src/Monolog/Formatter/LogglyFormatter.php | 47 + .../src/Monolog/Formatter/LogstashFormatter.php | 166 + .../src/Monolog/Formatter/MongoDBFormatter.php | 105 + .../src/Monolog/Formatter/NormalizerFormatter.php | 297 + .../src/Monolog/Formatter/ScalarFormatter.php | 48 + .../src/Monolog/Formatter/WildfireFormatter.php | 113 + .../src/Monolog/Handler/AbstractHandler.php | 186 + .../Monolog/Handler/AbstractProcessingHandler.php | 66 + .../src/Monolog/Handler/AbstractSyslogHandler.php | 101 + .../monolog/src/Monolog/Handler/AmqpHandler.php | 148 + .../src/Monolog/Handler/BrowserConsoleHandler.php | 230 + .../monolog/src/Monolog/Handler/BufferHandler.php | 117 + .../src/Monolog/Handler/ChromePHPHandler.php | 211 + .../monolog/src/Monolog/Handler/CouchDBHandler.php | 72 + .../monolog/src/Monolog/Handler/CubeHandler.php | 151 + .../monolog/src/Monolog/Handler/Curl/Util.php | 57 + .../src/Monolog/Handler/DeduplicationHandler.php | 169 + .../src/Monolog/Handler/DoctrineCouchDBHandler.php | 45 + .../src/Monolog/Handler/DynamoDbHandler.php | 107 + .../src/Monolog/Handler/ElasticSearchHandler.php | 128 + .../src/Monolog/Handler/ErrorLogHandler.php | 82 + .../monolog/src/Monolog/Handler/FilterHandler.php | 140 + .../FingersCrossed/ActivationStrategyInterface.php | 28 + .../ChannelLevelActivationStrategy.php | 59 + .../ErrorLevelActivationStrategy.php | 34 + .../src/Monolog/Handler/FingersCrossedHandler.php | 163 + .../monolog/src/Monolog/Handler/FirePHPHandler.php | 195 + .../src/Monolog/Handler/FleepHookHandler.php | 126 + .../src/Monolog/Handler/FlowdockHandler.php | 127 + .../monolog/src/Monolog/Handler/GelfHandler.php | 73 + .../monolog/src/Monolog/Handler/GroupHandler.php | 104 + .../src/Monolog/Handler/HandlerInterface.php | 90 + .../monolog/src/Monolog/Handler/HandlerWrapper.php | 108 + .../monolog/src/Monolog/Handler/HipChatHandler.php | 350 ++ .../monolog/src/Monolog/Handler/IFTTTHandler.php | 69 + .../src/Monolog/Handler/LogEntriesHandler.php | 55 + .../monolog/src/Monolog/Handler/LogglyHandler.php | 102 + .../monolog/src/Monolog/Handler/MailHandler.php | 67 + .../src/Monolog/Handler/MandrillHandler.php | 68 + .../Monolog/Handler/MissingExtensionException.php | 21 + .../monolog/src/Monolog/Handler/MongoDBHandler.php | 59 + .../src/Monolog/Handler/NativeMailerHandler.php | 185 + .../src/Monolog/Handler/NewRelicHandler.php | 202 + .../monolog/src/Monolog/Handler/NullHandler.php | 45 + .../src/Monolog/Handler/PHPConsoleHandler.php | 242 + .../monolog/src/Monolog/Handler/PsrHandler.php | 56 + .../src/Monolog/Handler/PushoverHandler.php | 185 + .../monolog/src/Monolog/Handler/RavenHandler.php | 232 + .../monolog/src/Monolog/Handler/RedisHandler.php | 97 + .../monolog/src/Monolog/Handler/RollbarHandler.php | 132 + .../src/Monolog/Handler/RotatingFileHandler.php | 178 + .../src/Monolog/Handler/SamplingHandler.php | 82 + .../src/Monolog/Handler/Slack/SlackRecord.php | 294 + .../monolog/src/Monolog/Handler/SlackHandler.php | 215 + .../src/Monolog/Handler/SlackWebhookHandler.php | 115 + .../src/Monolog/Handler/SlackbotHandler.php | 80 + .../monolog/src/Monolog/Handler/SocketHandler.php | 346 ++ .../monolog/src/Monolog/Handler/StreamHandler.php | 176 + .../src/Monolog/Handler/SwiftMailerHandler.php | 99 + .../monolog/src/Monolog/Handler/SyslogHandler.php | 67 + .../src/Monolog/Handler/SyslogUdp/UdpSocket.php | 56 + .../src/Monolog/Handler/SyslogUdpHandler.php | 103 + .../monolog/src/Monolog/Handler/TestHandler.php | 154 + .../Monolog/Handler/WhatFailureGroupHandler.php | 61 + .../src/Monolog/Handler/ZendMonitorHandler.php | 95 + .../vendor/monolog/monolog/src/Monolog/Logger.php | 700 +++ .../monolog/src/Monolog/Processor/GitProcessor.php | 64 + .../Monolog/Processor/IntrospectionProcessor.php | 112 + .../Monolog/Processor/MemoryPeakUsageProcessor.php | 35 + .../src/Monolog/Processor/MemoryProcessor.php | 63 + .../src/Monolog/Processor/MemoryUsageProcessor.php | 35 + .../src/Monolog/Processor/MercurialProcessor.php | 63 + .../src/Monolog/Processor/ProcessIdProcessor.php | 31 + .../Monolog/Processor/PsrLogMessageProcessor.php | 48 + .../monolog/src/Monolog/Processor/TagProcessor.php | 44 + .../monolog/src/Monolog/Processor/UidProcessor.php | 46 + .../monolog/src/Monolog/Processor/WebProcessor.php | 113 + .../monolog/monolog/src/Monolog/Registry.php | 134 + .../vendor/phpseclib/phpseclib/AUTHORS | 6 + .../vendor/phpseclib/phpseclib/LICENSE | 21 + .../vendor/phpseclib/phpseclib/README.md | 74 + .../vendor/phpseclib/phpseclib/composer.json | 76 + .../phpseclib/phpseclib/phpseclib/Crypt/AES.php | 126 + .../phpseclib/phpseclib/phpseclib/Crypt/Base.php | 2598 ++++++++ .../phpseclib/phpseclib/Crypt/Blowfish.php | 571 ++ .../phpseclib/phpseclib/phpseclib/Crypt/DES.php | 1443 +++++ .../phpseclib/phpseclib/phpseclib/Crypt/Hash.php | 829 +++ .../phpseclib/phpseclib/phpseclib/Crypt/RC2.php | 688 +++ .../phpseclib/phpseclib/phpseclib/Crypt/RC4.php | 342 ++ .../phpseclib/phpseclib/phpseclib/Crypt/RSA.php | 3053 +++++++++ .../phpseclib/phpseclib/phpseclib/Crypt/Random.php | 274 + .../phpseclib/phpseclib/Crypt/Rijndael.php | 936 +++ .../phpseclib/phpseclib/Crypt/TripleDES.php | 460 ++ .../phpseclib/phpseclib/Crypt/Twofish.php | 816 +++ .../phpseclib/phpseclib/Math/BigInteger.php | 3763 ++++++++++++ .../phpseclib/phpseclib/phpseclib/bootstrap.php | 16 + .../phpseclib/phpseclib/phpseclib/openssl.cnf | 6 + .../vendor/psr/cache/CHANGELOG.md | 16 + .../google-api-client/vendor/psr/cache/LICENSE.txt | 19 + .../google-api-client/vendor/psr/cache/README.md | 9 + .../vendor/psr/cache/composer.json | 25 + .../vendor/psr/cache/src/CacheException.php | 10 + .../vendor/psr/cache/src/CacheItemInterface.php | 105 + .../psr/cache/src/CacheItemPoolInterface.php | 138 + .../psr/cache/src/InvalidArgumentException.php | 13 + .../vendor/psr/http-message/CHANGELOG.md | 36 + .../vendor/psr/http-message/LICENSE | 19 + .../vendor/psr/http-message/README.md | 13 + .../vendor/psr/http-message/composer.json | 26 + .../psr/http-message/src/MessageInterface.php | 187 + .../psr/http-message/src/RequestInterface.php | 129 + .../psr/http-message/src/ResponseInterface.php | 68 + .../http-message/src/ServerRequestInterface.php | 261 + .../psr/http-message/src/StreamInterface.php | 158 + .../psr/http-message/src/UploadedFileInterface.php | 123 + .../vendor/psr/http-message/src/UriInterface.php | 323 + .../google-api-client/vendor/psr/log/LICENSE | 19 + .../vendor/psr/log/Psr/Log/AbstractLogger.php | 128 + .../psr/log/Psr/Log/InvalidArgumentException.php | 7 + .../vendor/psr/log/Psr/Log/LogLevel.php | 18 + .../psr/log/Psr/Log/LoggerAwareInterface.php | 18 + .../vendor/psr/log/Psr/Log/LoggerAwareTrait.php | 26 + .../vendor/psr/log/Psr/Log/LoggerInterface.php | 123 + .../vendor/psr/log/Psr/Log/LoggerTrait.php | 140 + .../vendor/psr/log/Psr/Log/NullLogger.php | 28 + .../psr/log/Psr/Log/Test/LoggerInterfaceTest.php | 140 + .../google-api-client/vendor/psr/log/README.md | 45 + .../google-api-client/vendor/psr/log/composer.json | 26 + .../LICENSE | 13 + .../src/Mandrill.php | 161 + .../src/Mandrill/Exceptions.php | 151 + .../src/Mandrill/Exports.php | 112 + .../src/Mandrill/Inbound.php | 138 + .../src/Mandrill/Internal.php | 10 + .../src/Mandrill/Ips.php | 279 + .../src/Mandrill/Messages.php | 410 ++ .../src/Mandrill/Metadata.php | 64 + .../src/Mandrill/Rejects.php | 80 + .../src/Mandrill/Senders.php | 218 + .../src/Mandrill/Subaccounts.php | 171 + .../src/Mandrill/Tags.php | 174 + .../src/Mandrill/Templates.php | 235 + .../src/Mandrill/Urls.php | 108 + .../src/Mandrill/Users.php | 132 + .../src/Mandrill/Webhooks.php | 122 + .../src/Mandrill/Whitelists.php | 52 + Postman/Postman-Mail/mailgun/composer.json | 7 + Postman/Postman-Mail/mailgun/composer.lock | 801 +++ Postman/Postman-Mail/mailgun/mailgun.php | 2 + Postman/Postman-Mail/mailgun/vendor/autoload.php | 7 + .../mailgun/vendor/clue/stream-filter/.travis.yml | 26 + .../mailgun/vendor/clue/stream-filter/CHANGELOG.md | 54 + .../mailgun/vendor/clue/stream-filter/LICENSE | 21 + .../mailgun/vendor/clue/stream-filter/README.md | 297 + .../vendor/clue/stream-filter/composer.json | 23 + .../clue/stream-filter/examples/base64_decode.php | 29 + .../clue/stream-filter/examples/base64_encode.php | 21 + .../clue/stream-filter/examples/uppercase.php | 9 + .../vendor/clue/stream-filter/phpunit.xml.dist | 19 + .../clue/stream-filter/src/CallbackFilter.php | 120 + .../vendor/clue/stream-filter/src/functions.php | 146 + .../mailgun/vendor/composer/ClassLoader.php | 413 ++ .../Postman-Mail/mailgun/vendor/composer/LICENSE | 433 ++ .../mailgun/vendor/composer/autoload_classmap.php | 9 + .../mailgun/vendor/composer/autoload_files.php | 12 + .../vendor/composer/autoload_namespaces.php | 10 + .../mailgun/vendor/composer/autoload_psr4.php | 21 + .../mailgun/vendor/composer/autoload_real.php | 59 + .../mailgun/vendor/composer/installed.json | 812 +++ .../mailgun/vendor/guzzlehttp/psr7/CHANGELOG.md | 110 + .../mailgun/vendor/guzzlehttp/psr7/LICENSE | 19 + .../mailgun/vendor/guzzlehttp/psr7/README.md | 739 +++ .../mailgun/vendor/guzzlehttp/psr7/composer.json | 39 + .../vendor/guzzlehttp/psr7/src/AppendStream.php | 233 + .../vendor/guzzlehttp/psr7/src/BufferStream.php | 137 + .../vendor/guzzlehttp/psr7/src/CachingStream.php | 138 + .../vendor/guzzlehttp/psr7/src/DroppingStream.php | 42 + .../vendor/guzzlehttp/psr7/src/FnStream.php | 149 + .../vendor/guzzlehttp/psr7/src/InflateStream.php | 52 + .../vendor/guzzlehttp/psr7/src/LazyOpenStream.php | 39 + .../vendor/guzzlehttp/psr7/src/LimitStream.php | 155 + .../vendor/guzzlehttp/psr7/src/MessageTrait.php | 183 + .../vendor/guzzlehttp/psr7/src/MultipartStream.php | 153 + .../vendor/guzzlehttp/psr7/src/NoSeekStream.php | 22 + .../vendor/guzzlehttp/psr7/src/PumpStream.php | 165 + .../mailgun/vendor/guzzlehttp/psr7/src/Request.php | 142 + .../vendor/guzzlehttp/psr7/src/Response.php | 132 + .../vendor/guzzlehttp/psr7/src/ServerRequest.php | 358 ++ .../mailgun/vendor/guzzlehttp/psr7/src/Stream.php | 257 + .../guzzlehttp/psr7/src/StreamDecoratorTrait.php | 149 + .../vendor/guzzlehttp/psr7/src/StreamWrapper.php | 121 + .../vendor/guzzlehttp/psr7/src/UploadedFile.php | 316 + .../mailgun/vendor/guzzlehttp/psr7/src/Uri.php | 702 +++ .../vendor/guzzlehttp/psr7/src/UriNormalizer.php | 216 + .../vendor/guzzlehttp/psr7/src/UriResolver.php | 219 + .../vendor/guzzlehttp/psr7/src/functions.php | 828 +++ .../guzzlehttp/psr7/src/functions_include.php | 6 + .../vendor/mailgun/mailgun-php/CHANGELOG.md | 174 + .../mailgun/vendor/mailgun/mailgun-php/LICENSE | 17 + .../mailgun/vendor/mailgun/mailgun-php/README.md | 197 + .../vendor/mailgun/mailgun-php/composer.json | 41 + .../mailgun/mailgun-php/src/Mailgun/Api/Domain.php | 266 + .../mailgun/mailgun-php/src/Mailgun/Api/Event.php | 38 + .../mailgun-php/src/Mailgun/Api/HttpApi.php | 235 + .../mailgun-php/src/Mailgun/Api/Message.php | 170 + .../mailgun-php/src/Mailgun/Api/Pagination.php | 83 + .../mailgun/mailgun-php/src/Mailgun/Api/Route.php | 157 + .../mailgun/mailgun-php/src/Mailgun/Api/Stats.php | 52 + .../mailgun-php/src/Mailgun/Api/Suppression.php | 76 + .../src/Mailgun/Api/Suppression/Bounce.php | 113 + .../src/Mailgun/Api/Suppression/Complaint.php | 116 + .../src/Mailgun/Api/Suppression/Unsubscribe.php | 113 + .../mailgun/mailgun-php/src/Mailgun/Api/Tag.php | 128 + .../mailgun-php/src/Mailgun/Api/Webhook.php | 160 + .../mailgun/mailgun-php/src/Mailgun/Assert.php | 25 + .../Connection/Exceptions/GenericHTTPError.php | 39 + .../Connection/Exceptions/InvalidCredentials.php | 19 + .../Connection/Exceptions/MissingEndpoint.php | 19 + .../Exceptions/MissingRequiredParameters.php | 19 + .../Connection/Exceptions/NoDomainsConfigured.php | 19 + .../src/Mailgun/Connection/RestClient.php | 379 ++ .../mailgun-php/src/Mailgun/Constants/Api.php | 24 + .../src/Mailgun/Constants/ExceptionMessages.php | 29 + .../mailgun/mailgun-php/src/Mailgun/Exception.php | 19 + .../src/Mailgun/Exception/HttpClientException.php | 85 + .../src/Mailgun/Exception/HttpServerException.php | 33 + .../src/Mailgun/Exception/HydrationException.php | 16 + .../Mailgun/Exception/InvalidArgumentException.php | 19 + .../Mailgun/Exception/UnknownErrorException.php | 19 + .../src/Mailgun/HttpClient/Plugin/History.php | 45 + .../Mailgun/HttpClient/Plugin/ReplaceUriPlugin.php | 45 + .../src/Mailgun/HttpClientConfigurator.php | 185 + .../src/Mailgun/Hydrator/ArrayHydrator.php | 42 + .../mailgun-php/src/Mailgun/Hydrator/Hydrator.php | 29 + .../src/Mailgun/Hydrator/ModelHydrator.php | 50 + .../src/Mailgun/Hydrator/NoopHydrator.php | 31 + .../mailgun-php/src/Mailgun/Lists/OptInHandler.php | 60 + .../mailgun-php/src/Mailgun/Lists/README.md | 116 + .../mailgun/mailgun-php/src/Mailgun/Mailgun.php | 381 ++ .../src/Mailgun/Messages/BatchMessage.php | 154 + .../Messages/Exceptions/InvalidParameter.php | 16 + .../Messages/Exceptions/InvalidParameterType.php | 16 + .../Exceptions/MissingRequiredMIMEParameters.php | 16 + .../Messages/Exceptions/TooManyParameters.php | 16 + .../src/Mailgun/Messages/MessageBuilder.php | 529 ++ .../mailgun-php/src/Mailgun/Messages/README.md | 138 + .../mailgun-php/src/Mailgun/Model/ApiResponse.php | 25 + .../Mailgun/Model/Domain/ConnectionResponse.php | 72 + .../Model/Domain/CreateCredentialResponse.php | 49 + .../src/Mailgun/Model/Domain/CreateResponse.php | 119 + .../Mailgun/Model/Domain/CredentialResponse.php | 77 + .../Model/Domain/CredentialResponseItem.php | 97 + .../Model/Domain/DeleteCredentialResponse.php | 83 + .../src/Mailgun/Model/Domain/DeleteResponse.php | 67 + .../src/Mailgun/Model/Domain/DnsRecord.php | 123 + .../src/Mailgun/Model/Domain/Domain.php | 147 + .../src/Mailgun/Model/Domain/IndexResponse.php | 78 + .../src/Mailgun/Model/Domain/ShowResponse.php | 99 + .../Model/Domain/UpdateConnectionResponse.php | 83 + .../Model/Domain/UpdateCredentialResponse.php | 49 + .../mailgun-php/src/Mailgun/Model/Event/Event.php | 505 ++ .../src/Mailgun/Model/Event/EventResponse.php | 57 + .../src/Mailgun/Model/Message/SendResponse.php | 74 + .../src/Mailgun/Model/Message/ShowResponse.php | 402 ++ .../src/Mailgun/Model/PaginationResponse.php | 69 + .../src/Mailgun/Model/PagingProvider.php | 44 + .../mailgun-php/src/Mailgun/Model/Route/Action.php | 57 + .../Model/Route/Response/CreateResponse.php | 68 + .../Model/Route/Response/DeleteResponse.php | 67 + .../Mailgun/Model/Route/Response/IndexResponse.php | 77 + .../Mailgun/Model/Route/Response/ShowResponse.php | 54 + .../Model/Route/Response/UpdateResponse.php | 68 + .../mailgun-php/src/Mailgun/Model/Route/Route.php | 133 + .../src/Mailgun/Model/Stats/AllResponse.php | 77 + .../src/Mailgun/Model/Stats/AllResponseItem.php | 113 + .../src/Mailgun/Model/Stats/TotalResponse.php | 105 + .../src/Mailgun/Model/Stats/TotalResponseItem.php | 97 + .../src/Mailgun/Model/Suppression/BaseResponse.php | 69 + .../Mailgun/Model/Suppression/Bounce/Bounce.php | 123 + .../Model/Suppression/Bounce/CreateResponse.php | 19 + .../Model/Suppression/Bounce/DeleteResponse.php | 19 + .../Model/Suppression/Bounce/IndexResponse.php | 62 + .../Model/Suppression/Bounce/ShowResponse.php | 19 + .../Model/Suppression/Complaint/Complaint.php | 75 + .../Model/Suppression/Complaint/CreateResponse.php | 19 + .../Model/Suppression/Complaint/DeleteResponse.php | 19 + .../Model/Suppression/Complaint/IndexResponse.php | 62 + .../Model/Suppression/Complaint/ShowResponse.php | 19 + .../Suppression/Unsubscribe/CreateResponse.php | 19 + .../Suppression/Unsubscribe/DeleteResponse.php | 19 + .../Suppression/Unsubscribe/IndexResponse.php | 62 + .../Model/Suppression/Unsubscribe/ShowResponse.php | 19 + .../Model/Suppression/Unsubscribe/Unsubscribe.php | 99 + .../src/Mailgun/Model/Tag/DeleteResponse.php | 49 + .../src/Mailgun/Model/Tag/IndexResponse.php | 60 + .../src/Mailgun/Model/Tag/ShowResponse.php | 19 + .../src/Mailgun/Model/Tag/StatisticsResponse.php | 131 + .../mailgun-php/src/Mailgun/Model/Tag/Tag.php | 73 + .../src/Mailgun/Model/Tag/UpdateResponse.php | 49 + .../src/Mailgun/Model/Webhook/BaseResponse.php | 78 + .../src/Mailgun/Model/Webhook/CreateResponse.php | 17 + .../src/Mailgun/Model/Webhook/DeleteResponse.php | 17 + .../src/Mailgun/Model/Webhook/IndexResponse.php | 219 + .../src/Mailgun/Model/Webhook/ShowResponse.php | 56 + .../src/Mailgun/Model/Webhook/UpdateResponse.php | 17 + .../mailgun-php/src/Mailgun/RequestBuilder.php | 121 + .../vendor/php-http/client-common/CHANGELOG.md | 137 + .../mailgun/vendor/php-http/client-common/LICENSE | 19 + .../vendor/php-http/client-common/README.md | 55 + .../vendor/php-http/client-common/composer.json | 43 + .../php-http/client-common/src/BatchClient.php | 73 + .../php-http/client-common/src/BatchResult.php | 181 + .../client-common/src/EmulatedHttpAsyncClient.php | 27 + .../client-common/src/EmulatedHttpClient.php | 27 + .../client-common/src/Exception/BatchException.php | 39 + .../src/Exception/CircularRedirectionException.php | 14 + .../src/Exception/ClientErrorException.php | 14 + .../src/Exception/HttpClientNotFoundException.php | 14 + .../client-common/src/Exception/LoopException.php | 14 + .../src/Exception/MultipleRedirectionException.php | 14 + .../src/Exception/ServerErrorException.php | 14 + .../client-common/src/FlexibleHttpClient.php | 39 + .../client-common/src/HttpAsyncClientDecorator.php | 29 + .../client-common/src/HttpAsyncClientEmulator.php | 36 + .../client-common/src/HttpClientDecorator.php | 29 + .../client-common/src/HttpClientEmulator.php | 32 + .../php-http/client-common/src/HttpClientPool.php | 59 + .../src/HttpClientPool/LeastUsedClientPool.php | 45 + .../src/HttpClientPool/RandomClientPool.php | 31 + .../src/HttpClientPool/RoundRobinClientPool.php | 41 + .../client-common/src/HttpClientPoolItem.php | 178 + .../client-common/src/HttpClientRouter.php | 74 + .../client-common/src/HttpMethodsClient.php | 205 + .../vendor/php-http/client-common/src/Plugin.php | 32 + .../client-common/src/Plugin/AddHostPlugin.php | 77 + .../client-common/src/Plugin/AddPathPlugin.php | 48 + .../src/Plugin/AuthenticationPlugin.php | 38 + .../client-common/src/Plugin/BaseUriPlugin.php | 54 + .../src/Plugin/ContentLengthPlugin.php | 36 + .../client-common/src/Plugin/ContentTypePlugin.php | 123 + .../client-common/src/Plugin/CookiePlugin.php | 180 + .../client-common/src/Plugin/DecoderPlugin.php | 140 + .../client-common/src/Plugin/ErrorPlugin.php | 55 + .../src/Plugin/HeaderAppendPlugin.php | 45 + .../src/Plugin/HeaderDefaultsPlugin.php | 43 + .../src/Plugin/HeaderRemovePlugin.php | 41 + .../client-common/src/Plugin/HeaderSetPlugin.php | 41 + .../client-common/src/Plugin/HistoryPlugin.php | 49 + .../php-http/client-common/src/Plugin/Journal.php | 31 + .../src/Plugin/QueryDefaultsPlugin.php | 54 + .../client-common/src/Plugin/RedirectPlugin.php | 270 + .../src/Plugin/RequestMatcherPlugin.php | 47 + .../client-common/src/Plugin/RetryPlugin.php | 122 + .../php-http/client-common/src/PluginClient.php | 179 + .../client-common/src/PluginClientFactory.php | 62 + .../mailgun/vendor/php-http/curl-client/.php_cs | 9 + .../vendor/php-http/curl-client/.styleci.yml | 4 + .../vendor/php-http/curl-client/CHANGELOG.md | 163 + .../mailgun/vendor/php-http/curl-client/LICENSE | 19 + .../mailgun/vendor/php-http/curl-client/README.md | 44 + .../vendor/php-http/curl-client/composer.json | 50 + .../mailgun/vendor/php-http/curl-client/puli.json | 242 + .../vendor/php-http/curl-client/src/Client.php | 371 ++ .../php-http/curl-client/src/CurlPromise.php | 108 + .../php-http/curl-client/src/MultiRunner.php | 127 + .../php-http/curl-client/src/PromiseCore.php | 224 + .../php-http/curl-client/src/ResponseBuilder.php | 21 + .../mailgun/vendor/php-http/discovery/CHANGELOG.md | 186 + .../mailgun/vendor/php-http/discovery/LICENSE | 19 + .../mailgun/vendor/php-http/discovery/README.md | 46 + .../vendor/php-http/discovery/composer.json | 48 + .../php-http/discovery/src/ClassDiscovery.php | 207 + .../vendor/php-http/discovery/src/Exception.php | 12 + .../ClassInstantiationFailedException.php | 14 + .../src/Exception/DiscoveryFailedException.php | 51 + .../discovery/src/Exception/NotFoundException.php | 16 + .../src/Exception/PuliUnavailableException.php | 12 + .../src/Exception/StrategyUnavailableException.php | 15 + .../discovery/src/HttpAsyncClientDiscovery.php | 36 + .../php-http/discovery/src/HttpClientDiscovery.php | 36 + .../discovery/src/MessageFactoryDiscovery.php | 36 + .../php-http/discovery/src/NotFoundException.php | 14 + .../src/Strategy/CommonClassesStrategy.php | 82 + .../discovery/src/Strategy/DiscoveryStrategy.php | 23 + .../discovery/src/Strategy/MockClientStrategy.php | 24 + .../discovery/src/Strategy/PuliBetaStrategy.php | 91 + .../discovery/src/StreamFactoryDiscovery.php | 36 + .../php-http/discovery/src/UriFactoryDiscovery.php | 36 + .../mailgun/vendor/php-http/httplug/CHANGELOG.md | 72 + .../mailgun/vendor/php-http/httplug/LICENSE | 20 + .../mailgun/vendor/php-http/httplug/README.md | 57 + .../mailgun/vendor/php-http/httplug/composer.json | 40 + .../mailgun/vendor/php-http/httplug/puli.json | 12 + .../vendor/php-http/httplug/src/Exception.php | 12 + .../httplug/src/Exception/HttpException.php | 74 + .../httplug/src/Exception/NetworkException.php | 14 + .../httplug/src/Exception/RequestException.php | 43 + .../httplug/src/Exception/TransferException.php | 14 + .../php-http/httplug/src/HttpAsyncClient.php | 27 + .../vendor/php-http/httplug/src/HttpClient.php | 28 + .../httplug/src/Promise/HttpFulfilledPromise.php | 57 + .../httplug/src/Promise/HttpRejectedPromise.php | 56 + .../vendor/php-http/message-factory/CHANGELOG.md | 65 + .../vendor/php-http/message-factory/LICENSE | 19 + .../vendor/php-http/message-factory/README.md | 36 + .../vendor/php-http/message-factory/composer.json | 27 + .../vendor/php-http/message-factory/puli.json | 43 + .../message-factory/src/MessageFactory.php | 12 + .../message-factory/src/RequestFactory.php | 34 + .../message-factory/src/ResponseFactory.php | 35 + .../php-http/message-factory/src/StreamFactory.php | 25 + .../php-http/message-factory/src/UriFactory.php | 24 + .../mailgun/vendor/php-http/message/CHANGELOG.md | 139 + .../mailgun/vendor/php-http/message/LICENSE | 19 + .../mailgun/vendor/php-http/message/README.md | 61 + .../mailgun/vendor/php-http/message/apigen.neon | 6 + .../mailgun/vendor/php-http/message/composer.json | 60 + .../mailgun/vendor/php-http/message/puli.json | 111 + .../vendor/php-http/message/src/Authentication.php | 22 + .../message/src/Authentication/AutoBasicAuth.php | 48 + .../message/src/Authentication/BasicAuth.php | 44 + .../php-http/message/src/Authentication/Bearer.php | 37 + .../php-http/message/src/Authentication/Chain.php | 47 + .../message/src/Authentication/Matching.php | 74 + .../message/src/Authentication/QueryParam.php | 50 + .../src/Authentication/RequestConditional.php | 47 + .../php-http/message/src/Authentication/Wsse.php | 58 + .../message/src/Builder/ResponseBuilder.php | 148 + .../mailgun/vendor/php-http/message/src/Cookie.php | 526 ++ .../vendor/php-http/message/src/CookieJar.php | 220 + .../vendor/php-http/message/src/CookieUtil.php | 53 + .../message/src/Decorator/MessageDecorator.php | 133 + .../message/src/Decorator/RequestDecorator.php | 88 + .../message/src/Decorator/ResponseDecorator.php | 57 + .../message/src/Decorator/StreamDecorator.php | 138 + .../php-http/message/src/Encoding/ChunkStream.php | 39 + .../message/src/Encoding/CompressStream.php | 42 + .../message/src/Encoding/DechunkStream.php | 29 + .../message/src/Encoding/DecompressStream.php | 42 + .../message/src/Encoding/DeflateStream.php | 38 + .../php-http/message/src/Encoding/Filter/Chunk.php | 30 + .../message/src/Encoding/FilteredStream.php | 198 + .../message/src/Encoding/GzipDecodeStream.php | 42 + .../message/src/Encoding/GzipEncodeStream.php | 42 + .../message/src/Encoding/InflateStream.php | 42 + .../vendor/php-http/message/src/Exception.php | 10 + .../src/Exception/UnexpectedValueException.php | 9 + .../vendor/php-http/message/src/Formatter.php | 32 + .../message/src/Formatter/CurlCommandFormatter.php | 80 + .../src/Formatter/FullHttpMessageFormatter.php | 91 + .../message/src/Formatter/SimpleFormatter.php | 42 + .../src/MessageFactory/DiactorosMessageFactory.php | 61 + .../src/MessageFactory/GuzzleMessageFactory.php | 53 + .../src/MessageFactory/SlimMessageFactory.php | 72 + .../vendor/php-http/message/src/RequestMatcher.php | 26 + .../src/RequestMatcher/CallbackRequestMatcher.php | 35 + .../src/RequestMatcher/RegexRequestMatcher.php | 41 + .../message/src/RequestMatcher/RequestMatcher.php | 78 + .../php-http/message/src/Stream/BufferedStream.php | 270 + .../src/StreamFactory/DiactorosStreamFactory.php | 36 + .../src/StreamFactory/GuzzleStreamFactory.php | 21 + .../src/StreamFactory/SlimStreamFactory.php | 37 + .../message/src/UriFactory/DiactorosUriFactory.php | 29 + .../message/src/UriFactory/GuzzleUriFactory.php | 22 + .../message/src/UriFactory/SlimUriFactory.php | 31 + .../vendor/php-http/message/src/filters.php | 6 + .../php-http/multipart-stream-builder/CHANGELOG.md | 60 + .../php-http/multipart-stream-builder/LICENSE | 19 + .../php-http/multipart-stream-builder/README.md | 37 + .../multipart-stream-builder/composer.json | 43 + .../src/ApacheMimetypeHelper.php | 142 + .../src/CustomMimetypeHelper.php | 51 + .../src/MimetypeHelper.php | 27 + .../src/MultipartStreamBuilder.php | 278 + .../mailgun/vendor/php-http/promise/CHANGELOG.md | 35 + .../mailgun/vendor/php-http/promise/LICENSE | 19 + .../mailgun/vendor/php-http/promise/README.md | 49 + .../mailgun/vendor/php-http/promise/composer.json | 35 + .../php-http/promise/src/FulfilledPromise.php | 58 + .../vendor/php-http/promise/src/Promise.php | 69 + .../php-http/promise/src/RejectedPromise.php | 58 + .../mailgun/vendor/psr/http-message/CHANGELOG.md | 36 + .../mailgun/vendor/psr/http-message/LICENSE | 19 + .../mailgun/vendor/psr/http-message/README.md | 13 + .../mailgun/vendor/psr/http-message/composer.json | 26 + .../psr/http-message/src/MessageInterface.php | 187 + .../psr/http-message/src/RequestInterface.php | 129 + .../psr/http-message/src/ResponseInterface.php | 68 + .../http-message/src/ServerRequestInterface.php | 261 + .../psr/http-message/src/StreamInterface.php | 158 + .../psr/http-message/src/UploadedFileInterface.php | 123 + .../vendor/psr/http-message/src/UriInterface.php | 323 + .../vendor/symfony/options-resolver/CHANGELOG.md | 52 + .../Debug/OptionsResolverIntrospector.php | 102 + .../options-resolver/Exception/AccessException.php | 22 + .../Exception/ExceptionInterface.php | 21 + .../Exception/InvalidArgumentException.php | 21 + .../Exception/InvalidOptionsException.php | 23 + .../Exception/MissingOptionsException.php | 23 + .../Exception/NoConfigurationException.php | 26 + .../Exception/NoSuchOptionException.php | 26 + .../Exception/OptionDefinitionException.php | 21 + .../Exception/UndefinedOptionsException.php | 24 + .../vendor/symfony/options-resolver/LICENSE | 19 + .../vendor/symfony/options-resolver/Options.php | 22 + .../symfony/options-resolver/OptionsResolver.php | 1076 ++++ .../vendor/symfony/options-resolver/README.md | 15 + .../Debug/OptionsResolverIntrospectorTest.php | 203 + .../options-resolver/Tests/OptionsResolverTest.php | 1644 +++++ .../vendor/symfony/options-resolver/composer.json | 33 + .../symfony/options-resolver/phpunit.xml.dist | 31 + .../vendor/webmozart/assert/.composer-auth.json | 7 + .../mailgun/vendor/webmozart/assert/.styleci.yml | 8 + .../mailgun/vendor/webmozart/assert/.travis.yml | 39 + .../mailgun/vendor/webmozart/assert/CHANGELOG.md | 34 + .../mailgun/vendor/webmozart/assert/LICENSE | 20 + .../mailgun/vendor/webmozart/assert/README.md | 242 + .../mailgun/vendor/webmozart/assert/appveyor.yml | 40 + .../mailgun/vendor/webmozart/assert/composer.json | 34 + .../vendor/webmozart/assert/phpunit.xml.dist | 16 + .../mailgun/vendor/webmozart/assert/src/Assert.php | 948 +++ .../vendor/webmozart/assert/tests/AssertTest.php | 451 ++ Postman/Postman-Mail/postman_gmail.js | 35 + Postman/Postman-Mail/postman_mailgun.js | 40 + Postman/Postman-Mail/postman_mandrill.js | 40 + Postman/Postman-Mail/postman_sendgrid.js | 40 + Postman/Postman-Mail/postman_smtp.js | 89 + Postman/Postman-Mail/sendgrid/.editorconfig | 8 + Postman/Postman-Mail/sendgrid/.travis.yml | 35 + Postman/Postman-Mail/sendgrid/composer.json | 5 + Postman/Postman-Mail/sendgrid/composer.lock | 128 + Postman/Postman-Mail/sendgrid/sendgrid-php.php | 5 + Postman/Postman-Mail/sendgrid/vendor/autoload.php | 7 + .../sendgrid/vendor/composer/ClassLoader.php | 413 ++ .../Postman-Mail/sendgrid/vendor/composer/LICENSE | 433 ++ .../sendgrid/vendor/composer/autoload_classmap.php | 9 + .../sendgrid/vendor/composer/autoload_files.php | 10 + .../vendor/composer/autoload_namespaces.php | 9 + .../sendgrid/vendor/composer/autoload_psr4.php | 13 + .../sendgrid/vendor/composer/autoload_real.php | 59 + .../sendgrid/vendor/composer/installed.json | 115 + .../sendgrid/php-http-client/.codeclimate.yml | 18 + .../php-http-client/.github/ISSUE_TEMPLATE | 17 + .../php-http-client/.github/PULL_REQUEST_TEMPLATE | 24 + .../vendor/sendgrid/php-http-client/.travis.yml | 27 + .../sendgrid/php-http-client/CONTRIBUTING.md | 201 + .../vendor/sendgrid/php-http-client/Dockerfile | 13 + .../vendor/sendgrid/php-http-client/LICENSE.txt | 22 + .../vendor/sendgrid/php-http-client/README.md | 195 + .../vendor/sendgrid/php-http-client/composer.json | 36 + .../vendor/sendgrid/php-http-client/lib/Client.php | 596 ++ .../sendgrid/php-http-client/lib/Response.php | 113 + .../vendor/sendgrid/sendgrid/.codeclimate.yml | 11 + .../vendor/sendgrid/sendgrid/.editorconfig | 8 + .../sendgrid/vendor/sendgrid/sendgrid/.env.sample | 1 + .../sendgrid/sendgrid/.github/ISSUE_TEMPLATE | 16 + .../sendgrid/.github/PULL_REQUEST_TEMPLATE | 26 + .../sendgrid/vendor/sendgrid/sendgrid/.travis.yml | 33 + .../vendor/sendgrid/sendgrid/CODE_OF_CONDUCT.md | 38 + .../sendgrid/vendor/sendgrid/sendgrid/LICENSE.md | 21 + .../sendgrid/vendor/sendgrid/sendgrid/README.md | 232 + .../vendor/sendgrid/sendgrid/composer.json | 47 + .../vendor/sendgrid/sendgrid/docker/Dockerfile | 22 + .../vendor/sendgrid/sendgrid/docker/README.md | 50 + .../vendor/sendgrid/sendgrid/docker/entrypoint.sh | 15 + .../vendor/sendgrid/sendgrid/lib/SendGrid.php | 77 + .../sendgrid/sendgrid/lib/contacts/README.md | 16 + .../sendgrid/sendgrid/lib/contacts/Recipient.php | 92 + .../sendgrid/lib/contacts/RecipientForm.php | 55 + .../vendor/sendgrid/sendgrid/lib/loader.php | 54 + .../vendor/sendgrid/sendgrid/lib/mail/Asm.php | 150 + .../sendgrid/sendgrid/lib/mail/Attachment.php | 235 + .../vendor/sendgrid/sendgrid/lib/mail/BatchId.php | 75 + .../vendor/sendgrid/sendgrid/lib/mail/Bcc.php | 24 + .../sendgrid/sendgrid/lib/mail/BccSettings.php | 118 + .../sendgrid/lib/mail/BypassListManagement.php | 87 + .../vendor/sendgrid/sendgrid/lib/mail/Category.php | 77 + .../vendor/sendgrid/sendgrid/lib/mail/Cc.php | 24 + .../sendgrid/sendgrid/lib/mail/ClickTracking.php | 114 + .../vendor/sendgrid/sendgrid/lib/mail/Content.php | 118 + .../sendgrid/sendgrid/lib/mail/CustomArg.php | 119 + .../sendgrid/sendgrid/lib/mail/EmailAddress.php | 222 + .../vendor/sendgrid/sendgrid/lib/mail/Footer.php | 144 + .../vendor/sendgrid/sendgrid/lib/mail/From.php | 24 + .../sendgrid/sendgrid/lib/mail/Ganalytics.php | 251 + .../vendor/sendgrid/sendgrid/lib/mail/GroupId.php | 73 + .../sendgrid/sendgrid/lib/mail/GroupsToDisplay.php | 87 + .../vendor/sendgrid/sendgrid/lib/mail/Header.php | 116 + .../sendgrid/sendgrid/lib/mail/HtmlContent.php | 33 + .../sendgrid/sendgrid/lib/mail/IpPoolName.php | 77 + .../vendor/sendgrid/sendgrid/lib/mail/Mail.php | 1911 ++++++ .../sendgrid/sendgrid/lib/mail/MailSettings.php | 274 + .../vendor/sendgrid/sendgrid/lib/mail/MimeType.php | 26 + .../sendgrid/sendgrid/lib/mail/OpenTracking.php | 124 + .../sendgrid/sendgrid/lib/mail/Personalization.php | 312 + .../sendgrid/lib/mail/PlainTextContent.php | 33 + .../vendor/sendgrid/sendgrid/lib/mail/README.md | 14 + .../vendor/sendgrid/sendgrid/lib/mail/ReplyTo.php | 24 + .../sendgrid/sendgrid/lib/mail/SandBoxMode.php | 80 + .../vendor/sendgrid/sendgrid/lib/mail/Section.php | 115 + .../vendor/sendgrid/sendgrid/lib/mail/SendAt.php | 102 + .../sendgrid/sendgrid/lib/mail/SpamCheck.php | 161 + .../vendor/sendgrid/sendgrid/lib/mail/Subject.php | 74 + .../sendgrid/lib/mail/SubscriptionTracking.php | 228 + .../sendgrid/sendgrid/lib/mail/Substitution.php | 120 + .../sendgrid/sendgrid/lib/mail/TemplateId.php | 86 + .../vendor/sendgrid/sendgrid/lib/mail/To.php | 24 + .../sendgrid/lib/mail/TrackingSettings.php | 252 + .../sendgrid/sendgrid/lib/mail/TypeException.php | 7 + .../vendor/sendgrid/sendgrid/lib/stats/Stats.php | 269 + .../sendgrid/vendor/sendgrid/sendgrid/phpcs.xml | 196 + .../vendor/sendgrid/sendgrid/scripts/package.sh | 9 + .../vendor/sendgrid/sendgrid/sendgrid-php.php | 3 + .../sendgrid/sendgrid/test/BaseTestClass.php | 70 + .../vendor/sendgrid/sendgrid/test/data/test.txt | 1 + .../test/integration/Alerts/AlertsTest.php | 52 + .../test/integration/ApiKeys/ApiKeysTest.php | 74 + .../test/integration/Asm/AsmGroupsTest.php | 105 + .../test/integration/Asm/AsmSuppressionTest.php | 52 + .../test/integration/Campaigns/CampaignsTest.php | 134 + .../test/integration/Categories/CategoriesTest.php | 32 + .../test/integration/Contacts/ContactDbTest.php | 424 ++ .../sendgrid/test/integration/Ip/IpPoolsTest.php | 72 + .../sendgrid/test/integration/Ip/IpsTest.php | 31 + .../sendgrid/test/integration/Ip/IpsWarmupTest.php | 41 + .../test/integration/Mail/MailBatchTest.php | 23 + .../test/integration/Mail/MailSendTest.php | 153 + .../test/integration/Mail/MailSettingsTest.php | 183 + .../test/integration/Mail/MailboxProvidersTest.php | 18 + .../test/integration/Scopes/ScopesTest.php | 15 + .../DomainAuthenticationTest.php | 124 + .../SenderAuthentication/LinkBrandingTest.php | 99 + .../SenderAuthentication/ReverseDNSTest.php | 52 + .../test/integration/Senders/SendersTest.php | 99 + .../integration/Settings/AccessSettingsTest.php | 76 + .../integration/Settings/PartnerSettingsTest.php | 35 + .../integration/Settings/TrackingSettingsTest.php | 94 + .../test/integration/Stats/BrowserStatsTest.php | 16 + .../test/integration/Stats/ClientsStatsTest.php | 25 + .../test/integration/Stats/DevicesStatsTest.php | 16 + .../test/integration/Stats/GeoStatsTest.php | 16 + .../sendgrid/test/integration/Stats/StatsTest.php | 16 + .../test/integration/Subusers/SubUsersTest.php | 155 + .../Suppression/SuppressionBlocksTest.php | 46 + .../Suppression/SuppressionBouncesTest.php | 47 + .../Suppression/SuppressionInvalidEmailsTest.php | 46 + .../Suppression/SuppressionSpamReportsTest.php | 46 + .../Suppression/SuppressionUnsubscribesTest.php | 16 + .../test/integration/Templates/TemplatesTest.php | 114 + .../sendgrid/test/integration/Users/UserTest.php | 274 + .../helpers/contacts/RecipientsTest.php | 31 + .../test/integration/helpers/stats/StatsTest.php | 238 + .../vendor/sendgrid/sendgrid/test/phpunit.xml.dist | 8 + .../vendor/sendgrid/sendgrid/test/prism.sh | 63 + .../sendgrid/test/unit/AttachmentsTest.php | 45 + .../sendgrid/test/unit/DynamicTemplateTest.php | 415 ++ .../sendgrid/sendgrid/test/unit/FilesExistTest.php | 48 + .../sendgrid/test/unit/KitchenSinkTest.php | 1229 ++++ .../sendgrid/test/unit/MailGetContentsTest.php | 38 + .../sendgrid/sendgrid/test/unit/MailHelperTest.php | 84 + .../unit/MultipleEmailToMultipleRecipientsTest.php | 517 ++ .../sendgrid/sendgrid/test/unit/SendGridTest.php | 88 + .../unit/SingleEmailToASingleRecipientTest.php | 98 + .../unit/SingleEmailToMultipleRecipientsTest.php | 117 + .../PostmanSendTestEmailController.php | 358 ++ .../postman_send_test_email.css | 3 + .../postman_send_test_email.js | 169 + Postman/Postman.php | 498 ++ Postman/PostmanAdminController.php | 412 ++ Postman/PostmanAjaxController.php | 68 + Postman/PostmanConfigTextHelper.php | 308 + Postman/PostmanEmailLogs.php | 113 + Postman/PostmanInputSanitizer.php | 186 + Postman/PostmanInstaller.php | 267 + Postman/PostmanLogFields.php | 139 + Postman/PostmanLogger.php | 73 + Postman/PostmanMessageHandler.php | 115 + Postman/PostmanOAuthToken.php | 89 + Postman/PostmanOptions.php | 679 ++ Postman/PostmanPluginFeedback.php | 157 + Postman/PostmanPreRequisitesCheck.php | 87 + Postman/PostmanSession.php | 95 + Postman/PostmanState.php | 113 + Postman/PostmanUtils.php | 482 ++ Postman/PostmanViewController.php | 390 ++ Postman/PostmanWpMail.php | 414 ++ Postman/PostmanWpMailBinder.php | 131 + Postman/extra/donation.php | 19 + Postman/extra/no-localhost-mails.php | 9 + Postman/languages/postman-smtp-el_GR.mo | Bin 0 -> 37592 bytes Postman/languages/postman-smtp-el_GR.po | 1738 ++++++ Postman/languages/postman-smtp-fr_FR.mo | Bin 0 -> 29123 bytes Postman/languages/postman-smtp-fr_FR.po | 2529 ++++++++ Postman/languages/postman-smtp-it_IT.mo | Bin 0 -> 28939 bytes Postman/languages/postman-smtp-it_IT.po | 2397 ++++++++ Postman/languages/postman-smtp-nl_NL.mo | Bin 0 -> 29682 bytes Postman/languages/postman-smtp-nl_NL.po | 1914 ++++++ Postman/languages/postman-smtp-ru_RU.mo | Bin 0 -> 36706 bytes Postman/languages/postman-smtp-ru_RU.po | 1778 ++++++ Postman/languages/postman-smtp-tr_TR.mo | Bin 0 -> 29147 bytes Postman/languages/postman-smtp-tr_TR.po | 2381 +++++++ Postman/languages/postman-smtp-zh_CN.mo | Bin 0 -> 27088 bytes Postman/languages/postman-smtp-zh_CN.po | 1511 +++++ Postman/languages/postman-smtp.pot | 1498 +++++ Postman/notifications/INotify.php | 7 + Postman/notifications/PostmanMailNotify.php | 14 + Postman/notifications/PostmanNotify.php | 42 + Postman/notifications/PostmanPushoverNotify.php | 34 + Postman/notifications/PostmanSlackNotify.php | 39 + 1067 files changed, 186194 insertions(+) create mode 100644 Postman/Phpmailer/PostsmtpMailer.php create mode 100644 Postman/Postman-Auth/PostmanAbstractAuthenticationManager.php create mode 100644 Postman/Postman-Auth/PostmanAuthenticationManager.php create mode 100644 Postman/Postman-Auth/PostmanAuthenticationManagerFactory.php create mode 100644 Postman/Postman-Auth/PostmanGoogleAuthenticationManager.php create mode 100644 Postman/Postman-Auth/PostmanMicrosoftAuthenticationManager.php create mode 100644 Postman/Postman-Auth/PostmanNonOAuthAuthenticationManager.php create mode 100644 Postman/Postman-Auth/PostmanStateIdMissingException.php create mode 100644 Postman/Postman-Auth/PostmanYahooAuthenticationManager.php create mode 100644 Postman/Postman-Configuration/PostmanConfigurationController.php create mode 100644 Postman/Postman-Configuration/PostmanImportableConfiguration.php create mode 100644 Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php create mode 100644 Postman/Postman-Configuration/PostmanSmtpDiscovery.php create mode 100644 Postman/Postman-Configuration/postman_manual_config.js create mode 100644 Postman/Postman-Configuration/postman_wizard.js create mode 100644 Postman/Postman-Connectivity-Test/Postman-PortTest.php create mode 100644 Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php create mode 100644 Postman/Postman-Connectivity-Test/postman_port_test.js create mode 100644 Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/effectiveTLDs.inc.php create mode 100644 Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/regDomain.class.php create mode 100644 Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/regDomain.inc.php create mode 100644 Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/test-regDomain.php create mode 100644 Postman/Postman-Connectivity-Test/registered-domain-libs-master/README.txt create mode 100644 Postman/Postman-Connectivity-Test/registered-domain-libs-master/generateEffectiveTLDs.php create mode 100644 Postman/Postman-Controller/PostmanAdminPointer.php create mode 100644 Postman/Postman-Controller/PostmanDashboardWidgetController.php create mode 100644 Postman/Postman-Controller/PostmanManageConfigurationAjaxHandler.php create mode 100644 Postman/Postman-Controller/PostmanWelcomeController.php create mode 100644 Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php create mode 100644 Postman/Postman-Diagnostic-Test/postman_diagnostics.js create mode 100644 Postman/Postman-Email-Log/PostmanEmailLogController.php create mode 100644 Postman/Postman-Email-Log/PostmanEmailLogPostType.php create mode 100644 Postman/Postman-Email-Log/PostmanEmailLogService.php create mode 100644 Postman/Postman-Email-Log/PostmanEmailLogView.php create mode 100644 Postman/Postman-Mail/PostmanContactForm7.php create mode 100644 Postman/Postman-Mail/PostmanDefaultModuleTransport.php create mode 100644 Postman/Postman-Mail/PostmanEmailAddress.php create mode 100644 Postman/Postman-Mail/PostmanGmailApiModuleTransport.php create mode 100644 Postman/Postman-Mail/PostmanGmailApiModuleZendMailTransport.php create mode 100644 Postman/Postman-Mail/PostmanMailEngine.php create mode 100644 Postman/Postman-Mail/PostmanMailgunMailEngine.php create mode 100644 Postman/Postman-Mail/PostmanMailgunTransport.php create mode 100644 Postman/Postman-Mail/PostmanMandrillMailEngine.php create mode 100644 Postman/Postman-Mail/PostmanMandrillTransport.php create mode 100644 Postman/Postman-Mail/PostmanMessage.php create mode 100644 Postman/Postman-Mail/PostmanModuleTransport.php create mode 100644 Postman/Postman-Mail/PostmanMyMailConnector.php create mode 100644 Postman/Postman-Mail/PostmanSendGridMailEngine.php create mode 100644 Postman/Postman-Mail/PostmanSendGridTransport.php create mode 100644 Postman/Postman-Mail/PostmanSmtpModuleTransport.php create mode 100644 Postman/Postman-Mail/PostmanTransportRegistry.php create mode 100644 Postman/Postman-Mail/PostmanWooCommerce.php create mode 100644 Postman/Postman-Mail/PostmanZendMailEngine.php create mode 100644 Postman/Postman-Mail/PostmanZendMailTransportConfigurationFactory.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Exception.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Loader.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Loader/Autoloader.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Exception.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Message.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Message/File.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Message/Interface.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Part/File.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Part/Interface.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Abstract.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Exception.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Imap.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Pop3.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Crammd5.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Login.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Oauth2.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Plain.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Abstract.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Exception.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Interface.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Maildir.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Mbox.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Imap.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Maildir.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Mbox.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Pop3.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Writable/Interface.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Writable/Maildir.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Abstract.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Exception.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/File.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Sendmail.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Smtp.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mime.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mime/Decode.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mime/Exception.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mime/Message.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Mime/Part.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Registry.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Abstract.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Alnum.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Alpha.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Barcode.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Between.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Callback.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Ccnum.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/CreditCard.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Date.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Digits.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/EmailAddress.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Exception.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Float.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/GreaterThan.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Hex.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Biz.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Cn.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Com.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Jp.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Iban.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Identical.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/InArray.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Int.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Interface.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Ip.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Isbn.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/LessThan.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/NotEmpty.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/PostCode.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/Regex.php create mode 100644 Postman/Postman-Mail/Zend-1.12.10/Validate/StringLength.php create mode 100644 Postman/Postman-Mail/google-api-client/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/composer.lock create mode 100644 Postman/Postman-Mail/google-api-client/vendor/autoload.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/composer/ClassLoader.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/composer/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/composer/autoload_classmap.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/composer/autoload_files.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/composer/autoload_namespaces.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/composer/autoload_psr4.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/composer/autoload_real.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/composer/installed.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/.travis.yml create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/CONTRIBUTING.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/phpunit.xml create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/AutoForwarding.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/BatchDeleteMessagesRequest.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/BatchModifyMessagesRequest.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Draft.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Filter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/FilterAction.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/FilterCriteria.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ForwardingAddress.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/History.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryLabelAdded.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryLabelRemoved.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryMessageAdded.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryMessageDeleted.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ImapSettings.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Label.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/LabelColor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListDraftsResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListFiltersResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListForwardingAddressesResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListHistoryResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListLabelsResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListMessagesResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListSendAsResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListSmimeInfoResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListThreadsResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Message.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePart.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePartBody.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePartHeader.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ModifyMessageRequest.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ModifyThreadRequest.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/PopSettings.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Profile.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/Users.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersDrafts.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersHistory.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersLabels.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersMessages.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersMessagesAttachments.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettings.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsFilters.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsForwardingAddresses.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsSendAs.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsSendAsSmimeInfo.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersThreads.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SendAs.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SmimeInfo.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SmtpMsa.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Thread.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/VacationSettings.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/WatchRequest.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/WatchResponse.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/.gitattributes create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AccessToken/Revoke.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AccessToken/Verify.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/AuthHandlerFactory.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/Guzzle5AuthHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/Guzzle6AuthHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Client.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Collection.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Exception.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/Batch.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/MediaFileUpload.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/REST.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Model.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/Exception.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/Resource.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Task/Exception.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Task/Retryable.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Task/Runner.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Utils/UriTemplate.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/autoload.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/.editorconfig create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/.php_cs create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/.travis.yml create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/COPYING create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/autoload.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/ApplicationDefaultCredentials.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/InvalidArgumentException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/Item.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/MemoryCacheItemPool.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/CacheTrait.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/AppIdentityCredentials.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/GCECredentials.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/IAMCredentials.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/ServiceAccountCredentials.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/ServiceAccountJwtAccessCredentials.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/UserRefreshCredentials.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/CredentialsLoader.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/FetchAuthTokenCache.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/FetchAuthTokenInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/Guzzle5HttpHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/Guzzle6HttpHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/HttpHandlerFactory.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/AuthTokenMiddleware.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/ScopedAccessTokenMiddleware.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/SimpleMiddleware.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/OAuth2.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/AuthTokenSubscriber.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/ScopedAccessTokenSubscriber.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/SimpleSubscriber.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/CHANGELOG.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/UPGRADING.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Client.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/ClientInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/CookieJar.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/CookieJarInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/FileCookieJar.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/SessionCookieJar.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/SetCookie.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/BadResponseException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/ClientException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/ConnectException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/GuzzleException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/RequestException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/SeekException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/ServerException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/TooManyRedirectsException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/TransferException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlFactory.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlFactoryInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlMultiHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/EasyHandle.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/MockHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/Proxy.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/StreamHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/HandlerStack.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/MessageFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Middleware.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Pool.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/PrepareBodyMiddleware.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RedirectMiddleware.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RequestOptions.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RetryMiddleware.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/TransferStats.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/UriTemplate.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/functions.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/functions_include.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/CHANGELOG.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/Makefile create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/AggregateException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/CancellationException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/Coroutine.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/EachPromise.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/FulfilledPromise.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/Promise.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/PromiseInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/PromisorInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/RejectedPromise.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/RejectionException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/TaskQueue.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/TaskQueueInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/functions.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/functions_include.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/CHANGELOG.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/AppendStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/BufferStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/CachingStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/DroppingStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/FnStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/InflateStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/LazyOpenStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/LimitStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/MessageTrait.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/MultipartStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/NoSeekStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/PumpStream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Request.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Response.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/ServerRequest.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Stream.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/StreamDecoratorTrait.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/StreamWrapper.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UploadedFile.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Uri.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UriNormalizer.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UriResolver.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/functions.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/functions_include.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/.php_cs create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/ErrorHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ChromePHPFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ElasticaFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FlowdockFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FluentdFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FormatterInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/GelfMessageFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/HtmlFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/JsonFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LineFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LogglyFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LogstashFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/MongoDBFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/NormalizerFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ScalarFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/WildfireFormatter.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractProcessingHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractSyslogHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AmqpHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/BufferHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ChromePHPHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/CouchDBHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/CubeHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/Curl/Util.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DeduplicationHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DoctrineCouchDBHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DynamoDbHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ElasticSearchHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ErrorLogHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FilterHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ActivationStrategyInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ChannelLevelActivationStrategy.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ErrorLevelActivationStrategy.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossedHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FirePHPHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FleepHookHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FlowdockHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/GelfHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/GroupHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HandlerInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HandlerWrapper.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HipChatHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/IFTTTHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/LogEntriesHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/LogglyHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MailHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MandrillHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MissingExtensionException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MongoDBHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NativeMailerHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NewRelicHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NullHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PHPConsoleHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PsrHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PushoverHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RavenHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RedisHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RollbarHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RotatingFileHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SamplingHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackWebhookHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackbotHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SocketHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/StreamHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SwiftMailerHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogUdp/UdpSocket.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogUdpHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/TestHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/WhatFailureGroupHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ZendMonitorHandler.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Logger.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/GitProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/IntrospectionProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryPeakUsageProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryUsageProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MercurialProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/ProcessIdProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/PsrLogMessageProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/TagProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/UidProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/WebProcessor.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Registry.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/AUTHORS create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/AES.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Base.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Blowfish.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/DES.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Hash.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RC2.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RC4.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RSA.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Random.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Rijndael.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/TripleDES.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Twofish.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Math/BigInteger.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/bootstrap.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/openssl.cnf create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/cache/CHANGELOG.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/cache/LICENSE.txt create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/cache/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/cache/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/cache/src/CacheException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/cache/src/CacheItemInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/cache/src/CacheItemPoolInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/cache/src/InvalidArgumentException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/CHANGELOG.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/composer.json create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/MessageInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/RequestInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/ResponseInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/ServerRequestInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/StreamInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/UploadedFileInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/UriInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/LICENSE create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/AbstractLogger.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/InvalidArgumentException.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/LogLevel.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/LoggerAwareInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/LoggerAwareTrait.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/LoggerInterface.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/LoggerTrait.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/NullLogger.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/Test/LoggerInterfaceTest.php create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/README.md create mode 100644 Postman/Postman-Mail/google-api-client/vendor/psr/log/composer.json create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/LICENSE create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Exceptions.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Exports.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Inbound.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Internal.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Ips.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Messages.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Metadata.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Rejects.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Senders.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Subaccounts.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Tags.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Templates.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Urls.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Users.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Webhooks.php create mode 100644 Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Whitelists.php create mode 100644 Postman/Postman-Mail/mailgun/composer.json create mode 100644 Postman/Postman-Mail/mailgun/composer.lock create mode 100644 Postman/Postman-Mail/mailgun/mailgun.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/autoload.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/.travis.yml create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/examples/base64_decode.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/examples/base64_encode.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/examples/uppercase.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/phpunit.xml.dist create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/src/CallbackFilter.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/src/functions.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/composer/ClassLoader.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/composer/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/composer/autoload_classmap.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/composer/autoload_files.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/composer/autoload_namespaces.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/composer/autoload_psr4.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/composer/autoload_real.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/composer/installed.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/AppendStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/BufferStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/CachingStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/DroppingStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/FnStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/InflateStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/LazyOpenStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/LimitStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/MessageTrait.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/MultipartStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/NoSeekStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/PumpStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Request.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Response.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/ServerRequest.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Stream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/StreamDecoratorTrait.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/StreamWrapper.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UploadedFile.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Uri.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UriNormalizer.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UriResolver.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/functions.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/functions_include.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Domain.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Event.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/HttpApi.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Message.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Pagination.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Route.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Stats.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Bounce.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Complaint.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Unsubscribe.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Tag.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Webhook.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Assert.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/GenericHTTPError.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/InvalidCredentials.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/MissingEndpoint.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/MissingRequiredParameters.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/NoDomainsConfigured.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/RestClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Constants/Api.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Constants/ExceptionMessages.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HttpClientException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HttpServerException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HydrationException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/InvalidArgumentException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/UnknownErrorException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClient/Plugin/History.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClient/Plugin/ReplaceUriPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClientConfigurator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/ArrayHydrator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/Hydrator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/ModelHydrator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/NoopHydrator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Lists/OptInHandler.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Lists/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Mailgun.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/BatchMessage.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/Exceptions/InvalidParameter.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/Exceptions/InvalidParameterType.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/Exceptions/MissingRequiredMIMEParameters.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/Exceptions/TooManyParameters.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/MessageBuilder.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/ApiResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/ConnectionResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CreateCredentialResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CreateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CredentialResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CredentialResponseItem.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DeleteCredentialResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DeleteResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DnsRecord.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/Domain.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/IndexResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/ShowResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/UpdateConnectionResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/UpdateCredentialResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Event/Event.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Event/EventResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Message/SendResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Message/ShowResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/PaginationResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/PagingProvider.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Action.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/CreateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/DeleteResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/IndexResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/ShowResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/UpdateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Route.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/AllResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/AllResponseItem.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/TotalResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/TotalResponseItem.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/BaseResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/Bounce.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/CreateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/DeleteResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/IndexResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/ShowResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/Complaint.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/CreateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/DeleteResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/IndexResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/ShowResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/CreateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/DeleteResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/IndexResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/ShowResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/Unsubscribe.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/DeleteResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/IndexResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/ShowResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/StatisticsResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/Tag.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/UpdateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/BaseResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/CreateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/DeleteResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/IndexResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/ShowResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/UpdateResponse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/RequestBuilder.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/BatchClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/BatchResult.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/EmulatedHttpAsyncClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/EmulatedHttpClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/BatchException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/CircularRedirectionException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/ClientErrorException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/HttpClientNotFoundException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/LoopException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/MultipleRedirectionException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/ServerErrorException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/FlexibleHttpClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpAsyncClientDecorator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpAsyncClientEmulator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientDecorator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientEmulator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/LeastUsedClientPool.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/RandomClientPool.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/RoundRobinClientPool.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPoolItem.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientRouter.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpMethodsClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AddHostPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AddPathPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AuthenticationPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/BaseUriPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ContentLengthPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ContentTypePlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/CookiePlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/DecoderPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ErrorPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderAppendPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderDefaultsPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderRemovePlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderSetPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HistoryPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/Journal.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/QueryDefaultsPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RedirectPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RequestMatcherPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RetryPlugin.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/PluginClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/PluginClientFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/.php_cs create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/.styleci.yml create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/puli.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/Client.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/CurlPromise.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/MultiRunner.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/PromiseCore.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/ResponseBuilder.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/ClassDiscovery.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/ClassInstantiationFailedException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/DiscoveryFailedException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/NotFoundException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/PuliUnavailableException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/StrategyUnavailableException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/HttpAsyncClientDiscovery.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/HttpClientDiscovery.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/MessageFactoryDiscovery.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/NotFoundException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/CommonClassesStrategy.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/DiscoveryStrategy.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/MockClientStrategy.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/PuliBetaStrategy.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/StreamFactoryDiscovery.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/UriFactoryDiscovery.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/puli.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/HttpException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/NetworkException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/RequestException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/TransferException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/HttpAsyncClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/HttpClient.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Promise/HttpFulfilledPromise.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Promise/HttpRejectedPromise.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/puli.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/MessageFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/RequestFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/ResponseFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/StreamFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/UriFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/apigen.neon create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/puli.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/AutoBasicAuth.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/BasicAuth.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Bearer.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Chain.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Matching.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/QueryParam.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/RequestConditional.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Wsse.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Builder/ResponseBuilder.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Cookie.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/CookieJar.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/CookieUtil.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/MessageDecorator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/RequestDecorator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/ResponseDecorator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/StreamDecorator.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/ChunkStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/CompressStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DechunkStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DecompressStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DeflateStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/Filter/Chunk.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/FilteredStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/GzipDecodeStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/GzipEncodeStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/InflateStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Exception.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Exception/UnexpectedValueException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/CurlCommandFormatter.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/FullHttpMessageFormatter.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/SimpleFormatter.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/DiactorosMessageFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/GuzzleMessageFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/SlimMessageFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/CallbackRequestMatcher.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/RegexRequestMatcher.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/RequestMatcher.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Stream/BufferedStream.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/DiactorosStreamFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/GuzzleStreamFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/SlimStreamFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/DiactorosUriFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/GuzzleUriFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/SlimUriFactory.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/message/src/filters.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/ApacheMimetypeHelper.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/CustomMimetypeHelper.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/MimetypeHelper.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/MultipartStreamBuilder.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/promise/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/promise/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/promise/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/promise/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/FulfilledPromise.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/Promise.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/RejectedPromise.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/MessageInterface.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/RequestInterface.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/ResponseInterface.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/ServerRequestInterface.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/StreamInterface.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/UploadedFileInterface.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/UriInterface.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Debug/OptionsResolverIntrospector.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/AccessException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/ExceptionInterface.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/InvalidArgumentException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/InvalidOptionsException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/MissingOptionsException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/NoConfigurationException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/NoSuchOptionException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/OptionDefinitionException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/UndefinedOptionsException.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Options.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/OptionsResolver.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Tests/Debug/OptionsResolverIntrospectorTest.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Tests/OptionsResolverTest.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/phpunit.xml.dist create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.composer-auth.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.styleci.yml create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.travis.yml create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/CHANGELOG.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/LICENSE create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/README.md create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/appveyor.yml create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/composer.json create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/phpunit.xml.dist create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/src/Assert.php create mode 100644 Postman/Postman-Mail/mailgun/vendor/webmozart/assert/tests/AssertTest.php create mode 100644 Postman/Postman-Mail/postman_gmail.js create mode 100644 Postman/Postman-Mail/postman_mailgun.js create mode 100644 Postman/Postman-Mail/postman_mandrill.js create mode 100644 Postman/Postman-Mail/postman_sendgrid.js create mode 100644 Postman/Postman-Mail/postman_smtp.js create mode 100644 Postman/Postman-Mail/sendgrid/.editorconfig create mode 100644 Postman/Postman-Mail/sendgrid/.travis.yml create mode 100644 Postman/Postman-Mail/sendgrid/composer.json create mode 100644 Postman/Postman-Mail/sendgrid/composer.lock create mode 100644 Postman/Postman-Mail/sendgrid/sendgrid-php.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/autoload.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/composer/ClassLoader.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/composer/LICENSE create mode 100644 Postman/Postman-Mail/sendgrid/vendor/composer/autoload_classmap.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/composer/autoload_files.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/composer/autoload_namespaces.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/composer/autoload_psr4.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/composer/autoload_real.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/composer/installed.json create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.codeclimate.yml create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.github/ISSUE_TEMPLATE create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.github/PULL_REQUEST_TEMPLATE create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.travis.yml create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/CONTRIBUTING.md create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/Dockerfile create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/LICENSE.txt create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/README.md create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/composer.json create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/lib/Client.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/lib/Response.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.codeclimate.yml create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.editorconfig create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.env.sample create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.github/ISSUE_TEMPLATE create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.github/PULL_REQUEST_TEMPLATE create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.travis.yml create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/CODE_OF_CONDUCT.md create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/LICENSE.md create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/README.md create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/composer.json create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/Dockerfile create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/README.md create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/entrypoint.sh create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/SendGrid.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/README.md create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/Recipient.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/RecipientForm.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/loader.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Asm.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Attachment.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BatchId.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Bcc.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BccSettings.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BypassListManagement.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Category.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Cc.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/ClickTracking.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Content.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/CustomArg.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/EmailAddress.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Footer.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/From.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Ganalytics.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/GroupId.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/GroupsToDisplay.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Header.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/HtmlContent.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/IpPoolName.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Mail.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/MailSettings.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/MimeType.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/OpenTracking.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Personalization.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/PlainTextContent.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/README.md create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/ReplyTo.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SandBoxMode.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Section.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SendAt.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SpamCheck.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Subject.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SubscriptionTracking.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Substitution.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TemplateId.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/To.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TrackingSettings.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TypeException.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/stats/Stats.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/phpcs.xml create mode 100755 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/scripts/package.sh create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/sendgrid-php.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/BaseTestClass.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/data/test.txt create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Alerts/AlertsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/ApiKeys/ApiKeysTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Asm/AsmGroupsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Asm/AsmSuppressionTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Campaigns/CampaignsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Categories/CategoriesTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Contacts/ContactDbTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpPoolsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpsWarmupTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailBatchTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailSendTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailSettingsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailboxProvidersTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Scopes/ScopesTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/DomainAuthenticationTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/LinkBrandingTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/ReverseDNSTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Senders/SendersTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/AccessSettingsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/PartnerSettingsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/TrackingSettingsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/BrowserStatsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/ClientsStatsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/DevicesStatsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/GeoStatsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/StatsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Subusers/SubUsersTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionBlocksTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionBouncesTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionInvalidEmailsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionSpamReportsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionUnsubscribesTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Templates/TemplatesTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Users/UserTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/helpers/contacts/RecipientsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/helpers/stats/StatsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/phpunit.xml.dist create mode 100755 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/prism.sh create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/AttachmentsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/DynamicTemplateTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/FilesExistTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/KitchenSinkTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MailGetContentsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MailHelperTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MultipleEmailToMultipleRecipientsTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SendGridTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SingleEmailToASingleRecipientTest.php create mode 100644 Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SingleEmailToMultipleRecipientsTest.php create mode 100644 Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php create mode 100644 Postman/Postman-Send-Test-Email/postman_send_test_email.css create mode 100644 Postman/Postman-Send-Test-Email/postman_send_test_email.js create mode 100644 Postman/Postman.php create mode 100644 Postman/PostmanAdminController.php create mode 100644 Postman/PostmanAjaxController.php create mode 100644 Postman/PostmanConfigTextHelper.php create mode 100644 Postman/PostmanEmailLogs.php create mode 100644 Postman/PostmanInputSanitizer.php create mode 100644 Postman/PostmanInstaller.php create mode 100644 Postman/PostmanLogFields.php create mode 100644 Postman/PostmanLogger.php create mode 100644 Postman/PostmanMessageHandler.php create mode 100644 Postman/PostmanOAuthToken.php create mode 100644 Postman/PostmanOptions.php create mode 100644 Postman/PostmanPluginFeedback.php create mode 100644 Postman/PostmanPreRequisitesCheck.php create mode 100644 Postman/PostmanSession.php create mode 100644 Postman/PostmanState.php create mode 100644 Postman/PostmanUtils.php create mode 100644 Postman/PostmanViewController.php create mode 100644 Postman/PostmanWpMail.php create mode 100644 Postman/PostmanWpMailBinder.php create mode 100644 Postman/extra/donation.php create mode 100644 Postman/extra/no-localhost-mails.php create mode 100644 Postman/languages/postman-smtp-el_GR.mo create mode 100644 Postman/languages/postman-smtp-el_GR.po create mode 100644 Postman/languages/postman-smtp-fr_FR.mo create mode 100644 Postman/languages/postman-smtp-fr_FR.po create mode 100644 Postman/languages/postman-smtp-it_IT.mo create mode 100644 Postman/languages/postman-smtp-it_IT.po create mode 100644 Postman/languages/postman-smtp-nl_NL.mo create mode 100644 Postman/languages/postman-smtp-nl_NL.po create mode 100644 Postman/languages/postman-smtp-ru_RU.mo create mode 100644 Postman/languages/postman-smtp-ru_RU.po create mode 100644 Postman/languages/postman-smtp-tr_TR.mo create mode 100644 Postman/languages/postman-smtp-tr_TR.po create mode 100644 Postman/languages/postman-smtp-zh_CN.mo create mode 100644 Postman/languages/postman-smtp-zh_CN.po create mode 100644 Postman/languages/postman-smtp.pot create mode 100644 Postman/notifications/INotify.php create mode 100644 Postman/notifications/PostmanMailNotify.php create mode 100644 Postman/notifications/PostmanNotify.php create mode 100644 Postman/notifications/PostmanPushoverNotify.php create mode 100644 Postman/notifications/PostmanSlackNotify.php diff --git a/Postman/Phpmailer/PostsmtpMailer.php b/Postman/Phpmailer/PostsmtpMailer.php new file mode 100644 index 0000000..b3a421b --- /dev/null +++ b/Postman/Phpmailer/PostsmtpMailer.php @@ -0,0 +1,125 @@ +options = PostmanOptions::getInstance(); + add_filter( 'postman_wp_mail_result', [ $this, 'postman_wp_mail_result' ] ); + } + + public function send() + { + require_once dirname(__DIR__) . '/PostmanWpMail.php'; + + // create a PostmanWpMail instance + $postmanWpMail = new PostmanWpMail(); + $postmanWpMail->init(); + + $senderEmail = $this->options->getMessageSenderEmail(); + $senderName = $this->options->getMessageSenderName(); + + // create a PostmanMessage instance + $message = $postmanWpMail->createNewMessage(); + + $message->setFrom( $senderEmail, $senderName ); + $message->addHeaders( $this->getHeaders() ); + $message->setBodyTextPart( $this->AltBody ); + $message->setBodyHtmlPart( $this->Body ); + $message->setBody( $this->Body ); + $message->setSubject( $this->Subject ); + $message->addTo( $this->flatArray($this->getToAddresses() ) ); + $message->setReplyTo( $this->flatArray( $this->getReplyToAddresses() ) ); + $message->addCc( $this->flatArray($this->getCcAddresses() ) ); + $message->addBCc( $this->flatArray( $this->getBccAddresses() ) ); + $message->setReplyTo( $this->flatArray( $this->getReplyToAddresses() ) ); + $message->setAttachments( $this->getAttachments() ); + + // create a PostmanEmailLog instance + $log = new PostmanEmailLog(); + + $log->originalTo = $this->flatArray($this->getToAddresses() ); + $log->originalSubject = $this->Subject; + $log->originalMessage = $this->Body; + $log->originalHeaders = $this->getCustomHeaders(); + + try { + return $postmanWpMail->sendMessage( $message, $log ); + } catch (phpmailerException $exc) { + + $this->error = $exc; + + $this->mailHeader = ''; + $this->setError($exc->getMessage()); + if ($this->exceptions) { + throw $exc; + } + return false; + } + + } + + public function getAttachments() { + $attachments = parent::getAttachments(); + + $data = array(); + foreach ( $attachments as $attachment ) { + $data[] = $attachment[0]; + } + + return $data; + } + + private function getHeaders() { + $headers = array(); + foreach ( $this->getCustomHeaders() as $header ) { + $headers[] = "{$header[0]}: {$header[1]}"; + } + + return $headers; + } + + public function postman_wp_mail_result() { + $result = [ + 'time' => '', + 'exception' => $this->error, + 'transcript' => '', + ]; + return $result; + } + + private function flatArray($arr) { + $result = []; + foreach ( $arr as $key => $value ) { + if ( is_array( $value ) ) { + foreach ($value as $k => $v ) { + if ( empty( $v ) ) { + continue; + } + $value = $v; + } + } + + $result[] = $value; + } + + return implode(',', $result ); + } +} \ No newline at end of file diff --git a/Postman/Postman-Auth/PostmanAbstractAuthenticationManager.php b/Postman/Postman-Auth/PostmanAbstractAuthenticationManager.php new file mode 100644 index 0000000..7402ba7 --- /dev/null +++ b/Postman/Postman-Auth/PostmanAbstractAuthenticationManager.php @@ -0,0 +1,171 @@ +logger = $logger; + $this->clientId = $clientId; + $this->clientSecret = $clientSecret; + $this->authorizationToken = $authorizationToken; + $this->callbackUri = $callbackUri; + } + protected function getLogger() { + return $this->logger; + } + protected function getClientId() { + return $this->clientId; + } + protected function getClientSecret() { + return $this->clientSecret; + } + protected function getAuthorizationToken() { + return $this->authorizationToken; + } + + /** + * Create a state token to prevent request forgery. + * Store it in the session for later validation. + */ + public function generateRequestTransactionId() { + return $state = md5 ( rand () ); + } + + /** + */ + public function isAccessTokenExpired() { + $expireTime = ($this->authorizationToken->getExpiryTime () - self::FORCE_REFRESH_X_SECONDS_BEFORE_EXPIRE); + $tokenHasExpired = time () > $expireTime; + $this->logger->debug ( 'Access Token Expiry Time is ' . $expireTime . ', expires_in=' . ($expireTime - time ()) . ', expired=' . ($tokenHasExpired ? 'yes' : 'no') ); + return $tokenHasExpired; + } + + /** + * Decoded the received token + * This code is identical for Google and Hotmail + * + * @param mixed $response + * @throws Exception + */ + protected function processResponse($response) { + $authToken = json_decode ( stripslashes ( $response ) ); + if ($authToken === NULL) { + $this->getLogger ()->error ( $response ); + throw new Exception ( $response ); + } else if (isset ( $authToken->{'error'} )) { + if (isset ( $authToken->{'error_description'} )) { + $this->getLogger ()->error ( $authToken->{'error'} . ' processing response: ' . $authToken->{'error_description'} ); + throw new Exception ( $authToken->{'error_description'} . '(' . $authToken->{'error'} . ')' ); + } else { + // Yahoo doesn't give descriptions + $this->getLogger ()->error ( $authToken->{'error'} . ' processing response' ); + throw new Exception ( $authToken->{'error'} ); + } + } else { + $this->getLogger ()->trace ( 'Processing response:' ); + $this->getLogger ()->trace ( $response ); + $this->decodeReceivedAuthorizationToken ( $authToken ); + } + } + + /** + * Parses the authorization token and extracts the expiry time, accessToken, + * and if this is a first-time authorization, a refresh token. + * + * This code is identical for Google and Hotmail + * + * @param mixed $client + */ + protected function decodeReceivedAuthorizationToken($newtoken) { + assert ( ! empty ( $newtoken ) ); + assert ( ! empty ( $newtoken->{self::EXPIRES} ) ); + assert ( ! empty ( $newtoken->{self::ACCESS_TOKEN} ) ); + + // update expiry time + if (empty ( $newtoken->{self::EXPIRES} )) { + throw new Exception ( '[expires_in] value is missing from the authentication token' ); + } + $newExpiryTime = time () + $newtoken->{self::EXPIRES}; + $this->getAuthorizationToken ()->setExpiryTime ( $newExpiryTime ); + $this->getLogger ()->debug ( 'Updating Access Token Expiry Time ' ); + + // update acccess token + if (empty ( $newtoken->{self::ACCESS_TOKEN} )) { + throw new Exception ( '[access_token] value is missing from the authentication token' ); + } + $newAccessToken = $newtoken->{self::ACCESS_TOKEN}; + $this->getAuthorizationToken ()->setAccessToken ( $newAccessToken ); + $this->getLogger ()->debug ( 'Updating Access Token' ); + + // update refresh token, if there is one + if (isset ( $newtoken->{self::REFRESH_TOKEN} )) { + $newRefreshToken = $newtoken->{self::REFRESH_TOKEN}; + $this->getAuthorizationToken ()->setRefreshToken ( $newRefreshToken ); + $this->getLogger ()->debug ( 'Updating Refresh Token ' ); + } + } + + /** + * Given an OAuth provider-specific URL and redirectUri, + * issue an HttpRequest to refresh the access token + * + * This code is identical for Google and Hotmail + */ + public function refreshToken() { + $this->getLogger ()->debug ( 'Refreshing Token' ); + $refreshUrl = $this->getTokenUrl (); + $callbackUrl = $this->getCallbackUri (); + assert ( ! empty ( $refreshUrl ) ); + assert ( ! empty ( $callbackUrl ) ); + // the format of the URL is + // client_id=CLIENT_ID&client_secret=CLIENT_SECRET&redirect_uri=REDIRECT_URI&grant_type=refresh_token&refresh_token=REFRESH_TOKEN + $postvals = array ( + 'client_id' => $this->getClientId (), + 'client_secret' => $this->getClientSecret (), + 'redirect_uri' => $callbackUrl, + 'grant_type' => 'refresh_token', + 'refresh_token' => $this->getAuthorizationToken ()->getRefreshToken () + ); + // example request string + // client_id=0000000603DB0F&redirect_uri=http%3A%2F%2Fwww.contoso.com%2Fcallback.php&client_secret=LWILlT555GicSrIATma5qgyBXebRI&refresh_token=*LA9...//refresh token string shortened for example//...xRoX&grant_type=refresh_token + $response = PostmanUtils::remotePostGetBodyOnly ( $refreshUrl, $postvals ); + $this->processResponse ( $response ); + } + /** + * (non-PHPdoc) + * + * @see PostmanAuthenticationManager::getCallbackUri() + */ + public function getCallbackUri() { + return $this->callbackUri; + } + } +} diff --git a/Postman/Postman-Auth/PostmanAuthenticationManager.php b/Postman/Postman-Auth/PostmanAuthenticationManager.php new file mode 100644 index 0000000..c405459 --- /dev/null +++ b/Postman/Postman-Auth/PostmanAuthenticationManager.php @@ -0,0 +1,18 @@ +logger = new PostmanLogger ( get_class ( $this ) ); + } + public function createAuthenticationManager() { + $transport = PostmanTransportRegistry::getInstance ()->getSelectedTransport (); + return $this->createManager ( $transport ); + } + private function createManager(PostmanZendModuleTransport $transport) { + $options = PostmanOptions::getInstance (); + $authorizationToken = PostmanOAuthToken::getInstance (); + $authenticationType = $options->getAuthenticationType (); + $hostname = $options->getHostname (); + $clientId = $options->getClientId (); + $clientSecret = $options->getClientSecret (); + $senderEmail = $options->getMessageSenderEmail (); + $scribe = $transport->getScribe (); + $redirectUrl = $scribe->getCallbackUrl (); + if ($transport->isOAuthUsed ( $options->getAuthenticationType () )) { + if ($transport->isServiceProviderGoogle ( $hostname )) { + $authenticationManager = new PostmanGoogleAuthenticationManager ( $clientId, $clientSecret, $authorizationToken, $redirectUrl, $senderEmail ); + } else if ($transport->isServiceProviderMicrosoft ( $hostname )) { + $authenticationManager = new PostmanMicrosoftAuthenticationManager ( $clientId, $clientSecret, $authorizationToken, $redirectUrl ); + } else if ($transport->isServiceProviderYahoo ( $hostname )) { + $authenticationManager = new PostmanYahooAuthenticationManager ( $clientId, $clientSecret, $authorizationToken, $redirectUrl ); + } else { + assert ( false ); + } + } else { + $authenticationManager = new PostmanNonOAuthAuthenticationManager (); + } + $this->logger->debug ( 'Created ' . get_class ( $authenticationManager ) ); + return $authenticationManager; + } + } +} \ No newline at end of file diff --git a/Postman/Postman-Auth/PostmanGoogleAuthenticationManager.php b/Postman/Postman-Auth/PostmanGoogleAuthenticationManager.php new file mode 100644 index 0000000..c00afba --- /dev/null +++ b/Postman/Postman-Auth/PostmanGoogleAuthenticationManager.php @@ -0,0 +1,122 @@ +senderEmail = $senderEmail; + parent::__construct ( $logger, $clientId, $clientSecret, $authorizationToken, $callbackUri ); + } + + /** + * The authorization sequence begins when your application redirects a browser to a Google URL; + * the URL includes query parameters that indicate the type of access being requested. + * + * As in other scenarios, Google handles user authentication, session selection, and user consent. + * The result is an authorization code, which Google returns to your application in a query string. + * + * (non-PHPdoc) + * + * @see PostmanAuthenticationManager::requestVerificationCode() + */ + public function requestVerificationCode($transactionId) { + $params = array ( + 'response_type' => 'code', + 'redirect_uri' => urlencode ( $this->getCallbackUri () ), + 'client_id' => $this->getClientId (), + 'scope' => urlencode ( self::SCOPE_FULL_ACCESS ), + 'access_type' => 'offline', + 'approval_prompt' => 'force', + 'state' => $transactionId, + 'login_hint' => $this->senderEmail + ); + + $authUrl = $this->getAuthorizationUrl () . '?' . build_query ( $params ); + + $this->getLogger ()->debug ( 'Requesting verification code from Google' ); + PostmanUtils::redirect ( $authUrl ); + } + + /** + * After receiving the authorization code, your application can exchange the code + * (along with a client ID and client secret) for an access token and, in some cases, + * a refresh token. + * + * This code is identical for Google and Hotmail + * + * @see PostmanAuthenticationManager::processAuthorizationGrantCode() + */ + public function processAuthorizationGrantCode($transactionId) { + if (isset ( $_GET ['code'] )) { + $this->getLogger ()->debug ( 'Found authorization code in request header' ); + $code = filter_input( INPUT_GET, 'code', FILTER_SANITIZE_STRING ); + if (isset ( $_GET ['state'] ) && $_GET ['state'] == $transactionId) { + $this->getLogger ()->debug ( 'Found valid state in request header' ); + } else { + $this->getLogger ()->error ( 'The grant code from Google had no accompanying state and may be a forgery' ); + throw new PostmanStateIdMissingException (); + } + $postvals = array ( + 'client_id' => $this->getClientId (), + 'client_secret' => $this->getClientSecret (), + 'grant_type' => 'authorization_code', + 'redirect_uri' => $this->getCallbackUri (), + 'code' => $code + ); + $response = PostmanUtils::remotePostGetBodyOnly ( $this->getTokenUrl (), $postvals ); + $this->processResponse ( $response ); + $this->getAuthorizationToken ()->setVendorName ( self::VENDOR_NAME ); + return true; + } else { + $this->getLogger ()->debug ( 'Expected code in the request header but found none - user probably denied request' ); + return false; + } + } + public function getAuthorizationUrl() { + return self::GOOGLE_ENDPOINT; + } + public function getTokenUrl() { + return self::GOOGLE_REFRESH; + } + } +} diff --git a/Postman/Postman-Auth/PostmanMicrosoftAuthenticationManager.php b/Postman/Postman-Auth/PostmanMicrosoftAuthenticationManager.php new file mode 100644 index 0000000..96fb529 --- /dev/null +++ b/Postman/Postman-Auth/PostmanMicrosoftAuthenticationManager.php @@ -0,0 +1,107 @@ + 'code', + 'redirect_uri' => urlencode ( $this->getCallbackUri () ), + 'client_id' => $this->getClientId (), + 'client_secret' => $this->getClientSecret (), + 'scope' => urlencode ( self::SCOPE ), + 'access_type' => 'offline', + 'approval_prompt' => 'force' + ); + + $authUrl = $this->getAuthorizationUrl () . '?' . build_query ( $params ); + + $this->getLogger ()->debug ( 'Requesting verification code from Microsoft' ); + PostmanUtils::redirect ( $authUrl ); + } + + /** + * ********************************************** + * If we have a code back from the OAuth 2.0 flow, + * we need to exchange that for an access token. + * We store the resultant access token + * bundle in the session, and redirect to ourself. + * ********************************************** + */ + public function processAuthorizationGrantCode($transactionId) { + if (isset ( $_GET ['code'] )) { + $code = filter_input( INPUT_GET, 'code', FILTER_SANITIZE_STRING ); + $this->getLogger ()->debug ( 'Found authorization code in request header' ); + $postvals = array ( + 'client_id' => $this->getClientId (), + 'client_secret' => $this->getClientSecret (), + 'grant_type' => 'authorization_code', + 'redirect_uri' => $this->getCallbackUri (), + 'code' => $code + ); + $response = PostmanUtils::remotePostGetBodyOnly ( $this->getTokenUrl (), $postvals ); + $this->processResponse ( $response ); + $this->getAuthorizationToken ()->setVendorName ( self::VENDOR_NAME ); + return true; + } else { + $this->getLogger ()->debug ( 'Expected code in the request header but found none - user probably denied request' ); + return false; + } + } + public function getAuthorizationUrl() { + return self::WINDOWS_LIVE_ENDPOINT; + } + public function getTokenUrl() { + return self::WINDOWS_LIVE_REFRESH; + } + } +} diff --git a/Postman/Postman-Auth/PostmanNonOAuthAuthenticationManager.php b/Postman/Postman-Auth/PostmanNonOAuthAuthenticationManager.php new file mode 100644 index 0000000..ed4f0c3 --- /dev/null +++ b/Postman/Postman-Auth/PostmanNonOAuthAuthenticationManager.php @@ -0,0 +1,46 @@ + 'code', + 'redirect_uri' => urlencode ( $this->getCallbackUri () ), + 'client_id' => $this->getClientId (), + 'state' => $transactionId, + 'language' => get_locale () + ); + + $authUrl = $this->getAuthorizationUrl () . '?' . build_query ( $params ); + + $this->getLogger ()->debug ( 'Requesting verification code from Yahoo' ); + PostmanUtils::redirect ( $authUrl ); + } + + /** + * After receiving the authorization code, your application can exchange the code + * (along with a client ID and client secret) for an access token and, in some cases, + * a refresh token. + * + * (non-PHPdoc) + * + * @see PostmanAuthenticationManager::processAuthorizationGrantCode() + */ + public function processAuthorizationGrantCode($transactionId) { + if (isset ( $_GET ['code'] )) { + $code = filter_input( INPUT_GET, 'code', FILTER_SANITIZE_STRING ); + $this->getLogger ()->debug ( sprintf ( 'Found authorization code %s in request header', $code ) ); + if (isset ( $_GET ['state'] ) && $_GET ['state'] == $transactionId) { + $this->getLogger ()->debug ( 'Found valid state in request header' ); + } else { + $this->getLogger ()->error ( 'The grant code from Yahoo had no accompanying state and may be a forgery' ); + throw new PostmanStateIdMissingException (); + } + // Note: The Authorization: Basic authorization header is generated through a Base64 encoding of client_id:client_secret per RFC 2617. + // header("Authorization: Basic " . base64_encode($username . ":" . $password); + $headers = array ( + 'Authorization' => sprintf ( "Basic %s", base64_encode ( $this->getClientId () . ':' . $this->getClientSecret () ) ) + ); + $postvals = array ( + 'code' => $code, + 'grant_type' => 'authorization_code', + 'redirect_uri' => $this->getCallbackUri () + ); + $response = PostmanUtils::remotePostGetBodyOnly ( $this->getTokenUrl (), $postvals, $headers ); + $this->processResponse ( $response ); + $this->getAuthorizationToken ()->setVendorName ( self::VENDOR_NAME ); + return true; + } else { + $this->getLogger ()->debug ( 'Expected code in the request header but found none - user probably denied request' ); + return false; + } + } + + /** + * Step 5: Exchange refresh token for new access token + * After the access token expires, you can use the refresh token, which has a long lifetime, to get a new access token. + */ + public function refreshToken() { + $this->getLogger ()->debug ( 'Refreshing Token' ); + $refreshUrl = $this->getTokenUrl (); + $callbackUrl = $this->getCallbackUri (); + assert ( ! empty ( $refreshUrl ) ); + assert ( ! empty ( $callbackUrl ) ); + $headers = array ( + 'Authorization' => sprintf ( "Basic %s", base64_encode ( $this->getClientId () . ':' . $this->getClientSecret () ) ) + ); + $postvals = array ( + 'redirect_uri' => $callbackUrl, + 'grant_type' => 'refresh_token', + 'refresh_token' => $this->getAuthorizationToken ()->getRefreshToken () + ); + $response = PostmanUtils::remotePostGetBodyOnly ( $this->getTokenUrl (), $postvals, $headers ); + $this->processResponse ( $response ); + } + public function getAuthorizationUrl() { + return self::AUTHORIZATION_URL; + } + public function getTokenUrl() { + return self::GET_TOKEN_URL; + } + } +} diff --git a/Postman/Postman-Configuration/PostmanConfigurationController.php b/Postman/Postman-Configuration/PostmanConfigurationController.php new file mode 100644 index 0000000..59fbdb8 --- /dev/null +++ b/Postman/Postman-Configuration/PostmanConfigurationController.php @@ -0,0 +1,948 @@ +logger = new PostmanLogger( get_class( $this ) ); + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->options = PostmanOptions::getInstance(); + $this->settingsRegistry = new PostmanSettingsRegistry(); + + PostmanUtils::registerAdminMenu( $this, 'addConfigurationSubmenu' ); + PostmanUtils::registerAdminMenu( $this, 'addSetupWizardSubmenu' ); + + // hook on the init event + add_action( 'init', array( + $this, + 'on_init', + ) ); + + // initialize the scripts, stylesheets and form fields + add_action( 'admin_init', array( + $this, + 'on_admin_init', + ) ); + } + + /** + * Functions to execute on the init event + * + * "Typically used by plugins to initialize. The current user is already authenticated by this time." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_a_Typical_Request + */ + public function on_init() { + // register Ajax handlers + new PostmanGetHostnameByEmailAjaxController(); + new PostmanManageConfigurationAjaxHandler(); + new PostmanImportConfigurationAjaxController( $this->options ); + } + + /** + * Fires on the admin_init method + */ + public function on_admin_init() { + $this->registerStylesAndScripts(); + $this->settingsRegistry->on_admin_init(); + } + + /** + * Register and add settings + */ + private function registerStylesAndScripts() { + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'registerStylesAndScripts()' ); + } + // register the stylesheet and javascript external resources + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + + wp_register_script( 'postman_manual_config_script', plugins_url( 'Postman/Postman-Configuration/postman_manual_config.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + 'jquery-ui-core', + 'jquery-ui-tabs', + 'jquery_validation', + PostmanViewController::POSTMAN_SCRIPT, + ), $pluginData ['version'] ); + + wp_register_script( 'postman_wizard_script', plugins_url( 'Postman/Postman-Configuration/postman_wizard.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + 'jquery_steps_script', + PostmanViewController::POSTMAN_SCRIPT, + 'sprintf', + ), $pluginData ['version'] ); + } + + /** + */ + private function addLocalizeScriptsToPage() { + $warning = __( 'Warning', 'post-smtp' ); + /* translators: where %s is the name of the SMTP server */ + wp_localize_script( 'postman_wizard_script', 'postman_smtp_mitm', sprintf( '%s: %s', $warning, __( 'connected to %1$s instead of %2$s.', 'post-smtp' ) ) ); + /* translators: where %d is a port number */ + wp_localize_script( 'postman_wizard_script', 'postman_wizard_bad_redirect_url', __( 'You are about to configure OAuth 2.0 with an IP address instead of a domain name. This is not permitted. Either assign a real domain name to your site or add a fake one in your local host file.', 'post-smtp' ) ); + + // user input + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_input_sender_email', '#input_' . PostmanOptions::MESSAGE_SENDER_EMAIL ); + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_input_sender_name', '#input_' . PostmanOptions::MESSAGE_SENDER_NAME ); + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_port_element_name', '#input_' . PostmanOptions::PORT ); + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_hostname_element_name', '#input_' . PostmanOptions::HOSTNAME ); + + // the enc input + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_enc_for_password_el', '#input_enc_type_password' ); + // these are the ids for the '; + printf( $optionPattern, $optionKey, $optionKey == $currentKey ? 'selected="selected"' : '', $label ); + } + public function runModeCallback() { + $inputDescription = __( 'Delivery mode offers options useful for developing or testing.', 'post-smtp' ); + printf( '
%s', $inputDescription ); + } + + public function stealthModeCallback() { + printf( ' %4$s', PostmanOptions::POSTMAN_OPTIONS, PostmanOptions::STEALTH_MODE, $this->options->isStealthModeEnabled() ? 'checked="checked"' : '', __( 'Remove the Postman X-Header signature from messages', 'post-smtp' ) ); + } + + public function temporaryDirectoryCallback() { + $inputDescription = __( 'Lockfiles are written here to prevent users from triggering an OAuth 2.0 token refresh at the same time.' ); + printf( '', PostmanOptions::POSTMAN_OPTIONS, PostmanOptions::TEMPORARY_DIRECTORY, $this->options->getTempDirectory() ); + if ( PostmanState::getInstance()->isFileLockingEnabled() ) { + printf( ' %s
%s', __( 'Valid', 'post-smtp' ), $inputDescription ); + } else { + printf( ' %s
%s', __( 'Invalid', 'post-smtp' ), $inputDescription ); + } + } + + /** + * Get the settings option array and print one of its values + */ + public function connection_timeout_callback() { + printf( '', PostmanOptions::POSTMAN_OPTIONS, PostmanOptions::CONNECTION_TIMEOUT, $this->options->getConnectionTimeout() ); + } + + /** + * Get the settings option array and print one of its values + */ + public function read_timeout_callback() { + printf( '', PostmanOptions::POSTMAN_OPTIONS, PostmanOptions::READ_TIMEOUT, $this->options->getReadTimeout() ); + } + + /** + * Get the settings option array and print one of its values + */ + public function port_callback( $args ) { + printf( '', null !== $this->options->getPort() ? esc_attr( $this->options->getPort() ) : '', isset( $args ['style'] ) ? $args ['style'] : '', __( 'Required', 'post-smtp' ) ); + } +} diff --git a/Postman/Postman-Configuration/PostmanSmtpDiscovery.php b/Postman/Postman-Configuration/PostmanSmtpDiscovery.php new file mode 100644 index 0000000..67a58b3 --- /dev/null +++ b/Postman/Postman-Configuration/PostmanSmtpDiscovery.php @@ -0,0 +1,237 @@ + 'smtp.1and1.com', + 'airmail.net' => 'smtp.airmail.net', + 'aol.com' => 'smtp.aol.com', + 'Bluewin.ch' => 'Smtpauths.bluewin.ch', + 'Comcast.net' => 'Smtp.comcast.net', + 'Earthlink.net' => 'Smtpauth.earthlink.net', + 'gmail.com' => 'smtp.gmail.com', + 'Gmx.com' => 'mail.gmx.com', + 'Gmx.net' => 'mail.gmx.com', + 'Gmx.us' => 'mail.gmx.com', + 'hotmail.com' => 'smtp.live.com', + 'icloud.com' => 'smtp.mail.me.com', + 'mail.com' => 'smtp.mail.com', + 'ntlworld.com' => 'smtp.ntlworld.com', + 'rocketmail.com' => 'plus.smtp.mail.yahoo.com', + 'rogers.com' => 'smtp.broadband.rogers.com', + 'yahoo.ca' => 'smtp.mail.yahoo.ca', + 'yahoo.co.id' => 'smtp.mail.yahoo.co.id', + 'yahoo.co.in' => 'smtp.mail.yahoo.co.in', + 'yahoo.co.kr' => 'smtp.mail.yahoo.com', + 'yahoo.com' => 'smtp.mail.yahoo.com', + 'yahoo.com.ar' => 'smtp.mail.yahoo.com.ar', + 'yahoo.com.au' => 'smtp.mail.yahoo.com.au', + 'yahoo.com.br' => 'smtp.mail.yahoo.com.br', + 'yahoo.com.cn' => 'smtp.mail.yahoo.com.cn', + 'yahoo.com.hk' => 'smtp.mail.yahoo.com.hk', + 'yahoo.com.mx' => 'smtp.mail.yahoo.com', + 'yahoo.com.my' => 'smtp.mail.yahoo.com.my', + 'yahoo.com.ph' => 'smtp.mail.yahoo.com.ph', + 'yahoo.com.sg' => 'smtp.mail.yahoo.com.sg', + 'yahoo.com.tw' => 'smtp.mail.yahoo.com.tw', + 'yahoo.com.vn' => 'smtp.mail.yahoo.com.vn', + 'yahoo.co.nz' => 'smtp.mail.yahoo.com.au', + 'yahoo.co.th' => 'smtp.mail.yahoo.co.th', + 'yahoo.co.uk' => 'smtp.mail.yahoo.co.uk', + 'yahoo.de' => 'smtp.mail.yahoo.de', + 'yahoo.es' => 'smtp.correo.yahoo.es', + 'yahoo.fr' => 'smtp.mail.yahoo.fr', + 'yahoo.ie' => 'smtp.mail.yahoo.co.uk', + 'yahoo.it' => 'smtp.mail.yahoo.it', + 'zoho.com' => 'smtp.zoho.com', + // from http://www.att.com/esupport/article.jsp?sid=KB401570&cv=801 + 'ameritech.net' => 'outbound.att.net', + 'att.net' => 'outbound.att.net', + 'bellsouth.net' => 'outbound.att.net', + 'flash.net' => 'outbound.att.net', + 'nvbell.net' => 'outbound.att.net', + 'pacbell.net' => 'outbound.att.net', + 'prodigy.net' => 'outbound.att.net', + 'sbcglobal.net' => 'outbound.att.net', + 'snet.net' => 'outbound.att.net', + 'swbell.net' => 'outbound.att.net', + 'wans.net' => 'outbound.att.net' + ); + // if an email's mx is in this domain array, it is a known smtp server (dns lookup) + // useful for custom domains that map to a mail service + private static $mxMappings = array ( + '1and1help.com' => 'smtp.1and1.com', + 'google.com' => 'smtp.gmail.com', + 'Gmx.net' => 'mail.gmx.com', + 'icloud.com' => 'smtp.mail.me.com', + 'hotmail.com' => 'smtp.live.com', + 'mx-eu.mail.am0.yahoodns.net' => 'smtp.mail.yahoo.com', + // 'mail.protection.outlook.com' => 'smtp.office365.com', + // 'mail.eo.outlook.com' => 'smtp.office365.com', + 'outlook.com' => 'smtp.office365.com', + 'biz.mail.am0.yahoodns.net' => 'smtp.bizmail.yahoo.com', + 'BIZ.MAIL.YAHOO.com' => 'smtp.bizmail.yahoo.com', + 'hushmail.com' => 'smtp.hushmail.com', + 'gmx.net' => 'mail.gmx.com', + 'mandrillapp.com' => 'smtp.mandrillapp.com', + 'smtp.secureserver.net' => 'relay-hosting.secureserver.net', + 'presmtp.ex1.secureserver.net' => 'smtp.ex1.secureserver.net', + 'presmtp.ex2.secureserver.net' => 'smtp.ex2.secureserver.net', + 'presmtp.ex3.secureserver.net' => 'smtp.ex2.secureserver.net', + 'presmtp.ex4.secureserver.net' => 'smtp.ex2.secureserver.net', + 'htvhosting.com' => 'mail.htvhosting.com' + ); + public static function getSmtpFromEmail($hostname) { + reset ( PostmanSmtpMappings::$emailDomain ); + foreach ( PostmanSmtpMappings::$emailDomain as $domain => $smtp ) { + if (strcasecmp ( $hostname, $domain ) == 0) { + return $smtp; + } + } + return false; + } + public static function getSmtpFromMx($mx) { + reset ( PostmanSmtpMappings::$mxMappings ); + foreach ( PostmanSmtpMappings::$mxMappings as $domain => $smtp ) { + if (PostmanUtils::endswith ( $mx, $domain )) { + return $smtp; + } + } + return false; + } + } +} +if (! class_exists ( 'PostmanSmtpDiscovery' )) { + class PostmanSmtpDiscovery { + + // private instance variables + public $isGoogle; + public $isGoDaddy; + public $isWellKnownDomain; + private $smtpServer; + private $primaryMx; + private $email; + private $domain; + + /** + * Constructor + * + * @param mixed $email + */ + public function __construct($email) { + $this->email = $email; + $this->determineSmtpServer ( $email ); + $this->isGoogle = $this->smtpServer == 'smtp.gmail.com'; + $this->isGoDaddy = $this->smtpServer == 'relay-hosting.secureserver.net'; + } + /** + * The SMTP server we suggest to use - this is determined + * by looking up the MX hosts for the domain. + */ + public function getSmtpServer() { + return $this->smtpServer; + } + public function getPrimaryMx() { + return $this->primaryMx; + } + /** + * + * @param mixed $email + * @return string|bool + */ + private function validateEmail($email) { + return PostmanUtils::validateEmail ( $email ); + } + private function determineSmtpServer($email) { + $hostname = substr ( strrchr ( $email, "@" ), 1 ); + $this->domain = $hostname; + $smtp = PostmanSmtpMappings::getSmtpFromEmail ( $hostname ); + if ($smtp) { + $this->smtpServer = $smtp; + $this->isWellKnownDomain = true; + return true; + } else { + $host = strtolower ( $this->findMxHostViaDns ( $hostname ) ); + if ($host) { + $this->primaryMx = $host; + $smtp = PostmanSmtpMappings::getSmtpFromMx ( $host ); + if ($smtp) { + $this->smtpServer = $smtp; + return true; + } else { + return false; + } + } else { + return false; + } + } + } + + /** + * Uses getmxrr to retrieve the MX records of a hostname + * + * @param mixed $hostname + * @return mixed|boolean + */ + private function findMxHostViaDns($hostname) { + if (function_exists ( 'getmxrr' )) { + $b_mx_avail = getmxrr ( $hostname, $mx_records, $mx_weight ); + } else { + $b_mx_avail = $this->getmxrr ( $hostname, $mx_records, $mx_weight ); + } + if ($b_mx_avail && sizeof ( $mx_records ) > 0) { + // copy mx records and weight into array $mxs + $mxs = array (); + + for($i = 0; $i < count ( $mx_records ); $i ++) { + $mxs [$mx_weight [$i]] = $mx_records [$i]; + } + + // sort array mxs to get servers with highest prio + ksort ( $mxs, SORT_NUMERIC ); + reset ( $mxs ); + $mxs_vals = array_values ( $mxs ); + return array_shift ( $mxs_vals ); + } else { + return false; + } + } + /** + * This is a custom implementation of mxrr for Windows PHP installations + * which don't have this method natively. + * + * @param mixed $hostname + * @param mixed $mxhosts + * @param mixed $mxweight + * @return boolean + */ + function getmxrr($hostname, &$mxhosts, &$mxweight) { + if (! is_array ( $mxhosts )) { + $mxhosts = array (); + } + $hostname = escapeshellarg ( $hostname ); + if (! empty ( $hostname )) { + $output = ""; + @exec ( "nslookup.exe -type=MX $hostname.", $output ); + $imx = - 1; + + foreach ( $output as $line ) { + $imx ++; + $parts = ""; + if (preg_match ( "/^$hostname\tMX preference = ([0-9]+), mail exchanger = (.*)$/", $line, $parts )) { + $mxweight [$imx] = $parts [1]; + $mxhosts [$imx] = $parts [2]; + } + } + return ($imx != - 1); + } + return false; + } + } +} + diff --git a/Postman/Postman-Configuration/postman_manual_config.js b/Postman/Postman-Configuration/postman_manual_config.js new file mode 100644 index 0000000..49438fc --- /dev/null +++ b/Postman/Postman-Configuration/postman_manual_config.js @@ -0,0 +1,104 @@ +var transports = []; + +jQuery(document).ready( + function($) { + + // display password on entry + enablePasswordDisplayOnEntry('input_basic_auth_password', + 'togglePasswordField'); + + // tabs + jQuery("#config_tabs").tabs(); + + // on first viewing, determine whether to show password or + // oauth section + reloadOauthSection(); + + // add an event on the transport input field + // when the user changes the transport, determine whether + // to show or hide the SMTP Settings + jQuery('select#input_transport_type').change(function() { + hide('#wizard_oauth2_help'); + reloadOauthSection(); + switchBetweenPasswordAndOAuth(); + }); + + jQuery('select#input_notification_service').change(function() { + var selected = $( this ).val(); + + if ( selected == 'default' ) { + $('#slack_cred').fadeOut('fast'); + $('#pushover_cred').fadeOut('fast'); + } + + if ( selected == 'pushover' ) { + $('#slack_cred').fadeOut('fast'); + $('#pushover_cred').fadeIn(); + } + + if ( selected == 'slack' ) { + $('#pushover_cred').fadeOut('fast'); + $('#slack_cred').fadeIn(); + } + + Hook.call( 'post_smtp_notification_change', selected ); + + }); + + + // add an event on the authentication input field + // on user changing the auth type, determine whether to show + // password or oauth section + jQuery('select#input_auth_type').change(function() { + switchBetweenPasswordAndOAuth(); + doneTyping(); + }); + + // setup before functions + var typingTimer; // timer identifier + var doneTypingInterval = 250; // time in ms, 5 second for + // example + + // add an event on the hostname input field + // on keyup, start the countdown + jQuery(postman_hostname_element_name).keyup(function() { + clearTimeout(typingTimer); + if (jQuery(postman_hostname_element_name).val) { + typingTimer = setTimeout(doneTyping, doneTypingInterval); + } + }); + + // user is "finished typing," do something + function doneTyping() { + if (jQuery(postman_input_auth_type).val() == 'oauth2') { + reloadOauthSection(); + } + } + }); + +function reloadOauthSection() { + var hostname = jQuery(postman_hostname_element_name).val(); + var transport = jQuery('#input_transport_type').val(); + var authtype = jQuery('select#input_auth_type').val(); + var security = jQuery('#security').val(); + var data = { + 'action' : 'manual_config', + 'auth_type' : authtype, + 'hostname' : hostname, + 'transport' : transport, + 'security' : security + }; + jQuery.post(ajaxurl, data, function(response) { + if (response.success) { + handleConfigurationResponse(response); + } + }).fail(function(response) { + ajaxFailed(response); + }); +} +function switchBetweenPasswordAndOAuth() { + var transportName = jQuery('select#input_transport_type').val(); + transports.forEach(function(item) { + item.handleTransportChange(transportName); + }); +} diff --git a/Postman/Postman-Configuration/postman_wizard.js b/Postman/Postman-Configuration/postman_wizard.js new file mode 100644 index 0000000..cbd2031 --- /dev/null +++ b/Postman/Postman-Configuration/postman_wizard.js @@ -0,0 +1,599 @@ +var transports = []; + +connectivtyTestResults = {}; +portTestInProgress = false; + +/** + * Functions to run on document load + */ +jQuery(document).ready(function() { + jQuery(postman_input_sender_email).focus(); + initializeJQuerySteps(); + // add an event on the plugin selection + jQuery('input[name="input_plugin"]').click(function() { + getConfiguration(); + }); + + // add an event on the transport input field + // when the user changes the transport, determine whether + // to show or hide the SMTP Settings + jQuery('select#input_transport_type').change(function() { + hide('#wizard_oauth2_help'); + reloadOauthSection(); + switchBetweenPasswordAndOAuth(); + }); + +}); + +function checkGoDaddyAndCheckEmail(email) { + hide('#godaddy_block'); + hide('#godaddy_spf_required'); + // are we hosted on GoDaddy? check. + var data = { + 'action' : 'postman_wizard_port_test', + 'hostname' : 'relay-hosting.secureserver.net', + 'port' : 25, + 'timeout' : 3, + 'security' : jQuery('#security').val(), + }; + goDaddy = 'unknown'; + checkedEmail = false; + jQuery.post(ajaxurl, data, function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + checkEmail(response.success, email); + } + }).fail(function(response) { + ajaxFailed(response); + }); +} + +function checkEmail(goDaddyHostDetected, email) { + var data = { + 'action' : 'postman_check_email', + 'go_daddy' : goDaddyHostDetected, + 'email' : email, + 'security' : jQuery('#security').val() + }; + jQuery.post( + ajaxurl, + data, + function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + checkedEmail = true; + smtpDiscovery = response.data; + if (response.data.hostname != null + && response.data.hostname) { + jQuery(postman_hostname_element_name).val( + response.data.hostname); + } + enableSmtpHostnameInput(goDaddyHostDetected); + } + }).fail(function(response) { + ajaxFailed(response); + }); +} + +function enableSmtpHostnameInput(goDaddyHostDetected) { + if (goDaddyHostDetected && !smtpDiscovery.is_google) { + // this is a godaddy server and we are using a godaddy smtp server + // (gmail excepted) + if (smtpDiscovery.is_go_daddy) { + // we detected GoDaddy, and the user has entered a GoDaddy hosted + // email + } else if (smtpDiscovery.is_well_known) { + // this is a godaddy server but the SMTP must be the email + // service + show('#godaddy_block'); + } else { + // this is a godaddy server and we're using a (possibly) custom + // domain + show('#godaddy_spf_required'); + } + } + enable('#input_hostname'); + jQuery('li').removeClass('disabled'); + hideLoaderIcon(); +} + +/** + * Initialize the Steps wizard + */ +function initializeJQuerySteps() { + jQuery("#postman_wizard").steps( + { + bodyTag : "fieldset", + headerTag : "h5", + transitionEffect : "slideLeft", + stepsOrientation : "vertical", + autoFocus : true, + startIndex : parseInt(postman_setup_wizard.start_page), + labels : { + current : steps_current_step, + pagination : steps_pagination, + finish : steps_finish, + next : steps_next, + previous : steps_previous, + loading : steps_loading + }, + onStepChanging : function(event, currentIndex, newIndex) { + return handleStepChange(event, currentIndex, newIndex, + jQuery(this)); + + }, + onInit : function() { + jQuery(postman_input_sender_email).focus(); + }, + onStepChanged : function(event, currentIndex, priorIndex) { + return postHandleStepChange(event, currentIndex, + priorIndex, jQuery(this)); + }, + onFinishing : function(event, currentIndex) { + var form = jQuery(this); + + // Disable validation on fields that + // are disabled. + // At this point it's recommended to + // do an overall check (mean + // ignoring + // only disabled fields) + // form.validate().settings.ignore = + // ":disabled"; + + // Start validation; Prevent form + // submission if false + return form.valid(); + }, + onFinished : function(event, currentIndex) { + var form = jQuery(this); + + // Submit form input + form.submit(); + } + }).validate({ + errorPlacement : function(error, element) { + element.before(error); + } + }); +} + +function handleStepChange(event, currentIndex, newIndex, form) { + // Always allow going backward even if + // the current step contains invalid fields! + if (currentIndex > newIndex) { + if (currentIndex === 2 && !(checkedEmail)) { + return false; + } + if (currentIndex === 3 && portTestInProgress) { + return false; + } + return true; + } + + // Clean up if user went backward + // before + if (currentIndex < newIndex) { + // To remove error styles + jQuery(".body:eq(" + newIndex + ") label.error", form).remove(); + jQuery(".body:eq(" + newIndex + ") .error", form).removeClass("error"); + } + + // Disable validation on fields that + // are disabled or hidden. + form.validate().settings.ignore = ":disabled,:hidden"; + + // Start validation; Prevent going + // forward if false + valid = form.valid(); + if (!valid) { + return false; + } + + if (currentIndex === 1) { + // page 1 : look-up the email + // address for the smtp server + checkGoDaddyAndCheckEmail(jQuery(postman_input_sender_email).val()); + + } else if (currentIndex === 2) { + + if (!(checkedEmail)) { + return false; + } + // page 2 : check the port + portsChecked = 0; + portsToCheck = 0; + totalAvail = 0; + + getHostsToCheck(jQuery(postman_hostname_element_name).val()); + + } else if (currentIndex === 3) { + + // user has clicked next but we haven't finished the check + if (portTestInProgress) { + return false; + } + // or all ports are unavailable + if (portCheckBlocksUi) { + return false; + } + valid = form.valid(); + if (!valid) { + return false; + } + var chosenPort = jQuery(postman_port_element_name).val(); + var hostname = jQuery(postman_hostname_element_name).val(); + var authType = jQuery(postman_input_auth_type).val() + + } + + return true; +} + +function postHandleStepChange(event, currentIndex, priorIndex, myself) { + var chosenPort = jQuery('#input_auth_type').val(); + // Suppress (skip) "Warning" step if + // the user is old enough and wants + // to the previous step. + if (currentIndex === 2) { + jQuery(postman_hostname_element_name).focus(); + // this is the second place i disable the next button but Steps + // re-enables it after the screen slides + if (priorIndex === 1) { + disable('#input_hostname'); + jQuery('li').addClass('disabled'); + showLoaderIcon(); + } + } + if (currentIndex === 3) { + if (priorIndex === 2) { + // this is the second place i disable the next button but Steps + // re-enables it after the screen slides + jQuery('li').addClass('disabled'); + showLoaderIcon(); + } + } + if (currentIndex === 4) { + if (redirectUrlWarning) { + alert(postman_wizard_bad_redirect_url); + } + if (chosenPort == 'none') { + if (priorIndex === 5) { + + myself.steps("previous"); + return; + } + myself.steps("next"); + } + } + +} + +/** + * Asks the server for a List of sockets to perform port checks upon. + * + * @param hostname + */ +function getHostsToCheck(hostname) { + jQuery('table#wizard_port_test').html(''); + jQuery('#wizard_recommendation').html(''); + hide('.user_override'); + hide('#smtp_not_secure'); + hide('#smtp_mitm'); + connectivtyTestResults = {}; + portCheckBlocksUi = true; + portTestInProgress = true; + var data = { + 'action' : 'postman_get_hosts_to_test', + 'hostname' : hostname, + 'original_smtp_server' : smtpDiscovery.hostname, + 'security' : jQuery('#security').val(), + }; + jQuery.post(ajaxurl, data, function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + handleHostsToCheckResponse(response.data); + } + }).fail(function(response) { + ajaxFailed(response); + }); +} + +/** + * Handles the response from the server of the list of sockets to check. + * + * @param hostname + * @param response + */ +function handleHostsToCheckResponse(response) { + for ( var x in response.hosts) { + var hostname = response.hosts[x].host; + var port = response.hosts[x].port; + var transport = response.hosts[x].transport_id; + portsToCheck++; + show('#connectivity_test_status'); + updateStatus(postman_port_test.in_progress + " " + portsToCheck); + var data = { + 'action' : 'postman_wizard_port_test', + 'hostname' : hostname, + 'port' : port, + 'transport' : transport, + 'security' : jQuery('#security').val(), + }; + postThePortTest(hostname, port, data); + } +} + +/** + * Asks the server to run a connectivity test on the given port + * + * @param hostname + * @param port + * @param data + */ +function postThePortTest(hostname, port, data) { + jQuery.post(ajaxurl, data, function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + handlePortTestResponse(hostname, port, data, response); + } + }).fail(function(response) { + ajaxFailed(response); + portsChecked++; + afterPortsChecked(); + }); +} + +/** + * Handles the result of the port test + * + * @param hostname + * @param port + * @param data + * @param response + */ +function handlePortTestResponse(hostname, port, data, response) { + if (!response.data.try_smtps) { + portsChecked++; + updateStatus(postman_port_test.in_progress + " " + + (portsToCheck - portsChecked)); + connectivtyTestResults[hostname + '_' + port] = response.data; + if (response.success) { + // a totalAvail > 0 is our signal to go to the next step + totalAvail++; + } + afterPortsChecked(); + } else { + // SMTP failed, try again on the SMTPS port + data['action'] = 'postman_wizard_port_test_smtps'; + data['security'] = jQuery('#security').val(); + postThePortTest(hostname, port, data); + } +} + +/** + * + * @param message + */ +function updateStatus(message) { + jQuery('#port_test_status').html( + '' + message + ''); +} + +/** + * This functions runs after ALL the ports have been checked. It's chief + * function is to push the results of the port test back to the server to get a + * suggested configuration. + */ +function afterPortsChecked() { + if (portsChecked >= portsToCheck) { + hideLoaderIcon(); + if (totalAvail != 0) { + jQuery('li').removeClass('disabled'); + portCheckBlocksUi = false; + } + var data = { + 'action' : 'get_wizard_configuration_options', + 'original_smtp_server' : smtpDiscovery.hostname, + 'host_data' : connectivtyTestResults, + 'security': jQuery('#security').val() + }; + postTheConfigurationRequest(data); + hide('#connectivity_test_status'); + } +} + +function userOverrideMenu() { + disable('input.user_socket_override'); + disable('input.user_auth_override'); + var data = { + 'action' : 'get_wizard_configuration_options', + 'original_smtp_server' : smtpDiscovery.hostname, + 'user_port_override' : jQuery( + "input:radio[name='user_socket_override']:checked").val(), + 'user_auth_override' : jQuery( + "input:radio[name='user_auth_override']:checked").val(), + 'host_data' : connectivtyTestResults, + 'security' : jQuery('#security').val() + }; + postTheConfigurationRequest(data); +} + +function postTheConfigurationRequest(data) { + jQuery.post( + ajaxurl, + data, + function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + portTestInProgress = false; + var $message = ''; + if (response.success) { + $message = '' + + response.data.configuration.message + + ''; + handleConfigurationResponse(response.data); + enable('input.user_socket_override'); + enable('input.user_auth_override'); + // enable both next/back buttons + jQuery('li').removeClass('disabled'); + } else { + $message = '' + + response.data.configuration.message + + ''; + // enable the back button only + jQuery('li').removeClass('disabled'); + jQuery('li + li').addClass('disabled'); + } + if (!response.data.configuration.user_override) { + jQuery('#wizard_recommendation').append($message); + } + } + }).fail(function(response) { + ajaxFailed(response); + }); +} +function handleConfigurationResponse(response) { + jQuery('#input_transport_type').val(response.configuration.transport_type); + transports.forEach(function(item) { + item.handleConfigurationResponse(response); + }) + + // this stuff builds the options and is common to all transports + // populate user Port Override menu + show('.user_override'); + var el1 = jQuery('#user_socket_override'); + el1.html(''); + for (i = 0; i < response.override_menu.length; i++) { + buildRadioButtonGroup(el1, 'user_socket_override', + response.override_menu[i].selected, + response.override_menu[i].value, + response.override_menu[i].description, + response.override_menu[i].secure); + // populate user Auth Override menu + if (response.override_menu[i].selected) { + if (response.override_menu[i].mitm) { + show('#smtp_mitm'); + jQuery('#smtp_mitm') + .html( + sprintf( + postman_port_test.mitm, + response.override_menu[i].reported_hostname_domain_only, + response.override_menu[i].hostname_domain_only)); + } else { + hide('#smtp_mitm'); + } + var el2 = jQuery('#user_auth_override'); + el2.html(''); + hide('#smtp_not_secure'); + for (j = 0; j < response.override_menu[i].auth_items.length; j++) { + buildRadioButtonGroup(el2, 'user_auth_override', + response.override_menu[i].auth_items[j].selected, + response.override_menu[i].auth_items[j].value, + response.override_menu[i].auth_items[j].name, false); + if (response.override_menu[i].auth_items[j].selected + && !response.override_menu[i].secure + && response.override_menu[i].auth_items[j].value != 'none') { + show('#smtp_not_secure'); + } + } + // add an event on the user port override field + jQuery('input.user_auth_override').change(function() { + userOverrideMenu(); + }); + } + + } + + jQuery('select#input_notification_service').change(function() { + var selected = jQuery( this ).val(); + + if ( selected == 'default' ) { + jQuery('#slack_cred').fadeOut('fast'); + jQuery('#pushover_cred').fadeOut('fast'); + } + + if ( selected == 'pushover' ) { + jQuery('#slack_cred').fadeOut('fast'); + jQuery('#pushover_cred').fadeIn(); + } + + if ( selected == 'slack' ) { + jQuery('#pushover_cred').fadeOut('fast'); + jQuery('#slack_cred').fadeIn(); + } + + Hook.call( 'post_smtp_notification_change', selected ); + }); + + // add an event on the user port override field + jQuery('input.user_socket_override').change(function() { + userOverrideMenu(); + }); +} + +function buildRadioButtonGroup(tableElement, radioGroupName, isSelected, value, + label, isSecure) { + var radioInputValue = ' value="' + value + '"'; + var radioInputChecked = ''; + if (isSelected) { + radioInputChecked = ' checked = "checked"'; + } + var secureIcon = ''; + if (isSecure) { + secureIcon = '🔒 '; + } + tableElement.append('' + secureIcon + + label + ''); +} + +/** + * Handles population of the configuration based on the options set in a + * 3rd-party SMTP plugin + */ +function getConfiguration() { + var plugin = jQuery('input[name="input_plugin"]' + ':checked').val(); + if (plugin != '') { + var data = { + 'action' : 'import_configuration', + 'plugin' : plugin, + '_wpnonce' : jQuery('#_wpnonce').val(), + }; + jQuery + .post( + ajaxurl, + data, + function(response) { + if (response.success) { + jQuery('select#input_transport_type').val( + 'smtp'); + jQuery(postman_input_sender_email).val( + response.sender_email); + jQuery(postman_input_sender_name).val( + response.sender_name); + jQuery(postman_hostname_element_name).val( + response.hostname); + jQuery(postman_port_element_name).val( + response.port); + jQuery(postman_input_auth_type).val( + response.auth_type); + jQuery('#input_enc_type') + .val(response.enc_type); + jQuery(postman_input_basic_username).val( + response.basic_auth_username); + jQuery(postman_input_basic_password).val( + response.basic_auth_password); + switchBetweenPasswordAndOAuth(); + } + }).fail(function(response) { + ajaxFailed(response); + }); + } else { + jQuery(postman_input_sender_email).val(''); + jQuery(postman_input_sender_name).val(''); + jQuery(postman_input_basic_username).val(''); + jQuery(postman_input_basic_password).val(''); + jQuery(postman_hostname_element_name).val(''); + jQuery(postman_port_element_name).val(''); + jQuery(postman_input_auth_type).val('none'); + jQuery(postman_enc_for_password_el).val('none'); + switchBetweenPasswordAndOAuth(); + } +} diff --git a/Postman/Postman-Connectivity-Test/Postman-PortTest.php b/Postman/Postman-Connectivity-Test/Postman-PortTest.php new file mode 100644 index 0000000..adbe530 --- /dev/null +++ b/Postman/Postman-Connectivity-Test/Postman-PortTest.php @@ -0,0 +1,286 @@ +logger = new PostmanLogger ( get_class ( $this ) ); + $this->hostname = $hostname; + $this->hostnameDomainOnly = $this->getRegisteredDomain ( $hostname ); + $this->port = $port; + $this->connectionTimeout = 10; + $this->readTimeout = 10; + } + + /** + * Wrap the regDomain/getRegisteredDomain function + * + * @param mixed $domain + * @return mixed + */ + private function getRegisteredDomain($hostname) { + $registeredDomain = getRegisteredDomain ( $hostname ); + if ($registeredDomain === NULL) { + return $hostname; + } + return $registeredDomain; + } + public function setConnectionTimeout($timeout) { + $this->connectionTimeout = $timeout; + $this->logger->trace ( $this->connectionTimeout ); + } + public function setReadTimeout($timeout) { + $this->readTimeout = $timeout; + $this->logger->trace ( $this->readTimeout ); + } + private function createStream($connectionString) { + $stream = @stream_socket_client ( $connectionString, $errno, $errstr, $this->connectionTimeout ); + if ($stream) { + $this->trace ( sprintf ( 'connected to %s', $connectionString ) ); + } else { + $this->trace ( sprintf ( 'Could not connect to %s because %s [%s]', $connectionString, $errstr, $errno ) ); + } + return $stream; + } + + /** + * + * @param number $timeout + * @return boolean + */ + public function genericConnectionTest() { + $this->logger->trace ( 'testCustomConnection()' ); + // test if the port is open + $connectionString = sprintf ( '%s:%s', $this->hostname, $this->port ); + $stream = $this->createStream ( $connectionString, $this->connectionTimeout ); + return null != $stream; + } + + /** + * Given a hostname, test if it has open ports + * + * @param string $hostname + */ + public function testHttpPorts() { + $this->trace ( 'testHttpPorts()' ); + $connectionString = sprintf ( "https://%s:%s", $this->hostname, $this->port ); + try { + $response = PostmanUtils::remotePost ( $connectionString ); + $this->trace ( 'wp_remote_retrieve_headers:' ); + $this->logger->trace ( wp_remote_retrieve_headers ( $response ) ); + $this->trace ( wp_remote_retrieve_response_code ( $response ) ); + $this->protocol = 'HTTPS'; + $this->http = true; + $this->https = true; + $this->secure = true; + $this->reportedHostname = $this->hostname; + $this->reportedHostnameDomainOnly = $this->getRegisteredDomain ( $this->hostname ); + return true; + } catch ( Exception $e ) { + $this->debug ( 'return false' ); + } + } + + /** + * Given a hostname, test if it has open ports + * + * @param string $hostname + */ + public function testSmtpPorts() { + $this->logger->trace ( 'testSmtpPorts()' ); + if ($this->port == 8025) { + $this->debug ( 'Executing test code for port 8025' ); + $this->protocol = 'SMTP'; + $this->smtp = true; + $this->authNone = 'true'; + return true; + } + $connectionString = sprintf ( "%s:%s", $this->hostname, $this->port ); + $success = $this->talkToMailServer ( $connectionString, $this->connectionTimeout, $this->readTimeout ); + if ($success) { + $this->protocol = 'SMTP'; + if (! ($this->authCrammd5 || $this->authLogin || $this->authPlain || $this->authXoauth)) { + $this->authNone = true; + } + } else { + $this->trySmtps = true; + } + return $success; + } + + /** + * Given a hostname, test if it has open ports + * + * @param string $hostname + */ + public function testSmtpsPorts() { + $this->logger->trace ( 'testSmtpsPorts()' ); + $connectionString = sprintf ( "ssl://%s:%s", $this->hostname, $this->port ); + $success = $this->talkToMailServer ( $connectionString, $this->connectionTimeout, $this->readTimeout ); + if ($success) { + if (! ($this->authCrammd5 || $this->authLogin || $this->authPlain || $this->authXoauth)) { + $this->authNone = true; + } + $this->protocol = self::SMTPS_PROTOCOL; + $this->smtps = true; + $this->secure = true; + } + return $success; + } + + /** + * Given a hostname, test if it has open ports + * + * @param string $hostname + */ + private function talkToMailServer($connectionString) { + $this->logger->trace ( 'talkToMailServer()' ); + $stream = $this->createStream ( $connectionString, $this->connectionTimeout ); + if ($stream) { + $serverName = PostmanUtils::postmanGetServerName (); + @stream_set_timeout ( $stream, $this->readTimeout ); + // see http://php.net/manual/en/transports.inet.php#113244 + // see http://php.net/stream_socket_enable_crypto + $result = $this->readSmtpResponse ( $stream ); + if ($result) { + $this->reportedHostname = $result; + $this->reportedHostnameDomainOnly = $this->getRegisteredDomain ( $this->reportedHostname ); + $this->logger->trace ( sprintf ( 'comparing %s with %s', $this->reportedHostnameDomainOnly, $this->hostnameDomainOnly ) ); + $this->mitm = true; + // MITM exceptions + if ($this->reportedHostnameDomainOnly == 'google.com' && $this->hostnameDomainOnly == 'gmail.com') { + $this->mitm = false; + } elseif ($this->reportedHostnameDomainOnly == 'hotmail.com' && $this->hostnameDomainOnly == 'live.com') { + $this->mitm = false; + } elseif ($this->reportedHostnameDomainOnly == $this->hostnameDomainOnly) { + $this->mitm = false; + } + $this->debug ( sprintf ( 'domain name: %s (%s)', $this->reportedHostname, $this->reportedHostnameDomainOnly ) ); + $this->sendSmtpCommand ( $stream, sprintf ( 'EHLO %s', $serverName ) ); + $this->readSmtpResponse ( $stream ); + if ($this->checkStartTls) { + $this->sendSmtpCommand ( $stream, 'STARTTLS' ); + $this->readSmtpResponse ( $stream ); + $starttlsSuccess = @stream_socket_enable_crypto ( $stream, true, STREAM_CRYPTO_METHOD_TLS_CLIENT ); + if ($starttlsSuccess) { + $this->startTls = true; + $this->secure = true; + $this->sendSmtpCommand ( $stream, sprintf ( 'EHLO %s', $serverName ) ); + $this->readSmtpResponse ( $stream ); + } else { + $this->error ( 'starttls failed' ); + } + } + fclose ( $stream ); + $this->debug ( 'return true' ); + return true; + } else { + fclose ( $stream ); + $this->debug ( 'return false' ); + return false; + } + } else { + return false; + } + } + private function sendSmtpCommand($stream, $message) { + $this->trace ( 'tx: ' . $message ); + fputs ( $stream, $message . "\r\n" ); + } + private function readSmtpResponse($stream) { + $result = ''; + while ( ($line = fgets ( $stream )) !== false ) { + $this->trace ( 'rx: ' . $line ); + if (preg_match ( '/^250.AUTH/', $line )) { + // $this->debug ( '250-AUTH' ); + if (preg_match ( '/\\sLOGIN\\s/', $line )) { + $this->authLogin = true; + $this->debug ( 'authLogin' ); + } + if (preg_match ( '/\\sPLAIN\\s/', $line )) { + $this->authPlain = true; + $this->debug ( 'authPlain' ); + } + if (preg_match ( '/\\sCRAM-MD5\\s/', $line )) { + $this->authCrammd5 = true; + $this->debug ( 'authCrammd5' ); + } + if (preg_match ( '/\\sXOAUTH.\\s/', $line )) { + $this->authXoauth = true; + $this->debug ( 'authXoauth' ); + } + if (preg_match ( '/\\sANONYMOUS\\s/', $line )) { + // Postman treats ANONYMOUS login as no authentication. + $this->authNone = true; + $this->debug ( 'authAnonymous => authNone' ); + } + // done + $result = 'auth'; + } elseif (preg_match ( '/STARTTLS/', $line )) { + $result = 'starttls'; + $this->checkStartTls = true; + $this->debug ( 'starttls' ); + } elseif (preg_match ( '/^220.(.*?)\\s/', $line, $matches )) { + if (empty ( $result )) + $result = $matches [1]; + } + if (preg_match ( '/^\d\d\d\\s/', $line )) { + // always exist on last server response line + // $this->debug ( 'exit' ); + return $result; + } + } + return false; + } + public function getErrorMessage() { + return $this->errstr; + } + private function trace($message) { + $this->logger->trace ( sprintf ( '%s:%s => %s', $this->hostname, $this->port, $message ) ); + } + private function debug($message) { + $this->logger->debug ( sprintf ( '%s:%s => %s', $this->hostname, $this->port, $message ) ); + } + private function error($message) { + $this->logger->error ( sprintf ( '%s:%s => %s', $this->hostname, $this->port, $message ) ); + } +} diff --git a/Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php b/Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php new file mode 100644 index 0000000..6ff5a69 --- /dev/null +++ b/Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php @@ -0,0 +1,336 @@ +logger = new PostmanLogger( get_class( $this ) ); + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + + PostmanUtils::registerAdminMenu( $this, 'addPortTestSubmenu' ); + + // hook on the init event + add_action( 'init', array( + $this, + 'on_init', + ) ); + + // initialize the scripts, stylesheets and form fields + add_action( 'admin_init', array( + $this, + 'on_admin_init', + ) ); + } + + /** + * Functions to execute on the init event + * + * "Typically used by plugins to initialize. The current user is already authenticated by this time." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_a_Typical_Request + */ + public function on_init() { + // register Ajax handlers + new PostmanPortTestAjaxController(); + } + + /** + * Fires on the admin_init method + */ + public function on_admin_init() { + $this->registerStylesAndScripts(); + } + + /** + * Register and add settings + */ + private function registerStylesAndScripts() { + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'registerStylesAndScripts()' ); + } + // register the stylesheet and javascript external resources + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + wp_register_script( 'postman_port_test_script', plugins_url( 'Postman/Postman-Connectivity-Test/postman_port_test.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + PostmanViewController::POSTMAN_SCRIPT, + 'sprintf', + ), $pluginData ['version'] ); + } + + /** + * Register the Email Test screen + */ + public function addPortTestSubmenu() { + $page = add_submenu_page( null, sprintf( __( '%s Setup', 'post-smtp' ), __( 'Postman SMTP', 'post-smtp' ) ), __( 'Postman SMTP', 'post-smtp' ), Postman::MANAGE_POSTMAN_CAPABILITY_NAME, PostmanConnectivityTestController::PORT_TEST_SLUG, array( + $this, + 'outputPortTestContent', + ) ); + // When the plugin options page is loaded, also load the stylesheet + add_action( 'admin_print_styles-' . $page, array( + $this, + 'enqueuePortTestResources', + ) ); + } + + /** + */ + function enqueuePortTestResources() { + wp_enqueue_style( PostmanViewController::POSTMAN_STYLE ); + wp_enqueue_script( 'postman_port_test_script' ); + $warning = __( 'Warning', 'post-smtp' ); + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_hostname_element_name', '#input_' . PostmanOptions::HOSTNAME ); + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_email_test', array( + 'recipient' => '#' . PostmanSendTestEmailController::RECIPIENT_EMAIL_FIELD_NAME, + 'not_started' => _x( 'In Outbox', 'Email Test Status', 'post-smtp' ), + 'sending' => _x( 'Sending...', 'Email Test Status', 'post-smtp' ), + 'success' => _x( 'Success', 'Email Test Status', 'post-smtp' ), + 'failed' => _x( 'Failed', 'Email Test Status', 'post-smtp' ), + 'ajax_error' => __( 'Ajax Error', 'post-smtp' ), + ) ); + PostmanConnectivityTestController::addLocalizeScriptForPortTest(); + } + static function addLocalizeScriptForPortTest() { + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_port_test', array( + 'in_progress' => _x( 'Checking..', 'The "please wait" message', 'post-smtp' ), + 'open' => _x( 'Open', 'The port is open', 'post-smtp' ), + 'closed' => _x( 'Closed', 'The port is closed', 'post-smtp' ), + 'yes' => __( 'Yes', 'post-smtp' ), + 'no' => __( 'No', 'post-smtp' ), + /* translators: where %d is a port number */ + 'blocked' => __( 'No outbound route between this site and the Internet on Port %d.', 'post-smtp' ), + /* translators: where %d is a port number and %s is a hostname */ + 'try_dif_smtp' => __( 'Port %d is open, but not to %s.', 'post-smtp' ), + /* translators: where %d is the port number and %s is the hostname */ + 'success' => __( 'Port %d can be used for SMTP to %s.', 'post-smtp' ), + 'mitm' => sprintf( '%s: %s', __( 'Warning', 'post-smtp' ), __( 'connected to %1$s instead of %2$s.', 'post-smtp' ) ), + /* translators: where %d is a port number and %s is the URL for the Postman Gmail Extension */ + 'https_success' => __( 'Port %d can be used with the %s.', 'post-smtp' ), + ) ); + } + + /** + * Get the settings option array and print one of its values + */ + public function port_test_hostname_callback() { + $hostname = PostmanTransportRegistry::getInstance()->getSelectedTransport()->getHostname(); + if ( empty( $hostname ) ) { + $hostname = PostmanTransportRegistry::getInstance()->getActiveTransport()->getHostname(); + } + printf( '', $hostname ); + } + + /** + */ + public function outputPortTestContent() { + print '
'; + + wp_nonce_field('post-smtp', 'security'); + + PostmanViewController::outputChildPageHeader( __( 'Connectivity Test', 'post-smtp' ) ); + + print '

'; + print __( 'This test determines which well-known ports are available for Postman to use.', 'post-smtp' ); + print '

'; + + wp_nonce_field('post-smtp', 'security' ); + + printf( '', __( 'Outgoing Mail Server Hostname', 'post-smtp' ) ); + $this->port_test_hostname_callback(); + submit_button( _x( 'Begin Test', 'Button Label', 'post-smtp' ), 'primary', 'begin-port-test', true ); + print '
'; + print ''; + print sprintf( '', __( 'Transport', 'post-smtp' ), _x( 'Socket', 'A socket is the network term for host and port together', 'post-smtp' ), __( 'Status', 'post-smtp' ) . '*', __( 'Service Available', 'post-smtp' ), __( 'Server ID', 'post-smtp' ), __( 'Authentication', 'post-smtp' ) ); + print sprintf( '', 'None', 'Login', 'Plain', 'CRAM-MD5', 'OAuth 2.0' ); + $sockets = PostmanTransportRegistry::getInstance()->getSocketsForSetupWizardToProbe(); + foreach ( $sockets as $socket ) { + if ( $socket ['smtp'] ) { + print sprintf( '', $socket ['id'], $socket ['transport_name'], $socket ['host'], $socket ['port'] ); + } else { + print sprintf( '', $socket ['id'], $socket ['transport_name'], $socket ['host'], $socket ['port'], __( 'n/a', 'post-smtp' ) ); + } + } + print '
%s%s%s%s%s%s
%s%s%s%s%s
%s%s:%s-------
%s%s:%s---%s
'; + /* Translators: Where %s is the name of the service providing Internet connectivity test */ + printf( '', sprintf( __( 'According to %s', 'post-smtp' ), 'portquiz.net' ) ); + printf( '', plugins_url( 'post-smtp/style/ajax-loader.gif' ) ); + print ''; + print ''; + print '
'; + } +} + +/** + * + * @author jasonhendriks + */ +class PostmanPortTestAjaxController { + private $logger; + /** + * Constructor + * + * @param PostmanOptions $options + */ + function __construct() { + $this->logger = new PostmanLogger( get_class( $this ) ); + PostmanUtils::registerAjaxHandler( 'postman_get_hosts_to_test', $this, 'getPortsToTestViaAjax' ); + PostmanUtils::registerAjaxHandler( 'postman_wizard_port_test', $this, 'runSmtpTest' ); + PostmanUtils::registerAjaxHandler( 'postman_wizard_port_test_smtps', $this, 'runSmtpsTest' ); + PostmanUtils::registerAjaxHandler( 'postman_port_quiz_test', $this, 'runPortQuizTest' ); + PostmanUtils::registerAjaxHandler( 'postman_test_port', $this, 'runSmtpTest' ); + PostmanUtils::registerAjaxHandler( 'postman_test_smtps', $this, 'runSmtpsTest' ); + } + + /** + * This Ajax function determines which hosts/ports to test in both the Wizard Connectivity Test and direct Connectivity Test + * + * Given a single outgoing smtp server hostname, return an array of host/port + * combinations to run the connectivity test on + */ + function getPortsToTestViaAjax() { + + check_admin_referer('post-smtp', 'security'); + + $queryHostname = PostmanUtils::getRequestParameter( 'hostname' ); + // originalSmtpServer is what SmtpDiscovery thinks the SMTP server should be, given an email address + $originalSmtpServer = PostmanUtils::getRequestParameter( 'original_smtp_server' ); + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Probing available transports for sockets against hostname ' . $queryHostname ); + } + $sockets = PostmanTransportRegistry::getInstance()->getSocketsForSetupWizardToProbe( $queryHostname, $originalSmtpServer ); + $response = array( + 'hosts' => $sockets, + ); + wp_send_json_success( $response ); + } + + /** + * This Ajax function retrieves whether a TCP port is open or not + */ + function runPortQuizTest() { + + check_admin_referer('post-smtp', 'security'); + + $hostname = 'portquiz.net'; + $port = intval( PostmanUtils::getRequestParameter( 'port' ) ); + $this->logger->debug( 'testing TCP port: hostname ' . $hostname . ' port ' . $port ); + $portTest = new PostmanPortTest( $hostname, $port ); + $success = $portTest->genericConnectionTest(); + $this->buildResponse( $hostname, $port, $portTest, $success ); + } + + /** + * This Ajax function retrieves whether a TCP port is open or not. + * This is called by both the Wizard and Port Test + */ + function runSmtpTest() { + + check_admin_referer('post-smtp', 'security'); + + $hostname = trim( PostmanUtils::getRequestParameter( 'hostname' ) ); + $port = intval( PostmanUtils::getRequestParameter( 'port' ) ); + $transport = trim( PostmanUtils::getRequestParameter( 'transport' ) ); + $timeout = PostmanUtils::getRequestParameter( 'timeout' ); + $this->logger->trace( $timeout ); + $portTest = new PostmanPortTest( $hostname, $port ); + if ( isset( $timeout ) ) { + $portTest->setConnectionTimeout( intval( $timeout ) ); + $portTest->setReadTimeout( intval( $timeout ) ); + } + if ( $port != 443 ) { + $this->logger->debug( sprintf( 'testing SMTP socket %s:%s (%s)', $hostname, $port, $transport ) ); + $success = $portTest->testSmtpPorts(); + } else { + $this->logger->debug( sprintf( 'testing HTTPS socket %s:%s (%s)', $hostname, $port, $transport ) ); + $success = $portTest->testHttpPorts(); + } + $this->buildResponse( $hostname, $port, $portTest, $success, $transport ); + } + /** + * This Ajax function retrieves whether a TCP port is open or not + */ + function runSmtpsTest() { + + check_admin_referer('post-smtp', 'security'); + + $hostname = trim( PostmanUtils::getRequestParameter( 'hostname' ) ); + $port = intval( PostmanUtils::getRequestParameter( 'port' ) ); + $transport = trim( PostmanUtils::getRequestParameter( 'transport' ) ); + $transportName = trim( PostmanUtils::getRequestParameter( 'transport_name' ) ); + $this->logger->debug( sprintf( 'testing SMTPS socket %s:%s (%s)', $hostname, $port, $transport ) ); + $portTest = new PostmanPortTest( $hostname, $port ); + $portTest->transportName = $transportName; + $success = $portTest->testSmtpsPorts(); + $this->buildResponse( $hostname, $port, $portTest, $success, $transport ); + } + + /** + * + * @param mixed $hostname + * @param mixed $port + * @param mixed $success + */ + private function buildResponse( $hostname, $port, PostmanPortTest $portTest, $success, $transport = '' ) { + $this->logger->debug( sprintf( 'testing port result for %s:%s success=%s', $hostname, $port, $success ) ); + $response = array( + 'hostname' => $hostname, + 'hostname_domain_only' => $portTest->hostnameDomainOnly, + 'port' => $port, + 'protocol' => $portTest->protocol, + 'secure' => ($portTest->secure), + 'mitm' => ($portTest->mitm), + 'reported_hostname' => $portTest->reportedHostname, + 'reported_hostname_domain_only' => $portTest->reportedHostnameDomainOnly, + 'message' => $portTest->getErrorMessage(), + 'start_tls' => $portTest->startTls, + 'auth_plain' => $portTest->authPlain, + 'auth_login' => $portTest->authLogin, + 'auth_crammd5' => $portTest->authCrammd5, + 'auth_xoauth' => $portTest->authXoauth, + 'auth_none' => $portTest->authNone, + 'try_smtps' => $portTest->trySmtps, + 'success' => $success, + 'transport' => $transport, + ); + $this->logger->trace( 'Ajax response:' ); + $this->logger->trace( $response ); + if ( $success ) { + wp_send_json_success( $response ); + } else { + wp_send_json_error( $response ); + } + } +} diff --git a/Postman/Postman-Connectivity-Test/postman_port_test.js b/Postman/Postman-Connectivity-Test/postman_port_test.js new file mode 100644 index 0000000..8667c06 --- /dev/null +++ b/Postman/Postman-Connectivity-Test/postman_port_test.js @@ -0,0 +1,336 @@ +postman_begin_test_button_id = 'input#begin-port-test'; + +jQuery(document).ready(function() { + var elHostname = jQuery(postman_begin_test_button_id); + jQuery(postman_hostname_element_name).focus(); + elHostname.click(function() { + valid = jQuery('#port_test_form_id').valid(); + if (!valid) { + return false; + } + + // initialize the view for a new test + elHostname.attr('disabled', 'disabled'); + hide('#conclusion'); + hide('#blocked-port-help'); + jQuery('ol.conclusion').html(''); + showLoaderIcon(); + + var $elTestingTable = jQuery('#connectivity_test_table'); + $elTestingTable.show(); + show('.portquiz'); + + var hostname = jQuery(postman_hostname_element_name).val(); + var data = { + 'action' : 'postman_get_hosts_to_test', + 'hostname' : hostname, + 'security' : jQuery('#security').val(), + }; + + totalPortsTested = 0; + portsToBeTested = 0; + + jQuery.post(ajaxurl, data, function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + handleHostsToCheckResponse(response.data); + } + }).fail(function(response) { + ajaxFailed(response); + }); + + // + return false; + }); +}); + +/** + * Handles the response from the server of the list of sockets to check. + * + * @param hostname + * @param response + */ +function handleHostsToCheckResponse(response) { + for ( var x in response.hosts) { + var id = response.hosts[x].id; + var transportSlug = response.hosts[x].transport_id; + var hostname = response.hosts[x].host; + var port = response.hosts[x].port + var cell = 'tr#' + id + " td.socket"; + var testEl = jQuery(cell); + testEl.html('' + hostname + ':' + port + ''); + portQuizTest(response.hosts[x], hostname, port); + } +} + +function portQuizTest(socket, hostname, port) { + resetView(socket.id); + portsToBeTested += 1; + var cell = 'tr#' + socket.id + " td.firewall"; + var testEl = jQuery(cell); + testEl.html('' + postman_port_test.in_progress + + ''); + var data = { + 'action' : 'postman_port_quiz_test', + 'hostname' : hostname, + 'port' : port, + 'security' : jQuery('#security').val(), + }; + jQuery.post( + ajaxurl, + data, + function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + if (response.success) { + testEl.html('' + + postman_port_test.open + ''); + // start the next test + } else { + testEl.html('' + + postman_port_test.closed + ''); + } + firstServiceTest(socket, hostname, port, response.success); + } + }).fail( + function(response) { + totalPortsTested += 1; + testEl.html('' + + postman_email_test.ajax_error + ""); + enableButtonCheck(); + }); +} +function firstServiceTest(socket, hostname, port, open) { + var cell = 'tr#' + socket.id + " td.service"; + var testEl = jQuery(cell); + testEl.html('' + postman_port_test.in_progress + + ''); + var data = { + 'action' : 'postman_test_port', + 'hostname' : hostname, + 'port' : port, + 'security' : jQuery('#security').val(), + }; + jQuery + .post( + ajaxurl, + data, + function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + if (response.success) { + totalPortsTested += 1; + if (port == 443) { + // API test + testEl + .html('🔒 ' + + response.data.protocol + + ''); + var cell = 'tr#' + socket.id + + " td.reported_id"; + var p443El = jQuery(cell); + if (response.data.reported_hostname_domain_only) { + p443El + .html('' + + response.data.reported_hostname_domain_only + + ''); + } + addConclusion(sprintf( + postman_port_test.https_success, + response.data.port, + socket.transport_name), true, + response.data.secure); + } else { + // SMTP test + testEl.html('' + + response.data.protocol + + ''); + inspectResponse(socket.id, response.data, + port); + var message = sprintf(postman_port_test.success, + port, hostname); + if (response.data.mitm) { + message += ' ' + + sprintf( + postman_port_test.mitm, + response.data.reported_hostname_domain_only, + response.data.hostname_domain_only) + + ''; + } + addConclusion(message, true, + response.data.secure); + } + } else { + if (port == 443) { + // API test + testEl.html('' + + postman_port_test.no + ''); + totalPortsTested += 1; + var p443El = jQuery(cell); + addConclusion(sprintf(postman_port_test.try_dif_smtp, + port, hostname), false, + response.data.secure); + } else { + if (response.data.try_smtps) { + // start the SMTPS test + portTest3(socket, hostname, port, open); + } else { + testEl.html('' + + postman_port_test.no + ''); + totalPortsTested += 1; + addConclusion(sprintf( + postman_port_test.blocked, port), + false, response.data.secure); + show('#blocked-port-help'); + } + } + } + enableButtonCheck(); + } + }).fail( + function(response) { + totalPortsTested += 1; + testEl.html('' + + postman_email_test.ajax_error + ""); + enableButtonCheck(); + }); +} +function portTest3(socket, hostname, port, open) { + var cell = 'tr#' + socket.id + " td.service"; + var testEl = jQuery(cell); + testEl.html('' + postman_port_test.in_progress + + ''); + var data = { + 'action' : 'postman_test_smtps', + 'hostname' : hostname, + 'port' : port, + 'security' : jQuery('#security').val(), + }; + jQuery + .post( + ajaxurl, + data, + function(response) { + if (postmanValidateAjaxResponseWithPopup(response)) { + if (response.success) { + if (response.data.protocol == 'SMTPS') { + testEl + .html('🔒 ' + + response.data.protocol + + ''); + } else { + + testEl.html('' + + response.data.protocol + + ''); + } + inspectResponse(socket.id, response.data, port); + var message = sprintf(postman_port_test.success, + port, hostname); + if (response.data.mitm) { + message += ' ' + + sprintf( + postman_port_test.mitm, + response.data.reported_hostname_domain_only, + response.data.hostname_domain_only + + ''); + } + addConclusion(message, true, + response.data.secure); + } else { + testEl.html('' + + postman_port_test.no + ''); + show('#blocked-port-help'); + if (open) { + addConclusion(sprintf(postman_port_test.try_dif_smtp, + port, hostname), false, + response.data.secure); + } else { + addConclusion(sprintf(postman_port_test.blocked, + port), false, response.data.secure); + } + } + totalPortsTested += 1; + enableButtonCheck(); + } + }).fail( + function(response) { + totalPortsTested += 1; + testEl.html('' + + postman_email_test.ajax_error + ""); + enableButtonCheck(); + }); +} +function enableButtonCheck() { + if (totalPortsTested >= portsToBeTested) { + enable(postman_begin_test_button_id); + hideLoaderIcon(); + jQuery(postman_hostname_element_name).focus(); + } +} +function inspectResponse(id, response, port) { + var cell = 'tr#' + id + " td.reported_id"; + var testEl = jQuery(cell); + if (response.reported_hostname_domain_only) { + testEl.html('' + response.reported_hostname_domain_only + + ''); + } + var cell = 'tr#' + id + " td.service"; + var testEl = jQuery(cell); + if (response.protocol == 'SMTPS') { + testEl.html('🔒 SMTPS'); + } else if (response.start_tls) { + testEl.html('🔒 SMTP-STARTTLS'); + } else { + testEl.html('SMTP'); + } + var cell = 'tr#' + id + " td.auth_none"; + var testEl = jQuery(cell); + if (response.auth_none) { + testEl.html('' + postman_port_test.yes + ''); + } else { + testEl.html('' + postman_port_test.no + ''); + } + var cell = 'tr#' + id + " td.auth_plain"; + var testEl = jQuery(cell); + if (response.auth_plain) { + testEl.html('' + postman_port_test.yes + ''); + } else { + testEl.html('' + postman_port_test.no + ''); + } + var cell = 'tr#' + id + " td.auth_login"; + var testEl = jQuery(cell); + if (response.auth_login) { + testEl.html('' + postman_port_test.yes + ''); + } else { + testEl.html('' + postman_port_test.no + ''); + } + var cell = 'tr#' + id + " td.auth_crammd5"; + var testEl = jQuery(cell); + if (response.auth_crammd5) { + testEl.html('' + postman_port_test.yes + ''); + } else { + testEl.html('' + postman_port_test.no + ''); + } + var cell = 'tr#' + id + " td.auth_xoauth2"; + var testEl = jQuery(cell); + if (response.auth_xoauth) { + testEl.html('' + postman_port_test.yes + ''); + } else { + testEl.html('' + postman_port_test.no + ''); + } +} +function resetView(id) { + var testEl = jQuery('tr#' + id + ' td.resettable'); + testEl.html('-'); +} +function addConclusion(message, success, isSecure) { + show('#conclusion'); + var secureIcon = ''; + if (isSecure) { + secureIcon = '🔒 '; + } + if (success) { + message = '✅ ' + secureIcon + message; + } else { + message = '❌ ' + secureIcon + message; + } + jQuery('ol.conclusion').append('
  • ' + message + '
    • '); +} \ No newline at end of file diff --git a/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/effectiveTLDs.inc.php b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/effectiveTLDs.inc.php new file mode 100644 index 0000000..8f353c8 --- /dev/null +++ b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/effectiveTLDs.inc.php @@ -0,0 +1,6484 @@ + array('com' => array(), +'edu' => array(), +'gov' => array(), +'net' => array(), +'mil' => array(), +'org' => array()), +'ad' => array('nom' => array()), +'ae' => array('co' => array(), +'net' => array(), +'org' => array(), +'sch' => array(), +'ac' => array(), +'gov' => array(), +'mil' => array()), +'aero' => array('accident-investigation' => array(), +'accident-prevention' => array(), +'aerobatic' => array(), +'aeroclub' => array(), +'aerodrome' => array(), +'agents' => array(), +'aircraft' => array(), +'airline' => array(), +'airport' => array(), +'air-surveillance' => array(), +'airtraffic' => array(), +'air-traffic-control' => array(), +'ambulance' => array(), +'amusement' => array(), +'association' => array(), +'author' => array(), +'ballooning' => array(), +'broker' => array(), +'caa' => array(), +'cargo' => array(), +'catering' => array(), +'certification' => array(), +'championship' => array(), +'charter' => array(), +'civilaviation' => array(), +'club' => array(), +'conference' => array(), +'consultant' => array(), +'consulting' => array(), +'control' => array(), +'council' => array(), +'crew' => array(), +'design' => array(), +'dgca' => array(), +'educator' => array(), +'emergency' => array(), +'engine' => array(), +'engineer' => array(), +'entertainment' => array(), +'equipment' => array(), +'exchange' => array(), +'express' => array(), +'federation' => array(), +'flight' => array(), +'freight' => array(), +'fuel' => array(), +'gliding' => array(), +'government' => array(), +'groundhandling' => array(), +'group' => array(), +'hanggliding' => array(), +'homebuilt' => array(), +'insurance' => array(), +'journal' => array(), +'journalist' => array(), +'leasing' => array(), +'logistics' => array(), +'magazine' => array(), +'maintenance' => array(), +'marketplace' => array(), +'media' => array(), +'microlight' => array(), +'modelling' => array(), +'navigation' => array(), +'parachuting' => array(), +'paragliding' => array(), +'passenger-association' => array(), +'pilot' => array(), +'press' => array(), +'production' => array(), +'recreation' => array(), +'repbody' => array(), +'res' => array(), +'research' => array(), +'rotorcraft' => array(), +'safety' => array(), +'scientist' => array(), +'services' => array(), +'show' => array(), +'skydiving' => array(), +'software' => array(), +'student' => array(), +'taxi' => array(), +'trader' => array(), +'trading' => array(), +'trainer' => array(), +'union' => array(), +'workinggroup' => array(), +'works' => array()), +'af' => array('gov' => array(), +'com' => array(), +'org' => array(), +'net' => array(), +'edu' => array()), +'ag' => array('com' => array(), +'org' => array(), +'net' => array(), +'co' => array(), +'nom' => array()), +'ai' => array('off' => array(), +'com' => array(), +'net' => array(), +'org' => array()), +'al' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'mil' => array(), +'net' => array(), +'org' => array()), +'am' => array(), +'an' => array('com' => array(), +'net' => array(), +'org' => array(), +'edu' => array()), +'ao' => array('ed' => array(), +'gv' => array(), +'og' => array(), +'co' => array(), +'pb' => array(), +'it' => array()), +'aq' => array(), +'ar' => array('com' => array('blogspot' => array()), +'edu' => array(), +'gob' => array(), +'gov' => array(), +'int' => array(), +'mil' => array(), +'net' => array(), +'org' => array(), +'tur' => array()), +'arpa' => array('e164' => array(), +'in-addr' => array(), +'ip6' => array(), +'iris' => array(), +'uri' => array(), +'urn' => array()), +'as' => array('gov' => array()), +'asia' => array(), +'at' => array('ac' => array(), +'co' => array('blogspot' => array()), +'gv' => array(), +'or' => array(), +'biz' => array(), +'info' => array(), +'priv' => array()), +'au' => array('com' => array('blogspot' => array()), +'net' => array(), +'org' => array(), +'edu' => array('act' => array(), +'nsw' => array(), +'nt' => array(), +'qld' => array(), +'sa' => array(), +'tas' => array(), +'vic' => array(), +'wa' => array()), +'gov' => array('qld' => array(), +'sa' => array(), +'tas' => array(), +'vic' => array(), +'wa' => array()), +'asn' => array(), +'id' => array(), +'info' => array(), +'conf' => array(), +'oz' => array(), +'act' => array(), +'nsw' => array(), +'nt' => array(), +'qld' => array(), +'sa' => array(), +'tas' => array(), +'vic' => array(), +'wa' => array()), +'aw' => array('com' => array()), +'ax' => array(), +'az' => array('com' => array(), +'net' => array(), +'int' => array(), +'gov' => array(), +'org' => array(), +'edu' => array(), +'info' => array(), +'pp' => array(), +'mil' => array(), +'name' => array(), +'pro' => array(), +'biz' => array()), +'ba' => array('org' => array(), +'net' => array(), +'edu' => array(), +'gov' => array(), +'mil' => array(), +'unsa' => array(), +'unbi' => array(), +'co' => array(), +'com' => array(), +'rs' => array()), +'bb' => array('biz' => array(), +'co' => array(), +'com' => array(), +'edu' => array(), +'gov' => array(), +'info' => array(), +'net' => array(), +'org' => array(), +'store' => array(), +'tv' => array()), +'bd' => array('*' => array()), +'be' => array('ac' => array(), +'blogspot' => array()), +'bf' => array('gov' => array()), +'bg' => array('a' => array(), +'b' => array(), +'c' => array(), +'d' => array(), +'e' => array(), +'f' => array(), +'g' => array(), +'h' => array(), +'i' => array(), +'j' => array(), +'k' => array(), +'l' => array(), +'m' => array(), +'n' => array(), +'o' => array(), +'p' => array(), +'q' => array(), +'r' => array(), +'s' => array(), +'t' => array(), +'u' => array(), +'v' => array(), +'w' => array(), +'x' => array(), +'y' => array(), +'z' => array(), +'0' => array(), +'1' => array(), +'2' => array(), +'3' => array(), +'4' => array(), +'5' => array(), +'6' => array(), +'7' => array(), +'8' => array(), +'9' => array()), +'bh' => array('com' => array(), +'edu' => array(), +'net' => array(), +'org' => array(), +'gov' => array()), +'bi' => array('co' => array(), +'com' => array(), +'edu' => array(), +'or' => array(), +'org' => array()), +'biz' => array('dyndns' => array(), +'for-better' => array(), +'for-more' => array(), +'for-some' => array(), +'for-the' => array(), +'selfip' => array(), +'webhop' => array()), +'bj' => array('asso' => array(), +'barreau' => array(), +'gouv' => array(), +'blogspot' => array()), +'bm' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'net' => array(), +'org' => array()), +'bn' => array('*' => array()), +'bo' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'gob' => array(), +'int' => array(), +'org' => array(), +'net' => array(), +'mil' => array(), +'tv' => array()), +'br' => array('adm' => array(), +'adv' => array(), +'agr' => array(), +'am' => array(), +'arq' => array(), +'art' => array(), +'ato' => array(), +'b' => array(), +'bio' => array(), +'blog' => array(), +'bmd' => array(), +'cim' => array(), +'cng' => array(), +'cnt' => array(), +'com' => array('blogspot' => array()), +'coop' => array(), +'ecn' => array(), +'eco' => array(), +'edu' => array(), +'emp' => array(), +'eng' => array(), +'esp' => array(), +'etc' => array(), +'eti' => array(), +'far' => array(), +'flog' => array(), +'fm' => array(), +'fnd' => array(), +'fot' => array(), +'fst' => array(), +'g12' => array(), +'ggf' => array(), +'gov' => array(), +'imb' => array(), +'ind' => array(), +'inf' => array(), +'jor' => array(), +'jus' => array(), +'leg' => array(), +'lel' => array(), +'mat' => array(), +'med' => array(), +'mil' => array(), +'mp' => array(), +'mus' => array(), +'net' => array(), +'nom' => array('*' => array()), +'not' => array(), +'ntr' => array(), +'odo' => array(), +'org' => array(), +'ppg' => array(), +'pro' => array(), +'psc' => array(), +'psi' => array(), +'qsl' => array(), +'radio' => array(), +'rec' => array(), +'slg' => array(), +'srv' => array(), +'taxi' => array(), +'teo' => array(), +'tmp' => array(), +'trd' => array(), +'tur' => array(), +'tv' => array(), +'vet' => array(), +'vlog' => array(), +'wiki' => array(), +'zlg' => array()), +'bs' => array('com' => array(), +'net' => array(), +'org' => array(), +'edu' => array(), +'gov' => array()), +'bt' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'net' => array(), +'org' => array()), +'bv' => array(), +'bw' => array('co' => array(), +'org' => array()), +'by' => array('gov' => array(), +'mil' => array(), +'com' => array(), +'of' => array()), +'bz' => array('com' => array(), +'net' => array(), +'org' => array(), +'edu' => array(), +'gov' => array(), +'za' => array()), +'ca' => array('ab' => array(), +'bc' => array(), +'mb' => array(), +'nb' => array(), +'nf' => array(), +'nl' => array(), +'ns' => array(), +'nt' => array(), +'nu' => array(), +'on' => array(), +'pe' => array(), +'qc' => array(), +'sk' => array(), +'yk' => array(), +'gc' => array(), +'co' => array(), +'blogspot' => array()), +'cat' => array(), +'cc' => array('ftpaccess' => array(), +'game-server' => array(), +'myphotos' => array(), +'scrapping' => array()), +'cd' => array('gov' => array()), +'cf' => array('blogspot' => array()), +'cg' => array(), +'ch' => array('blogspot' => array()), +'ci' => array('org' => array(), +'or' => array(), +'com' => array(), +'co' => array(), +'edu' => array(), +'ed' => array(), +'ac' => array(), +'net' => array(), +'go' => array(), +'asso' => array(), +'aéroport' => array(), +'int' => array(), +'presse' => array(), +'md' => array(), +'gouv' => array()), +'ck' => array('*' => array(), +'www' => array('!' => '')), +'cl' => array('gov' => array(), +'gob' => array(), +'co' => array(), +'mil' => array()), +'cm' => array('co' => array(), +'com' => array(), +'gov' => array(), +'net' => array()), +'cn' => array('ac' => array(), +'com' => array(), +'edu' => array(), +'gov' => array(), +'net' => array(), +'org' => array(), +'mil' => array(), +'公司' => array(), +'网络' => array(), +'網絡' => array(), +'ah' => array(), +'bj' => array(), +'cq' => array(), +'fj' => array(), +'gd' => array(), +'gs' => array(), +'gz' => array(), +'gx' => array(), +'ha' => array(), +'hb' => array(), +'he' => array(), +'hi' => array(), +'hl' => array(), +'hn' => array(), +'jl' => array(), +'js' => array(), +'jx' => array(), +'ln' => array(), +'nm' => array(), +'nx' => array(), +'qh' => array(), +'sc' => array(), +'sd' => array(), +'sh' => array(), +'sn' => array(), +'sx' => array(), +'tj' => array(), +'xj' => array(), +'xz' => array(), +'yn' => array(), +'zj' => array(), +'hk' => array(), +'mo' => array(), +'tw' => array(), +'amazonaws' => array('compute' => array('cn-north-1' => array()))), +'co' => array('arts' => array(), +'com' => array(), +'edu' => array(), +'firm' => array(), +'gov' => array(), +'info' => array(), +'int' => array(), +'mil' => array(), +'net' => array(), +'nom' => array(), +'org' => array(), +'rec' => array(), +'web' => array()), +'com' => array('amazonaws' => array('compute' => array('ap-northeast-1' => array(), +'ap-southeast-1' => array(), +'ap-southeast-2' => array(), +'eu-west-1' => array(), +'sa-east-1' => array(), +'us-gov-west-1' => array(), +'us-west-1' => array(), +'us-west-2' => array()), +'compute-1' => array('z-1' => array(), +'z-2' => array()), +'us-east-1' => array(), +'elb' => array(), +'s3' => array(), +'s3-us-west-2' => array(), +'s3-us-west-1' => array(), +'s3-eu-west-1' => array(), +'s3-ap-southeast-1' => array(), +'s3-ap-southeast-2' => array(), +'s3-ap-northeast-1' => array(), +'s3-sa-east-1' => array(), +'s3-us-gov-west-1' => array(), +'s3-fips-us-gov-west-1' => array(), +'s3-website-us-east-1' => array(), +'s3-website-us-west-2' => array(), +'s3-website-us-west-1' => array(), +'s3-website-eu-west-1' => array(), +'s3-website-ap-southeast-1' => array(), +'s3-website-ap-southeast-2' => array(), +'s3-website-ap-northeast-1' => array(), +'s3-website-sa-east-1' => array(), +'s3-website-us-gov-west-1' => array()), +'elasticbeanstalk' => array(), +'betainabox' => array(), +'ar' => array(), +'br' => array(), +'cn' => array(), +'de' => array(), +'eu' => array(), +'gb' => array(), +'hu' => array(), +'jpn' => array(), +'kr' => array(), +'mex' => array(), +'no' => array(), +'qc' => array(), +'ru' => array(), +'sa' => array(), +'se' => array(), +'uk' => array(), +'us' => array(), +'uy' => array(), +'za' => array(), +'africa' => array(), +'gr' => array(), +'co' => array(), +'cloudcontrolled' => array(), +'cloudcontrolapp' => array(), +'dreamhosters' => array(), +'dyndns-at-home' => array(), +'dyndns-at-work' => array(), +'dyndns-blog' => array(), +'dyndns-free' => array(), +'dyndns-home' => array(), +'dyndns-ip' => array(), +'dyndns-mail' => array(), +'dyndns-office' => array(), +'dyndns-pics' => array(), +'dyndns-remote' => array(), +'dyndns-server' => array(), +'dyndns-web' => array(), +'dyndns-wiki' => array(), +'dyndns-work' => array(), +'blogdns' => array(), +'cechire' => array(), +'dnsalias' => array(), +'dnsdojo' => array(), +'doesntexist' => array(), +'dontexist' => array(), +'doomdns' => array(), +'dyn-o-saur' => array(), +'dynalias' => array(), +'est-a-la-maison' => array(), +'est-a-la-masion' => array(), +'est-le-patron' => array(), +'est-mon-blogueur' => array(), +'from-ak' => array(), +'from-al' => array(), +'from-ar' => array(), +'from-ca' => array(), +'from-ct' => array(), +'from-dc' => array(), +'from-de' => array(), +'from-fl' => array(), +'from-ga' => array(), +'from-hi' => array(), +'from-ia' => array(), +'from-id' => array(), +'from-il' => array(), +'from-in' => array(), +'from-ks' => array(), +'from-ky' => array(), +'from-ma' => array(), +'from-md' => array(), +'from-mi' => array(), +'from-mn' => array(), +'from-mo' => array(), +'from-ms' => array(), +'from-mt' => array(), +'from-nc' => array(), +'from-nd' => array(), +'from-ne' => array(), +'from-nh' => array(), +'from-nj' => array(), +'from-nm' => array(), +'from-nv' => array(), +'from-oh' => array(), +'from-ok' => array(), +'from-or' => array(), +'from-pa' => array(), +'from-pr' => array(), +'from-ri' => array(), +'from-sc' => array(), +'from-sd' => array(), +'from-tn' => array(), +'from-tx' => array(), +'from-ut' => array(), +'from-va' => array(), +'from-vt' => array(), +'from-wa' => array(), +'from-wi' => array(), +'from-wv' => array(), +'from-wy' => array(), +'getmyip' => array(), +'gotdns' => array(), +'hobby-site' => array(), +'homelinux' => array(), +'homeunix' => array(), +'iamallama' => array(), +'is-a-anarchist' => array(), +'is-a-blogger' => array(), +'is-a-bookkeeper' => array(), +'is-a-bulls-fan' => array(), +'is-a-caterer' => array(), +'is-a-chef' => array(), +'is-a-conservative' => array(), +'is-a-cpa' => array(), +'is-a-cubicle-slave' => array(), +'is-a-democrat' => array(), +'is-a-designer' => array(), +'is-a-doctor' => array(), +'is-a-financialadvisor' => array(), +'is-a-geek' => array(), +'is-a-green' => array(), +'is-a-guru' => array(), +'is-a-hard-worker' => array(), +'is-a-hunter' => array(), +'is-a-landscaper' => array(), +'is-a-lawyer' => array(), +'is-a-liberal' => array(), +'is-a-libertarian' => array(), +'is-a-llama' => array(), +'is-a-musician' => array(), +'is-a-nascarfan' => array(), +'is-a-nurse' => array(), +'is-a-painter' => array(), +'is-a-personaltrainer' => array(), +'is-a-photographer' => array(), +'is-a-player' => array(), +'is-a-republican' => array(), +'is-a-rockstar' => array(), +'is-a-socialist' => array(), +'is-a-student' => array(), +'is-a-teacher' => array(), +'is-a-techie' => array(), +'is-a-therapist' => array(), +'is-an-accountant' => array(), +'is-an-actor' => array(), +'is-an-actress' => array(), +'is-an-anarchist' => array(), +'is-an-artist' => array(), +'is-an-engineer' => array(), +'is-an-entertainer' => array(), +'is-certified' => array(), +'is-gone' => array(), +'is-into-anime' => array(), +'is-into-cars' => array(), +'is-into-cartoons' => array(), +'is-into-games' => array(), +'is-leet' => array(), +'is-not-certified' => array(), +'is-slick' => array(), +'is-uberleet' => array(), +'is-with-theband' => array(), +'isa-geek' => array(), +'isa-hockeynut' => array(), +'issmarterthanyou' => array(), +'likes-pie' => array(), +'likescandy' => array(), +'neat-url' => array(), +'saves-the-whales' => array(), +'selfip' => array(), +'sells-for-less' => array(), +'sells-for-u' => array(), +'servebbs' => array(), +'simple-url' => array(), +'space-to-rent' => array(), +'teaches-yoga' => array(), +'writesthisblog' => array(), +'firebaseapp' => array(), +'flynnhub' => array(), +'githubusercontent' => array(), +'ro' => array(), +'appspot' => array(), +'blogspot' => array(), +'codespot' => array(), +'googleapis' => array(), +'googlecode' => array(), +'withgoogle' => array(), +'herokuapp' => array(), +'herokussl' => array(), +'nfshost' => array(), +'operaunite' => array(), +'outsystemscloud' => array(), +'rhcloud' => array(), +'yolasite' => array()), +'coop' => array(), +'cr' => array('ac' => array(), +'co' => array(), +'ed' => array(), +'fi' => array(), +'go' => array(), +'or' => array(), +'sa' => array()), +'cu' => array('com' => array(), +'edu' => array(), +'org' => array(), +'net' => array(), +'gov' => array(), +'inf' => array()), +'cv' => array('blogspot' => array()), +'cw' => array('com' => array(), +'edu' => array(), +'net' => array(), +'org' => array()), +'cx' => array('gov' => array(), +'ath' => array()), +'cy' => array('*' => array()), +'cz' => array('blogspot' => array()), +'de' => array('com' => array(), +'fuettertdasnetz' => array(), +'isteingeek' => array(), +'istmein' => array(), +'lebtimnetz' => array(), +'leitungsen' => array(), +'traeumtgerade' => array(), +'blogspot' => array()), +'dj' => array(), +'dk' => array('blogspot' => array()), +'dm' => array('com' => array(), +'net' => array(), +'org' => array(), +'edu' => array(), +'gov' => array()), +'do' => array('art' => array(), +'com' => array(), +'edu' => array(), +'gob' => array(), +'gov' => array(), +'mil' => array(), +'net' => array(), +'org' => array(), +'sld' => array(), +'web' => array()), +'dz' => array('com' => array(), +'org' => array(), +'net' => array(), +'gov' => array(), +'edu' => array(), +'asso' => array(), +'pol' => array(), +'art' => array()), +'ec' => array('com' => array(), +'info' => array(), +'net' => array(), +'fin' => array(), +'k12' => array(), +'med' => array(), +'pro' => array(), +'org' => array(), +'edu' => array(), +'gov' => array(), +'gob' => array(), +'mil' => array()), +'edu' => array(), +'ee' => array('edu' => array(), +'gov' => array(), +'riik' => array(), +'lib' => array(), +'med' => array(), +'com' => array(), +'pri' => array(), +'aip' => array(), +'org' => array(), +'fie' => array()), +'eg' => array('com' => array(), +'edu' => array(), +'eun' => array(), +'gov' => array(), +'mil' => array(), +'name' => array(), +'net' => array(), +'org' => array(), +'sci' => array()), +'er' => array('*' => array()), +'es' => array('com' => array('blogspot' => array()), +'nom' => array(), +'org' => array(), +'gob' => array(), +'edu' => array()), +'et' => array('com' => array(), +'gov' => array(), +'org' => array(), +'edu' => array(), +'biz' => array(), +'name' => array(), +'info' => array()), +'eu' => array(), +'fi' => array('aland' => array(), +'blogspot' => array(), +'iki' => array()), +'fj' => array('*' => array()), +'fk' => array('*' => array()), +'fm' => array(), +'fo' => array(), +'fr' => array('com' => array(), +'asso' => array(), +'nom' => array(), +'prd' => array(), +'presse' => array(), +'tm' => array(), +'aeroport' => array(), +'assedic' => array(), +'avocat' => array(), +'avoues' => array(), +'cci' => array(), +'chambagri' => array(), +'chirurgiens-dentistes' => array(), +'experts-comptables' => array(), +'geometre-expert' => array(), +'gouv' => array(), +'greta' => array(), +'huissier-justice' => array(), +'medecin' => array(), +'notaires' => array(), +'pharmacien' => array(), +'port' => array(), +'veterinaire' => array(), +'blogspot' => array()), +'ga' => array(), +'gb' => array(), +'gd' => array(), +'ge' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'org' => array(), +'mil' => array(), +'net' => array(), +'pvt' => array()), +'gf' => array(), +'gg' => array('co' => array(), +'net' => array(), +'org' => array()), +'gh' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'org' => array(), +'mil' => array()), +'gi' => array('com' => array(), +'ltd' => array(), +'gov' => array(), +'mod' => array(), +'edu' => array(), +'org' => array()), +'gl' => array(), +'gm' => array(), +'gn' => array('ac' => array(), +'com' => array(), +'edu' => array(), +'gov' => array(), +'org' => array(), +'net' => array()), +'gov' => array(), +'gp' => array('com' => array(), +'net' => array(), +'mobi' => array(), +'edu' => array(), +'org' => array(), +'asso' => array()), +'gq' => array(), +'gr' => array('com' => array(), +'edu' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'blogspot' => array()), +'gs' => array(), +'gt' => array('com' => array(), +'edu' => array(), +'gob' => array(), +'ind' => array(), +'mil' => array(), +'net' => array(), +'org' => array()), +'gu' => array('*' => array()), +'gw' => array(), +'gy' => array('co' => array(), +'com' => array(), +'net' => array()), +'hk' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'idv' => array(), +'net' => array(), +'org' => array(), +'公司' => array(), +'教育' => array(), +'敎育' => array(), +'政府' => array(), +'個人' => array(), +'个人' => array(), +'箇人' => array(), +'網络' => array(), +'网络' => array(), +'组織' => array(), +'網絡' => array(), +'网絡' => array(), +'组织' => array(), +'組織' => array(), +'組织' => array(), +'blogspot' => array()), +'hm' => array(), +'hn' => array('com' => array(), +'edu' => array(), +'org' => array(), +'net' => array(), +'mil' => array(), +'gob' => array()), +'hr' => array('iz' => array(), +'from' => array(), +'name' => array(), +'com' => array()), +'ht' => array('com' => array(), +'shop' => array(), +'firm' => array(), +'info' => array(), +'adult' => array(), +'net' => array(), +'pro' => array(), +'org' => array(), +'med' => array(), +'art' => array(), +'coop' => array(), +'pol' => array(), +'asso' => array(), +'edu' => array(), +'rel' => array(), +'gouv' => array(), +'perso' => array()), +'hu' => array('co' => array(), +'info' => array(), +'org' => array(), +'priv' => array(), +'sport' => array(), +'tm' => array(), +'2000' => array(), +'agrar' => array(), +'bolt' => array(), +'casino' => array(), +'city' => array(), +'erotica' => array(), +'erotika' => array(), +'film' => array(), +'forum' => array(), +'games' => array(), +'hotel' => array(), +'ingatlan' => array(), +'jogasz' => array(), +'konyvelo' => array(), +'lakas' => array(), +'media' => array(), +'news' => array(), +'reklam' => array(), +'sex' => array(), +'shop' => array(), +'suli' => array(), +'szex' => array(), +'tozsde' => array(), +'utazas' => array(), +'video' => array(), +'blogspot' => array()), +'id' => array('ac' => array(), +'biz' => array(), +'co' => array(), +'desa' => array(), +'go' => array(), +'mil' => array(), +'my' => array(), +'net' => array(), +'or' => array(), +'sch' => array(), +'web' => array()), +'ie' => array('gov' => array(), +'blogspot' => array()), +'il' => array('*' => array(), +'co' => array('blogspot' => array())), +'im' => array('ac' => array(), +'co' => array('ltd' => array(), +'plc' => array()), +'com' => array(), +'net' => array(), +'org' => array(), +'tt' => array(), +'tv' => array()), +'in' => array('co' => array(), +'firm' => array(), +'net' => array(), +'org' => array(), +'gen' => array(), +'ind' => array(), +'nic' => array(), +'ac' => array(), +'edu' => array(), +'res' => array(), +'gov' => array(), +'mil' => array(), +'blogspot' => array()), +'info' => array('dyndns' => array(), +'barrel-of-knowledge' => array(), +'barrell-of-knowledge' => array(), +'for-our' => array(), +'groks-the' => array(), +'groks-this' => array(), +'here-for-more' => array(), +'knowsitall' => array(), +'selfip' => array(), +'webhop' => array()), +'int' => array('eu' => array()), +'io' => array('com' => array(), +'github' => array(), +'nid' => array()), +'iq' => array('gov' => array(), +'edu' => array(), +'mil' => array(), +'com' => array(), +'org' => array(), +'net' => array()), +'ir' => array('ac' => array(), +'co' => array(), +'gov' => array(), +'id' => array(), +'net' => array(), +'org' => array(), +'sch' => array(), +'ایران' => array(), +'ايران' => array()), +'is' => array('net' => array(), +'com' => array(), +'edu' => array(), +'gov' => array(), +'org' => array(), +'int' => array(), +'cupcake' => array()), +'it' => array('gov' => array(), +'edu' => array(), +'abr' => array(), +'abruzzo' => array(), +'aosta-valley' => array(), +'aostavalley' => array(), +'bas' => array(), +'basilicata' => array(), +'cal' => array(), +'calabria' => array(), +'cam' => array(), +'campania' => array(), +'emilia-romagna' => array(), +'emiliaromagna' => array(), +'emr' => array(), +'friuli-v-giulia' => array(), +'friuli-ve-giulia' => array(), +'friuli-vegiulia' => array(), +'friuli-venezia-giulia' => array(), +'friuli-veneziagiulia' => array(), +'friuli-vgiulia' => array(), +'friuliv-giulia' => array(), +'friulive-giulia' => array(), +'friulivegiulia' => array(), +'friulivenezia-giulia' => array(), +'friuliveneziagiulia' => array(), +'friulivgiulia' => array(), +'fvg' => array(), +'laz' => array(), +'lazio' => array(), +'lig' => array(), +'liguria' => array(), +'lom' => array(), +'lombardia' => array(), +'lombardy' => array(), +'lucania' => array(), +'mar' => array(), +'marche' => array(), +'mol' => array(), +'molise' => array(), +'piedmont' => array(), +'piemonte' => array(), +'pmn' => array(), +'pug' => array(), +'puglia' => array(), +'sar' => array(), +'sardegna' => array(), +'sardinia' => array(), +'sic' => array(), +'sicilia' => array(), +'sicily' => array(), +'taa' => array(), +'tos' => array(), +'toscana' => array(), +'trentino-a-adige' => array(), +'trentino-aadige' => array(), +'trentino-alto-adige' => array(), +'trentino-altoadige' => array(), +'trentino-s-tirol' => array(), +'trentino-stirol' => array(), +'trentino-sud-tirol' => array(), +'trentino-sudtirol' => array(), +'trentino-sued-tirol' => array(), +'trentino-suedtirol' => array(), +'trentinoa-adige' => array(), +'trentinoaadige' => array(), +'trentinoalto-adige' => array(), +'trentinoaltoadige' => array(), +'trentinos-tirol' => array(), +'trentinostirol' => array(), +'trentinosud-tirol' => array(), +'trentinosudtirol' => array(), +'trentinosued-tirol' => array(), +'trentinosuedtirol' => array(), +'tuscany' => array(), +'umb' => array(), +'umbria' => array(), +'val-d-aosta' => array(), +'val-daosta' => array(), +'vald-aosta' => array(), +'valdaosta' => array(), +'valle-aosta' => array(), +'valle-d-aosta' => array(), +'valle-daosta' => array(), +'valleaosta' => array(), +'valled-aosta' => array(), +'valledaosta' => array(), +'vallee-aoste' => array(), +'valleeaoste' => array(), +'vao' => array(), +'vda' => array(), +'ven' => array(), +'veneto' => array(), +'ag' => array(), +'agrigento' => array(), +'al' => array(), +'alessandria' => array(), +'alto-adige' => array(), +'altoadige' => array(), +'an' => array(), +'ancona' => array(), +'andria-barletta-trani' => array(), +'andria-trani-barletta' => array(), +'andriabarlettatrani' => array(), +'andriatranibarletta' => array(), +'ao' => array(), +'aosta' => array(), +'aoste' => array(), +'ap' => array(), +'aq' => array(), +'aquila' => array(), +'ar' => array(), +'arezzo' => array(), +'ascoli-piceno' => array(), +'ascolipiceno' => array(), +'asti' => array(), +'at' => array(), +'av' => array(), +'avellino' => array(), +'ba' => array(), +'balsan' => array(), +'bari' => array(), +'barletta-trani-andria' => array(), +'barlettatraniandria' => array(), +'belluno' => array(), +'benevento' => array(), +'bergamo' => array(), +'bg' => array(), +'bi' => array(), +'biella' => array(), +'bl' => array(), +'bn' => array(), +'bo' => array(), +'bologna' => array(), +'bolzano' => array(), +'bozen' => array(), +'br' => array(), +'brescia' => array(), +'brindisi' => array(), +'bs' => array(), +'bt' => array(), +'bz' => array(), +'ca' => array(), +'cagliari' => array(), +'caltanissetta' => array(), +'campidano-medio' => array(), +'campidanomedio' => array(), +'campobasso' => array(), +'carbonia-iglesias' => array(), +'carboniaiglesias' => array(), +'carrara-massa' => array(), +'carraramassa' => array(), +'caserta' => array(), +'catania' => array(), +'catanzaro' => array(), +'cb' => array(), +'ce' => array(), +'cesena-forli' => array(), +'cesenaforli' => array(), +'ch' => array(), +'chieti' => array(), +'ci' => array(), +'cl' => array(), +'cn' => array(), +'co' => array(), +'como' => array(), +'cosenza' => array(), +'cr' => array(), +'cremona' => array(), +'crotone' => array(), +'cs' => array(), +'ct' => array(), +'cuneo' => array(), +'cz' => array(), +'dell-ogliastra' => array(), +'dellogliastra' => array(), +'en' => array(), +'enna' => array(), +'fc' => array(), +'fe' => array(), +'fermo' => array(), +'ferrara' => array(), +'fg' => array(), +'fi' => array(), +'firenze' => array(), +'florence' => array(), +'fm' => array(), +'foggia' => array(), +'forli-cesena' => array(), +'forlicesena' => array(), +'fr' => array(), +'frosinone' => array(), +'ge' => array(), +'genoa' => array(), +'genova' => array(), +'go' => array(), +'gorizia' => array(), +'gr' => array(), +'grosseto' => array(), +'iglesias-carbonia' => array(), +'iglesiascarbonia' => array(), +'im' => array(), +'imperia' => array(), +'is' => array(), +'isernia' => array(), +'kr' => array(), +'la-spezia' => array(), +'laquila' => array(), +'laspezia' => array(), +'latina' => array(), +'lc' => array(), +'le' => array(), +'lecce' => array(), +'lecco' => array(), +'li' => array(), +'livorno' => array(), +'lo' => array(), +'lodi' => array(), +'lt' => array(), +'lu' => array(), +'lucca' => array(), +'macerata' => array(), +'mantova' => array(), +'massa-carrara' => array(), +'massacarrara' => array(), +'matera' => array(), +'mb' => array(), +'mc' => array(), +'me' => array(), +'medio-campidano' => array(), +'mediocampidano' => array(), +'messina' => array(), +'mi' => array(), +'milan' => array(), +'milano' => array(), +'mn' => array(), +'mo' => array(), +'modena' => array(), +'monza-brianza' => array(), +'monza-e-della-brianza' => array(), +'monza' => array(), +'monzabrianza' => array(), +'monzaebrianza' => array(), +'monzaedellabrianza' => array(), +'ms' => array(), +'mt' => array(), +'na' => array(), +'naples' => array(), +'napoli' => array(), +'no' => array(), +'novara' => array(), +'nu' => array(), +'nuoro' => array(), +'og' => array(), +'ogliastra' => array(), +'olbia-tempio' => array(), +'olbiatempio' => array(), +'or' => array(), +'oristano' => array(), +'ot' => array(), +'pa' => array(), +'padova' => array(), +'padua' => array(), +'palermo' => array(), +'parma' => array(), +'pavia' => array(), +'pc' => array(), +'pd' => array(), +'pe' => array(), +'perugia' => array(), +'pesaro-urbino' => array(), +'pesarourbino' => array(), +'pescara' => array(), +'pg' => array(), +'pi' => array(), +'piacenza' => array(), +'pisa' => array(), +'pistoia' => array(), +'pn' => array(), +'po' => array(), +'pordenone' => array(), +'potenza' => array(), +'pr' => array(), +'prato' => array(), +'pt' => array(), +'pu' => array(), +'pv' => array(), +'pz' => array(), +'ra' => array(), +'ragusa' => array(), +'ravenna' => array(), +'rc' => array(), +'re' => array(), +'reggio-calabria' => array(), +'reggio-emilia' => array(), +'reggiocalabria' => array(), +'reggioemilia' => array(), +'rg' => array(), +'ri' => array(), +'rieti' => array(), +'rimini' => array(), +'rm' => array(), +'rn' => array(), +'ro' => array(), +'roma' => array(), +'rome' => array(), +'rovigo' => array(), +'sa' => array(), +'salerno' => array(), +'sassari' => array(), +'savona' => array(), +'si' => array(), +'siena' => array(), +'siracusa' => array(), +'so' => array(), +'sondrio' => array(), +'sp' => array(), +'sr' => array(), +'ss' => array(), +'suedtirol' => array(), +'sv' => array(), +'ta' => array(), +'taranto' => array(), +'te' => array(), +'tempio-olbia' => array(), +'tempioolbia' => array(), +'teramo' => array(), +'terni' => array(), +'tn' => array(), +'to' => array(), +'torino' => array(), +'tp' => array(), +'tr' => array(), +'trani-andria-barletta' => array(), +'trani-barletta-andria' => array(), +'traniandriabarletta' => array(), +'tranibarlettaandria' => array(), +'trapani' => array(), +'trentino' => array(), +'trento' => array(), +'treviso' => array(), +'trieste' => array(), +'ts' => array(), +'turin' => array(), +'tv' => array(), +'ud' => array(), +'udine' => array(), +'urbino-pesaro' => array(), +'urbinopesaro' => array(), +'va' => array(), +'varese' => array(), +'vb' => array(), +'vc' => array(), +'ve' => array(), +'venezia' => array(), +'venice' => array(), +'verbania' => array(), +'vercelli' => array(), +'verona' => array(), +'vi' => array(), +'vibo-valentia' => array(), +'vibovalentia' => array(), +'vicenza' => array(), +'viterbo' => array(), +'vr' => array(), +'vs' => array(), +'vt' => array(), +'vv' => array(), +'blogspot' => array()), +'je' => array('co' => array(), +'net' => array(), +'org' => array()), +'jm' => array('*' => array()), +'jo' => array('com' => array(), +'org' => array(), +'net' => array(), +'edu' => array(), +'sch' => array(), +'gov' => array(), +'mil' => array(), +'name' => array()), +'jobs' => array(), +'jp' => array('ac' => array(), +'ad' => array(), +'co' => array(), +'ed' => array(), +'go' => array(), +'gr' => array(), +'lg' => array(), +'ne' => array(), +'or' => array(), +'aichi' => array('aisai' => array(), +'ama' => array(), +'anjo' => array(), +'asuke' => array(), +'chiryu' => array(), +'chita' => array(), +'fuso' => array(), +'gamagori' => array(), +'handa' => array(), +'hazu' => array(), +'hekinan' => array(), +'higashiura' => array(), +'ichinomiya' => array(), +'inazawa' => array(), +'inuyama' => array(), +'isshiki' => array(), +'iwakura' => array(), +'kanie' => array(), +'kariya' => array(), +'kasugai' => array(), +'kira' => array(), +'kiyosu' => array(), +'komaki' => array(), +'konan' => array(), +'kota' => array(), +'mihama' => array(), +'miyoshi' => array(), +'nishio' => array(), +'nisshin' => array(), +'obu' => array(), +'oguchi' => array(), +'oharu' => array(), +'okazaki' => array(), +'owariasahi' => array(), +'seto' => array(), +'shikatsu' => array(), +'shinshiro' => array(), +'shitara' => array(), +'tahara' => array(), +'takahama' => array(), +'tobishima' => array(), +'toei' => array(), +'togo' => array(), +'tokai' => array(), +'tokoname' => array(), +'toyoake' => array(), +'toyohashi' => array(), +'toyokawa' => array(), +'toyone' => array(), +'toyota' => array(), +'tsushima' => array(), +'yatomi' => array()), +'akita' => array('akita' => array(), +'daisen' => array(), +'fujisato' => array(), +'gojome' => array(), +'hachirogata' => array(), +'happou' => array(), +'higashinaruse' => array(), +'honjo' => array(), +'honjyo' => array(), +'ikawa' => array(), +'kamikoani' => array(), +'kamioka' => array(), +'katagami' => array(), +'kazuno' => array(), +'kitaakita' => array(), +'kosaka' => array(), +'kyowa' => array(), +'misato' => array(), +'mitane' => array(), +'moriyoshi' => array(), +'nikaho' => array(), +'noshiro' => array(), +'odate' => array(), +'oga' => array(), +'ogata' => array(), +'semboku' => array(), +'yokote' => array(), +'yurihonjo' => array()), +'aomori' => array('aomori' => array(), +'gonohe' => array(), +'hachinohe' => array(), +'hashikami' => array(), +'hiranai' => array(), +'hirosaki' => array(), +'itayanagi' => array(), +'kuroishi' => array(), +'misawa' => array(), +'mutsu' => array(), +'nakadomari' => array(), +'noheji' => array(), +'oirase' => array(), +'owani' => array(), +'rokunohe' => array(), +'sannohe' => array(), +'shichinohe' => array(), +'shingo' => array(), +'takko' => array(), +'towada' => array(), +'tsugaru' => array(), +'tsuruta' => array()), +'chiba' => array('abiko' => array(), +'asahi' => array(), +'chonan' => array(), +'chosei' => array(), +'choshi' => array(), +'chuo' => array(), +'funabashi' => array(), +'futtsu' => array(), +'hanamigawa' => array(), +'ichihara' => array(), +'ichikawa' => array(), +'ichinomiya' => array(), +'inzai' => array(), +'isumi' => array(), +'kamagaya' => array(), +'kamogawa' => array(), +'kashiwa' => array(), +'katori' => array(), +'katsuura' => array(), +'kimitsu' => array(), +'kisarazu' => array(), +'kozaki' => array(), +'kujukuri' => array(), +'kyonan' => array(), +'matsudo' => array(), +'midori' => array(), +'mihama' => array(), +'minamiboso' => array(), +'mobara' => array(), +'mutsuzawa' => array(), +'nagara' => array(), +'nagareyama' => array(), +'narashino' => array(), +'narita' => array(), +'noda' => array(), +'oamishirasato' => array(), +'omigawa' => array(), +'onjuku' => array(), +'otaki' => array(), +'sakae' => array(), +'sakura' => array(), +'shimofusa' => array(), +'shirako' => array(), +'shiroi' => array(), +'shisui' => array(), +'sodegaura' => array(), +'sosa' => array(), +'tako' => array(), +'tateyama' => array(), +'togane' => array(), +'tohnosho' => array(), +'tomisato' => array(), +'urayasu' => array(), +'yachimata' => array(), +'yachiyo' => array(), +'yokaichiba' => array(), +'yokoshibahikari' => array(), +'yotsukaido' => array()), +'ehime' => array('ainan' => array(), +'honai' => array(), +'ikata' => array(), +'imabari' => array(), +'iyo' => array(), +'kamijima' => array(), +'kihoku' => array(), +'kumakogen' => array(), +'masaki' => array(), +'matsuno' => array(), +'matsuyama' => array(), +'namikata' => array(), +'niihama' => array(), +'ozu' => array(), +'saijo' => array(), +'seiyo' => array(), +'shikokuchuo' => array(), +'tobe' => array(), +'toon' => array(), +'uchiko' => array(), +'uwajima' => array(), +'yawatahama' => array()), +'fukui' => array('echizen' => array(), +'eiheiji' => array(), +'fukui' => array(), +'ikeda' => array(), +'katsuyama' => array(), +'mihama' => array(), +'minamiechizen' => array(), +'obama' => array(), +'ohi' => array(), +'ono' => array(), +'sabae' => array(), +'sakai' => array(), +'takahama' => array(), +'tsuruga' => array(), +'wakasa' => array()), +'fukuoka' => array('ashiya' => array(), +'buzen' => array(), +'chikugo' => array(), +'chikuho' => array(), +'chikujo' => array(), +'chikushino' => array(), +'chikuzen' => array(), +'chuo' => array(), +'dazaifu' => array(), +'fukuchi' => array(), +'hakata' => array(), +'higashi' => array(), +'hirokawa' => array(), +'hisayama' => array(), +'iizuka' => array(), +'inatsuki' => array(), +'kaho' => array(), +'kasuga' => array(), +'kasuya' => array(), +'kawara' => array(), +'keisen' => array(), +'koga' => array(), +'kurate' => array(), +'kurogi' => array(), +'kurume' => array(), +'minami' => array(), +'miyako' => array(), +'miyama' => array(), +'miyawaka' => array(), +'mizumaki' => array(), +'munakata' => array(), +'nakagawa' => array(), +'nakama' => array(), +'nishi' => array(), +'nogata' => array(), +'ogori' => array(), +'okagaki' => array(), +'okawa' => array(), +'oki' => array(), +'omuta' => array(), +'onga' => array(), +'onojo' => array(), +'oto' => array(), +'saigawa' => array(), +'sasaguri' => array(), +'shingu' => array(), +'shinyoshitomi' => array(), +'shonai' => array(), +'soeda' => array(), +'sue' => array(), +'tachiarai' => array(), +'tagawa' => array(), +'takata' => array(), +'toho' => array(), +'toyotsu' => array(), +'tsuiki' => array(), +'ukiha' => array(), +'umi' => array(), +'usui' => array(), +'yamada' => array(), +'yame' => array(), +'yanagawa' => array(), +'yukuhashi' => array()), +'fukushima' => array('aizubange' => array(), +'aizumisato' => array(), +'aizuwakamatsu' => array(), +'asakawa' => array(), +'bandai' => array(), +'date' => array(), +'fukushima' => array(), +'furudono' => array(), +'futaba' => array(), +'hanawa' => array(), +'higashi' => array(), +'hirata' => array(), +'hirono' => array(), +'iitate' => array(), +'inawashiro' => array(), +'ishikawa' => array(), +'iwaki' => array(), +'izumizaki' => array(), +'kagamiishi' => array(), +'kaneyama' => array(), +'kawamata' => array(), +'kitakata' => array(), +'kitashiobara' => array(), +'koori' => array(), +'koriyama' => array(), +'kunimi' => array(), +'miharu' => array(), +'mishima' => array(), +'namie' => array(), +'nango' => array(), +'nishiaizu' => array(), +'nishigo' => array(), +'okuma' => array(), +'omotego' => array(), +'ono' => array(), +'otama' => array(), +'samegawa' => array(), +'shimogo' => array(), +'shirakawa' => array(), +'showa' => array(), +'soma' => array(), +'sukagawa' => array(), +'taishin' => array(), +'tamakawa' => array(), +'tanagura' => array(), +'tenei' => array(), +'yabuki' => array(), +'yamato' => array(), +'yamatsuri' => array(), +'yanaizu' => array(), +'yugawa' => array()), +'gifu' => array('anpachi' => array(), +'ena' => array(), +'gifu' => array(), +'ginan' => array(), +'godo' => array(), +'gujo' => array(), +'hashima' => array(), +'hichiso' => array(), +'hida' => array(), +'higashishirakawa' => array(), +'ibigawa' => array(), +'ikeda' => array(), +'kakamigahara' => array(), +'kani' => array(), +'kasahara' => array(), +'kasamatsu' => array(), +'kawaue' => array(), +'kitagata' => array(), +'mino' => array(), +'minokamo' => array(), +'mitake' => array(), +'mizunami' => array(), +'motosu' => array(), +'nakatsugawa' => array(), +'ogaki' => array(), +'sakahogi' => array(), +'seki' => array(), +'sekigahara' => array(), +'shirakawa' => array(), +'tajimi' => array(), +'takayama' => array(), +'tarui' => array(), +'toki' => array(), +'tomika' => array(), +'wanouchi' => array(), +'yamagata' => array(), +'yaotsu' => array(), +'yoro' => array()), +'gunma' => array('annaka' => array(), +'chiyoda' => array(), +'fujioka' => array(), +'higashiagatsuma' => array(), +'isesaki' => array(), +'itakura' => array(), +'kanna' => array(), +'kanra' => array(), +'katashina' => array(), +'kawaba' => array(), +'kiryu' => array(), +'kusatsu' => array(), +'maebashi' => array(), +'meiwa' => array(), +'midori' => array(), +'minakami' => array(), +'naganohara' => array(), +'nakanojo' => array(), +'nanmoku' => array(), +'numata' => array(), +'oizumi' => array(), +'ora' => array(), +'ota' => array(), +'shibukawa' => array(), +'shimonita' => array(), +'shinto' => array(), +'showa' => array(), +'takasaki' => array(), +'takayama' => array(), +'tamamura' => array(), +'tatebayashi' => array(), +'tomioka' => array(), +'tsukiyono' => array(), +'tsumagoi' => array(), +'ueno' => array(), +'yoshioka' => array()), +'hiroshima' => array('asaminami' => array(), +'daiwa' => array(), +'etajima' => array(), +'fuchu' => array(), +'fukuyama' => array(), +'hatsukaichi' => array(), +'higashihiroshima' => array(), +'hongo' => array(), +'jinsekikogen' => array(), +'kaita' => array(), +'kui' => array(), +'kumano' => array(), +'kure' => array(), +'mihara' => array(), +'miyoshi' => array(), +'naka' => array(), +'onomichi' => array(), +'osakikamijima' => array(), +'otake' => array(), +'saka' => array(), +'sera' => array(), +'seranishi' => array(), +'shinichi' => array(), +'shobara' => array(), +'takehara' => array()), +'hokkaido' => array('abashiri' => array(), +'abira' => array(), +'aibetsu' => array(), +'akabira' => array(), +'akkeshi' => array(), +'asahikawa' => array(), +'ashibetsu' => array(), +'ashoro' => array(), +'assabu' => array(), +'atsuma' => array(), +'bibai' => array(), +'biei' => array(), +'bifuka' => array(), +'bihoro' => array(), +'biratori' => array(), +'chippubetsu' => array(), +'chitose' => array(), +'date' => array(), +'ebetsu' => array(), +'embetsu' => array(), +'eniwa' => array(), +'erimo' => array(), +'esan' => array(), +'esashi' => array(), +'fukagawa' => array(), +'fukushima' => array(), +'furano' => array(), +'furubira' => array(), +'haboro' => array(), +'hakodate' => array(), +'hamatonbetsu' => array(), +'hidaka' => array(), +'higashikagura' => array(), +'higashikawa' => array(), +'hiroo' => array(), +'hokuryu' => array(), +'hokuto' => array(), +'honbetsu' => array(), +'horokanai' => array(), +'horonobe' => array(), +'ikeda' => array(), +'imakane' => array(), +'ishikari' => array(), +'iwamizawa' => array(), +'iwanai' => array(), +'kamifurano' => array(), +'kamikawa' => array(), +'kamishihoro' => array(), +'kamisunagawa' => array(), +'kamoenai' => array(), +'kayabe' => array(), +'kembuchi' => array(), +'kikonai' => array(), +'kimobetsu' => array(), +'kitahiroshima' => array(), +'kitami' => array(), +'kiyosato' => array(), +'koshimizu' => array(), +'kunneppu' => array(), +'kuriyama' => array(), +'kuromatsunai' => array(), +'kushiro' => array(), +'kutchan' => array(), +'kyowa' => array(), +'mashike' => array(), +'matsumae' => array(), +'mikasa' => array(), +'minamifurano' => array(), +'mombetsu' => array(), +'moseushi' => array(), +'mukawa' => array(), +'muroran' => array(), +'naie' => array(), +'nakagawa' => array(), +'nakasatsunai' => array(), +'nakatombetsu' => array(), +'nanae' => array(), +'nanporo' => array(), +'nayoro' => array(), +'nemuro' => array(), +'niikappu' => array(), +'niki' => array(), +'nishiokoppe' => array(), +'noboribetsu' => array(), +'numata' => array(), +'obihiro' => array(), +'obira' => array(), +'oketo' => array(), +'okoppe' => array(), +'otaru' => array(), +'otobe' => array(), +'otofuke' => array(), +'otoineppu' => array(), +'oumu' => array(), +'ozora' => array(), +'pippu' => array(), +'rankoshi' => array(), +'rebun' => array(), +'rikubetsu' => array(), +'rishiri' => array(), +'rishirifuji' => array(), +'saroma' => array(), +'sarufutsu' => array(), +'shakotan' => array(), +'shari' => array(), +'shibecha' => array(), +'shibetsu' => array(), +'shikabe' => array(), +'shikaoi' => array(), +'shimamaki' => array(), +'shimizu' => array(), +'shimokawa' => array(), +'shinshinotsu' => array(), +'shintoku' => array(), +'shiranuka' => array(), +'shiraoi' => array(), +'shiriuchi' => array(), +'sobetsu' => array(), +'sunagawa' => array(), +'taiki' => array(), +'takasu' => array(), +'takikawa' => array(), +'takinoue' => array(), +'teshikaga' => array(), +'tobetsu' => array(), +'tohma' => array(), +'tomakomai' => array(), +'tomari' => array(), +'toya' => array(), +'toyako' => array(), +'toyotomi' => array(), +'toyoura' => array(), +'tsubetsu' => array(), +'tsukigata' => array(), +'urakawa' => array(), +'urausu' => array(), +'uryu' => array(), +'utashinai' => array(), +'wakkanai' => array(), +'wassamu' => array(), +'yakumo' => array(), +'yoichi' => array()), +'hyogo' => array('aioi' => array(), +'akashi' => array(), +'ako' => array(), +'amagasaki' => array(), +'aogaki' => array(), +'asago' => array(), +'ashiya' => array(), +'awaji' => array(), +'fukusaki' => array(), +'goshiki' => array(), +'harima' => array(), +'himeji' => array(), +'ichikawa' => array(), +'inagawa' => array(), +'itami' => array(), +'kakogawa' => array(), +'kamigori' => array(), +'kamikawa' => array(), +'kasai' => array(), +'kasuga' => array(), +'kawanishi' => array(), +'miki' => array(), +'minamiawaji' => array(), +'nishinomiya' => array(), +'nishiwaki' => array(), +'ono' => array(), +'sanda' => array(), +'sannan' => array(), +'sasayama' => array(), +'sayo' => array(), +'shingu' => array(), +'shinonsen' => array(), +'shiso' => array(), +'sumoto' => array(), +'taishi' => array(), +'taka' => array(), +'takarazuka' => array(), +'takasago' => array(), +'takino' => array(), +'tamba' => array(), +'tatsuno' => array(), +'toyooka' => array(), +'yabu' => array(), +'yashiro' => array(), +'yoka' => array(), +'yokawa' => array()), +'ibaraki' => array('ami' => array(), +'asahi' => array(), +'bando' => array(), +'chikusei' => array(), +'daigo' => array(), +'fujishiro' => array(), +'hitachi' => array(), +'hitachinaka' => array(), +'hitachiomiya' => array(), +'hitachiota' => array(), +'ibaraki' => array(), +'ina' => array(), +'inashiki' => array(), +'itako' => array(), +'iwama' => array(), +'joso' => array(), +'kamisu' => array(), +'kasama' => array(), +'kashima' => array(), +'kasumigaura' => array(), +'koga' => array(), +'miho' => array(), +'mito' => array(), +'moriya' => array(), +'naka' => array(), +'namegata' => array(), +'oarai' => array(), +'ogawa' => array(), +'omitama' => array(), +'ryugasaki' => array(), +'sakai' => array(), +'sakuragawa' => array(), +'shimodate' => array(), +'shimotsuma' => array(), +'shirosato' => array(), +'sowa' => array(), +'suifu' => array(), +'takahagi' => array(), +'tamatsukuri' => array(), +'tokai' => array(), +'tomobe' => array(), +'tone' => array(), +'toride' => array(), +'tsuchiura' => array(), +'tsukuba' => array(), +'uchihara' => array(), +'ushiku' => array(), +'yachiyo' => array(), +'yamagata' => array(), +'yawara' => array(), +'yuki' => array()), +'ishikawa' => array('anamizu' => array(), +'hakui' => array(), +'hakusan' => array(), +'kaga' => array(), +'kahoku' => array(), +'kanazawa' => array(), +'kawakita' => array(), +'komatsu' => array(), +'nakanoto' => array(), +'nanao' => array(), +'nomi' => array(), +'nonoichi' => array(), +'noto' => array(), +'shika' => array(), +'suzu' => array(), +'tsubata' => array(), +'tsurugi' => array(), +'uchinada' => array(), +'wajima' => array()), +'iwate' => array('fudai' => array(), +'fujisawa' => array(), +'hanamaki' => array(), +'hiraizumi' => array(), +'hirono' => array(), +'ichinohe' => array(), +'ichinoseki' => array(), +'iwaizumi' => array(), +'iwate' => array(), +'joboji' => array(), +'kamaishi' => array(), +'kanegasaki' => array(), +'karumai' => array(), +'kawai' => array(), +'kitakami' => array(), +'kuji' => array(), +'kunohe' => array(), +'kuzumaki' => array(), +'miyako' => array(), +'mizusawa' => array(), +'morioka' => array(), +'ninohe' => array(), +'noda' => array(), +'ofunato' => array(), +'oshu' => array(), +'otsuchi' => array(), +'rikuzentakata' => array(), +'shiwa' => array(), +'shizukuishi' => array(), +'sumita' => array(), +'tanohata' => array(), +'tono' => array(), +'yahaba' => array(), +'yamada' => array()), +'kagawa' => array('ayagawa' => array(), +'higashikagawa' => array(), +'kanonji' => array(), +'kotohira' => array(), +'manno' => array(), +'marugame' => array(), +'mitoyo' => array(), +'naoshima' => array(), +'sanuki' => array(), +'tadotsu' => array(), +'takamatsu' => array(), +'tonosho' => array(), +'uchinomi' => array(), +'utazu' => array(), +'zentsuji' => array()), +'kagoshima' => array('akune' => array(), +'amami' => array(), +'hioki' => array(), +'isa' => array(), +'isen' => array(), +'izumi' => array(), +'kagoshima' => array(), +'kanoya' => array(), +'kawanabe' => array(), +'kinko' => array(), +'kouyama' => array(), +'makurazaki' => array(), +'matsumoto' => array(), +'minamitane' => array(), +'nakatane' => array(), +'nishinoomote' => array(), +'satsumasendai' => array(), +'soo' => array(), +'tarumizu' => array(), +'yusui' => array()), +'kanagawa' => array('aikawa' => array(), +'atsugi' => array(), +'ayase' => array(), +'chigasaki' => array(), +'ebina' => array(), +'fujisawa' => array(), +'hadano' => array(), +'hakone' => array(), +'hiratsuka' => array(), +'isehara' => array(), +'kaisei' => array(), +'kamakura' => array(), +'kiyokawa' => array(), +'matsuda' => array(), +'minamiashigara' => array(), +'miura' => array(), +'nakai' => array(), +'ninomiya' => array(), +'odawara' => array(), +'oi' => array(), +'oiso' => array(), +'sagamihara' => array(), +'samukawa' => array(), +'tsukui' => array(), +'yamakita' => array(), +'yamato' => array(), +'yokosuka' => array(), +'yugawara' => array(), +'zama' => array(), +'zushi' => array()), +'kochi' => array('aki' => array(), +'geisei' => array(), +'hidaka' => array(), +'higashitsuno' => array(), +'ino' => array(), +'kagami' => array(), +'kami' => array(), +'kitagawa' => array(), +'kochi' => array(), +'mihara' => array(), +'motoyama' => array(), +'muroto' => array(), +'nahari' => array(), +'nakamura' => array(), +'nankoku' => array(), +'nishitosa' => array(), +'niyodogawa' => array(), +'ochi' => array(), +'okawa' => array(), +'otoyo' => array(), +'otsuki' => array(), +'sakawa' => array(), +'sukumo' => array(), +'susaki' => array(), +'tosa' => array(), +'tosashimizu' => array(), +'toyo' => array(), +'tsuno' => array(), +'umaji' => array(), +'yasuda' => array(), +'yusuhara' => array()), +'kumamoto' => array('amakusa' => array(), +'arao' => array(), +'aso' => array(), +'choyo' => array(), +'gyokuto' => array(), +'hitoyoshi' => array(), +'kamiamakusa' => array(), +'kashima' => array(), +'kikuchi' => array(), +'kosa' => array(), +'kumamoto' => array(), +'mashiki' => array(), +'mifune' => array(), +'minamata' => array(), +'minamioguni' => array(), +'nagasu' => array(), +'nishihara' => array(), +'oguni' => array(), +'ozu' => array(), +'sumoto' => array(), +'takamori' => array(), +'uki' => array(), +'uto' => array(), +'yamaga' => array(), +'yamato' => array(), +'yatsushiro' => array()), +'kyoto' => array('ayabe' => array(), +'fukuchiyama' => array(), +'higashiyama' => array(), +'ide' => array(), +'ine' => array(), +'joyo' => array(), +'kameoka' => array(), +'kamo' => array(), +'kita' => array(), +'kizu' => array(), +'kumiyama' => array(), +'kyotamba' => array(), +'kyotanabe' => array(), +'kyotango' => array(), +'maizuru' => array(), +'minami' => array(), +'minamiyamashiro' => array(), +'miyazu' => array(), +'muko' => array(), +'nagaokakyo' => array(), +'nakagyo' => array(), +'nantan' => array(), +'oyamazaki' => array(), +'sakyo' => array(), +'seika' => array(), +'tanabe' => array(), +'uji' => array(), +'ujitawara' => array(), +'wazuka' => array(), +'yamashina' => array(), +'yawata' => array()), +'mie' => array('asahi' => array(), +'inabe' => array(), +'ise' => array(), +'kameyama' => array(), +'kawagoe' => array(), +'kiho' => array(), +'kisosaki' => array(), +'kiwa' => array(), +'komono' => array(), +'kumano' => array(), +'kuwana' => array(), +'matsusaka' => array(), +'meiwa' => array(), +'mihama' => array(), +'minamiise' => array(), +'misugi' => array(), +'miyama' => array(), +'nabari' => array(), +'shima' => array(), +'suzuka' => array(), +'tado' => array(), +'taiki' => array(), +'taki' => array(), +'tamaki' => array(), +'toba' => array(), +'tsu' => array(), +'udono' => array(), +'ureshino' => array(), +'watarai' => array(), +'yokkaichi' => array()), +'miyagi' => array('furukawa' => array(), +'higashimatsushima' => array(), +'ishinomaki' => array(), +'iwanuma' => array(), +'kakuda' => array(), +'kami' => array(), +'kawasaki' => array(), +'kesennuma' => array(), +'marumori' => array(), +'matsushima' => array(), +'minamisanriku' => array(), +'misato' => array(), +'murata' => array(), +'natori' => array(), +'ogawara' => array(), +'ohira' => array(), +'onagawa' => array(), +'osaki' => array(), +'rifu' => array(), +'semine' => array(), +'shibata' => array(), +'shichikashuku' => array(), +'shikama' => array(), +'shiogama' => array(), +'shiroishi' => array(), +'tagajo' => array(), +'taiwa' => array(), +'tome' => array(), +'tomiya' => array(), +'wakuya' => array(), +'watari' => array(), +'yamamoto' => array(), +'zao' => array()), +'miyazaki' => array('aya' => array(), +'ebino' => array(), +'gokase' => array(), +'hyuga' => array(), +'kadogawa' => array(), +'kawaminami' => array(), +'kijo' => array(), +'kitagawa' => array(), +'kitakata' => array(), +'kitaura' => array(), +'kobayashi' => array(), +'kunitomi' => array(), +'kushima' => array(), +'mimata' => array(), +'miyakonojo' => array(), +'miyazaki' => array(), +'morotsuka' => array(), +'nichinan' => array(), +'nishimera' => array(), +'nobeoka' => array(), +'saito' => array(), +'shiiba' => array(), +'shintomi' => array(), +'takaharu' => array(), +'takanabe' => array(), +'takazaki' => array(), +'tsuno' => array()), +'nagano' => array('achi' => array(), +'agematsu' => array(), +'anan' => array(), +'aoki' => array(), +'asahi' => array(), +'azumino' => array(), +'chikuhoku' => array(), +'chikuma' => array(), +'chino' => array(), +'fujimi' => array(), +'hakuba' => array(), +'hara' => array(), +'hiraya' => array(), +'iida' => array(), +'iijima' => array(), +'iiyama' => array(), +'iizuna' => array(), +'ikeda' => array(), +'ikusaka' => array(), +'ina' => array(), +'karuizawa' => array(), +'kawakami' => array(), +'kiso' => array(), +'kisofukushima' => array(), +'kitaaiki' => array(), +'komagane' => array(), +'komoro' => array(), +'matsukawa' => array(), +'matsumoto' => array(), +'miasa' => array(), +'minamiaiki' => array(), +'minamimaki' => array(), +'minamiminowa' => array(), +'minowa' => array(), +'miyada' => array(), +'miyota' => array(), +'mochizuki' => array(), +'nagano' => array(), +'nagawa' => array(), +'nagiso' => array(), +'nakagawa' => array(), +'nakano' => array(), +'nozawaonsen' => array(), +'obuse' => array(), +'ogawa' => array(), +'okaya' => array(), +'omachi' => array(), +'omi' => array(), +'ookuwa' => array(), +'ooshika' => array(), +'otaki' => array(), +'otari' => array(), +'sakae' => array(), +'sakaki' => array(), +'saku' => array(), +'sakuho' => array(), +'shimosuwa' => array(), +'shinanomachi' => array(), +'shiojiri' => array(), +'suwa' => array(), +'suzaka' => array(), +'takagi' => array(), +'takamori' => array(), +'takayama' => array(), +'tateshina' => array(), +'tatsuno' => array(), +'togakushi' => array(), +'togura' => array(), +'tomi' => array(), +'ueda' => array(), +'wada' => array(), +'yamagata' => array(), +'yamanouchi' => array(), +'yasaka' => array(), +'yasuoka' => array()), +'nagasaki' => array('chijiwa' => array(), +'futsu' => array(), +'goto' => array(), +'hasami' => array(), +'hirado' => array(), +'iki' => array(), +'isahaya' => array(), +'kawatana' => array(), +'kuchinotsu' => array(), +'matsuura' => array(), +'nagasaki' => array(), +'obama' => array(), +'omura' => array(), +'oseto' => array(), +'saikai' => array(), +'sasebo' => array(), +'seihi' => array(), +'shimabara' => array(), +'shinkamigoto' => array(), +'togitsu' => array(), +'tsushima' => array(), +'unzen' => array()), +'nara' => array('ando' => array(), +'gose' => array(), +'heguri' => array(), +'higashiyoshino' => array(), +'ikaruga' => array(), +'ikoma' => array(), +'kamikitayama' => array(), +'kanmaki' => array(), +'kashiba' => array(), +'kashihara' => array(), +'katsuragi' => array(), +'kawai' => array(), +'kawakami' => array(), +'kawanishi' => array(), +'koryo' => array(), +'kurotaki' => array(), +'mitsue' => array(), +'miyake' => array(), +'nara' => array(), +'nosegawa' => array(), +'oji' => array(), +'ouda' => array(), +'oyodo' => array(), +'sakurai' => array(), +'sango' => array(), +'shimoichi' => array(), +'shimokitayama' => array(), +'shinjo' => array(), +'soni' => array(), +'takatori' => array(), +'tawaramoto' => array(), +'tenkawa' => array(), +'tenri' => array(), +'uda' => array(), +'yamatokoriyama' => array(), +'yamatotakada' => array(), +'yamazoe' => array(), +'yoshino' => array()), +'niigata' => array('aga' => array(), +'agano' => array(), +'gosen' => array(), +'itoigawa' => array(), +'izumozaki' => array(), +'joetsu' => array(), +'kamo' => array(), +'kariwa' => array(), +'kashiwazaki' => array(), +'minamiuonuma' => array(), +'mitsuke' => array(), +'muika' => array(), +'murakami' => array(), +'myoko' => array(), +'nagaoka' => array(), +'niigata' => array(), +'ojiya' => array(), +'omi' => array(), +'sado' => array(), +'sanjo' => array(), +'seiro' => array(), +'seirou' => array(), +'sekikawa' => array(), +'shibata' => array(), +'tagami' => array(), +'tainai' => array(), +'tochio' => array(), +'tokamachi' => array(), +'tsubame' => array(), +'tsunan' => array(), +'uonuma' => array(), +'yahiko' => array(), +'yoita' => array(), +'yuzawa' => array()), +'oita' => array('beppu' => array(), +'bungoono' => array(), +'bungotakada' => array(), +'hasama' => array(), +'hiji' => array(), +'himeshima' => array(), +'hita' => array(), +'kamitsue' => array(), +'kokonoe' => array(), +'kuju' => array(), +'kunisaki' => array(), +'kusu' => array(), +'oita' => array(), +'saiki' => array(), +'taketa' => array(), +'tsukumi' => array(), +'usa' => array(), +'usuki' => array(), +'yufu' => array()), +'okayama' => array('akaiwa' => array(), +'asakuchi' => array(), +'bizen' => array(), +'hayashima' => array(), +'ibara' => array(), +'kagamino' => array(), +'kasaoka' => array(), +'kibichuo' => array(), +'kumenan' => array(), +'kurashiki' => array(), +'maniwa' => array(), +'misaki' => array(), +'nagi' => array(), +'niimi' => array(), +'nishiawakura' => array(), +'okayama' => array(), +'satosho' => array(), +'setouchi' => array(), +'shinjo' => array(), +'shoo' => array(), +'soja' => array(), +'takahashi' => array(), +'tamano' => array(), +'tsuyama' => array(), +'wake' => array(), +'yakage' => array()), +'okinawa' => array('aguni' => array(), +'ginowan' => array(), +'ginoza' => array(), +'gushikami' => array(), +'haebaru' => array(), +'higashi' => array(), +'hirara' => array(), +'iheya' => array(), +'ishigaki' => array(), +'ishikawa' => array(), +'itoman' => array(), +'izena' => array(), +'kadena' => array(), +'kin' => array(), +'kitadaito' => array(), +'kitanakagusuku' => array(), +'kumejima' => array(), +'kunigami' => array(), +'minamidaito' => array(), +'motobu' => array(), +'nago' => array(), +'naha' => array(), +'nakagusuku' => array(), +'nakijin' => array(), +'nanjo' => array(), +'nishihara' => array(), +'ogimi' => array(), +'okinawa' => array(), +'onna' => array(), +'shimoji' => array(), +'taketomi' => array(), +'tarama' => array(), +'tokashiki' => array(), +'tomigusuku' => array(), +'tonaki' => array(), +'urasoe' => array(), +'uruma' => array(), +'yaese' => array(), +'yomitan' => array(), +'yonabaru' => array(), +'yonaguni' => array(), +'zamami' => array()), +'osaka' => array('abeno' => array(), +'chihayaakasaka' => array(), +'chuo' => array(), +'daito' => array(), +'fujiidera' => array(), +'habikino' => array(), +'hannan' => array(), +'higashiosaka' => array(), +'higashisumiyoshi' => array(), +'higashiyodogawa' => array(), +'hirakata' => array(), +'ibaraki' => array(), +'ikeda' => array(), +'izumi' => array(), +'izumiotsu' => array(), +'izumisano' => array(), +'kadoma' => array(), +'kaizuka' => array(), +'kanan' => array(), +'kashiwara' => array(), +'katano' => array(), +'kawachinagano' => array(), +'kishiwada' => array(), +'kita' => array(), +'kumatori' => array(), +'matsubara' => array(), +'minato' => array(), +'minoh' => array(), +'misaki' => array(), +'moriguchi' => array(), +'neyagawa' => array(), +'nishi' => array(), +'nose' => array(), +'osakasayama' => array(), +'sakai' => array(), +'sayama' => array(), +'sennan' => array(), +'settsu' => array(), +'shijonawate' => array(), +'shimamoto' => array(), +'suita' => array(), +'tadaoka' => array(), +'taishi' => array(), +'tajiri' => array(), +'takaishi' => array(), +'takatsuki' => array(), +'tondabayashi' => array(), +'toyonaka' => array(), +'toyono' => array(), +'yao' => array()), +'saga' => array('ariake' => array(), +'arita' => array(), +'fukudomi' => array(), +'genkai' => array(), +'hamatama' => array(), +'hizen' => array(), +'imari' => array(), +'kamimine' => array(), +'kanzaki' => array(), +'karatsu' => array(), +'kashima' => array(), +'kitagata' => array(), +'kitahata' => array(), +'kiyama' => array(), +'kouhoku' => array(), +'kyuragi' => array(), +'nishiarita' => array(), +'ogi' => array(), +'omachi' => array(), +'ouchi' => array(), +'saga' => array(), +'shiroishi' => array(), +'taku' => array(), +'tara' => array(), +'tosu' => array(), +'yoshinogari' => array()), +'saitama' => array('arakawa' => array(), +'asaka' => array(), +'chichibu' => array(), +'fujimi' => array(), +'fujimino' => array(), +'fukaya' => array(), +'hanno' => array(), +'hanyu' => array(), +'hasuda' => array(), +'hatogaya' => array(), +'hatoyama' => array(), +'hidaka' => array(), +'higashichichibu' => array(), +'higashimatsuyama' => array(), +'honjo' => array(), +'ina' => array(), +'iruma' => array(), +'iwatsuki' => array(), +'kamiizumi' => array(), +'kamikawa' => array(), +'kamisato' => array(), +'kasukabe' => array(), +'kawagoe' => array(), +'kawaguchi' => array(), +'kawajima' => array(), +'kazo' => array(), +'kitamoto' => array(), +'koshigaya' => array(), +'kounosu' => array(), +'kuki' => array(), +'kumagaya' => array(), +'matsubushi' => array(), +'minano' => array(), +'misato' => array(), +'miyashiro' => array(), +'miyoshi' => array(), +'moroyama' => array(), +'nagatoro' => array(), +'namegawa' => array(), +'niiza' => array(), +'ogano' => array(), +'ogawa' => array(), +'ogose' => array(), +'okegawa' => array(), +'omiya' => array(), +'otaki' => array(), +'ranzan' => array(), +'ryokami' => array(), +'saitama' => array(), +'sakado' => array(), +'satte' => array(), +'sayama' => array(), +'shiki' => array(), +'shiraoka' => array(), +'soka' => array(), +'sugito' => array(), +'toda' => array(), +'tokigawa' => array(), +'tokorozawa' => array(), +'tsurugashima' => array(), +'urawa' => array(), +'warabi' => array(), +'yashio' => array(), +'yokoze' => array(), +'yono' => array(), +'yorii' => array(), +'yoshida' => array(), +'yoshikawa' => array(), +'yoshimi' => array()), +'shiga' => array('aisho' => array(), +'gamo' => array(), +'higashiomi' => array(), +'hikone' => array(), +'koka' => array(), +'konan' => array(), +'kosei' => array(), +'koto' => array(), +'kusatsu' => array(), +'maibara' => array(), +'moriyama' => array(), +'nagahama' => array(), +'nishiazai' => array(), +'notogawa' => array(), +'omihachiman' => array(), +'otsu' => array(), +'ritto' => array(), +'ryuoh' => array(), +'takashima' => array(), +'takatsuki' => array(), +'torahime' => array(), +'toyosato' => array(), +'yasu' => array()), +'shimane' => array('akagi' => array(), +'ama' => array(), +'gotsu' => array(), +'hamada' => array(), +'higashiizumo' => array(), +'hikawa' => array(), +'hikimi' => array(), +'izumo' => array(), +'kakinoki' => array(), +'masuda' => array(), +'matsue' => array(), +'misato' => array(), +'nishinoshima' => array(), +'ohda' => array(), +'okinoshima' => array(), +'okuizumo' => array(), +'shimane' => array(), +'tamayu' => array(), +'tsuwano' => array(), +'unnan' => array(), +'yakumo' => array(), +'yasugi' => array(), +'yatsuka' => array()), +'shizuoka' => array('arai' => array(), +'atami' => array(), +'fuji' => array(), +'fujieda' => array(), +'fujikawa' => array(), +'fujinomiya' => array(), +'fukuroi' => array(), +'gotemba' => array(), +'haibara' => array(), +'hamamatsu' => array(), +'higashiizu' => array(), +'ito' => array(), +'iwata' => array(), +'izu' => array(), +'izunokuni' => array(), +'kakegawa' => array(), +'kannami' => array(), +'kawanehon' => array(), +'kawazu' => array(), +'kikugawa' => array(), +'kosai' => array(), +'makinohara' => array(), +'matsuzaki' => array(), +'minamiizu' => array(), +'mishima' => array(), +'morimachi' => array(), +'nishiizu' => array(), +'numazu' => array(), +'omaezaki' => array(), +'shimada' => array(), +'shimizu' => array(), +'shimoda' => array(), +'shizuoka' => array(), +'susono' => array(), +'yaizu' => array(), +'yoshida' => array()), +'tochigi' => array('ashikaga' => array(), +'bato' => array(), +'haga' => array(), +'ichikai' => array(), +'iwafune' => array(), +'kaminokawa' => array(), +'kanuma' => array(), +'karasuyama' => array(), +'kuroiso' => array(), +'mashiko' => array(), +'mibu' => array(), +'moka' => array(), +'motegi' => array(), +'nasu' => array(), +'nasushiobara' => array(), +'nikko' => array(), +'nishikata' => array(), +'nogi' => array(), +'ohira' => array(), +'ohtawara' => array(), +'oyama' => array(), +'sakura' => array(), +'sano' => array(), +'shimotsuke' => array(), +'shioya' => array(), +'takanezawa' => array(), +'tochigi' => array(), +'tsuga' => array(), +'ujiie' => array(), +'utsunomiya' => array(), +'yaita' => array()), +'tokushima' => array('aizumi' => array(), +'anan' => array(), +'ichiba' => array(), +'itano' => array(), +'kainan' => array(), +'komatsushima' => array(), +'matsushige' => array(), +'mima' => array(), +'minami' => array(), +'miyoshi' => array(), +'mugi' => array(), +'nakagawa' => array(), +'naruto' => array(), +'sanagochi' => array(), +'shishikui' => array(), +'tokushima' => array(), +'wajiki' => array()), +'tokyo' => array('adachi' => array(), +'akiruno' => array(), +'akishima' => array(), +'aogashima' => array(), +'arakawa' => array(), +'bunkyo' => array(), +'chiyoda' => array(), +'chofu' => array(), +'chuo' => array(), +'edogawa' => array(), +'fuchu' => array(), +'fussa' => array(), +'hachijo' => array(), +'hachioji' => array(), +'hamura' => array(), +'higashikurume' => array(), +'higashimurayama' => array(), +'higashiyamato' => array(), +'hino' => array(), +'hinode' => array(), +'hinohara' => array(), +'inagi' => array(), +'itabashi' => array(), +'katsushika' => array(), +'kita' => array(), +'kiyose' => array(), +'kodaira' => array(), +'koganei' => array(), +'kokubunji' => array(), +'komae' => array(), +'koto' => array(), +'kouzushima' => array(), +'kunitachi' => array(), +'machida' => array(), +'meguro' => array(), +'minato' => array(), +'mitaka' => array(), +'mizuho' => array(), +'musashimurayama' => array(), +'musashino' => array(), +'nakano' => array(), +'nerima' => array(), +'ogasawara' => array(), +'okutama' => array(), +'ome' => array(), +'oshima' => array(), +'ota' => array(), +'setagaya' => array(), +'shibuya' => array(), +'shinagawa' => array(), +'shinjuku' => array(), +'suginami' => array(), +'sumida' => array(), +'tachikawa' => array(), +'taito' => array(), +'tama' => array(), +'toshima' => array()), +'tottori' => array('chizu' => array(), +'hino' => array(), +'kawahara' => array(), +'koge' => array(), +'kotoura' => array(), +'misasa' => array(), +'nanbu' => array(), +'nichinan' => array(), +'sakaiminato' => array(), +'tottori' => array(), +'wakasa' => array(), +'yazu' => array(), +'yonago' => array()), +'toyama' => array('asahi' => array(), +'fuchu' => array(), +'fukumitsu' => array(), +'funahashi' => array(), +'himi' => array(), +'imizu' => array(), +'inami' => array(), +'johana' => array(), +'kamiichi' => array(), +'kurobe' => array(), +'nakaniikawa' => array(), +'namerikawa' => array(), +'nanto' => array(), +'nyuzen' => array(), +'oyabe' => array(), +'taira' => array(), +'takaoka' => array(), +'tateyama' => array(), +'toga' => array(), +'tonami' => array(), +'toyama' => array(), +'unazuki' => array(), +'uozu' => array(), +'yamada' => array()), +'wakayama' => array('arida' => array(), +'aridagawa' => array(), +'gobo' => array(), +'hashimoto' => array(), +'hidaka' => array(), +'hirogawa' => array(), +'inami' => array(), +'iwade' => array(), +'kainan' => array(), +'kamitonda' => array(), +'katsuragi' => array(), +'kimino' => array(), +'kinokawa' => array(), +'kitayama' => array(), +'koya' => array(), +'koza' => array(), +'kozagawa' => array(), +'kudoyama' => array(), +'kushimoto' => array(), +'mihama' => array(), +'misato' => array(), +'nachikatsuura' => array(), +'shingu' => array(), +'shirahama' => array(), +'taiji' => array(), +'tanabe' => array(), +'wakayama' => array(), +'yuasa' => array(), +'yura' => array()), +'yamagata' => array('asahi' => array(), +'funagata' => array(), +'higashine' => array(), +'iide' => array(), +'kahoku' => array(), +'kaminoyama' => array(), +'kaneyama' => array(), +'kawanishi' => array(), +'mamurogawa' => array(), +'mikawa' => array(), +'murayama' => array(), +'nagai' => array(), +'nakayama' => array(), +'nanyo' => array(), +'nishikawa' => array(), +'obanazawa' => array(), +'oe' => array(), +'oguni' => array(), +'ohkura' => array(), +'oishida' => array(), +'sagae' => array(), +'sakata' => array(), +'sakegawa' => array(), +'shinjo' => array(), +'shirataka' => array(), +'shonai' => array(), +'takahata' => array(), +'tendo' => array(), +'tozawa' => array(), +'tsuruoka' => array(), +'yamagata' => array(), +'yamanobe' => array(), +'yonezawa' => array(), +'yuza' => array()), +'yamaguchi' => array('abu' => array(), +'hagi' => array(), +'hikari' => array(), +'hofu' => array(), +'iwakuni' => array(), +'kudamatsu' => array(), +'mitou' => array(), +'nagato' => array(), +'oshima' => array(), +'shimonoseki' => array(), +'shunan' => array(), +'tabuse' => array(), +'tokuyama' => array(), +'toyota' => array(), +'ube' => array(), +'yuu' => array()), +'yamanashi' => array('chuo' => array(), +'doshi' => array(), +'fuefuki' => array(), +'fujikawa' => array(), +'fujikawaguchiko' => array(), +'fujiyoshida' => array(), +'hayakawa' => array(), +'hokuto' => array(), +'ichikawamisato' => array(), +'kai' => array(), +'kofu' => array(), +'koshu' => array(), +'kosuge' => array(), +'minami-alps' => array(), +'minobu' => array(), +'nakamichi' => array(), +'nanbu' => array(), +'narusawa' => array(), +'nirasaki' => array(), +'nishikatsura' => array(), +'oshino' => array(), +'otsuki' => array(), +'showa' => array(), +'tabayama' => array(), +'tsuru' => array(), +'uenohara' => array(), +'yamanakako' => array(), +'yamanashi' => array()), +'kawasaki' => array('*' => array(), +'city' => array('!' => '')), +'kitakyushu' => array('*' => array(), +'city' => array('!' => '')), +'kobe' => array('*' => array(), +'city' => array('!' => '')), +'nagoya' => array('*' => array(), +'city' => array('!' => '')), +'sapporo' => array('*' => array(), +'city' => array('!' => '')), +'sendai' => array('*' => array(), +'city' => array('!' => '')), +'yokohama' => array('*' => array(), +'city' => array('!' => '')), +'blogspot' => array()), +'ke' => array('*' => array()), +'kg' => array('org' => array(), +'net' => array(), +'com' => array(), +'edu' => array(), +'gov' => array(), +'mil' => array()), +'kh' => array('*' => array()), +'ki' => array('edu' => array(), +'biz' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'info' => array(), +'com' => array()), +'km' => array('org' => array(), +'nom' => array(), +'gov' => array(), +'prd' => array(), +'tm' => array(), +'edu' => array(), +'mil' => array(), +'ass' => array(), +'com' => array(), +'coop' => array(), +'asso' => array(), +'presse' => array(), +'medecin' => array(), +'notaires' => array(), +'pharmaciens' => array(), +'veterinaire' => array(), +'gouv' => array()), +'kn' => array('net' => array(), +'org' => array(), +'edu' => array(), +'gov' => array()), +'kp' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'org' => array(), +'rep' => array(), +'tra' => array()), +'kr' => array('ac' => array(), +'co' => array(), +'es' => array(), +'go' => array(), +'hs' => array(), +'kg' => array(), +'mil' => array(), +'ms' => array(), +'ne' => array(), +'or' => array(), +'pe' => array(), +'re' => array(), +'sc' => array(), +'busan' => array(), +'chungbuk' => array(), +'chungnam' => array(), +'daegu' => array(), +'daejeon' => array(), +'gangwon' => array(), +'gwangju' => array(), +'gyeongbuk' => array(), +'gyeonggi' => array(), +'gyeongnam' => array(), +'incheon' => array(), +'jeju' => array(), +'jeonbuk' => array(), +'jeonnam' => array(), +'seoul' => array(), +'ulsan' => array(), +'blogspot' => array()), +'kw' => array('*' => array()), +'ky' => array('edu' => array(), +'gov' => array(), +'com' => array(), +'org' => array(), +'net' => array()), +'kz' => array('org' => array(), +'edu' => array(), +'net' => array(), +'gov' => array(), +'mil' => array(), +'com' => array()), +'la' => array('int' => array(), +'net' => array(), +'info' => array(), +'edu' => array(), +'gov' => array(), +'per' => array(), +'com' => array(), +'org' => array(), +'c' => array()), +'lb' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'net' => array(), +'org' => array()), +'lc' => array('com' => array(), +'net' => array(), +'co' => array(), +'org' => array(), +'edu' => array(), +'gov' => array()), +'li' => array(), +'lk' => array('gov' => array(), +'sch' => array(), +'net' => array(), +'int' => array(), +'com' => array(), +'org' => array(), +'edu' => array(), +'ngo' => array(), +'soc' => array(), +'web' => array(), +'ltd' => array(), +'assn' => array(), +'grp' => array(), +'hotel' => array()), +'lr' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'org' => array(), +'net' => array()), +'ls' => array('co' => array(), +'org' => array()), +'lt' => array('gov' => array()), +'lu' => array(), +'lv' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'org' => array(), +'mil' => array(), +'id' => array(), +'net' => array(), +'asn' => array(), +'conf' => array()), +'ly' => array('com' => array(), +'net' => array(), +'gov' => array(), +'plc' => array(), +'edu' => array(), +'sch' => array(), +'med' => array(), +'org' => array(), +'id' => array()), +'ma' => array('co' => array(), +'net' => array(), +'gov' => array(), +'org' => array(), +'ac' => array(), +'press' => array()), +'mc' => array('tm' => array(), +'asso' => array()), +'md' => array(), +'me' => array('co' => array(), +'net' => array(), +'org' => array(), +'edu' => array(), +'ac' => array(), +'gov' => array(), +'its' => array(), +'priv' => array()), +'mg' => array('org' => array(), +'nom' => array(), +'gov' => array(), +'prd' => array(), +'tm' => array(), +'edu' => array(), +'mil' => array(), +'com' => array()), +'mh' => array(), +'mil' => array(), +'mk' => array('com' => array(), +'org' => array(), +'net' => array(), +'edu' => array(), +'gov' => array(), +'inf' => array(), +'name' => array()), +'ml' => array('com' => array(), +'edu' => array(), +'gouv' => array(), +'gov' => array(), +'net' => array(), +'org' => array(), +'presse' => array()), +'mm' => array('*' => array()), +'mn' => array('gov' => array(), +'edu' => array(), +'org' => array(), +'nyc' => array()), +'mo' => array('com' => array(), +'net' => array(), +'org' => array(), +'edu' => array(), +'gov' => array()), +'mobi' => array(), +'mp' => array(), +'mq' => array(), +'mr' => array('gov' => array(), +'blogspot' => array()), +'ms' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'net' => array(), +'org' => array()), +'mt' => array('com' => array(), +'edu' => array(), +'net' => array(), +'org' => array()), +'mu' => array('com' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'ac' => array(), +'co' => array(), +'or' => array()), +'museum' => array('academy' => array(), +'agriculture' => array(), +'air' => array(), +'airguard' => array(), +'alabama' => array(), +'alaska' => array(), +'amber' => array(), +'ambulance' => array(), +'american' => array(), +'americana' => array(), +'americanantiques' => array(), +'americanart' => array(), +'amsterdam' => array(), +'and' => array(), +'annefrank' => array(), +'anthro' => array(), +'anthropology' => array(), +'antiques' => array(), +'aquarium' => array(), +'arboretum' => array(), +'archaeological' => array(), +'archaeology' => array(), +'architecture' => array(), +'art' => array(), +'artanddesign' => array(), +'artcenter' => array(), +'artdeco' => array(), +'arteducation' => array(), +'artgallery' => array(), +'arts' => array(), +'artsandcrafts' => array(), +'asmatart' => array(), +'assassination' => array(), +'assisi' => array(), +'association' => array(), +'astronomy' => array(), +'atlanta' => array(), +'austin' => array(), +'australia' => array(), +'automotive' => array(), +'aviation' => array(), +'axis' => array(), +'badajoz' => array(), +'baghdad' => array(), +'bahn' => array(), +'bale' => array(), +'baltimore' => array(), +'barcelona' => array(), +'baseball' => array(), +'basel' => array(), +'baths' => array(), +'bauern' => array(), +'beauxarts' => array(), +'beeldengeluid' => array(), +'bellevue' => array(), +'bergbau' => array(), +'berkeley' => array(), +'berlin' => array(), +'bern' => array(), +'bible' => array(), +'bilbao' => array(), +'bill' => array(), +'birdart' => array(), +'birthplace' => array(), +'bonn' => array(), +'boston' => array(), +'botanical' => array(), +'botanicalgarden' => array(), +'botanicgarden' => array(), +'botany' => array(), +'brandywinevalley' => array(), +'brasil' => array(), +'bristol' => array(), +'british' => array(), +'britishcolumbia' => array(), +'broadcast' => array(), +'brunel' => array(), +'brussel' => array(), +'brussels' => array(), +'bruxelles' => array(), +'building' => array(), +'burghof' => array(), +'bus' => array(), +'bushey' => array(), +'cadaques' => array(), +'california' => array(), +'cambridge' => array(), +'can' => array(), +'canada' => array(), +'capebreton' => array(), +'carrier' => array(), +'cartoonart' => array(), +'casadelamoneda' => array(), +'castle' => array(), +'castres' => array(), +'celtic' => array(), +'center' => array(), +'chattanooga' => array(), +'cheltenham' => array(), +'chesapeakebay' => array(), +'chicago' => array(), +'children' => array(), +'childrens' => array(), +'childrensgarden' => array(), +'chiropractic' => array(), +'chocolate' => array(), +'christiansburg' => array(), +'cincinnati' => array(), +'cinema' => array(), +'circus' => array(), +'civilisation' => array(), +'civilization' => array(), +'civilwar' => array(), +'clinton' => array(), +'clock' => array(), +'coal' => array(), +'coastaldefence' => array(), +'cody' => array(), +'coldwar' => array(), +'collection' => array(), +'colonialwilliamsburg' => array(), +'coloradoplateau' => array(), +'columbia' => array(), +'columbus' => array(), +'communication' => array(), +'communications' => array(), +'community' => array(), +'computer' => array(), +'computerhistory' => array(), +'comunicações' => array(), +'contemporary' => array(), +'contemporaryart' => array(), +'convent' => array(), +'copenhagen' => array(), +'corporation' => array(), +'correios-e-telecomunicações' => array(), +'corvette' => array(), +'costume' => array(), +'countryestate' => array(), +'county' => array(), +'crafts' => array(), +'cranbrook' => array(), +'creation' => array(), +'cultural' => array(), +'culturalcenter' => array(), +'culture' => array(), +'cyber' => array(), +'cymru' => array(), +'dali' => array(), +'dallas' => array(), +'database' => array(), +'ddr' => array(), +'decorativearts' => array(), +'delaware' => array(), +'delmenhorst' => array(), +'denmark' => array(), +'depot' => array(), +'design' => array(), +'detroit' => array(), +'dinosaur' => array(), +'discovery' => array(), +'dolls' => array(), +'donostia' => array(), +'durham' => array(), +'eastafrica' => array(), +'eastcoast' => array(), +'education' => array(), +'educational' => array(), +'egyptian' => array(), +'eisenbahn' => array(), +'elburg' => array(), +'elvendrell' => array(), +'embroidery' => array(), +'encyclopedic' => array(), +'england' => array(), +'entomology' => array(), +'environment' => array(), +'environmentalconservation' => array(), +'epilepsy' => array(), +'essex' => array(), +'estate' => array(), +'ethnology' => array(), +'exeter' => array(), +'exhibition' => array(), +'family' => array(), +'farm' => array(), +'farmequipment' => array(), +'farmers' => array(), +'farmstead' => array(), +'field' => array(), +'figueres' => array(), +'filatelia' => array(), +'film' => array(), +'fineart' => array(), +'finearts' => array(), +'finland' => array(), +'flanders' => array(), +'florida' => array(), +'force' => array(), +'fortmissoula' => array(), +'fortworth' => array(), +'foundation' => array(), +'francaise' => array(), +'frankfurt' => array(), +'franziskaner' => array(), +'freemasonry' => array(), +'freiburg' => array(), +'fribourg' => array(), +'frog' => array(), +'fundacio' => array(), +'furniture' => array(), +'gallery' => array(), +'garden' => array(), +'gateway' => array(), +'geelvinck' => array(), +'gemological' => array(), +'geology' => array(), +'georgia' => array(), +'giessen' => array(), +'glas' => array(), +'glass' => array(), +'gorge' => array(), +'grandrapids' => array(), +'graz' => array(), +'guernsey' => array(), +'halloffame' => array(), +'hamburg' => array(), +'handson' => array(), +'harvestcelebration' => array(), +'hawaii' => array(), +'health' => array(), +'heimatunduhren' => array(), +'hellas' => array(), +'helsinki' => array(), +'hembygdsforbund' => array(), +'heritage' => array(), +'histoire' => array(), +'historical' => array(), +'historicalsociety' => array(), +'historichouses' => array(), +'historisch' => array(), +'historisches' => array(), +'history' => array(), +'historyofscience' => array(), +'horology' => array(), +'house' => array(), +'humanities' => array(), +'illustration' => array(), +'imageandsound' => array(), +'indian' => array(), +'indiana' => array(), +'indianapolis' => array(), +'indianmarket' => array(), +'intelligence' => array(), +'interactive' => array(), +'iraq' => array(), +'iron' => array(), +'isleofman' => array(), +'jamison' => array(), +'jefferson' => array(), +'jerusalem' => array(), +'jewelry' => array(), +'jewish' => array(), +'jewishart' => array(), +'jfk' => array(), +'journalism' => array(), +'judaica' => array(), +'judygarland' => array(), +'juedisches' => array(), +'juif' => array(), +'karate' => array(), +'karikatur' => array(), +'kids' => array(), +'koebenhavn' => array(), +'koeln' => array(), +'kunst' => array(), +'kunstsammlung' => array(), +'kunstunddesign' => array(), +'labor' => array(), +'labour' => array(), +'lajolla' => array(), +'lancashire' => array(), +'landes' => array(), +'lans' => array(), +'läns' => array(), +'larsson' => array(), +'lewismiller' => array(), +'lincoln' => array(), +'linz' => array(), +'living' => array(), +'livinghistory' => array(), +'localhistory' => array(), +'london' => array(), +'losangeles' => array(), +'louvre' => array(), +'loyalist' => array(), +'lucerne' => array(), +'luxembourg' => array(), +'luzern' => array(), +'mad' => array(), +'madrid' => array(), +'mallorca' => array(), +'manchester' => array(), +'mansion' => array(), +'mansions' => array(), +'manx' => array(), +'marburg' => array(), +'maritime' => array(), +'maritimo' => array(), +'maryland' => array(), +'marylhurst' => array(), +'media' => array(), +'medical' => array(), +'medizinhistorisches' => array(), +'meeres' => array(), +'memorial' => array(), +'mesaverde' => array(), +'michigan' => array(), +'midatlantic' => array(), +'military' => array(), +'mill' => array(), +'miners' => array(), +'mining' => array(), +'minnesota' => array(), +'missile' => array(), +'missoula' => array(), +'modern' => array(), +'moma' => array(), +'money' => array(), +'monmouth' => array(), +'monticello' => array(), +'montreal' => array(), +'moscow' => array(), +'motorcycle' => array(), +'muenchen' => array(), +'muenster' => array(), +'mulhouse' => array(), +'muncie' => array(), +'museet' => array(), +'museumcenter' => array(), +'museumvereniging' => array(), +'music' => array(), +'national' => array(), +'nationalfirearms' => array(), +'nationalheritage' => array(), +'nativeamerican' => array(), +'naturalhistory' => array(), +'naturalhistorymuseum' => array(), +'naturalsciences' => array(), +'nature' => array(), +'naturhistorisches' => array(), +'natuurwetenschappen' => array(), +'naumburg' => array(), +'naval' => array(), +'nebraska' => array(), +'neues' => array(), +'newhampshire' => array(), +'newjersey' => array(), +'newmexico' => array(), +'newport' => array(), +'newspaper' => array(), +'newyork' => array(), +'niepce' => array(), +'norfolk' => array(), +'north' => array(), +'nrw' => array(), +'nuernberg' => array(), +'nuremberg' => array(), +'nyc' => array(), +'nyny' => array(), +'oceanographic' => array(), +'oceanographique' => array(), +'omaha' => array(), +'online' => array(), +'ontario' => array(), +'openair' => array(), +'oregon' => array(), +'oregontrail' => array(), +'otago' => array(), +'oxford' => array(), +'pacific' => array(), +'paderborn' => array(), +'palace' => array(), +'paleo' => array(), +'palmsprings' => array(), +'panama' => array(), +'paris' => array(), +'pasadena' => array(), +'pharmacy' => array(), +'philadelphia' => array(), +'philadelphiaarea' => array(), +'philately' => array(), +'phoenix' => array(), +'photography' => array(), +'pilots' => array(), +'pittsburgh' => array(), +'planetarium' => array(), +'plantation' => array(), +'plants' => array(), +'plaza' => array(), +'portal' => array(), +'portland' => array(), +'portlligat' => array(), +'posts-and-telecommunications' => array(), +'preservation' => array(), +'presidio' => array(), +'press' => array(), +'project' => array(), +'public' => array(), +'pubol' => array(), +'quebec' => array(), +'railroad' => array(), +'railway' => array(), +'research' => array(), +'resistance' => array(), +'riodejaneiro' => array(), +'rochester' => array(), +'rockart' => array(), +'roma' => array(), +'russia' => array(), +'saintlouis' => array(), +'salem' => array(), +'salvadordali' => array(), +'salzburg' => array(), +'sandiego' => array(), +'sanfrancisco' => array(), +'santabarbara' => array(), +'santacruz' => array(), +'santafe' => array(), +'saskatchewan' => array(), +'satx' => array(), +'savannahga' => array(), +'schlesisches' => array(), +'schoenbrunn' => array(), +'schokoladen' => array(), +'school' => array(), +'schweiz' => array(), +'science' => array(), +'scienceandhistory' => array(), +'scienceandindustry' => array(), +'sciencecenter' => array(), +'sciencecenters' => array(), +'science-fiction' => array(), +'sciencehistory' => array(), +'sciences' => array(), +'sciencesnaturelles' => array(), +'scotland' => array(), +'seaport' => array(), +'settlement' => array(), +'settlers' => array(), +'shell' => array(), +'sherbrooke' => array(), +'sibenik' => array(), +'silk' => array(), +'ski' => array(), +'skole' => array(), +'society' => array(), +'sologne' => array(), +'soundandvision' => array(), +'southcarolina' => array(), +'southwest' => array(), +'space' => array(), +'spy' => array(), +'square' => array(), +'stadt' => array(), +'stalbans' => array(), +'starnberg' => array(), +'state' => array(), +'stateofdelaware' => array(), +'station' => array(), +'steam' => array(), +'steiermark' => array(), +'stjohn' => array(), +'stockholm' => array(), +'stpetersburg' => array(), +'stuttgart' => array(), +'suisse' => array(), +'surgeonshall' => array(), +'surrey' => array(), +'svizzera' => array(), +'sweden' => array(), +'sydney' => array(), +'tank' => array(), +'tcm' => array(), +'technology' => array(), +'telekommunikation' => array(), +'television' => array(), +'texas' => array(), +'textile' => array(), +'theater' => array(), +'time' => array(), +'timekeeping' => array(), +'topology' => array(), +'torino' => array(), +'touch' => array(), +'town' => array(), +'transport' => array(), +'tree' => array(), +'trolley' => array(), +'trust' => array(), +'trustee' => array(), +'uhren' => array(), +'ulm' => array(), +'undersea' => array(), +'university' => array(), +'usa' => array(), +'usantiques' => array(), +'usarts' => array(), +'uscountryestate' => array(), +'usculture' => array(), +'usdecorativearts' => array(), +'usgarden' => array(), +'ushistory' => array(), +'ushuaia' => array(), +'uslivinghistory' => array(), +'utah' => array(), +'uvic' => array(), +'valley' => array(), +'vantaa' => array(), +'versailles' => array(), +'viking' => array(), +'village' => array(), +'virginia' => array(), +'virtual' => array(), +'virtuel' => array(), +'vlaanderen' => array(), +'volkenkunde' => array(), +'wales' => array(), +'wallonie' => array(), +'war' => array(), +'washingtondc' => array(), +'watchandclock' => array(), +'watch-and-clock' => array(), +'western' => array(), +'westfalen' => array(), +'whaling' => array(), +'wildlife' => array(), +'williamsburg' => array(), +'windmill' => array(), +'workshop' => array(), +'york' => array(), +'yorkshire' => array(), +'yosemite' => array(), +'youth' => array(), +'zoological' => array(), +'zoology' => array(), +'ירושלים' => array(), +'иком' => array()), +'mv' => array('aero' => array(), +'biz' => array(), +'com' => array(), +'coop' => array(), +'edu' => array(), +'gov' => array(), +'info' => array(), +'int' => array(), +'mil' => array(), +'museum' => array(), +'name' => array(), +'net' => array(), +'org' => array(), +'pro' => array()), +'mw' => array('ac' => array(), +'biz' => array(), +'co' => array(), +'com' => array(), +'coop' => array(), +'edu' => array(), +'gov' => array(), +'int' => array(), +'museum' => array(), +'net' => array(), +'org' => array()), +'mx' => array('com' => array(), +'org' => array(), +'gob' => array(), +'edu' => array(), +'net' => array(), +'blogspot' => array()), +'my' => array('com' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'edu' => array(), +'mil' => array(), +'name' => array()), +'mz' => array('*' => array(), +'teledata' => array('!' => '')), +'na' => array('info' => array(), +'pro' => array(), +'name' => array(), +'school' => array(), +'or' => array(), +'dr' => array(), +'us' => array(), +'mx' => array(), +'ca' => array(), +'in' => array(), +'cc' => array(), +'tv' => array(), +'ws' => array(), +'mobi' => array(), +'co' => array(), +'com' => array(), +'org' => array()), +'name' => array('her' => array('forgot' => array()), +'his' => array('forgot' => array())), +'nc' => array('asso' => array()), +'ne' => array(), +'net' => array('cloudfront' => array(), +'gb' => array(), +'hu' => array(), +'jp' => array(), +'se' => array(), +'uk' => array(), +'in' => array(), +'at-band-camp' => array(), +'blogdns' => array(), +'broke-it' => array(), +'buyshouses' => array(), +'dnsalias' => array(), +'dnsdojo' => array(), +'does-it' => array(), +'dontexist' => array(), +'dynalias' => array(), +'dynathome' => array(), +'endofinternet' => array(), +'from-az' => array(), +'from-co' => array(), +'from-la' => array(), +'from-ny' => array(), +'gets-it' => array(), +'ham-radio-op' => array(), +'homeftp' => array(), +'homeip' => array(), +'homelinux' => array(), +'homeunix' => array(), +'in-the-band' => array(), +'is-a-chef' => array(), +'is-a-geek' => array(), +'isa-geek' => array(), +'kicks-ass' => array(), +'office-on-the' => array(), +'podzone' => array(), +'scrapper-site' => array(), +'selfip' => array(), +'sells-it' => array(), +'servebbs' => array(), +'serveftp' => array(), +'thruhere' => array(), +'webhop' => array(), +'fastly' => array('ssl' => array('a' => array(), +'b' => array(), +'global' => array()), +'prod' => array('a' => array(), +'global' => array())), +'azurewebsites' => array(), +'azure-mobile' => array(), +'cloudapp' => array(), +'za' => array()), +'nf' => array('com' => array(), +'net' => array(), +'per' => array(), +'rec' => array(), +'web' => array(), +'arts' => array(), +'firm' => array(), +'info' => array(), +'other' => array(), +'store' => array()), +'ng' => array('com' => array(), +'edu' => array(), +'name' => array(), +'net' => array(), +'org' => array(), +'sch' => array(), +'gov' => array(), +'mil' => array(), +'mobi' => array()), +'ni' => array('*' => array()), +'nl' => array('bv' => array(), +'co' => array(), +'blogspot' => array()), +'no' => array('fhs' => array(), +'vgs' => array(), +'fylkesbibl' => array(), +'folkebibl' => array(), +'museum' => array(), +'idrett' => array(), +'priv' => array(), +'mil' => array(), +'stat' => array(), +'dep' => array(), +'kommune' => array(), +'herad' => array(), +'aa' => array('gs' => array()), +'ah' => array('gs' => array()), +'bu' => array('gs' => array()), +'fm' => array('gs' => array()), +'hl' => array('gs' => array()), +'hm' => array('gs' => array()), +'jan-mayen' => array('gs' => array()), +'mr' => array('gs' => array()), +'nl' => array('gs' => array()), +'nt' => array('gs' => array()), +'of' => array('gs' => array()), +'ol' => array('gs' => array()), +'oslo' => array('gs' => array()), +'rl' => array('gs' => array()), +'sf' => array('gs' => array()), +'st' => array('gs' => array()), +'svalbard' => array('gs' => array()), +'tm' => array('gs' => array()), +'tr' => array('gs' => array()), +'va' => array('gs' => array()), +'vf' => array('gs' => array()), +'akrehamn' => array(), +'åkrehamn' => array(), +'algard' => array(), +'ålgård' => array(), +'arna' => array(), +'brumunddal' => array(), +'bryne' => array(), +'bronnoysund' => array(), +'brønnøysund' => array(), +'drobak' => array(), +'drøbak' => array(), +'egersund' => array(), +'fetsund' => array(), +'floro' => array(), +'florø' => array(), +'fredrikstad' => array(), +'hokksund' => array(), +'honefoss' => array(), +'hønefoss' => array(), +'jessheim' => array(), +'jorpeland' => array(), +'jørpeland' => array(), +'kirkenes' => array(), +'kopervik' => array(), +'krokstadelva' => array(), +'langevag' => array(), +'langevåg' => array(), +'leirvik' => array(), +'mjondalen' => array(), +'mjøndalen' => array(), +'mo-i-rana' => array(), +'mosjoen' => array(), +'mosjøen' => array(), +'nesoddtangen' => array(), +'orkanger' => array(), +'osoyro' => array(), +'osøyro' => array(), +'raholt' => array(), +'råholt' => array(), +'sandnessjoen' => array(), +'sandnessjøen' => array(), +'skedsmokorset' => array(), +'slattum' => array(), +'spjelkavik' => array(), +'stathelle' => array(), +'stavern' => array(), +'stjordalshalsen' => array(), +'stjørdalshalsen' => array(), +'tananger' => array(), +'tranby' => array(), +'vossevangen' => array(), +'afjord' => array(), +'åfjord' => array(), +'agdenes' => array(), +'al' => array(), +'ål' => array(), +'alesund' => array(), +'ålesund' => array(), +'alstahaug' => array(), +'alta' => array(), +'áltá' => array(), +'alaheadju' => array(), +'álaheadju' => array(), +'alvdal' => array(), +'amli' => array(), +'åmli' => array(), +'amot' => array(), +'åmot' => array(), +'andebu' => array(), +'andoy' => array(), +'andøy' => array(), +'andasuolo' => array(), +'ardal' => array(), +'årdal' => array(), +'aremark' => array(), +'arendal' => array(), +'ås' => array(), +'aseral' => array(), +'åseral' => array(), +'asker' => array(), +'askim' => array(), +'askvoll' => array(), +'askoy' => array(), +'askøy' => array(), +'asnes' => array(), +'åsnes' => array(), +'audnedaln' => array(), +'aukra' => array(), +'aure' => array(), +'aurland' => array(), +'aurskog-holand' => array(), +'aurskog-høland' => array(), +'austevoll' => array(), +'austrheim' => array(), +'averoy' => array(), +'averøy' => array(), +'balestrand' => array(), +'ballangen' => array(), +'balat' => array(), +'bálát' => array(), +'balsfjord' => array(), +'bahccavuotna' => array(), +'báhccavuotna' => array(), +'bamble' => array(), +'bardu' => array(), +'beardu' => array(), +'beiarn' => array(), +'bajddar' => array(), +'bájddar' => array(), +'baidar' => array(), +'báidár' => array(), +'berg' => array(), +'bergen' => array(), +'berlevag' => array(), +'berlevåg' => array(), +'bearalvahki' => array(), +'bearalváhki' => array(), +'bindal' => array(), +'birkenes' => array(), +'bjarkoy' => array(), +'bjarkøy' => array(), +'bjerkreim' => array(), +'bjugn' => array(), +'bodo' => array(), +'bodø' => array(), +'badaddja' => array(), +'bådåddjå' => array(), +'budejju' => array(), +'bokn' => array(), +'bremanger' => array(), +'bronnoy' => array(), +'brønnøy' => array(), +'bygland' => array(), +'bykle' => array(), +'barum' => array(), +'bærum' => array(), +'telemark' => array('bo' => array(), +'bø' => array()), +'nordland' => array('bo' => array(), +'bø' => array(), +'heroy' => array(), +'herøy' => array()), +'bievat' => array(), +'bievát' => array(), +'bomlo' => array(), +'bømlo' => array(), +'batsfjord' => array(), +'båtsfjord' => array(), +'bahcavuotna' => array(), +'báhcavuotna' => array(), +'dovre' => array(), +'drammen' => array(), +'drangedal' => array(), +'dyroy' => array(), +'dyrøy' => array(), +'donna' => array(), +'dønna' => array(), +'eid' => array(), +'eidfjord' => array(), +'eidsberg' => array(), +'eidskog' => array(), +'eidsvoll' => array(), +'eigersund' => array(), +'elverum' => array(), +'enebakk' => array(), +'engerdal' => array(), +'etne' => array(), +'etnedal' => array(), +'evenes' => array(), +'evenassi' => array(), +'evenášši' => array(), +'evje-og-hornnes' => array(), +'farsund' => array(), +'fauske' => array(), +'fuossko' => array(), +'fuoisku' => array(), +'fedje' => array(), +'fet' => array(), +'finnoy' => array(), +'finnøy' => array(), +'fitjar' => array(), +'fjaler' => array(), +'fjell' => array(), +'flakstad' => array(), +'flatanger' => array(), +'flekkefjord' => array(), +'flesberg' => array(), +'flora' => array(), +'fla' => array(), +'flå' => array(), +'folldal' => array(), +'forsand' => array(), +'fosnes' => array(), +'frei' => array(), +'frogn' => array(), +'froland' => array(), +'frosta' => array(), +'frana' => array(), +'fræna' => array(), +'froya' => array(), +'frøya' => array(), +'fusa' => array(), +'fyresdal' => array(), +'forde' => array(), +'førde' => array(), +'gamvik' => array(), +'gangaviika' => array(), +'gáŋgaviika' => array(), +'gaular' => array(), +'gausdal' => array(), +'gildeskal' => array(), +'gildeskål' => array(), +'giske' => array(), +'gjemnes' => array(), +'gjerdrum' => array(), +'gjerstad' => array(), +'gjesdal' => array(), +'gjovik' => array(), +'gjøvik' => array(), +'gloppen' => array(), +'gol' => array(), +'gran' => array(), +'grane' => array(), +'granvin' => array(), +'gratangen' => array(), +'grimstad' => array(), +'grong' => array(), +'kraanghke' => array(), +'kråanghke' => array(), +'grue' => array(), +'gulen' => array(), +'hadsel' => array(), +'halden' => array(), +'halsa' => array(), +'hamar' => array(), +'hamaroy' => array(), +'habmer' => array(), +'hábmer' => array(), +'hapmir' => array(), +'hápmir' => array(), +'hammerfest' => array(), +'hammarfeasta' => array(), +'hámmárfeasta' => array(), +'haram' => array(), +'hareid' => array(), +'harstad' => array(), +'hasvik' => array(), +'aknoluokta' => array(), +'ákŋoluokta' => array(), +'hattfjelldal' => array(), +'aarborte' => array(), +'haugesund' => array(), +'hemne' => array(), +'hemnes' => array(), +'hemsedal' => array(), +'more-og-romsdal' => array('heroy' => array(), +'sande' => array()), +'møre-og-romsdal' => array('herøy' => array(), +'sande' => array()), +'hitra' => array(), +'hjartdal' => array(), +'hjelmeland' => array(), +'hobol' => array(), +'hobøl' => array(), +'hof' => array(), +'hol' => array(), +'hole' => array(), +'holmestrand' => array(), +'holtalen' => array(), +'holtålen' => array(), +'hornindal' => array(), +'horten' => array(), +'hurdal' => array(), +'hurum' => array(), +'hvaler' => array(), +'hyllestad' => array(), +'hagebostad' => array(), +'hægebostad' => array(), +'hoyanger' => array(), +'høyanger' => array(), +'hoylandet' => array(), +'høylandet' => array(), +'ha' => array(), +'hå' => array(), +'ibestad' => array(), +'inderoy' => array(), +'inderøy' => array(), +'iveland' => array(), +'jevnaker' => array(), +'jondal' => array(), +'jolster' => array(), +'jølster' => array(), +'karasjok' => array(), +'karasjohka' => array(), +'kárášjohka' => array(), +'karlsoy' => array(), +'galsa' => array(), +'gálsá' => array(), +'karmoy' => array(), +'karmøy' => array(), +'kautokeino' => array(), +'guovdageaidnu' => array(), +'klepp' => array(), +'klabu' => array(), +'klæbu' => array(), +'kongsberg' => array(), +'kongsvinger' => array(), +'kragero' => array(), +'kragerø' => array(), +'kristiansand' => array(), +'kristiansund' => array(), +'krodsherad' => array(), +'krødsherad' => array(), +'kvalsund' => array(), +'rahkkeravju' => array(), +'ráhkkerávju' => array(), +'kvam' => array(), +'kvinesdal' => array(), +'kvinnherad' => array(), +'kviteseid' => array(), +'kvitsoy' => array(), +'kvitsøy' => array(), +'kvafjord' => array(), +'kvæfjord' => array(), +'giehtavuoatna' => array(), +'kvanangen' => array(), +'kvænangen' => array(), +'navuotna' => array(), +'návuotna' => array(), +'kafjord' => array(), +'kåfjord' => array(), +'gaivuotna' => array(), +'gáivuotna' => array(), +'larvik' => array(), +'lavangen' => array(), +'lavagis' => array(), +'loabat' => array(), +'loabát' => array(), +'lebesby' => array(), +'davvesiida' => array(), +'leikanger' => array(), +'leirfjord' => array(), +'leka' => array(), +'leksvik' => array(), +'lenvik' => array(), +'leangaviika' => array(), +'leaŋgaviika' => array(), +'lesja' => array(), +'levanger' => array(), +'lier' => array(), +'lierne' => array(), +'lillehammer' => array(), +'lillesand' => array(), +'lindesnes' => array(), +'lindas' => array(), +'lindås' => array(), +'lom' => array(), +'loppa' => array(), +'lahppi' => array(), +'láhppi' => array(), +'lund' => array(), +'lunner' => array(), +'luroy' => array(), +'lurøy' => array(), +'luster' => array(), +'lyngdal' => array(), +'lyngen' => array(), +'ivgu' => array(), +'lardal' => array(), +'lerdal' => array(), +'lærdal' => array(), +'lodingen' => array(), +'lødingen' => array(), +'lorenskog' => array(), +'lørenskog' => array(), +'loten' => array(), +'løten' => array(), +'malvik' => array(), +'masoy' => array(), +'måsøy' => array(), +'muosat' => array(), +'muosát' => array(), +'mandal' => array(), +'marker' => array(), +'marnardal' => array(), +'masfjorden' => array(), +'meland' => array(), +'meldal' => array(), +'melhus' => array(), +'meloy' => array(), +'meløy' => array(), +'meraker' => array(), +'meråker' => array(), +'moareke' => array(), +'moåreke' => array(), +'midsund' => array(), +'midtre-gauldal' => array(), +'modalen' => array(), +'modum' => array(), +'molde' => array(), +'moskenes' => array(), +'moss' => array(), +'mosvik' => array(), +'malselv' => array(), +'målselv' => array(), +'malatvuopmi' => array(), +'málatvuopmi' => array(), +'namdalseid' => array(), +'aejrie' => array(), +'namsos' => array(), +'namsskogan' => array(), +'naamesjevuemie' => array(), +'nååmesjevuemie' => array(), +'laakesvuemie' => array(), +'nannestad' => array(), +'narvik' => array(), +'narviika' => array(), +'naustdal' => array(), +'nedre-eiker' => array(), +'akershus' => array('nes' => array()), +'buskerud' => array('nes' => array()), +'nesna' => array(), +'nesodden' => array(), +'nesseby' => array(), +'unjarga' => array(), +'unjárga' => array(), +'nesset' => array(), +'nissedal' => array(), +'nittedal' => array(), +'nord-aurdal' => array(), +'nord-fron' => array(), +'nord-odal' => array(), +'norddal' => array(), +'nordkapp' => array(), +'davvenjarga' => array(), +'davvenjárga' => array(), +'nordre-land' => array(), +'nordreisa' => array(), +'raisa' => array(), +'ráisa' => array(), +'nore-og-uvdal' => array(), +'notodden' => array(), +'naroy' => array(), +'nærøy' => array(), +'notteroy' => array(), +'nøtterøy' => array(), +'odda' => array(), +'oksnes' => array(), +'øksnes' => array(), +'oppdal' => array(), +'oppegard' => array(), +'oppegård' => array(), +'orkdal' => array(), +'orland' => array(), +'ørland' => array(), +'orskog' => array(), +'ørskog' => array(), +'orsta' => array(), +'ørsta' => array(), +'hedmark' => array('os' => array(), +'valer' => array(), +'våler' => array()), +'hordaland' => array('os' => array()), +'osen' => array(), +'osteroy' => array(), +'osterøy' => array(), +'ostre-toten' => array(), +'østre-toten' => array(), +'overhalla' => array(), +'ovre-eiker' => array(), +'øvre-eiker' => array(), +'oyer' => array(), +'øyer' => array(), +'oygarden' => array(), +'øygarden' => array(), +'oystre-slidre' => array(), +'øystre-slidre' => array(), +'porsanger' => array(), +'porsangu' => array(), +'porsáŋgu' => array(), +'porsgrunn' => array(), +'radoy' => array(), +'radøy' => array(), +'rakkestad' => array(), +'rana' => array(), +'ruovat' => array(), +'randaberg' => array(), +'rauma' => array(), +'rendalen' => array(), +'rennebu' => array(), +'rennesoy' => array(), +'rennesøy' => array(), +'rindal' => array(), +'ringebu' => array(), +'ringerike' => array(), +'ringsaker' => array(), +'rissa' => array(), +'risor' => array(), +'risør' => array(), +'roan' => array(), +'rollag' => array(), +'rygge' => array(), +'ralingen' => array(), +'rælingen' => array(), +'rodoy' => array(), +'rødøy' => array(), +'romskog' => array(), +'rømskog' => array(), +'roros' => array(), +'røros' => array(), +'rost' => array(), +'røst' => array(), +'royken' => array(), +'røyken' => array(), +'royrvik' => array(), +'røyrvik' => array(), +'rade' => array(), +'råde' => array(), +'salangen' => array(), +'siellak' => array(), +'saltdal' => array(), +'salat' => array(), +'sálát' => array(), +'sálat' => array(), +'samnanger' => array(), +'vestfold' => array('sande' => array()), +'sandefjord' => array(), +'sandnes' => array(), +'sandoy' => array(), +'sandøy' => array(), +'sarpsborg' => array(), +'sauda' => array(), +'sauherad' => array(), +'sel' => array(), +'selbu' => array(), +'selje' => array(), +'seljord' => array(), +'sigdal' => array(), +'siljan' => array(), +'sirdal' => array(), +'skaun' => array(), +'skedsmo' => array(), +'ski' => array(), +'skien' => array(), +'skiptvet' => array(), +'skjervoy' => array(), +'skjervøy' => array(), +'skierva' => array(), +'skiervá' => array(), +'skjak' => array(), +'skjåk' => array(), +'skodje' => array(), +'skanland' => array(), +'skånland' => array(), +'skanit' => array(), +'skánit' => array(), +'smola' => array(), +'smøla' => array(), +'snillfjord' => array(), +'snasa' => array(), +'snåsa' => array(), +'snoasa' => array(), +'snaase' => array(), +'snåase' => array(), +'sogndal' => array(), +'sokndal' => array(), +'sola' => array(), +'solund' => array(), +'songdalen' => array(), +'sortland' => array(), +'spydeberg' => array(), +'stange' => array(), +'stavanger' => array(), +'steigen' => array(), +'steinkjer' => array(), +'stjordal' => array(), +'stjørdal' => array(), +'stokke' => array(), +'stor-elvdal' => array(), +'stord' => array(), +'stordal' => array(), +'storfjord' => array(), +'omasvuotna' => array(), +'strand' => array(), +'stranda' => array(), +'stryn' => array(), +'sula' => array(), +'suldal' => array(), +'sund' => array(), +'sunndal' => array(), +'surnadal' => array(), +'sveio' => array(), +'svelvik' => array(), +'sykkylven' => array(), +'sogne' => array(), +'søgne' => array(), +'somna' => array(), +'sømna' => array(), +'sondre-land' => array(), +'søndre-land' => array(), +'sor-aurdal' => array(), +'sør-aurdal' => array(), +'sor-fron' => array(), +'sør-fron' => array(), +'sor-odal' => array(), +'sør-odal' => array(), +'sor-varanger' => array(), +'sør-varanger' => array(), +'matta-varjjat' => array(), +'mátta-várjjat' => array(), +'sorfold' => array(), +'sørfold' => array(), +'sorreisa' => array(), +'sørreisa' => array(), +'sorum' => array(), +'sørum' => array(), +'tana' => array(), +'deatnu' => array(), +'time' => array(), +'tingvoll' => array(), +'tinn' => array(), +'tjeldsund' => array(), +'dielddanuorri' => array(), +'tjome' => array(), +'tjøme' => array(), +'tokke' => array(), +'tolga' => array(), +'torsken' => array(), +'tranoy' => array(), +'tranøy' => array(), +'tromso' => array(), +'tromsø' => array(), +'tromsa' => array(), +'romsa' => array(), +'trondheim' => array(), +'troandin' => array(), +'trysil' => array(), +'trana' => array(), +'træna' => array(), +'trogstad' => array(), +'trøgstad' => array(), +'tvedestrand' => array(), +'tydal' => array(), +'tynset' => array(), +'tysfjord' => array(), +'divtasvuodna' => array(), +'divttasvuotna' => array(), +'tysnes' => array(), +'tysvar' => array(), +'tysvær' => array(), +'tonsberg' => array(), +'tønsberg' => array(), +'ullensaker' => array(), +'ullensvang' => array(), +'ulvik' => array(), +'utsira' => array(), +'vadso' => array(), +'vadsø' => array(), +'cahcesuolo' => array(), +'čáhcesuolo' => array(), +'vaksdal' => array(), +'valle' => array(), +'vang' => array(), +'vanylven' => array(), +'vardo' => array(), +'vardø' => array(), +'varggat' => array(), +'várggát' => array(), +'vefsn' => array(), +'vaapste' => array(), +'vega' => array(), +'vegarshei' => array(), +'vegårshei' => array(), +'vennesla' => array(), +'verdal' => array(), +'verran' => array(), +'vestby' => array(), +'vestnes' => array(), +'vestre-slidre' => array(), +'vestre-toten' => array(), +'vestvagoy' => array(), +'vestvågøy' => array(), +'vevelstad' => array(), +'vik' => array(), +'vikna' => array(), +'vindafjord' => array(), +'volda' => array(), +'voss' => array(), +'varoy' => array(), +'værøy' => array(), +'vagan' => array(), +'vågan' => array(), +'voagat' => array(), +'vagsoy' => array(), +'vågsøy' => array(), +'vaga' => array(), +'vågå' => array(), +'ostfold' => array('valer' => array()), +'østfold' => array('våler' => array()), +'co' => array(), +'blogspot' => array()), +'np' => array('*' => array()), +'nr' => array('biz' => array(), +'info' => array(), +'gov' => array(), +'edu' => array(), +'org' => array(), +'net' => array(), +'com' => array()), +'nu' => array('merseine' => array(), +'mine' => array(), +'shacknet' => array()), +'nz' => array('ac' => array(), +'co' => array('blogspot' => array()), +'cri' => array(), +'geek' => array(), +'gen' => array(), +'govt' => array(), +'health' => array(), +'iwi' => array(), +'kiwi' => array(), +'maori' => array(), +'mil' => array(), +'māori' => array(), +'net' => array(), +'org' => array(), +'parliament' => array(), +'school' => array()), +'om' => array('co' => array(), +'com' => array(), +'edu' => array(), +'gov' => array(), +'med' => array(), +'museum' => array(), +'net' => array(), +'org' => array(), +'pro' => array()), +'org' => array('ae' => array(), +'us' => array(), +'dyndns' => array('go' => array(), +'home' => array()), +'blogdns' => array(), +'blogsite' => array(), +'boldlygoingnowhere' => array(), +'dnsalias' => array(), +'dnsdojo' => array(), +'doesntexist' => array(), +'dontexist' => array(), +'doomdns' => array(), +'dvrdns' => array(), +'dynalias' => array(), +'endofinternet' => array(), +'endoftheinternet' => array(), +'from-me' => array(), +'game-host' => array(), +'gotdns' => array(), +'hobby-site' => array(), +'homedns' => array(), +'homeftp' => array(), +'homelinux' => array(), +'homeunix' => array(), +'is-a-bruinsfan' => array(), +'is-a-candidate' => array(), +'is-a-celticsfan' => array(), +'is-a-chef' => array(), +'is-a-geek' => array(), +'is-a-knight' => array(), +'is-a-linux-user' => array(), +'is-a-patsfan' => array(), +'is-a-soxfan' => array(), +'is-found' => array(), +'is-lost' => array(), +'is-saved' => array(), +'is-very-bad' => array(), +'is-very-evil' => array(), +'is-very-good' => array(), +'is-very-nice' => array(), +'is-very-sweet' => array(), +'isa-geek' => array(), +'kicks-ass' => array(), +'misconfused' => array(), +'podzone' => array(), +'readmyblog' => array(), +'selfip' => array(), +'sellsyourhome' => array(), +'servebbs' => array(), +'serveftp' => array(), +'servegame' => array(), +'stuff-4-sale' => array(), +'webhop' => array(), +'za' => array()), +'pa' => array('ac' => array(), +'gob' => array(), +'com' => array(), +'org' => array(), +'sld' => array(), +'edu' => array(), +'net' => array(), +'ing' => array(), +'abo' => array(), +'med' => array(), +'nom' => array()), +'pe' => array('edu' => array(), +'gob' => array(), +'nom' => array(), +'mil' => array(), +'org' => array(), +'com' => array(), +'net' => array()), +'pf' => array('com' => array(), +'org' => array(), +'edu' => array()), +'pg' => array('*' => array()), +'ph' => array('com' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'edu' => array(), +'ngo' => array(), +'mil' => array(), +'i' => array()), +'pk' => array('com' => array(), +'net' => array(), +'edu' => array(), +'org' => array(), +'fam' => array(), +'biz' => array(), +'web' => array(), +'gov' => array(), +'gob' => array(), +'gok' => array(), +'gon' => array(), +'gop' => array(), +'gos' => array(), +'info' => array()), +'pl' => array('aid' => array(), +'agro' => array(), +'atm' => array(), +'auto' => array(), +'biz' => array(), +'com' => array(), +'edu' => array(), +'gmina' => array(), +'gsm' => array(), +'info' => array(), +'mail' => array(), +'miasta' => array(), +'media' => array(), +'mil' => array(), +'net' => array(), +'nieruchomosci' => array(), +'nom' => array(), +'org' => array(), +'pc' => array(), +'powiat' => array(), +'priv' => array(), +'realestate' => array(), +'rel' => array(), +'sex' => array(), +'shop' => array(), +'sklep' => array(), +'sos' => array(), +'szkola' => array(), +'targi' => array(), +'tm' => array(), +'tourism' => array(), +'travel' => array(), +'turystyka' => array(), +'6bone' => array(), +'art' => array(), +'mbone' => array(), +'gov' => array('uw' => array(), +'um' => array(), +'ug' => array(), +'upow' => array(), +'starostwo' => array(), +'so' => array(), +'sr' => array(), +'po' => array(), +'pa' => array()), +'ngo' => array(), +'irc' => array(), +'usenet' => array(), +'augustow' => array(), +'babia-gora' => array(), +'bedzin' => array(), +'beskidy' => array(), +'bialowieza' => array(), +'bialystok' => array(), +'bielawa' => array(), +'bieszczady' => array(), +'boleslawiec' => array(), +'bydgoszcz' => array(), +'bytom' => array(), +'cieszyn' => array(), +'czeladz' => array(), +'czest' => array(), +'dlugoleka' => array(), +'elblag' => array(), +'elk' => array(), +'glogow' => array(), +'gniezno' => array(), +'gorlice' => array(), +'grajewo' => array(), +'ilawa' => array(), +'jaworzno' => array(), +'jelenia-gora' => array(), +'jgora' => array(), +'kalisz' => array(), +'kazimierz-dolny' => array(), +'karpacz' => array(), +'kartuzy' => array(), +'kaszuby' => array(), +'katowice' => array(), +'kepno' => array(), +'ketrzyn' => array(), +'klodzko' => array(), +'kobierzyce' => array(), +'kolobrzeg' => array(), +'konin' => array(), +'konskowola' => array(), +'kutno' => array(), +'lapy' => array(), +'lebork' => array(), +'legnica' => array(), +'lezajsk' => array(), +'limanowa' => array(), +'lomza' => array(), +'lowicz' => array(), +'lubin' => array(), +'lukow' => array(), +'malbork' => array(), +'malopolska' => array(), +'mazowsze' => array(), +'mazury' => array(), +'mielec' => array(), +'mielno' => array(), +'mragowo' => array(), +'naklo' => array(), +'nowaruda' => array(), +'nysa' => array(), +'olawa' => array(), +'olecko' => array(), +'olkusz' => array(), +'olsztyn' => array(), +'opoczno' => array(), +'opole' => array(), +'ostroda' => array(), +'ostroleka' => array(), +'ostrowiec' => array(), +'ostrowwlkp' => array(), +'pila' => array(), +'pisz' => array(), +'podhale' => array(), +'podlasie' => array(), +'polkowice' => array(), +'pomorze' => array(), +'pomorskie' => array(), +'prochowice' => array(), +'pruszkow' => array(), +'przeworsk' => array(), +'pulawy' => array(), +'radom' => array(), +'rawa-maz' => array(), +'rybnik' => array(), +'rzeszow' => array(), +'sanok' => array(), +'sejny' => array(), +'siedlce' => array(), +'slask' => array(), +'slupsk' => array(), +'sosnowiec' => array(), +'stalowa-wola' => array(), +'skoczow' => array(), +'starachowice' => array(), +'stargard' => array(), +'suwalki' => array(), +'swidnica' => array(), +'swiebodzin' => array(), +'swinoujscie' => array(), +'szczecin' => array(), +'szczytno' => array(), +'tarnobrzeg' => array(), +'tgory' => array(), +'turek' => array(), +'tychy' => array(), +'ustka' => array(), +'walbrzych' => array(), +'warmia' => array(), +'warszawa' => array(), +'waw' => array(), +'wegrow' => array(), +'wielun' => array(), +'wlocl' => array(), +'wloclawek' => array(), +'wodzislaw' => array(), +'wolomin' => array(), +'wroclaw' => array(), +'zachpomor' => array(), +'zagan' => array(), +'zarow' => array(), +'zgora' => array(), +'zgorzelec' => array(), +'gda' => array(), +'gdansk' => array(), +'gdynia' => array(), +'med' => array(), +'sopot' => array(), +'gliwice' => array(), +'krakow' => array(), +'poznan' => array(), +'wroc' => array(), +'zakopane' => array(), +'co' => array()), +'pm' => array(), +'pn' => array('gov' => array(), +'co' => array(), +'org' => array(), +'edu' => array(), +'net' => array()), +'post' => array(), +'pr' => array('com' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'edu' => array(), +'isla' => array(), +'pro' => array(), +'biz' => array(), +'info' => array(), +'name' => array(), +'est' => array(), +'prof' => array(), +'ac' => array()), +'pro' => array('aca' => array(), +'bar' => array(), +'cpa' => array(), +'jur' => array(), +'law' => array(), +'med' => array(), +'eng' => array()), +'ps' => array('edu' => array(), +'gov' => array(), +'sec' => array(), +'plo' => array(), +'com' => array(), +'org' => array(), +'net' => array()), +'pt' => array('net' => array(), +'gov' => array(), +'org' => array(), +'edu' => array(), +'int' => array(), +'publ' => array(), +'com' => array(), +'nome' => array(), +'blogspot' => array()), +'pw' => array('co' => array(), +'ne' => array(), +'or' => array(), +'ed' => array(), +'go' => array(), +'belau' => array()), +'py' => array('com' => array(), +'coop' => array(), +'edu' => array(), +'gov' => array(), +'mil' => array(), +'net' => array(), +'org' => array()), +'qa' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'mil' => array(), +'name' => array(), +'net' => array(), +'org' => array(), +'sch' => array()), +'re' => array('com' => array(), +'asso' => array(), +'nom' => array(), +'blogspot' => array()), +'ro' => array('com' => array(), +'org' => array(), +'tm' => array(), +'nt' => array(), +'nom' => array(), +'info' => array(), +'rec' => array(), +'arts' => array(), +'firm' => array(), +'store' => array(), +'www' => array(), +'blogspot' => array()), +'rs' => array('co' => array(), +'org' => array(), +'edu' => array(), +'ac' => array(), +'gov' => array(), +'in' => array()), +'ru' => array('ac' => array(), +'com' => array(), +'edu' => array(), +'int' => array(), +'net' => array(), +'org' => array(), +'pp' => array(), +'adygeya' => array(), +'altai' => array(), +'amur' => array(), +'arkhangelsk' => array(), +'astrakhan' => array(), +'bashkiria' => array(), +'belgorod' => array(), +'bir' => array(), +'bryansk' => array(), +'buryatia' => array(), +'cbg' => array(), +'chel' => array(), +'chelyabinsk' => array(), +'chita' => array(), +'chukotka' => array(), +'chuvashia' => array(), +'dagestan' => array(), +'dudinka' => array(), +'e-burg' => array(), +'grozny' => array(), +'irkutsk' => array(), +'ivanovo' => array(), +'izhevsk' => array(), +'jar' => array(), +'joshkar-ola' => array(), +'kalmykia' => array(), +'kaluga' => array(), +'kamchatka' => array(), +'karelia' => array(), +'kazan' => array(), +'kchr' => array(), +'kemerovo' => array(), +'khabarovsk' => array(), +'khakassia' => array(), +'khv' => array(), +'kirov' => array(), +'koenig' => array(), +'komi' => array(), +'kostroma' => array(), +'krasnoyarsk' => array(), +'kuban' => array(), +'kurgan' => array(), +'kursk' => array(), +'lipetsk' => array(), +'magadan' => array(), +'mari' => array(), +'mari-el' => array(), +'marine' => array(), +'mordovia' => array(), +'mosreg' => array(), +'msk' => array(), +'murmansk' => array(), +'nalchik' => array(), +'nnov' => array(), +'nov' => array(), +'novosibirsk' => array(), +'nsk' => array(), +'omsk' => array(), +'orenburg' => array(), +'oryol' => array(), +'palana' => array(), +'penza' => array(), +'perm' => array(), +'ptz' => array(), +'rnd' => array(), +'ryazan' => array(), +'sakhalin' => array(), +'samara' => array(), +'saratov' => array(), +'simbirsk' => array(), +'smolensk' => array(), +'spb' => array(), +'stavropol' => array(), +'stv' => array(), +'surgut' => array(), +'tambov' => array(), +'tatarstan' => array(), +'tom' => array(), +'tomsk' => array(), +'tsaritsyn' => array(), +'tsk' => array(), +'tula' => array(), +'tuva' => array(), +'tver' => array(), +'tyumen' => array(), +'udm' => array(), +'udmurtia' => array(), +'ulan-ude' => array(), +'vladikavkaz' => array(), +'vladimir' => array(), +'vladivostok' => array(), +'volgograd' => array(), +'vologda' => array(), +'voronezh' => array(), +'vrn' => array(), +'vyatka' => array(), +'yakutia' => array(), +'yamal' => array(), +'yaroslavl' => array(), +'yekaterinburg' => array(), +'yuzhno-sakhalinsk' => array(), +'amursk' => array(), +'baikal' => array(), +'cmw' => array(), +'fareast' => array(), +'jamal' => array(), +'kms' => array(), +'k-uralsk' => array(), +'kustanai' => array(), +'kuzbass' => array(), +'magnitka' => array(), +'mytis' => array(), +'nakhodka' => array(), +'nkz' => array(), +'norilsk' => array(), +'oskol' => array(), +'pyatigorsk' => array(), +'rubtsovsk' => array(), +'snz' => array(), +'syzran' => array(), +'vdonsk' => array(), +'zgrad' => array(), +'gov' => array(), +'mil' => array(), +'test' => array()), +'rw' => array('gov' => array(), +'net' => array(), +'edu' => array(), +'ac' => array(), +'com' => array(), +'co' => array(), +'int' => array(), +'mil' => array(), +'gouv' => array()), +'sa' => array('com' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'med' => array(), +'pub' => array(), +'edu' => array(), +'sch' => array()), +'sb' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'net' => array(), +'org' => array()), +'sc' => array('com' => array(), +'gov' => array(), +'net' => array(), +'org' => array(), +'edu' => array()), +'sd' => array('com' => array(), +'net' => array(), +'org' => array(), +'edu' => array(), +'med' => array(), +'tv' => array(), +'gov' => array(), +'info' => array()), +'se' => array('a' => array(), +'ac' => array(), +'b' => array(), +'bd' => array(), +'brand' => array(), +'c' => array(), +'d' => array(), +'e' => array(), +'f' => array(), +'fh' => array(), +'fhsk' => array(), +'fhv' => array(), +'g' => array(), +'h' => array(), +'i' => array(), +'k' => array(), +'komforb' => array(), +'kommunalforbund' => array(), +'komvux' => array(), +'l' => array(), +'lanbib' => array(), +'m' => array(), +'n' => array(), +'naturbruksgymn' => array(), +'o' => array(), +'org' => array(), +'p' => array(), +'parti' => array(), +'pp' => array(), +'press' => array(), +'r' => array(), +'s' => array(), +'t' => array(), +'tm' => array(), +'u' => array(), +'w' => array(), +'x' => array(), +'y' => array(), +'z' => array(), +'com' => array(), +'blogspot' => array()), +'sg' => array('com' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'edu' => array(), +'per' => array(), +'blogspot' => array()), +'sh' => array('com' => array(), +'net' => array(), +'gov' => array(), +'org' => array(), +'mil' => array()), +'si' => array(), +'sj' => array(), +'sk' => array('blogspot' => array()), +'sl' => array('com' => array(), +'net' => array(), +'edu' => array(), +'gov' => array(), +'org' => array()), +'sm' => array(), +'sn' => array('art' => array(), +'com' => array(), +'edu' => array(), +'gouv' => array(), +'org' => array(), +'perso' => array(), +'univ' => array()), +'so' => array('com' => array(), +'net' => array(), +'org' => array()), +'sr' => array(), +'st' => array('co' => array(), +'com' => array(), +'consulado' => array(), +'edu' => array(), +'embaixada' => array(), +'gov' => array(), +'mil' => array(), +'net' => array(), +'org' => array(), +'principe' => array(), +'saotome' => array(), +'store' => array()), +'su' => array(), +'sv' => array('com' => array(), +'edu' => array(), +'gob' => array(), +'org' => array(), +'red' => array()), +'sx' => array('gov' => array()), +'sy' => array('edu' => array(), +'gov' => array(), +'net' => array(), +'mil' => array(), +'com' => array(), +'org' => array()), +'sz' => array('co' => array(), +'ac' => array(), +'org' => array()), +'tc' => array(), +'td' => array('blogspot' => array()), +'tel' => array(), +'tf' => array(), +'tg' => array(), +'th' => array('ac' => array(), +'co' => array(), +'go' => array(), +'in' => array(), +'mi' => array(), +'net' => array(), +'or' => array()), +'tj' => array('ac' => array(), +'biz' => array(), +'co' => array(), +'com' => array(), +'edu' => array(), +'go' => array(), +'gov' => array(), +'int' => array(), +'mil' => array(), +'name' => array(), +'net' => array(), +'nic' => array(), +'org' => array(), +'test' => array(), +'web' => array()), +'tk' => array(), +'tl' => array('gov' => array()), +'tm' => array('com' => array(), +'co' => array(), +'org' => array(), +'net' => array(), +'nom' => array(), +'gov' => array(), +'mil' => array(), +'edu' => array()), +'tn' => array('com' => array(), +'ens' => array(), +'fin' => array(), +'gov' => array(), +'ind' => array(), +'intl' => array(), +'nat' => array(), +'net' => array(), +'org' => array(), +'info' => array(), +'perso' => array(), +'tourism' => array(), +'edunet' => array(), +'rnrt' => array(), +'rns' => array(), +'rnu' => array(), +'mincom' => array(), +'agrinet' => array(), +'defense' => array(), +'turen' => array()), +'to' => array('com' => array(), +'gov' => array(), +'net' => array(), +'org' => array(), +'edu' => array(), +'mil' => array()), +'tp' => array(), +'tr' => array('com' => array(), +'info' => array(), +'biz' => array(), +'net' => array(), +'org' => array(), +'web' => array(), +'gen' => array(), +'tv' => array(), +'av' => array(), +'dr' => array(), +'bbs' => array(), +'name' => array(), +'tel' => array(), +'gov' => array(), +'bel' => array(), +'pol' => array(), +'mil' => array(), +'k12' => array(), +'edu' => array(), +'kep' => array(), +'nc' => array('gov' => array())), +'travel' => array(), +'tt' => array('co' => array(), +'com' => array(), +'org' => array(), +'net' => array(), +'biz' => array(), +'info' => array(), +'pro' => array(), +'int' => array(), +'coop' => array(), +'jobs' => array(), +'mobi' => array(), +'travel' => array(), +'museum' => array(), +'aero' => array(), +'name' => array(), +'gov' => array(), +'edu' => array()), +'tv' => array('dyndns' => array(), +'better-than' => array(), +'on-the-web' => array(), +'worse-than' => array()), +'tw' => array('edu' => array(), +'gov' => array(), +'mil' => array(), +'com' => array(), +'net' => array(), +'org' => array(), +'idv' => array(), +'game' => array(), +'ebiz' => array(), +'club' => array(), +'網路' => array(), +'組織' => array(), +'商業' => array(), +'blogspot' => array()), +'tz' => array('ac' => array(), +'co' => array(), +'go' => array(), +'hotel' => array(), +'info' => array(), +'me' => array(), +'mil' => array(), +'mobi' => array(), +'ne' => array(), +'or' => array(), +'sc' => array(), +'tv' => array()), +'ua' => array('com' => array(), +'edu' => array(), +'gov' => array(), +'in' => array(), +'net' => array(), +'org' => array(), +'cherkassy' => array(), +'cherkasy' => array(), +'chernigov' => array(), +'chernihiv' => array(), +'chernivtsi' => array(), +'chernovtsy' => array(), +'ck' => array(), +'cn' => array(), +'cr' => array(), +'crimea' => array(), +'cv' => array(), +'dn' => array(), +'dnepropetrovsk' => array(), +'dnipropetrovsk' => array(), +'dominic' => array(), +'donetsk' => array(), +'dp' => array(), +'if' => array(), +'ivano-frankivsk' => array(), +'kh' => array(), +'kharkiv' => array(), +'kharkov' => array(), +'kherson' => array(), +'khmelnitskiy' => array(), +'khmelnytskyi' => array(), +'kiev' => array(), +'kirovograd' => array(), +'km' => array(), +'kr' => array(), +'krym' => array(), +'ks' => array(), +'kv' => array(), +'kyiv' => array(), +'lg' => array(), +'lt' => array(), +'lugansk' => array(), +'lutsk' => array(), +'lv' => array(), +'lviv' => array(), +'mk' => array(), +'mykolaiv' => array(), +'nikolaev' => array(), +'od' => array(), +'odesa' => array(), +'odessa' => array(), +'pl' => array(), +'poltava' => array(), +'rivne' => array(), +'rovno' => array(), +'rv' => array(), +'sb' => array(), +'sebastopol' => array(), +'sevastopol' => array(), +'sm' => array(), +'sumy' => array(), +'te' => array(), +'ternopil' => array(), +'uz' => array(), +'uzhgorod' => array(), +'vinnica' => array(), +'vinnytsia' => array(), +'vn' => array(), +'volyn' => array(), +'yalta' => array(), +'zaporizhzhe' => array(), +'zaporizhzhia' => array(), +'zhitomir' => array(), +'zhytomyr' => array(), +'zp' => array(), +'zt' => array(), +'co' => array(), +'pp' => array()), +'ug' => array('co' => array(), +'or' => array(), +'ac' => array(), +'sc' => array(), +'go' => array(), +'ne' => array(), +'com' => array(), +'org' => array()), +'uk' => array('ac' => array(), +'co' => array('blogspot' => array()), +'gov' => array('service' => array()), +'ltd' => array(), +'me' => array(), +'net' => array(), +'nhs' => array(), +'org' => array(), +'plc' => array(), +'police' => array(), +'sch' => array('*' => array())), +'us' => array('dni' => array(), +'fed' => array(), +'isa' => array(), +'kids' => array(), +'nsn' => array(), +'ak' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'al' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ar' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'as' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'az' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ca' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'co' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ct' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'dc' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'de' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'fl' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ga' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'gu' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'hi' => array('cc' => array(), +'lib' => array()), +'ia' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'id' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'il' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'in' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ks' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ky' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'la' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ma' => array('k12' => array('pvt' => array(), +'chtr' => array(), +'paroch' => array()), +'cc' => array(), +'lib' => array()), +'md' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'me' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'mi' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'mn' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'mo' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ms' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'mt' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'nc' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'nd' => array('cc' => array(), +'lib' => array()), +'ne' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'nh' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'nj' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'nm' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'nv' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ny' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'oh' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ok' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'or' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'pa' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'pr' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ri' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'sc' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'sd' => array('cc' => array(), +'lib' => array()), +'tn' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'tx' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'ut' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'vi' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'vt' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'va' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'wa' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'wi' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'wv' => array('cc' => array()), +'wy' => array('k12' => array(), +'cc' => array(), +'lib' => array()), +'is-by' => array(), +'land-4-sale' => array(), +'stuff-4-sale' => array()), +'uy' => array('com' => array(), +'edu' => array(), +'gub' => array(), +'mil' => array(), +'net' => array(), +'org' => array()), +'uz' => array('co' => array(), +'com' => array(), +'net' => array(), +'org' => array()), +'va' => array(), +'vc' => array('com' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'mil' => array(), +'edu' => array()), +'ve' => array('arts' => array(), +'co' => array(), +'com' => array(), +'e12' => array(), +'edu' => array(), +'firm' => array(), +'gob' => array(), +'gov' => array(), +'info' => array(), +'int' => array(), +'mil' => array(), +'net' => array(), +'org' => array(), +'rec' => array(), +'store' => array(), +'tec' => array(), +'web' => array()), +'vg' => array(), +'vi' => array('co' => array(), +'com' => array(), +'k12' => array(), +'net' => array(), +'org' => array()), +'vn' => array('com' => array(), +'net' => array(), +'org' => array(), +'edu' => array(), +'gov' => array(), +'int' => array(), +'ac' => array(), +'biz' => array(), +'info' => array(), +'name' => array(), +'pro' => array(), +'health' => array()), +'vu' => array('com' => array(), +'edu' => array(), +'net' => array(), +'org' => array()), +'wf' => array(), +'ws' => array('com' => array(), +'net' => array(), +'org' => array(), +'gov' => array(), +'edu' => array(), +'dyndns' => array(), +'mypets' => array()), +'yt' => array(), +'امارات' => array(), +'বাংলা' => array(), +'中国' => array(), +'中國' => array(), +'الجزائر' => array(), +'مصر' => array(), +'გე' => array(), +'香港' => array(), +'भारत' => array(), +'بھارت' => array(), +'భారత్' => array(), +'ભારત' => array(), +'ਭਾਰਤ' => array(), +'ভারত' => array(), +'இந்தியா' => array(), +'ایران' => array(), +'ايران' => array(), +'الاردن' => array(), +'한국' => array(), +'қаз' => array(), +'ලංකා' => array(), +'இலங்கை' => array(), +'المغرب' => array(), +'мон' => array(), +'مليسيا' => array(), +'عمان' => array(), +'فلسطين' => array(), +'срб' => array('пр' => array(), +'орг' => array(), +'обр' => array(), +'од' => array(), +'упр' => array(), +'ак' => array()), +'рф' => array(), +'قطر' => array(), +'السعودية' => array(), +'السعودیة' => array(), +'السعودیۃ' => array(), +'السعوديه' => array(), +'سورية' => array(), +'سوريا' => array(), +'新加坡' => array(), +'சிங்கப்பூர்' => array(), +'ไทย' => array(), +'تونس' => array(), +'台灣' => array(), +'台湾' => array(), +'臺灣' => array(), +'укр' => array(), +'اليمن' => array(), +'xxx' => array(), +'ye' => array('*' => array()), +'za' => array('*' => array()), +'zm' => array('*' => array()), +'zw' => array('*' => array()), +'abbott' => array(), +'abogado' => array(), +'academy' => array(), +'accenture' => array(), +'accountants' => array(), +'active' => array(), +'actor' => array(), +'africa' => array(), +'agency' => array(), +'airforce' => array(), +'allfinanz' => array(), +'alsace' => array(), +'amsterdam' => array(), +'android' => array(), +'aquarelle' => array(), +'archi' => array(), +'army' => array(), +'associates' => array(), +'attorney' => array(), +'auction' => array(), +'audio' => array(), +'autos' => array(), +'axa' => array(), +'band' => array(), +'bar' => array(), +'barcelona' => array(), +'bargains' => array(), +'bauhaus' => array(), +'bayern' => array(), +'bcn' => array(), +'beer' => array(), +'berlin' => array(), +'best' => array(), +'bharti' => array(), +'bible' => array(), +'bid' => array(), +'bike' => array(), +'bio' => array(), +'black' => array(), +'blackfriday' => array(), +'bloomberg' => array(), +'blue' => array(), +'bmw' => array(), +'bnl' => array(), +'bnpparibas' => array(), +'bond' => array(), +'boo' => array(), +'boutique' => array(), +'brussels' => array(), +'budapest' => array(), +'build' => array(), +'builders' => array(), +'business' => array(), +'buzz' => array(), +'bzh' => array(), +'cab' => array(), +'cal' => array(), +'camera' => array(), +'camp' => array(), +'cancerresearch' => array(), +'capetown' => array(), +'capital' => array(), +'caravan' => array(), +'cards' => array(), +'care' => array(), +'career' => array(), +'careers' => array(), +'cartier' => array(), +'casa' => array(), +'cash' => array(), +'catering' => array(), +'cba' => array(), +'cbn' => array(), +'center' => array(), +'ceo' => array(), +'cern' => array(), +'cfa' => array(), +'channel' => array(), +'cheap' => array(), +'christmas' => array(), +'chrome' => array(), +'church' => array(), +'citic' => array(), +'city' => array(), +'claims' => array(), +'cleaning' => array(), +'click' => array(), +'clinic' => array(), +'clothing' => array(), +'club' => array(), +'codes' => array(), +'coffee' => array(), +'college' => array(), +'cologne' => array(), +'commbank' => array(), +'community' => array(), +'company' => array(), +'computer' => array(), +'condos' => array(), +'construction' => array(), +'consulting' => array(), +'contractors' => array(), +'cooking' => array(), +'cool' => array(), +'country' => array(), +'credit' => array(), +'creditcard' => array(), +'crs' => array(), +'cruises' => array(), +'cuisinella' => array(), +'cymru' => array(), +'dabur' => array(), +'dad' => array(), +'dance' => array(), +'dating' => array(), +'datsun' => array(), +'day' => array(), +'deals' => array(), +'degree' => array(), +'democrat' => array(), +'dental' => array(), +'dentist' => array(), +'desi' => array(), +'diamonds' => array(), +'diet' => array(), +'digital' => array(), +'direct' => array(), +'directory' => array(), +'discount' => array(), +'dnp' => array(), +'domains' => array(), +'doosan' => array(), +'durban' => array(), +'dvag' => array(), +'eat' => array(), +'education' => array(), +'email' => array(), +'emerck' => array(), +'engineer' => array(), +'engineering' => array(), +'enterprises' => array(), +'equipment' => array(), +'erni' => array(), +'esq' => array(), +'estate' => array(), +'eurovision' => array(), +'eus' => array(), +'events' => array(), +'everbank' => array(), +'exchange' => array(), +'expert' => array(), +'exposed' => array(), +'fail' => array(), +'fan' => array(), +'farm' => array(), +'fashion' => array(), +'feedback' => array(), +'finance' => array(), +'financial' => array(), +'firmdale' => array(), +'fish' => array(), +'fishing' => array(), +'fitness' => array(), +'flights' => array(), +'florist' => array(), +'flsmidth' => array(), +'fly' => array(), +'foo' => array(), +'forsale' => array(), +'foundation' => array(), +'frl' => array(), +'frogans' => array(), +'fund' => array(), +'furniture' => array(), +'futbol' => array(), +'gal' => array(), +'gallery' => array(), +'garden' => array(), +'gbiz' => array(), +'gdn' => array(), +'gent' => array(), +'ggee' => array(), +'gift' => array(), +'gifts' => array(), +'gives' => array(), +'glass' => array(), +'gle' => array(), +'global' => array(), +'globo' => array(), +'gmail' => array(), +'gmo' => array(), +'gmx' => array(), +'google' => array(), +'gop' => array(), +'graphics' => array(), +'gratis' => array(), +'green' => array(), +'gripe' => array(), +'group' => array(), +'guge' => array(), +'guide' => array(), +'guitars' => array(), +'guru' => array(), +'hamburg' => array(), +'haus' => array(), +'healthcare' => array(), +'help' => array(), +'here' => array(), +'hermes' => array(), +'hiphop' => array(), +'hiv' => array(), +'holdings' => array(), +'holiday' => array(), +'homes' => array(), +'horse' => array(), +'host' => array(), +'hosting' => array(), +'house' => array(), +'how' => array(), +'ibm' => array(), +'ifm' => array(), +'iinet' => array(), +'immo' => array(), +'immobilien' => array(), +'industries' => array(), +'infiniti' => array(), +'ing' => array(), +'ink' => array(), +'institute' => array(), +'insure' => array(), +'international' => array(), +'investments' => array(), +'ipiranga' => array(), +'irish' => array(), +'ist' => array(), +'istanbul' => array(), +'iwc' => array(), +'java' => array(), +'jetzt' => array(), +'joburg' => array(), +'juegos' => array(), +'kaufen' => array(), +'kim' => array(), +'kitchen' => array(), +'kiwi' => array(), +'koeln' => array(), +'krd' => array(), +'kred' => array(), +'lacaixa' => array(), +'land' => array(), +'latrobe' => array(), +'lawyer' => array(), +'lds' => array(), +'lease' => array(), +'leclerc' => array(), +'lgbt' => array(), +'life' => array(), +'lighting' => array(), +'limited' => array(), +'limo' => array(), +'link' => array(), +'loans' => array(), +'london' => array(), +'lotto' => array(), +'ltda' => array(), +'luxe' => array(), +'luxury' => array(), +'madrid' => array(), +'maison' => array(), +'management' => array(), +'mango' => array(), +'market' => array(), +'marketing' => array(), +'media' => array(), +'meet' => array(), +'melbourne' => array(), +'meme' => array(), +'menu' => array(), +'miami' => array(), +'mini' => array(), +'moda' => array(), +'moe' => array(), +'monash' => array(), +'montblanc' => array(), +'mormon' => array(), +'mortgage' => array(), +'moscow' => array(), +'motorcycles' => array(), +'mov' => array(), +'nagoya' => array(), +'navy' => array(), +'netbank' => array(), +'network' => array(), +'neustar' => array(), +'new' => array(), +'nexus' => array(), +'ngo' => array(), +'nhk' => array(), +'ninja' => array(), +'nissan' => array(), +'nra' => array(), +'nrw' => array(), +'nyc' => array(), +'okinawa' => array(), +'ong' => array(), +'onl' => array(), +'ooo' => array(), +'oracle' => array(), +'organic' => array(), +'otsuka' => array(), +'ovh' => array(), +'paris' => array(), +'partners' => array(), +'parts' => array(), +'pharmacy' => array(), +'photo' => array(), +'photography' => array(), +'photos' => array(), +'physio' => array(), +'pics' => array(), +'pictet' => array(), +'pictures' => array(), +'pink' => array(), +'pizza' => array(), +'place' => array(), +'plumbing' => array(), +'pohl' => array(), +'poker' => array(), +'praxi' => array(), +'press' => array(), +'prod' => array(), +'productions' => array(), +'prof' => array(), +'properties' => array(), +'property' => array(), +'pub' => array(), +'qpon' => array(), +'quebec' => array(), +'realtor' => array(), +'recipes' => array(), +'red' => array(), +'rehab' => array(), +'reise' => array(), +'reisen' => array(), +'ren' => array(), +'rentals' => array(), +'repair' => array(), +'report' => array(), +'republican' => array(), +'rest' => array(), +'restaurant' => array(), +'reviews' => array(), +'rich' => array(), +'rio' => array(), +'rip' => array(), +'rocks' => array(), +'rodeo' => array(), +'rsvp' => array(), +'ruhr' => array(), +'ryukyu' => array(), +'saarland' => array(), +'samsung' => array(), +'sap' => array(), +'sarl' => array(), +'sca' => array(), +'scb' => array(), +'schmidt' => array(), +'scholarships' => array(), +'schule' => array(), +'scot' => array(), +'seat' => array(), +'services' => array(), +'sew' => array(), +'sexy' => array(), +'sharp' => array(), +'shiksha' => array(), +'shoes' => array(), +'shriram' => array(), +'singles' => array(), +'sky' => array(), +'social' => array(), +'software' => array(), +'sohu' => array(), +'solar' => array(), +'solutions' => array(), +'soy' => array(), +'space' => array(), +'spiegel' => array(), +'supplies' => array(), +'supply' => array(), +'support' => array(), +'surf' => array(), +'surgery' => array(), +'suzuki' => array(), +'systems' => array(), +'taipei' => array(), +'tatar' => array(), +'tattoo' => array(), +'tax' => array(), +'technology' => array(), +'temasek' => array(), +'tienda' => array(), +'tips' => array(), +'tirol' => array(), +'today' => array(), +'tokyo' => array(), +'tools' => array(), +'top' => array(), +'toshiba' => array(), +'town' => array(), +'toys' => array(), +'trade' => array(), +'training' => array(), +'tui' => array(), +'university' => array(), +'uno' => array(), +'uol' => array(), +'vacations' => array(), +'vegas' => array(), +'ventures' => array(), +'versicherung' => array(), +'vet' => array(), +'viajes' => array(), +'villas' => array(), +'vision' => array(), +'vlaanderen' => array(), +'vodka' => array(), +'vote' => array(), +'voting' => array(), +'voto' => array(), +'voyage' => array(), +'wales' => array(), +'wang' => array(), +'watch' => array(), +'webcam' => array(), +'website' => array(), +'wed' => array(), +'wedding' => array(), +'whoswho' => array(), +'wien' => array(), +'wiki' => array(), +'williamhill' => array(), +'wme' => array(), +'work' => array(), +'works' => array(), +'world' => array(), +'wtc' => array(), +'wtf' => array(), +'佛山' => array(), +'慈善' => array(), +'集团' => array(), +'在线' => array(), +'八卦' => array(), +'موقع' => array(), +'公益' => array(), +'公司' => array(), +'移动' => array(), +'我爱你' => array(), +'москва' => array(), +'онлайн' => array(), +'сайт' => array(), +'时尚' => array(), +'淡马锡' => array(), +'орг' => array(), +'삼성' => array(), +'商标' => array(), +'商店' => array(), +'商城' => array(), +'дети' => array(), +'新闻' => array(), +'中文网' => array(), +'中信' => array(), +'娱乐' => array(), +'谷歌' => array(), +'网店' => array(), +'संगठन' => array(), +'网络' => array(), +'手机' => array(), +'بازار' => array(), +'政府' => array(), +'شبكة' => array(), +'机构' => array(), +'组织机构' => array(), +'рус' => array(), +'みんな' => array(), +'グーグル' => array(), +'世界' => array(), +'网址' => array(), +'游戏' => array(), +'vermögensberater' => array(), +'vermögensberatung' => array(), +'企业' => array(), +'广东' => array(), +'政务' => array(), +'xyz' => array(), +'yachts' => array(), +'yandex' => array(), +'yoga' => array(), +'yokohama' => array(), +'youtube' => array(), +'zip' => array(), +'zone' => array()); diff --git a/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/regDomain.class.php b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/regDomain.class.php new file mode 100644 index 0000000..ffe492e --- /dev/null +++ b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/regDomain.class.php @@ -0,0 +1,120 @@ + + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to you under the Apache License, Version 2.0 + * (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at: + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * + * Florian Sager, 25.07.2008, sager@agitos.de, http://www.agitos.de + */ + +/* + * Remove subdomains from a signing domain to get the registered domain. + * + * dkim-reputation.org blocks signing domains on the level of registered domains + * to rate senders who use e.g. a.spamdomain.tld, b.spamdomain.tld, ... under + * the most common identifier - the registered domain - finally. + * + * This function returns NULL if $signingDomain is TLD itself + * + * $signingDomain has to be provided lowercase (!) + */ + +class regDomain { + /* tld tree */ + protected $tldTree = array(); + + /* main function */ + public function getRegisteredDomain($signingDomain, $fallback = TRUE) { + $signingDomainParts = explode('.', $signingDomain); + + $result = $this->findRegisteredDomain($signingDomainParts, $this->tldTree); + + if ($result===NULL || $result=="") { + // this is an invalid domain name + return NULL; + } + + // assure there is at least 1 TLD in the stripped signing domain + if (!strpos($result, '.')) { + if ($fallback===FALSE) { + return NULL; + } + $cnt = count($signingDomainParts); + if ($cnt==1 || $signingDomainParts[$cnt-2]=="") return NULL; + if (!$this->validDomainPart($signingDomainParts[$cnt-2]) || !$this->validDomainPart($signingDomainParts[$cnt-1])) return NULL; + return $signingDomainParts[$cnt-2].'.'.$signingDomainParts[$cnt-1]; + } + return $result; + } + + /* validate parts */ + public function validDomainPart($domPart) { + // see http://www.register.com/domain-extension-rules.rcmx + $len = strlen($domPart); + + // not more than 63 characters + if ($len>63) return FALSE; + + // not less than 1 characters --> there are TLD-specific rules that could be considered additionally + if ($len<1) return FALSE; + + // Use only letters, numbers, or hyphen ("-") + // not beginning or ending with a hypen (this is TLD specific, be aware!) + if (!preg_match("/^([a-z0-9])(([a-z0-9-])*([a-z0-9]))*$/", $domPart)) return FALSE; + + return TRUE; + } + + /* recursive helper method */ + public function findRegisteredDomain($remainingSigningDomainParts, &$treeNode) { + $sub = array_pop($remainingSigningDomainParts); + + $result = NULL; + if (isset($treeNode['!'])) { + return '#'; + } + + if (!$this->validDomainPart($sub)) { + return NULL; + } + + if (is_array($treeNode) && array_key_exists($sub, $treeNode)) { + $result = $this->findRegisteredDomain($remainingSigningDomainParts, $treeNode[$sub]); + } else if (is_array($treeNode) && array_key_exists('*', $treeNode)) { + $result = $this->findRegisteredDomain($remainingSigningDomainParts, $treeNode['*']); + } else { + return $sub; + } + + // this is a hack 'cause PHP interpretes '' as NULL + if ($result == '#') { + return $sub; + } else if (strlen($result)>0) { + return $result.'.'.$sub; + } + return NULL; + } + + /* load tld tree into object */ + function __construct() { + /* include tld tree data */ + include(dirname(__FILE__) . '/effectiveTLDs.inc.php'); + } + +} diff --git a/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/regDomain.inc.php b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/regDomain.inc.php new file mode 100644 index 0000000..e6b7a2a --- /dev/null +++ b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/regDomain.inc.php @@ -0,0 +1,62 @@ + + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to you under the Apache License, Version 2.0 + * (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at: + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * + * Florian Sager, 25.07.2008, sager@agitos.de, http://www.agitos.de + */ + +/* + * Remove subdomains from a signing domain to get the registered domain. + * + * dkim-reputation.org blocks signing domains on the level of registered domains + * to rate senders who use e.g. a.spamdomain.tld, b.spamdomain.tld, ... under + * the most common identifier - the registered domain - finally. + * + * This function returns NULL if $signingDomain is TLD itself + * + * $signingDomain has to be provided lowercase (!) + */ + +/* pull in class */ +require_once (dirname ( __FILE__ ) . '/regDomain.class.php'); + +/* create global object */ +; +function getRegisteredDomain($signingDomain, $fallback = TRUE) { + /* pull in object */ + $regDomainObj = new regDomain (); + /* return object method */ + return $regDomainObj->getRegisteredDomain ( $signingDomain, $fallback ); +} +function validDomainPart($domPart) { + /* pull in object */ + $regDomainObj = new regDomain (); + /* return object method */ + return $regDomainObj->validDomainPart ( $domPart ); +} + +// recursive helper method +function findRegisteredDomain($remainingSigningDomainParts, &$treeNode) { + /* pull in object */ + $regDomainObj = new regDomain (); + /* return object method */ + return $regDomainObj->findRegisteredDomain ( $remainingSigningDomainParts, $treeNode ); +} diff --git a/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/test-regDomain.php b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/test-regDomain.php new file mode 100644 index 0000000..d1cc47c --- /dev/null +++ b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/PHP/test-regDomain.php @@ -0,0 +1,51 @@ + + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to you under the Apache License, Version 2.0 + * (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at: + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + * + * Florian Sager, 25.07.2008, sager@agitos.de, http://www.agitos.de + */ + +require_once("effectiveTLDs.inc.php"); +require_once("regDomain.inc.php"); + +if ($_SERVER["argc"]<2) { + print("test-regDomain.php <(fully-qualified-domain-name )+>\n"); + exit; +} + +// strip subdomains from every signing domain +// char dom[] = "sub2.sub.registered.nom.ad"; + +$argc = $_SERVER["argc"]; +$argv = $_SERVER["argv"]; + +for ($i=1; $i<$argc; $i++) { + + $registeredDomain = getRegisteredDomain($argv[$i], $tldTree); + + if ( $registeredDomain === NULL ) { + printf("error: %s\n", $argv[$i]); + } else { + printf("%s\n", $registeredDomain); + } +} + +?> diff --git a/Postman/Postman-Connectivity-Test/registered-domain-libs-master/README.txt b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/README.txt new file mode 100644 index 0000000..9199c9f --- /dev/null +++ b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/README.txt @@ -0,0 +1,56 @@ +=============================================== +Detection of registered domains by reg-dom libs +=============================================== + +The reg-dom libs are available in C, Perl and PHP so far. + +They include recent representations of the effective TLD list available at +http://mxr.mozilla.org/mozilla-central/source/netwerk/dns/effective_tld_names.dat?raw=1 +and help to convert an arbitrary domain name to the registered domain name. + +Sample use: +dkim-reputation.org blocks signing domains on the level of registered domains +to rate senders who use e.g. a.spamdomain.tld, b.spamdomain.tld, ... under +the most common identifier - the registered domain - finally. +Project page: http://www.dkim-reputation.org/regdom-libs/ + +Pseudo code: +registeredDomain = getRegisteredDomain(ingoingDomain); + +Return values: +1) NULL if ingoingDomain is a TLD +2) the registered domain name if TLD is known +3) just . if is unknown + This case was added to support new TLDs in outdated reg-dom libs + by a certain likelihood. This fallback method is implemented in the + last conversion step and can be simply commented out. + +--- + +If you like to regenerate the effective TLD tree structure by yourself +you can use the script generateEffectiveTLDs.php with the following parameters: + +php generateEffectiveTLDs.php php > PHP/effectiveTLDs.inc.php +php generateEffectiveTLDs.php perl > Perl/effectiveTLDs.pm +php generateEffectiveTLDs.php c > C/tld-canon.h + + + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to you under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + + +Florian Sager, 2009-02-05, sager@agitos.de, http://www.agitos.de diff --git a/Postman/Postman-Connectivity-Test/registered-domain-libs-master/generateEffectiveTLDs.php b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/generateEffectiveTLDs.php new file mode 100644 index 0000000..63acb79 --- /dev/null +++ b/Postman/Postman-Connectivity-Test/registered-domain-libs-master/generateEffectiveTLDs.php @@ -0,0 +1,213 @@ +1) { + if ($_SERVER['argv'][1] == "perl") { + $format = "perl"; + } else if ($_SERVER['argv'][1] == "c") { + $format = "c"; + } +} + +/* + * Does $search start with $startstring? + */ +function startsWith($search, $startstring) { + return (substr($search, 0, strlen($startstring))==$startstring); +} + +/* + * Does $search end with $endstring? + */ +function endsWith($search, $endstring) { + return (substr($search, -strlen($endstring))==$endstring); +} + + +function buildSubdomain(&$node, $tldParts) { + + $dom = trim(array_pop($tldParts)); + + $isNotDomain = FALSE; + if (startsWith($dom, "!")) { + $dom = substr($dom, 1); + $isNotDomain = TRUE; + } + + if (!array_key_exists($dom, $node)) { + if ($isNotDomain) { + $node[$dom] = array("!" => ""); + } else { + $node[$dom] = array(); + } + } + + if (!$isNotDomain && count($tldParts)>0) { + buildSubdomain($node[$dom], $tldParts); + } +} + +function printNode($key, $valueTree, $isAssignment = false) { + + global $format; + + if ($isAssignment) { + if ($format == "perl") { + echo "$key = {"; + } else { + echo "$key = array("; + } + } else { + if (strcmp($key, "!")==0) { + if ($format == "perl") { + echo "'!' => {}"; + } else { + echo "'!' => ''"; + } + return; + } else { + if ($format == "perl") { + echo "'$key' => {"; + } else { + echo "'$key' => array("; + } + } + } + + $keys = array_keys($valueTree); + + for ($i=0; $i0) { + + if (strcmp($keys['!'], "!")==0) { + echo "!"; + } else { + + echo "(".count($keys).":"; + + for ($i=0; $i0) { + printNode_C($key, $valueTree[$key]); + // } + + if ($i+1 != count($valueTree)) { + echo ","; + } + } + + echo ')'; + } + } +} + +// --- main --- + +error_reporting(E_ERROR); + +$tldTree = array(); +$list = file_get_contents(URL); +// $list = "bg\na.bg\n0.bg\n!c.bg\n"; +$lines = explode("\n", $list); +$licence = TRUE; + +if ($format == "php") echo " array(), // test.agitos.de --> agitos.de + 'uk' => array( + 'co' => array(), // test.agitos.co.uk --> agitos.co.uk + 'xy' => array('!'), // test.agitos.xy.uk --> xy.uk + '*' => array() // test.agitos.ab.uk --> agitos.ab.uk + ) +); +*/ + +if ($format == "c") { + + echo "static const char tldString[] = \""; + printNode_C("root", $tldTree); + echo "\";\n\n"; + +} else { + + if ($format == "perl") { + print "package effectiveTLDs;\n\n"; + } + printNode("\$tldTree", $tldTree, TRUE); + echo ";\n"; + if ($format == "php") echo '?>' . "\n"; + +} + +?> diff --git a/Postman/Postman-Controller/PostmanAdminPointer.php b/Postman/Postman-Controller/PostmanAdminPointer.php new file mode 100644 index 0000000..a05376b --- /dev/null +++ b/Postman/Postman-Controller/PostmanAdminPointer.php @@ -0,0 +1,111 @@ +logger = new PostmanLogger ( get_class ( $this ) ); + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + + // Don't run on WP < 3.3 + if (get_bloginfo ( 'version' ) < '3.3' || true) + return; + + add_action ( 'admin_enqueue_scripts', array ( + $this, + 'wptuts_pointer_load' + ), 1000 ); + add_filter ( 'postman_admin_pointers-settings_page_postman', array ( + $this, + 'wptuts_register_pointer_testing' + ) ); + } + + /** + * + * @param mixed $hook_suffix + */ + function wptuts_pointer_load($hook_suffix) { + // only do this for administrators + if (PostmanUtils::isAdmin ()) { + $this->logger->trace ( 'wptuts' ); + + $screen = get_current_screen (); + $screen_id = $screen->id; + + // Get pointers for this screen + $pointers = apply_filters ( 'postman_admin_pointers-' . $screen_id, array () ); + + if (! $pointers || ! is_array ( $pointers )) + return; + + // Get dismissed pointers + $dismissed = explode ( ',', ( string ) get_user_meta ( get_current_user_id (), 'dismissed_wp_pointers', true ) ); + $this->logger->trace ( $dismissed ); + $valid_pointers = array (); + + // Check pointers and remove dismissed ones. + foreach ( $pointers as $pointer_id => $pointer ) { + + // Sanity check + if (in_array ( $pointer_id, $dismissed ) || empty ( $pointer ) || empty ( $pointer_id ) || empty ( $pointer ['target'] ) || empty ( $pointer ['options'] )) + continue; + + $pointer ['pointer_id'] = $pointer_id; + + // Add the pointer to $valid_pointers array + $valid_pointers ['pointers'] [] = $pointer; + } + + // No valid pointers? Stop here. + if (empty ( $valid_pointers )) { + return; + } + + // Add pointers style to queue. + wp_enqueue_style ( 'wp-pointer' ); + + // Add pointers script to queue. Add custom script. + wp_enqueue_script ( 'postman_admin_pointer', plugins_url ( 'script/postman-admin-pointer.js', $this->rootPluginFilenameAndPath ), array ( + 'wp-pointer' + ) ); + + // Add pointer options to script. + wp_localize_script ( 'postman_admin_pointer', 'postman_admin_pointer', $valid_pointers ); + $this->logger->trace ( 'out wptuts' ); + } + } + function wptuts_register_pointer_testing($p) { + // only do this for administrators + if (PostmanUtils::isAdmin () && false) { + $p ['postman16_log'] = array ( + 'target' => '.configure_manually', + 'options' => array ( + 'content' => '', + 'position' => array ( + 'edge' => 'top', + 'align' => 'left' + ) + ) + ); + return $p; + } + } + } +} diff --git a/Postman/Postman-Controller/PostmanDashboardWidgetController.php b/Postman/Postman-Controller/PostmanDashboardWidgetController.php new file mode 100644 index 0000000..8f6bae6 --- /dev/null +++ b/Postman/Postman-Controller/PostmanDashboardWidgetController.php @@ -0,0 +1,161 @@ +rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->options = $options; + $this->authorizationToken = $authorizationToken; + $this->wpMailBinder = $binder; + + add_action ( 'wp_dashboard_setup', array ( + $this, + 'addDashboardWidget' + ) ); + + add_action ( 'wp_network_dashboard_setup', array ( + $this, + 'addNetworkDashboardWidget' + ) ); + + // dashboard glance mod + if ($this->options->isMailLoggingEnabled ()) { + add_filter ( 'dashboard_glance_items', array ( + $this, + 'customizeAtAGlanceDashboardWidget' + ), 10, 1 ); + } + + // Postman API: register the human-readable plugin state + add_filter ( 'print_postman_status', array ( + $this, + 'print_postman_status' + ) ); + } + + /** + * Add a widget to the dashboard. + * + * This function is hooked into the 'wp_dashboard_setup' action below. + */ + public function addDashboardWidget() { + // only display to the widget to administrator + if (PostmanUtils::isAdmin ()) { + wp_add_dashboard_widget ( 'example_dashboard_widget', __ ( 'Postman SMTP', 'post-smtp' ), array ( + $this, + 'printDashboardWidget' + ) ); // Display function. + } + } + + /** + * Add a widget to the network dashboard + */ + public function addNetworkDashboardWidget() { + // only display to the widget to administrator + if (PostmanUtils::isAdmin ()) { + wp_add_dashboard_widget ( 'example_dashboard_widget', __ ( 'Postman SMTP', 'post-smtp' ), array ( + $this, + 'printNetworkDashboardWidget' + ) ); // Display function. + } + } + + /** + * Create the function to output the contents of our Dashboard Widget. + */ + public function printDashboardWidget() { + $goToSettings = sprintf ( '%s', PostmanUtils::getSettingsPageUrl (), __ ( 'Settings', 'post-smtp' ) ); + $goToEmailLog = sprintf ( '%s', _x ( 'Email Log', 'The log of Emails that have been delivered', 'post-smtp' ) ); + if ($this->options->isMailLoggingEnabled ()) { + $goToEmailLog = sprintf ( '%s', PostmanUtils::getEmailLogPageUrl (), $goToEmailLog ); + } + apply_filters ( 'print_postman_status', null ); + printf ( '

    %s | %s

    ', $goToEmailLog, $goToSettings ); + } + + /** + * Print the human-readable plugin state + */ + public function print_postman_status() { + if (! PostmanPreRequisitesCheck::isReady ()) { + printf ( '

    %s

    ', __ ( 'Error: Postman is missing a required PHP library.', 'post-smtp' ) ); + } else if ($this->wpMailBinder->isUnboundDueToException ()) { + printf ( '

    %s

    ', __ ( 'Postman: wp_mail has been declared by another plugin or theme, so you won\'t be able to use Postman until the conflict is resolved.', 'post-smtp' ) ); + } else { + if ($this->options->getRunMode () != PostmanOptions::RUN_MODE_PRODUCTION) { + printf ( '

    %s

    ', __ ( 'Postman is in non-Production mode and is dumping all emails.', 'post-smtp' ) ); + } else if (PostmanTransportRegistry::getInstance ()->getSelectedTransport ()->isConfiguredAndReady ()) { + printf ( '

    %s

    ', sprintf ( _n ( 'Postman is configured and has delivered %d email.', 'Postman is configured and has delivered %d emails.', PostmanState::getInstance ()->getSuccessfulDeliveries (), 'post-smtp' ), PostmanState::getInstance ()->getSuccessfulDeliveries () ) ); + } else { + printf ( '

    %s

    ', __ ( 'Postman is not configured and is mimicking out-of-the-box WordPress email delivery.', 'post-smtp' ) ); + } + $currentTransport = PostmanTransportRegistry::getInstance ()->getActiveTransport (); + $deliveryDetails = $currentTransport->getDeliveryDetails ( $this->options ); + printf ( '

    %s

    ', $deliveryDetails ); + } + } + + /** + * Create the function to output the contents of our Dashboard Widget. + */ + public function printNetworkDashboardWidget() { + printf ( '

    %s

    ', __ ( 'Postman is operating in per-site mode.', 'post-smtp' ) ); + } + + /** + * From http://www.hughlashbrooke.com/2014/02/wordpress-add-items-glance-widget/ + * http://coffeecupweb.com/how-to-add-custom-post-types-to-at-a-glance-dashboard-widget-in-wordpress/ + * + * @param mixed $items + * @return string + */ + function customizeAtAGlanceDashboardWidget($items = array()) { + // only modify the At-a-Glance for administrators + if (PostmanUtils::isAdmin ()) { + $post_types = array ( + PostmanEmailLogPostType::POSTMAN_CUSTOM_POST_TYPE_SLUG + ); + + foreach ( $post_types as $type ) { + + if (! post_type_exists ( $type )) + continue; + + $num_posts = wp_count_posts ( $type ); + + if ($num_posts) { + + $published = intval ( $num_posts->publish ); + $privated = intval ( $num_posts->private ); + $post_type = get_post_type_object ( $type ); + + $text = _n ( '%s ' . $post_type->labels->singular_name, '%s ' . $post_type->labels->name, $privated, 'post-smtp' ); + $text = sprintf ( $text, number_format_i18n ( $privated ) ); + + $items [] = sprintf ( '%2$s', $type, $text, PostmanUtils::getEmailLogPageUrl () ) . "\n"; + } + } + + return $items; + } + } + } +} \ No newline at end of file diff --git a/Postman/Postman-Controller/PostmanManageConfigurationAjaxHandler.php b/Postman/Postman-Controller/PostmanManageConfigurationAjaxHandler.php new file mode 100644 index 0000000..82472c3 --- /dev/null +++ b/Postman/Postman-Controller/PostmanManageConfigurationAjaxHandler.php @@ -0,0 +1,59 @@ +hostname = $queryHostData ['hostname']; + $this->hostnameDomainOnly = $queryHostData ['hostname_domain_only']; + $this->port = $queryHostData ['port']; + $this->protocol = $queryHostData ['protocol']; + $this->secure = PostmanUtils::parseBoolean ( $queryHostData ['secure'] ); + $this->mitm = PostmanUtils::parseBoolean ( $queryHostData ['mitm'] ); + $this->reportedHostname = $queryHostData ['reported_hostname']; + $this->reportedHostnameDomainOnly = $queryHostData ['reported_hostname_domain_only']; + $this->message = $queryHostData ['message']; + $this->startTls = PostmanUtils::parseBoolean ( $queryHostData ['start_tls'] ); + $this->authPlain = PostmanUtils::parseBoolean ( $queryHostData ['auth_plain'] ); + $this->auth_login = PostmanUtils::parseBoolean ( $queryHostData ['auth_login'] ); + $this->auth_crammd5 = PostmanUtils::parseBoolean ( $queryHostData ['auth_crammd5'] ); + $this->auth_xoauth = PostmanUtils::parseBoolean ( $queryHostData ['auth_xoauth'] ); + $this->auth_none = PostmanUtils::parseBoolean ( $queryHostData ['auth_none'] ); + $this->try_smtps = PostmanUtils::parseBoolean ( $queryHostData ['try_smtps'] ); + $this->success = PostmanUtils::parseBoolean ( $queryHostData ['success'] ); + $this->transport = $queryHostData ['transport']; + assert ( ! empty ( $this->transport ) ); + $this->id = sprintf ( '%s_%s', $this->hostname, $this->port ); + } +} + diff --git a/Postman/Postman-Controller/PostmanWelcomeController.php b/Postman/Postman-Controller/PostmanWelcomeController.php new file mode 100644 index 0000000..e37d3e8 --- /dev/null +++ b/Postman/Postman-Controller/PostmanWelcomeController.php @@ -0,0 +1,222 @@ +rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->pluginUrl = plugins_url( 'style', $rootPluginFilenameAndPath ); + $this->version = PostmanState::getInstance()->getVersion(); + + add_action( 'admin_menu', array( $this, 'add_menus' ) ); + add_action( 'admin_head', array( $this, 'admin_head' ) ); + } + + public function add_menus() { + + if ( current_user_can( 'manage_options' ) ) { + + // About + add_dashboard_page( + __( 'Welcome', 'post-smtp' ), + __( 'Welcome', 'post-smtp' ), + 'manage_options', + 'post-about', + array( $this, 'about_screen' ) + ); + + // Credits + add_dashboard_page( + __( 'Credits', 'post-smtp' ), + __( 'Credits', 'post-smtp' ), + 'manage_options', + 'post-credits', + array( $this, 'credits_screen' ) + ); + + // add_action( 'admin_print_styles-' . $page, array( $this, 'postman_about_enqueue_resources' ) ); + } + } + + public function admin_head() { + remove_submenu_page( 'index.php', 'post-about' ); + remove_submenu_page( 'index.php', 'post-credits' ); + } + + public function postman_about_enqueue_resources() { + // wp_enqueue_style( 'font-awsome', '' ); + } + + + public function about_screen() { + ?> + +
    +

    version ); ?>

    +
    version ); ?>
    + %s','Post SMTP support every SMTP service: Gmail/G-suite, SendGrid, Mandrill, Office365, and more...' ); ?> +
    +
    version ); ?>
    + +

    + + + + + +

    + +
    +

    + +
    +
    +

    +

    + + +

    +
    + +
    +

    +

    + + +

    +
    +
    +
    + +
    +

    + +
    +
    +

    +
    +
    + +
    +
    +

    +

    +
    + +
    +

    +

    +
    + +
    +

    +

    +
    +
    +
    + +
    + +
    + +
    + + + +
    +

    version ); ?>

    +
    version ); ?>
    +
    version ); ?>
    + +

    + + + + + +

    + +

    + +

    + + +

    +
    +

    + diegocanal, + Johan Yourstone, + bodhirayo, + Neil Murray , + A place waiting for you? :-) +

    + +
    + +
    + +
    + + logger = new PostmanLogger( get_class( $this ) ); + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->options = PostmanOptions::getInstance(); + + // register the admin menu + PostmanUtils::registerAdminMenu( $this, 'addDiagnosticsSubmenu' ); + + // hook on the init event + add_action( 'init', array( + $this, + 'on_init', + ) ); + + // initialize the scripts, stylesheets and form fields + add_action( 'admin_init', array( + $this, + 'on_admin_init', + ) ); + } + + /** + * Functions to execute on the init event + * + * "Typically used by plugins to initialize. The current user is already authenticated by this time." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_a_Typical_Request + */ + public function on_init() { + // register Ajax handlers + new PostmanGetDiagnosticsViaAjax(); + } + + /** + * Fires on the admin_init method + */ + public function on_admin_init() { + $this->registerStylesAndScripts(); + } + + /** + * Register and add settings + */ + private function registerStylesAndScripts() { + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'registerStylesAndScripts()' ); + } + + // register the javascript resource + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + wp_register_script( 'postman_diagnostics_script', plugins_url( 'Postman/Postman-Diagnostic-Test/postman_diagnostics.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + PostmanViewController::POSTMAN_SCRIPT, + ), $pluginData ['version'] ); + } + + /** + * Register the Diagnostics screen + */ + public function addDiagnosticsSubmenu() { + $page = add_submenu_page( null, sprintf( __( '%s Setup', 'post-smtp' ), __( 'Postman SMTP', 'post-smtp' ) ), __( 'Postman SMTP', 'post-smtp' ), Postman::MANAGE_POSTMAN_CAPABILITY_NAME, PostmanDiagnosticTestController::DIAGNOSTICS_SLUG, array( + $this, + 'outputDiagnosticsContent', + ) ); + // When the plugin options page is loaded, also load the stylesheet + add_action( 'admin_print_styles-' . $page, array( + $this, + 'enqueueDiagnosticsScreenStylesheet', + ) ); + } + function enqueueDiagnosticsScreenStylesheet() { + wp_enqueue_style( PostmanViewController::POSTMAN_STYLE ); + wp_enqueue_script( 'postman_diagnostics_script' ); + } + + /** + */ + public function outputDiagnosticsContent() { + // test features + print '
    '; + + PostmanViewController::outputChildPageHeader( __( 'Diagnostic Test', 'post-smtp' ) ); + + ?> +
    + +
    + %s', __( 'Are you having issues with Postman?', 'post-smtp' ) ); + /* translators: where %1$s and %2$s are the URLs to the Troubleshooting and Support Forums on WordPress.org */ + printf( '

    %s

    ', sprintf( __( 'Please check the troubleshooting and error messages page and the support forum.', 'post-smtp' ), 'https://wordpress.org/plugins/post-smtp/other_notes/', 'https://wordpress.org/support/plugin/post-smtp' ) ); + printf( '

    %s

    ', __( 'Diagnostic Test', 'post-smtp' ) ); + printf( '

    %s


    ', sprintf( __( 'If you write for help, please include the following:', 'post-smtp' ), 'https://wordpress.org/plugins/post-smtp/other_notes/', 'https://wordpress.org/support/plugin/post-smtp' ) ); + printf( '', _x( 'Checking..', 'The "please wait" message', 'post-smtp' ) ); + print '
    '; + } +} + +/** + * + * @author jasonhendriks + */ +class PostmanGetDiagnosticsViaAjax { + private $diagnostics; + private $options; + private $authorizationToken; + /** + * Constructor + * + * @param PostmanOptions $options + */ + function __construct() { + $this->options = PostmanOptions::getInstance(); + $this->authorizationToken = PostmanOAuthToken::getInstance(); + $this->diagnostics = ''; + PostmanUtils::registerAjaxHandler( 'postman_diagnostics', $this, 'getDiagnostics' ); + } + private function addToDiagnostics( $header, $data ) { + if ( isset( $data ) ) { + $this->diagnostics .= sprintf( '%s: %s%s', $header, $data, PHP_EOL ); + } + } + private function getActivePlugins() { + // from http://stackoverflow.com/questions/20488264/how-do-i-get-activated-plugin-list-in-wordpress-plugin-development + $apl = get_option( 'active_plugins' ); + $plugins = get_plugins(); + $pluginText = array(); + foreach ( $apl as $p ) { + if ( isset( $plugins [ $p ] ) ) { + array_push( $pluginText, $plugins [ $p ] ['Name'] ); + } + } + return implode( ', ', $pluginText ); + } + private function getPhpDependencies() { + $apl = PostmanPreRequisitesCheck::getState(); + $pluginText = array(); + foreach ( $apl as $p ) { + array_push( $pluginText, $p ['name'] . '=' . ($p ['ready'] ? 'Yes' : 'No') ); + } + return implode( ', ', $pluginText ); + } + private function getTransports() { + $transports = ''; + foreach ( PostmanTransportRegistry::getInstance()->getTransports() as $transport ) { + $transports .= ' : ' . $transport->getName(); + } + return $transports; + } + + /** + * Diagnostic Data test to current SMTP server + * + * @return string + */ + private function testConnectivity( PostmanModuleTransport $transport ) { + $hostname = $transport->getHostname( $this->options ); + $port = $transport->getPort( $this->options ); + if ( ! empty( $hostname ) && ! empty( $port ) ) { + $portTest = new PostmanPortTest( $transport->getHostname( $this->options ), $transport->getPort( $this->options ) ); + $result = $portTest->genericConnectionTest( $this->options->getConnectionTimeout() ); + if ( $result ) { + return 'Yes'; + } else { + return 'No'; + } + } + return 'n/a'; + } + + /** + * Inspects the $wp_filter variable and returns the plugins attached to it + * From: http://stackoverflow.com/questions/5224209/wordpress-how-do-i-get-all-the-registered-functions-for-the-content-filter + */ + private function getFilters( $hook = '' ) { + global $wp_filter; + if ( empty( $hook ) || ! isset( $wp_filter [ $hook ] ) ) { + return null; } + $functionArray = array(); + foreach ( $wp_filter [ $hook ] as $functions ) { + foreach ( $functions as $function ) { + $thing = $function ['function']; + if ( is_array( $thing ) ) { + $name = get_class( $thing [0] ) . '->' . $thing [1]; + array_push( $functionArray, $name ); + } else { + array_push( $functionArray, $thing ); + } + } + } + return implode( ', ', $functionArray ); + } + + /** + */ + public function getDiagnostics() { + + check_admin_referer('post-smtp', 'security'); + + $curl = curl_version(); + $transportRegistry = PostmanTransportRegistry::getInstance(); + $this->addToDiagnostics( 'Mailer', PostmanOptions::getInstance()->getSmtpMailer() ); + $this->addToDiagnostics( 'HostName', PostmanUtils::getServerName() ); + $this->addToDiagnostics( 'cURL Version', $curl['version'] ); + $this->addToDiagnostics( 'OpenSSL Version', $curl['ssl_version'] ); + $this->addToDiagnostics( 'OS', php_uname() ); + $this->addToDiagnostics( 'PHP', PHP_OS . ' ' . PHP_VERSION . ' ' . setlocale( LC_CTYPE, 0 ) ); + $this->addToDiagnostics( 'PHP Dependencies', $this->getPhpDependencies() ); + $this->addToDiagnostics( 'WordPress', (is_multisite() ? 'Multisite ' : '') . get_bloginfo( 'version' ) . ' ' . get_locale() . ' ' . get_bloginfo( 'charset', 'display' ) ); + $this->addToDiagnostics( 'WordPress Theme', wp_get_theme() ); + $this->addToDiagnostics( 'WordPress Plugins', $this->getActivePlugins() ); + + $bindResult = apply_filters( 'postman_wp_mail_bind_status', null ); + $wp_mail_file_name = 'n/a'; + if ( class_exists( 'ReflectionFunction' ) ) { + $wp_mail = new ReflectionFunction( 'wp_mail' ); + $wp_mail_file_name = realpath( $wp_mail->getFileName() ); + } + + $this->addToDiagnostics( 'WordPress wp_mail Owner', $wp_mail_file_name ); + $this->addToDiagnostics( 'WordPress wp_mail Filter(s)', $this->getFilters( 'wp_mail' ) ); + $this->addToDiagnostics( 'WordPress wp_mail_from Filter(s)', $this->getFilters( 'wp_mail_from' ) ); + $this->addToDiagnostics( 'WordPress wp_mail_from_name Filter(s)', $this->getFilters( 'wp_mail_from_name' ) ); + $this->addToDiagnostics( 'WordPress wp_mail_content_type Filter(s)', $this->getFilters( 'wp_mail_content_type' ) ); + $this->addToDiagnostics( 'WordPress wp_mail_charset Filter(s)', $this->getFilters( 'wp_mail_charset' ) ); + $this->addToDiagnostics( 'WordPress phpmailer_init Action(s)', $this->getFilters( 'phpmailer_init' ) ); + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + $this->addToDiagnostics( 'Postman', $pluginData ['version'] ); + { + $s1 = $this->options->getEnvelopeSender(); + $s2 = $this->options->getMessageSenderEmail(); + if ( ! empty( $s1 ) || ! empty( $s2 ) ) { + $this->addToDiagnostics( 'Postman Sender Domain (Envelope|Message)', ($hostname = substr( strrchr( $this->options->getEnvelopeSender(), '@' ), 1 )) . ' | ' . ($hostname = substr( strrchr( $this->options->getMessageSenderEmail(), '@' ), 1 )) ); + } + } + $this->addToDiagnostics( 'Postman Prevent Message Sender Override (Email|Name)', ($this->options->isSenderEmailOverridePrevented() ? 'Yes' : 'No') . ' | ' . ($this->options->isSenderNameOverridePrevented() ? 'Yes' : 'No') ); + { + // status of the active transport + $transport = $transportRegistry->getActiveTransport(); + $this->addToDiagnostics( 'Postman Active Transport', sprintf( '%s (%s)', $transport->getName(), $transportRegistry->getPublicTransportUri( $transport ) ) ); + $this->addToDiagnostics( 'Postman Active Transport Status (Ready|Connected)', ($transport->isConfiguredAndReady() ? 'Yes' : 'No') . ' | ' . ($this->testConnectivity( $transport )) ); + } + if ( $transportRegistry->getActiveTransport() != $transportRegistry->getSelectedTransport() && $transportRegistry->getSelectedTransport() != null ) { + // status of the selected transport + $transport = $transportRegistry->getSelectedTransport(); + $this->addToDiagnostics( 'Postman Selected Transport', sprintf( '%s (%s)', $transport->getName(), $transportRegistry->getPublicTransportUri( $transport ) ) ); + $this->addToDiagnostics( 'Postman Selected Transport Status (Ready|Connected)', ($transport->isConfiguredAndReady() ? 'Yes' : 'No') . ' | ' . ($this->testConnectivity( $transport )) ); + } + $this->addToDiagnostics( 'Postman Deliveries (Success|Fail)', (PostmanState::getInstance()->getSuccessfulDeliveries()) . ' | ' . (PostmanState::getInstance()->getFailedDeliveries()) ); + if ( $this->options->getConnectionTimeout() != PostmanOptions::DEFAULT_TCP_CONNECTION_TIMEOUT || $this->options->getReadTimeout() != PostmanOptions::DEFAULT_TCP_READ_TIMEOUT ) { + $this->addToDiagnostics( 'Postman TCP Timeout (Connection|Read)', $this->options->getConnectionTimeout() . ' | ' . $this->options->getReadTimeout() ); + } + if ( $this->options->isMailLoggingEnabled() != PostmanOptions::DEFAULT_MAIL_LOG_ENABLED || $this->options->getMailLoggingMaxEntries() != PostmanOptions::DEFAULT_MAIL_LOG_ENTRIES || $this->options->getTranscriptSize() != PostmanOptions::DEFAULT_TRANSCRIPT_SIZE ) { + $this->addToDiagnostics( 'Postman Email Log (Enabled|Limit|Transcript Size)', ($this->options->isMailLoggingEnabled() ? 'Yes' : 'No') . ' | ' . $this->options->getMailLoggingMaxEntries() . ' | ' . $this->options->getTranscriptSize() ); + } + $this->addToDiagnostics( 'Postman Run Mode', $this->options->getRunMode() == PostmanOptions::RUN_MODE_PRODUCTION ? null : $this->options->getRunMode() ); + $this->addToDiagnostics( 'Postman PHP LogLevel', $this->options->getLogLevel() == PostmanLogger::ERROR_INT ? null : $this->options->getLogLevel() ); + $this->addToDiagnostics( 'Postman Stealth Mode', $this->options->isStealthModeEnabled() ? 'Yes' : null ); + $this->addToDiagnostics( 'Postman File Locking (Enabled|Temp Dir)', PostmanState::getInstance()->isFileLockingEnabled() ? null : 'No' . ' | ' . $this->options->getTempDirectory() ); + $response = array( + 'message' => $this->diagnostics, + ); + wp_send_json_success( $response ); + } +} diff --git a/Postman/Postman-Diagnostic-Test/postman_diagnostics.js b/Postman/Postman-Diagnostic-Test/postman_diagnostics.js new file mode 100644 index 0000000..140668e --- /dev/null +++ b/Postman/Postman-Diagnostic-Test/postman_diagnostics.js @@ -0,0 +1,19 @@ +jQuery(document).ready(function() { + getDiagnosticData(); +}); + +/** + */ +function getDiagnosticData() { + var data = { + 'action' : 'postman_diagnostics', + 'security' : jQuery('#security').val() + }; + jQuery.post(ajaxurl, data, function(response) { + if (response.success) { + jQuery('#diagnostic-text').val(response.data.message); + } + }).fail(function(response) { + ajaxFailed(response); + }); +} diff --git a/Postman/Postman-Email-Log/PostmanEmailLogController.php b/Postman/Postman-Email-Log/PostmanEmailLogController.php new file mode 100644 index 0000000..c496455 --- /dev/null +++ b/Postman/Postman-Email-Log/PostmanEmailLogController.php @@ -0,0 +1,480 @@ +rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->logger = new PostmanLogger( get_class( $this ) ); + if ( PostmanOptions::getInstance()->isMailLoggingEnabled() ) { + add_action( 'admin_menu', array( + $this, + 'postmanAddMenuItem', + ),20 ); + } else { + $this->logger->trace( 'not creating PostmanEmailLog admin menu item' ); + } + if ( PostmanUtils::isCurrentPagePostmanAdmin( 'postman_email_log' ) ) { + $this->logger->trace( 'on postman email log page' ); + // $this->logger->debug ( 'Registering ' . $actionName . ' Action Post handler' ); + add_action( 'admin_post_delete', array( + $this, + 'delete_log_item', + ) ); + add_action( 'admin_post_view', array( + $this, + 'view_log_item', + ) ); + add_action( 'admin_post_transcript', array( + $this, + 'view_transcript_log_item', + ) ); + add_action( 'admin_init', array( + $this, + 'on_admin_init', + ) ); + + + } + if ( is_admin() ) { + $actionName = self::RESEND_MAIL_AJAX_SLUG; + $fullname = 'wp_ajax_' . $actionName; + // $this->logger->debug ( 'Registering ' . 'wp_ajax_' . $fullname . ' Ajax handler' ); + add_action( $fullname, array( + $this, + 'resendMail', + ) ); + } + } + + /** + */ + function on_admin_init() { + $this->handleBulkAction(); + // register the stylesheet and javascript external resources + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + wp_register_script( 'postman_resend_email_script', plugins_url( 'script/postman_resend_email_sript.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + PostmanViewController::POSTMAN_SCRIPT, + ), $pluginData ['version'] ); + $this->handleCsvExport(); + } + + function handleCsvExport() { + if ( ! empty( $_POST ) && ! wp_verify_nonce( $_REQUEST['post-smtp-log'], 'post-smtp' ) ) + die( 'Security check' ); + + if ( isset( $_POST['postman_export_csv'] ) && current_user_can( Postman::MANAGE_POSTMAN_CAPABILITY_LOGS ) ) { + $args = array( + 'post_type' => PostmanEmailLogPostType::POSTMAN_CUSTOM_POST_TYPE_SLUG, + 'post_status' => PostmanEmailLogService::POSTMAN_CUSTOM_POST_STATUS_PRIVATE, + 'posts_per_page' => -1, + ); + $logs = new WP_Query($args); + + if ( empty( $logs->posts ) ) { + return; + } + + header('Content-Type: text/csv'); + header('Content-Disposition: attachment; filename="email-logs.csv"'); + + $fp = fopen('php://output', 'wb'); + + $headers = array_keys( PostmanLogFields::get_instance()->get_fields() ); + fputcsv($fp, $headers); + + foreach ( $logs->posts as $log ) { + $meta = PostmanLogFields::get_instance()->get($log->ID); + $data = []; + foreach ( $meta as $header => $line ) { + $data[] = $line[0]; + } + fputcsv($fp, $data); + } + + fclose($fp); + die(); + + } + } + + /** + */ + public function resendMail() { + check_admin_referer( 'resend', 'security' ); + + // get the email address of the recipient from the HTTP Request + $postid = $this->getRequestParameter( 'email' ); + if ( ! empty( $postid ) ) { + $meta_values = PostmanLogFields::get_instance()->get( $postid ); + + if ( isset( $_POST['mail_to'] ) && ! empty( $_POST['mail_to'] ) ) { + $emails = explode( ',', $_POST['mail_to'] ); + $to = array_map( 'sanitize_email', $emails ); + } else { + $to = $meta_values ['original_to'] [0]; + } + + $success = wp_mail( $to, $meta_values ['original_subject'] [0], $meta_values ['original_message'] [0], $meta_values ['original_headers'] [0] ); + + // Postman API: retrieve the result of sending this message from Postman + $result = apply_filters( 'postman_wp_mail_result', null ); + $transcript = $result ['transcript']; + + // post-handling + if ( $success ) { + $this->logger->debug( 'Email was successfully re-sent' ); + // the message was sent successfully, generate an appropriate message for the user + $statusMessage = sprintf( __( 'Your message was delivered (%d ms) to the SMTP server! Congratulations :)', 'post-smtp' ), $result ['time'] ); + + // compose the JSON response for the caller + $response = array( + 'message' => $statusMessage, + 'transcript' => $transcript, + ); + $this->logger->trace( 'AJAX response' ); + $this->logger->trace( $response ); + // send the JSON response + wp_send_json_success( $response ); + } else { + $this->logger->error( 'Email was not successfully re-sent - ' . $result ['exception']->getCode() ); + // the message was NOT sent successfully, generate an appropriate message for the user + $statusMessage = $result ['exception']->getMessage(); + + // compose the JSON response for the caller + $response = array( + 'message' => $statusMessage, + 'transcript' => $transcript, + ); + $this->logger->trace( 'AJAX response' ); + $this->logger->trace( $response ); + // send the JSON response + wp_send_json_error( $response ); + } + } else { + // compose the JSON response for the caller + $response = array(); + // send the JSON response + wp_send_json_error( $response ); + } + } + + /** + * TODO move this somewhere reusable + * + * @param mixed $parameterName + * @return mixed + */ + private function getRequestParameter( $parameterName ) { + if ( isset( $_POST [ $parameterName ] ) ) { + $value = filter_var( $_POST [ $parameterName ], FILTER_SANITIZE_STRING ); + $this->logger->trace( sprintf( 'Found parameter "%s"', $parameterName ) ); + $this->logger->trace( $value ); + return $value; + } + } + + /** + * From https://www.skyverge.com/blog/add-custom-bulk-action/ + */ + function handleBulkAction() { + // only do this for administrators + if ( PostmanUtils::isAdmin() && isset( $_REQUEST ['email_log_entry'] ) ) { + $this->logger->trace( 'handling bulk action' ); + if ( wp_verify_nonce( $_REQUEST ['_wpnonce'], 'bulk-email_log_entries' ) ) { + $this->logger->trace( sprintf( 'nonce "%s" passed validation', sanitize_text_field($_REQUEST ['_wpnonce']) ) ); + if ( isset( $_REQUEST ['action'] ) && ($_REQUEST ['action'] == 'bulk_delete' || $_REQUEST ['action2'] == 'bulk_delete') ) { + $this->logger->trace( sprintf( 'handling bulk delete' ) ); + $purger = new PostmanEmailLogPurger(); + $postids = array_map( 'absint', $_REQUEST ['email_log_entry'] ); + foreach ( $postids as $postid ) { + $purger->verifyLogItemExistsAndRemove( $postid ); + } + $mh = new PostmanMessageHandler(); + $mh->addMessage( __( 'Mail Log Entries were deleted.', 'post-smtp' ) ); + } else { + $this->logger->warn( sprintf( 'action "%s" not recognized', sanitize_text_field($_REQUEST ['action']) ) ); + } + } else { + $this->logger->warn( sprintf( 'nonce "%s" failed validation', sanitize_text_field($_REQUEST ['_wpnonce']) ) ); + } + $this->redirectToLogPage(); + } + } + + /** + */ + function delete_log_item() { + // only do this for administrators + if ( PostmanUtils::isAdmin() ) { + $this->logger->trace( 'handling delete item' ); + $postid = absint($_REQUEST ['email']); + if ( wp_verify_nonce( $_REQUEST ['_wpnonce'], 'delete_email_log_item_' . $postid ) ) { + $this->logger->trace( sprintf( 'nonce "%s" passed validation', sanitize_text_field($_REQUEST ['_wpnonce']) ) ); + $purger = new PostmanEmailLogPurger(); + $purger->verifyLogItemExistsAndRemove( $postid ); + $mh = new PostmanMessageHandler(); + $mh->addMessage( __( 'Mail Log Entry was deleted.', 'post-smtp' ) ); + } else { + $this->logger->warn( sprintf( 'nonce "%s" failed validation', sanitize_text_field($_REQUEST ['_wpnonce']) ) ); + } + $this->redirectToLogPage(); + } + } + + /** + */ + function view_log_item() { + // only do this for administrators + if ( PostmanUtils::isAdmin() ) { + $this->logger->trace( 'handling view item' ); + $postid = absint( $_REQUEST ['email'] ); + $post = get_post( $postid ); + + if ( $post->post_type !== 'postman_sent_mail' ) { + return; + } + + $meta_values = PostmanLogFields::get_instance()->get( $postid ); + // https://css-tricks.com/examples/hrs/ + print ''; + print ''; + if ( ! empty( $meta_values ['from_header'] [0] ) ) { + printf( '', _x( 'From', 'Who is this message From?', 'post-smtp' ), esc_html( $meta_values ['from_header'] [0] ) ); + } + // show the To header (it's optional) + if ( ! empty( $meta_values ['to_header'] [0] ) ) { + printf( '', _x( 'To', 'Who is this message To?', 'post-smtp' ), esc_html( $meta_values ['to_header'] [0] ) ); + } + // show the Cc header (it's optional) + if ( ! empty( $meta_values ['cc_header'] [0] ) ) { + printf( '', _x( 'Cc', 'Who is this message Cc\'d to?', 'post-smtp' ), esc_html( $meta_values ['cc_header'] [0] ) ); + } + // show the Bcc header (it's optional) + if ( ! empty( $meta_values ['bcc_header'] [0] ) ) { + printf( '', _x( 'Bcc', 'Who is this message Bcc\'d to?', 'post-smtp' ), esc_html( $meta_values ['bcc_header'] [0] ) ); + } + // show the Reply-To header (it's optional) + if ( ! empty( $meta_values ['reply_to_header'] [0] ) ) { + printf( '', __( 'Reply-To', 'post-smtp' ), esc_html( $meta_values ['reply_to_header'] [0] ) ); + } + printf( '', _x( 'Date', 'What is the date today?', 'post-smtp' ), $post->post_date ); + printf( '', _x( 'Subject', 'What is the subject of this message?', 'post-smtp' ), esc_html( $post->post_title ) ); + // The Transport UI is always there, in more recent versions that is + if ( ! empty( $meta_values ['transport_uri'] [0] ) ) { + printf( '', _x( 'Delivery-URI', 'What is the unique URI of the configuration?', 'post-smtp' ), esc_html( $meta_values ['transport_uri'] [0] ) ); + } + print '
    %s:%s
    %s:%s
    %s:%s
    %s:%s
    %s:%s
    %s:%s
    %s:%s
    %s:%s
    '; + print '
    '; + print '
    ';
+			print $this->sanitize_message( $post->post_content );
+			print '
    '; + print ''; + die(); + } + } + + function sanitize_message( $message ) { + $allowed_tags = wp_kses_allowed_html( 'post' ); + $allowed_tags['style'] = array(); + + return wp_kses( $message, $allowed_tags ); + } + + /** + */ + function view_transcript_log_item() { + // only do this for administrators + if ( PostmanUtils::isAdmin() ) { + $this->logger->trace( 'handling view transcript item' ); + $postid = absint($_REQUEST ['email']); + $post = get_post( $postid ); + $meta_values = PostmanLogFields::get_instance()->get( $postid ); + // https://css-tricks.com/examples/hrs/ + print ''; + printf( '

    %s

    ', __( 'This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password.', 'post-smtp' ) ); + print '
    '; + print '
    ';
+			if ( ! empty( $meta_values ['session_transcript'] [0] ) ) {
+				print esc_html( $meta_values ['session_transcript'] [0] );
+			} else {
+				/* Translators: Meaning "Not Applicable" */
+				print __( 'n/a', 'post-smtp' );
+			}
+			print '
    '; + print ''; + die(); + } + } + + /** + * For whatever reason, PostmanUtils::get..url doesn't work here? :( + */ + function redirectToLogPage() { + PostmanUtils::redirect( PostmanUtils::POSTMAN_EMAIL_LOG_PAGE_RELATIVE_URL ); + die(); + } + + /** + * Register the page + */ + function postmanAddMenuItem() { + // only do this for administrators + if ( PostmanUtils::isAdmin() ) { + $this->logger->trace( 'created PostmanEmailLog admin menu item' ); + /* + Translators where (%s) is the name of the plugin */ + $pageTitle = sprintf( __( '%s Email Log', 'post-smtp' ), __( 'Post SMTP', 'post-smtp' ) ); + $pluginName = _x( 'Email Log', 'The log of Emails that have been delivered', 'post-smtp' ); + + $page = add_submenu_page( PostmanViewController::POSTMAN_MENU_SLUG, $pageTitle, $pluginName, Postman::MANAGE_POSTMAN_CAPABILITY_LOGS, 'postman_email_log', array( $this, 'postman_render_email_page' ) ); + + // When the plugin options page is loaded, also load the stylesheet + add_action( 'admin_print_styles-' . $page, array( + $this, + 'postman_email_log_enqueue_resources', + ) ); + } + } + function postman_email_log_enqueue_resources() { + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + wp_register_style( 'postman_email_log', plugins_url( 'style/postman-email-log.css', $this->rootPluginFilenameAndPath ), null, $pluginData ['version'] ); + wp_enqueue_style( 'postman_email_log' ); + wp_enqueue_script( 'postman_resend_email_script' ); + wp_enqueue_script( 'sprintf' ); + wp_localize_script( 'postman_resend_email_script', 'postman_js_email_was_resent', __( 'Email was successfully resent (but without attachments)', 'post-smtp' ) ); + /* Translators: Where %s is an error message */ + wp_localize_script( 'postman_resend_email_script', 'postman_js_email_not_resent', __( 'Email could not be resent. Error: %s', 'post-smtp' ) ); + wp_localize_script( 'postman_resend_email_script', 'postman_js_resend_label', __( 'Resend', 'post-smtp' ) ); + } + + /** + * *************************** RENDER TEST PAGE ******************************** + * ****************************************************************************** + * This function renders the admin page and the example list table. + * Although it's + * possible to call prepare_items() and display() from the constructor, there + * are often times where you may need to include logic here between those steps, + * so we've instead called those methods explicitly. It keeps things flexible, and + * it's the way the list tables are used in the WordPress core. + */ + function postman_render_email_page() { + + // Create an instance of our package class... + $testListTable = new PostmanEmailLogView(); + wp_enqueue_script( 'postman_resend_email_script' ); + // Fetch, prepare, sort, and filter our data... + $testListTable->prepare_items(); + + ?> +
    + +
    +
    +
    +

    + + + +
    +

    +
    + + + +
    + + + +
    +
    + + +
    +
    + + +
    +
    + + +
    +
    + + +
    + +
    + +
    + +
    + +
    + +
    + +
    + +
    +
    Please notice: when you select a date for example 11/20/2017, behind the scene the query select 11/20/2017 00:00:00.
    So if you searching for an email arrived that day at any hour you need to select 11/20/2017 as the From Date and 11/21/2017 as the To Date.
    +
    + + +
    + + + + + display()?> +
    + + + +
    + array ( + 'name' => _x ( 'Sent Emails', 'The group of Emails that have been delivered', 'post-smtp' ), + 'singular_name' => _x ( 'Sent Email', 'An Email that has been delivered', 'post-smtp' ) + ), + 'capability_type' => '', + 'capabilities' => array () + ) ); + $logger = new PostmanLogger ( 'PostmanEmailLogPostType' ); + $logger->trace ( 'Created post type: ' . self::POSTMAN_CUSTOM_POST_TYPE_SLUG ); + } + } +} + diff --git a/Postman/Postman-Email-Log/PostmanEmailLogService.php b/Postman/Postman-Email-Log/PostmanEmailLogService.php new file mode 100644 index 0000000..2538700 --- /dev/null +++ b/Postman/Postman-Email-Log/PostmanEmailLogService.php @@ -0,0 +1,359 @@ +statusMessage .= $message; + } + } +} + +if ( ! class_exists( 'PostmanEmailLogService' ) ) { + + /** + * This class creates the Custom Post Type for Email Logs and handles writing these posts. + * + * @author jasonhendriks + */ + class PostmanEmailLogService { + + /* + * Private content is published only for your eyes, or the eyes of only those with authorization + * permission levels to see private content. Normal users and visitors will not be aware of + * private content. It will not appear in the article lists. If a visitor were to guess the URL + * for your private post, they would still not be able to see your content. You will only see + * the private content when you are logged into your WordPress blog. + */ + const POSTMAN_CUSTOM_POST_STATUS_PRIVATE = 'private'; + + // member variables + private $logger; + private $inst; + + /** + * Constructor + */ + private function __construct() { + $this->logger = new PostmanLogger( get_class( $this ) ); + } + + /** + * singleton instance + */ + public static function getInstance() { + static $inst = null; + if ( $inst === null ) { + $inst = new PostmanEmailLogService(); + } + return $inst; + } + + /** + * Logs successful email attempts + * + * @param PostmanMessage $message + * @param mixed $transcript + * @param PostmanModuleTransport $transport + */ + public function writeSuccessLog( PostmanEmailLog $log, PostmanMessage $message, $transcript, PostmanModuleTransport $transport ) { + if ( PostmanOptions::getInstance()->isMailLoggingEnabled() ) { + $statusMessage = ''; + $status = true; + $subject = $message->getSubject(); + if ( empty( $subject ) ) { + $statusMessage = sprintf( '%s: %s', __( 'Warning', 'post-smtp' ), __( 'An empty subject line can result in delivery failure.', 'post-smtp' ) ); + $status = 'WARN'; + } + $this->createLog( $log, $message, $transcript, $statusMessage, $status, $transport ); + $this->writeToEmailLog( $log ); + } + } + + /** + * Logs failed email attempts, requires more metadata so the email can be resent in the future + * + * @param PostmanMessage $message + * @param mixed $transcript + * @param PostmanModuleTransport $transport + * @param mixed $statusMessage + * @param mixed $originalTo + * @param mixed $originalSubject + * @param mixed $originalMessage + * @param mixed $originalHeaders + */ + public function writeFailureLog( PostmanEmailLog $log, PostmanMessage $message = null, $transcript, PostmanModuleTransport $transport, $statusMessage ) { + if ( PostmanOptions::getInstance()->isMailLoggingEnabled() ) { + $this->createLog( $log, $message, $transcript, $statusMessage, false, $transport ); + $this->writeToEmailLog( $log,$message ); + } + } + + /** + * Writes an email sending attempt to the Email Log + * + * From http://wordpress.stackexchange.com/questions/8569/wp-insert-post-php-function-and-custom-fields + */ + private function writeToEmailLog( PostmanEmailLog $log, PostmanMessage $message = null ) { + + $options = PostmanOptions::getInstance(); + + $this->checkForLogErrors( $log ,$message ); + $new_status = $log->statusMessage; + + if ( $options->is_fallback && empty( $log->statusMessage ) ) { + $new_status = 'Sent ( ** Fallback ** )'; + } + + if ( $options->is_fallback && ! empty( $log->statusMessage ) ) { + $new_status = '( ** Fallback ** ) ' . $log->statusMessage; + } + + // nothing here is sanitized as WordPress should take care of + // making database writes safe + $my_post = array( + 'post_type' => PostmanEmailLogPostType::POSTMAN_CUSTOM_POST_TYPE_SLUG, + 'post_title' => $log->subject, + 'post_content' => $log->body, + 'post_excerpt' => $new_status, + 'post_status' => PostmanEmailLogService::POSTMAN_CUSTOM_POST_STATUS_PRIVATE, + ); + + // Insert the post into the database (WordPress gives us the Post ID) + $post_id = wp_insert_post( $my_post, true ); + + if ( is_wp_error( $post_id ) ) { + add_action( 'admin_notices', function() use( $post_id ) { + $class = 'notice notice-error'; + $message = $post_id->get_error_message(); + + printf( '

    %2$s

    ', esc_attr( $class ), esc_html( $message ) ); + }); + } + + $this->logger->debug( sprintf( 'Saved message #%s to the database', $post_id ) ); + $this->logger->trace( $log ); + + // Write the meta data related to the email + PostmanLogFields::get_instance()->update( $post_id, 'success', $log->success ); + PostmanLogFields::get_instance()->update( $post_id, 'from_header', $log->sender ); + if ( ! empty( $log->toRecipients ) ) { + PostmanLogFields::get_instance()->update( $post_id, 'to_header', $log->toRecipients ); + } + if ( ! empty( $log->ccRecipients ) ) { + PostmanLogFields::get_instance()->update( $post_id, 'cc_header', $log->ccRecipients ); + } + if ( ! empty( $log->bccRecipients ) ) { + PostmanLogFields::get_instance()->update( $post_id, 'bcc_header', $log->bccRecipients ); + } + if ( ! empty( $log->replyTo ) ) { + PostmanLogFields::get_instance()->update( $post_id, 'reply_to_header', $log->replyTo ); + } + PostmanLogFields::get_instance()->update( $post_id, 'transport_uri', $log->transportUri ); + + if ( ! $log->success || true ) { + // alwas add the meta data so we can re-send it + PostmanLogFields::get_instance()->update( $post_id, 'original_to', $log->originalTo ); + PostmanLogFields::get_instance()->update( $post_id, 'original_subject', $log->originalSubject ); + PostmanLogFields::get_instance()->update( $post_id, 'original_message', $log->originalMessage ); + PostmanLogFields::get_instance()->update( $post_id, 'original_headers', $log->originalHeaders ); + } + + // we do not sanitize the session transcript - let the reader decide how to handle the data + PostmanLogFields::get_instance()->update( $post_id, 'session_transcript', $log->sessionTranscript ); + + // truncate the log (remove older entries) + $purger = new PostmanEmailLogPurger(); + $purger->truncateLogItems( PostmanOptions::getInstance()->getMailLoggingMaxEntries() ); + } + + private function checkForLogErrors( PostmanEmailLog $log, $postMessage ) { + $message = __( 'You getting this message because an error detected while delivered your email.', 'post-smtp' ); + $message .= "\r\n" . sprintf( __( 'For the domain: %1$s','post-smtp' ), get_bloginfo('url') ); + $message .= "\r\n" . __( 'The log to paste when you open a support issue:', 'post-smtp' ) . "\r\n"; + + if ( $log->statusMessage && ! empty( $log->statusMessage ) ) { + require_once POST_SMTP_PATH . '/Postman/notifications/PostmanNotify.php'; + + $message = $message . $log->statusMessage; + + $notification_service = PostmanOptions::getInstance()->getNotificationService(); + switch ($notification_service) { + case 'default': + $notifyer = new PostmanMailNotify; + break; + case 'pushover': + $notifyer = new PostmanPushoverNotify; + break; + case 'slack': + $notifyer = new PostmanSlackNotify; + break; + default: + $notifyer = new PostmanMailNotify; + } + + $notifyer = apply_filters( 'post_smtp_notifier', $notifyer, $notification_service ); + + // Notifications + $notify = new PostmanNotify( $notifyer ); + $notify->send($message, $log); + $notify->push_to_chrome($log->statusMessage); + } + + /** + * @todo + * After commented by me, check if it was needed. + */ + preg_match_all( '/(.*)From/s', $log->sessionTranscript, $matches ); + + if ( isset( $matches[1][0] ) && ! empty( $matches[1][0] ) && strpos( strtolower( $matches[1][0] ), 'error' ) !== false ) { + $message = $message . $log->sessionTranscript; + } + } + + /** + * Creates a Log object for use by writeToEmailLog() + * + * @param PostmanMessage $message + * @param mixed $transcript + * @param mixed $statusMessage + * @param mixed $success + * @param PostmanModuleTransport $transport + * @return PostmanEmailLog + */ + private function createLog( PostmanEmailLog $log, PostmanMessage $message = null, $transcript, $statusMessage, $success, PostmanModuleTransport $transport ) { + if ( $message ) { + $log->sender = $message->getFromAddress()->format(); + $log->toRecipients = $this->flattenEmails( $message->getToRecipients() ); + $log->ccRecipients = $this->flattenEmails( $message->getCcRecipients() ); + $log->bccRecipients = $this->flattenEmails( $message->getBccRecipients() ); + $log->subject = $message->getSubject(); + $log->body = $message->getBody(); + if ( null !== $message->getReplyTo() ) { + $log->replyTo = $message->getReplyTo()->format(); + } + } + $log->success = $success; + $log->statusMessage = $statusMessage; + $log->transportUri = PostmanTransportRegistry::getInstance()->getPublicTransportUri( $transport ); + $log->sessionTranscript = $log->transportUri . "\n\n" . $transcript; + return $log; + } + + /** + * Creates a readable "TO" entry based on the recipient header + * + * @param array $addresses + * @return string + */ + private static function flattenEmails( array $addresses ) { + $flat = ''; + $count = 0; + foreach ( $addresses as $address ) { + if ( $count >= 3 ) { + $flat .= sprintf( __( '.. +%d more', 'post-smtp' ), sizeof( $addresses ) - $count ); + break; + } + if ( $count > 0 ) { + $flat .= ', '; + } + $flat .= $address->format(); + $count ++; + } + return $flat; + } + } +} + +if ( ! class_exists( 'PostmanEmailLogPurger' ) ) { + class PostmanEmailLogPurger { + private $posts; + private $logger; + + /** + * + * @return mixed + */ + function __construct( $args = array() ) { + $this->logger = new PostmanLogger( get_class( $this ) ); + $defaults = array( + 'posts_per_page' => -1, + 'offset' => 0, + 'category' => '', + 'category_name' => '', + 'orderby' => 'date', + 'order' => 'DESC', + 'include' => '', + 'exclude' => '', + 'meta_key' => '', + 'meta_value' => '', + 'post_type' => PostmanEmailLogPostType::POSTMAN_CUSTOM_POST_TYPE_SLUG, + 'post_mime_type' => '', + 'post_parent' => '', + 'post_status' => 'private', + 'suppress_filters' => true, + ); + $args = wp_parse_args( $args, $defaults ); + $query = new WP_Query( $args ); + $this->posts = $query->posts; + } + + /** + * + * @param array $posts + * @param mixed $postid + */ + function verifyLogItemExistsAndRemove( $postid ) { + $force_delete = true; + foreach ( $this->posts as $post ) { + if ( $post->ID == $postid ) { + $this->logger->debug( 'deleting log item ' . intval( $postid ) ); + wp_delete_post( $postid, $force_delete ); + return; + } + } + $this->logger->warn( 'could not find Postman Log Item #' . $postid ); + } + function removeAll() { + $this->logger->debug( sprintf( 'deleting %d log items ', sizeof( $this->posts ) ) ); + $force_delete = true; + foreach ( $this->posts as $post ) { + wp_delete_post( $post->ID, $force_delete ); + } + } + + /** + * + * @param mixed $size + */ + function truncateLogItems( $size ) { + $index = count( $this->posts ); + $force_delete = true; + while ( $index > $size ) { + $postid = $this->posts [ -- $index ]->ID; + $this->logger->debug( 'deleting log item ' . $postid ); + wp_delete_post( $postid, $force_delete ); + } + } + } +} diff --git a/Postman/Postman-Email-Log/PostmanEmailLogView.php b/Postman/Postman-Email-Log/PostmanEmailLogView.php new file mode 100644 index 0000000..52cdd4d --- /dev/null +++ b/Postman/Postman-Email-Log/PostmanEmailLogView.php @@ -0,0 +1,462 @@ +logger = new PostmanLogger( get_class( $this ) ); + + // Set parent defaults + parent::__construct( array( + 'singular' => 'email_log_entry', // singular name of the listed records + 'plural' => 'email_log_entries', // plural name of the listed records + 'ajax' => false, + ) ); // does this table support ajax? + } + + /** + * ************************************************************************ + * Recommended. + * This method is called when the parent class can't find a method + * specifically build for a given column. Generally, it's recommended to include + * one method for each column you want to render, keeping your package class + * neat and organized. For example, if the class needs to process a column + * named 'title', it would first see if a method named $this->column_title() + * exists - if it does, that method will be used. If it doesn't, this one will + * be used. Generally, you should try to use custom column methods as much as + * possible. + * + * Since we have defined a column_title() method later on, this method doesn't + * need to concern itself with any column with a name of 'title'. Instead, it + * needs to handle everything else. + * + * For more detailed insight into how columns are handled, take a look at + * WP_List_Table::single_row_columns() + * + * @param array $item + * A singular item (one full row's worth of data) + * @param array $column_name + * The name/slug of the column to be processed + * @return string Text or HTML to be placed inside the column + * ************************************************************************ + */ + function column_default( $item, $column_name ) { + switch ( $column_name ) { + case 'sent_to' : + case 'date' : + case 'status' : + return $item [ $column_name ]; + default : + return print_r( $item, true ); // Show the whole array for troubleshooting purposes + } + } + + /** + * ************************************************************************ + * Recommended. + * This is a custom column method and is responsible for what + * is rendered in any column with a name/slug of 'title'. Every time the class + * needs to render a column, it first looks for a method named + * column_{$column_title} - if it exists, that method is run. If it doesn't + * exist, column_default() is called instead. + * + * This example also illustrates how to implement rollover actions. Actions + * should be an associative array formatted as 'slug'=>'link html' - and you + * will need to generate the URLs yourself. You could even ensure the links + * + * @see WP_List_Table::::single_row_columns() + * @param array $item + * A singular item (one full row's worth of data) + * @return string Text to be placed inside the column (movie title only) + * ************************************************************************ + */ + function column_title( $item ) { + + // Build row actions + $iframeUri = 'admin-post.php?page=postman_email_log&action=%s&email=%s&TB_iframe=true&width=700&height=550'; + $deleteUrl = wp_nonce_url( admin_url( sprintf( 'admin-post.php?page=postman_email_log&action=%s&email=%s', 'delete', $item ['ID'] ) ), 'delete_email_log_item_' . $item ['ID'] ); + $viewUrl = admin_url( sprintf( $iframeUri, 'view', $item ['ID'] ) ); + $transcriptUrl = admin_url( sprintf( $iframeUri, 'transcript', $item ['ID'] ) ); + $resendUrl = admin_url( sprintf( $iframeUri, 'resend', $item ['ID'] ) ); + + $meta_values = PostmanLogFields::get_instance()->get( $item ['ID'] ); + + $actions = array( + 'delete' => sprintf( '%s', $deleteUrl, _x( 'Delete', 'Delete an item from the email log', 'post-smtp' ) ), + 'view' => sprintf( '%s', $viewUrl, _x( 'View', 'View an item from the email log', 'post-smtp' ) ), + ); + + if ( ! empty( $meta_values ['session_transcript'] [0] ) ) { + $actions ['transcript'] = sprintf( '%2$s', $transcriptUrl, __( 'Session Transcript', 'post-smtp' ) ); + } else { + $actions ['transcript'] = sprintf( '%2$s', $transcriptUrl, __( 'Session Transcript', 'post-smtp' ) ); + } + if ( ! (empty( $meta_values ['original_to'] [0] ) && empty( $meta_values ['originalHeaders'] [0] )) ) { + // $actions ['resend'] = sprintf ( '%s', $resendUrl, __ ( 'Resend', 'post-smtp' ) ); + $emails = $meta_values ['original_to'] [0]; + $to = is_array( $emails ) ? implode( ',', array_walk($emails, 'sanitize_email') ) : sanitize_email( $emails ); + + $actions ['resend'] = sprintf( '%2$s
    %5$s
    ', $item ['ID'], __( 'Resend', 'post-smtp' ), 'resend-' . $item ['ID'], esc_attr( $to ), __( 'comma-separated for multiple emails', 'post-smtp' ), wp_create_nonce( 'resend' ) ); + } else { + $actions ['resend'] = sprintf( '%2$s', $resendUrl, __( 'Resend', 'post-smtp' ) ); + } + + // Return the title contents + return sprintf( '%1$s %3$s', + /*$1%s*/ $item ['title'], + /*$2%s*/ $item ['ID'], + /*$3%s*/ $this->row_actions( $actions ) ); + } + + /** + * ************************************************************************ + * REQUIRED if displaying checkboxes or using bulk actions! The 'cb' column + * is given special treatment when columns are processed. + * It ALWAYS needs to + * have it's own method. + * + * @see WP_List_Table::::single_row_columns() + * @param array $item + * A singular item (one full row's worth of data) + * @return string Text to be placed inside the column (movie title only) + * ************************************************************************ + */ + function column_cb( $item ) { + return sprintf( '', + /*$1%s*/ $this->_args ['singular'], // Let's simply repurpose the table's singular label ("movie") + /* $2%s */ + $item ['ID'] ); // The value of the checkbox should be the record's id + } + + /** + * ************************************************************************ + * REQUIRED! This method dictates the table's columns and titles. + * This should + * return an array where the key is the column slug (and class) and the value + * is the column's title text. If you need a checkbox for bulk actions, refer + * to the $columns array below. + * + * The 'cb' column is treated differently than the rest. If including a checkbox + * column in your table you must create a column_cb() method. If you don't need + * bulk actions or checkboxes, simply leave the 'cb' entry out of your array. + * + * @see WP_List_Table::::single_row_columns() + * @return array An associative array containing column information: 'slugs'=>'Visible Titles' + * ************************************************************************ + */ + function get_columns() { + $columns = array( + 'cb' => '', // Render a checkbox instead of text + 'title' => _x( 'Subject', 'What is the subject of this message?', 'post-smtp' ), + 'sent_to' => __( 'Sent To', 'post-smtp' ), + 'status' => __( 'Status', 'post-smtp' ), + 'date' => _x( 'Delivery Time', 'When was this email sent?', 'post-smtp' ), + ); + return $columns; + } + + /** + * ************************************************************************ + * Optional. + * If you want one or more columns to be sortable (ASC/DESC toggle), + * you will need to register it here. This should return an array where the + * key is the column that needs to be sortable, and the value is db column to + * sort by. Often, the key and value will be the same, but this is not always + * the case (as the value is a column name from the database, not the list table). + * + * This method merely defines which columns should be sortable and makes them + * clickable - it does not handle the actual sorting. You still need to detect + * the ORDERBY and ORDER querystring variables within prepare_items() and sort + * your data accordingly (usually by modifying your query). + * + * @return array An associative array containing all the columns that should be sortable: 'slugs'=>array('data_values',bool) + * ************************************************************************ + */ + function get_sortable_columns() { + return array(); + $sortable_columns = array( + 'title' => array( + 'title', + false, + ), // true means it's already sorted + 'status' => array( + 'status', + false, + ), + 'date' => array( + 'date', + false, + ), + ); + return $sortable_columns; + } + + /** + * ************************************************************************ + * Optional. + * If you need to include bulk actions in your list table, this is + * the place to define them. Bulk actions are an associative array in the format + * 'slug'=>'Visible Title' + * + * If this method returns an empty value, no bulk action will be rendered. If + * you specify any bulk actions, the bulk actions box will be rendered with + * the table automatically on display(). + * + * Also note that list tables are not automatically wrapped in
    elements, + * so you will need to create those manually in order for bulk actions to function. + * + * @return array An associative array containing all the bulk actions: 'slugs'=>'Visible Titles' + * ************************************************************************ + */ + function get_bulk_actions() { + $actions = array( + 'bulk_delete' => _x( 'Delete', 'Delete an item from the email log', 'post-smtp' ), + ); + return $actions; + } + + /** + * ************************************************************************ + * Optional. + * You can handle your bulk actions anywhere or anyhow you prefer. + * For this example package, we will handle it in the class to keep things + * clean and organized. + * + * @see $this->prepare_items() ************************************************************************ + */ + function process_bulk_action() { + } + + /** + * ************************************************************************ + * REQUIRED! This is where you prepare your data for display. + * This method will + * usually be used to query the database, sort and filter the data, and generally + * get it ready to be displayed. At a minimum, we should set $this->items and + * $this->set_pagination_args(), although the following properties and methods + * are frequently interacted with here... + * + * @global WPDB $wpdb + * @uses $this->_column_headers + * @uses $this->items + * @uses $this->get_columns() + * @uses $this->get_sortable_columns() + * @uses $this->get_pagenum() + * @uses $this->set_pagination_args() + * ************************************************************************ + */ + function prepare_items() { + if ( ! empty( $_POST ) && ! wp_verify_nonce( $_REQUEST['post-smtp-log'], 'post-smtp' ) ) + die( 'Security check' ); + + /** + * First, lets decide how many records per page to show + */ + $per_page = isset( $_POST['postman_page_records'] ) ? absint( $_POST['postman_page_records'] ) : 10; + + /** + * REQUIRED. + * Now we need to define our column headers. This includes a complete + * array of columns to be displayed (slugs & titles), a list of columns + * to keep hidden, and a list of columns that are sortable. Each of these + * can be defined in another method (as we've done here) before being + * used to build the value for our _column_headers property. + */ + $columns = $this->get_columns(); + $hidden = array(); + $sortable = $this->get_sortable_columns(); + + /** + * REQUIRED. + * Finally, we build an array to be used by the class for column + * headers. The $this->_column_headers property takes an array which contains + * 3 other arrays. One for all columns, one for hidden columns, and one + * for sortable columns. + */ + $this->_column_headers = array( + $columns, + $hidden, + $sortable, + ); + + /** + * Optional. + * You can handle your bulk actions however you see fit. In this + * case, we'll handle them within our package just to keep things clean. + */ + $this->process_bulk_action(); + + /** + * Instead of querying a database, we're going to fetch the example data + * property we created for use in this plugin. + * This makes this example + * package slightly different than one you might build on your own. In + * this example, we'll be using array manipulation to sort and paginate + * our data. In a real-world implementation, you will probably want to + * use sort and pagination data to build a custom query instead, as you'll + * be able to use your precisely-queried data immediately. + */ + $data = array(); + + $args = array( + 'posts_per_page' => -1, + 'orderby' => 'date', + 'order' => 'DESC', + 'post_type' => PostmanEmailLogPostType::POSTMAN_CUSTOM_POST_TYPE_SLUG, + 'post_status' => 'private', + 'suppress_filters' => true, + ); + + if ( isset( $_POST['from_date'] ) && ! empty( $_POST['from_date'] ) ) { + $from_date = sanitize_text_field( $_POST['from_date'] ); + + $args['date_query']['after'] = $from_date; + $args['date_query']['column'] = 'post_date'; + $args['date_query']['inclusive'] = false; + } + + if ( isset( $_POST['to_date'] ) && ! empty( $_POST['to_date'] ) ) { + $to_date = sanitize_text_field( $_POST['to_date'] ); + + $args['date_query']['before'] = $to_date; + $args['date_query']['column'] = 'post_date'; + $args['date_query']['inclusive'] = true; + } + + if ( ! empty( $_POST['search'] ) ) { + + if ( isset( $args['date_query'] ) ) { + unset( $args['date_query'] ); } + + $args['s'] = sanitize_text_field( $_POST['search'] ); + } + + if ( isset( $_POST['postman_trash_all'] ) ) { + $args['posts_per_page'] = -1; + } + $posts = new WP_query( $args ); + + if ( isset( $_POST['postman_trash_all'] ) ) { + foreach ( $posts->posts as $post ) { + wp_delete_post( $post->ID, true ); + } + + $posts->posts = array(); + } + + $date_format = get_option( 'date_format' ); + $time_format = get_option( 'time_format' ); + + foreach ( $posts->posts as $post ) { + $date = $post->post_date; + $humanTime = human_time_diff( strtotime( $post->post_date_gmt ) ); + // if this PHP system support humanTime, than use it + if ( ! empty( $humanTime ) ) { + /* Translators: where %s indicates the relative time from now */ + $date = sprintf( _x( '%s ago', 'A relative time as in "five days ago"', 'post-smtp' ), $humanTime ); + } + $meta_values = PostmanLogFields::get_instance()->get( $post->ID ); + $sent_to = array_map( 'esc_html', explode( ',' , $meta_values ['to_header'] [0] ) ); + $flattenedPost = array( + // the post title must be escaped as they are displayed in the HTML output + 'sent_to' => implode( ', ', $sent_to ), + 'title' => esc_html( $post->post_title ), + // the post status must be escaped as they are displayed in the HTML output + 'status' => ($post->post_excerpt != null ? esc_html( $post->post_excerpt ) : __( 'Sent', 'post-smtp' )), + 'date' => date( "$date_format $time_format", strtotime( $post->post_date ) ), + 'ID' => $post->ID, + ); + array_push( $data, $flattenedPost ); + } + + /** + * This checks for sorting input and sorts the data in our array accordingly. + * + * In a real-world situation involving a database, you would probably want + * to handle sorting by passing the 'orderby' and 'order' values directly + * to a custom query. The returned data will be pre-sorted, and this array + * sorting technique would be unnecessary. + */ + function usort_reorder( $a, $b ) { + $orderby = ( ! empty( $_REQUEST ['orderby'] )) ? sanitize_text_field($_REQUEST ['orderby']) : 'title'; // If no sort, default to title + $order = ( ! empty( $_REQUEST ['order'] )) ? sanitize_text_field($_REQUEST ['order']) : 'asc'; // If no order, default to asc + $result = strcmp( $a [ $orderby ], $b [ $orderby ] ); // Determine sort order + return ($order === 'asc') ? $result : - $result; // Send final sort direction to usort + } + // usort($data, 'usort_reorder'); + /** + * ********************************************************************* + * --------------------------------------------------------------------- + * vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv + * + * In a real-world situation, this is where you would place your query. + * + * For information on making queries in WordPress, see this Codex entry: + * http://codex.wordpress.org/Class_Reference/wpdb + * + * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + * --------------------------------------------------------------------- + * ******************************************************************** + */ + + /** + * REQUIRED for pagination. + * Let's figure out what page the user is currently + * looking at. We'll need this later, so you should always include it in + * your own package classes. + */ + $current_page = $this->get_pagenum(); + + /** + * REQUIRED for pagination. + * Let's check how many items are in our data array. + * In real-world use, this would be the total number of items in your database, + * without filtering. We'll need this later, so you should always include it + * in your own package classes. + */ + $total_items = count( $data ); + + /** + * The WP_List_Table class does not handle pagination for us, so we need + * to ensure that the data is trimmed to only the current page. + * We can use + * array_slice() to + */ + $data = array_slice( $data, (($current_page - 1) * $per_page), $per_page ); + + /** + * REQUIRED. + * Now we can add our *sorted* data to the items property, where + * it can be used by the rest of the class. + */ + $this->items = $data; + + /** + * REQUIRED. + * We also have to register our pagination options & calculations. + */ + $this->set_pagination_args( array( + 'total_items' => $total_items, // WE have to calculate the total number of items + 'per_page' => $per_page, // WE have to determine how many items to show on a page + 'total_pages' => ceil( $total_items / $per_page ), + ) ); // WE have to calculate the total number of pages + } +} + diff --git a/Postman/Postman-Mail/PostmanContactForm7.php b/Postman/Postman-Mail/PostmanContactForm7.php new file mode 100644 index 0000000..8792b08 --- /dev/null +++ b/Postman/Postman-Mail/PostmanContactForm7.php @@ -0,0 +1,42 @@ +result_error = apply_filters( 'postman_wp_mail_result', null ); + } + + public function change_rest_response( $response ) { + if ( array_key_exists('status', $response) && $response['status'] == 'mail_failed' ) { + $message = $this->result_error ['exception']->getMessage(); + + if ( ! $message || $message == '' ) { + return $response; + } + + $currentTransport = PostmanOptions::getInstance()->getTransportType(); + $result = json_decode($message); + $is_json = (json_last_error() == JSON_ERROR_NONE); + + switch ($currentTransport) { + case 'gmail_api': + $response['message'] = $is_json ? $result->error->message : $message; + break; + default: + $response['message'] = $is_json ? json_encode(json_decode($message), JSON_PRETTY_PRINT) : $message; + } + } + + return $response; + } + +} diff --git a/Postman/Postman-Mail/PostmanDefaultModuleTransport.php b/Postman/Postman-Mail/PostmanDefaultModuleTransport.php new file mode 100644 index 0000000..e52c754 --- /dev/null +++ b/Postman/Postman-Mail/PostmanDefaultModuleTransport.php @@ -0,0 +1,166 @@ +init (); + } + + /** + * Copied from WordPress core + * Set the from name and email + */ + public function init() { + parent::init(); + // From email and name + // If we don't have a name from the input headers + $this->fromName = apply_filters( 'wp_mail_from_name', 'WordPress' ); + + /* + * If we don't have an email from the input headers default to wordpress@$sitename + * Some hosts will block outgoing mail from this address if it doesn't exist but + * there's no easy alternative. Defaulting to admin_email might appear to be another + * option but some hosts may refuse to relay mail from an unknown domain. See + * https://core.trac.wordpress.org/ticket/5007. + */ + + // Get the site domain and get rid of www. + $site_url = get_bloginfo( 'url' ); + $sitename = strtolower ( PostmanUtils::getHost( $site_url ) ); + + $this->fromEmail = apply_filters( 'wp_mail_from', 'wordpress@' . $sitename ); + } + public function isConfiguredAndReady() { + return false; + } + public function isReadyToSendMail() { + return true; + } + public function getFromEmailAddress() { + return $this->fromEmail; + } + public function getFromName() { + return $this->fromName; + } + public function getEnvelopeFromEmailAddress() { + return $this->getFromEmailAddress (); + } + public function isEmailValidationSupported() { + return false; + } + + /** + * (non-PHPdoc) + * + * @see PostmanAbstractZendModuleTransport::validateTransportConfiguration() + */ + protected function validateTransportConfiguration() { + return array (); + // no-op, always valid + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::createMailEngine() + */ + public function createMailEngine() { + require_once 'PostmanZendMailEngine.php'; + return new PostmanZendMailEngine ( $this ); + } + + /** + * (non-PHPdoc) + * + * @see PostmanZendModuleTransport::createZendMailTransport() + */ + public function createZendMailTransport($fakeHostname, $fakeConfig) { + $config = array ( + 'port' => $this->getPort () + ); + return new Postman_Zend_Mail_Transport_Smtp ( $this->getHostname (), $config ); + } + + /** + * Determines whether Mail Engine locking is needed + * + * @see PostmanModuleTransport::requiresLocking() + */ + public function isLockingRequired() { + return PostmanOptions::AUTHENTICATION_TYPE_OAUTH2 == $this->getAuthenticationType (); + } + public function getSlug() { + return self::SLUG; + } + public function getName() { + return __ ( 'Default', 'post-smtp' ); + } + public function getHostname() { + return 'localhost'; + } + public function getPort() { + return 25; + } + public function getSecurityType() { + return PostmanOptions::SECURITY_TYPE_NONE; + } + public function getAuthenticationType() { + return PostmanOptions::AUTHENTICATION_TYPE_NONE; + } + public function getCredentialsId() { + $options = PostmanOptions::getInstance (); + if ($options->isAuthTypeOAuth2 ()) { + return $options->getClientId (); + } else { + return $options->getUsername (); + } + } + public function getCredentialsSecret() { + $options = PostmanOptions::getInstance (); + if ($options->isAuthTypeOAuth2 ()) { + return $options->getClientSecret (); + } else { + return $options->getPassword (); + } + } + public function isServiceProviderGoogle($hostname) { + return PostmanUtils::endsWith ( $hostname, 'gmail.com' ); + } + public function isServiceProviderMicrosoft($hostname) { + return PostmanUtils::endsWith ( $hostname, 'live.com' ); + } + public function isServiceProviderYahoo($hostname) { + return strpos ( $hostname, 'yahoo' ); + } + public function isOAuthUsed($authType) { + return false; + } + public final function getConfigurationBid(PostmanWizardSocket $hostData, $userAuthOverride, $originalSmtpServer) { + return null; + } + + /** + * Does not participate in the Wizard process; + * + * (non-PHPdoc) + * + * @see PostmanModuleTransport::getSocketsForSetupWizardToProbe() + */ + public function getSocketsForSetupWizardToProbe($hostname, $smtpServerGuess) { + return array (); + } + } +} diff --git a/Postman/Postman-Mail/PostmanEmailAddress.php b/Postman/Postman-Mail/PostmanEmailAddress.php new file mode 100644 index 0000000..d29b0f4 --- /dev/null +++ b/Postman/Postman-Mail/PostmanEmailAddress.php @@ -0,0 +1,95 @@ +" + if (preg_match ( '/(.*)<(.+)>/', $email, $matches )) { + if (count ( $matches ) == 3) { + $name = $matches [1]; + $email = $matches [2]; + } + } + $this->setEmail ( trim ( $email ) ); + $this->setName ( trim ( $name ) ); + } + public static function copy(PostmanEmailAddress $orig) { + return new PostmanEmailAddress ( $orig->getEmail (), $orig->getName () ); + } + public function getName() { + return $this->name; + } + public function getEmail() { + return $this->email; + } + public function format() { + $name = $this->getName (); + if (! empty ( $name )) { + return sprintf ( '%s <%s>', $this->getName (), $this->getEmail () ); + } else { + return sprintf ( '%s', $this->getEmail () ); + } + } + public function setName($name) { + $this->name = $name; + } + public function setEmail($email) { + $this->email = $email; + } + + /** + * Validate the email address + * + * @throws Exception + */ + public function validate($desc = '') { + if (! PostmanUtils::validateEmail ( $this->email )) { + if (empty ( $desc )) { + /* Translators: Where %s is the email address */ + $message = sprintf ( 'Invalid e-mail address "%s"', $this->email ); + } else { + /* Translators: Where (1) is the header name (eg. To) and (2) is the email address */ + $message = sprintf ( 'Invalid "%1$s" e-mail address "%2$s"', $desc, $this->email ); + } + $logger = new PostmanLogger ( get_class ( $this ) ); + $logger->warn ( $message ); + throw new Exception ( $message ); + } + } + + /** + * Accept a String of addresses or an array and return an array + * + * @param mixed $recipientList + * @param mixed $recipients + */ + public static function convertToArray($emails) { + assert ( ! empty ( $emails ) ); + if (! is_array ( $emails )) { + // http://tiku.io/questions/955963/splitting-comma-separated-email-addresses-in-a-string-with-commas-in-quotes-in-p + $t = str_getcsv ( $emails ); + $emails = array (); + foreach ( $t as $k => $v ) { + if (strpos ( $v, ',' ) !== false) { + $t [$k] = '"' . str_replace ( ' <', '" <', $v ); + } + $tokenizedEmail = trim ( $t [$k] ); + array_push ( $emails, $tokenizedEmail ); + } + } + return $emails; + } + public function log(PostmanLogger $log, $desc) { + $message = $desc . ' email=' . $this->getEmail (); + if (! empty ( $this->name )) { + $message .= ' name=' . $this->getName (); + } + $log->debug ( $message ); + } + } +} \ No newline at end of file diff --git a/Postman/Postman-Mail/PostmanGmailApiModuleTransport.php b/Postman/Postman-Mail/PostmanGmailApiModuleTransport.php new file mode 100644 index 0000000..fc9e351 --- /dev/null +++ b/Postman/Postman-Mail/PostmanGmailApiModuleTransport.php @@ -0,0 +1,261 @@ +getAuthenticationType ()) { + $config = PostmanOAuth2ConfigurationFactory::createConfig ( $this ); + } else { + $config = PostmanBasicAuthConfigurationFactory::createConfig ( $this ); + } + + // Google's autoloader will try and load this so we list it first + require_once 'PostmanGmailApiModuleZendMailTransport.php'; + + // Gmail Client includes + require_once 'google-api-client/vendor/autoload.php'; + + // build the Gmail Client + $authToken = PostmanOAuthToken::getInstance (); + $client = new Google_Client (); + $client->setClientId ( $this->options->getClientId () ); + $client->setClientSecret ( $this->options->getClientSecret () ); + $client->setRedirectUri ( '' ); + // rebuild the google access token + $token = new stdClass (); + $token->access_token = $authToken->getAccessToken (); + $token->refresh_token = $authToken->getRefreshToken (); + $token->token_type = 'Bearer'; + $token->expires_in = 3600; + $token->id_token = null; + $token->created = 0; + $client->setAccessToken ( json_encode ( $token ) ); + // We only need permissions to compose and send emails + $client->addScope ( "https://www.googleapis.com/auth/gmail.compose" ); + $service = new Google_Service_Gmail ( $client ); + $config [PostmanGmailApiModuleZendMailTransport::SERVICE_OPTION] = $service; + + return new PostmanGmailApiModuleZendMailTransport ( self::HOST, $config ); + } + + /** + * Determines whether Mail Engine locking is needed + * + * @see PostmanModuleTransport::requiresLocking() + */ + public function isLockingRequired() { + return PostmanOptions::AUTHENTICATION_TYPE_OAUTH2 == $this->getAuthenticationType (); + } + public function getSlug() { + return self::SLUG; + } + public function getName() { + return __ ( 'Gmail API', 'post-smtp' ); + } + public function isEnvelopeFromValidationSupported() { + return false; + } + public function getHostname() { + return self::HOST; + } + public function getPort() { + return self::PORT; + } + public function getAuthenticationType() { + return $this->options->getAuthenticationType (); + } + public function getSecurityType() { + return null; + } + public function getCredentialsId() { + $this->options = $this->options; + if ($this->options->isAuthTypeOAuth2 ()) { + return $this->options->getClientId (); + } else { + return $this->options->getUsername (); + } + } + public function getCredentialsSecret() { + $this->options = $this->options; + if ($this->options->isAuthTypeOAuth2 ()) { + return $this->options->getClientSecret (); + } else { + return $this->options->getPassword (); + } + } + public function isServiceProviderMicrosoft($hostname) { + return false; + } + public function isServiceProviderYahoo($hostname) { + return false; + } + public function isOAuthUsed($authType) { + return true; + } + + /** + * (non-PHPdoc) + * + * @see PostmanAbstractModuleTransport::getDeliveryDetails() + */ + public function getDeliveryDetails() { + /* translators: where (1) is the secure icon and (2) is the transport name */ + return sprintf ( __ ( 'Postman will send mail via the %1$s %2$s.', 'post-smtp' ), '🔐', $this->getName () ); + } + + /** + * (non-PHPdoc) + * + * @see PostmanAbstractZendModuleTransport::validateTransportConfiguration() + */ + protected function validateTransportConfiguration() { + $messages = parent::validateTransportConfiguration (); + if (empty ( $messages )) { + $this->setReadyForOAuthGrant (); + if ($this->isPermissionNeeded ()) { + /* translators: %1$s is the Client ID label, and %2$s is the Client Secret label */ + $message = sprintf ( __ ( 'You have configured OAuth 2.0 authentication, but have not received permission to use it.', 'post-smtp' ), $this->getScribe ()->getClientIdLabel (), $this->getScribe ()->getClientSecretLabel () ); + $message .= sprintf ( ' %s.', PostmanUtils::getGrantOAuthPermissionUrl (), $this->getScribe ()->getRequestPermissionLinkText () ); + array_push ( $messages, $message ); + $this->setNotConfiguredAndReady (); + } + } + return $messages; + } + + /** + * Given a hostname, what ports should we test? + * + * May return an array of several combinations. + */ + public function getSocketsForSetupWizardToProbe($hostname, $smtpServerGuess) { + $hosts = array (); + if ($smtpServerGuess == null || PostmanUtils::isGoogle ( $smtpServerGuess )) { + array_push ( $hosts, parent::createSocketDefinition ( $this->getHostname (), $this->getPort () ) ); + } + return $hosts; + } + + /** + * Postman Gmail API supports delivering mail with these parameters: + * + * 70 gmail api on port 465 to www.googleapis.com + * + * @param mixed $hostData + */ + public function getConfigurationBid(PostmanWizardSocket $hostData, $userAuthOverride, $originalSmtpServer) { + $recommendation = array (); + $recommendation ['priority'] = 0; + $recommendation ['transport'] = self::SLUG; + $recommendation ['enc'] = PostmanOptions::SECURITY_TYPE_NONE; + $recommendation ['auth'] = PostmanOptions::AUTHENTICATION_TYPE_OAUTH2; + $recommendation ['hostname'] = null; // scribe looks this + $recommendation ['label'] = $this->getName (); + $recommendation ['display_auth'] = 'oauth2'; + if ($hostData->hostname == self::HOST && $hostData->port == self::PORT) { + /* translators: where variables are (1) transport name (2) host and (3) port */ + $recommendation ['message'] = sprintf ( __ ( ('Postman recommends the %1$s to host %2$s on port %3$d.') ), $this->getName (), self::HOST, self::PORT ); + $recommendation ['priority'] = 27000; + } + + return $recommendation; + } + + /** + */ + public function createOverrideMenu(PostmanWizardSocket $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride) { + $overrideItem = parent::createOverrideMenu ( $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride ); + // push the authentication options into the $overrideItem structure + $overrideItem ['auth_items'] = array ( + array ( + 'selected' => true, + 'name' => __ ( 'OAuth 2.0 (requires Client ID and Client Secret)', 'post-smtp' ), + 'value' => 'oauth2' + ) + ); + return $overrideItem; + } + + /** + * Functions to execute on the admin_init event + * + * "Runs at the beginning of every admin page before the page is rendered." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_an_Admin_Page_Request + */ + public function on_admin_init() { + // only administrators should be able to trigger this + if (PostmanUtils::isAdmin ()) { + $this->registerStylesAndScripts (); + } + } + + /** + */ + public function registerStylesAndScripts() { + // register the stylesheet and javascript external resources + $pluginData = apply_filters ( 'postman_get_plugin_metadata', null ); + wp_register_script ( 'postman_gmail_script', plugins_url ( 'Postman/Postman-Mail/postman_gmail.js', $this->rootPluginFilenameAndPath ), array ( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + PostmanViewController::POSTMAN_SCRIPT + ), $pluginData ['version'] ); + } + + /** + */ + public function enqueueScript() { + wp_enqueue_script ( 'postman_gmail_script' ); + } +} diff --git a/Postman/Postman-Mail/PostmanGmailApiModuleZendMailTransport.php b/Postman/Postman-Mail/PostmanGmailApiModuleZendMailTransport.php new file mode 100644 index 0000000..b190772 --- /dev/null +++ b/Postman/Postman-Mail/PostmanGmailApiModuleZendMailTransport.php @@ -0,0 +1,278 @@ +_name = $config ['name']; + } + if (isset ( $config ['port'] )) { + $this->_port = $config ['port']; + } + if (isset ( $config ['auth'] )) { + $this->_auth = $config ['auth']; + } + + $this->_host = $host; + $this->_config = $config; + $this->logger = new PostmanLogger ( get_class ( $this ) ); + } + + /** + * Class destructor to ensure all open connections are closed + * + * @return void + */ + public function __destruct() { + if ($this->_connection instanceof Postman_Zend_Mail_Protocol_Smtp) { + try { + $this->_connection->quit (); + } catch ( Postman_Zend_Mail_Protocol_Exception $e ) { + // ignore + } + $this->_connection->disconnect (); + } + } + + /** + * Sets the connection protocol instance + * + * @param Postman_Zend_Mail_Protocol_Abstract $client + * + * @return void + */ + public function setConnection(Postman_Zend_Mail_Protocol_Abstract $connection) { + $this->_connection = $connection; + } + + /** + * Gets the connection protocol instance + * + * @return Postman_Zend_Mail_Protocol_Abstract|null + */ + public function getConnection() { + return $this->_connection; + } + + /** + * Send an email via the Gmail API + * + * Uses URI https://www.googleapis.com + * + * + * @return void + * @todo Rename this to sendMail, it's a public method... + */ + public function _sendMail() { + + // Prepare the message in message/rfc822 + $message = $this->header . Postman_Zend_Mime::LINEEND . $this->body; + $this->message = $message; + + // The message needs to be encoded in Base64URL + $encodedMessage = rtrim ( strtr ( base64_encode ( $message ), '+/', '-_' ), '=' ); + $googleApiMessage = new Google_Service_Gmail_Message (); + $googleService = $this->_config [self::SERVICE_OPTION]; + $googleClient = $googleService->getClient(); + + $file_size = strlen($message); + + $result = array (); + try { + $googleClient->setDefer(true); + $result = $googleService->users_messages->send ( 'me', $googleApiMessage, array('uploadType' => 'resumable') ); + + $chunkSizeBytes = 1 * 1024 * 1024; + + // create mediafile upload + $media = new Google_Http_MediaFileUpload( + $googleClient, + $result, + 'message/rfc822', + $message, + true, + $chunkSizeBytes + ); + $media->setFileSize($file_size); + + $status = false; + while (! $status) { + $status = $media->nextChunk(); + } + $result = false; + + // Reset to the client to execute requests immediately in the future. + $googleClient->setDefer(false); + + $googleMessageId = $status->getId(); + + if ($this->logger->isInfo ()) { + $this->logger->info ( sprintf ( 'Message %d accepted for delivery', PostmanState::getInstance ()->getSuccessfulDeliveries () + 1 ) ); + } + $this->transcript = print_r ( $result, true ); + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= $message; + } catch ( Exception $e ) { + $this->transcript = $e->getMessage (); + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= $message; + throw $e; + } + } + + public function getMessage() { + return $this->message; + } + public function getTranscript() { + return $this->transcript; + } + + /** + * Format and fix headers + * + * Some SMTP servers do not strip BCC headers. Most clients do it themselves as do we. + * + * @access protected + * @param array $headers + * @return void + * @throws Postman_Zend_Transport_Exception + */ + protected function _prepareHeaders($headers) { + if (! $this->_mail) { + /** + * + * @see Postman_Zend_Mail_Transport_Exception + */ + // require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception ( '_prepareHeaders requires a registered Postman_Zend_Mail object' ); + } + + // google will unset the Bcc header for us. + // unset ( $headers ['Bcc'] ); + + // Prepare headers + parent::_prepareHeaders ( $headers ); + } + } +} \ No newline at end of file diff --git a/Postman/Postman-Mail/PostmanMailEngine.php b/Postman/Postman-Mail/PostmanMailEngine.php new file mode 100644 index 0000000..046178b --- /dev/null +++ b/Postman/Postman-Mail/PostmanMailEngine.php @@ -0,0 +1,14 @@ +apiKey = $apiKey; + $this->domainName = $domainName; + + // create the logger + $this->logger = new PostmanLogger( get_class( $this ) ); + $this->mailgunMessage = array( + 'from' => '', + 'to' => '', + 'subject' => '', + ); + } + + /** + * (non-PHPdoc) + * + * @see PostmanSmtpEngine::send() + */ + public function send( PostmanMessage $message ) { + $options = PostmanOptions::getInstance(); + $this->api_endpoint = ! is_null( $options->getMailgunRegion() ) ? 'https://api.eu.mailgun.net' : 'https://api.mailgun.net'; + + // add the Postman signature - append it to whatever the user may have set + if ( ! $options->isStealthModeEnabled() ) { + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + $this->addHeader( 'X-Mailer', sprintf( 'Postman SMTP %s for WordPress (%s)', $pluginData ['version'], 'https://wordpress.org/plugins/post-smtp/' ) ); + } + + // add the headers - see http://framework.zend.com/manual/1.12/en/zend.mail.additional-headers.html + foreach ( ( array ) $message->getHeaders() as $header ) { + $this->logger->debug( sprintf( 'Adding user header %s=%s', $header ['name'], $header ['content'] ) ); + $this->addHeader( $header ['name'], $header ['content'], true ); + } + + // if the caller set a Content-Type header, use it + $contentType = $message->getContentType(); + if ( ! empty( $contentType ) ) { + $this->logger->debug( 'Adding content-type ' . $contentType ); + $this->addHeader( 'Content-Type', $contentType ); + } + + // add the From Header + $sender = $message->getFromAddress(); + { + $senderEmail = PostmanOptions::getInstance()->getMessageSenderEmail(); + $senderName = $sender->getName(); + assert( ! empty( $senderEmail ) ); + + $senderText = ! empty( $senderName ) ? $senderName : $senderEmail; + $this->mailgunMessage ['from'] = "{$senderText} <{$senderEmail}>"; + // now log it + $sender->log( $this->logger, 'From' ); + } + + // add the Sender Header, overriding what the user may have set + $this->addHeader( 'Sender', $options->getEnvelopeSender() ); + + // add the to recipients + $recipients = array(); + foreach ( ( array ) $message->getToRecipients() as $recipient ) { + $recipient->log( $this->logger, 'To' ); + $recipients[] = $recipient->getEmail(); + } + $this->mailgunMessage['to'] = $recipients; + + // add the cc recipients + $recipients = array(); + foreach ( ( array ) $message->getCcRecipients() as $recipient ) { + $recipient->log( $this->logger, 'Cc' ); + $recipients[] = $recipient->getEmail(); + } + $this->mailgunMessage['cc'] = implode( ',', $recipients ); + + // add the bcc recipients + $recipients = array(); + foreach ( ( array ) $message->getBccRecipients() as $recipient ) { + $recipient->log( $this->logger, 'Bcc' ); + $recipients[] = $recipient->getEmail(); + } + $this->mailgunMessage['bcc'] = implode( ',', $recipients ); + + // add the reply-to + $replyTo = $message->getReplyTo(); + // $replyTo is null or a PostmanEmailAddress object + if ( isset( $replyTo ) ) { + $this->addHeader( 'reply-to', $replyTo->format() ); + } + + // add the date + $date = $message->getDate(); + if ( ! empty( $date ) ) { + $this->addHeader( 'date', $message->getDate() ); + } + + // add the messageId + $messageId = $message->getMessageId(); + if ( ! empty( $messageId ) ) { + $this->addHeader( 'message-id', $messageId ); + } + + // add the subject + if ( null !== $message->getSubject() ) { + $this->mailgunMessage ['subject'] = $message->getSubject(); + } + + // add the message content + { + $textPart = $message->getBodyTextPart(); + if ( ! empty( $textPart ) ) { + $this->logger->debug( 'Adding body as text' ); + $this->mailgunMessage ['text'] = $textPart; + } + $htmlPart = $message->getBodyHtmlPart(); + if ( ! empty( $htmlPart ) ) { + $this->logger->debug( 'Adding body as html' ); + $this->mailgunMessage ['html'] = $htmlPart; + } + } + + // add attachments + $this->logger->debug( 'Adding attachments' ); + $this->addAttachmentsToMail( $message ); + + $result = array(); + try { + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Creating Mailgun service with apiKey=' . $this->apiKey ); + } + + // send the message + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Sending mail' ); + } + + $configurator = new HttpClientConfigurator(); + $configurator->setEndpoint( $this->api_endpoint . '/v3/'. $this->domainName .'/messages'); + $configurator->setApiKey($this->apiKey); + $mg = Mailgun::configure($configurator); + + // Make the call to the client. + $result = $this->processSend( $mg ); + + if ( $this->logger->isInfo() ) { + $this->logger->info( sprintf( 'Message %d accepted for delivery', PostmanState::getInstance()->getSuccessfulDeliveries() + 1 ) ); + } + + $this->transcript = print_r( $result, true ); + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= print_r( $this->mailgunMessage, true ); + } catch ( Exception $e ) { + $this->transcript = $e->getMessage(); + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= print_r( $this->mailgunMessage, true ); + throw $e; + } + } + + + private function processSend( $mg ) { + + if ( count( $this->mailgunMessage['to'] ) <= 1 ) { + + return $mg->messages()->send( $this->domainName, array_filter( $this->mailgunMessage ) ); + } else { + $chunks = array_chunk( $this->mailgunMessage['to'], 1000, true ); + + $result = array(); + foreach ( $chunks as $key => $emails ) { + $this->mailgunMessage['to'] = $emails; + $recipient_variables = $this->getRecipientVariables( $emails ); + $this->mailgunMessage['recipient-variables'] = $recipient_variables; + + $result[] = $mg->messages()->send( $this->domainName, array_filter( $this->mailgunMessage ) ); + + // Don't have a reason just wait a bit before sending the next chunk + sleep(2); + } + + return $result; + } + } + + private function getRecipientVariables( $emails ) { + $recipient_variables = array(); + foreach ( $emails as $key => $email ) { + $recipient_variables[$email] = array( 'id' => $key ); + } + + return json_encode( $recipient_variables ); + } + + private function addHeader( $name, $value, $deprecated = '' ) { + if ( $value && ! empty( $value ) ) { + $this->mailgunMessage['h:' . $name] = preg_replace('/.*:\s?/', '', $value); + } + } + + /** + * Add attachments to the message + * + * @param Postman_Zend_Mail $mail + */ + private function addAttachmentsToMail( PostmanMessage $message ) { + $attachments = $message->getAttachments(); + if ( ! is_array( $attachments ) ) { + // WordPress may a single filename or a newline-delimited string list of multiple filenames + $attArray[] = explode( PHP_EOL, $attachments ); + } else { + $attArray = $attachments; + } + + $attachments = array(); + foreach ( $attArray as $file ) { + if ( ! empty( $file ) ) { + $this->logger->debug( 'Adding attachment: ' . $file ); + $attachments[] = array( 'filePath' => $file ); + } + } + + if ( ! empty( $attachments ) ) { + if ( $this->logger->isTrace() ) { + $this->logger->trace( $attachments ); + } + $this->mailgunMessage['attachment'] = $attachments; + } + } + + // return the SMTP session transcript + public function getTranscript() { + return $this->transcript; + } + } +} + diff --git a/Postman/Postman-Mail/PostmanMailgunTransport.php b/Postman/Postman-Mail/PostmanMailgunTransport.php new file mode 100644 index 0000000..b56cadf --- /dev/null +++ b/Postman/Postman-Mail/PostmanMailgunTransport.php @@ -0,0 +1,267 @@ +options->getMailgunRegion() ) ? self::EU_REGION : self::HOST; + } + /** + * v0.2.1 + * + * @return int + */ + public function getPort() { + return self::PORT; + } + /** + * v1.7.0 + * + * @return string + */ + public function getTransportType() { + return 'Mailgun_api'; + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::createMailEngine() + */ + public function createMailEngine() { + $apiKey = $this->options->getMailgunApiKey(); + $domainName = $this->options->getMailgunDomainName(); + + require_once 'PostmanMailgunMailEngine.php'; + $engine = new PostmanMailgunMailEngine( $apiKey, $domainName ); + return $engine; + } + public function getDeliveryDetails() { + /* translators: where (1) is the secure icon and (2) is the transport name */ + return sprintf( __( 'Post SMTP will send mail via the %1$s %2$s.', 'post-smtp' ), '🔐', $this->getName() ); + } + + /** + * + * @param mixed $data + */ + public function prepareOptionsForExport( $data ) { + $data = parent::prepareOptionsForExport( $data ); + $data [ PostmanOptions::MAILGUN_API_KEY ] = PostmanOptions::getInstance()->getMailgunApiKey(); + return $data; + } + + /** + * (non-PHPdoc) + * + * @see PostmanTransport::getMisconfigurationMessage() + */ + protected function validateTransportConfiguration() { + $messages = parent::validateTransportConfiguration(); + $apiKey = $this->options->getMailgunApiKey(); + $domainName = $this->options->getMailgunDomainName(); + + if ( empty( $apiKey ) ) { + array_push( $messages, __( 'API Key can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady(); + } + + if ( empty( $domainName ) ) { + array_push( $messages, __( 'Domain Name can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady(); + } + + if ( ! $this->isSenderConfigured() ) { + array_push( $messages, __( 'Message From Address can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady(); + } + return $messages; + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::getConfigurationBid() + */ + public function getConfigurationBid( PostmanWizardSocket $hostData, $userAuthOverride, $originalSmtpServer ) { + $recommendation = array(); + $recommendation ['priority'] = 0; + $recommendation ['transport'] = self::SLUG; + $recommendation ['hostname'] = null; // scribe looks this + $recommendation ['label'] = $this->getName(); + if ( $hostData->hostname == $this->getHostname() && $hostData->port == self::PORT ) { + $recommendation ['priority'] = self::PRIORITY; + /* translators: where variables are (1) transport name (2) host and (3) port */ + $recommendation ['message'] = sprintf( __( ('Postman recommends the %1$s to host %2$s on port %3$d.') ), $this->getName(), $this->getHostname(), self::PORT ); + } + return $recommendation; + } + + /** + * + * @param mixed $hostname + * @param mixed $response + */ + public function populateConfiguration( $hostname ) { + $response = parent::populateConfiguration( $hostname ); + return $response; + } + + /** + */ + public function createOverrideMenu( PostmanWizardSocket $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride ) { + $overrideItem = parent::createOverrideMenu( $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride ); + // push the authentication options into the $overrideItem structure + $overrideItem ['auth_items'] = array( + array( + 'selected' => true, + 'name' => __( 'API Key', 'post-smtp' ), + 'value' => 'api_key', + ), + ); + return $overrideItem; + } + + /** + * Functions to execute on the admin_init event + * + * "Runs at the beginning of every admin page before the page is rendered." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_an_Admin_Page_Request + */ + public function on_admin_init() { + // only administrators should be able to trigger this + if ( PostmanUtils::isAdmin() ) { + $this->addSettings(); + $this->registerStylesAndScripts(); + } + } + + /* + * What follows in the code responsible for creating the Admin Settings page + */ + + /** + */ + public function addSettings() { + // the Mailgun Auth section + add_settings_section( PostmanMailgunTransport::MAILGUN_AUTH_SECTION, __( 'Authentication', 'post-smtp' ), array( + $this, + 'printMailgunAuthSectionInfo', + ), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS ); + + add_settings_field( PostmanOptions::MAILGUN_API_KEY, __( 'API Key', 'post-smtp' ), array( + $this, + 'mailgun_api_key_callback', + ), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS, PostmanMailgunTransport::MAILGUN_AUTH_SECTION ); + + add_settings_field( PostmanOptions::MAILGUN_DOMAIN_NAME, __( 'Domain Name', 'post-smtp' ), array( + $this, + 'mailgun_domain_name_callback', + ), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS, PostmanMailgunTransport::MAILGUN_AUTH_SECTION ); + + add_settings_field( PostmanOptions::MAILGUN_REGION, __( 'Mailgun Europe Region?', 'post-smtp' ), array( + $this, + 'mailgun_region_callback', + ), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS, PostmanMailgunTransport::MAILGUN_AUTH_SECTION ); + } + public function printMailgunAuthSectionInfo() { + /* Translators: Where (1) is the service URL and (2) is the service name and (3) is a api key URL */ + printf( '

    %s

    ', sprintf( __( 'Create an account at %2$s and enter an API key below.', 'post-smtp' ), 'https://mailgun.com', 'mailgun.com', 'https://app.mailgun.com/app/domains/' ) ); + } + + /** + */ + public function mailgun_api_key_callback() { + printf( '', null !== $this->options->getMailgunApiKey() ? esc_attr( PostmanUtils::obfuscatePassword( $this->options->getMailgunApiKey() ) ) : '', __( 'Required', 'post-smtp' ) ); + print ''; + } + + function mailgun_domain_name_callback() { + printf( '', null !== $this->options->getMailgunDomainName() ? esc_attr( $this->options->getMailgunDomainName() ) : '', __( 'Required', 'post-smtp' ) ); + } + + function mailgun_region_callback() { + $value = $this->options->getMailgunRegion(); + printf( '', null !== $value ? ' checked' : '' ); + } + + /** + */ + public function registerStylesAndScripts() { + // register the stylesheet and javascript external resources + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + wp_register_script( 'postman_mailgun_script', plugins_url( 'Postman/Postman-Mail/postman_mailgun.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + PostmanViewController::POSTMAN_SCRIPT, + ), $pluginData ['version'] ); + } + + /** + */ + public function enqueueScript() { + wp_enqueue_script( 'postman_mailgun_script' ); + } + + /** + */ + public function printWizardAuthenticationStep() { + print '
    '; + $this->printMailgunAuthSectionInfo(); + printf( '', __( 'API Key', 'post-smtp' ) ); + print '
    '; + print $this->mailgun_api_key_callback(); + printf( '', __( 'Domain Name', 'post-smtp' ) ); + print '
    '; + print $this->mailgun_domain_name_callback(); + print '
    '; + printf( '', __( 'Mailgun Europe Region?', 'post-smtp' ) ); + print '
    '; + print $this->mailgun_region_callback(); + print '
    '; + } +} diff --git a/Postman/Postman-Mail/PostmanMandrillMailEngine.php b/Postman/Postman-Mail/PostmanMandrillMailEngine.php new file mode 100644 index 0000000..74980d3 --- /dev/null +++ b/Postman/Postman-Mail/PostmanMandrillMailEngine.php @@ -0,0 +1,238 @@ +apiKey = $apiKey; + + // create the logger + $this->logger = new PostmanLogger( get_class( $this ) ); + + // create the Message + $this->mandrillMessage = array( + 'to' => array(), + 'headers' => array(), + ); + } + + /** + * (non-PHPdoc) + * + * @see PostmanSmtpEngine::send() + */ + public function send( PostmanMessage $message ) { + $options = PostmanOptions::getInstance(); + + // add the Postman signature - append it to whatever the user may have set + if ( ! $options->isStealthModeEnabled() ) { + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + $this->addHeader( 'X-Mailer', sprintf( 'Postman SMTP %s for WordPress (%s)', $pluginData ['version'], 'https://wordpress.org/plugins/post-smtp/' ) ); + } + + // add the headers - see http://framework.zend.com/manual/1.12/en/zend.mail.additional-headers.html + foreach ( ( array ) $message->getHeaders() as $header ) { + $this->logger->debug( sprintf( 'Adding user header %s=%s', $header ['name'], $header ['content'] ) ); + $this->addHeader( $header ['name'], $header ['content'], true ); + } + + // if the caller set a Content-Type header, use it + $contentType = $message->getContentType(); + if ( ! empty( $contentType ) ) { + $this->logger->debug( 'Adding content-type ' . $contentType ); + $this->addHeader( 'Content-Type', $contentType ); + } + + // add the From Header + $sender = $message->getFromAddress(); + { + $senderEmail = PostmanOptions::getInstance()->getMessageSenderEmail(); + $senderName = $sender->getName(); + assert( ! empty( $senderEmail ) ); + $this->mandrillMessage ['from_email'] = $senderEmail; + if ( ! empty( $senderName ) ) { + $this->mandrillMessage ['from_name'] = $senderName; + } + // now log it + $sender->log( $this->logger, 'From' ); + } + + // add the Sender Header, overriding what the user may have set + $this->addHeader( 'Sender', $options->getEnvelopeSender() ); + + // add the to recipients + foreach ( ( array ) $message->getToRecipients() as $recipient ) { + $recipient->log( $this->logger, 'To' ); + $recipient = array( + 'email' => $recipient->getEmail(), + 'name' => $recipient->getName(), + 'type' => 'to', + ); + array_push( $this->mandrillMessage ['to'], $recipient ); + } + + // add the cc recipients + foreach ( ( array ) $message->getCcRecipients() as $recipient ) { + $recipient->log( $this->logger, 'Cc' ); + $recipient = array( + 'email' => $recipient->getEmail(), + 'name' => $recipient->getName(), + 'type' => 'cc', + ); + array_push( $this->mandrillMessage ['to'], $recipient ); + } + + // add the bcc recipients + foreach ( ( array ) $message->getBccRecipients() as $recipient ) { + $recipient->log( $this->logger, 'Bcc' ); + $recipient = array( + 'email' => $recipient->getEmail(), + 'name' => $recipient->getName(), + 'type' => 'bcc', + ); + array_push( $this->mandrillMessage ['to'], $recipient ); + } + + // add the reply-to + $replyTo = $message->getReplyTo(); + // $replyTo is null or a PostmanEmailAddress object + if ( isset( $replyTo ) ) { + $this->addHeader( 'reply-to', $replyTo->format() ); + } + + // add the date + $date = $message->getDate(); + if ( ! empty( $date ) ) { + $this->addHeader( 'date', $message->getDate() ); + } + + // add the messageId + $messageId = $message->getMessageId(); + if ( ! empty( $messageId ) ) { + $this->addHeader( 'message-id', $messageId ); + } + + // add the subject + if ( null !== $message->getSubject() ) { + $this->mandrillMessage ['subject'] = $message->getSubject(); + } + + // add the message content + { + $textPart = $message->getBodyTextPart(); + if ( ! empty( $textPart ) ) { + $this->logger->debug( 'Adding body as text' ); + $this->mandrillMessage ['text'] = $textPart; + } + $htmlPart = $message->getBodyHtmlPart(); + if ( ! empty( $htmlPart ) ) { + $this->logger->debug( 'Adding body as html' ); + $this->mandrillMessage ['html'] = $htmlPart; + } + } + + // add attachments + $this->logger->debug( 'Adding attachments' ); + $this->addAttachmentsToMail( $message ); + + $result = array(); + try { + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Creating Mandrill service with apiKey=' . $this->apiKey ); + } + $mandrill = new Postman_Mandrill( $this->apiKey ); + + // send the message + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Sending mail' ); + } + + $result = $mandrill->messages->send( $this->mandrillMessage ); + if ( $this->logger->isInfo() ) { + $this->logger->info( sprintf( 'Message %d accepted for delivery', PostmanState::getInstance()->getSuccessfulDeliveries() + 1 ) ); + } + + $this->transcript = print_r( $result, true ); + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= print_r( $this->mandrillMessage, true ); + } catch ( Exception $e ) { + $this->transcript = $e->getMessage(); + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= print_r( $this->mandrillMessage, true ); + throw $e; + } + } + private function addHeader( $key, $value, $append = false ) { + $this->logger->debug( 'Adding header: ' . $key . ' = ' . $value ); + $header = &$this->mandrillMessage ['headers']; + if ( $append && ! empty( $header [ $key ] ) ) { + $header [ $key ] = $header [ $key ] . ', ' . $value; + } else { + $header [ $key ] = $value; + } + } + + /** + * Add attachments to the message + * + * @param Postman_Zend_Mail $mail + */ + private function addAttachmentsToMail( PostmanMessage $message ) { + $attachments = $message->getAttachments(); + if ( isset( $attachments ) ) { + $this->mandrillMessage ['attachments'] = array(); + if ( ! is_array( $attachments ) ) { + // WordPress may a single filename or a newline-delimited string list of multiple filenames + $attArray = explode( PHP_EOL, $attachments ); + } else { + $attArray = $attachments; + } + // otherwise WordPress sends an array + foreach ( $attArray as $file ) { + if ( ! empty( $file ) ) { + $this->logger->debug( 'Adding attachment: ' . $file ); + $attachment = array( + 'type' => 'attachment', + 'name' => basename( $file ), + 'content' => base64_encode( file_get_contents( $file ) ), + ); + array_push( $this->mandrillMessage ['attachments'], $attachment ); + } + } + } + } + + // return the SMTP session transcript + public function getTranscript() { + return $this->transcript; + } + } +} + diff --git a/Postman/Postman-Mail/PostmanMandrillTransport.php b/Postman/Postman-Mail/PostmanMandrillTransport.php new file mode 100644 index 0000000..3279f2b --- /dev/null +++ b/Postman/Postman-Mail/PostmanMandrillTransport.php @@ -0,0 +1,280 @@ +getMandrillApiKey (); + return $data; + } + public function getProtocol() { + return 'https'; + } + + // this should be standard across all transports + public function getSlug() { + return self::SLUG; + } + public function getName() { + return __ ( 'Mandrill API', 'post-smtp' ); + } + /** + * v0.2.1 + * + * @return string + */ + public function getHostname() { + return self::HOST; + } + /** + * v0.2.1 + * + * @return int + */ + public function getPort() { + return self::PORT; + } + /** + * v1.7.0 + * + * @return string + */ + public function getTransportType() { + return 'mandrill_api'; + } + /** + * v0.2.1 + * + * @return string + */ + public function getAuthenticationType() { + return ''; + } + /** + * v0.2.1 + * + * @return string + */ + public function getSecurityType() { + return self::PROTOCOL; + } + /** + * v0.2.1 + * + * @return string + */ + public function getCredentialsId() { + return $this->options->getClientId (); + } + /** + * v0.2.1 + * + * @return string + */ + public function getCredentialsSecret() { + return $this->options->getClientSecret (); + } + public function isServiceProviderGoogle($hostname) { + return false; + } + public function isServiceProviderMicrosoft($hostname) { + return false; + } + public function isServiceProviderYahoo($hostname) { + return false; + } + public function isOAuthUsed($authType) { + return false; + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::createMailEngine() + */ + public function createMailEngine() { + $apiKey = $this->options->getMandrillApiKey (); + require_once 'PostmanMandrillMailEngine.php'; + $engine = new PostmanMandrillMailEngine ( $apiKey ); + return $engine; + } + + /** + * This short description of the Transport State shows on the Summary screens + * (non-PHPdoc) + * + * @see PostmanModuleTransport::getDeliveryDetails() + */ + public function getDeliveryDetails() { + /* translators: where (1) is the secure icon and (2) is the transport name */ + return sprintf ( __ ( 'Postman will send mail via the %1$s %2$s.', 'post-smtp' ), '🔐', $this->getName () ); + } + + /** + * (non-PHPdoc) + * + * @see PostmanAbstractModuleTransport::validateTransportConfiguration() + */ + protected function validateTransportConfiguration() { + $messages = parent::validateTransportConfiguration (); + $apiKey = $this->options->getMandrillApiKey (); + if (empty ( $apiKey )) { + array_push ( $messages, __ ( 'API Key can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady (); + } + if (! $this->isSenderConfigured ()) { + array_push ( $messages, __ ( 'Message From Address can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady (); + } + return $messages; + } + + /** + * Mandrill API doesn't care what the hostname or guessed SMTP Server is; it runs it's port test no matter what + */ + public function getSocketsForSetupWizardToProbe($hostname, $smtpServerGuess) { + $hosts = array ( + self::createSocketDefinition ( $this->getHostname (), $this->getPort () ) + ); + return $hosts; + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::getConfigurationBid() + */ + public function getConfigurationBid(PostmanWizardSocket $hostData, $userAuthOverride, $originalSmtpServer) { + $recommendation = array (); + $recommendation ['priority'] = 0; + $recommendation ['transport'] = self::SLUG; + $recommendation ['hostname'] = null; // scribe looks this + $recommendation ['label'] = $this->getName (); + if ($hostData->hostname == self::HOST && $hostData->port == self::PORT) { + $recommendation ['priority'] = self::PRIORITY; + /* translators: where variables are (1) transport name (2) host and (3) port */ + $recommendation ['message'] = sprintf ( __ ( ('Postman recommends the %1$s to host %2$s on port %3$d.') ), $this->getName (), self::HOST, self::PORT ); + } + return $recommendation; + } + + /** + */ + public function createOverrideMenu(PostmanWizardSocket $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride) { + $overrideItem = parent::createOverrideMenu ( $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride ); + // push the authentication options into the $overrideItem structure + $overrideItem ['auth_items'] = array ( + array ( + 'selected' => true, + 'name' => __ ( 'API Key', 'post-smtp' ), + 'value' => 'api_key' + ) + ); + return $overrideItem; + } + + /** + * Functions to execute on the admin_init event + * + * "Runs at the beginning of every admin page before the page is rendered." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_an_Admin_Page_Request + */ + public function on_admin_init() { + // only administrators should be able to trigger this + if (PostmanUtils::isAdmin ()) { + $this->addSettings (); + $this->registerStylesAndScripts (); + } + } + + /* + * What follows in the code responsible for creating the Admin Settings page + */ + + /** + */ + public function addSettings() { + // the Mandrill Auth section + add_settings_section ( PostmanMandrillTransport::MANDRILL_AUTH_SECTION, __ ( 'Authentication', 'post-smtp' ), array ( + $this, + 'printMandrillAuthSectionInfo' + ), PostmanMandrillTransport::MANDRILL_AUTH_OPTIONS ); + + add_settings_field ( PostmanOptions::MANDRILL_API_KEY, __ ( 'API Key', 'post-smtp' ), array ( + $this, + 'mandrill_api_key_callback' + ), PostmanMandrillTransport::MANDRILL_AUTH_OPTIONS, PostmanMandrillTransport::MANDRILL_AUTH_SECTION ); + } + + /** + */ + public function printMandrillAuthSectionInfo() { + /* Translators: Where (1) is the service URL and (2) is the service name and (3) is a api key URL */ + printf ( '

    %s

    ', sprintf ( __ ( 'Create an account at %2$s and enter an API key below.', 'post-smtp' ), 'https://mandrillapp.com', 'Mandrillapp.com', 'https://mandrillapp.com/settings' ) ); + } + + /** + */ + public function mandrill_api_key_callback() { + printf ( '', null !== $this->options->getMandrillApiKey () ? esc_attr ( PostmanUtils::obfuscatePassword ( $this->options->getMandrillApiKey () ) ) : '', __ ( 'Required', 'post-smtp' ) ); + print ' '; + } + + /** + */ + public function registerStylesAndScripts() { + // register the stylesheet and javascript external resources + $pluginData = apply_filters ( 'postman_get_plugin_metadata', null ); + wp_register_script ( 'postman_mandrill_script', plugins_url ( 'Postman/Postman-Mail/postman_mandrill.js', $this->rootPluginFilenameAndPath ), array ( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + PostmanViewController::POSTMAN_SCRIPT + ), $pluginData ['version'] ); + } + + /** + */ + public function enqueueScript() { + wp_enqueue_script ( 'postman_mandrill_script' ); + } + + /** + */ + public function printWizardAuthenticationStep() { + print '
    '; + $this->printMandrillAuthSectionInfo (); + printf ( '', __ ( 'API Key', 'post-smtp' ) ); + print '
    '; + print $this->mandrill_api_key_callback (); + print '
    '; + } +} diff --git a/Postman/Postman-Mail/PostmanMessage.php b/Postman/Postman-Mail/PostmanMessage.php new file mode 100644 index 0000000..12099ba --- /dev/null +++ b/Postman/Postman-Mail/PostmanMessage.php @@ -0,0 +1,824 @@ +logger = new PostmanLogger( get_class( $this ) ); + $this->headers = array(); + $this->toRecipients = array(); + $this->ccRecipients = array(); + $this->bccRecipients = array(); + } + + function __get( $name ) { + $message = __( '%1$s property of a PostmanMessage object is not supported. For now all of this class properties are private.', 'post-smtp' ); + + if ( WP_DEBUG ) { + trigger_error( sprintf( $message, $name ) ); + } + } + + function __call($name, $args) { + $class = new ReflectionClass(__CLASS__); + $methods = $class->getMethods(ReflectionMethod::IS_PUBLIC ); + + $message = __( '%1$s method of a PostmanMessage object is not supported. Use one of the following methods 
    %2$s
    ', 'post-smtp' ); + + if ( WP_DEBUG ) { + trigger_error( sprintf( $message, $name, print_r( $methods, true ) ) ); + } + } + + /** + * + * @return boolean + */ + public function isBodyPartsEmpty() { + return empty( $this->bodyTextPart ) && empty( $this->bodyHtmlPart ); + } + + /** + * + * @param PostmanModuleTransport $transport + */ + public function validate( PostmanModuleTransport $transport ) { + if ( $transport->isEmailValidationSupported() ) { + $this->internalValidate(); + } + } + + /** + * Create body parts based on content type + * MyMail creates its own body parts + */ + public function createBodyParts() { + + // modify the content-type to include the boundary + if ( false !== stripos( $this->contentType, 'multipart' ) && ! empty( $this->boundary ) ) { + // Lines in email are terminated by CRLF ("\r\n") according to RFC2821 + $this->contentType = sprintf( "%s;\r\n\t boundary=\"%s\"", $this->contentType, $this->getBoundary() ); + } + + $body = $this->getBody(); + $contentType = $this->getContentType(); + // add the message content as either text or html + if ( empty( $contentType ) || substr( $contentType, 0, 10 ) === 'text/plain' ) { + $this->logger->debug( 'Creating text body part' ); + $this->setBodyTextPart( $body ); + } else if ( substr( $contentType, 0, 9 ) === 'text/html' ) { + $this->logger->debug( 'Creating html body part' ); + $this->setBodyHtmlPart( $body ); + } else if ( substr( $contentType, 0, 21 ) === 'multipart/alternative' ) { + $this->logger->debug( 'Adding body as multipart/alternative' ); + $arr = explode( PHP_EOL, $body ); + $textBody = ''; + $htmlBody = ''; + $mode = ''; + foreach ( $arr as $s ) { + $this->logger->trace( 'mode: ' . $mode . ' bodyline: ' . $s ); + if ( substr( $s, 0, 25 ) === 'Content-Type: text/plain;' ) { + $mode = 'foundText'; + } else if ( substr( $s, 0, 24 ) === 'Content-Type: text/html;' ) { + $mode = 'foundHtml'; + } else if ( $mode == 'textReading' ) { + $textBody .= $s; + } else if ( $mode == 'htmlReading' ) { + $htmlBody .= $s; + } else if ( $mode == 'foundText' ) { + $trim = trim( $s ); + if ( empty( $trim ) ) { + $mode = 'textReading'; + } + } else if ( $mode == 'foundHtml' ) { + $trim = trim( $s ); + if ( empty( $trim ) ) { + $mode = 'htmlReading'; + } + } + } + $this->setBodyHtmlPart( $htmlBody ); + $this->setBodyTextPart( $textBody ); + } else { + $this->logger->error( 'Unknown content-type: ' . $contentType ); + $this->setBodyTextPart( $body ); + } + } + + /** + * Apply the WordPress filters to the email + */ + public function applyFilters() { + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Applying WordPress filters' ); + } + + /** + * Filter the email address to send from. + * + * @since 2.2.0 + * + * @param string $from_email + * Email address to send from. + */ + $filteredEmail = apply_filters( 'wp_mail_from', $this->getFromAddress()->getEmail() ); + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'wp_mail_from: ' . $filteredEmail ); + } + if ( $this->getFromAddress()->getEmail() !== $filteredEmail ) { + $this->logger->debug( sprintf( 'Filtering From email address: before=%s after=%s', $this->getFromAddress()->getEmail(), $filteredEmail ) ); + $this->getFromAddress()->setEmail( $filteredEmail ); + } + + /** + * Filter the name to associate with the "from" email address. + * + * @since 2.3.0 + * + * @param string $from_name + * Name associated with the "from" email address. + */ + $filteredName = apply_filters( 'wp_mail_from_name', $this->getFromAddress()->getName() ); + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'wp_mail_from_name: ' . $filteredName ); + } + if ( $this->getFromAddress()->getName() !== $filteredName ) { + $this->logger->debug( sprintf( 'Filtering From email name: before=%s after=%s', $this->getFromAddress()->getName(), $filteredName ) ); + $this->getFromAddress()->setName( $filteredName ); + } + + /** + * Filter the default wp_mail() charset. + * + * @since 2.3.0 + * + * @param string $charset + * Default email charset. + */ + $filteredCharset = apply_filters( 'wp_mail_charset', $this->getCharset() ); + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'wp_mail_charset: ' . $filteredCharset ); + } + if ( $this->getCharset() !== $filteredCharset ) { + $this->logger->debug( sprintf( 'Filtering Charset: before=%s after=%s', $this->getCharset(), $filteredCharset ) ); + $this->setCharset( $filteredCharset ); + } + + /** + * Filter the wp_mail() content type. + * + * @since 2.3.0 + * + * @param string $content_type + * Default wp_mail() content type. + */ + $filteredContentType = apply_filters( 'wp_mail_content_type', $this->getContentType() ); + if ( $this->logger->isTrace() ) { + $this->logger->trace( sprintf( 'wp_mail_content_type: "%s"', $filteredContentType ) ); + } + if ( $this->getContentType() != $filteredContentType ) { + $this->logger->debug( sprintf( 'Filtering Content-Type: before=%s after=%s', $this->getContentType(), $filteredContentType ) ); + $this->setContentType( $filteredContentType ); + } + + // Postman has it's own 'user override' filter + $options = PostmanOptions::getInstance(); + $forcedEmailAddress = $options->getMessageSenderEmail(); + if ( $options->isSenderEmailOverridePrevented() && $this->getFromAddress()->getEmail() !== $forcedEmailAddress ) { + $this->logger->debug( sprintf( 'Forced From email address: before=%s after=%s', $this->getFromAddress()->getEmail(), $forcedEmailAddress ) ); + $this->getFromAddress()->setEmail( $forcedEmailAddress ); + } + + if ( $options->is_fallback ) { + $fallback_email = $options->getFallbackFromEmail(); + $this->logger->debug( sprintf( 'Fallback: Forced From email address: before=%s after=%s', $this->getFromAddress()->getEmail(), $fallback_email ) ); + $this->getFromAddress()->setEmail( $fallback_email ); + } + + $forcedEmailName = $options->getMessageSenderName(); + if ( $options->isSenderNameOverridePrevented() && $this->getFromAddress()->getName() !== $forcedEmailName ) { + $this->logger->debug( sprintf( 'Forced From email name: before=%s after=%s', $this->getFromAddress()->getName(), $forcedEmailName ) ); + $this->getFromAddress()->setName( $forcedEmailName ); + } + } + + /** + * Check all email headers for errors + * Throw an exception if an error is found + */ + private function internalValidate() { + // check the reply-to address for errors + if ( isset( $this->replyTo ) ) { + $this->getReplyTo()->validate( 'Reply-To' ); + } + + // check the from address for errors + $this->getFromAddress()->validate( 'From' ); + + // validate the To recipients + foreach ( ( array ) $this->getToRecipients() as $toRecipient ) { + $toRecipient->validate( 'To' ); + } + + // validate the Cc recipients + foreach ( ( array ) $this->getCcRecipients() as $ccRecipient ) { + $ccRecipient->validate( 'Cc' ); + } + + // validate the Bcc recipients + foreach ( ( array ) $this->getBccRecipients() as $bccRecipient ) { + $bccRecipient->validate( 'Bcc' ); + } + } + + /** + * + * @return PostmanEmailAddress + */ + public function getFromAddress() { + return $this->from; + } + + /** + * Get the charset, checking first the WordPress bloginfo, then the header, then the wp_mail_charset filter. + * + * @return string + */ + public function getCharset() { + return $this->charset; + } + + /** + * Set the charset + * + * @param mixed $charset + */ + public function setCharset( $charset ) { + $this->charset = $charset; + } + + /** + * Get the content type, checking first the header, then the wp_mail_content_type filter + * + * @return string + */ + public function getContentType() { + return $this->contentType; + } + public function setContentType( $contentType ) { + $this->contentType = $contentType; + } + /** + * + * @param mixed $recipients + * Array or comma-separated list of email addresses to send message. + * @throws Exception + */ + public function addTo( $to ) { + $this->addRecipients( $this->toRecipients, $to ); + } + /** + * + * @param mixed $recipients + * Array or comma-separated list of email addresses to send message. + * @throws Exception + */ + public function addCc( $cc ) { + $this->addRecipients( $this->ccRecipients, $cc ); + } + /** + * + * @param mixed $recipients + * Array or comma-separated list of email addresses to send message. + * @throws Exception + */ + public function addBcc( $bcc ) { + $this->addRecipients( $this->bccRecipients, $bcc ); + } + /** + * + * @param mixed $recipients + * Array or comma-separated list of email addresses to send message. + * @throws Exception + */ + private function addRecipients( &$recipientList, $recipients ) { + if ( ! empty( $recipients ) ) { + $recipients = PostmanEmailAddress::convertToArray( $recipients ); + foreach ( $recipients as $recipient ) { + if ( ! empty( $recipient ) ) { + $this->logger->debug( sprintf( 'User added recipient: "%s"', $recipient ) ); + array_push( $recipientList, new PostmanEmailAddress( $recipient ) ); + } + } + } + } + + /** + * For the string version, each header line (beginning with From:, Cc:, etc.) is delimited with a newline ("\r\n") + */ + public function addHeaders( $headers ) { + if ( ! is_array( $headers ) ) { + // WordPress may send a string where "each header line (beginning with From:, Cc:, etc.) is delimited with a newline ("\r\n") (advanced)" + // this converts that string to an array + $headers = explode( "\n", str_replace( "\r\n", "\n", $headers ) ); + // $headers = explode ( PHP_EOL, $headers ); + } + // otherwise WordPress sends an array + foreach ( $headers as $header ) { + if ( ! empty( $header ) ) { + // boundary may be in a header line, but it's not a header + // eg. boundary="----=_NextPart_DC7E1BB5... + if ( strpos( $header, ':' ) === false ) { + if ( false !== stripos( $header, 'boundary=' ) ) { + $parts = preg_split( '/boundary=/i', trim( $header ) ); + $this->boundary = trim( str_replace( array( + "'", + '"', + ), '', $parts [1] ) ); + $this->logger->debug( sprintf( 'Processing special boundary header \'%s\'', $this->getBoundary() ) ); + } else { + $this->logger->debug( sprintf( 'Ignoring broken header \'%s\'', $header ) ); + } + continue; + } + list ( $name, $content ) = explode( ':', trim( $header ), 2 ); + $this->processHeader( $name, $content ); + } + } + } + + /** + * Add the headers that were processed in processHeaders() + * Zend requires that several headers are specially handled. + * + * @param mixed $name + * @param mixed $value + * @param Postman_Zend_Mail $mail + */ + private function processHeader( $name, $content ) { + $name = trim( $name ); + $content = trim( $content ); + switch ( strtolower( $name ) ) { + case 'content-type' : + $this->logProcessHeader( 'Content-Type', $name, $content ); + if ( strpos( $content, ';' ) !== false ) { + list ( $type, $charset ) = explode( ';', $content ); + $this->setContentType( trim( $type ) ); + if ( false !== stripos( $charset, 'charset=' ) ) { + $charset = trim( str_replace( array( + 'charset=', + '"', + ), '', $charset ) ); + } elseif ( false !== stripos( $charset, 'boundary=' ) ) { + $this->boundary = trim( str_replace( array( + 'BOUNDARY=', + 'boundary=', + '"', + ), '', $charset ) ); + $charset = ''; + } + if ( ! empty( $charset ) ) { + $this->setCharset( $charset ); + } + } else { + $this->setContentType( trim( $content ) ); + } + break; + case 'to' : + $this->logProcessHeader( 'To', $name, $content ); + $this->addTo( $content ); + break; + case 'cc' : + $this->logProcessHeader( 'Cc', $name, $content ); + $this->addCc( $content ); + break; + case 'bcc' : + $this->logProcessHeader( 'Bcc', $name, $content ); + $this->addBcc( $content ); + break; + case 'from' : + $this->logProcessHeader( 'From', $name, $content ); + $this->setFrom( $content ); + break; + case 'subject' : + $this->logProcessHeader( 'Subject', $name, $content ); + $this->setSubject( $content ); + break; + case 'reply-to' : + $this->logProcessHeader( 'Reply-To', $name, $content ); + $this->setReplyTo( $content ); + break; + case 'sender' : + $this->logProcessHeader( 'Sender', $name, $content ); + $this->logger->warn( sprintf( 'Ignoring Sender header \'%s\'', $content ) ); + break; + case 'return-path' : + $this->logProcessHeader( 'Return-Path', $name, $content ); + $this->logger->warn( sprintf( 'Ignoring Return-Path header \'%s\'', $content ) ); + break; + case 'date' : + $this->logProcessHeader( 'Date', $name, $content ); + $this->setDate( $content ); + break; + case 'message-id' : + $this->logProcessHeader( 'Message-Id', $name, $content ); + $this->setMessageId( $content ); + break; + default : + // Add it to our grand headers array + $this->logProcessHeader( 'other', $name, $content ); + array_push( $this->headers, array( + 'name' => $name, + 'content' => $content, + ) ); + break; + } + } + + /** + * + * @param mixed $desc + * @param mixed $name + * @param mixed $content + */ + private function logProcessHeader( $desc, $name, $content ) { + $this->logger->debug( 'Processing ' . $desc . ' Header - ' . $name . ': ' . $content ); + } + + /** + * Add attachments to the message + * + * @param Postman_Zend_Mail $mail + */ + public function addAttachmentsToMail( Postman_Zend_Mail $mail ) { + $attachments = $this->attachments; + if ( ! is_array( $attachments ) ) { + // WordPress may a single filename or a newline-delimited string list of multiple filenames + $attArray = explode( PHP_EOL, $attachments ); + } else { + $attArray = $attachments; + } + // otherwise WordPress sends an array + foreach ( $attArray as $file ) { + if ( ! empty( $file ) ) { + $this->logger->debug( 'Adding attachment: ' . $file ); + $at = new Postman_Zend_Mime_Part( file_get_contents( $file ) ); + // $at->type = 'image/gif'; + $at->disposition = Postman_Zend_Mime::DISPOSITION_ATTACHMENT; + $at->encoding = Postman_Zend_Mime::ENCODING_BASE64; + $at->filename = basename( $file ); + $mail->addAttachment( $at ); + } + } + } + function setBody( $body ) { + $this->body = $body; + } + function setBodyTextPart( $bodyTextPart ) { + $this->bodyTextPart = $bodyTextPart; + } + function setBodyHtmlPart( $bodyHtmlPart ) { + $this->bodyHtmlPart = $bodyHtmlPart; + } + function setSubject( $subject ) { + $this->subject = $subject; + } + function setAttachments( $attachments ) { + $this->attachments = $attachments; + } + function setFrom( $email, $name = null ) { + if ( ! empty( $email ) ) { + $this->from = new PostmanEmailAddress( $email, $name ); + } + } + function setReplyTo( $replyTo ) { + if ( ! empty( $replyTo ) ) { + $this->replyTo = new PostmanEmailAddress( $replyTo ); + } + } + function setMessageId( $messageId ) { + $this->messageId = $messageId; + } + function setDate( $date ) { + $this->date = $date; + } + + // return the headers + public function getHeaders() { + return $this->headers; + } + public function getBoundary() { + return $this->boundary; + } + public function getToRecipients() { + return $this->toRecipients; + } + public function getCcRecipients() { + return $this->ccRecipients; + } + public function getBccRecipients() { + return $this->bccRecipients; + } + public function getReplyTo() { + return $this->replyTo; + } + public function getDate() { + return $this->date; + } + public function getMessageId() { + return $this->messageId; + } + public function getSubject() { + return $this->subject; + } + public function getBody() { + return $this->body; + } + public function getBodyTextPart() { + return $this->bodyTextPart; + } + public function getBodyHtmlPart() { + return $this->bodyHtmlPart; + } + public function getAttachments() { + return $this->attachments; + } + + /** + * @todo + * is this right? maybe extending the phpmailer class insted? + */ + + /** + * Add an embedded (inline) attachment from a file. + * This can include images, sounds, and just about any other document type. + * These differ from 'regular' attachments in that they are intended to be + * displayed inline with the message, not just attached for download. + * This is used in HTML messages that embed the images + * the HTML refers to using the $cid value. + * Never use a user-supplied path to a file! + * @param string $path Path to the attachment. + * @param string $cid Content ID of the attachment; Use this to reference + * the content when using an embedded image in HTML. + * @param string $name Overrides the attachment name. + * @param string $encoding File encoding (see $Encoding). + * @param string $type File MIME type. + * @param string $disposition Disposition to use + * @return boolean True on successfully adding an attachment + */ + public function addEmbeddedImage($path, $cid, $name = '', $encoding = 'base64', $type = '', $disposition = 'inline') { + if (!@is_file($path)) { + return false; + } + + // If a MIME type is not specified, try to work it out from the file name + if ($type == '') { + $type = self::filenameToType($path); + } + + $filename = basename($path); + if ($name == '') { + $name = $filename; + } + + // Append to $attachment array + $this->attachments[] = array( + 0 => $path, + 1 => $filename, + 2 => $name, + 3 => $encoding, + 4 => $type, + 5 => false, // isStringAttachment + 6 => $disposition, + 7 => $cid + ); + + return true; + } + + /** + * Get the MIME type for a file extension. + * @param string $ext File extension + * @access public + * @return string MIME type of file. + * @static + */ + public static function _mime_types($ext = '') + { + $mimes = array( + 'xl' => 'application/excel', + 'js' => 'application/javascript', + 'hqx' => 'application/mac-binhex40', + 'cpt' => 'application/mac-compactpro', + 'bin' => 'application/macbinary', + 'doc' => 'application/msword', + 'word' => 'application/msword', + 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', + 'xltx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.template', + 'potx' => 'application/vnd.openxmlformats-officedocument.presentationml.template', + 'ppsx' => 'application/vnd.openxmlformats-officedocument.presentationml.slideshow', + 'pptx' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation', + 'sldx' => 'application/vnd.openxmlformats-officedocument.presentationml.slide', + 'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', + 'dotx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.template', + 'xlam' => 'application/vnd.ms-excel.addin.macroEnabled.12', + 'xlsb' => 'application/vnd.ms-excel.sheet.binary.macroEnabled.12', + 'class' => 'application/octet-stream', + 'dll' => 'application/octet-stream', + 'dms' => 'application/octet-stream', + 'exe' => 'application/octet-stream', + 'lha' => 'application/octet-stream', + 'lzh' => 'application/octet-stream', + 'psd' => 'application/octet-stream', + 'sea' => 'application/octet-stream', + 'so' => 'application/octet-stream', + 'oda' => 'application/oda', + 'pdf' => 'application/pdf', + 'ai' => 'application/postscript', + 'eps' => 'application/postscript', + 'ps' => 'application/postscript', + 'smi' => 'application/smil', + 'smil' => 'application/smil', + 'mif' => 'application/vnd.mif', + 'xls' => 'application/vnd.ms-excel', + 'ppt' => 'application/vnd.ms-powerpoint', + 'wbxml' => 'application/vnd.wap.wbxml', + 'wmlc' => 'application/vnd.wap.wmlc', + 'dcr' => 'application/x-director', + 'dir' => 'application/x-director', + 'dxr' => 'application/x-director', + 'dvi' => 'application/x-dvi', + 'gtar' => 'application/x-gtar', + 'php3' => 'application/x-httpd-php', + 'php4' => 'application/x-httpd-php', + 'php' => 'application/x-httpd-php', + 'phtml' => 'application/x-httpd-php', + 'phps' => 'application/x-httpd-php-source', + 'swf' => 'application/x-shockwave-flash', + 'sit' => 'application/x-stuffit', + 'tar' => 'application/x-tar', + 'tgz' => 'application/x-tar', + 'xht' => 'application/xhtml+xml', + 'xhtml' => 'application/xhtml+xml', + 'zip' => 'application/zip', + 'mid' => 'audio/midi', + 'midi' => 'audio/midi', + 'mp2' => 'audio/mpeg', + 'mp3' => 'audio/mpeg', + 'mpga' => 'audio/mpeg', + 'aif' => 'audio/x-aiff', + 'aifc' => 'audio/x-aiff', + 'aiff' => 'audio/x-aiff', + 'ram' => 'audio/x-pn-realaudio', + 'rm' => 'audio/x-pn-realaudio', + 'rpm' => 'audio/x-pn-realaudio-plugin', + 'ra' => 'audio/x-realaudio', + 'wav' => 'audio/x-wav', + 'bmp' => 'image/bmp', + 'gif' => 'image/gif', + 'jpeg' => 'image/jpeg', + 'jpe' => 'image/jpeg', + 'jpg' => 'image/jpeg', + 'png' => 'image/png', + 'tiff' => 'image/tiff', + 'tif' => 'image/tiff', + 'eml' => 'message/rfc822', + 'css' => 'text/css', + 'html' => 'text/html', + 'htm' => 'text/html', + 'shtml' => 'text/html', + 'log' => 'text/plain', + 'text' => 'text/plain', + 'txt' => 'text/plain', + 'rtx' => 'text/richtext', + 'rtf' => 'text/rtf', + 'vcf' => 'text/vcard', + 'vcard' => 'text/vcard', + 'xml' => 'text/xml', + 'xsl' => 'text/xml', + 'mpeg' => 'video/mpeg', + 'mpe' => 'video/mpeg', + 'mpg' => 'video/mpeg', + 'mov' => 'video/quicktime', + 'qt' => 'video/quicktime', + 'rv' => 'video/vnd.rn-realvideo', + 'avi' => 'video/x-msvideo', + 'movie' => 'video/x-sgi-movie' + ); + if (array_key_exists(strtolower($ext), $mimes)) { + return $mimes[strtolower($ext)]; + } + return 'application/octet-stream'; + } + + /** + * Map a file name to a MIME type. + * Defaults to 'application/octet-stream', i.e.. arbitrary binary data. + * @param string $filename A file name or full path, does not need to exist as a file + * @return string + * @static + */ + public static function filenameToType($filename) + { + // In case the path is a URL, strip any query string before getting extension + $qpos = strpos($filename, '?'); + if (false !== $qpos) { + $filename = substr($filename, 0, $qpos); + } + $pathinfo = self::mb_pathinfo($filename); + return self::_mime_types($pathinfo['extension']); + } + + /** + * Multi-byte-safe pathinfo replacement. + * Drop-in replacement for pathinfo(), but multibyte-safe, cross-platform-safe, old-version-safe. + * Works similarly to the one in PHP >= 5.2.0 + * @link http://www.php.net/manual/en/function.pathinfo.php#107461 + * @param string $path A filename or path, does not need to exist as a file + * @param integer|string $options Either a PATHINFO_* constant, + * or a string name to return only the specified piece, allows 'filename' to work on PHP < 5.2 + * @return string|array + * @static + */ + public static function mb_pathinfo($path, $options = null) + { + $ret = array('dirname' => '', 'basename' => '', 'extension' => '', 'filename' => ''); + $pathinfo = array(); + if (preg_match('%^(.*?)[\\\\/]*(([^/\\\\]*?)(\.([^\.\\\\/]+?)|))[\\\\/\.]*$%im', $path, $pathinfo)) { + if (array_key_exists(1, $pathinfo)) { + $ret['dirname'] = $pathinfo[1]; + } + if (array_key_exists(2, $pathinfo)) { + $ret['basename'] = $pathinfo[2]; + } + if (array_key_exists(5, $pathinfo)) { + $ret['extension'] = $pathinfo[5]; + } + if (array_key_exists(3, $pathinfo)) { + $ret['filename'] = $pathinfo[3]; + } + } + switch ($options) { + case PATHINFO_DIRNAME: + case 'dirname': + return $ret['dirname']; + case PATHINFO_BASENAME: + case 'basename': + return $ret['basename']; + case PATHINFO_EXTENSION: + case 'extension': + return $ret['extension']; + case PATHINFO_FILENAME: + case 'filename': + return $ret['filename']; + default: + return $ret; + } + } + + } +} diff --git a/Postman/Postman-Mail/PostmanModuleTransport.php b/Postman/Postman-Mail/PostmanModuleTransport.php new file mode 100644 index 0000000..a0874e3 --- /dev/null +++ b/Postman/Postman-Mail/PostmanModuleTransport.php @@ -0,0 +1,758 @@ +logger = new PostmanLogger ( get_class ( $this ) ); + $this->options = PostmanOptions::getInstance (); + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + } + + /** + * Initialize the Module + * + * Perform validation and create configuration error messages. + * The module is not in a configured-and-ready state until initialization + */ + public function init() { + // create the scribe + $hostname = $this->getHostname (); + $this->scribe = $this->createScribe ( $hostname ); + + // validate the transport and generate error messages + $this->configurationMessages = $this->validateTransportConfiguration (); + } + + /** + * SendGrid API doesn't care what the hostname or guessed SMTP Server is; it runs it's port test no matter what + */ + public function getSocketsForSetupWizardToProbe($hostname, $smtpServerGuess) { + $hosts = array ( + self::createSocketDefinition ( $this->getHostname (), $this->getPort () ) + ); + return $hosts; + } + + /** + * Creates a single socket for the Wizard to test + */ + protected function createSocketDefinition($hostname, $port) { + $socket = array (); + $socket ['host'] = $hostname; + $socket ['port'] = $port; + $socket ['id'] = sprintf ( '%s-%s', $this->getSlug (), $port ); + $socket ['transport_id'] = $this->getSlug (); + $socket ['transport_name'] = $this->getName (); + $socket ['smtp'] = false; + return $socket; + } + + /** + * + * @param mixed $data + */ + public function prepareOptionsForExport($data) { + // no-op + return $data; + } + + /** + */ + public function printActionMenuItem() { + printf ( '
  • %s
    • ', $this->getScribe ()->getRequestPermissionLinkText () ); + } + + /** + * + * @param mixed $queryHostname + */ + protected function createScribe($hostname) { + $scribe = new PostmanNonOAuthScribe ( $hostname ); + return $scribe; + } + + /** + */ + public function enqueueScript() { + // no-op, this for subclasses + } + + /** + * This method is for internal use + */ + protected function validateTransportConfiguration() { + $this->configuredAndReady = true; + $messages = array (); + return $messages; + } + + /** + */ + protected function setNotConfiguredAndReady() { + $this->configuredAndReady = false; + } + + /** + * A short-hand way of showing the complete delivery method + * + * @param PostmanModuleTransport $transport + * @return string + */ + public function getPublicTransportUri() { + $name = $this->getSlug (); + $host = $this->getHostname (); + $port = $this->getPort (); + $protocol = $this->getProtocol (); + return sprintf ( '%s://%s:%s', $protocol, $host, $port ); + } + + /** + * The Message From Address + */ + public function getFromEmailAddress() { + return PostmanOptions::getInstance ()->getMessageSenderEmail (); + } + + /** + * The Message From Name + */ + public function getFromName() { + return PostmanOptions::getInstance ()->getMessageSenderName (); + } + public function getEnvelopeFromEmailAddress() { + return PostmanOptions::getInstance ()->getEnvelopeSender (); + } + public function isEmailValidationSupported() { + return ! PostmanOptions::getInstance ()->isEmailValidationDisabled (); + } + + /** + * Make sure the Senders are configured + * + * @param PostmanOptions $options + * @return boolean + */ + protected function isSenderConfigured() { + $options = PostmanOptions::getInstance (); + $messageFrom = $options->getMessageSenderEmail (); + return ! empty ( $messageFrom ); + } + + /** + * Get the configuration error messages + */ + public function getConfigurationMessages() { + return $this->configurationMessages; + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::isConfiguredAndReady() + */ + public function isConfiguredAndReady() { + return $this->configuredAndReady; + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::isReadyToSendMail() + */ + public function isReadyToSendMail() { + return $this->isConfiguredAndReady (); + } + + /** + * Determines whether Mail Engine locking is needed + * + * @see PostmanModuleTransport::requiresLocking() + */ + public function isLockingRequired() { + return false; + } + public function isOAuthUsed($authType) { + return $authType == PostmanOptions::AUTHENTICATION_TYPE_OAUTH2; + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::isWizardSupported() + */ + public function isWizardSupported() { + return false; + } + + /** + * This is for step 2 of the Wizard + */ + public function printWizardMailServerHostnameStep() { + } + + /** + * This is for step 4 of the Wizard + */ + public function printWizardAuthenticationStep() { + } + + /** + * + * @return PostmanNonOAuthScribe + */ + public function getScribe() { + return $this->scribe; + } + + /** + * + * @param mixed $hostname + * @param mixed $response + */ + public function populateConfiguration($hostname) { + $configuration = array (); + return $configuration; + } + /** + * + * @param mixed $winningRecommendation + * @param mixed $response + */ + public function populateConfigurationFromRecommendation($winningRecommendation) { + $configuration = array (); + $configuration ['message'] = $winningRecommendation ['message']; + $configuration [PostmanOptions::TRANSPORT_TYPE] = $winningRecommendation ['transport']; + return $configuration; + } + + /** + */ + public function createOverrideMenu(PostmanWizardSocket $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride) { + $overrideItem = array (); + $overrideItem ['secure'] = $socket->secure; + $overrideItem ['mitm'] = $socket->mitm; + $overrideItem ['hostname_domain_only'] = $socket->hostnameDomainOnly; + $overrideItem ['reported_hostname_domain_only'] = $socket->reportedHostnameDomainOnly; + $overrideItem ['value'] = $socket->id; + $overrideItem ['description'] = $socket->label; + $overrideItem ['selected'] = ($winningRecommendation ['id'] == $overrideItem ['value']); + return $overrideItem; + } + + /* + * ****************************************************************** + * Not deprecated, but I wish they didn't live here on the superclass + */ + public function isServiceProviderGoogle($hostname) { + return PostmanUtils::endsWith ( $hostname, 'gmail.com' ) || PostmanUtils::endsWith ( $hostname, 'googleapis.com' ); + } + public function isServiceProviderMicrosoft($hostname) { + return PostmanUtils::endsWith ( $hostname, 'live.com' ); + } + public function isServiceProviderYahoo($hostname) { + return strpos ( $hostname, 'yahoo' ); + } + + /* + * ******************************** + * Unused, deprecated methods follow + * ********************************* + */ + + /** + * + * @deprecated (non-PHPdoc) + * @see PostmanTransport::createZendMailTransport() + */ + public function createZendMailTransport($hostname, $config) { + } + + /** + * + * @deprecated (non-PHPdoc) + * @see PostmanTransport::isTranscriptSupported() + */ + public function isTranscriptSupported() { + return false; + } + + /** + * Only here because I can't remove it from the Interface + */ + public final function getMisconfigurationMessage(PostmanConfigTextHelper $scribe, PostmanOptionsInterface $options, PostmanOAuthToken $token) { + } + public final function isReady(PostmanOptionsInterface $options, PostmanOAuthToken $token) { + return ! ($this->isConfiguredAndReady ()); + } + public final function isConfigured(PostmanOptionsInterface $options, PostmanOAuthToken $token) { + return ! ($this->isConfiguredAndReady ()); + } + /** + * + * @deprecated (non-PHPdoc) + * @see PostmanTransport::getConfigurationRecommendation() + */ + public final function getConfigurationRecommendation($hostData) { + } + /** + * + * @deprecated (non-PHPdoc) + * @see PostmanTransport::getHostsToTest() + */ + public final function getHostsToTest($hostname) { + } + protected final function isHostConfigured(PostmanOptions $options) { + $hostname = $options->getHostname (); + $port = $options->getPort (); + return ! (empty ( $hostname ) || empty ( $port )); + } + /** + * + * @deprecated (non-PHPdoc) + * @see PostmanTransport::createPostmanMailAuthenticator() + */ + public final function createPostmanMailAuthenticator(PostmanOptions $options, PostmanOAuthToken $authToken) { + } +} + +/** + * For the transports which depend on Zend_Mail + * + * @author jasonhendriks + * + */ +abstract class PostmanAbstractZendModuleTransport extends PostmanAbstractModuleTransport implements PostmanZendModuleTransport { + private $oauthToken; + private $readyForOAuthGrant; + + /** + */ + public function __construct($rootPluginFilenameAndPath) { + parent::__construct ( $rootPluginFilenameAndPath ); + $this->oauthToken = PostmanOAuthToken::getInstance (); + } + public function getOAuthToken() { + return $this->oauthToken; + } + public function getProtocol() { + if ($this->getSecurityType () == PostmanOptions::SECURITY_TYPE_SMTPS) + return 'smtps'; + else + return 'smtp'; + } + public function getSecurityType() { + return PostmanOptions::getInstance ()->getEncryptionType (); + } + + /** + * + * @param mixed $data + */ + public function prepareOptionsForExport($data) { + $data = parent::prepareOptionsForExport ( $data ); + $data [PostmanOptions::BASIC_AUTH_PASSWORD] = PostmanOptions::getInstance ()->getPassword (); + return $data; + } + + /** + * + * @return boolean + */ + public function isEnvelopeFromValidationSupported() { + return $this->isEmailValidationSupported (); + } + + /** + */ + protected function setReadyForOAuthGrant() { + $this->readyForOAuthGrant = true; + } + + /** + */ + public function printActionMenuItem() { + if ($this->readyForOAuthGrant && $this->getAuthenticationType () == PostmanOptions::AUTHENTICATION_TYPE_OAUTH2) { + printf ( '
  • %s
    • ', PostmanUtils::getGrantOAuthPermissionUrl (), $this->getScribe ()->getRequestPermissionLinkText () ); + } else { + parent::printActionMenuItem (); + } + } + + /** + * + * @param mixed $queryHostname + */ + protected function createScribe($hostname) { + $scribe = null; + if ($this->isServiceProviderGoogle ( $hostname )) { + $scribe = new PostmanGoogleOAuthScribe (); + } else if ($this->isServiceProviderMicrosoft ( $hostname )) { + $scribe = new PostmanMicrosoftOAuthScribe (); + } else if ($this->isServiceProviderYahoo ( $hostname )) { + $scribe = new PostmanYahooOAuthScribe (); + } else { + $scribe = new PostmanNonOAuthScribe ( $hostname ); + } + return $scribe; + } + + /** + * A short-hand way of showing the complete delivery method + * + * @param PostmanModuleTransport $transport + * @return string + */ + public function getPublicTransportUri() { + $transportName = $this->getSlug (); + $options = PostmanOptions::getInstance (); + $auth = $this->getAuthenticationType ( $options ); + $protocol = $this->getProtocol (); + $security = $this->getSecurityType (); + $host = $this->getHostname ( $options ); + $port = $this->getPort ( $options ); + if (! empty ( $security ) && $security != 'ssl') { + return sprintf ( '%s:%s:%s://%s:%s', $protocol, $security, $auth, $host, $port ); + } else { + return sprintf ( '%s:%s://%s:%s', $protocol, $auth, $host, $port ); + } + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::getDeliveryDetails() + */ + public function getDeliveryDetails() { + $this->options = $this->options; + $deliveryDetails ['transport_name'] = $this->getTransportDescription ( $this->getSecurityType () ); + $deliveryDetails ['host'] = $this->getHostname () . ':' . $this->getPort (); + $deliveryDetails ['auth_desc'] = $this->getAuthenticationDescription ( $this->getAuthenticationType () ); + + if ( $deliveryDetails ['host'] == 'localhost:25' ) { + $deliveryDetails ['transport_name'] = __( 'Sendmail (server defualt - not SMTP)', 'post-smtp'); + } + + /* translators: where (1) is the transport type, (2) is the host, and (3) is the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 using OAuth 2.0 authentication.) */ + return sprintf ( __ ( 'Postman will send mail via %1$s to %2$s using %3$s authentication.', 'post-smtp' ), '' . $deliveryDetails ['transport_name'] . '', '' . $deliveryDetails ['host'] . '', '' . $deliveryDetails ['auth_desc'] . '' ); + } + + /** + * + * @param mixed $encType + * @return string + */ + protected function getTransportDescription($encType) { + $deliveryDetails = '🔓SMTP'; + if ($encType == PostmanOptions::SECURITY_TYPE_SMTPS) { + /* translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s is the encryption type (e.g. SSL or TLS) */ + $deliveryDetails = '🔐SMTPS'; + } else if ($encType == PostmanOptions::SECURITY_TYPE_STARTTLS) { + /* translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s is the encryption type (e.g. SSL or TLS) */ + $deliveryDetails = '🔐SMTP-STARTTLS'; + } + return $deliveryDetails; + } + + /** + * + * @param mixed $authType + */ + protected function getAuthenticationDescription($authType) { + if (PostmanOptions::AUTHENTICATION_TYPE_OAUTH2 == $authType) { + return 'OAuth 2.0'; + } else if (PostmanOptions::AUTHENTICATION_TYPE_NONE == $authType) { + return _x ( 'no', 'as in "There is no Spoon"', 'post-smtp' ); + } else { + switch ($authType) { + case PostmanOptions::AUTHENTICATION_TYPE_CRAMMD5 : + $authDescription = 'CRAM-MD5'; + break; + + case PostmanOptions::AUTHENTICATION_TYPE_LOGIN : + $authDescription = 'Login'; + break; + + case PostmanOptions::AUTHENTICATION_TYPE_PLAIN : + $authDescription = 'Plain'; + break; + + default : + $authDescription = $authType; + break; + } + return sprintf ( '%s (%s)', __ ( 'Password', 'post-smtp' ), $authDescription ); + } + } + + /** + * Make sure the Senders are configured + * + * @param PostmanOptions $options + * @return boolean + */ + protected function isEnvelopeFromConfigured() { + $options = PostmanOptions::getInstance (); + $envelopeFrom = $options->getEnvelopeSender (); + return ! empty ( $envelopeFrom ); + } + + /** + * (non-PHPdoc) + * + * @see PostmanTransport::getMisconfigurationMessage() + */ + protected function validateTransportConfiguration() { + parent::validateTransportConfiguration (); + $messages = parent::validateTransportConfiguration (); + if (! $this->isSenderConfigured ()) { + array_push ( $messages, __ ( 'Message From Address can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady (); + } + if ($this->getAuthenticationType () == PostmanOptions::AUTHENTICATION_TYPE_OAUTH2) { + if (! $this->isOAuth2ClientIdAndClientSecretConfigured ()) { + /* translators: %1$s is the Client ID label, and %2$s is the Client Secret label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) */ + array_push ( $messages, sprintf ( __ ( 'OAuth 2.0 authentication requires a %1$s and %2$s.', 'post-smtp' ), $this->getScribe ()->getClientIdLabel (), $this->getScribe ()->getClientSecretLabel () ) ); + $this->setNotConfiguredAndReady (); + } + } + return $messages; + } + + /** + * + * @return boolean + */ + protected function isOAuth2ClientIdAndClientSecretConfigured() { + $options = PostmanOptions::getInstance (); + $clientId = $options->getClientId (); + $clientSecret = $options->getClientSecret (); + return ! (empty ( $clientId ) || empty ( $clientSecret )); + } + + /** + * + * @return boolean + */ + protected function isPasswordAuthenticationConfigured(PostmanOptions $options) { + $username = $options->getUsername (); + $password = $options->getPassword (); + return $this->options->isAuthTypePassword () && ! (empty ( $username ) || empty ( $password )); + } + + /** + * + * @return boolean + */ + protected function isPermissionNeeded() { + $accessToken = $this->getOAuthToken ()->getAccessToken (); + $refreshToken = $this->getOAuthToken ()->getRefreshToken (); + return $this->isOAuthUsed ( PostmanOptions::getInstance ()->getAuthenticationType () ) && (empty ( $accessToken ) || empty ( $refreshToken )); + } + + /** + * + * @param mixed $hostname + * @param mixed $response + */ + public function populateConfiguration($hostname) { + $response = parent::populateConfiguration ( $hostname ); + $this->logger->debug ( sprintf ( 'populateConfigurationFromRecommendation for hostname %s', $hostname ) ); + $scribe = $this->createScribe ( $hostname ); + // checks to see if the host is an IP address and sticks the result in the response + // IP addresses are not allowed in the Redirect URL + $urlParts = parse_url ( $scribe->getCallbackUrl () ); + $response ['dot_notation_url'] = false; + if (isset ( $urlParts ['host'] )) { + if (PostmanUtils::isHostAddressNotADomainName ( $urlParts ['host'] )) { + $response ['dot_notation_url'] = true; + } + } + $response ['redirect_url'] = $scribe->getCallbackUrl (); + $response ['callback_domain'] = $scribe->getCallbackDomain (); + $response ['help_text'] = $scribe->getOAuthHelp (); + $response ['client_id_label'] = $scribe->getClientIdLabel (); + $response ['client_secret_label'] = $scribe->getClientSecretLabel (); + $response ['redirect_url_label'] = $scribe->getCallbackUrlLabel (); + $response ['callback_domain_label'] = $scribe->getCallbackDomainLabel (); + return $response; + } + + /** + * Populate the Ajax response for the Setup Wizard / Manual Configuration + * + * @param mixed $hostname + * @param mixed $response + */ + public function populateConfigurationFromRecommendation($winningRecommendation) { + $response = parent::populateConfigurationFromRecommendation ( $winningRecommendation ); + $response [PostmanOptions::AUTHENTICATION_TYPE] = $winningRecommendation ['auth']; + if (isset ( $winningRecommendation ['enc'] )) { + $response [PostmanOptions::SECURITY_TYPE] = $winningRecommendation ['enc']; + } + if (isset ( $winningRecommendation ['port'] )) { + $response [PostmanOptions::PORT] = $winningRecommendation ['port']; + } + if (isset ( $winningRecommendation ['hostname'] )) { + $response [PostmanOptions::HOSTNAME] = $winningRecommendation ['hostname']; + } + if (isset ( $winningRecommendation ['display_auth'] )) { + $response ['display_auth'] = $winningRecommendation ['display_auth']; + } + return $response; + } + + /** + */ + public function createOverrideMenu(PostmanWizardSocket $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride) { + $overrideItem = parent::createOverrideMenu ( $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride ); + $selected = $overrideItem ['selected']; + + // only smtp can have multiple auth options + $overrideAuthItems = array (); + $passwordMode = false; + $oauth2Mode = false; + $noAuthMode = false; + if (isset ( $userAuthOverride ) || isset ( $userSocketOverride )) { + if ($userAuthOverride == 'password') { + $passwordMode = true; + } elseif ($userAuthOverride == 'oauth2') { + $oauth2Mode = true; + } else { + $noAuthMode = true; + } + } else { + if ($winningRecommendation ['display_auth'] == 'password') { + $passwordMode = true; + } elseif ($winningRecommendation ['display_auth'] == 'oauth2') { + $oauth2Mode = true; + } else { + $noAuthMode = true; + } + } + if ($selected) { + if ($socket->auth_crammd5 || $socket->auth_login || $socket->authPlain) { + array_push ( $overrideAuthItems, array ( + 'selected' => $passwordMode, + 'name' => __ ( 'Password (requires username and password)', 'post-smtp' ), + 'value' => 'password' + ) ); + } + if ($socket->auth_xoauth || $winningRecommendation ['auth'] == 'oauth2') { + array_push ( $overrideAuthItems, array ( + 'selected' => $oauth2Mode, + 'name' => __ ( 'OAuth 2.0 (requires Client ID and Client Secret)', 'post-smtp' ), + 'value' => 'oauth2' + ) ); + } + if ($socket->auth_none) { + array_push ( $overrideAuthItems, array ( + 'selected' => $noAuthMode, + 'name' => __ ( 'None', 'post-smtp' ), + 'value' => 'none' + ) ); + } + + // marks at least one item as selected if none are selected + $atLeastOneSelected = false; + $firstItem = null; + // don't use variable reference see http://stackoverflow.com/questions/15024616/php-foreach-change-original-array-values + foreach ( $overrideAuthItems as $key => $field ) { + if (! $firstItem) { + $firstItem = $key; + } + if ($field ['selected']) { + $atLeastOneSelected = true; + } + } + if (! $atLeastOneSelected) { + $this->logger->debug ( 'nothing selected - forcing a selection on the *first* overrided auth item' ); + $overrideAuthItems [$firstItem] ['selected'] = true; + } + + // push the authentication options into the $overrideItem structure + $overrideItem ['auth_items'] = $overrideAuthItems; + } + return $overrideItem; + } +} + diff --git a/Postman/Postman-Mail/PostmanMyMailConnector.php b/Postman/Postman-Mail/PostmanMyMailConnector.php new file mode 100644 index 0000000..507b4e0 --- /dev/null +++ b/Postman/Postman-Mail/PostmanMyMailConnector.php @@ -0,0 +1,223 @@ +' ) ) { + // no-op + } else { + // create an instance of the Logger + $this->logger = new PostmanLogger( get_class( $this ) ); + $this->logger->debug( 'Starting' ); + + add_filter( 'mailster_delivery_methods', array( + &$this, + 'delivery_method', + ) ); + add_action( 'mailster_deliverymethod_tab_postman', array( + &$this, + 'deliverytab', + ) ); + + if ( mailster_option( 'deliverymethod' ) == MAILSTER_POSTMAN_ID ) { + add_action( 'mailster_initsend', array( + &$this, + 'initsend', + ) ); + add_action( 'mailster_presend', array( + &$this, + 'presend', + ) ); + add_action( 'mailster_dosend', array( + &$this, + 'dosend', + ) ); + add_action( 'MAILSTER_POSTMAN_cron', array( + &$this, + 'reset', + ) ); + } + } + } + + /** + * initsend function. + * + * uses mailster_initsend hook to set initial settings + * + * @access public + * @param mixed $mailobject + * @return void + */ + public function initsend( $mailobject ) { + $this->logger->trace( 'initsend' ); + // disable dkim + $mailobject->dkim = false; + } + + /** + * presend function. + * + * uses the mailster_presend hook to apply setttings before each mail + * + * @access public + * @param mixed $mailobject + * @return void + */ + public function presend( $mailobject ) { + + // embedding images doesn't work + $mailobject->embed_images = false; + + // use pre_send from the main class + // need the raw email body to send so we use the same option + $mailobject->pre_send(); + } + + /** + * dosend function. + * + * uses the mailster_dosend hook and triggers the send + * + * @access public + * @param mixed $mailobject + * @return void + */ + public function dosend( $mailobject ) { + $this->logger->trace( 'dosend' ); + $this->logger->trace( $mailobject->mailer ); + + // create a PostmanWpMail instance + $postmanWpMail = new PostmanWpMail(); + $postmanWpMail->init(); + + // create a PostmanMessage instance + $message = $postmanWpMail->createNewMessage(); + $message->addHeaders( $mailobject->headers ); + $message->setBodyTextPart( $mailobject->mailer->AltBody ); + $message->setBodyHtmlPart( $mailobject->mailer->Body ); + $message->setBody( $mailobject->mailer->AltBody . $mailobject->mailer->Body ); + $message->setSubject( $mailobject->subject ); + $message->addTo( $mailobject->to ); + $message->setReplyTo( $mailobject->reply_to ); + $message->setAttachments( $mailobject->attachments ); + + // create a PostmanEmailLog instance + $log = new PostmanEmailLog(); + + // send the message and store the result + $mailobject->sent = $postmanWpMail->sendMessage( $message, $log ); + + // give error message back to MyMail + $result = apply_filters( 'postman_wp_mail_result', null ); + if ( ! $mailobject->sent ) { + $mailobject->set_error( $result ['exception']->getMessage() ); + } + } + + /** + * reset function. + * + * resets the current time + * + * @access public + * @param mixed $message + */ + public function reset() { + update_option( '_transient__mailster_send_period_timeout', false ); + update_option( '_transient__mailster_send_period', 0 ); + } + + /** + * delivery_method function. + * + * add the delivery method to the options + * + * @access public + * @param mixed $delivery_methods + * @return mixed + */ + public function delivery_method( $delivery_methods ) { + $delivery_methods [ MAILSTER_POSTMAN_ID ] = __( 'Postman SMTP', 'post-smtp' ); + return $delivery_methods; + } + + /** + * deliverytab function. + * + * the content of the tab for the options + * + * @access public + * @return void + */ + public function deliverytab() { + apply_filters( 'print_postman_status', null ); + } + + /** + * activate function. + * + * @access public + * @return void + */ + public function activate() { + if ( defined( 'MAILSTER_VERSION' ) && version_compare( MAILSTER_POSTMAN_REQUIRED_VERSION, MAILSTER_VERSION, '<=' ) ) { + mailster_notice( sprintf( __( 'MyMail: Change the delivery method in the %s!', 'post-smtp' ), sprintf( '%s', __( 'Settings', 'postman-smtp' ) ) ), '', false, 'delivery_method' ); + $this->reset(); + } + } + + /** + * deactivate function. + * + * @access public + * @return void + */ + public function deactivate() { + if ( defined( 'MAILSTER_VERSION' ) && function_exists( 'mailster_option' ) && version_compare( MAILSTER_POSTMAN_REQUIRED_VERSION, MAILSTER_VERSION, '<=' ) ) { + if ( mailster_option( 'deliverymethod' ) == MAILSTER_POSTMAN_ID ) { + mailster_update_option( 'deliverymethod', 'simple' ); + /* Translators where %s is the name of the page */ + mailster_notice( sprintf( __( 'MyMail: Change the delivery method in the %s!', 'post-smtp' ), sprintf( '%s', __( 'Settings', 'postman-smtp' ) ) ), '', false, 'delivery_method' ); + } + } + } + } +} diff --git a/Postman/Postman-Mail/PostmanSendGridMailEngine.php b/Postman/Postman-Mail/PostmanSendGridMailEngine.php new file mode 100644 index 0000000..2ffb8e2 --- /dev/null +++ b/Postman/Postman-Mail/PostmanSendGridMailEngine.php @@ -0,0 +1,259 @@ +apiKey = $apiKey; + + // create the logger + $this->logger = new PostmanLogger( get_class( $this ) ); + } + + /** + * (non-PHPdoc) + * + * @see PostmanSmtpEngine::send() + */ + public function send( PostmanMessage $message ) { + $options = PostmanOptions::getInstance(); + + $email = new \SendGrid\Mail\Mail(); + + // add the From Header + $sender = $message->getFromAddress(); + + $senderEmail = ! empty( $sender->getEmail() ) ? $sender->getEmail() : $options->getMessageSenderEmail(); + $senderName = ! empty( $sender->getName() ) ? $sender->getName() : $options->getMessageSenderName(); + + $email->setFrom($senderEmail, $senderName); + + // now log it + $sender->log( $this->logger, 'From' ); + + // add the to recipients + foreach ( ( array ) $message->getToRecipients() as $recipient ) { + $emails[] = new \SendGrid\Mail\To($recipient->getEmail(), $recipient->getName() ); + } + + $email->addTos( $emails ); + + // add the subject + if ( null !== $message->getSubject() ) { + $email->setSubject($message->getSubject()); + } + + // add the message content + + $textPart = $message->getBodyTextPart(); + if ( ! empty( $textPart ) ) { + $this->logger->debug( 'Adding body as text' ); + $email->addContent("text/plain", $textPart); + } + + $htmlPart = $message->getBodyHtmlPart(); + if ( ! empty( $htmlPart ) ) { + $this->logger->debug( 'Adding body as html' ); + $email->addContent("text/html", $htmlPart); + } + + // add the reply-to + $replyTo = $message->getReplyTo(); + // $replyTo is null or a PostmanEmailAddress object + if ( isset( $replyTo ) ) { + $email->setReplyTo( $replyTo->getEmail(), $replyTo->getName() ); + } + + // add the Postman signature - append it to whatever the user may have set + if ( ! $options->isStealthModeEnabled() ) { + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + $email->addHeader( 'X-Mailer', sprintf( 'Postman SMTP %s for WordPress (%s)', $pluginData ['version'], 'https://wordpress.org/plugins/post-smtp/' ) ); + } + + // add the headers - see http://framework.zend.com/manual/1.12/en/zend.mail.additional-headers.html + foreach ( ( array ) $message->getHeaders() as $header ) { + $this->logger->debug( sprintf( 'Adding user header %s=%s', $header ['name'], $header ['content'] ) ); + $email->addHeader( $header ['name'], $header ['content'] ); + } + + // if the caller set a Content-Type header, use it + $contentType = $message->getContentType(); + if ( ! empty( $contentType ) ) { + $this->logger->debug( 'Some header keys are reserved. You may not include any of the following reserved headers: x-sg-id, x-sg-eid, received, dkim-signature, Content-Type, Content-Transfer-Encoding, To, From, Subject, Reply-To, CC, BCC.' ); + } + + // add the cc recipients + $ccEmails = array(); + foreach ( ( array ) $message->getCcRecipients() as $recipient ) { + $recipient->log( $this->logger, 'Cc' ); + $ccEmails[] = new \SendGrid\Mail\Cc( $recipient->getEmail(), $recipient->getName() ); + } + $email->addCcs($ccEmails); + + // add the bcc recipients + $bccEmails = array(); + foreach ( ( array ) $message->getBccRecipients() as $recipient ) { + $recipient->log($this->logger, 'Bcc'); + $bccEmails[] = new \SendGrid\Mail\Bcc( $recipient->getEmail(), $recipient->getName() ); + } + $email->addBccs($bccEmails); + + // add the messageId + $messageId = $message->getMessageId(); + if ( ! empty( $messageId ) ) { + $email->addHeader( 'message-id', $messageId ); + } + + // add attachments + $this->logger->debug( 'Adding attachments' ); + + $attachments = $this->addAttachmentsToMail( $message ); + + foreach ( $attachments as $index => $attachment ) { + + $email->addAttachment( + $attachment['content'], + $attachment['type'], + $attachment['file_name'], + "attachment" + ); + } + + try { + + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Creating SendGrid service with apiKey=' . $this->apiKey ); + } + $sendgrid = new \SendGrid( $this->apiKey ); + + // send the message + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Sending mail' ); + } + + $response = $sendgrid->send($email); + if ( $this->logger->isInfo() ) { + $this->logger->info( sprintf( 'Message %d accepted for delivery', PostmanState::getInstance()->getSuccessfulDeliveries() + 1 ) ); + } + + $response_body = json_decode( $response->body() ); + + $response_code = $response->statusCode(); + $email_sent = ( $response_code >= 200 and $response_code < 300 ); + + if ( isset( $response_body->errors[0]->message ) || ! $email_sent ) { + + $e = ! isset( $response_body->errors[0]->message ) ? $this->errorCodesMap($response_code) : $response_body->errors[0]->message; + $this->transcript = $e; + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= print_r( $email, true ); + + $this->logger->debug( 'Transcript=' . $this->transcript ); + + throw new Exception( $e ); + } + $this->transcript = print_r( $response->body(), true ); + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= print_r( $email, true ); + } catch ( SendGrid\Exception $e ) { + $this->transcript = $e->getMessage(); + $this->transcript .= PostmanModuleTransport::RAW_MESSAGE_FOLLOWS; + $this->transcript .= print_r( $email, true ); + $this->logger->debug( 'Transcript=' . $this->transcript ); + + throw $e; + } + } + + + private function errorCodesMap($error_code) { + switch ($error_code) { + case 413: + $message = sprintf( __( 'ERROR: The JSON payload you have included in your request is too large. Status code is %1$s', 'post-smtp' ), $error_code ); + break; + case 429: + $message = sprintf( __( 'ERROR: The number of requests you have made exceeds SendGrid rate limitations. Status code is %1$s', 'post-smtp' ), $error_code ); + break; + case 500: + $message = sprintf( __( 'ERROR: An error occurred on a SendGrid server. Status code is %1$s', 'post-smtp' ), $error_code ); + break; + case 513: + $message = sprintf( __( 'ERROR: The SendGrid v3 Web API is not available. Status code is %1$s', 'post-smtp' ), $error_code ); + break; + case 502: + $message = sprintf( __( 'ERROR: No recipient supplied. Status code is %1$s', 'post-smtp' ), $error_code ); + break; + default: + $message = sprintf( __( 'ERROR: Status code is %1$s', 'post-smtp' ), $error_code ); + } + + return $message; + } + + /** + * Add attachments to the message + * + * @param Postman_Zend_Mail $mail + */ + private function addAttachmentsToMail( PostmanMessage $message ) { + $attachments = $message->getAttachments(); + if ( ! is_array( $attachments ) ) { + // WordPress may a single filename or a newline-delimited string list of multiple filenames + $attArray = explode( PHP_EOL, $attachments ); + } else { + $attArray = $attachments; + } + // otherwise WordPress sends an array + $attachments = array(); + foreach ( $attArray as $file ) { + if ( ! empty( $file ) ) { + $this->logger->debug( 'Adding attachment: ' . $file ); + + $file_name = basename( $file ); + $file_parts = explode( '.', $file_name ); + $file_type = wp_check_filetype( $file ); + $attachments[] = array( + 'content' => base64_encode( file_get_contents( $file ) ), + 'type' => $file_type['type'], + 'file_name' => $file_name, + 'disposition' => 'attachment', + 'id' => $file_parts[0], + ); + } + } + + return $attachments; + } + + // return the SMTP session transcript + public function getTranscript() { + return $this->transcript; + } + } +} diff --git a/Postman/Postman-Mail/PostmanSendGridTransport.php b/Postman/Postman-Mail/PostmanSendGridTransport.php new file mode 100644 index 0000000..47a0638 --- /dev/null +++ b/Postman/Postman-Mail/PostmanSendGridTransport.php @@ -0,0 +1,231 @@ +options->getSendGridApiKey (); + require_once 'PostmanSendGridMailEngine.php'; + $engine = new PostmanSendGridMailEngine ( $apiKey ); + return $engine; + } + public function getDeliveryDetails() { + /* translators: where (1) is the secure icon and (2) is the transport name */ + return sprintf ( __ ( 'Postman will send mail via the %1$s %2$s.', 'post-smtp' ), '🔐', $this->getName () ); + } + + /** + * + * @param mixed $data + */ + public function prepareOptionsForExport($data) { + $data = parent::prepareOptionsForExport ( $data ); + $data [PostmanOptions::SENDGRID_API_KEY] = PostmanOptions::getInstance ()->getSendGridApiKey (); + return $data; + } + + /** + * (non-PHPdoc) + * + * @see PostmanTransport::getMisconfigurationMessage() + */ + protected function validateTransportConfiguration() { + $messages = parent::validateTransportConfiguration (); + $apiKey = $this->options->getSendGridApiKey (); + if (empty ( $apiKey )) { + array_push ( $messages, __ ( 'API Key can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady (); + } + if (! $this->isSenderConfigured ()) { + array_push ( $messages, __ ( 'Message From Address can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady (); + } + return $messages; + } + + /** + * (non-PHPdoc) + * + * @see PostmanModuleTransport::getConfigurationBid() + */ + public function getConfigurationBid(PostmanWizardSocket $hostData, $userAuthOverride, $originalSmtpServer) { + $recommendation = array (); + $recommendation ['priority'] = 0; + $recommendation ['transport'] = self::SLUG; + $recommendation ['hostname'] = null; // scribe looks this + $recommendation ['label'] = $this->getName (); + if ($hostData->hostname == self::HOST && $hostData->port == self::PORT) { + $recommendation ['priority'] = self::PRIORITY; + /* translators: where variables are (1) transport name (2) host and (3) port */ + $recommendation ['message'] = sprintf ( __ ( ('Postman recommends the %1$s to host %2$s on port %3$d.') ), $this->getName (), self::HOST, self::PORT ); + } + return $recommendation; + } + + /** + * + * @param mixed $hostname + * @param mixed $response + */ + public function populateConfiguration($hostname) { + $response = parent::populateConfiguration ( $hostname ); + return $response; + } + + /** + */ + public function createOverrideMenu(PostmanWizardSocket $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride) { + $overrideItem = parent::createOverrideMenu ( $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride ); + // push the authentication options into the $overrideItem structure + $overrideItem ['auth_items'] = array ( + array ( + 'selected' => true, + 'name' => __ ( 'API Key', 'post-smtp' ), + 'value' => 'api_key' + ) + ); + return $overrideItem; + } + + /** + * Functions to execute on the admin_init event + * + * "Runs at the beginning of every admin page before the page is rendered." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_an_Admin_Page_Request + */ + public function on_admin_init() { + // only administrators should be able to trigger this + if (PostmanUtils::isAdmin ()) { + $this->addSettings (); + $this->registerStylesAndScripts (); + } + } + + /* + * What follows in the code responsible for creating the Admin Settings page + */ + + /** + */ + public function addSettings() { + // the SendGrid Auth section + add_settings_section ( PostmanSendGridTransport::SENDGRID_AUTH_SECTION, __ ( 'Authentication', 'post-smtp' ), array ( + $this, + 'printSendGridAuthSectionInfo' + ), PostmanSendGridTransport::SENDGRID_AUTH_OPTIONS ); + + add_settings_field ( PostmanOptions::SENDGRID_API_KEY, __ ( 'API Key', 'post-smtp' ), array ( + $this, + 'sendgrid_api_key_callback' + ), PostmanSendGridTransport::SENDGRID_AUTH_OPTIONS, PostmanSendGridTransport::SENDGRID_AUTH_SECTION ); + } + public function printSendGridAuthSectionInfo() { + /* Translators: Where (1) is the service URL and (2) is the service name and (3) is a api key URL */ + printf ( '

    %s

    ', sprintf ( __ ( 'Create an account at %2$s and enter an API key below.', 'post-smtp' ), 'https://sendgrid.com', 'SendGrid.com', 'https://app.sendgrid.com/settings/api_keys' ) ); + } + + /** + */ + public function sendgrid_api_key_callback() { + printf ( '', null !== $this->options->getSendGridApiKey () ? esc_attr ( PostmanUtils::obfuscatePassword ( $this->options->getSendGridApiKey () ) ) : '', __ ( 'Required', 'post-smtp' ) ); + print ' '; + } + + /** + */ + public function registerStylesAndScripts() { + // register the stylesheet and javascript external resources + $pluginData = apply_filters ( 'postman_get_plugin_metadata', null ); + wp_register_script ( 'postman_sendgrid_script', plugins_url ( 'Postman/Postman-Mail/postman_sendgrid.js', $this->rootPluginFilenameAndPath ), array ( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + PostmanViewController::POSTMAN_SCRIPT + ), $pluginData ['version'] ); + } + + /** + */ + public function enqueueScript() { + wp_enqueue_script ( 'postman_sendgrid_script' ); + } + + /** + */ + public function printWizardAuthenticationStep() { + print '
    '; + $this->printSendGridAuthSectionInfo (); + printf ( '', __ ( 'API Key', 'post-smtp' ) ); + print '
    '; + print $this->sendgrid_api_key_callback (); + print '
    '; + } +} diff --git a/Postman/Postman-Mail/PostmanSmtpModuleTransport.php b/Postman/Postman-Mail/PostmanSmtpModuleTransport.php new file mode 100644 index 0000000..7442972 --- /dev/null +++ b/Postman/Postman-Mail/PostmanSmtpModuleTransport.php @@ -0,0 +1,594 @@ +getAuthenticationType() ) { + $config = PostmanOAuth2ConfigurationFactory::createConfig( $this ); + } else { + $config = PostmanBasicAuthConfigurationFactory::createConfig( $this ); + } + return new Postman_Zend_Mail_Transport_Smtp( $this->getHostname(), $config ); + } + + /** + * Determines whether Mail Engine locking is needed + * + * @see PostmanModuleTransport::requiresLocking() + */ + public function isLockingRequired() { + return PostmanOptions::AUTHENTICATION_TYPE_OAUTH2 == $this->getAuthenticationType(); + } + public function getSlug() { + return self::SLUG; + } + public function getName() { + return 'SMTP'; + } + public function getHostname() { + $this->options = $this->options; + return $this->options->getHostname(); + } + public function getPort() { + $this->options = $this->options; + return $this->options->getPort(); + } + public function getAuthenticationType() { + return $this->options->getAuthenticationType(); + } + public function getCredentialsId() { + $this->options = $this->options; + if ( $this->options->isAuthTypeOAuth2() ) { + return $this->options->getClientId(); + } else { + return $this->options->getUsername(); + } + } + public function getCredentialsSecret() { + $this->options = $this->options; + if ( $this->options->isAuthTypeOAuth2() ) { + return $this->options->getClientSecret(); + } else { + return $this->options->getPassword(); + } + } + + /** + * (non-PHPdoc) + * + * @see PostmanTransport::getMisconfigurationMessage() + */ + protected function validateTransportConfiguration() { + $messages = parent::validateTransportConfiguration(); + if ( ! $this->isHostConfigured( $this->options ) ) { + array_push( $messages, __( 'Outgoing Mail Server Hostname and Port can not be empty.', 'post-smtp' ) ); + $this->setNotConfiguredAndReady(); + } + if ( ! $this->isEnvelopeFromConfigured() ) { + array_push( $messages, __( 'Envelope-From Email Address can not be empty', 'post-smtp' ) . '.' ); + $this->setNotConfiguredAndReady(); + } + if ( $this->options->isAuthTypePassword() && ! $this->isPasswordAuthenticationConfigured( $this->options ) ) { + array_push( $messages, __( 'Username and password can not be empty.', 'post-smtp' ) ); + $this->setNotConfiguredAndReady(); + } + if ( $this->getAuthenticationType() == PostmanOptions::AUTHENTICATION_TYPE_OAUTH2 ) { + if ( ! $this->isOAuth2SupportedHostConfigured() ) { + /* translators: %1$s is the Client ID label, and %2$s is the Client Secret label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) */ + array_push( $messages, sprintf( __( 'OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server.', 'post-smtp' ) ) ); + $this->setNotConfiguredAndReady(); + } + } + if ( empty( $messages ) ) { + $this->setReadyForOAuthGrant(); + if ( $this->isPermissionNeeded( $this->options, $this->getOAuthToken() ) ) { + /* translators: %1$s is the Client ID label, and %2$s is the Client Secret label */ + $message = sprintf( __( 'You have configured OAuth 2.0 authentication, but have not received permission to use it.', 'post-smtp' ), $this->getScribe()->getClientIdLabel(), $this->getScribe()->getClientSecretLabel() ); + $message .= sprintf( ' %s.', PostmanUtils::getGrantOAuthPermissionUrl(), $this->getScribe()->getRequestPermissionLinkText() ); + array_push( $messages, $message ); + $this->setNotConfiguredAndReady(); + } + } + return $messages; + } + + /** + * + * @return boolean + */ + private function isOAuth2SupportedHostConfigured() { + $options = PostmanOptions::getInstance(); + $hostname = $options->getHostname(); + $supportedOAuthProvider = $this->isServiceProviderGoogle( $hostname ) || $this->isServiceProviderMicrosoft( $hostname ) || $this->isServiceProviderYahoo( $hostname ); + return $supportedOAuthProvider; + } + + /** + * Given a hostname, what ports should we test? + * + * May return an array of several combinations. + */ + public function getSocketsForSetupWizardToProbe( $hostname, $smtpServerGuess ) { + $hosts = array( + $this->createSocketDefinition( $hostname, 25 ), + $this->createSocketDefinition( $hostname, 465 ), + $this->createSocketDefinition( $hostname, 587 ), + ); + + return $hosts; + } + + /** + * Creates a single socket for the Wizard to test + */ + protected function createSocketDefinition( $hostname, $port ) { + $socket = parent::createSocketDefinition( $hostname, $port ); + $socket ['smtp'] = true; + return $socket; + } + + /** + * SendGrid will never recommend it's configuration + * + * @param mixed $hostData + */ + public function getConfigurationBid( PostmanWizardSocket $hostData, $userAuthOverride, $originalSmtpServer ) { + $port = $hostData->port; + $hostname = $hostData->hostname; + // because some servers, like smtp.broadband.rogers.com, report XOAUTH2 but have no OAuth2 front-end + $supportedOAuth2Provider = $this->isServiceProviderGoogle( $hostname ) || $this->isServiceProviderMicrosoft( $hostname ) || $this->isServiceProviderYahoo( $hostname ); + $score = 1; + $recommendation = array(); + // increment score for auth type + if ( $hostData->mitm ) { + $this->logger->debug( 'Losing points for MITM' ); + $score -= 10000; + $recommendation ['mitm'] = true; + } + if ( ! empty( $originalSmtpServer ) && $hostname != $originalSmtpServer ) { + $this->logger->debug( 'Losing points for Not The Original SMTP server' ); + $score -= 10000; + } + $secure = true; + if ( $hostData->startTls ) { + // STARTTLS was formalized in 2002 + // http://www.rfc-editor.org/rfc/rfc3207.txt + $recommendation ['enc'] = PostmanOptions::SECURITY_TYPE_STARTTLS; + $score += 30000; + } elseif ( $hostData->protocol == 'SMTPS' ) { + // "The hopelessly confusing and imprecise term, SSL, + // has often been used to indicate the SMTPS wrapper and + // TLS to indicate the STARTTLS protocol extension." + // http://stackoverflow.com/a/19942206/4368109 + $recommendation ['enc'] = PostmanOptions::SECURITY_TYPE_SMTPS; + $score += 28000; + } elseif ( $hostData->protocol == 'SMTP' ) { + $recommendation ['enc'] = PostmanOptions::SECURITY_TYPE_NONE; + $score += 26000; + $secure = false; + } + + // if there is a way to send mail.... + if ( $score > 10 ) { + + // determine the authentication type + if ( $hostData->auth_xoauth && $supportedOAuth2Provider && (empty( $userAuthOverride ) || $userAuthOverride == 'oauth2') ) { + $recommendation ['auth'] = PostmanOptions::AUTHENTICATION_TYPE_OAUTH2; + $recommendation ['display_auth'] = 'oauth2'; + $score += 500; + if ( ! $secure ) { + $this->logger->debug( 'Losing points for sending credentials in the clear' ); + $score -= 10000; + } + } elseif ( $hostData->auth_crammd5 && (empty( $userAuthOverride ) || $userAuthOverride == 'password') ) { + $recommendation ['auth'] = PostmanOptions::AUTHENTICATION_TYPE_CRAMMD5; + $recommendation ['display_auth'] = 'password'; + $score += 400; + if ( ! $secure ) { + $this->logger->debug( 'Losing points for sending credentials in the clear' ); + $score -= 10000; + } + } elseif ( $hostData->authPlain && (empty( $userAuthOverride ) || $userAuthOverride == 'password') ) { + $recommendation ['auth'] = PostmanOptions::AUTHENTICATION_TYPE_PLAIN; + $recommendation ['display_auth'] = 'password'; + $score += 300; + if ( ! $secure ) { + $this->logger->debug( 'Losing points for sending credentials in the clear' ); + $score -= 10000; + } + } elseif ( $hostData->auth_login && (empty( $userAuthOverride ) || $userAuthOverride == 'password') ) { + $recommendation ['auth'] = PostmanOptions::AUTHENTICATION_TYPE_LOGIN; + $recommendation ['display_auth'] = 'password'; + $score += 200; + if ( ! $secure ) { + $this->logger->debug( 'Losing points for sending credentials in the clear' ); + $score -= 10000; + } + } else if ( empty( $userAuthOverride ) || $userAuthOverride == 'none' ) { + $recommendation ['auth'] = PostmanOptions::AUTHENTICATION_TYPE_NONE; + $recommendation ['display_auth'] = 'none'; + $score += 100; + } + + // tiny weighting to prejudice the port selection, all things being equal + if ( $port == 587 ) { + $score += 4; + } elseif ( $port == 25 ) { + // "due to the prevalence of machines that have worms, + // viruses, or other malicious software that generate large amounts of + // spam, many sites now prohibit outbound traffic on the standard SMTP + // port (port 25), funneling all mail submissions through submission + // servers." + // http://www.rfc-editor.org/rfc/rfc6409.txt + $score += 3; + } elseif ( $port == 465 ) { + // use of port 465 for SMTP was deprecated in 1998 + // http://www.imc.org/ietf-apps-tls/mail-archive/msg00204.html + $score += 2; + } else { + $score += 1; + } + + // create the recommendation message for the user + // this can only be set if there is a valid ['auth'] and ['enc'] + $transportDescription = $this->getTransportDescription( $recommendation ['enc'] ); + $authDesc = $this->getAuthenticationDescription( $recommendation ['auth'] ); + $recommendation ['label'] = sprintf( 'SMTP - %2$s:%3$d', $transportDescription, $hostData->hostnameDomainOnly, $port ); + /* translators: where %1$s is a description of the transport (eg. SMTPS-SSL), %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is the TCP port (eg. 465), %4$d is the hostname */ + $recommendation ['message'] = sprintf( __( 'Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d.', 'post-smtp' ), $transportDescription, $authDesc, $port, $hostname ); + } + + // fill-in the rest of the recommendation + $recommendation ['transport'] = PostmanSmtpModuleTransport::SLUG; + $recommendation ['priority'] = $score; + $recommendation ['port'] = $port; + $recommendation ['hostname'] = $hostname; + $recommendation ['transport'] = self::SLUG; + + return $recommendation; + } + + /** + * Functions to execute on the admin_init event + * + * "Runs at the beginning of every admin page before the page is rendered." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_an_Admin_Page_Request + */ + public function on_admin_init() { + // only administrators should be able to trigger this + if ( PostmanUtils::isAdmin() ) { + $this->addSettings(); + $this->registerStylesAndScripts(); + } + } + + /** + */ + public function registerStylesAndScripts() { + // register the stylesheet and javascript external resources + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + wp_register_script( 'postman_smtp_script', plugins_url( 'Postman/Postman-Mail/postman_smtp.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + PostmanViewController::POSTMAN_SCRIPT, + ), $pluginData ['version'] ); + } + + /* + * What follows in the code responsible for creating the Admin Settings page + */ + + /** + */ + public function enqueueScript() { + wp_enqueue_script( 'postman_smtp_script' ); + } + + /** + */ + public function addSettings() { + $transport = $this; + $this->options = $this->options; + $oauthScribe = $transport->getScribe(); + + // Sanitize + add_settings_section( PostmanAdminController::SMTP_SECTION, __( 'Transport Settings', 'post-smtp' ), array( + $this, + 'printSmtpSectionInfo', + ), PostmanAdminController::SMTP_OPTIONS ); + + add_settings_field( PostmanOptions::HOSTNAME, __( 'Outgoing Mail Server Hostname', 'post-smtp' ), array( + $this, + 'hostname_callback', + ), PostmanAdminController::SMTP_OPTIONS, PostmanAdminController::SMTP_SECTION ); + + add_settings_field( PostmanOptions::PORT, __( 'Outgoing Mail Server Port', 'post-smtp' ), array( + $this, + 'port_callback', + ), PostmanAdminController::SMTP_OPTIONS, PostmanAdminController::SMTP_SECTION ); + + add_settings_field( PostmanOptions::ENVELOPE_SENDER, __( 'Envelope-From Email Address', 'post-smtp' ), array( + $this, + 'sender_email_callback', + ), PostmanAdminController::SMTP_OPTIONS, PostmanAdminController::SMTP_SECTION ); + + add_settings_field( PostmanOptions::SECURITY_TYPE, _x( 'Security', 'Configuration Input Field', 'post-smtp' ), array( + $this, + 'encryption_type_callback', + ), PostmanAdminController::SMTP_OPTIONS, PostmanAdminController::SMTP_SECTION ); + + add_settings_field( PostmanOptions::AUTHENTICATION_TYPE, __( 'Authentication', 'post-smtp' ), array( + $this, + 'authentication_type_callback', + ), PostmanAdminController::SMTP_OPTIONS, PostmanAdminController::SMTP_SECTION ); + + add_settings_section( PostmanAdminController::BASIC_AUTH_SECTION, __( 'Authentication', 'post-smtp' ), array( + $this, + 'printBasicAuthSectionInfo', + ), PostmanAdminController::BASIC_AUTH_OPTIONS ); + + add_settings_field( PostmanOptions::BASIC_AUTH_USERNAME, __( 'Username', 'post-smtp' ), array( + $this, + 'basic_auth_username_callback', + ), PostmanAdminController::BASIC_AUTH_OPTIONS, PostmanAdminController::BASIC_AUTH_SECTION ); + + add_settings_field( PostmanOptions::BASIC_AUTH_PASSWORD, __( 'Password', 'post-smtp' ), array( + $this, + 'basic_auth_password_callback', + ), PostmanAdminController::BASIC_AUTH_OPTIONS, PostmanAdminController::BASIC_AUTH_SECTION ); + + // the OAuth section + add_settings_section( PostmanAdminController::OAUTH_SECTION, __( 'Authentication', 'post-smtp' ), array( + $this, + 'printOAuthSectionInfo', + ), PostmanAdminController::OAUTH_AUTH_OPTIONS ); + + add_settings_field( 'callback_domain', sprintf( '%s', $oauthScribe->getCallbackDomainLabel() ), array( + $this, + 'callback_domain_callback', + ), PostmanAdminController::OAUTH_AUTH_OPTIONS, PostmanAdminController::OAUTH_SECTION ); + + add_settings_field( 'redirect_url', sprintf( '%s', $oauthScribe->getCallbackUrlLabel() ), array( + $this, + 'redirect_url_callback', + ), PostmanAdminController::OAUTH_AUTH_OPTIONS, PostmanAdminController::OAUTH_SECTION ); + + add_settings_field( PostmanOptions::CLIENT_ID, $oauthScribe->getClientIdLabel(), array( + $this, + 'oauth_client_id_callback', + ), PostmanAdminController::OAUTH_AUTH_OPTIONS, PostmanAdminController::OAUTH_SECTION ); + + add_settings_field( PostmanOptions::CLIENT_SECRET, $oauthScribe->getClientSecretLabel(), array( + $this, + 'oauth_client_secret_callback', + ), PostmanAdminController::OAUTH_AUTH_OPTIONS, PostmanAdminController::OAUTH_SECTION ); + } + + /** + * Print the Section text + */ + public function printSmtpSectionInfo() { + print __( 'Configure the communication with the mail server.', 'post-smtp' ); + } + + /** + * Get the settings option array and print one of its values + */ + public function hostname_callback() { + printf( '', null !== $this->options->getHostname() ? esc_attr( $this->options->getHostname() ) : '', __( 'Required', 'post-smtp' ) ); + } + + /** + * Get the settings option array and print one of its values + */ + public function port_callback( $args ) { + printf( '', null !== $this->options->getPort() ? esc_attr( $this->options->getPort() ) : '', isset( $args ['style'] ) ? $args ['style'] : '', __( 'Required', 'post-smtp' ) ); + } + + /** + * Get the settings option array and print one of its values + */ + public function encryption_type_callback() { + $encType = $this->options->getEncryptionType(); + print ''; + } + + /** + * Get the settings option array and print one of its values + */ + public function authentication_type_callback() { + $authType = $this->options->getAuthenticationType(); + printf( ''; + } + + /** + * Print the Section text + */ + public function printBasicAuthSectionInfo() { + print __( 'Enter the account credentials.', 'post-smtp' ); + } + + /** + * Get the settings option array and print one of its values + */ + public function basic_auth_username_callback() { + $inputValue = (null !== $this->options->getUsername() ? esc_attr( $this->options->getUsername() ) : ''); + $inputDescription = __( 'The Username is usually the same as the Envelope-From Email Address.', 'post-smtp' ); + print ('') ; + printf( '
    %s', $inputValue, __( 'Required', 'post-smtp' ), $inputDescription ); + } + + /** + * Get the settings option array and print one of its values + */ + public function basic_auth_password_callback() { + print ('') ; + printf( '', null !== $this->options->getPassword() ? esc_attr( PostmanUtils::obfuscatePassword( $this->options->getPassword() ) ) : '', __( 'Required', 'post-smtp' ) ); + print ' '; + } + + /** + * Get the settings option array and print one of its values + */ + public function oauth_client_id_callback() { + printf( '', null !== $this->options->getClientId() ? esc_attr( $this->options->getClientId() ) : '', __( 'Required', 'post-smtp' ) ); + } + + /** + * Get the settings option array and print one of its values + */ + public function oauth_client_secret_callback() { + printf( '', null !== $this->options->getClientSecret() ? esc_attr( $this->options->getClientSecret() ) : '', __( 'Required', 'post-smtp' ) ); + } + + /** + * Print the Section text + */ + public function printOAuthSectionInfo() { + $this->options = $this->options; + $transport = $this; + $oauthScribe = $transport->getScribe(); + printf( '

    %s

    ', $oauthScribe->getOAuthHelp() ); + } + + /** + * Get the settings option array and print one of its values + */ + public function callback_domain_callback() { + printf( '', $this->getCallbackDomain() ); + } + + /** + */ + private function getCallbackDomain() { + try { + $this->options = $this->options; + $transport = $this; + $oauthScribe = $transport->getScribe(); + return $oauthScribe->getCallbackDomain(); + } catch ( Exception $e ) { + return __( 'Error computing your domain root - please enter it manually', 'post-smtp' ); + } + } + + /** + * Get the settings option array and print one of its values + */ + public function redirect_url_callback() { + $this->options = $this->options; + $transport = $this; + $oauthScribe = $transport->getScribe(); + printf( '', $oauthScribe->getCallbackUrl() ); + } + + /** + * Get the settings option array and print one of its values + */ + public function sender_email_callback() { + $inputValue = (null !== $this->options->getEnvelopeSender() ? esc_attr( $this->options->getEnvelopeSender() ) : ''); + $requiredLabel = __( 'Required', 'post-smtp' ); + $envelopeFromMessage = __( 'This address, like the return address printed on an envelope, identifies the account owner to the SMTP server.', 'post-smtp' ); + $spfMessage = sprintf( __( 'For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above.', 'post-smtp' ), 'https://www.mail-tester.com/spf/' ); + printf( '
    %s %s', $inputValue, $requiredLabel, $envelopeFromMessage, $spfMessage ); + } + + /** + */ + public function printWizardMailServerHostnameStep() { + printf( '%s', _x( 'Which host will relay the mail?', 'Wizard Step Title', 'post-smtp' ) ); + printf( '

    %s

    ', __( 'This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. This server is specific to your email account, and if you don\'t know what to use, ask your email service provider.', 'post-smtp' ) ); + printf( '

    %s

    ', __( 'Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, require that you use their mail accounts with their mail servers, and prevent you from using others.', 'post-smtp' ) ); + + printf( '
    %s

    ', __( 'If you plan to use An API and not SMTP just type any value.', 'post-smtp' ) ); + printf( '', __( 'Outgoing Mail Server Hostname', 'post-smtp' ) ); + print $this->hostname_callback(); + printf( '', plugins_url( 'post-smtp/style/ajax-loader.gif' ) ); + $warning = __( 'Warning', 'post-smtp' ); + /* Translators: Where (%s) is the name of the web host */ + $nonGodaddyDomainMessage = sprintf( __( 'Your email address requires access to a remote SMTP server blocked by %s.', 'post-smtp' ), 'GoDaddy' ); + $nonGodaddyDomainMessage .= sprintf( ' %s', __( 'If you have access to cPanel, enable the Remote Mail Exchanger.', 'post-smtp' ) ); + printf( '

    %s: %s

    ', $warning, $nonGodaddyDomainMessage ); + /* Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the web host */ + $godaddyCustomDomainMessage = sprintf( __( 'If you own this domain, make sure it has an SPF record authorizing %2$s as a relay, or you will have delivery problems.', 'post-smtp' ), 'http://www.mail-tester.com/spf/godaddy', 'GoDaddy' ); + printf( '

    %s: %s

    ', $warning, $godaddyCustomDomainMessage ); + } + + /** + */ + public function printWizardAuthenticationStep() { + print '
    '; + print '

    '; + printf( '', $this->getScribe()->getCallbackDomainLabel() ); + print '
    '; + print $this->callback_domain_callback(); + print '
    '; + printf( '', $this->getScribe()->getCallbackUrlLabel() ); + print '
    '; + print $this->redirect_url_callback(); + print '
    '; + printf( '', $this->getScribe()->getClientIdLabel() ); + print '
    '; + print $this->oauth_client_id_callback(); + print '
    '; + printf( '', $this->getScribe()->getClientSecretLabel() ); + print '
    '; + print $this->oauth_client_secret_callback(); + print '
    '; + print '
    '; + + print '
    '; + printf( '

    %s

    ', __( 'Enter the account credentials.', 'post-smtp' ) ); + printf( '', __( 'Username', 'post-smtp' ) ); + print '
    '; + print $this->basic_auth_username_callback(); + print '
    '; + printf( '', __( 'Password', 'post-smtp' ) ); + print '
    '; + print $this->basic_auth_password_callback(); + print '
    '; + } +} diff --git a/Postman/Postman-Mail/PostmanTransportRegistry.php b/Postman/Postman-Mail/PostmanTransportRegistry.php new file mode 100644 index 0000000..4de782a --- /dev/null +++ b/Postman/Postman-Mail/PostmanTransportRegistry.php @@ -0,0 +1,253 @@ +logger = new PostmanLogger( get_class( $this ) ); + } + + // singleton instance + public static function getInstance() { + static $inst = null; + if ( $inst === null ) { + $inst = new PostmanTransportRegistry(); + } + return $inst; + } + public function registerTransport( PostmanModuleTransport $instance ) { + $this->transports [ $instance->getSlug() ] = $instance; + $instance->init(); + } + public function getTransports() { + return $this->transports; + } + + /** + * Retrieve a Transport by slug + * Look up a specific Transport use: + * A) when retrieving the transport saved in the database + * B) when querying what a theoretical scenario involving this transport is like + * (ie.for ajax in config screen) + * + * @param mixed $slug + */ + public function getTransport( $slug ) { + $transports = $this->getTransports(); + if ( isset( $transports [ $slug ] ) ) { + return $transports [ $slug ]; + } + } + + /** + * A short-hand way of showing the complete delivery method + * + * @param PostmanModuleTransport $transport + * @return string + */ + public function getPublicTransportUri( PostmanModuleTransport $transport ) { + return $transport->getPublicTransportUri(); + } + + /** + * Determine if a specific transport is registered in the directory. + * + * @param mixed $slug + */ + public function isRegistered( $slug ) { + $transports = $this->getTransports(); + return isset( $transports [ $slug ] ); + } + + /** + * Retrieve the transport Postman is currently configured with. + * + * @return PostmanModuleTransport + * @deprecated + */ + public function getCurrentTransport() { + $selectedTransport = PostmanOptions::getInstance()->getTransportType(); + $transports = $this->getTransports(); + if ( ! isset( $transports [ $selectedTransport ] ) ) { + return $transports ['default']; + } else { + return $transports [ $selectedTransport ]; + } + } + + /** + * + * @param PostmanOptions $options + * @param PostmanOAuthToken $token + * @return boolean + */ + public function getActiveTransport() { + $selectedTransport = PostmanOptions::getInstance()->getTransportType(); + $transports = $this->getTransports(); + if ( isset( $transports [ $selectedTransport ] ) ) { + $transport = $transports [ $selectedTransport ]; + if ( $transport->getSlug() == $selectedTransport && $transport->isConfiguredAndReady() ) { + return $transport; + } + } + return $transports ['default']; + } + + /** + * Retrieve the transport Postman is currently configured with. + * + * @return PostmanModuleTransport + */ + public function getSelectedTransport() { + $selectedTransport = PostmanOptions::getInstance()->getTransportType(); + $transports = $this->getTransports(); + if ( isset( $transports [ $selectedTransport ] ) ) { + return $transports [ $selectedTransport ]; + } else { + return $transports ['default']; + } + } + + /** + * Determine whether to show the Request Permission link on the main menu + * + * This link is displayed if + * 1. the current transport requires OAuth 2.0 + * 2. the transport is properly configured + * 3. we have a valid Client ID and Client Secret without an Auth Token + * + * @param PostmanOptions $options + * @return boolean + */ + public function isRequestOAuthPermissionAllowed( PostmanOptions $options, PostmanOAuthToken $authToken ) { + // does the current transport use OAuth 2.0 + $oauthUsed = self::getSelectedTransport()->isOAuthUsed( $options->getAuthenticationType() ); + + // is the transport configured + if ( $oauthUsed ) { + $configured = self::getSelectedTransport()->isConfiguredAndReady(); + } + + return $oauthUsed && $configured; + } + + /** + * Polls all the installed transports to get a complete list of sockets to probe for connectivity + * + * @param mixed $hostname + * @param mixed $isGmail + * @return multitype: + */ + public function getSocketsForSetupWizardToProbe( $hostname = 'localhost', $smtpServerGuess = null ) { + $hosts = array(); + if ( $this->logger->isDebug() ) { + $this->logger->debug( sprintf( 'Getting sockets for Port Test given hostname %s and smtpServerGuess %s', $hostname, $smtpServerGuess ) ); + } + + $transports = $this->getTransports(); + if ( $hostname !== 'smtp.gmail.com' ) { + unset( $transports['gmail_api'] ); + } + foreach ( $transports as $transport ) { + $socketsToTest = $transport->getSocketsForSetupWizardToProbe( $hostname, $smtpServerGuess ); + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'sockets to test:' ); + $this->logger->trace( $socketsToTest ); + } + $hosts = array_merge( $hosts, $socketsToTest ); + if ( $this->logger->isDebug() ) { + $this->logger->debug( sprintf( 'Transport %s returns %d sockets ', $transport->getName(), sizeof( $socketsToTest ) ) ); + } + } + return $hosts; + } + + /** + * If the host port is a possible configuration option, recommend it + * + * $hostData includes ['host'] and ['port'] + * + * response should include ['success'], ['message'], ['priority'] + * + * @param mixed $hostData + */ + public function getRecommendation( PostmanWizardSocket $hostData, $userAuthOverride, $originalSmtpServer ) { + $scrubbedUserAuthOverride = $this->scrubUserOverride( $hostData, $userAuthOverride ); + $transport = $this->getTransport( $hostData->transport ); + $recommendation = $transport->getConfigurationBid( $hostData, $scrubbedUserAuthOverride, $originalSmtpServer ); + if ( $this->logger->isDebug() ) { + $this->logger->debug( sprintf( 'Transport %s bid %s', $transport->getName(), $recommendation ['priority'] ) ); + } + return $recommendation; + } + + /** + * + * @param PostmanWizardSocket $hostData + * @param mixed $userAuthOverride + * @return NULL + */ + private function scrubUserOverride( PostmanWizardSocket $hostData, $userAuthOverride ) { + $this->logger->trace( 'before scrubbing userAuthOverride: ' . $userAuthOverride ); + + // validate userAuthOverride + if ( ! ($userAuthOverride == 'oauth2' || $userAuthOverride == 'password' || $userAuthOverride == 'none') ) { + $userAuthOverride = null; + } + + // validate the userAuthOverride + if ( ! $hostData->auth_xoauth ) { + if ( $userAuthOverride == 'oauth2' ) { + $userAuthOverride = null; + } + } + if ( ! $hostData->auth_crammd5 && ! $hostData->authPlain && ! $hostData->auth_login ) { + if ( $userAuthOverride == 'password' ) { + $userAuthOverride = null; + } + } + if ( ! $hostData->auth_none ) { + if ( $userAuthOverride == 'none' ) { + $userAuthOverride = null; + } + } + $this->logger->trace( 'after scrubbing userAuthOverride: ' . $userAuthOverride ); + return $userAuthOverride; + } + + /** + */ + public function getReadyMessage() { + if ( $this->getCurrentTransport()->isConfiguredAndReady() ) { + if ( PostmanOptions::getInstance()->getRunMode() != PostmanOptions::RUN_MODE_PRODUCTION ) { + return array( + 'error' => true, + 'message' => __( 'Postman is in non-Production mode and is dumping all emails.', 'post-smtp' ), + ); + } else { + return array( + 'error' => false, + 'message' => __( 'Postman is configured.', 'post-smtp' ), + ); + } + } else { + return array( + 'error' => true, + 'message' => __( 'Postman is not configured and is mimicking out-of-the-box WordPress email delivery.', 'post-smtp' ), + ); + } + } +} diff --git a/Postman/Postman-Mail/PostmanWooCommerce.php b/Postman/Postman-Mail/PostmanWooCommerce.php new file mode 100644 index 0000000..1768881 --- /dev/null +++ b/Postman/Postman-Mail/PostmanWooCommerce.php @@ -0,0 +1,152 @@ +set_vars(); + $this->hooks(); + } + + public function set_vars() { + $this->options = PostmanOptions::getInstance (); + } + + public function hooks() { + add_filter( 'option_woocommerce_email_from_address', array( $this, 'set_postman_from_address' ), 10, 2 ); + add_filter( 'woocommerce_email_from_address', array( $this, 'set_postman_from_address' ), 10, 2 ); + add_filter( 'woocommerce_get_settings_email', array( $this, 'overide_email_settings' ) ); + } + + public function set_postman_from_address( $from_address, $WC_Email ) { + return $this->options->getMessageSenderEmail(); + } + + public function overide_email_settings( $settings ) { + + return array( + + array( 'title' => __( 'Email notifications', 'post-smtp' ), 'desc' => __( 'Email notifications sent from WooCommerce are listed below. Click on an email to configure it.', 'post-smtp' ), 'type' => 'title', 'id' => 'email_notification_settings' ), + + array( 'type' => 'email_notification' ), + + array( 'type' => 'sectionend', 'id' => 'email_notification_settings' ), + + array( 'type' => 'sectionend', 'id' => 'email_recipient_options' ), + + array( 'title' => __( 'Email sender options', 'post-smtp' ), 'type' => 'title', 'desc' => '', 'id' => 'email_options' ), + + array( + 'title' => __( '"From" name', 'post-smtp' ), + 'desc' => __( 'How the sender name appears in outgoing WooCommerce emails.', 'post-smtp' ), + 'id' => 'woocommerce_email_from_name', + 'type' => 'text', + 'css' => 'min-width:300px;', + 'default' => esc_attr( get_bloginfo( 'name', 'display' ) ), + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( '"From" address', 'post-smtp' ), + 'desc' => __( 'This is overided by the account configured on Post SMTP plugin configuration.', 'post-smtp' ), + 'id' => 'woocommerce_email_from_address', + 'type' => 'email', + 'custom_attributes' => array( + 'multiple' => 'multiple', + 'disabled' => 'true', + ), + 'css' => 'min-width:300px;', + 'default' => $this->options->getMessageSenderEmail(), + 'autoload' => false, + 'desc_tip' => true, + ), + + array( 'type' => 'sectionend', 'id' => 'email_options' ), + + array( 'title' => __( 'Email template', 'post-smtp' ), 'type' => 'title', 'desc' => sprintf( __( 'This section lets you customize the WooCommerce emails. Click here to preview your email template.', 'post-smtp' ), wp_nonce_url( admin_url( '?preview_woocommerce_mail=true' ), 'preview-mail' ) ), 'id' => 'email_template_options' ), + + array( + 'title' => __( 'Header image', 'post-smtp' ), + 'desc' => __( 'URL to an image you want to show in the email header. Upload images using the media uploader (Admin > Media).', 'post-smtp' ), + 'id' => 'woocommerce_email_header_image', + 'type' => 'text', + 'css' => 'min-width:300px;', + 'placeholder' => __( 'N/A', 'post-smtp' ), + 'default' => '', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Footer text', 'post-smtp' ), + 'desc' => __( 'The text to appear in the footer of WooCommerce emails.', 'post-smtp' ), + 'id' => 'woocommerce_email_footer_text', + 'css' => 'width:300px; height: 75px;', + 'placeholder' => __( 'N/A', 'post-smtp' ), + 'type' => 'textarea', + /* translators: %s: site name */ + 'default' => get_bloginfo( 'name', 'display' ), + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Base color', 'post-smtp' ), + /* translators: %s: default color */ + 'desc' => sprintf( __( 'The base color for WooCommerce email templates. Default %s.', 'post-smtp' ), '#96588a' ), + 'id' => 'woocommerce_email_base_color', + 'type' => 'color', + 'css' => 'width:6em;', + 'default' => '#96588a', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Background color', 'post-smtp' ), + /* translators: %s: default color */ + 'desc' => sprintf( __( 'The background color for WooCommerce email templates. Default %s.', 'post-smtp' ), '#f7f7f7' ), + 'id' => 'woocommerce_email_background_color', + 'type' => 'color', + 'css' => 'width:6em;', + 'default' => '#f7f7f7', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Body background color', 'post-smtp' ), + /* translators: %s: default color */ + 'desc' => sprintf( __( 'The main body background color. Default %s.', 'post-smtp' ), '#ffffff' ), + 'id' => 'woocommerce_email_body_background_color', + 'type' => 'color', + 'css' => 'width:6em;', + 'default' => '#ffffff', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( + 'title' => __( 'Body text color', 'post-smtp' ), + /* translators: %s: default color */ + 'desc' => sprintf( __( 'The main body text color. Default %s.', 'post-smtp' ), '#3c3c3c' ), + 'id' => 'woocommerce_email_text_color', + 'type' => 'color', + 'css' => 'width:6em;', + 'default' => '#3c3c3c', + 'autoload' => false, + 'desc_tip' => true, + ), + + array( 'type' => 'sectionend', 'id' => 'email_template_options' ), + + ); + } + } +} \ No newline at end of file diff --git a/Postman/Postman-Mail/PostmanZendMailEngine.php b/Postman/Postman-Mail/PostmanZendMailEngine.php new file mode 100644 index 0000000..82da37c --- /dev/null +++ b/Postman/Postman-Mail/PostmanZendMailEngine.php @@ -0,0 +1,249 @@ +transport = $transport; + + // create the logger + $this->logger = new PostmanLogger( get_class( $this ) ); + } + + /** + * (non-PHPdoc) + * + * @see PostmanSmtpEngine::send() + */ + public function send( PostmanMessage $message ) { + $this->logger->debug( 'Prepping Zend' ); + $envelopeFrom = new PostmanEmailAddress( $this->transport->getEnvelopeFromEmailAddress() ); + if ( $this->transport->isEnvelopeFromValidationSupported() ) { + // validate the envelope from since we didn't do it in the Message + $envelopeFrom->validate( 'Envelope From' ); + } + + // create the Message + $charset = $message->getCharset(); + $this->logger->debug( 'Building Postman_Zend_Mail with charset=' . $charset ); + $mail = new Postman_Zend_Mail( $charset ); + + // add the Postman signature - append it to whatever the user may have set + if ( ! PostmanOptions::getInstance()->isStealthModeEnabled() ) { + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + $mail->addHeader( 'X-Mailer', sprintf( 'Postman SMTP %s for WordPress (%s)', $pluginData ['version'], 'https://wordpress.org/plugins/post-smtp/' ) ); + } + + // add the headers - see http://framework.zend.com/manual/1.12/en/zend.mail.additional-headers.html + foreach ( ( array ) $message->getHeaders() as $header ) { + $this->logger->debug( sprintf( 'Adding user header %s=%s', $header ['name'], $header ['content'] ) ); + $mail->addHeader( $header ['name'], $header ['content'], true ); + } + + // if the caller set a Content-Type header, use it + $contentType = $message->getContentType(); + if ( ! empty( $contentType ) ) { + $mail->addHeader( 'Content-Type', $contentType, false ); + $this->logger->debug( 'Adding content-type ' . $contentType ); + } + + // add the From Header + $fromHeader = $this->addFrom( $message, $mail ); + $fromHeader->log( $this->logger, 'From' ); + + // add the Sender Header, overriding what the user may have set + $mail->addHeader( 'Sender', $this->transport->getFromEmailAddress(), false ); + // from RFC 5321: http://tools.ietf.org/html/rfc5321#section-4.4 + // A message-originating SMTP system SHOULD NOT send a message that + // already contains a Return-path header field. + // I changed Zend/Mail/Mail.php to fix this + $mail->setReturnPath( $this->transport->getEnvelopeFromEmailAddress() ); + + // add the to recipients + foreach ( ( array ) $message->getToRecipients() as $recipient ) { + $recipient->log( $this->logger, 'To' ); + $mail->addTo( $recipient->getEmail(), $recipient->getName() ); + } + + // add the cc recipients + foreach ( ( array ) $message->getCcRecipients() as $recipient ) { + $recipient->log( $this->logger, 'Cc' ); + $mail->addCc( $recipient->getEmail(), $recipient->getName() ); + } + + // add the to recipients + foreach ( ( array ) $message->getBccRecipients() as $recipient ) { + $recipient->log( $this->logger, 'Bcc' ); + $mail->addBcc( $recipient->getEmail(), $recipient->getName() ); + } + + // add the reply-to + $replyTo = $message->getReplyTo(); + // $replyTo is null or a PostmanEmailAddress object + if ( isset( $replyTo ) ) { + $mail->setReplyTo( $replyTo->getEmail(), $replyTo->getName() ); + } + + // add the date + $date = $message->getDate(); + if ( ! empty( $date ) ) { + $mail->setDate( $date ); + } + + // add the messageId + $messageId = $message->getMessageId(); + if ( ! empty( $messageId ) ) { + $mail->setMessageId( $messageId ); + } + + // add the subject + if ( null !== $message->getSubject() ) { + $mail->setSubject( $message->getSubject() ); + } + + // add the message content + { + $textPart = $message->getBodyTextPart(); + if ( ! empty( $textPart ) ) { + $this->logger->debug( 'Adding body as text' ); + $mail->setBodyText( $textPart ); + } + $htmlPart = $message->getBodyHtmlPart(); + if ( ! empty( $htmlPart ) ) { + $this->logger->debug( 'Adding body as html' ); + $mail->setBodyHtml( $htmlPart ); + } + } + + // add attachments + $this->logger->debug( 'Adding attachments' ); + $message->addAttachmentsToMail( $mail ); + + // create the SMTP transport + $this->logger->debug( 'Create the Zend_Mail transport' ); + $zendTransport = $this->transport->createZendMailTransport( $this->transport->getHostname(), array() ); + + $transport = $this->transport instanceof PostmanDefaultModuleTransport ? null : $zendTransport; + + try { + // send the message + $this->logger->debug( 'Sending mail' ); + $mail->send( $transport ); + if ( $this->logger->isInfo() ) { + $this->logger->info( sprintf( 'Message %d accepted for delivery', PostmanState::getInstance()->getSuccessfulDeliveries() + 1 ) ); + } + // finally not supported?? + if ( $zendTransport->getConnection() && ! PostmanUtils::isEmpty( $zendTransport->getConnection()->getLog() ) ) { + $this->transcript = $zendTransport->getConnection()->getLog(); + } else if ( method_exists( $zendTransport, 'getTranscript' ) && ! PostmanUtils::isEmpty( $zendTransport->getTranscript() ) ) { + // then use the API response + $this->transcript = $zendTransport->getTranscript(); + } else if ( method_exists( $zendTransport, 'getMessage' ) && ! PostmanUtils::isEmpty( $zendTransport->getMessage() ) ) { + // then use the Raw Message as the Transcript + $this->transcript = $zendTransport->getMessage(); + } + } catch ( Exception $e ) { + // finally not supported?? + if ( $zendTransport->getConnection() && ! PostmanUtils::isEmpty( $zendTransport->getConnection()->getLog() ) ) { + $this->transcript = $zendTransport->getConnection()->getLog(); + } else if ( method_exists( $zendTransport, 'getTranscript' ) && ! PostmanUtils::isEmpty( $zendTransport->getTranscript() ) ) { + // then use the API response + $this->transcript = $zendTransport->getTranscript(); + } else if ( method_exists( $zendTransport, 'getMessage' ) && ! PostmanUtils::isEmpty( $zendTransport->getMessage() ) ) { + // then use the Raw Message as the Transcript + $this->transcript = $zendTransport->getMessage(); + } + + // get the current exception message + $message = $e->getMessage(); + if ( $e->getCode() == 334 ) { + // replace the unusable Google message with a better one in the case of code 334 + $message = sprintf( __( 'Communication Error [334] - make sure the Envelope From email is the same account used to create the Client ID.', 'post-smtp' ) ); + } + // create a new exception + $newException = new Exception( $message, $e->getCode() ); + // throw the new exception after handling + throw $newException; + } + } + + /** + * Get the sender from PostmanMessage and add it to the Postman_Zend_Mail object + * + * @param PostmanMessage $message + * @param Postman_Zend_Mail $mail + * @return PostmanEmailAddress + */ + public function addFrom( PostmanMessage $message, Postman_Zend_Mail $mail ) { + $sender = $message->getFromAddress(); + // now log it and push it into the message + $senderEmail = $sender->getEmail(); + $senderName = $sender->getName(); + assert( ! empty( $senderEmail ) ); + if ( ! empty( $senderName ) ) { + $mail->setFrom( $senderEmail, $senderName ); + } else { + $mail->setFrom( $senderEmail ); + } + return $sender; + } + + // return the SMTP session transcript + public function getTranscript() { + return $this->transcript; + } + } +} + diff --git a/Postman/Postman-Mail/PostmanZendMailTransportConfigurationFactory.php b/Postman/Postman-Mail/PostmanZendMailTransportConfigurationFactory.php new file mode 100644 index 0000000..23fdc41 --- /dev/null +++ b/Postman/Postman-Mail/PostmanZendMailTransportConfigurationFactory.php @@ -0,0 +1,133 @@ +getHostname (); + $port = $transport->getPort (); + $securityType = $transport->getSecurityType (); + $authType = $transport->getAuthenticationType (); + $username = $transport->getCredentialsId (); + $password = $transport->getCredentialsSecret (); + + // create the Configuration structure for Zend_Mail + $config = array ( + 'port' => $port + ); + $logger->debug ( sprintf ( 'Using %s:%s ', $hostname, $port ) ); + if ($securityType != PostmanOptions::SECURITY_TYPE_NONE) { + $config ['ssl'] = $securityType; + $logger->debug ( 'Using encryption ' . $securityType ); + } else { + $logger->debug ( 'Using no encryption' ); + } + if ($authType != PostmanOptions::AUTHENTICATION_TYPE_NONE) { + $config ['auth'] = $authType; + $config ['username'] = $username; + $config ['password'] = $password; + $logger->debug ( sprintf ( 'Using auth %s with username %s and password %s', $authType, $username, PostmanUtils::obfuscatePassword ( $password ) ) ); + } else { + $logger->debug ( 'Using no authentication' ); + } + + // return the Configuration structure + return $config; + } + } +} + +if (! class_exists ( 'PostmanOAuth2ConfigurationFactory' )) { + class PostmanOAuth2ConfigurationFactory implements PostmanZendMailTransportConfigurationFactory { + public static function createConfig(PostmanTransport $transport) { + + // create Logger + $logger = new PostmanLogger ( 'PostmanOAuth2ConfigurationFactory' ); + + // retrieve the hostname and port form the transport + $hostname = $transport->getHostname (); + $port = $transport->getPort (); + + // the sender email is needed for the OAuth2 Bearer token + $senderEmail = PostmanOptions::getInstance ()->getEnvelopeSender (); + assert ( ! empty ( $senderEmail ) ); + + // the vendor is required for Yahoo's OAuth2 implementation + $vendor = self::createVendorString ( $hostname ); + + // create the OAuth2 SMTP Authentication string + $initClientRequestEncoded = self::createAuthenticationString ( $senderEmail, PostmanOAuthToken::getInstance ()->getAccessToken (), $vendor ); + + // create the Configuration structure for Zend_Mail + $config = self::createConfiguration ( $logger, $hostname, $port, $transport->getSecurityType (), $transport->getAuthenticationType (), $initClientRequestEncoded ); + + // return the Configuration structure + return $config; + } + + /** + * + * Create the Configuration structure for Zend_Mail + * + * @param mixed $hostname + * @param mixed $port + * @param mixed $securityType + * @param mixed $authenticationType + * @param mixed $initClientRequestEncoded + * @return multitype:unknown NULL + */ + private static function createConfiguration($logger, $hostname, $port, $securityType, $authenticationType, $initClientRequestEncoded) { + $config = array ( + 'ssl' => $securityType, + 'port' => $port, + 'auth' => $authenticationType, + 'xoauth2_request' => $initClientRequestEncoded + ); + $logger->debug ( sprintf ( 'Using auth %s with encryption %s to %s:%s ', $config ['auth'], $config ['ssl'], $hostname, $config ['port'] ) ); + return $config; + } + + /** + * Create the vendor string (for Yahoo servers only) + * + * @param mixed $hostname + * @return string + */ + private static function createVendorString($hostname) { + // the vendor is required for Yahoo's OAuth2 implementation + $vendor = ''; + if (PostmanUtils::endsWith ( $hostname, 'yahoo.com' )) { + // Yahoo Mail requires a Vendor - see http://imapclient.freshfoo.com/changeset/535%3A80ae438f4e4a/ + $pluginData = apply_filters ( 'postman_get_plugin_metadata', null ); + $vendor = sprintf ( "vendor=Postman SMTP %s\1", $pluginData ['version'] ); + } + return $vendor; + } + + /** + * Create the standard OAuth2 SMTP Authentication string + * + * @param mixed $senderEmail + * @param mixed $oauth2AccessToken + * @param mixed $vendor + * @return string + */ + private static function createAuthenticationString($senderEmail, $oauth2AccessToken, $vendor) { + $initClientRequestEncoded = base64_encode ( sprintf ( "user=%s\1auth=Bearer %s\1%s\1", $senderEmail, $oauth2AccessToken, $vendor ) ); + return $initClientRequestEncoded; + } + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Exception.php b/Postman/Postman-Mail/Zend-1.12.10/Exception.php new file mode 100644 index 0000000..7ab867b --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Exception.php @@ -0,0 +1,96 @@ +_previous = $previous; + } else { + parent::__construct($msg, (int) $code, $previous); + } + } + + /** + * Overloading + * + * For PHP < 5.3.0, provides access to the getPrevious() method. + * + * @param string $method + * @param array $args + * @return mixed + */ + public function __call($method, array $args) + { + if ('getprevious' == strtolower($method)) { + return $this->_getPrevious(); + } + return null; + } + + /** + * String representation of the exception + * + * @return string + */ + public function __toString() + { + if (version_compare(PHP_VERSION, '5.3.0', '<')) { + if (null !== ($e = $this->getPrevious())) { + return $e->__toString() + . "\n\nNext " + . parent::__toString(); + } + } + return parent::__toString(); + } + + /** + * Returns previous Exception + * + * @return Exception|null + */ + protected function _getPrevious() + { + return $this->_previous; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Loader.php b/Postman/Postman-Mail/Zend-1.12.10/Loader.php new file mode 100644 index 0000000..0635c77 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Loader.php @@ -0,0 +1,343 @@ + $dir) { + if ($dir == '.') { + $dirs[$key] = $dirPath; + } else { + $dir = rtrim($dir, '\\/'); + $dirs[$key] = $dir . DIRECTORY_SEPARATOR . $dirPath; + } + } + $file = basename($file); + self::loadFile($file, $dirs, true); + } else { + self::loadFile($file, null, true); + } + + if (!class_exists($class, false) && !interface_exists($class, false)) { + require_once 'Zend/Exception.php'; + throw new Postman_Zend_Exception("File \"$file\" does not exist or class \"$class\" was not found in the file"); + } + } + + /** + * Loads a PHP file. This is a wrapper for PHP's include() function. + * + * $filename must be the complete filename, including any + * extension such as ".php". Note that a security check is performed that + * does not permit extended characters in the filename. This method is + * intended for loading Zend Framework files. + * + * If $dirs is a string or an array, it will search the directories + * in the order supplied, and attempt to load the first matching file. + * + * If the file was not found in the $dirs, or if no $dirs were specified, + * it will attempt to load it from PHP's include_path. + * + * If $once is TRUE, it will use include_once() instead of include(). + * + * @param string $filename + * @param string|array $dirs - OPTIONAL either a path or array of paths + * to search. + * @param boolean $once + * @return boolean + * @throws Postman_Zend_Exception + */ + public static function loadFile($filename, $dirs = null, $once = false) + { + self::_securityCheck($filename); + + /** + * Search in provided directories, as well as include_path + */ + $incPath = false; + if (!empty($dirs) && (is_array($dirs) || is_string($dirs))) { + if (is_array($dirs)) { + $dirs = implode(PATH_SEPARATOR, $dirs); + } + $incPath = get_include_path(); + set_include_path($dirs . PATH_SEPARATOR . $incPath); + } + + /** + * Try finding for the plain filename in the include_path. + */ + if ($once) { + include_once $filename; + } else { + include $filename; + } + + /** + * If searching in directories, reset include_path + */ + if ($incPath) { + set_include_path($incPath); + } + + return true; + } + + /** + * Returns TRUE if the $filename is readable, or FALSE otherwise. + * This function uses the PHP include_path, where PHP's is_readable() + * does not. + * + * Note from ZF-2900: + * If you use custom error handler, please check whether return value + * from error_reporting() is zero or not. + * At mark of fopen() can not suppress warning if the handler is used. + * + * @param string $filename + * @return boolean + */ + public static function isReadable($filename) + { + if (is_readable($filename)) { + // Return early if the filename is readable without needing the + // include_path + return true; + } + + if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN' + && preg_match('/^[a-z]:/i', $filename) + ) { + // If on windows, and path provided is clearly an absolute path, + // return false immediately + return false; + } + + foreach (self::explodeIncludePath() as $path) { + if ($path == '.') { + if (is_readable($filename)) { + return true; + } + continue; + } + $file = $path . '/' . $filename; + if (is_readable($file)) { + return true; + } + } + return false; + } + + /** + * Explode an include path into an array + * + * If no path provided, uses current include_path. Works around issues that + * occur when the path includes stream schemas. + * + * @param string|null $path + * @return array + */ + public static function explodeIncludePath($path = null) + { + if (null === $path) { + $path = get_include_path(); + } + + if (PATH_SEPARATOR == ':') { + // On *nix systems, include_paths which include paths with a stream + // schema cannot be safely explode'd, so we have to be a bit more + // intelligent in the approach. + $paths = preg_split('#:(?!//)#', $path); + } else { + $paths = explode(PATH_SEPARATOR, $path); + } + return $paths; + } + + /** + * spl_autoload() suitable implementation for supporting class autoloading. + * + * Attach to spl_autoload() using the following: + * + * spl_autoload_register(array('Postman_Zend_Loader', 'autoload')); + * + * + * @deprecated Since 1.8.0 + * @param string $class + * @return string|false Class name on success; false on failure + */ + public static function autoload($class) + { + trigger_error(__CLASS__ . '::' . __METHOD__ . ' is deprecated as of 1.8.0 and will be removed with 2.0.0; use Postman_Zend_Loader_Autoloader instead', E_USER_NOTICE); + try { + @self::loadClass($class); + return $class; + } catch (Exception $e) { + return false; + } + } + + /** + * Register {@link autoload()} with spl_autoload() + * + * @deprecated Since 1.8.0 + * @param string $class (optional) + * @param boolean $enabled (optional) + * @return void + * @throws Postman_Zend_Exception if spl_autoload() is not found + * or if the specified class does not have an autoload() method. + */ + public static function registerAutoload($class = 'Postman_Zend_Loader', $enabled = true) + { + trigger_error(__CLASS__ . '::' . __METHOD__ . ' is deprecated as of 1.8.0 and will be removed with 2.0.0; use Postman_Zend_Loader_Autoloader instead', E_USER_NOTICE); + require_once 'Zend/Loader/Autoloader.php'; + $autoloader = Postman_Zend_Loader_Autoloader::getInstance(); + $autoloader->setFallbackAutoloader(true); + + if ('Postman_Zend_Loader' != $class) { + self::loadClass($class); + $methods = get_class_methods($class); + if (!in_array('autoload', (array) $methods)) { + require_once 'Zend/Exception.php'; + throw new Postman_Zend_Exception("The class \"$class\" does not have an autoload() method"); + } + + $callback = array($class, 'autoload'); + + if ($enabled) { + $autoloader->pushAutoloader($callback); + } else { + $autoloader->removeAutoloader($callback); + } + } + } + + /** + * Ensure that filename does not contain exploits + * + * @param string $filename + * @return void + * @throws Postman_Zend_Exception + */ + protected static function _securityCheck($filename) + { + /** + * Security check + */ + if (preg_match('/[^a-z0-9\\/\\\\_.:-]/i', $filename)) { + require_once 'Zend/Exception.php'; + throw new Postman_Zend_Exception('Security check: Illegal character in filename'); + } + } + + /** + * Attempt to include() the file. + * + * include() is not prefixed with the @ operator because if + * the file is loaded and contains a parse error, execution + * will halt silently and this is difficult to debug. + * + * Always set display_errors = Off on production servers! + * + * @param string $filespec + * @param boolean $once + * @return boolean + * @deprecated Since 1.5.0; use loadFile() instead + */ + protected static function _includeFile($filespec, $once = false) + { + if ($once) { + return include_once $filespec; + } else { + return include $filespec ; + } + } + + /** + * Standardise the filename. + * + * Convert the supplied filename into the namespace-aware standard, + * based on the Framework Interop Group reference implementation: + * http://groups.google.com/group/php-standards/web/psr-0-final-proposal + * + * The filename must be formatted as "$file.php". + * + * @param string $file - The file name to be loaded. + * @return string + */ + public static function standardiseFile($file) + { + $fileName = ltrim($file, '\\'); + $file = ''; + $namespace = ''; + if ($lastNsPos = strripos($fileName, '\\')) { + $namespace = substr($fileName, 0, $lastNsPos); + $fileName = substr($fileName, $lastNsPos + 1); + $file = str_replace('\\', DIRECTORY_SEPARATOR, $namespace) . DIRECTORY_SEPARATOR; + } + $file .= str_replace('_', DIRECTORY_SEPARATOR, $fileName) . '.php'; + return $file; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Loader/Autoloader.php b/Postman/Postman-Mail/Zend-1.12.10/Loader/Autoloader.php new file mode 100644 index 0000000..84b8e72 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Loader/Autoloader.php @@ -0,0 +1,589 @@ + true, + 'ZendX_' => true, + ); + + /** + * @var array Namespace-specific autoloaders + */ + protected $_namespaceAutoloaders = array(); + + /** + * @var bool Whether or not to suppress file not found warnings + */ + protected $_suppressNotFoundWarnings = false; + + /** + * @var null|string + */ + protected $_zfPath; + + /** + * Retrieve singleton instance + * + * @return Postman_Zend_Loader_Autoloader + */ + public static function getInstance() + { + if (null === self::$_instance) { + self::$_instance = new self(); + } + return self::$_instance; + } + + /** + * Reset the singleton instance + * + * @return void + */ + public static function resetInstance() + { + self::$_instance = null; + } + + /** + * Autoload a class + * + * @param string $class + * @return bool + */ + public static function autoload($class) + { + $self = self::getInstance(); + + foreach ($self->getClassAutoloaders($class) as $autoloader) { + if ($autoloader instanceof Postman_Zend_Loader_Autoloader_Interface) { + if ($autoloader->autoload($class)) { + return true; + } + } elseif (is_array($autoloader)) { + if (call_user_func($autoloader, $class)) { + return true; + } + } elseif (is_string($autoloader) || is_callable($autoloader)) { + if ($autoloader($class)) { + return true; + } + } + } + + return false; + } + + /** + * Set the default autoloader implementation + * + * @param string|array $callback PHP callback + * @return void + */ + public function setDefaultAutoloader($callback) + { + if (!is_callable($callback)) { + throw new Postman_Zend_Loader_Exception('Invalid callback specified for default autoloader'); + } + + $this->_defaultAutoloader = $callback; + return $this; + } + + /** + * Retrieve the default autoloader callback + * + * @return string|array PHP Callback + */ + public function getDefaultAutoloader() + { + return $this->_defaultAutoloader; + } + + /** + * Set several autoloader callbacks at once + * + * @param array $autoloaders Array of PHP callbacks (or Postman_Zend_Loader_Autoloader_Interface implementations) to act as autoloaders + * @return Postman_Zend_Loader_Autoloader + */ + public function setAutoloaders(array $autoloaders) + { + $this->_autoloaders = $autoloaders; + return $this; + } + + /** + * Get attached autoloader implementations + * + * @return array + */ + public function getAutoloaders() + { + return $this->_autoloaders; + } + + /** + * Return all autoloaders for a given namespace + * + * @param string $namespace + * @return array + */ + public function getNamespaceAutoloaders($namespace) + { + $namespace = (string) $namespace; + if (!array_key_exists($namespace, $this->_namespaceAutoloaders)) { + return array(); + } + return $this->_namespaceAutoloaders[$namespace]; + } + + /** + * Register a namespace to autoload + * + * @param string|array $namespace + * @return Postman_Zend_Loader_Autoloader + */ + public function registerNamespace($namespace) + { + if (is_string($namespace)) { + $namespace = (array) $namespace; + } elseif (!is_array($namespace)) { + throw new Postman_Zend_Loader_Exception('Invalid namespace provided'); + } + + foreach ($namespace as $ns) { + if (!isset($this->_namespaces[$ns])) { + $this->_namespaces[$ns] = true; + } + } + return $this; + } + + /** + * Unload a registered autoload namespace + * + * @param string|array $namespace + * @return Postman_Zend_Loader_Autoloader + */ + public function unregisterNamespace($namespace) + { + if (is_string($namespace)) { + $namespace = (array) $namespace; + } elseif (!is_array($namespace)) { + throw new Postman_Zend_Loader_Exception('Invalid namespace provided'); + } + + foreach ($namespace as $ns) { + if (isset($this->_namespaces[$ns])) { + unset($this->_namespaces[$ns]); + } + } + return $this; + } + + /** + * Get a list of registered autoload namespaces + * + * @return array + */ + public function getRegisteredNamespaces() + { + return array_keys($this->_namespaces); + } + + public function setZfPath($spec, $version = 'latest') + { + $path = $spec; + if (is_array($spec)) { + if (!isset($spec['path'])) { + throw new Postman_Zend_Loader_Exception('No path specified for ZF'); + } + $path = $spec['path']; + if (isset($spec['version'])) { + $version = $spec['version']; + } + } + + $this->_zfPath = $this->_getVersionPath($path, $version); + set_include_path(implode(PATH_SEPARATOR, array( + $this->_zfPath, + get_include_path(), + ))); + return $this; + } + + public function getZfPath() + { + return $this->_zfPath; + } + + /** + * Get or set the value of the "suppress not found warnings" flag + * + * @param null|bool $flag + * @return bool|Postman_Zend_Loader_Autoloader Returns boolean if no argument is passed, object instance otherwise + */ + public function suppressNotFoundWarnings($flag = null) + { + if (null === $flag) { + return $this->_suppressNotFoundWarnings; + } + $this->_suppressNotFoundWarnings = (bool) $flag; + return $this; + } + + /** + * Indicate whether or not this autoloader should be a fallback autoloader + * + * @param bool $flag + * @return Postman_Zend_Loader_Autoloader + */ + public function setFallbackAutoloader($flag) + { + $this->_fallbackAutoloader = (bool) $flag; + return $this; + } + + /** + * Is this instance acting as a fallback autoloader? + * + * @return bool + */ + public function isFallbackAutoloader() + { + return $this->_fallbackAutoloader; + } + + /** + * Get autoloaders to use when matching class + * + * Determines if the class matches a registered namespace, and, if so, + * returns only the autoloaders for that namespace. Otherwise, it returns + * all non-namespaced autoloaders. + * + * @param string $class + * @return array Array of autoloaders to use + */ + public function getClassAutoloaders($class) + { + $namespace = false; + $autoloaders = array(); + + // Add concrete namespaced autoloaders + foreach (array_keys($this->_namespaceAutoloaders) as $ns) { + if ('' == $ns) { + continue; + } + if (0 === strpos($class, $ns)) { + if ((false === $namespace) || (strlen($ns) > strlen($namespace))) { + $namespace = $ns; + $autoloaders = $this->getNamespaceAutoloaders($ns); + } + } + } + + // Add internal namespaced autoloader + foreach ($this->getRegisteredNamespaces() as $ns) { + if (0 === strpos($class, $ns)) { + $namespace = $ns; + $autoloaders[] = $this->_internalAutoloader; + break; + } + } + + // Add non-namespaced autoloaders + $autoloadersNonNamespace = $this->getNamespaceAutoloaders(''); + if (count($autoloadersNonNamespace)) { + foreach ($autoloadersNonNamespace as $ns) { + $autoloaders[] = $ns; + } + unset($autoloadersNonNamespace); + } + + // Add fallback autoloader + if (!$namespace && $this->isFallbackAutoloader()) { + $autoloaders[] = $this->_internalAutoloader; + } + + return $autoloaders; + } + + /** + * Add an autoloader to the beginning of the stack + * + * @param object|array|string $callback PHP callback or Postman_Zend_Loader_Autoloader_Interface implementation + * @param string|array $namespace Specific namespace(s) under which to register callback + * @return Postman_Zend_Loader_Autoloader + */ + public function unshiftAutoloader($callback, $namespace = '') + { + $autoloaders = $this->getAutoloaders(); + array_unshift($autoloaders, $callback); + $this->setAutoloaders($autoloaders); + + $namespace = (array) $namespace; + foreach ($namespace as $ns) { + $autoloaders = $this->getNamespaceAutoloaders($ns); + array_unshift($autoloaders, $callback); + $this->_setNamespaceAutoloaders($autoloaders, $ns); + } + + return $this; + } + + /** + * Append an autoloader to the autoloader stack + * + * @param object|array|string $callback PHP callback or Postman_Zend_Loader_Autoloader_Interface implementation + * @param string|array $namespace Specific namespace(s) under which to register callback + * @return Postman_Zend_Loader_Autoloader + */ + public function pushAutoloader($callback, $namespace = '') + { + $autoloaders = $this->getAutoloaders(); + array_push($autoloaders, $callback); + $this->setAutoloaders($autoloaders); + + $namespace = (array) $namespace; + foreach ($namespace as $ns) { + $autoloaders = $this->getNamespaceAutoloaders($ns); + array_push($autoloaders, $callback); + $this->_setNamespaceAutoloaders($autoloaders, $ns); + } + + return $this; + } + + /** + * Remove an autoloader from the autoloader stack + * + * @param object|array|string $callback PHP callback or Postman_Zend_Loader_Autoloader_Interface implementation + * @param null|string|array $namespace Specific namespace(s) from which to remove autoloader + * @return Postman_Zend_Loader_Autoloader + */ + public function removeAutoloader($callback, $namespace = null) + { + if (null === $namespace) { + $autoloaders = $this->getAutoloaders(); + if (false !== ($index = array_search($callback, $autoloaders, true))) { + unset($autoloaders[$index]); + $this->setAutoloaders($autoloaders); + } + + foreach ($this->_namespaceAutoloaders as $ns => $autoloaders) { + if (false !== ($index = array_search($callback, $autoloaders, true))) { + unset($autoloaders[$index]); + $this->_setNamespaceAutoloaders($autoloaders, $ns); + } + } + } else { + $namespace = (array) $namespace; + foreach ($namespace as $ns) { + $autoloaders = $this->getNamespaceAutoloaders($ns); + if (false !== ($index = array_search($callback, $autoloaders, true))) { + unset($autoloaders[$index]); + $this->_setNamespaceAutoloaders($autoloaders, $ns); + } + } + } + + return $this; + } + + /** + * Constructor + * + * Registers instance with spl_autoload stack + * + * @return void + */ + protected function __construct() + { + spl_autoload_register(array(__CLASS__, 'autoload')); + $this->_internalAutoloader = array($this, '_autoload'); + } + + /** + * Internal autoloader implementation + * + * @param string $class + * @return bool + */ + protected function _autoload($class) + { + $callback = $this->getDefaultAutoloader(); + try { + if ($this->suppressNotFoundWarnings()) { + @call_user_func($callback, $class); + } else { + call_user_func($callback, $class); + } + return $class; + } catch (Postman_Zend_Exception $e) { + return false; + } + } + + /** + * Set autoloaders for a specific namespace + * + * @param array $autoloaders + * @param string $namespace + * @return Postman_Zend_Loader_Autoloader + */ + protected function _setNamespaceAutoloaders(array $autoloaders, $namespace = '') + { + $namespace = (string) $namespace; + $this->_namespaceAutoloaders[$namespace] = $autoloaders; + return $this; + } + + /** + * Retrieve the filesystem path for the requested ZF version + * + * @param string $path + * @param string $version + * @return void + */ + protected function _getVersionPath($path, $version) + { + $type = $this->_getVersionType($version); + + if ($type == 'latest') { + $version = 'latest'; + } + + $availableVersions = $this->_getAvailableVersions($path, $version); + if (empty($availableVersions)) { + throw new Postman_Zend_Loader_Exception('No valid ZF installations discovered'); + } + + $matchedVersion = array_pop($availableVersions); + return $matchedVersion; + } + + /** + * Retrieve the ZF version type + * + * @param string $version + * @return string "latest", "major", "minor", or "specific" + * @throws Postman_Zend_Loader_Exception if version string contains too many dots + */ + protected function _getVersionType($version) + { + if (strtolower($version) == 'latest') { + return 'latest'; + } + + $parts = explode('.', $version); + $count = count($parts); + if (1 == $count) { + return 'major'; + } + if (2 == $count) { + return 'minor'; + } + if (3 < $count) { + throw new Postman_Zend_Loader_Exception('Invalid version string provided'); + } + return 'specific'; + } + + /** + * Get available versions for the version type requested + * + * @param string $path + * @param string $version + * @return array + */ + protected function _getAvailableVersions($path, $version) + { + if (!is_dir($path)) { + throw new Postman_Zend_Loader_Exception('Invalid ZF path provided'); + } + + $path = rtrim($path, '/'); + $path = rtrim($path, '\\'); + $versionLen = strlen($version); + $versions = array(); + $dirs = glob("$path/*", GLOB_ONLYDIR); + foreach ((array) $dirs as $dir) { + $dirName = substr($dir, strlen($path) + 1); + if (!preg_match('/^(?:ZendFramework-)?(\d+\.\d+\.\d+((a|b|pl|pr|p|rc)\d+)?)(?:-minimal)?$/i', $dirName, $matches)) { + continue; + } + + $matchedVersion = $matches[1]; + + if (('latest' == $version) + || ((strlen($matchedVersion) >= $versionLen) + && (0 === strpos($matchedVersion, $version))) + ) { + $versions[$matchedVersion] = $dir . '/library'; + } + } + + uksort($versions, 'version_compare'); + return $versions; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail.php b/Postman/Postman-Mail/Zend-1.12.10/Mail.php new file mode 100644 index 0000000..702add0 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail.php @@ -0,0 +1,1291 @@ +_charset = $charset; + } + } + + /** + * Return charset string + * + * @return string + */ + public function getCharset() + { + return $this->_charset; + } + + /** + * Set content type + * + * Should only be used for manually setting multipart content types. + * + * @param string $type Content type + * @return Postman_Zend_Mail Implements fluent interface + * @throws Postman_Zend_Mail_Exception for types not supported by Postman_Zend_Mime + */ + public function setType($type) + { + $allowed = array( + Postman_Zend_Mime::MULTIPART_ALTERNATIVE, + Postman_Zend_Mime::MULTIPART_MIXED, + Postman_Zend_Mime::MULTIPART_RELATED, + ); + if (!in_array($type, $allowed)) { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('Invalid content type "' . $type . '"'); + } + + $this->_type = $type; + return $this; + } + + /** + * Get content type of the message + * + * @return string + */ + public function getType() + { + return $this->_type; + } + + /** + * Set an arbitrary mime boundary for the message + * + * If not set, Postman_Zend_Mime will generate one. + * + * @param string $boundary + * @return Postman_Zend_Mail Provides fluent interface + */ + public function setMimeBoundary($boundary) + { + $this->_mimeBoundary = $boundary; + + return $this; + } + + /** + * Return the boundary string used for the message + * + * @return string + */ + public function getMimeBoundary() + { + return $this->_mimeBoundary; + } + + /** + * Return encoding of mail headers + * + * @deprecated use {@link getHeaderEncoding()} instead + * @return string + */ + public function getEncodingOfHeaders() + { + return $this->getHeaderEncoding(); + } + + /** + * Return the encoding of mail headers + * + * Either Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE or Postman_Zend_Mime::ENCODING_BASE64 + * + * @return string + */ + public function getHeaderEncoding() + { + return $this->_headerEncoding; + } + + /** + * Set the encoding of mail headers + * + * @deprecated Use {@link setHeaderEncoding()} instead. + * @param string $encoding + * @return Postman_Zend_Mail + */ + public function setEncodingOfHeaders($encoding) + { + return $this->setHeaderEncoding($encoding); + } + + /** + * Set the encoding of mail headers + * + * @param string $encoding Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE or Postman_Zend_Mime::ENCODING_BASE64 + * @return Postman_Zend_Mail Provides fluent interface + */ + public function setHeaderEncoding($encoding) + { + $allowed = array( + Postman_Zend_Mime::ENCODING_BASE64, + Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE + ); + if (!in_array($encoding, $allowed)) { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('Invalid encoding "' . $encoding . '"'); + } + $this->_headerEncoding = $encoding; + + return $this; + } + + /** + * Sets the text body for the message. + * + * @param string $txt + * @param string $charset + * @param string $encoding + * @return Postman_Zend_Mail Provides fluent interface + */ + public function setBodyText($txt, $charset = null, $encoding = Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE) + { + if ($charset === null) { + $charset = $this->_charset; + } + + $mp = new Postman_Zend_Mime_Part($txt); + $mp->encoding = apply_filters( 'post_smtp_content_transfer_encoding', $encoding, Postman_Zend_Mime::TYPE_TEXT); + $mp->type = Postman_Zend_Mime::TYPE_TEXT; + $mp->disposition = Postman_Zend_Mime::DISPOSITION_INLINE; + $mp->charset = $charset; + + $this->_bodyText = $mp; + + return $this; + } + + /** + * Return text body Postman_Zend_Mime_Part or string + * + * @param bool textOnly Whether to return just the body text content or the MIME part; defaults to false, the MIME part + * @return false|Postman_Zend_Mime_Part|string + */ + public function getBodyText($textOnly = false) + { + if ($textOnly && $this->_bodyText) { + $body = $this->_bodyText; + return $body->getContent(); + } + + return $this->_bodyText; + } + + /** + * Sets the HTML body for the message + * + * @param string $html + * @param string $charset + * @param string $encoding + * @return Postman_Zend_Mail Provides fluent interface + */ + public function setBodyHtml($html, $charset = null, $encoding = Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE) + { + if ($charset === null) { + $charset = $this->_charset; + } + + $mp = new Postman_Zend_Mime_Part($html); + $mp->encoding = apply_filters( 'post_smtp_content_transfer_encoding', $encoding, Postman_Zend_Mime::TYPE_HTML ); + $mp->type = Postman_Zend_Mime::TYPE_HTML; + $mp->disposition = Postman_Zend_Mime::DISPOSITION_INLINE; + $mp->charset = $charset; + + $this->_bodyHtml = $mp; + + return $this; + } + + /** + * Return Postman_Zend_Mime_Part representing body HTML + * + * @param bool $htmlOnly Whether to return the body HTML only, or the MIME part; defaults to false, the MIME part + * @return false|Postman_Zend_Mime_Part|string + */ + public function getBodyHtml($htmlOnly = false) + { + if ($htmlOnly && $this->_bodyHtml) { + $body = $this->_bodyHtml; + return $body->getContent(); + } + + return $this->_bodyHtml; + } + + /** + * Adds an existing attachment to the mail message + * + * @param Postman_Zend_Mime_Part $attachment + * @return Postman_Zend_Mail Provides fluent interface + */ + public function addAttachment(Postman_Zend_Mime_Part $attachment) + { + $this->addPart($attachment); + $this->hasAttachments = true; + + return $this; + } + + /** + * Creates a Postman_Zend_Mime_Part attachment + * + * Attachment is automatically added to the mail object after creation. The + * attachment object is returned to allow for further manipulation. + * + * @param string $body + * @param string $mimeType + * @param string $disposition + * @param string $encoding + * @param string $filename OPTIONAL A filename for the attachment + * @return Postman_Zend_Mime_Part Newly created Postman_Zend_Mime_Part object (to allow + * advanced settings) + */ + public function createAttachment($body, + $mimeType = Postman_Zend_Mime::TYPE_OCTETSTREAM, + $disposition = Postman_Zend_Mime::DISPOSITION_ATTACHMENT, + $encoding = Postman_Zend_Mime::ENCODING_BASE64, + $filename = null) + { + + $mp = new Postman_Zend_Mime_Part($body); + $mp->encoding = $encoding; + $mp->type = $mimeType; + $mp->disposition = $disposition; + $mp->filename = $filename; + + $this->addAttachment($mp); + + return $mp; + } + + /** + * Return a count of message parts + * + * @return integer + */ + public function getPartCount() + { + return count($this->_parts); + } + + /** + * Encode header fields + * + * Encodes header content according to RFC1522 if it contains non-printable + * characters. + * + * @param string $value + * @return string + */ + protected function _encodeHeader($value) + { + if (Postman_Zend_Mime::isPrintable($value) === false) { + if ($this->getHeaderEncoding() === Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE) { + $value = Postman_Zend_Mime::encodeQuotedPrintableHeader($value, $this->getCharset(), Postman_Zend_Mime::LINELENGTH, Postman_Zend_Mime::LINEEND); + } else { + $value = Postman_Zend_Mime::encodeBase64Header($value, $this->getCharset(), Postman_Zend_Mime::LINELENGTH, Postman_Zend_Mime::LINEEND); + } + } + + return $value; + } + + /** + * Add a header to the message + * + * Adds a header to this message. If append is true and the header already + * exists, raises a flag indicating that the header should be appended. + * + * @param string $headerName + * @param string $value + * @param bool $append + */ + protected function _storeHeader($headerName, $value, $append = false) + { + if (isset($this->_headers[$headerName])) { + $this->_headers[$headerName][] = $value; + } else { + $this->_headers[$headerName] = array($value); + } + + if ($append) { + $this->_headers[$headerName]['append'] = true; + } + + } + + /** + * Clear header from the message + * + * @param string $headerName + * @deprecated use public method directly + */ + protected function _clearHeader($headerName) + { + $this->clearHeader($headerName); + } + + /** + * Helper function for adding a recipient and the corresponding header + * + * @param string $headerName + * @param string $email + * @param string $name + */ + protected function _addRecipientAndHeader($headerName, $email, $name) + { + $email = $this->_filterEmail($email); + $name = $this->_filterName($name); + // prevent duplicates + $this->_recipients[$email] = 1; + $this->_storeHeader($headerName, $this->_formatAddress($email, $name), true); + } + + /** + * Adds To-header and recipient, $email can be an array, or a single string address + * + * @param string|array $email + * @param string $name + * @return Postman_Zend_Mail Provides fluent interface + */ + public function addTo($email, $name='') + { + if (!is_array($email)) { + $email = array($name => $email); + } + + foreach ($email as $n => $recipient) { + $this->_addRecipientAndHeader('To', $recipient, is_int($n) ? '' : $n); + $this->_to[] = $recipient; + } + + return $this; + } + + /** + * Adds Cc-header and recipient, $email can be an array, or a single string address + * + * @param string|array $email + * @param string $name + * @return Postman_Zend_Mail Provides fluent interface + */ + public function addCc($email, $name='') + { + if (!is_array($email)) { + $email = array($name => $email); + } + + foreach ($email as $n => $recipient) { + $this->_addRecipientAndHeader('Cc', $recipient, is_int($n) ? '' : $n); + } + + return $this; + } + + /** + * Adds Bcc recipient, $email can be an array, or a single string address + * + * @param string|array $email + * @return Postman_Zend_Mail Provides fluent interface + */ + public function addBcc($email) + { + if (!is_array($email)) { + $email = array($email); + } + + foreach ($email as $recipient) { + $this->_addRecipientAndHeader('Bcc', $recipient, ''); + } + + return $this; + } + + /** + * Return list of recipient email addresses + * + * @return array (of strings) + */ + public function getRecipients() + { + return array_keys($this->_recipients); + } + + /** + * Clear header from the message + * + * @param string $headerName + * @return Postman_Zend_Mail Provides fluent inter + */ + public function clearHeader($headerName) + { + if (isset($this->_headers[$headerName])){ + unset($this->_headers[$headerName]); + } + return $this; + } + + /** + * Clears list of recipient email addresses + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function clearRecipients() + { + $this->_recipients = array(); + $this->_to = array(); + + $this->clearHeader('To'); + $this->clearHeader('Cc'); + $this->clearHeader('Bcc'); + + return $this; + } + + /** + * Sets From-header and sender of the message + * + * @param string $email + * @param string $name + * @return Postman_Zend_Mail Provides fluent interface + * @throws Postman_Zend_Mail_Exception if called subsequent times + */ + public function setFrom($email, $name = null) + { + if (null !== $this->_from) { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('From Header set twice'); + } + + $email = $this->_filterEmail($email); + $name = $this->_filterName($name); + $this->_from = $email; + $this->_storeHeader('From', $this->_formatAddress($email, $name), true); + + return $this; + } + + /** + * Set Reply-To Header + * + * @param string $email + * @param string $name + * @return Postman_Zend_Mail + * @throws Postman_Zend_Mail_Exception if called more than one time + */ + public function setReplyTo($email, $name = null) + { + if (null !== $this->_replyTo) { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('Reply-To Header set twice'); + } + + $name = $this->_filterName($name); + $this->_replyTo = $email; + + if ( strpos( $email, ',' ) !== false ) { + $emails = explode(',', $email ); + foreach ( $emails as $email ) { + $email = $this->_filterEmail($email); + $replyToList[] = $this->_formatAddress($email, $name); + } + } else { + $email = $this->_filterEmail($email); + $replyToList[] = $this->_formatAddress($email, $name); + } + + $this->_storeHeader('Reply-To', implode(',', $replyToList ), true); + + return $this; + } + + /** + * Returns the sender of the mail + * + * @return string + */ + public function getFrom() + { + return $this->_from; + } + + /** + * Returns the current Reply-To address of the message + * + * @return string|null Reply-To address, null when not set + */ + public function getReplyTo() + { + return $this->_replyTo; + } + + /** + * Clears the sender from the mail + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function clearFrom() + { + $this->_from = null; + $this->clearHeader('From'); + + return $this; + } + + /** + * Clears the current Reply-To address from the message + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function clearReplyTo() + { + $this->_replyTo = null; + $this->clearHeader('Reply-To'); + + return $this; + } + + /** + * Sets Default From-email and name of the message + * + * @param string $email + * @param string Optional $name + * @return void + */ + public static function setDefaultFrom($email, $name = null) + { + self::$_defaultFrom = array('email' => $email, 'name' => $name); + } + + /** + * Returns the default sender of the mail + * + * @return null|array Null if none was set. + */ + public static function getDefaultFrom() + { + return self::$_defaultFrom; + } + + /** + * Clears the default sender from the mail + * + * @return void + */ + public static function clearDefaultFrom() + { + self::$_defaultFrom = null; + } + + /** + * Sets From-name and -email based on the defaults + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function setFromToDefaultFrom() { + $from = self::getDefaultFrom(); + if($from === null) { +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception( + 'No default From Address set to use'); + } + + $this->setFrom($from['email'], $from['name']); + + return $this; + } + + /** + * Sets Default ReplyTo-address and -name of the message + * + * @param string $email + * @param string Optional $name + * @return void + */ + public static function setDefaultReplyTo($email, $name = null) + { + self::$_defaultReplyTo = array('email' => $email, 'name' => $name); + } + + /** + * Returns the default Reply-To Address and Name of the mail + * + * @return null|array Null if none was set. + */ + public static function getDefaultReplyTo() + { + return self::$_defaultReplyTo; + } + + /** + * Clears the default ReplyTo-address and -name from the mail + * + * @return void + */ + public static function clearDefaultReplyTo() + { + self::$_defaultReplyTo = null; + } + + /** + * Sets ReplyTo-name and -email based on the defaults + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function setReplyToFromDefault() { + $replyTo = self::getDefaultReplyTo(); + if($replyTo === null) { +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception( + 'No default Reply-To Address set to use'); + } + + $this->setReplyTo($replyTo['email'], $replyTo['name']); + + return $this; + } + + /** + * Sets the Return-Path header of the message + * + * @param string $email + * @return Postman_Zend_Mail Provides fluent interface + * @throws Postman_Zend_Mail_Exception if set multiple times + */ + public function setReturnPath($email) + { + if ($this->_returnPath === null) { + $email = $this->_filterEmail($email); + $this->_returnPath = $email; + // Postman SMTP Fix - Jason Hendriks + // according to RFC 5321, Return-Path should not be set my the MUA + // http://tools.ietf.org/html/rfc5321#section-4.4 + // $this->_storeHeader('Return-Path', $email, false); + } else { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('Return-Path Header set twice'); + } + return $this; + } + + /** + * Returns the current Return-Path address of the message + * + * If no Return-Path header is set, returns the value of {@link $_from}. + * + * @return string + */ + public function getReturnPath() + { + if (null !== $this->_returnPath) { + return $this->_returnPath; + } + + return $this->_from; + } + + /** + * Clears the current Return-Path address from the message + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function clearReturnPath() + { + $this->_returnPath = null; + $this->clearHeader('Return-Path'); + + return $this; + } + + /** + * Sets the subject of the message + * + * @param string $subject + * @return Postman_Zend_Mail Provides fluent interface + * @throws Postman_Zend_Mail_Exception + */ + public function setSubject($subject) + { + if ($this->_subject === null) { + $subject = $this->_filterOther($subject); + $this->_subject = $this->_encodeHeader($subject); + $this->_storeHeader('Subject', $this->_subject); + } else { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('Subject set twice'); + } + return $this; + } + + /** + * Returns the encoded subject of the message + * + * @return string + */ + public function getSubject() + { + return $this->_subject; + } + + /** + * Clears the encoded subject from the message + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function clearSubject() + { + $this->_subject = null; + $this->clearHeader('Subject'); + + return $this; + } + + /** + * Sets Date-header + * + * @param timestamp|string|Postman_Zend_Date $date + * @return Postman_Zend_Mail Provides fluent interface + * @throws Postman_Zend_Mail_Exception if called subsequent times or wrong date format. + */ + public function setDate($date = null) + { + if ($this->_date === null) { + if ($date === null) { + $date = date('r'); + } else if (is_int($date)) { + $date = date('r', $date); + } else if (is_string($date)) { + $date = strtotime($date); + if ($date === false || $date < 0) { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('String representations of Date Header must be ' . + 'strtotime()-compatible'); + } + $date = date('r', $date); + } else if ($date instanceof Postman_Zend_Date) { + $date = $date->get(Postman_Zend_Date::RFC_2822); + } else { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception(__METHOD__ . ' only accepts UNIX timestamps, Postman_Zend_Date objects, ' . + ' and strtotime()-compatible strings'); + } + $this->_date = $date; + $this->_storeHeader('Date', $date); + } else { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('Date Header set twice'); + } + return $this; + } + + /** + * Returns the formatted date of the message + * + * @return string + */ + public function getDate() + { + return $this->_date; + } + + /** + * Clears the formatted date from the message + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function clearDate() + { + $this->_date = null; + $this->clearHeader('Date'); + + return $this; + } + + /** + * Sets the Message-ID of the message + * + * @param boolean|string $id + * true :Auto + * false :No set + * null :No set + * string:Sets given string (Angle brackets is not necessary) + * @return Postman_Zend_Mail Provides fluent interface + * @throws Postman_Zend_Mail_Exception + */ + public function setMessageId($id = true) + { + if ($id === null || $id === false) { + return $this; + } elseif ($id === true) { + $id = $this->createMessageId(); + } + + if ($this->_messageId === null) { + $id = $this->_filterOther($id); + $this->_messageId = $id; + $this->_storeHeader('Message-Id', '<' . $this->_messageId . '>'); + } else { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('Message-ID set twice'); + } + + return $this; + } + + /** + * Returns the Message-ID of the message + * + * @return string + */ + public function getMessageId() + { + return $this->_messageId; + } + + + /** + * Clears the Message-ID from the message + * + * @return Postman_Zend_Mail Provides fluent interface + */ + public function clearMessageId() + { + $this->_messageId = null; + $this->clearHeader('Message-Id'); + + return $this; + } + + /** + * Creates the Message-ID + * + * @return string + */ + public function createMessageId() { + + $time = time(); + + if ($this->_from !== null) { + $user = $this->_from; + } elseif (isset($_SERVER['REMOTE_ADDR'])) { + $user = $_SERVER['REMOTE_ADDR']; + } else { + $user = getmypid(); + } + + $rand = mt_rand(); + + if ($this->_recipients !== array()) { + $recipient = array_rand($this->_recipients); + } else { + $recipient = 'unknown'; + } + + if (isset($_SERVER["SERVER_NAME"])) { + $hostName = $_SERVER["SERVER_NAME"]; + } else { + $hostName = php_uname('n'); + } + + return sha1($time . $user . $rand . $recipient) . '@' . $hostName; + } + + /** + * Add a custom header to the message + * + * @param string $name + * @param string $value + * @param boolean $append + * @return Postman_Zend_Mail Provides fluent interface + * @throws Postman_Zend_Mail_Exception on attempts to create standard headers + */ + public function addHeader($name, $value, $append = false) + { + $prohibit = array('to', 'cc', 'bcc', 'from', 'subject', + 'reply-to', 'return-path', + 'date', 'message-id', + ); + if (in_array(strtolower($name), $prohibit)) { + /** + * @see Postman_Zend_Mail_Exception + */ +// require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('Cannot set standard header from addHeader()'); + } + + $value = $this->_filterOther($value); + $value = $this->_encodeHeader($value); + $this->_storeHeader($name, $value, $append); + + return $this; + } + + /** + * Return mail headers + * + * @return void + */ + public function getHeaders() + { + return $this->_headers; + } + + /** + * Sends this email using the given transport or a previously + * set DefaultTransport or the internal mail function if no + * default transport had been set. + * + * @param Postman_Zend_Mail_Transport_Abstract $transport + * @return Postman_Zend_Mail Provides fluent interface + */ + public function send($transport = null) + { + if ($transport === null) { + if (! self::$_defaultTransport instanceof Postman_Zend_Mail_Transport_Abstract) { + require_once 'Mail/Transport/Sendmail.php'; + + $transport = new Postman_Zend_Mail_Transport_Sendmail("-f{$this->_from}"); + } else { + $transport = self::$_defaultTransport; + } + } + + if ($this->_date === null) { + $this->setDate(); + } + + if(null === $this->_from && null !== self::getDefaultFrom()) { + $this->setFromToDefaultFrom(); + } + + if(null === $this->_replyTo && null !== self::getDefaultReplyTo()) { + $this->setReplyToFromDefault(); + } + + $transport->send($this); + + return $this; + } + + /** + * Filter of email data + * + * @param string $email + * @return string + */ + protected function _filterEmail($email) + { + $rule = array("\r" => '', + "\n" => '', + "\t" => '', + '"' => '', + ',' => '', + '<' => '', + '>' => '', + ); + + return strtr($email, $rule); + } + + /** + * Filter of name data + * + * @param string $name + * @return string + */ + protected function _filterName($name) + { + $rule = array("\r" => '', + "\n" => '', + "\t" => '', + '"' => "'", + '<' => '[', + '>' => ']', + ); + + return trim(strtr($name, $rule)); + } + + /** + * Filter of other data + * + * @param string $data + * @return string + */ + protected function _filterOther($data) + { + $rule = array("\r" => '', + "\n" => '', + "\t" => '', + ); + + return strtr($data, $rule); + } + + /** + * Formats e-mail address + * + * @param string $email + * @param string $name + * @return string + */ + protected function _formatAddress($email, $name) + { + if ($name === '' || $name === null || $name === $email) { + return $email; + } else { + $encodedName = $this->_encodeHeader($name); + if ($encodedName === $name && strcspn($name, '()<>[]:;@\\,.') != strlen($name)) { + $format = '"%s" <%s>'; + } else { + $format = '%s <%s>'; + } + return sprintf($format, $encodedName, $email); + } + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Exception.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Exception.php new file mode 100644 index 0000000..7c741f7 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Exception.php @@ -0,0 +1,37 @@ +_flags = array_merge($this->_flags, array_combine($params['flags'],$params['flags'])); + } + + parent::__construct($params); + } + + /** + * return toplines as found after headers + * + * @return string toplines + */ + public function getTopLines() + { + return $this->_topLines; + } + + /** + * check if flag is set + * + * @param mixed $flag a flag name, use constants defined in Postman_Zend_Mail_Storage + * @return bool true if set, otherwise false + */ + public function hasFlag($flag) + { + return isset($this->_flags[$flag]); + } + + /** + * get all set flags + * + * @return array array with flags, key and value are the same for easy lookup + */ + public function getFlags() + { + return $this->_flags; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Message/File.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Message/File.php new file mode 100644 index 0000000..0ff7ca5 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Message/File.php @@ -0,0 +1,96 @@ +_flags = array_combine($params['flags'], $params['flags']); + } + + parent::__construct($params); + } + + /** + * return toplines as found after headers + * + * @return string toplines + */ + public function getTopLines() + { + return $this->_topLines; + } + + /** + * check if flag is set + * + * @param mixed $flag a flag name, use constants defined in Postman_Zend_Mail_Storage + * @return bool true if set, otherwise false + */ + public function hasFlag($flag) + { + return isset($this->_flags[$flag]); + } + + /** + * get all set flags + * + * @return array array with flags, key and value are the same for easy lookup + */ + public function getFlags() + { + return $this->_flags; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Message/Interface.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Message/Interface.php new file mode 100644 index 0000000..2b08074 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Message/Interface.php @@ -0,0 +1,55 @@ +_fh = fopen($params['file'], 'r'); + } else { + $this->_fh = $params['file']; + } + if (!$this->_fh) { + /** + * @see Postman_Zend_Mail_Exception + */ + require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('could not open file'); + } + if (isset($params['startPos'])) { + fseek($this->_fh, $params['startPos']); + } + $header = ''; + $endPos = isset($params['endPos']) ? $params['endPos'] : null; + while (($endPos === null || ftell($this->_fh) < $endPos) && trim($line = fgets($this->_fh))) { + $header .= $line; + } + + Postman_Zend_Mime_Decode::splitMessage($header, $this->_headers, $null); + + $this->_contentPos[0] = ftell($this->_fh); + if ($endPos !== null) { + $this->_contentPos[1] = $endPos; + } else { + fseek($this->_fh, 0, SEEK_END); + $this->_contentPos[1] = ftell($this->_fh); + } + if (!$this->isMultipart()) { + return; + } + + $boundary = $this->getHeaderField('content-type', 'boundary'); + if (!$boundary) { + /** + * @see Postman_Zend_Mail_Exception + */ + require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('no boundary found in content type to split message'); + } + + $part = array(); + $pos = $this->_contentPos[0]; + fseek($this->_fh, $pos); + while (!feof($this->_fh) && ($endPos === null || $pos < $endPos)) { + $line = fgets($this->_fh); + if ($line === false) { + if (feof($this->_fh)) { + break; + } + /** + * @see Postman_Zend_Mail_Exception + */ + require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('error reading file'); + } + + $lastPos = $pos; + $pos = ftell($this->_fh); + $line = trim($line); + + if ($line == '--' . $boundary) { + if ($part) { + // not first part + $part[1] = $lastPos; + $this->_partPos[] = $part; + } + $part = array($pos); + } else if ($line == '--' . $boundary . '--') { + $part[1] = $lastPos; + $this->_partPos[] = $part; + break; + } + } + $this->_countParts = count($this->_partPos); + + } + + + /** + * Body of part + * + * If part is multipart the raw content of this part with all sub parts is returned + * + * @return string body + * @throws Postman_Zend_Mail_Exception + */ + public function getContent($stream = null) + { + fseek($this->_fh, $this->_contentPos[0]); + if ($stream !== null) { + return stream_copy_to_stream($this->_fh, $stream, $this->_contentPos[1] - $this->_contentPos[0]); + } + $length = $this->_contentPos[1] - $this->_contentPos[0]; + return $length < 1 ? '' : fread($this->_fh, $length); + } + + /** + * Return size of part + * + * Quite simple implemented currently (not decoding). Handle with care. + * + * @return int size + */ + public function getSize() { + return $this->_contentPos[1] - $this->_contentPos[0]; + } + + /** + * Get part of multipart message + * + * @param int $num number of part starting with 1 for first part + * @return Postman_Zend_Mail_Part wanted part + * @throws Postman_Zend_Mail_Exception + */ + public function getPart($num) + { + --$num; + if (!isset($this->_partPos[$num])) { + /** + * @see Postman_Zend_Mail_Exception + */ + require_once 'Zend/Mail/Exception.php'; + throw new Postman_Zend_Mail_Exception('part not found'); + } + + return new self(array('file' => $this->_fh, 'startPos' => $this->_partPos[$num][0], + 'endPos' => $this->_partPos[$num][1])); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Part/Interface.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Part/Interface.php new file mode 100644 index 0000000..ac9656f --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Part/Interface.php @@ -0,0 +1,136 @@ + value) + */ + public function getHeaders(); + + /** + * Get a header in specificed format + * + * Internally headers that occur more than once are saved as array, all other as string. If $format + * is set to string implode is used to concat the values (with Postman_Zend_Mime::LINEEND as delim). + * + * @param string $name name of header, matches case-insensitive, but camel-case is replaced with dashes + * @param string $format change type of return value to 'string' or 'array' + * @return string|array value of header in wanted or internal format + * @throws Postman_Zend_Mail_Exception + */ + public function getHeader($name, $format = null); + + /** + * Get a specific field from a header like content type or all fields as array + * + * If the header occurs more than once, only the value from the first header + * is returned. + * + * Throws a Postman_Zend_Mail_Exception if the requested header does not exist. If + * the specific header field does not exist, returns null. + * + * @param string $name name of header, like in getHeader() + * @param string $wantedPart the wanted part, default is first, if null an array with all parts is returned + * @param string $firstName key name for the first part + * @return string|array wanted part or all parts as array($firstName => firstPart, partname => value) + * @throws Postman_Zend_Exception, Postman_Zend_Mail_Exception + */ + public function getHeaderField($name, $wantedPart = 0, $firstName = 0); + + + /** + * Getter for mail headers - name is matched in lowercase + * + * This getter is short for Postman_Zend_Mail_Part::getHeader($name, 'string') + * + * @see Postman_Zend_Mail_Part::getHeader() + * + * @param string $name header name + * @return string value of header + * @throws Postman_Zend_Mail_Exception + */ + public function __get($name); + + /** + * magic method to get content of part + * + * @return string content + */ + public function __toString(); +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Abstract.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Abstract.php new file mode 100644 index 0000000..8cfdc20 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Abstract.php @@ -0,0 +1,453 @@ +_validHost = new Postman_Zend_Validate(); + $this->_validHost->addValidator(new Postman_Zend_Validate_Hostname(Postman_Zend_Validate_Hostname::ALLOW_ALL)); + + if (!$this->_validHost->isValid($host)) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception(join(', ', $this->_validHost->getMessages())); + } + + $this->_host = $host; + $this->_port = $port; + $this->_maximumLog = PostmanOptions::getInstance()->getTranscriptSize(); + } + + + /** + * Class destructor to cleanup open resources + * + * @return void + */ + public function __destruct() + { + $this->_disconnect(); + } + + /** + * Set the maximum log size + * + * @param integer $maximumLog Maximum log size + * @return void + */ + public function setMaximumLog($maximumLog) + { + $this->_maximumLog = (int) $maximumLog; + } + + + /** + * Get the maximum log size + * + * @return int the maximum log size + */ + public function getMaximumLog() + { + return $this->_maximumLog; + } + + + /** + * Create a connection to the remote host + * + * Concrete adapters for this class will implement their own unique connect scripts, using the _connect() method to create the socket resource. + */ + abstract public function connect(); + + + /** + * Retrieve the last client request + * + * @return string + */ + public function getRequest() + { + return $this->_request; + } + + + /** + * Retrieve the last server response + * + * @return array + */ + public function getResponse() + { + return $this->_response; + } + + + /** + * Retrieve the transaction log + * + * @return string + */ + public function getLog() + { + return implode('', $this->_log); + } + + + /** + * Reset the transaction log + * + * @return void + */ + public function resetLog() + { + $this->_log = array(); + } + + /** + * Add the transaction log + * + * @param string new transaction + * @return void + */ + protected function _addLog($value) + { + if ($this->_maximumLog >= 0 && count($this->_log) >= $this->_maximumLog) { + array_shift($this->_log); + } + + $this->_log[] = $value; + } + + /** + * Connect to the server using the supplied transport and target + * + * An example $remote string may be 'tcp://mail.example.com:25' or 'ssh://hostname.com:2222' + * + * @param string $remote Remote + * @throws Postman_Zend_Mail_Protocol_Exception + * @return boolean + */ + protected function _connect($remote) + { + $errorNum = 0; + $errorStr = ''; + + // open connection + $this->_socket = @stream_socket_client($remote, $errorNum, $errorStr, self::TIMEOUT_CONNECTION); + + if ($this->_socket === false) { + if ($errorNum == 0) { + $errorStr = 'Could not open socket'; + } + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception($errorStr); + } + + if (($result = $this->_setStreamTimeout(self::TIMEOUT_CONNECTION)) === false) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('Could not set stream timeout'); + } + + return $result; + } + + + /** + * Disconnect from remote host and free resource + * + * @return void + */ + protected function _disconnect() + { + if (is_resource($this->_socket)) { + fclose($this->_socket); + } + } + + + /** + * Send the given request followed by a LINEEND to the server. + * + * @param string $request + * @throws Postman_Zend_Mail_Protocol_Exception + * @return integer|boolean Number of bytes written to remote host + */ + protected function _send($request) + { + if (!is_resource($this->_socket)) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('No connection has been established to ' . $this->_host); + } + + $this->_request = $request; + + $result = fwrite($this->_socket, $request . self::EOL); + + // Save request to internal log + $this->_addLog($request . self::EOL); + + if ($result === false) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('Could not send request to ' . $this->_host); + } + + return $result; + } + + + /** + * Get a line from the stream. + * + * @var integer $timeout Per-request timeout value if applicable + * @throws Postman_Zend_Mail_Protocol_Exception + * @return string + */ + protected function _receive($timeout = null) + { + if (!is_resource($this->_socket)) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('No connection has been established to ' . $this->_host); + } + + // Adapters may wish to supply per-commend timeouts according to appropriate RFC + if ($timeout !== null) { + $this->_setStreamTimeout($timeout); + } + + // Retrieve response + $reponse = fgets($this->_socket, 1024); + + // Save request to internal log + $this->_addLog($reponse); + + // Check meta data to ensure connection is still valid + $info = stream_get_meta_data($this->_socket); + + if (!empty($info['timed_out'])) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception($this->_host . ' has timed out'); + } + + if ($reponse === false) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('Could not read from ' . $this->_host); + } + + return $reponse; + } + + + /** + * Parse server response for successful codes + * + * Read the response from the stream and check for expected return code. + * Throws a Postman_Zend_Mail_Protocol_Exception if an unexpected code is returned. + * + * @param string|array $code One or more codes that indicate a successful response + * @throws Postman_Zend_Mail_Protocol_Exception + * @return string Last line of response string + */ + protected function _expect($code, $timeout = null) + { + $userTimeout = PostmanOptions::getInstance()->getReadTimeout(); + if($timeout > $userTimeout) { + $timeout = $userTimeout; + } + $this->_response = array(); + $cmd = ''; + $more = ''; + $msg = ''; + $errMsg = ''; + + if (!is_array($code)) { + $code = array($code); + } + + do { + $this->_response[] = $result = $this->_receive($timeout); + list($cmd, $more, $msg) = preg_split('/([\s-]+)/', $result, 2, PREG_SPLIT_DELIM_CAPTURE); + + if ($errMsg !== '') { + $errMsg .= ' ' . $msg; + } elseif ($cmd === null || !in_array($cmd, $code)) { + $errMsg = $msg; + } + + } while (strpos($more, '-') === 0); // The '-' message prefix indicates an information string instead of a response string. + + if ($errMsg !== '') { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception($errMsg, $cmd); + } + + return $msg; + } + + /** + * Set stream timeout + * + * @param integer $timeout + * @return boolean + */ + protected function _setStreamTimeout($timeout) + { + // @jason: added @ to hide PHP warnings if the host has disabled stream_set_timeout + return @stream_set_timeout($this->_socket, $timeout); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Exception.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Exception.php new file mode 100644 index 0000000..7bd2901 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Exception.php @@ -0,0 +1,39 @@ +connect($host, $port, $ssl); + } + } + + /** + * Public destructor + */ + public function __destruct() + { + $this->logout(); + } + + /** + * Open connection to IMAP server + * + * @param string $host hostname or IP address of IMAP server + * @param int|null $port of IMAP server, default is 143 (993 for ssl) + * @param string|bool $ssl use 'SSL', 'TLS' or false + * @return string welcome message + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function connect($host, $port = null, $ssl = false) + { + if ($ssl == 'SSL') { + $host = 'ssl://' . $host; + } + + if ($port === null) { + $port = $ssl === 'SSL' ? 993 : 143; + } + + $errno = 0; + $errstr = ''; + $this->_socket = @fsockopen($host, $port, $errno, $errstr, self::TIMEOUT_CONNECTION); + if (!$this->_socket) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('cannot connect to host; error = ' . $errstr . + ' (errno = ' . $errno . ' )'); + } + + if (!$this->_assumedNextLine('* OK')) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('host doesn\'t allow connection'); + } + + if ($ssl === 'TLS') { + $result = $this->requestAndResponse('STARTTLS'); + $result = $result && stream_socket_enable_crypto($this->_socket, true, STREAM_CRYPTO_METHOD_TLS_CLIENT); + if (!$result) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('cannot enable TLS'); + } + } + } + + /** + * get the next line from socket with error checking, but nothing else + * + * @return string next line + * @throws Postman_Zend_Mail_Protocol_Exception + */ + protected function _nextLine() + { + $line = @fgets($this->_socket); + if ($line === false) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('cannot read - connection closed?'); + } + + return $line; + } + + /** + * get next line and assume it starts with $start. some requests give a simple + * feedback so we can quickly check if we can go on. + * + * @param string $start the first bytes we assume to be in the next line + * @return bool line starts with $start + * @throws Postman_Zend_Mail_Protocol_Exception + */ + protected function _assumedNextLine($start) + { + $line = $this->_nextLine(); + return strpos($line, $start) === 0; + } + + /** + * get next line and split the tag. that's the normal case for a response line + * + * @param string $tag tag of line is returned by reference + * @return string next line + * @throws Postman_Zend_Mail_Protocol_Exception + */ + protected function _nextTaggedLine(&$tag) + { + $line = $this->_nextLine(); + + // seperate tag from line + list($tag, $line) = explode(' ', $line, 2); + + return $line; + } + + /** + * split a given line in tokens. a token is literal of any form or a list + * + * @param string $line line to decode + * @return array tokens, literals are returned as string, lists as array + * @throws Postman_Zend_Mail_Protocol_Exception + */ + protected function _decodeLine($line) + { + $tokens = array(); + $stack = array(); + + /* + We start to decode the response here. The unterstood tokens are: + literal + "literal" or also "lit\\er\"al" + {bytes}literal + (literals*) + All tokens are returned in an array. Literals in braces (the last unterstood + token in the list) are returned as an array of tokens. I.e. the following response: + "foo" baz {3}bar ("f\\\"oo" bar) + would be returned as: + array('foo', 'baz', 'bar', array('f\\\"oo', 'bar')); + + // TODO: add handling of '[' and ']' to parser for easier handling of response text + */ + // replace any trailling including spaces with a single space + $line = rtrim($line) . ' '; + while (($pos = strpos($line, ' ')) !== false) { + $token = substr($line, 0, $pos); + while ($token[0] == '(') { + array_push($stack, $tokens); + $tokens = array(); + $token = substr($token, 1); + } + if ($token[0] == '"') { + if (preg_match('%^\(*"((.|\\\\|\\")*?)" *%', $line, $matches)) { + $tokens[] = $matches[1]; + $line = substr($line, strlen($matches[0])); + continue; + } + } + if ($token[0] == '{') { + $endPos = strpos($token, '}'); + $chars = substr($token, 1, $endPos - 1); + if (is_numeric($chars)) { + $token = ''; + while (strlen($token) < $chars) { + $token .= $this->_nextLine(); + } + $line = ''; + if (strlen($token) > $chars) { + $line = substr($token, $chars); + $token = substr($token, 0, $chars); + } else { + $line .= $this->_nextLine(); + } + $tokens[] = $token; + $line = trim($line) . ' '; + continue; + } + } + if ($stack && $token[strlen($token) - 1] == ')') { + // closing braces are not seperated by spaces, so we need to count them + $braces = strlen($token); + $token = rtrim($token, ')'); + // only count braces if more than one + $braces -= strlen($token) + 1; + // only add if token had more than just closing braces + if (rtrim($token) != '') { + $tokens[] = rtrim($token); + } + $token = $tokens; + $tokens = array_pop($stack); + // special handline if more than one closing brace + while ($braces-- > 0) { + $tokens[] = $token; + $token = $tokens; + $tokens = array_pop($stack); + } + } + $tokens[] = $token; + $line = substr($line, $pos + 1); + } + + // maybe the server forgot to send some closing braces + while ($stack) { + $child = $tokens; + $tokens = array_pop($stack); + $tokens[] = $child; + } + + return $tokens; + } + + /** + * read a response "line" (could also be more than one real line if response has {..}) + * and do a simple decode + * + * @param array|string $tokens decoded tokens are returned by reference, if $dontParse + * is true the unparsed line is returned here + * @param string $wantedTag check for this tag for response code. Default '*' is + * continuation tag. + * @param bool $dontParse if true only the unparsed line is returned $tokens + * @return bool if returned tag matches wanted tag + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function readLine(&$tokens = array(), $wantedTag = '*', $dontParse = false) + { + $line = $this->_nextTaggedLine($tag); + if (!$dontParse) { + $tokens = $this->_decodeLine($line); + } else { + $tokens = $line; + } + + // if tag is wanted tag we might be at the end of a multiline response + return $tag == $wantedTag; + } + + /** + * read all lines of response until given tag is found (last line of response) + * + * @param string $tag the tag of your request + * @param string|array $filter you can filter the response so you get only the + * given response lines + * @param bool $dontParse if true every line is returned unparsed instead of + * the decoded tokens + * @return null|bool|array tokens if success, false if error, null if bad request + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function readResponse($tag, $dontParse = false) + { + $lines = array(); + while (!$this->readLine($tokens, $tag, $dontParse)) { + $lines[] = $tokens; + } + + if ($dontParse) { + // last to chars are still needed for response code + $tokens = array(substr($tokens, 0, 2)); + } + // last line has response code + if ($tokens[0] == 'OK') { + return $lines ? $lines : true; + } else if ($tokens[0] == 'NO'){ + return false; + } + return null; + } + + /** + * send a request + * + * @param string $command your request command + * @param array $tokens additional parameters to command, use escapeString() to prepare + * @param string $tag provide a tag otherwise an autogenerated is returned + * @return null + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function sendRequest($command, $tokens = array(), &$tag = null) + { + if (!$tag) { + ++$this->_tagCount; + $tag = 'TAG' . $this->_tagCount; + } + + $line = $tag . ' ' . $command; + + foreach ($tokens as $token) { + if (is_array($token)) { + if (@fputs($this->_socket, $line . ' ' . $token[0] . "\r\n") === false) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('cannot write - connection closed?'); + } + if (!$this->_assumedNextLine('+ ')) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('cannot send literal string'); + } + $line = $token[1]; + } else { + $line .= ' ' . $token; + } + } + + if (@fputs($this->_socket, $line . "\r\n") === false) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('cannot write - connection closed?'); + } + } + + /** + * send a request and get response at once + * + * @param string $command command as in sendRequest() + * @param array $tokens parameters as in sendRequest() + * @param bool $dontParse if true unparsed lines are returned instead of tokens + * @return mixed response as in readResponse() + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function requestAndResponse($command, $tokens = array(), $dontParse = false) + { + $this->sendRequest($command, $tokens, $tag); + $response = $this->readResponse($tag, $dontParse); + + return $response; + } + + /** + * escape one or more literals i.e. for sendRequest + * + * @param string|array $string the literal/-s + * @return string|array escape literals, literals with newline ar returned + * as array('{size}', 'string'); + */ + public function escapeString($string) + { + if (func_num_args() < 2) { + if (strpos($string, "\n") !== false) { + return array('{' . strlen($string) . '}', $string); + } else { + return '"' . str_replace(array('\\', '"'), array('\\\\', '\\"'), $string) . '"'; + } + } + $result = array(); + foreach (func_get_args() as $string) { + $result[] = $this->escapeString($string); + } + return $result; + } + + /** + * escape a list with literals or lists + * + * @param array $list list with literals or lists as PHP array + * @return string escaped list for imap + */ + public function escapeList($list) + { + $result = array(); + foreach ($list as $k => $v) { + if (!is_array($v)) { +// $result[] = $this->escapeString($v); + $result[] = $v; + continue; + } + $result[] = $this->escapeList($v); + } + return '(' . implode(' ', $result) . ')'; + } + + /** + * Login to IMAP server. + * + * @param string $user username + * @param string $password password + * @return bool success + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function login($user, $password) + { + return $this->requestAndResponse('LOGIN', $this->escapeString($user, $password), true); + } + + /** + * logout of imap server + * + * @return bool success + */ + public function logout() + { + $result = false; + if ($this->_socket) { + try { + $result = $this->requestAndResponse('LOGOUT', array(), true); + } catch (Postman_Zend_Mail_Protocol_Exception $e) { + // ignoring exception + } + fclose($this->_socket); + $this->_socket = null; + } + return $result; + } + + + /** + * Get capabilities from IMAP server + * + * @return array list of capabilities + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function capability() + { + $response = $this->requestAndResponse('CAPABILITY'); + + if (!$response) { + return $response; + } + + $capabilities = array(); + foreach ($response as $line) { + $capabilities = array_merge($capabilities, $line); + } + return $capabilities; + } + + /** + * Examine and select have the same response. The common code for both + * is in this method + * + * @param string $command can be 'EXAMINE' or 'SELECT' and this is used as command + * @param string $box which folder to change to or examine + * @return bool|array false if error, array with returned information + * otherwise (flags, exists, recent, uidvalidity) + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function examineOrSelect($command = 'EXAMINE', $box = 'INBOX') + { + $this->sendRequest($command, array($this->escapeString($box)), $tag); + + $result = array(); + while (!$this->readLine($tokens, $tag)) { + if ($tokens[0] == 'FLAGS') { + array_shift($tokens); + $result['flags'] = $tokens; + continue; + } + switch ($tokens[1]) { + case 'EXISTS': + case 'RECENT': + $result[strtolower($tokens[1])] = $tokens[0]; + break; + case '[UIDVALIDITY': + $result['uidvalidity'] = (int)$tokens[2]; + break; + default: + // ignore + } + } + + if ($tokens[0] != 'OK') { + return false; + } + return $result; + } + + /** + * change folder + * + * @param string $box change to this folder + * @return bool|array see examineOrselect() + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function select($box = 'INBOX') + { + return $this->examineOrSelect('SELECT', $box); + } + + /** + * examine folder + * + * @param string $box examine this folder + * @return bool|array see examineOrselect() + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function examine($box = 'INBOX') + { + return $this->examineOrSelect('EXAMINE', $box); + } + + /** + * fetch one or more items of one or more messages + * + * @param string|array $items items to fetch from message(s) as string (if only one item) + * or array of strings + * @param int $from message for items or start message if $to !== null + * @param int|null $to if null only one message ($from) is fetched, else it's the + * last message, INF means last message avaible + * @return string|array if only one item of one message is fetched it's returned as string + * if items of one message are fetched it's returned as (name => value) + * if one items of messages are fetched it's returned as (msgno => value) + * if items of messages are fetchted it's returned as (msgno => (name => value)) + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function fetch($items, $from, $to = null) + { + if (is_array($from)) { + $set = implode(',', $from); + } else if ($to === null) { + $set = (int)$from; + } else if ($to === INF) { + $set = (int)$from . ':*'; + } else { + $set = (int)$from . ':' . (int)$to; + } + + $items = (array)$items; + $itemList = $this->escapeList($items); + + $this->sendRequest('FETCH', array($set, $itemList), $tag); + + $result = array(); + while (!$this->readLine($tokens, $tag)) { + // ignore other responses + if ($tokens[1] != 'FETCH') { + continue; + } + // ignore other messages + if ($to === null && !is_array($from) && $tokens[0] != $from) { + continue; + } + // if we only want one item we return that one directly + if (count($items) == 1) { + if ($tokens[2][0] == $items[0]) { + $data = $tokens[2][1]; + } else { + // maybe the server send an other field we didn't wanted + $count = count($tokens[2]); + // we start with 2, because 0 was already checked + for ($i = 2; $i < $count; $i += 2) { + if ($tokens[2][$i] != $items[0]) { + continue; + } + $data = $tokens[2][$i + 1]; + break; + } + } + } else { + $data = array(); + while (key($tokens[2]) !== null) { + $data[current($tokens[2])] = next($tokens[2]); + next($tokens[2]); + } + } + // if we want only one message we can ignore everything else and just return + if ($to === null && !is_array($from) && $tokens[0] == $from) { + // we still need to read all lines + while (!$this->readLine($tokens, $tag)); + return $data; + } + $result[$tokens[0]] = $data; + } + + if ($to === null && !is_array($from)) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('the single id was not found in response'); + } + + return $result; + } + + /** + * get mailbox list + * + * this method can't be named after the IMAP command 'LIST', as list is a reserved keyword + * + * @param string $reference mailbox reference for list + * @param string $mailbox mailbox name match with wildcards + * @return array mailboxes that matched $mailbox as array(globalName => array('delim' => .., 'flags' => ..)) + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function listMailbox($reference = '', $mailbox = '*') + { + $result = array(); + $list = $this->requestAndResponse('LIST', $this->escapeString($reference, $mailbox)); + if (!$list || $list === true) { + return $result; + } + + foreach ($list as $item) { + if (count($item) != 4 || $item[0] != 'LIST') { + continue; + } + $result[$item[3]] = array('delim' => $item[2], 'flags' => $item[1]); + } + + return $result; + } + + /** + * set flags + * + * @param array $flags flags to set, add or remove - see $mode + * @param int $from message for items or start message if $to !== null + * @param int|null $to if null only one message ($from) is fetched, else it's the + * last message, INF means last message avaible + * @param string|null $mode '+' to add flags, '-' to remove flags, everything else sets the flags as given + * @param bool $silent if false the return values are the new flags for the wanted messages + * @return bool|array new flags if $silent is false, else true or false depending on success + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function store(array $flags, $from, $to = null, $mode = null, $silent = true) + { + $item = 'FLAGS'; + if ($mode == '+' || $mode == '-') { + $item = $mode . $item; + } + if ($silent) { + $item .= '.SILENT'; + } + + $flags = $this->escapeList($flags); + $set = (int)$from; + if ($to != null) { + $set .= ':' . ($to == INF ? '*' : (int)$to); + } + + $result = $this->requestAndResponse('STORE', array($set, $item, $flags), $silent); + + if ($silent) { + return $result ? true : false; + } + + $tokens = $result; + $result = array(); + foreach ($tokens as $token) { + if ($token[1] != 'FETCH' || $token[2][0] != 'FLAGS') { + continue; + } + $result[$token[0]] = $token[2][1]; + } + + return $result; + } + + /** + * append a new message to given folder + * + * @param string $folder name of target folder + * @param string $message full message content + * @param array $flags flags for new message + * @param string $date date for new message + * @return bool success + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function append($folder, $message, $flags = null, $date = null) + { + $tokens = array(); + $tokens[] = $this->escapeString($folder); + if ($flags !== null) { + $tokens[] = $this->escapeList($flags); + } + if ($date !== null) { + $tokens[] = $this->escapeString($date); + } + $tokens[] = $this->escapeString($message); + + return $this->requestAndResponse('APPEND', $tokens, true); + } + + /** + * copy message set from current folder to other folder + * + * @param string $folder destination folder + * @param int|null $to if null only one message ($from) is fetched, else it's the + * last message, INF means last message avaible + * @return bool success + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function copy($folder, $from, $to = null) + { + $set = (int)$from; + if ($to != null) { + $set .= ':' . ($to == INF ? '*' : (int)$to); + } + + return $this->requestAndResponse('COPY', array($set, $this->escapeString($folder)), true); + } + + /** + * create a new folder (and parent folders if needed) + * + * @param string $folder folder name + * @return bool success + */ + public function create($folder) + { + return $this->requestAndResponse('CREATE', array($this->escapeString($folder)), true); + } + + /** + * rename an existing folder + * + * @param string $old old name + * @param string $new new name + * @return bool success + */ + public function rename($old, $new) + { + return $this->requestAndResponse('RENAME', $this->escapeString($old, $new), true); + } + + /** + * remove a folder + * + * @param string $folder folder name + * @return bool success + */ + public function delete($folder) + { + return $this->requestAndResponse('DELETE', array($this->escapeString($folder)), true); + } + + /** + * permanently remove messages + * + * @return bool success + */ + public function expunge() + { + // TODO: parse response? + return $this->requestAndResponse('EXPUNGE'); + } + + /** + * send noop + * + * @return bool success + */ + public function noop() + { + // TODO: parse response + return $this->requestAndResponse('NOOP'); + } + + /** + * do a search request + * + * This method is currently marked as internal as the API might change and is not + * safe if you don't take precautions. + * + * @internal + * @return array message ids + */ + public function search(array $params) + { + $response = $this->requestAndResponse('SEARCH', $params); + if (!$response) { + return $response; + } + + foreach ($response as $ids) { + if ($ids[0] == 'SEARCH') { + array_shift($ids); + return $ids; + } + } + return array(); + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Pop3.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Pop3.php new file mode 100644 index 0000000..bbd826e --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Pop3.php @@ -0,0 +1,472 @@ +connect($host, $port, $ssl); + } + } + + + /** + * Public destructor + */ + public function __destruct() + { + $this->logout(); + } + + + /** + * Open connection to POP3 server + * + * @param string $host hostname or IP address of POP3 server + * @param int|null $port of POP3 server, default is 110 (995 for ssl) + * @param string|bool $ssl use 'SSL', 'TLS' or false + * @return string welcome message + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function connect($host, $port = null, $ssl = false) + { + if ($ssl == 'SSL') { + $host = 'ssl://' . $host; + } + + if ($port === null) { + $port = $ssl == 'SSL' ? 995 : 110; + } + + $errno = 0; + $errstr = ''; + $this->_socket = @fsockopen($host, $port, $errno, $errstr, self::TIMEOUT_CONNECTION); + if (!$this->_socket) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('cannot connect to host; error = ' . $errstr . + ' (errno = ' . $errno . ' )'); + } + + $welcome = $this->readResponse(); + + strtok($welcome, '<'); + $this->_timestamp = strtok('>'); + if (!strpos($this->_timestamp, '@')) { + $this->_timestamp = null; + } else { + $this->_timestamp = '<' . $this->_timestamp . '>'; + } + + if ($ssl === 'TLS') { + $this->request('STLS'); + $result = stream_socket_enable_crypto($this->_socket, true, STREAM_CRYPTO_METHOD_TLS_CLIENT); + if (!$result) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('cannot enable TLS'); + } + } + + return $welcome; + } + + + /** + * Send a request + * + * @param string $request your request without newline + * @return null + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function sendRequest($request) + { + $result = @fputs($this->_socket, $request . "\r\n"); + if (!$result) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('send failed - connection closed?'); + } + } + + + /** + * read a response + * + * @param boolean $multiline response has multiple lines and should be read until "." + * @return string response + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function readResponse($multiline = false) + { + $result = @fgets($this->_socket); + if (!is_string($result)) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('read failed - connection closed?'); + } + + $result = trim($result); + if (strpos($result, ' ')) { + list($status, $message) = explode(' ', $result, 2); + } else { + $status = $result; + $message = ''; + } + + if ($status != '+OK') { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('last request failed'); + } + + if ($multiline) { + $message = ''; + $line = fgets($this->_socket); + while ($line && rtrim($line, "\r\n") != '.') { + if ($line[0] == '.') { + $line = substr($line, 1); + } + $message .= $line; + $line = fgets($this->_socket); + }; + } + + return $message; + } + + + /** + * Send request and get resposne + * + * @see sendRequest(), readResponse() + * + * @param string $request request + * @param bool $multiline multiline response? + * @return string result from readResponse() + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function request($request, $multiline = false) + { + $this->sendRequest($request); + return $this->readResponse($multiline); + } + + + /** + * End communication with POP3 server (also closes socket) + * + * @return null + */ + public function logout() + { + if (!$this->_socket) { + return; + } + + try { + $this->request('QUIT'); + } catch (Postman_Zend_Mail_Protocol_Exception $e) { + // ignore error - we're closing the socket anyway + } + + fclose($this->_socket); + $this->_socket = null; + } + + + /** + * Get capabilities from POP3 server + * + * @return array list of capabilities + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function capa() + { + $result = $this->request('CAPA', true); + return explode("\n", $result); + } + + + /** + * Login to POP3 server. Can use APOP + * + * @param string $user username + * @param string $password password + * @param bool $try_apop should APOP be tried? + * @return void + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function login($user, $password, $tryApop = true) + { + if ($tryApop && $this->_timestamp) { + try { + $this->request("APOP $user " . md5($this->_timestamp . $password)); + return; + } catch (Postman_Zend_Mail_Protocol_Exception $e) { + // ignore + } + } + + $result = $this->request("USER $user"); + $result = $this->request("PASS $password"); + } + + + /** + * Make STAT call for message count and size sum + * + * @param int $messages out parameter with count of messages + * @param int $octets out parameter with size in octects of messages + * @return void + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function status(&$messages, &$octets) + { + $messages = 0; + $octets = 0; + $result = $this->request('STAT'); + + list($messages, $octets) = explode(' ', $result); + } + + + /** + * Make LIST call for size of message(s) + * + * @param int|null $msgno number of message, null for all + * @return int|array size of given message or list with array(num => size) + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function getList($msgno = null) + { + if ($msgno !== null) { + $result = $this->request("LIST $msgno"); + + list(, $result) = explode(' ', $result); + return (int)$result; + } + + $result = $this->request('LIST', true); + $messages = array(); + $line = strtok($result, "\n"); + while ($line) { + list($no, $size) = explode(' ', trim($line)); + $messages[(int)$no] = (int)$size; + $line = strtok("\n"); + } + + return $messages; + } + + + /** + * Make UIDL call for getting a uniqueid + * + * @param int|null $msgno number of message, null for all + * @return string|array uniqueid of message or list with array(num => uniqueid) + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function uniqueid($msgno = null) + { + if ($msgno !== null) { + $result = $this->request("UIDL $msgno"); + + list(, $result) = explode(' ', $result); + return $result; + } + + $result = $this->request('UIDL', true); + + $result = explode("\n", $result); + $messages = array(); + foreach ($result as $line) { + if (!$line) { + continue; + } + list($no, $id) = explode(' ', trim($line), 2); + $messages[(int)$no] = $id; + } + + return $messages; + + } + + + /** + * Make TOP call for getting headers and maybe some body lines + * This method also sets hasTop - before it it's not known if top is supported + * + * The fallback makes normale RETR call, which retrieves the whole message. Additional + * lines are not removed. + * + * @param int $msgno number of message + * @param int $lines number of wanted body lines (empty line is inserted after header lines) + * @param bool $fallback fallback with full retrieve if top is not supported + * @return string message headers with wanted body lines + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function top($msgno, $lines = 0, $fallback = false) + { + if ($this->hasTop === false) { + if ($fallback) { + return $this->retrieve($msgno); + } else { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ + require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('top not supported and no fallback wanted'); + } + } + $this->hasTop = true; + + $lines = (!$lines || $lines < 1) ? 0 : (int)$lines; + + try { + $result = $this->request("TOP $msgno $lines", true); + } catch (Postman_Zend_Mail_Protocol_Exception $e) { + $this->hasTop = false; + if ($fallback) { + $result = $this->retrieve($msgno); + } else { + throw $e; + } + } + + return $result; + } + + + /** + * Make a RETR call for retrieving a full message with headers and body + * + * @deprecated since 1.1.0; this method has a typo - please use retrieve() + * @param int $msgno message number + * @return string message + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function retrive($msgno) + { + return $this->retrieve($msgno); + } + + + /** + * Make a RETR call for retrieving a full message with headers and body + * + * @param int $msgno message number + * @return string message + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function retrieve($msgno) + { + $result = $this->request("RETR $msgno", true); + return $result; + } + + /** + * Make a NOOP call, maybe needed for keeping the server happy + * + * @return null + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function noop() + { + $this->request('NOOP'); + } + + + /** + * Make a DELE count to remove a message + * + * @return null + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function delete($msgno) + { + $this->request("DELE $msgno"); + } + + + /** + * Make RSET call, which rollbacks delete requests + * + * @return null + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function undelete() + { + $this->request('RSET'); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp.php new file mode 100644 index 0000000..6f3c978 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp.php @@ -0,0 +1,467 @@ +_secure = 'tls'; + break; + + case 'ssl': + $this->_transport = 'ssl'; + $this->_secure = 'ssl'; + if ($port == null) { + $port = 465; + } + break; + + default: + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception($config['ssl'] . ' is unsupported SSL type'); + break; + } + } + + // If no port has been specified then check the master PHP ini file. Defaults to 25 if the ini setting is null. + if ($port == null) { + if (($port = ini_get('smtp_port')) == '') { + $port = 25; + } + } + + parent::__construct($host, $port); + } + + + /** + * Connect to the server with the parameters given in the constructor. + * + * @return boolean + */ + public function connect() + { + return $this->_connect($this->_transport . '://' . $this->_host . ':'. $this->_port); + } + + + /** + * Initiate HELO/EHLO sequence and set flag to indicate valid smtp session + * + * @param string $host The client hostname or IP address (default: 127.0.0.1) + * @throws Postman_Zend_Mail_Protocol_Exception + * @return void + */ + public function helo($host = '127.0.0.1') + { + // Respect RFC 2821 and disallow HELO attempts if session is already initiated. + if ($this->_sess === true) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('Cannot issue HELO to existing session'); + } + + // Validate client hostname + if (!$this->_validHost->isValid($host)) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception(join(', ', $this->_validHost->getMessages())); + } + + // Initiate helo sequence + $this->_expect(220, 300); // Timeout set for 5 minutes as per RFC 2821 4.5.3.2 + $this->_ehlo($host); + + // If a TLS session is required, commence negotiation + if ($this->_secure == 'tls') { + $this->_send('STARTTLS'); + $this->_expect(220, 180); + + stream_context_set_option($this->_socket, 'ssl', 'verify_peer', false); + stream_context_set_option($this->_socket, 'ssl', 'verify_peer_name', false); + stream_context_set_option($this->_socket, 'ssl', 'allow_self_signed', true); + + $crypto_method = STREAM_CRYPTO_METHOD_TLS_CLIENT; + + $curl = curl_version(); + preg_match('/.*\/(\d*\.\d*\.\d*)[a-z]?/', $curl['ssl_version'], $ver_match ); + $tlsv1_2_installed = ! empty( $ver_match[1] ) ? $ver_match[1] >= '1.0.1' : true; + + if ( $this->_host == 'smtp.office365.com' && ! $tlsv1_2_installed ) { + + $error = sprintf( 'Office365 SMTP servie require TLS v1.2 and OpenSSL version 1.0.1 or greater, your current OpenSSL version is: %s. +You need to contact your web hosting support for help.', $ver_match[1] ); + + throw new Postman_Zend_Mail_Protocol_Exception( $error ); + } + + if ( defined('STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT') ) { + $crypto_method |= STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT; + $crypto_method |= STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT; + } + + if (!stream_socket_enable_crypto($this->_socket, true, $crypto_method)) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('Unable to connect via TLS'); + } + $this->_ehlo($host); + } + + $this->_startSession(); + $this->auth(); + } + + + /** + * Send EHLO or HELO depending on capabilities of smtp host + * + * @param string $host The client hostname or IP address (default: 127.0.0.1) + * @throws Postman_Zend_Mail_Protocol_Exception + * @return void + */ + protected function _ehlo($host) + { + // Support for older, less-compliant remote servers. Tries multiple attempts of EHLO or HELO. + try { + $this->_send('EHLO ' . $host); + $this->_expect(250, 300); // Timeout set for 5 minutes as per RFC 2821 4.5.3.2 + } catch (Postman_Zend_Mail_Protocol_Exception $e) { + $this->_send('HELO ' . $host); + $this->_expect(250, 300); // Timeout set for 5 minutes as per RFC 2821 4.5.3.2 + } catch (Postman_Zend_Mail_Protocol_Exception $e) { + throw $e; + } + } + + + /** + * Issues MAIL command + * + * @param string $from Sender mailbox + * @throws Postman_Zend_Mail_Protocol_Exception + * @return void + */ + public function mail($from) + { + if ($this->_sess !== true) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('A valid session has not been started'); + } + + $this->_send('MAIL FROM:<' . $from . '>'); + $this->_expect(250, 300); // Timeout set for 5 minutes as per RFC 2821 4.5.3.2 + + // Set mail to true, clear recipients and any existing data flags as per 4.1.1.2 of RFC 2821 + $this->_mail = true; + $this->_rcpt = false; + $this->_data = false; + } + + + /** + * Issues RCPT command + * + * @param string $to Receiver(s) mailbox + * @throws Postman_Zend_Mail_Protocol_Exception + * @return void + */ + public function rcpt($to) + { + if ($this->_mail !== true) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('No sender reverse path has been supplied'); + } + + // Set rcpt to true, as per 4.1.1.3 of RFC 2821 + $this->_send('RCPT TO:<' . $to . '>'); + $this->_expect(array(250, 251), 300); // Timeout set for 5 minutes as per RFC 2821 4.5.3.2 + $this->_rcpt = true; + } + + + /** + * Issues DATA command + * + * @param string $data + * @throws Postman_Zend_Mail_Protocol_Exception + * @return void + */ + public function data($data) + { + // Ensure recipients have been set + if ($this->_rcpt !== true) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('No recipient forward path has been supplied'); + } + + $this->_send('DATA'); + $this->_expect(354, 120); // Timeout set for 2 minutes as per RFC 2821 4.5.3.2 + + foreach (explode(Postman_Zend_Mime::LINEEND, $data) as $line) { + if (strpos($line, '.') === 0) { + // Escape lines prefixed with a '.' + $line = '.' . $line; + } + $this->_send($line); + } + + $this->_send('.'); + $this->_expect(250, 600); // Timeout set for 10 minutes as per RFC 2821 4.5.3.2 + $this->_data = true; + } + + + /** + * Issues the RSET command and validates answer + * + * Can be used to restore a clean smtp communication state when a transaction has been cancelled or commencing a new transaction. + * + * @return void + */ + public function rset() + { + $this->_send('RSET'); + // MS ESMTP doesn't follow RFC, see [ZF-1377] + $this->_expect(array(250, 220)); + + $this->_mail = false; + $this->_rcpt = false; + $this->_data = false; + } + + + /** + * Issues the NOOP command and validates answer + * + * Not used by Postman_Zend_Mail, could be used to keep a connection alive or check if it is still open. + * + * @return void + */ + public function noop() + { + $this->_send('NOOP'); + $this->_expect(250, 300); // Timeout set for 5 minutes as per RFC 2821 4.5.3.2 + } + + + /** + * Issues the VRFY command and validates answer + * + * Not used by Postman_Zend_Mail. + * + * @param string $user User Name or eMail to verify + * @return void + */ + public function vrfy($user) + { + $this->_send('VRFY ' . $user); + $this->_expect(array(250, 251, 252), 300); // Timeout set for 5 minutes as per RFC 2821 4.5.3.2 + } + + + /** + * Issues the QUIT command and clears the current session + * + * @return void + */ + public function quit() + { + if ($this->_sess) { + $this->_send('QUIT'); + $this->_expect(221, 300); // Timeout set for 5 minutes as per RFC 2821 4.5.3.2 + $this->_stopSession(); + } + } + + + /** + * Default authentication method + * + * This default method is implemented by AUTH adapters to properly authenticate to a remote host. + * + * @throws Postman_Zend_Mail_Protocol_Exception + * @return void + */ + public function auth() + { + if ($this->_auth === true) { + /** + * @see Postman_Zend_Mail_Protocol_Exception + */ +// require_once 'Zend/Mail/Protocol/Exception.php'; + throw new Postman_Zend_Mail_Protocol_Exception('Already authenticated for this session'); + } + } + + + /** + * Closes connection + * + * @return void + */ + public function disconnect() + { + $this->_disconnect(); + } + + + /** + * Start mail session + * + * @return void + */ + protected function _startSession() + { + $this->_sess = true; + } + + + /** + * Stop mail session + * + * @return void + */ + protected function _stopSession() + { + $this->_sess = false; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Crammd5.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Crammd5.php new file mode 100644 index 0000000..7ca9c1d --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Crammd5.php @@ -0,0 +1,108 @@ +_username = $config['username']; + } + if (isset($config['password'])) { + $this->_password = $config['password']; + } + } + + parent::__construct($host, $port, $config); + } + + + /** + * @todo Perform CRAM-MD5 authentication with supplied credentials + * + * @return void + */ + public function auth() + { + // Ensure AUTH has not already been initiated. + parent::auth(); + + $this->_send('AUTH CRAM-MD5'); + $challenge = $this->_expect(334); + $challenge = base64_decode($challenge); + $digest = $this->_hmacMd5($this->_password, $challenge); + $this->_send(base64_encode($this->_username . ' ' . $digest)); + $this->_expect(235); + $this->_auth = true; + } + + + /** + * Prepare CRAM-MD5 response to server's ticket + * + * @param string $key Challenge key (usually password) + * @param string $data Challenge data + * @param string $block Length of blocks + * @return string + */ + protected function _hmacMd5($key, $data, $block = 64) + { + if (strlen($key) > 64) { + $key = pack('H32', md5($key)); + } elseif (strlen($key) < 64) { + $key = str_pad($key, $block, "\0"); + } + + $k_ipad = substr($key, 0, 64) ^ str_repeat(chr(0x36), 64); + $k_opad = substr($key, 0, 64) ^ str_repeat(chr(0x5C), 64); + + $inner = pack('H32', md5($k_ipad . $data)); + $digest = md5($k_opad . $inner); + + return $digest; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Login.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Login.php new file mode 100644 index 0000000..714b6fb --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Login.php @@ -0,0 +1,98 @@ +_username = $config['username']; + } + if (isset($config['password'])) { + $this->_password = $config['password']; + } + } + + parent::__construct($host, $port, $config); + } + + + /** + * Perform LOGIN authentication with supplied credentials + * + * @return void + */ + public function auth() + { + // Ensure AUTH has not already been initiated. + parent::auth(); + + $this->_send('AUTH LOGIN'); + $this->_expect(334); + $this->_send(base64_encode($this->_username)); + $this->_expect(334); + $this->_send(base64_encode($this->_password)); + $this->_expect(235); + $this->_auth = true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Oauth2.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Oauth2.php new file mode 100644 index 0000000..7b181ad --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Oauth2.php @@ -0,0 +1,78 @@ +_xoauth2_request = $config['xoauth2_request']; + } + } + + parent::__construct($host, $port, $config); + } + + /** + * Perform LOGIN authentication with supplied credentials + * + * @return void + */ + public function auth() + { + // Ensure AUTH has not already been initiated. + parent::auth(); + + $this->_send('AUTH XOAUTH2 '.$this->_xoauth2_request); + $this->_expect(235); + $this->_auth = true; + } +} \ No newline at end of file diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Plain.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Plain.php new file mode 100644 index 0000000..73df793 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Protocol/Smtp/Auth/Plain.php @@ -0,0 +1,96 @@ +_username = $config['username']; + } + if (isset($config['password'])) { + $this->_password = $config['password']; + } + } + + parent::__construct($host, $port, $config); + } + + + /** + * Perform PLAIN authentication with supplied credentials + * + * @return void + */ + public function auth() + { + // Ensure AUTH has not already been initiated. + parent::auth(); + + $this->_send('AUTH PLAIN'); + $this->_expect(334); + $this->_send(base64_encode("\0" . $this->_username . "\0" . $this->_password)); + $this->_expect(235); + $this->_auth = true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage.php new file mode 100644 index 0000000..adecc53 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage.php @@ -0,0 +1,39 @@ + true, + 'delete' => false, + 'create' => false, + 'top' => false, + 'fetchPart' => true, + 'flags' => false); + + /** + * current iteration position + * @var int + */ + protected $_iterationPos = 0; + + /** + * maximum iteration position (= message count) + * @var null|int + */ + protected $_iterationMax = null; + + /** + * used message class, change it in an extened class to extend the returned message class + * @var string + */ + protected $_messageClass = 'Postman_Zend_Mail_Message'; + + /** + * Getter for has-properties. The standard has properties + * are: hasFolder, hasUniqueid, hasDelete, hasCreate, hasTop + * + * The valid values for the has-properties are: + * - true if a feature is supported + * - false if a feature is not supported + * - null is it's not yet known or it can't be know if a feature is supported + * + * @param string $var property name + * @return bool supported or not + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function __get($var) + { + if (strpos($var, 'has') === 0) { + $var = strtolower(substr($var, 3)); + return isset($this->_has[$var]) ? $this->_has[$var] : null; + } + + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception($var . ' not found'); + } + + + /** + * Get a full list of features supported by the specific mail lib and the server + * + * @return array list of features as array(featurename => true|false[|null]) + */ + public function getCapabilities() + { + return $this->_has; + } + + + /** + * Count messages messages in current box/folder + * + * @return int number of messages + * @throws Postman_Zend_Mail_Storage_Exception + */ + abstract public function countMessages(); + + + /** + * Get a list of messages with number and size + * + * @param int $id number of message + * @return int|array size of given message of list with all messages as array(num => size) + */ + abstract public function getSize($id = 0); + + + /** + * Get a message with headers and body + * + * @param int $id number of message + * @return Postman_Zend_Mail_Message + */ + abstract public function getMessage($id); + + + /** + * Get raw header of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage header + * @param int $topLines include this many lines with header (after an empty line) + * @return string raw header + */ + abstract public function getRawHeader($id, $part = null, $topLines = 0); + + /** + * Get raw content of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage content + * @return string raw content + */ + abstract public function getRawContent($id, $part = null); + + /** + * Create instance with parameters + * + * @param array $params mail reader specific parameters + * @throws Postman_Zend_Mail_Storage_Exception + */ + abstract public function __construct($params); + + + /** + * Destructor calls close() and therefore closes the resource. + */ + public function __destruct() + { + $this->close(); + } + + + /** + * Close resource for mail lib. If you need to control, when the resource + * is closed. Otherwise the destructor would call this. + * + * @return null + */ + abstract public function close(); + + + /** + * Keep the resource alive. + * + * @return null + */ + abstract public function noop(); + + /** + * delete a message from current box/folder + * + * @return null + */ + abstract public function removeMessage($id); + + /** + * get unique id for one or all messages + * + * if storage does not support unique ids it's the same as the message number + * + * @param int|null $id message number + * @return array|string message number for given message or all messages as array + * @throws Postman_Zend_Mail_Storage_Exception + */ + abstract public function getUniqueId($id = null); + + /** + * get a message number from a unique id + * + * I.e. if you have a webmailer that supports deleting messages you should use unique ids + * as parameter and use this method to translate it to message number right before calling removeMessage() + * + * @param string $id unique id + * @return int message number + * @throws Postman_Zend_Mail_Storage_Exception + */ + abstract public function getNumberByUniqueId($id); + + // interface implementations follows + + /** + * Countable::count() + * + * @return int + */ + public function count() + { + return $this->countMessages(); + } + + + /** + * ArrayAccess::offsetExists() + * + * @param int $id + * @return boolean + */ + public function offsetExists($id) + { + try { + if ($this->getMessage($id)) { + return true; + } + } catch(Postman_Zend_Mail_Storage_Exception $e) {} + + return false; + } + + + /** + * ArrayAccess::offsetGet() + * + * @param int $id + * @return Postman_Zend_Mail_Message message object + */ + public function offsetGet($id) + { + return $this->getMessage($id); + } + + + /** + * ArrayAccess::offsetSet() + * + * @param id $id + * @param mixed $value + * @throws Postman_Zend_Mail_Storage_Exception + * @return void + */ + public function offsetSet($id, $value) + { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot write mail messages via array access'); + } + + + /** + * ArrayAccess::offsetUnset() + * + * @param int $id + * @return boolean success + */ + public function offsetUnset($id) + { + return $this->removeMessage($id); + } + + + /** + * Iterator::rewind() + * + * Rewind always gets the new count from the storage. Thus if you use + * the interfaces and your scripts take long you should use reset() + * from time to time. + * + * @return void + */ + public function rewind() + { + $this->_iterationMax = $this->countMessages(); + $this->_iterationPos = 1; + } + + + /** + * Iterator::current() + * + * @return Postman_Zend_Mail_Message current message + */ + public function current() + { + return $this->getMessage($this->_iterationPos); + } + + + /** + * Iterator::key() + * + * @return int id of current position + */ + public function key() + { + return $this->_iterationPos; + } + + + /** + * Iterator::next() + * + * @return void + */ + public function next() + { + ++$this->_iterationPos; + } + + + /** + * Iterator::valid() + * + * @return boolean + */ + public function valid() + { + if ($this->_iterationMax === null) { + $this->_iterationMax = $this->countMessages(); + } + return $this->_iterationPos && $this->_iterationPos <= $this->_iterationMax; + } + + + /** + * SeekableIterator::seek() + * + * @param int $pos + * @return void + * @throws OutOfBoundsException + */ + public function seek($pos) + { + if ($this->_iterationMax === null) { + $this->_iterationMax = $this->countMessages(); + } + + if ($pos > $this->_iterationMax) { + throw new OutOfBoundsException('this position does not exist'); + } + $this->_iterationPos = $pos; + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Exception.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Exception.php new file mode 100644 index 0000000..99ece01 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Exception.php @@ -0,0 +1,39 @@ + Postman_Zend_Mail_Storage_Folder folder) + * @var array + */ + protected $_folders; + + /** + * local name (name of folder in parent folder) + * @var string + */ + protected $_localName; + + /** + * global name (absolute name of folder) + * @var string + */ + protected $_globalName; + + /** + * folder is selectable if folder is able to hold messages, else it's just a parent folder + * @var bool + */ + protected $_selectable = true; + + /** + * create a new mail folder instance + * + * @param string $localName name of folder in current subdirectory + * @param string $globalName absolute name of folder + * @param bool $selectable if true folder holds messages, if false it's just a parent for subfolders + * @param array $folders init with given instances of Postman_Zend_Mail_Storage_Folder as subfolders + */ + public function __construct($localName, $globalName = '', $selectable = true, array $folders = array()) + { + $this->_localName = $localName; + $this->_globalName = $globalName ? $globalName : $localName; + $this->_selectable = $selectable; + $this->_folders = $folders; + } + + /** + * implements RecursiveIterator::hasChildren() + * + * @return bool current element has children + */ + public function hasChildren() + { + $current = $this->current(); + return $current && $current instanceof Postman_Zend_Mail_Storage_Folder && !$current->isLeaf(); + } + + /** + * implements RecursiveIterator::getChildren() + * + * @return Postman_Zend_Mail_Storage_Folder same as self::current() + */ + public function getChildren() + { + return $this->current(); + } + + /** + * implements Iterator::valid() + * + * @return bool check if there's a current element + */ + public function valid() + { + return key($this->_folders) !== null; + } + + /** + * implements Iterator::next() + * + * @return null + */ + public function next() + { + next($this->_folders); + } + + /** + * implements Iterator::key() + * + * @return string key/local name of current element + */ + public function key() + { + return key($this->_folders); + } + + /** + * implements Iterator::current() + * + * @return Postman_Zend_Mail_Storage_Folder current folder + */ + public function current() + { + return current($this->_folders); + } + + /** + * implements Iterator::rewind() + * + * @return null + */ + public function rewind() + { + reset($this->_folders); + } + + /** + * get subfolder named $name + * + * @param string $name wanted subfolder + * @return Postman_Zend_Mail_Storage_Folder folder named $folder + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function __get($name) + { + if (!isset($this->_folders[$name])) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("no subfolder named $name"); + } + + return $this->_folders[$name]; + } + + /** + * add or replace subfolder named $name + * + * @param string $name local name of subfolder + * @param Postman_Zend_Mail_Storage_Folder $folder instance for new subfolder + * @return null + */ + public function __set($name, Postman_Zend_Mail_Storage_Folder $folder) + { + $this->_folders[$name] = $folder; + } + + /** + * remove subfolder named $name + * + * @param string $name local name of subfolder + * @return null + */ + public function __unset($name) + { + unset($this->_folders[$name]); + } + + /** + * magic method for easy output of global name + * + * @return string global name of folder + */ + public function __toString() + { + return (string)$this->getGlobalName(); + } + + /** + * get local name + * + * @return string local name + */ + public function getLocalName() + { + return $this->_localName; + } + + /** + * get global name + * + * @return string global name + */ + public function getGlobalName() + { + return $this->_globalName; + } + + /** + * is this folder selectable? + * + * @return bool selectable + */ + public function isSelectable() + { + return $this->_selectable; + } + + /** + * check if folder has no subfolder + * + * @return bool true if no subfolders + */ + public function isLeaf() + { + return empty($this->_folders); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Interface.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Interface.php new file mode 100644 index 0000000..e991c4f --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Interface.php @@ -0,0 +1,60 @@ +dirname) || !is_dir($params->dirname)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('no valid dirname given in params'); + } + + $this->_rootdir = rtrim($params->dirname, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR; + + $this->_delim = isset($params->delim) ? $params->delim : '.'; + + $this->_buildFolderTree(); + $this->selectFolder(!empty($params->folder) ? $params->folder : 'INBOX'); + $this->_has['top'] = true; + $this->_has['flags'] = true; + } + + /** + * find all subfolders and mbox files for folder structure + * + * Result is save in Postman_Zend_Mail_Storage_Folder instances with the root in $this->_rootFolder. + * $parentFolder and $parentGlobalName are only used internally for recursion. + * + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + protected function _buildFolderTree() + { + $this->_rootFolder = new Postman_Zend_Mail_Storage_Folder('/', '/', false); + $this->_rootFolder->INBOX = new Postman_Zend_Mail_Storage_Folder('INBOX', 'INBOX', true); + + $dh = @opendir($this->_rootdir); + if (!$dh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("can't read folders in maildir"); + } + $dirs = array(); + while (($entry = readdir($dh)) !== false) { + // maildir++ defines folders must start with . + if ($entry[0] != '.' || $entry == '.' || $entry == '..') { + continue; + } + if ($this->_isMaildir($this->_rootdir . $entry)) { + $dirs[] = $entry; + } + } + closedir($dh); + + sort($dirs); + $stack = array(null); + $folderStack = array(null); + $parentFolder = $this->_rootFolder; + $parent = '.'; + + foreach ($dirs as $dir) { + do { + if (strpos($dir, $parent) === 0) { + $local = substr($dir, strlen($parent)); + if (strpos($local, $this->_delim) !== false) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('error while reading maildir'); + } + array_push($stack, $parent); + $parent = $dir . $this->_delim; + $folder = new Postman_Zend_Mail_Storage_Folder($local, substr($dir, 1), true); + $parentFolder->$local = $folder; + array_push($folderStack, $parentFolder); + $parentFolder = $folder; + break; + } else if ($stack) { + $parent = array_pop($stack); + $parentFolder = array_pop($folderStack); + } + } while ($stack); + if (!$stack) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('error while reading maildir'); + } + } + } + + /** + * get root folder or given folder + * + * @param string $rootFolder get folder structure for given folder, else root + * @return Postman_Zend_Mail_Storage_Folder root or wanted folder + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getFolders($rootFolder = null) + { + if (!$rootFolder || $rootFolder == 'INBOX') { + return $this->_rootFolder; + } + + // rootdir is same as INBOX in maildir + if (strpos($rootFolder, 'INBOX' . $this->_delim) === 0) { + $rootFolder = substr($rootFolder, 6); + } + $currentFolder = $this->_rootFolder; + $subname = trim($rootFolder, $this->_delim); + while ($currentFolder) { + @list($entry, $subname) = @explode($this->_delim, $subname, 2); + $currentFolder = $currentFolder->$entry; + if (!$subname) { + break; + } + } + + if ($currentFolder->getGlobalName() != rtrim($rootFolder, $this->_delim)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("folder $rootFolder not found"); + } + return $currentFolder; + } + + /** + * select given folder + * + * folder must be selectable! + * + * @param Postman_Zend_Mail_Storage_Folder|string $globalName global name of folder or instance for subfolder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function selectFolder($globalName) + { + $this->_currentFolder = (string)$globalName; + + // getting folder from folder tree for validation + $folder = $this->getFolders($this->_currentFolder); + + try { + $this->_openMaildir($this->_rootdir . '.' . $folder->getGlobalName()); + } catch(Postman_Zend_Mail_Storage_Exception $e) { + // check what went wrong + if (!$folder->isSelectable()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("{$this->_currentFolder} is not selectable", 0, $e); + } + // seems like file has vanished; rebuilding folder tree - but it's still an exception + $this->_buildFolderTree($this->_rootdir); + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('seems like the maildir has vanished, I\'ve rebuild the ' . + 'folder tree, search for an other folder and try again', 0, $e); + } + } + + /** + * get Postman_Zend_Mail_Storage_Folder instance for current folder + * + * @return Postman_Zend_Mail_Storage_Folder instance of current folder + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getCurrentFolder() + { + return $this->_currentFolder; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Mbox.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Mbox.php new file mode 100644 index 0000000..8f61e16 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Folder/Mbox.php @@ -0,0 +1,264 @@ +filename)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('use Postman_Zend_Mail_Storage_Mbox for a single file'); + } + + if (!isset($params->dirname) || !is_dir($params->dirname)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('no valid dirname given in params'); + } + + $this->_rootdir = rtrim($params->dirname, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR; + + $this->_buildFolderTree($this->_rootdir); + $this->selectFolder(!empty($params->folder) ? $params->folder : 'INBOX'); + $this->_has['top'] = true; + $this->_has['uniqueid'] = false; + } + + /** + * find all subfolders and mbox files for folder structure + * + * Result is save in Postman_Zend_Mail_Storage_Folder instances with the root in $this->_rootFolder. + * $parentFolder and $parentGlobalName are only used internally for recursion. + * + * @param string $currentDir call with root dir, also used for recursion. + * @param Postman_Zend_Mail_Storage_Folder|null $parentFolder used for recursion + * @param string $parentGlobalName used for rescursion + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + protected function _buildFolderTree($currentDir, $parentFolder = null, $parentGlobalName = '') + { + if (!$parentFolder) { + $this->_rootFolder = new Postman_Zend_Mail_Storage_Folder('/', '/', false); + $parentFolder = $this->_rootFolder; + } + + $dh = @opendir($currentDir); + if (!$dh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("can't read dir $currentDir"); + } + while (($entry = readdir($dh)) !== false) { + // ignore hidden files for mbox + if ($entry[0] == '.') { + continue; + } + $absoluteEntry = $currentDir . $entry; + $globalName = $parentGlobalName . DIRECTORY_SEPARATOR . $entry; + if (is_file($absoluteEntry) && $this->_isMboxFile($absoluteEntry)) { + $parentFolder->$entry = new Postman_Zend_Mail_Storage_Folder($entry, $globalName); + continue; + } + if (!is_dir($absoluteEntry) /* || $entry == '.' || $entry == '..' */) { + continue; + } + $folder = new Postman_Zend_Mail_Storage_Folder($entry, $globalName, false); + $parentFolder->$entry = $folder; + $this->_buildFolderTree($absoluteEntry . DIRECTORY_SEPARATOR, $folder, $globalName); + } + + closedir($dh); + } + + /** + * get root folder or given folder + * + * @param string $rootFolder get folder structure for given folder, else root + * @return Postman_Zend_Mail_Storage_Folder root or wanted folder + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getFolders($rootFolder = null) + { + if (!$rootFolder) { + return $this->_rootFolder; + } + + $currentFolder = $this->_rootFolder; + $subname = trim($rootFolder, DIRECTORY_SEPARATOR); + while ($currentFolder) { + @list($entry, $subname) = @explode(DIRECTORY_SEPARATOR, $subname, 2); + $currentFolder = $currentFolder->$entry; + if (!$subname) { + break; + } + } + + if ($currentFolder->getGlobalName() != DIRECTORY_SEPARATOR . trim($rootFolder, DIRECTORY_SEPARATOR)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("folder $rootFolder not found"); + } + return $currentFolder; + } + + /** + * select given folder + * + * folder must be selectable! + * + * @param Postman_Zend_Mail_Storage_Folder|string $globalName global name of folder or instance for subfolder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function selectFolder($globalName) + { + $this->_currentFolder = (string)$globalName; + + // getting folder from folder tree for validation + $folder = $this->getFolders($this->_currentFolder); + + try { + $this->_openMboxFile($this->_rootdir . $folder->getGlobalName()); + } catch(Postman_Zend_Mail_Storage_Exception $e) { + // check what went wrong + if (!$folder->isSelectable()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("{$this->_currentFolder} is not selectable", 0, $e); + } + // seems like file has vanished; rebuilding folder tree - but it's still an exception + $this->_buildFolderTree($this->_rootdir); + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('seems like the mbox file has vanished, I\'ve rebuild the ' . + 'folder tree, search for an other folder and try again', 0, $e); + } + } + + /** + * get Postman_Zend_Mail_Storage_Folder instance for current folder + * + * @return Postman_Zend_Mail_Storage_Folder instance of current folder + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getCurrentFolder() + { + return $this->_currentFolder; + } + + /** + * magic method for serialize() + * + * with this method you can cache the mbox class + * + * @return array name of variables + */ + public function __sleep() + { + return array_merge(parent::__sleep(), array('_currentFolder', '_rootFolder', '_rootdir')); + } + + /** + * magic method for unserialize() + * + * with this method you can cache the mbox class + * + * @return null + */ + public function __wakeup() + { + // if cache is stall selectFolder() rebuilds the tree on error + parent::__wakeup(); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Imap.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Imap.php new file mode 100644 index 0000000..8073c93 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Imap.php @@ -0,0 +1,644 @@ + Postman_Zend_Mail_Storage::FLAG_PASSED, + '\Answered' => Postman_Zend_Mail_Storage::FLAG_ANSWERED, + '\Seen' => Postman_Zend_Mail_Storage::FLAG_SEEN, + '\Deleted' => Postman_Zend_Mail_Storage::FLAG_DELETED, + '\Draft' => Postman_Zend_Mail_Storage::FLAG_DRAFT, + '\Flagged' => Postman_Zend_Mail_Storage::FLAG_FLAGGED); + + /** + * map flags to search criterias + * @var array + */ + protected static $_searchFlags = array('\Recent' => 'RECENT', + '\Answered' => 'ANSWERED', + '\Seen' => 'SEEN', + '\Deleted' => 'DELETED', + '\Draft' => 'DRAFT', + '\Flagged' => 'FLAGGED'); + + /** + * Count messages all messages in current box + * + * @return int number of messages + * @throws Postman_Zend_Mail_Storage_Exception + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function countMessages($flags = null) + { + if (!$this->_currentFolder) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('No selected folder to count'); + } + + if ($flags === null) { + return count($this->_protocol->search(array('ALL'))); + } + + $params = array(); + foreach ((array)$flags as $flag) { + if (isset(self::$_searchFlags[$flag])) { + $params[] = self::$_searchFlags[$flag]; + } else { + $params[] = 'KEYWORD'; + $params[] = $this->_protocol->escapeString($flag); + } + } + return count($this->_protocol->search($params)); + } + + /** + * get a list of messages with number and size + * + * @param int $id number of message + * @return int|array size of given message of list with all messages as array(num => size) + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function getSize($id = 0) + { + if ($id) { + return $this->_protocol->fetch('RFC822.SIZE', $id); + } + return $this->_protocol->fetch('RFC822.SIZE', 1, INF); + } + + /** + * Fetch a message + * + * @param int $id number of message + * @return Postman_Zend_Mail_Message + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function getMessage($id) + { + $data = $this->_protocol->fetch(array('FLAGS', 'RFC822.HEADER'), $id); + $header = $data['RFC822.HEADER']; + + $flags = array(); + foreach ($data['FLAGS'] as $flag) { + $flags[] = isset(self::$_knownFlags[$flag]) ? self::$_knownFlags[$flag] : $flag; + } + + return new $this->_messageClass(array('handler' => $this, 'id' => $id, 'headers' => $header, 'flags' => $flags)); + } + + /* + * Get raw header of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage header + * @param int $topLines include this many lines with header (after an empty line) + * @param int $topLines include this many lines with header (after an empty line) + * @return string raw header + * @throws Postman_Zend_Mail_Protocol_Exception + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getRawHeader($id, $part = null, $topLines = 0) + { + if ($part !== null) { + // TODO: implement + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('not implemented'); + } + + // TODO: toplines + return $this->_protocol->fetch('RFC822.HEADER', $id); + } + + /* + * Get raw content of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage content + * @return string raw content + * @throws Postman_Zend_Mail_Protocol_Exception + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getRawContent($id, $part = null) + { + if ($part !== null) { + // TODO: implement + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('not implemented'); + } + + return $this->_protocol->fetch('RFC822.TEXT', $id); + } + + /** + * create instance with parameters + * Supported paramters are + * - user username + * - host hostname or ip address of IMAP server [optional, default = 'localhost'] + * - password password for user 'username' [optional, default = ''] + * - port port for IMAP server [optional, default = 110] + * - ssl 'SSL' or 'TLS' for secure sockets + * - folder select this folder [optional, default = 'INBOX'] + * + * @param array $params mail reader specific parameters + * @throws Postman_Zend_Mail_Storage_Exception + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function __construct($params) + { + if (is_array($params)) { + $params = (object)$params; + } + + $this->_has['flags'] = true; + + if ($params instanceof Postman_Zend_Mail_Protocol_Imap) { + $this->_protocol = $params; + try { + $this->selectFolder('INBOX'); + } catch(Postman_Zend_Mail_Storage_Exception $e) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot select INBOX, is this a valid transport?', 0, $e); + } + return; + } + + if (!isset($params->user)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('need at least user in params'); + } + + $host = isset($params->host) ? $params->host : 'localhost'; + $password = isset($params->password) ? $params->password : ''; + $port = isset($params->port) ? $params->port : null; + $ssl = isset($params->ssl) ? $params->ssl : false; + + $this->_protocol = new Postman_Zend_Mail_Protocol_Imap(); + $this->_protocol->connect($host, $port, $ssl); + if (!$this->_protocol->login($params->user, $password)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot login, user or password wrong'); + } + $this->selectFolder(isset($params->folder) ? $params->folder : 'INBOX'); + } + + /** + * Close resource for mail lib. If you need to control, when the resource + * is closed. Otherwise the destructor would call this. + * + * @return null + */ + public function close() + { + $this->_currentFolder = ''; + $this->_protocol->logout(); + } + + /** + * Keep the server busy. + * + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function noop() + { + if (!$this->_protocol->noop()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('could not do nothing'); + } + } + + /** + * Remove a message from server. If you're doing that from a web enviroment + * you should be careful and use a uniqueid as parameter if possible to + * identify the message. + * + * @param int $id number of message + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function removeMessage($id) + { + if (!$this->_protocol->store(array(Postman_Zend_Mail_Storage::FLAG_DELETED), $id, null, '+')) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot set deleted flag'); + } + // TODO: expunge here or at close? we can handle an error here better and are more fail safe + if (!$this->_protocol->expunge()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('message marked as deleted, but could not expunge'); + } + } + + /** + * get unique id for one or all messages + * + * if storage does not support unique ids it's the same as the message number + * + * @param int|null $id message number + * @return array|string message number for given message or all messages as array + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getUniqueId($id = null) + { + if ($id) { + return $this->_protocol->fetch('UID', $id); + } + + return $this->_protocol->fetch('UID', 1, INF); + } + + /** + * get a message number from a unique id + * + * I.e. if you have a webmailer that supports deleting messages you should use unique ids + * as parameter and use this method to translate it to message number right before calling removeMessage() + * + * @param string $id unique id + * @return int message number + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getNumberByUniqueId($id) + { + // TODO: use search to find number directly + $ids = $this->getUniqueId(); + foreach ($ids as $k => $v) { + if ($v == $id) { + return $k; + } + } + + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('unique id not found'); + } + + + /** + * get root folder or given folder + * + * @param string $rootFolder get folder structure for given folder, else root + * @return Postman_Zend_Mail_Storage_Folder root or wanted folder + * @throws Postman_Zend_Mail_Storage_Exception + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function getFolders($rootFolder = null) + { + $folders = $this->_protocol->listMailbox((string)$rootFolder); + if (!$folders) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('folder not found'); + } + + ksort($folders, SORT_STRING); + $root = new Postman_Zend_Mail_Storage_Folder('/', '/', false); + $stack = array(null); + $folderStack = array(null); + $parentFolder = $root; + $parent = ''; + + foreach ($folders as $globalName => $data) { + do { + if (!$parent || strpos($globalName, $parent) === 0) { + $pos = strrpos($globalName, $data['delim']); + if ($pos === false) { + $localName = $globalName; + } else { + $localName = substr($globalName, $pos + 1); + } + $selectable = !$data['flags'] || !in_array('\\Noselect', $data['flags']); + + array_push($stack, $parent); + $parent = $globalName . $data['delim']; + $folder = new Postman_Zend_Mail_Storage_Folder($localName, $globalName, $selectable); + $parentFolder->$localName = $folder; + array_push($folderStack, $parentFolder); + $parentFolder = $folder; + break; + } else if ($stack) { + $parent = array_pop($stack); + $parentFolder = array_pop($folderStack); + } + } while ($stack); + if (!$stack) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('error while constructing folder tree'); + } + } + + return $root; + } + + /** + * select given folder + * + * folder must be selectable! + * + * @param Postman_Zend_Mail_Storage_Folder|string $globalName global name of folder or instance for subfolder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function selectFolder($globalName) + { + $this->_currentFolder = $globalName; + if (!$this->_protocol->select($this->_currentFolder)) { + $this->_currentFolder = ''; + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot change folder, maybe it does not exist'); + } + } + + + /** + * get Postman_Zend_Mail_Storage_Folder instance for current folder + * + * @return Postman_Zend_Mail_Storage_Folder instance of current folder + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getCurrentFolder() + { + return $this->_currentFolder; + } + + /** + * create a new folder + * + * This method also creates parent folders if necessary. Some mail storages may restrict, which folder + * may be used as parent or which chars may be used in the folder name + * + * @param string $name global name of folder, local name if $parentFolder is set + * @param string|Postman_Zend_Mail_Storage_Folder $parentFolder parent folder for new folder, else root folder is parent + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function createFolder($name, $parentFolder = null) + { + // TODO: we assume / as the hierarchy delim - need to get that from the folder class! + if ($parentFolder instanceof Postman_Zend_Mail_Storage_Folder) { + $folder = $parentFolder->getGlobalName() . '/' . $name; + } else if ($parentFolder != null) { + $folder = $parentFolder . '/' . $name; + } else { + $folder = $name; + } + + if (!$this->_protocol->create($folder)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot create folder'); + } + } + + /** + * remove a folder + * + * @param string|Postman_Zend_Mail_Storage_Folder $name name or instance of folder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function removeFolder($name) + { + if ($name instanceof Postman_Zend_Mail_Storage_Folder) { + $name = $name->getGlobalName(); + } + + if (!$this->_protocol->delete($name)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot delete folder'); + } + } + + /** + * rename and/or move folder + * + * The new name has the same restrictions as in createFolder() + * + * @param string|Postman_Zend_Mail_Storage_Folder $oldName name or instance of folder + * @param string $newName new global name of folder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function renameFolder($oldName, $newName) + { + if ($oldName instanceof Postman_Zend_Mail_Storage_Folder) { + $oldName = $oldName->getGlobalName(); + } + + if (!$this->_protocol->rename($oldName, $newName)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot rename folder'); + } + } + + /** + * append a new message to mail storage + * + * @param string $message message as string or instance of message class + * @param null|string|Postman_Zend_Mail_Storage_Folder $folder folder for new message, else current folder is taken + * @param null|array $flags set flags for new message, else a default set is used + * @throws Postman_Zend_Mail_Storage_Exception + */ + // not yet * @param string|Postman_Zend_Mail_Message|Postman_Zend_Mime_Message $message message as string or instance of message class + public function appendMessage($message, $folder = null, $flags = null) + { + if ($folder === null) { + $folder = $this->_currentFolder; + } + + if ($flags === null) { + $flags = array(Postman_Zend_Mail_Storage::FLAG_SEEN); + } + + // TODO: handle class instances for $message + if (!$this->_protocol->append($folder, $message, $flags)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot create message, please check if the folder exists and your flags'); + } + } + + /** + * copy an existing message + * + * @param int $id number of message + * @param string|Postman_Zend_Mail_Storage_Folder $folder name or instance of targer folder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function copyMessage($id, $folder) + { + if (!$this->_protocol->copy($folder, $id)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot copy message, does the folder exist?'); + } + } + + /** + * move an existing message + * + * NOTE: imap has no native move command, thus it's emulated with copy and delete + * + * @param int $id number of message + * @param string|Postman_Zend_Mail_Storage_Folder $folder name or instance of targer folder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function moveMessage($id, $folder) { + $this->copyMessage($id, $folder); + $this->removeMessage($id); + } + + /** + * set flags for message + * + * NOTE: this method can't set the recent flag. + * + * @param int $id number of message + * @param array $flags new flags for message + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function setFlags($id, $flags) + { + if (!$this->_protocol->store($flags, $id)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot set flags, have you tried to set the recent flag or special chars?'); + } + } +} + diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Maildir.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Maildir.php new file mode 100644 index 0000000..39913ca --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Maildir.php @@ -0,0 +1,475 @@ + Postman_Zend_Mail_Storage::FLAG_DRAFT, + 'F' => Postman_Zend_Mail_Storage::FLAG_FLAGGED, + 'P' => Postman_Zend_Mail_Storage::FLAG_PASSED, + 'R' => Postman_Zend_Mail_Storage::FLAG_ANSWERED, + 'S' => Postman_Zend_Mail_Storage::FLAG_SEEN, + 'T' => Postman_Zend_Mail_Storage::FLAG_DELETED); + + // TODO: getFlags($id) for fast access if headers are not needed (i.e. just setting flags)? + + /** + * Count messages all messages in current box + * + * @return int number of messages + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function countMessages($flags = null) + { + if ($flags === null) { + return count($this->_files); + } + + $count = 0; + if (!is_array($flags)) { + foreach ($this->_files as $file) { + if (isset($file['flaglookup'][$flags])) { + ++$count; + } + } + return $count; + } + + $flags = array_flip($flags); + foreach ($this->_files as $file) { + foreach ($flags as $flag => $v) { + if (!isset($file['flaglookup'][$flag])) { + continue 2; + } + } + ++$count; + } + return $count; + } + + /** + * Get one or all fields from file structure. Also checks if message is valid + * + * @param int $id message number + * @param string|null $field wanted field + * @return string|array wanted field or all fields as array + * @throws Postman_Zend_Mail_Storage_Exception + */ + protected function _getFileData($id, $field = null) + { + if (!isset($this->_files[$id - 1])) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('id does not exist'); + } + + if (!$field) { + return $this->_files[$id - 1]; + } + + if (!isset($this->_files[$id - 1][$field])) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('field does not exist'); + } + + return $this->_files[$id - 1][$field]; + } + + /** + * Get a list of messages with number and size + * + * @param int|null $id number of message or null for all messages + * @return int|array size of given message of list with all messages as array(num => size) + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getSize($id = null) + { + if ($id !== null) { + $filedata = $this->_getFileData($id); + return isset($filedata['size']) ? $filedata['size'] : filesize($filedata['filename']); + } + + $result = array(); + foreach ($this->_files as $num => $data) { + $result[$num + 1] = isset($data['size']) ? $data['size'] : filesize($data['filename']); + } + + return $result; + } + + + + /** + * Fetch a message + * + * @param int $id number of message + * @return Postman_Zend_Mail_Message_File + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getMessage($id) + { + // TODO that's ugly, would be better to let the message class decide + if (strtolower($this->_messageClass) == 'Postman_Zend_mail_message_file' || is_subclass_of($this->_messageClass, 'Postman_Zend_mail_message_file')) { + return new $this->_messageClass(array('file' => $this->_getFileData($id, 'filename'), + 'flags' => $this->_getFileData($id, 'flags'))); + } + + return new $this->_messageClass(array('handler' => $this, 'id' => $id, 'headers' => $this->getRawHeader($id), + 'flags' => $this->_getFileData($id, 'flags'))); + } + + /* + * Get raw header of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage header + * @param int $topLines include this many lines with header (after an empty line) + * @return string raw header + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getRawHeader($id, $part = null, $topLines = 0) + { + if ($part !== null) { + // TODO: implement + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('not implemented'); + } + + $fh = fopen($this->_getFileData($id, 'filename'), 'r'); + + $content = ''; + while (!feof($fh)) { + $line = fgets($fh); + if (!trim($line)) { + break; + } + $content .= $line; + } + + fclose($fh); + return $content; + } + + /* + * Get raw content of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage content + * @return string raw content + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getRawContent($id, $part = null) + { + if ($part !== null) { + // TODO: implement + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('not implemented'); + } + + $fh = fopen($this->_getFileData($id, 'filename'), 'r'); + + while (!feof($fh)) { + $line = fgets($fh); + if (!trim($line)) { + break; + } + } + + $content = stream_get_contents($fh); + fclose($fh); + return $content; + } + + /** + * Create instance with parameters + * Supported parameters are: + * - dirname dirname of mbox file + * + * @param array $params mail reader specific parameters + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function __construct($params) + { + if (is_array($params)) { + $params = (object)$params; + } + + if (!isset($params->dirname) || !is_dir($params->dirname)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('no valid dirname given in params'); + } + + if (!$this->_isMaildir($params->dirname)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('invalid maildir given'); + } + + $this->_has['top'] = true; + $this->_has['flags'] = true; + $this->_openMaildir($params->dirname); + } + + /** + * check if a given dir is a valid maildir + * + * @param string $dirname name of dir + * @return bool dir is valid maildir + */ + protected function _isMaildir($dirname) + { + if (file_exists($dirname . '/new') && !is_dir($dirname . '/new')) { + return false; + } + if (file_exists($dirname . '/tmp') && !is_dir($dirname . '/tmp')) { + return false; + } + return is_dir($dirname . '/cur'); + } + + /** + * open given dir as current maildir + * + * @param string $dirname name of maildir + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + protected function _openMaildir($dirname) + { + if ($this->_files) { + $this->close(); + } + + $dh = @opendir($dirname . '/cur/'); + if (!$dh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot open maildir'); + } + $this->_getMaildirFiles($dh, $dirname . '/cur/'); + closedir($dh); + + $dh = @opendir($dirname . '/new/'); + if ($dh) { + $this->_getMaildirFiles($dh, $dirname . '/new/', array(Postman_Zend_Mail_Storage::FLAG_RECENT)); + closedir($dh); + } else if (file_exists($dirname . '/new/')) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot read recent mails in maildir'); + } + } + + /** + * find all files in opened dir handle and add to maildir files + * + * @param resource $dh dir handle used for search + * @param string $dirname dirname of dir in $dh + * @param array $default_flags default flags for given dir + * @return null + */ + protected function _getMaildirFiles($dh, $dirname, $default_flags = array()) + { + while (($entry = readdir($dh)) !== false) { + if ($entry[0] == '.' || !is_file($dirname . $entry)) { + continue; + } + + @list($uniq, $info) = explode(':', $entry, 2); + @list(,$size) = explode(',', $uniq, 2); + if ($size && $size[0] == 'S' && $size[1] == '=') { + $size = substr($size, 2); + } + if (!ctype_digit($size)) { + $size = null; + } + @list($version, $flags) = explode(',', $info, 2); + if ($version != 2) { + $flags = ''; + } + + $named_flags = $default_flags; + $length = strlen($flags); + for ($i = 0; $i < $length; ++$i) { + $flag = $flags[$i]; + $named_flags[$flag] = isset(self::$_knownFlags[$flag]) ? self::$_knownFlags[$flag] : $flag; + } + + $data = array('uniq' => $uniq, + 'flags' => $named_flags, + 'flaglookup' => array_flip($named_flags), + 'filename' => $dirname . $entry); + if ($size !== null) { + $data['size'] = (int)$size; + } + $this->_files[] = $data; + } + } + + + /** + * Close resource for mail lib. If you need to control, when the resource + * is closed. Otherwise the destructor would call this. + * + * @return void + */ + public function close() + { + $this->_files = array(); + } + + + /** + * Waste some CPU cycles doing nothing. + * + * @return void + */ + public function noop() + { + return true; + } + + + /** + * stub for not supported message deletion + * + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function removeMessage($id) + { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('maildir is (currently) read-only'); + } + + /** + * get unique id for one or all messages + * + * if storage does not support unique ids it's the same as the message number + * + * @param int|null $id message number + * @return array|string message number for given message or all messages as array + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getUniqueId($id = null) + { + if ($id) { + return $this->_getFileData($id, 'uniq'); + } + + $ids = array(); + foreach ($this->_files as $num => $file) { + $ids[$num + 1] = $file['uniq']; + } + return $ids; + } + + /** + * get a message number from a unique id + * + * I.e. if you have a webmailer that supports deleting messages you should use unique ids + * as parameter and use this method to translate it to message number right before calling removeMessage() + * + * @param string $id unique id + * @return int message number + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getNumberByUniqueId($id) + { + foreach ($this->_files as $num => $file) { + if ($file['uniq'] == $id) { + return $num + 1; + } + } + + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('unique id not found'); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Mbox.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Mbox.php new file mode 100644 index 0000000..0880a96 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Mbox.php @@ -0,0 +1,447 @@ + start, 'seperator' => headersep, 'end' => end) + * @var array + */ + protected $_positions; + + /** + * used message class, change it in an extened class to extend the returned message class + * @var string + */ + protected $_messageClass = 'Postman_Zend_Mail_Message_File'; + + /** + * Count messages all messages in current box + * + * @return int number of messages + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function countMessages() + { + return count($this->_positions); + } + + + /** + * Get a list of messages with number and size + * + * @param int|null $id number of message or null for all messages + * @return int|array size of given message of list with all messages as array(num => size) + */ + public function getSize($id = 0) + { + if ($id) { + $pos = $this->_positions[$id - 1]; + return $pos['end'] - $pos['start']; + } + + $result = array(); + foreach ($this->_positions as $num => $pos) { + $result[$num + 1] = $pos['end'] - $pos['start']; + } + + return $result; + } + + + /** + * Get positions for mail message or throw exeption if id is invalid + * + * @param int $id number of message + * @return array positions as in _positions + * @throws Postman_Zend_Mail_Storage_Exception + */ + protected function _getPos($id) + { + if (!isset($this->_positions[$id - 1])) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('id does not exist'); + } + + return $this->_positions[$id - 1]; + } + + + /** + * Fetch a message + * + * @param int $id number of message + * @return Postman_Zend_Mail_Message_File + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getMessage($id) + { + // TODO that's ugly, would be better to let the message class decide + if (strtolower($this->_messageClass) == 'Postman_Zend_mail_message_file' || is_subclass_of($this->_messageClass, 'Postman_Zend_mail_message_file')) { + // TODO top/body lines + $messagePos = $this->_getPos($id); + return new $this->_messageClass(array('file' => $this->_fh, 'startPos' => $messagePos['start'], + 'endPos' => $messagePos['end'])); + } + + $bodyLines = 0; // TODO: need a way to change that + + $message = $this->getRawHeader($id); + // file pointer is after headers now + if ($bodyLines) { + $message .= "\n"; + while ($bodyLines-- && ftell($this->_fh) < $this->_positions[$id - 1]['end']) { + $message .= fgets($this->_fh); + } + } + + return new $this->_messageClass(array('handler' => $this, 'id' => $id, 'headers' => $message)); + } + + /* + * Get raw header of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage header + * @param int $topLines include this many lines with header (after an empty line) + * @return string raw header + * @throws Postman_Zend_Mail_Protocol_Exception + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getRawHeader($id, $part = null, $topLines = 0) + { + if ($part !== null) { + // TODO: implement + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('not implemented'); + } + $messagePos = $this->_getPos($id); + // TODO: toplines + return stream_get_contents($this->_fh, $messagePos['separator'] - $messagePos['start'], $messagePos['start']); + } + + /* + * Get raw content of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage content + * @return string raw content + * @throws Postman_Zend_Mail_Protocol_Exception + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getRawContent($id, $part = null) + { + if ($part !== null) { + // TODO: implement + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('not implemented'); + } + $messagePos = $this->_getPos($id); + return stream_get_contents($this->_fh, $messagePos['end'] - $messagePos['separator'], $messagePos['separator']); + } + + /** + * Create instance with parameters + * Supported parameters are: + * - filename filename of mbox file + * + * @param array $params mail reader specific parameters + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function __construct($params) + { + if (is_array($params)) { + $params = (object)$params; + } + + if (!isset($params->filename) /* || Postman_Zend_Loader::isReadable($params['filename']) */) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('no valid filename given in params'); + } + + $this->_openMboxFile($params->filename); + $this->_has['top'] = true; + $this->_has['uniqueid'] = false; + } + + /** + * check if given file is a mbox file + * + * if $file is a resource its file pointer is moved after the first line + * + * @param resource|string $file stream resource of name of file + * @param bool $fileIsString file is string or resource + * @return bool file is mbox file + */ + protected function _isMboxFile($file, $fileIsString = true) + { + if ($fileIsString) { + $file = @fopen($file, 'r'); + if (!$file) { + return false; + } + } else { + fseek($file, 0); + } + + $result = false; + + $line = fgets($file); + if (strpos($line, 'From ') === 0) { + $result = true; + } + + if ($fileIsString) { + @fclose($file); + } + + return $result; + } + + /** + * open given file as current mbox file + * + * @param string $filename filename of mbox file + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + protected function _openMboxFile($filename) + { + if ($this->_fh) { + $this->close(); + } + + $this->_fh = @fopen($filename, 'r'); + if (!$this->_fh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot open mbox file'); + } + $this->_filename = $filename; + $this->_filemtime = filemtime($this->_filename); + + if (!$this->_isMboxFile($this->_fh, false)) { + @fclose($this->_fh); + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('file is not a valid mbox format'); + } + + $messagePos = array('start' => ftell($this->_fh), 'separator' => 0, 'end' => 0); + while (($line = fgets($this->_fh)) !== false) { + if (strpos($line, 'From ') === 0) { + $messagePos['end'] = ftell($this->_fh) - strlen($line) - 2; // + newline + if (!$messagePos['separator']) { + $messagePos['separator'] = $messagePos['end']; + } + $this->_positions[] = $messagePos; + $messagePos = array('start' => ftell($this->_fh), 'separator' => 0, 'end' => 0); + } + if (!$messagePos['separator'] && !trim($line)) { + $messagePos['separator'] = ftell($this->_fh); + } + } + + $messagePos['end'] = ftell($this->_fh); + if (!$messagePos['separator']) { + $messagePos['separator'] = $messagePos['end']; + } + $this->_positions[] = $messagePos; + } + + /** + * Close resource for mail lib. If you need to control, when the resource + * is closed. Otherwise the destructor would call this. + * + * @return void + */ + public function close() + { + @fclose($this->_fh); + $this->_positions = array(); + } + + + /** + * Waste some CPU cycles doing nothing. + * + * @return void + */ + public function noop() + { + return true; + } + + + /** + * stub for not supported message deletion + * + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function removeMessage($id) + { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('mbox is read-only'); + } + + /** + * get unique id for one or all messages + * + * Mbox does not support unique ids (yet) - it's always the same as the message number. + * That shouldn't be a problem, because we can't change mbox files. Therefor the message + * number is save enough. + * + * @param int|null $id message number + * @return array|string message number for given message or all messages as array + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getUniqueId($id = null) + { + if ($id) { + // check if id exists + $this->_getPos($id); + return $id; + } + + $range = range(1, $this->countMessages()); + return array_combine($range, $range); + } + + /** + * get a message number from a unique id + * + * I.e. if you have a webmailer that supports deleting messages you should use unique ids + * as parameter and use this method to translate it to message number right before calling removeMessage() + * + * @param string $id unique id + * @return int message number + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getNumberByUniqueId($id) + { + // check if id exists + $this->_getPos($id); + return $id; + } + + /** + * magic method for serialize() + * + * with this method you can cache the mbox class + * + * @return array name of variables + */ + public function __sleep() + { + return array('_filename', '_positions', '_filemtime'); + } + + /** + * magic method for unserialize() + * + * with this method you can cache the mbox class + * for cache validation the mtime of the mbox file is used + * + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function __wakeup() + { + if ($this->_filemtime != @filemtime($this->_filename)) { + $this->close(); + $this->_openMboxFile($this->_filename); + } else { + $this->_fh = @fopen($this->_filename, 'r'); + if (!$this->_fh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot open mbox file'); + } + } + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Pop3.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Pop3.php new file mode 100644 index 0000000..efc8f8d --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Pop3.php @@ -0,0 +1,328 @@ +_protocol->status($count, $null); + return (int)$count; + } + + /** + * get a list of messages with number and size + * + * @param int $id number of message + * @return int|array size of given message of list with all messages as array(num => size) + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function getSize($id = 0) + { + $id = $id ? $id : null; + return $this->_protocol->getList($id); + } + + /** + * Fetch a message + * + * @param int $id number of message + * @return Postman_Zend_Mail_Message + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function getMessage($id) + { + $bodyLines = 0; + $message = $this->_protocol->top($id, $bodyLines, true); + + return new $this->_messageClass(array('handler' => $this, 'id' => $id, 'headers' => $message, + 'noToplines' => $bodyLines < 1)); + } + + /* + * Get raw header of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage header + * @param int $topLines include this many lines with header (after an empty line) + * @return string raw header + * @throws Postman_Zend_Mail_Protocol_Exception + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getRawHeader($id, $part = null, $topLines = 0) + { + if ($part !== null) { + // TODO: implement + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('not implemented'); + } + + return $this->_protocol->top($id, 0, true); + } + + /* + * Get raw content of message or part + * + * @param int $id number of message + * @param null|array|string $part path to part or null for messsage content + * @return string raw content + * @throws Postman_Zend_Mail_Protocol_Exception + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getRawContent($id, $part = null) + { + if ($part !== null) { + // TODO: implement + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('not implemented'); + } + + $content = $this->_protocol->retrieve($id); + // TODO: find a way to avoid decoding the headers + Postman_Zend_Mime_Decode::splitMessage($content, $null, $body); + return $body; + } + + /** + * create instance with parameters + * Supported paramters are + * - host hostname or ip address of POP3 server + * - user username + * - password password for user 'username' [optional, default = ''] + * - port port for POP3 server [optional, default = 110] + * - ssl 'SSL' or 'TLS' for secure sockets + * + * @param array $params mail reader specific parameters + * @throws Postman_Zend_Mail_Storage_Exception + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function __construct($params) + { + if (is_array($params)) { + $params = (object)$params; + } + + $this->_has['fetchPart'] = false; + $this->_has['top'] = null; + $this->_has['uniqueid'] = null; + + if ($params instanceof Postman_Zend_Mail_Protocol_Pop3) { + $this->_protocol = $params; + return; + } + + if (!isset($params->user)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('need at least user in params'); + } + + $host = isset($params->host) ? $params->host : 'localhost'; + $password = isset($params->password) ? $params->password : ''; + $port = isset($params->port) ? $params->port : null; + $ssl = isset($params->ssl) ? $params->ssl : false; + + $this->_protocol = new Postman_Zend_Mail_Protocol_Pop3(); + $this->_protocol->connect($host, $port, $ssl); + $this->_protocol->login($params->user, $password); + } + + /** + * Close resource for mail lib. If you need to control, when the resource + * is closed. Otherwise the destructor would call this. + * + * @return null + */ + public function close() + { + $this->_protocol->logout(); + } + + /** + * Keep the server busy. + * + * @return null + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function noop() + { + return $this->_protocol->noop(); + } + + /** + * Remove a message from server. If you're doing that from a web enviroment + * you should be careful and use a uniqueid as parameter if possible to + * identify the message. + * + * @param int $id number of message + * @return null + * @throws Postman_Zend_Mail_Protocol_Exception + */ + public function removeMessage($id) + { + $this->_protocol->delete($id); + } + + /** + * get unique id for one or all messages + * + * if storage does not support unique ids it's the same as the message number + * + * @param int|null $id message number + * @return array|string message number for given message or all messages as array + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getUniqueId($id = null) + { + if (!$this->hasUniqueid) { + if ($id) { + return $id; + } + $count = $this->countMessages(); + if ($count < 1) { + return array(); + } + $range = range(1, $count); + return array_combine($range, $range); + } + + return $this->_protocol->uniqueid($id); + } + + /** + * get a message number from a unique id + * + * I.e. if you have a webmailer that supports deleting messages you should use unique ids + * as parameter and use this method to translate it to message number right before calling removeMessage() + * + * @param string $id unique id + * @return int message number + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function getNumberByUniqueId($id) + { + if (!$this->hasUniqueid) { + return $id; + } + + $ids = $this->getUniqueId(); + foreach ($ids as $k => $v) { + if ($v == $id) { + return $k; + } + } + + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('unique id not found'); + } + + /** + * Special handling for hasTop and hasUniqueid. The headers of the first message is + * retrieved if Top wasn't needed/tried yet. + * + * @see Postman_Zend_Mail_Storage_Abstract:__get() + * @param string $var + * @return string + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function __get($var) + { + $result = parent::__get($var); + if ($result !== null) { + return $result; + } + + if (strtolower($var) == 'hastop') { + if ($this->_protocol->hasTop === null) { + // need to make a real call, because not all server are honest in their capas + try { + $this->_protocol->top(1, 0, false); + } catch(Postman_Zend_Mail_Exception $e) { + // ignoring error + } + } + $this->_has['top'] = $this->_protocol->hasTop; + return $this->_protocol->hasTop; + } + + if (strtolower($var) == 'hasuniqueid') { + $id = null; + try { + $id = $this->_protocol->uniqueid(1); + } catch(Postman_Zend_Mail_Exception $e) { + // ignoring error + } + $this->_has['uniqueid'] = $id ? true : false; + return $this->_has['uniqueid']; + } + + return $result; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Writable/Interface.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Writable/Interface.php new file mode 100644 index 0000000..27ff498 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Storage/Writable/Interface.php @@ -0,0 +1,108 @@ +create) && isset($params->dirname) && !file_exists($params->dirname . DIRECTORY_SEPARATOR . 'cur')) { + self::initMaildir($params->dirname); + } + + parent::__construct($params); + } + + /** + * create a new folder + * + * This method also creates parent folders if necessary. Some mail storages may restrict, which folder + * may be used as parent or which chars may be used in the folder name + * + * @param string $name global name of folder, local name if $parentFolder is set + * @param string|Postman_Zend_Mail_Storage_Folder $parentFolder parent folder for new folder, else root folder is parent + * @return string only used internally (new created maildir) + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function createFolder($name, $parentFolder = null) + { + if ($parentFolder instanceof Postman_Zend_Mail_Storage_Folder) { + $folder = $parentFolder->getGlobalName() . $this->_delim . $name; + } else if ($parentFolder != null) { + $folder = rtrim($parentFolder, $this->_delim) . $this->_delim . $name; + } else { + $folder = $name; + } + + $folder = trim($folder, $this->_delim); + + // first we check if we try to create a folder that does exist + $exists = null; + try { + $exists = $this->getFolders($folder); + } catch (Postman_Zend_Mail_Exception $e) { + // ok + } + if ($exists) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('folder already exists'); + } + + if (strpos($folder, $this->_delim . $this->_delim) !== false) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('invalid name - folder parts may not be empty'); + } + + if (strpos($folder, 'INBOX' . $this->_delim) === 0) { + $folder = substr($folder, 6); + } + + $fulldir = $this->_rootdir . '.' . $folder; + + // check if we got tricked and would create a dir outside of the rootdir or not as direct child + if (strpos($folder, DIRECTORY_SEPARATOR) !== false || strpos($folder, '/') !== false + || dirname($fulldir) . DIRECTORY_SEPARATOR != $this->_rootdir) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('invalid name - no directory seprator allowed in folder name'); + } + + // has a parent folder? + $parent = null; + if (strpos($folder, $this->_delim)) { + // let's see if the parent folder exists + $parent = substr($folder, 0, strrpos($folder, $this->_delim)); + try { + $this->getFolders($parent); + } catch (Postman_Zend_Mail_Exception $e) { + // does not - create parent folder + $this->createFolder($parent); + } + } + + if (!@mkdir($fulldir) || !@mkdir($fulldir . DIRECTORY_SEPARATOR . 'cur')) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('error while creating new folder, may be created incompletly'); + } + + mkdir($fulldir . DIRECTORY_SEPARATOR . 'new'); + mkdir($fulldir . DIRECTORY_SEPARATOR . 'tmp'); + + $localName = $parent ? substr($folder, strlen($parent) + 1) : $folder; + $this->getFolders($parent)->$localName = new Postman_Zend_Mail_Storage_Folder($localName, $folder, true); + + return $fulldir; + } + + /** + * remove a folder + * + * @param string|Postman_Zend_Mail_Storage_Folder $name name or instance of folder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function removeFolder($name) + { + // TODO: This could fail in the middle of the task, which is not optimal. + // But there is no defined standard way to mark a folder as removed and there is no atomar fs-op + // to remove a directory. Also moving the folder to a/the trash folder is not possible, as + // all parent folders must be created. What we could do is add a dash to the front of the + // directory name and it should be ignored as long as other processes obey the standard. + + if ($name instanceof Postman_Zend_Mail_Storage_Folder) { + $name = $name->getGlobalName(); + } + + $name = trim($name, $this->_delim); + if (strpos($name, 'INBOX' . $this->_delim) === 0) { + $name = substr($name, 6); + } + + // check if folder exists and has no children + if (!$this->getFolders($name)->isLeaf()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('delete children first'); + } + + if ($name == 'INBOX' || $name == DIRECTORY_SEPARATOR || $name == '/') { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('wont delete INBOX'); + } + + if ($name == $this->getCurrentFolder()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('wont delete selected folder'); + } + + foreach (array('tmp', 'new', 'cur', '.') as $subdir) { + $dir = $this->_rootdir . '.' . $name . DIRECTORY_SEPARATOR . $subdir; + if (!file_exists($dir)) { + continue; + } + $dh = opendir($dir); + if (!$dh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("error opening $subdir"); + } + while (($entry = readdir($dh)) !== false) { + if ($entry == '.' || $entry == '..') { + continue; + } + if (!unlink($dir . DIRECTORY_SEPARATOR . $entry)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("error cleaning $subdir"); + } + } + closedir($dh); + if ($subdir !== '.') { + if (!rmdir($dir)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("error removing $subdir"); + } + } + } + + if (!rmdir($this->_rootdir . '.' . $name)) { + // at least we should try to make it a valid maildir again + mkdir($this->_rootdir . '.' . $name . DIRECTORY_SEPARATOR . 'cur'); + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("error removing maindir"); + } + + $parent = strpos($name, $this->_delim) ? substr($name, 0, strrpos($name, $this->_delim)) : null; + $localName = $parent ? substr($name, strlen($parent) + 1) : $name; + unset($this->getFolders($parent)->$localName); + } + + /** + * rename and/or move folder + * + * The new name has the same restrictions as in createFolder() + * + * @param string|Postman_Zend_Mail_Storage_Folder $oldName name or instance of folder + * @param string $newName new global name of folder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function renameFolder($oldName, $newName) + { + // TODO: This is also not atomar and has similar problems as removeFolder() + + if ($oldName instanceof Postman_Zend_Mail_Storage_Folder) { + $oldName = $oldName->getGlobalName(); + } + + $oldName = trim($oldName, $this->_delim); + if (strpos($oldName, 'INBOX' . $this->_delim) === 0) { + $oldName = substr($oldName, 6); + } + + $newName = trim($newName, $this->_delim); + if (strpos($newName, 'INBOX' . $this->_delim) === 0) { + $newName = substr($newName, 6); + } + + if (strpos($newName, $oldName . $this->_delim) === 0) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('new folder cannot be a child of old folder'); + } + + // check if folder exists and has no children + $folder = $this->getFolders($oldName); + + if ($oldName == 'INBOX' || $oldName == DIRECTORY_SEPARATOR || $oldName == '/') { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('wont rename INBOX'); + } + + if ($oldName == $this->getCurrentFolder()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('wont rename selected folder'); + } + + $newdir = $this->createFolder($newName); + + if (!$folder->isLeaf()) { + foreach ($folder as $k => $v) { + $this->renameFolder($v->getGlobalName(), $newName . $this->_delim . $k); + } + } + + $olddir = $this->_rootdir . '.' . $folder; + foreach (array('tmp', 'new', 'cur') as $subdir) { + $subdir = DIRECTORY_SEPARATOR . $subdir; + if (!file_exists($olddir . $subdir)) { + continue; + } + // using copy or moving files would be even better - but also much slower + if (!rename($olddir . $subdir, $newdir . $subdir)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('error while moving ' . $subdir); + } + } + // create a dummy if removing fails - otherwise we can't read it next time + mkdir($olddir . DIRECTORY_SEPARATOR . 'cur'); + $this->removeFolder($oldName); + } + + /** + * create a uniqueid for maildir filename + * + * This is nearly the format defined in the maildir standard. The microtime() call should already + * create a uniqueid, the pid is for multicore/-cpu machine that manage to call this function at the + * exact same time, and uname() gives us the hostname for multiple machines accessing the same storage. + * + * If someone disables posix we create a random number of the same size, so this method should also + * work on Windows - if you manage to get maildir working on Windows. + * Microtime could also be disabled, altough I've never seen it. + * + * @return string new uniqueid + */ + protected function _createUniqueId() + { + $id = ''; + $id .= function_exists('microtime') ? microtime(true) : (time() . ' ' . rand(0, 100000)); + $id .= '.' . (function_exists('posix_getpid') ? posix_getpid() : rand(50, 65535)); + $id .= '.' . php_uname('n'); + + return $id; + } + + /** + * open a temporary maildir file + * + * makes sure tmp/ exists and create a file with a unique name + * you should close the returned filehandle! + * + * @param string $folder name of current folder without leading . + * @return array array('dirname' => dir of maildir folder, 'uniq' => unique id, 'filename' => name of create file + * 'handle' => file opened for writing) + * @throws Postman_Zend_Mail_Storage_Exception + */ + protected function _createTmpFile($folder = 'INBOX') + { + if ($folder == 'INBOX') { + $tmpdir = $this->_rootdir . DIRECTORY_SEPARATOR . 'tmp' . DIRECTORY_SEPARATOR; + } else { + $tmpdir = $this->_rootdir . '.' . $folder . DIRECTORY_SEPARATOR . 'tmp' . DIRECTORY_SEPARATOR; + } + if (!file_exists($tmpdir)) { + if (!mkdir($tmpdir)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('problems creating tmp dir'); + } + } + + // we should retry to create a unique id if a file with the same name exists + // to avoid a script timeout we only wait 1 second (instead of 2) and stop + // after a defined retry count + // if you change this variable take into account that it can take up to $max_tries seconds + // normally we should have a valid unique name after the first try, we're just following the "standard" here + $max_tries = 5; + for ($i = 0; $i < $max_tries; ++$i) { + $uniq = $this->_createUniqueId(); + if (!file_exists($tmpdir . $uniq)) { + // here is the race condition! - as defined in the standard + // to avoid having a long time between stat()ing the file and creating it we're opening it here + // to mark the filename as taken + $fh = fopen($tmpdir . $uniq, 'w'); + if (!$fh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('could not open temp file'); + } + break; + } + sleep(1); + } + + if (!$fh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception("tried $max_tries unique ids for a temp file, but all were taken" + . ' - giving up'); + } + + return array('dirname' => $this->_rootdir . '.' . $folder, 'uniq' => $uniq, 'filename' => $tmpdir . $uniq, + 'handle' => $fh); + } + + /** + * create an info string for filenames with given flags + * + * @param array $flags wanted flags, with the reference you'll get the set flags with correct key (= char for flag) + * @return string info string for version 2 filenames including the leading colon + * @throws Postman_Zend_Mail_Storage_Exception + */ + protected function _getInfoString(&$flags) + { + // accessing keys is easier, faster and it removes duplicated flags + $wanted_flags = array_flip($flags); + if (isset($wanted_flags[Postman_Zend_Mail_Storage::FLAG_RECENT])) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('recent flag may not be set'); + } + + $info = ':2,'; + $flags = array(); + foreach (Postman_Zend_Mail_Storage_Maildir::$_knownFlags as $char => $flag) { + if (!isset($wanted_flags[$flag])) { + continue; + } + $info .= $char; + $flags[$char] = $flag; + unset($wanted_flags[$flag]); + } + + if (!empty($wanted_flags)) { + $wanted_flags = implode(', ', array_keys($wanted_flags)); + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('unknown flag(s): ' . $wanted_flags); + } + + return $info; + } + + /** + * append a new message to mail storage + * + * @param string|stream $message message as string or stream resource + * @param null|string|Postman_Zend_Mail_Storage_Folder $folder folder for new message, else current folder is taken + * @param null|array $flags set flags for new message, else a default set is used + * @param bool $recent handle this mail as if recent flag has been set, + * should only be used in delivery + * @throws Postman_Zend_Mail_Storage_Exception + */ + // not yet * @param string|Postman_Zend_Mail_Message|Postman_Zend_Mime_Message $message message as string or instance of message class + + public function appendMessage($message, $folder = null, $flags = null, $recent = false) + { + if ($this->_quota && $this->checkQuota()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('storage is over quota!'); + } + + if ($folder === null) { + $folder = $this->_currentFolder; + } + + if (!($folder instanceof Postman_Zend_Mail_Storage_Folder)) { + $folder = $this->getFolders($folder); + } + + if ($flags === null) { + $flags = array(Postman_Zend_Mail_Storage::FLAG_SEEN); + } + $info = $this->_getInfoString($flags); + $temp_file = $this->_createTmpFile($folder->getGlobalName()); + + // TODO: handle class instances for $message + if (is_resource($message) && get_resource_type($message) == 'stream') { + stream_copy_to_stream($message, $temp_file['handle']); + } else { + fputs($temp_file['handle'], $message); + } + fclose($temp_file['handle']); + + // we're adding the size to the filename for maildir++ + $size = filesize($temp_file['filename']); + if ($size !== false) { + $info = ',S=' . $size . $info; + } + $new_filename = $temp_file['dirname'] . DIRECTORY_SEPARATOR; + $new_filename .= $recent ? 'new' : 'cur'; + $new_filename .= DIRECTORY_SEPARATOR . $temp_file['uniq'] . $info; + + // we're throwing any exception after removing our temp file and saving it to this variable instead + $exception = null; + + if (!link($temp_file['filename'], $new_filename)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + $exception = new Postman_Zend_Mail_Storage_Exception('cannot link message file to final dir'); + } + @unlink($temp_file['filename']); + + if ($exception) { + throw $exception; + } + + $this->_files[] = array('uniq' => $temp_file['uniq'], + 'flags' => $flags, + 'filename' => $new_filename); + if ($this->_quota) { + $this->_addQuotaEntry((int)$size, 1); + } + } + + /** + * copy an existing message + * + * @param int $id number of message + * @param string|Postman_Zend_Mail_Storage_Folder $folder name or instance of targer folder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function copyMessage($id, $folder) + { + if ($this->_quota && $this->checkQuota()) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('storage is over quota!'); + } + + if (!($folder instanceof Postman_Zend_Mail_Storage_Folder)) { + $folder = $this->getFolders($folder); + } + + $filedata = $this->_getFileData($id); + $old_file = $filedata['filename']; + $flags = $filedata['flags']; + + // copied message can't be recent + while (($key = array_search(Postman_Zend_Mail_Storage::FLAG_RECENT, $flags)) !== false) { + unset($flags[$key]); + } + $info = $this->_getInfoString($flags); + + // we're creating the copy as temp file before moving to cur/ + $temp_file = $this->_createTmpFile($folder->getGlobalName()); + // we don't write directly to the file + fclose($temp_file['handle']); + + // we're adding the size to the filename for maildir++ + $size = filesize($old_file); + if ($size !== false) { + $info = ',S=' . $size . $info; + } + + $new_file = $temp_file['dirname'] . DIRECTORY_SEPARATOR . 'cur' . DIRECTORY_SEPARATOR . $temp_file['uniq'] . $info; + + // we're throwing any exception after removing our temp file and saving it to this variable instead + $exception = null; + + if (!copy($old_file, $temp_file['filename'])) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + $exception = new Postman_Zend_Mail_Storage_Exception('cannot copy message file'); + } else if (!link($temp_file['filename'], $new_file)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + $exception = new Postman_Zend_Mail_Storage_Exception('cannot link message file to final dir'); + } + @unlink($temp_file['filename']); + + if ($exception) { + throw $exception; + } + + if ($folder->getGlobalName() == $this->_currentFolder + || ($this->_currentFolder == 'INBOX' && $folder->getGlobalName() == '/')) { + $this->_files[] = array('uniq' => $temp_file['uniq'], + 'flags' => $flags, + 'filename' => $new_file); + } + + if ($this->_quota) { + $this->_addQuotaEntry((int)$size, 1); + } + } + + /** + * move an existing message + * + * @param int $id number of message + * @param string|Postman_Zend_Mail_Storage_Folder $folder name or instance of targer folder + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function moveMessage($id, $folder) { + if (!($folder instanceof Postman_Zend_Mail_Storage_Folder)) { + $folder = $this->getFolders($folder); + } + + if ($folder->getGlobalName() == $this->_currentFolder + || ($this->_currentFolder == 'INBOX' && $folder->getGlobalName() == '/')) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('target is current folder'); + } + + $filedata = $this->_getFileData($id); + $old_file = $filedata['filename']; + $flags = $filedata['flags']; + + // moved message can't be recent + while (($key = array_search(Postman_Zend_Mail_Storage::FLAG_RECENT, $flags)) !== false) { + unset($flags[$key]); + } + $info = $this->_getInfoString($flags); + + // reserving a new name + $temp_file = $this->_createTmpFile($folder->getGlobalName()); + fclose($temp_file['handle']); + + // we're adding the size to the filename for maildir++ + $size = filesize($old_file); + if ($size !== false) { + $info = ',S=' . $size . $info; + } + + $new_file = $temp_file['dirname'] . DIRECTORY_SEPARATOR . 'cur' . DIRECTORY_SEPARATOR . $temp_file['uniq'] . $info; + + // we're throwing any exception after removing our temp file and saving it to this variable instead + $exception = null; + + if (!rename($old_file, $new_file)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + $exception = new Postman_Zend_Mail_Storage_Exception('cannot move message file'); + } + @unlink($temp_file['filename']); + + if ($exception) { + throw $exception; + } + + unset($this->_files[$id - 1]); + // remove the gap + $this->_files = array_values($this->_files); + } + + + /** + * set flags for message + * + * NOTE: this method can't set the recent flag. + * + * @param int $id number of message + * @param array $flags new flags for message + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function setFlags($id, $flags) + { + $info = $this->_getInfoString($flags); + $filedata = $this->_getFileData($id); + + // NOTE: double dirname to make sure we always move to cur. if recent flag has been set (message is in new) it will be moved to cur. + $new_filename = dirname(dirname($filedata['filename'])) . DIRECTORY_SEPARATOR . 'cur' . DIRECTORY_SEPARATOR . "$filedata[uniq]$info"; + + if (!@rename($filedata['filename'], $new_filename)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot rename file'); + } + + $filedata['flags'] = $flags; + $filedata['filename'] = $new_filename; + + $this->_files[$id - 1] = $filedata; + } + + + /** + * stub for not supported message deletion + * + * @return null + * @throws Postman_Zend_Mail_Storage_Exception + */ + public function removeMessage($id) + { + $filename = $this->_getFileData($id, 'filename'); + + if ($this->_quota) { + $size = filesize($filename); + } + + if (!@unlink($filename)) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot remove message'); + } + unset($this->_files[$id - 1]); + // remove the gap + $this->_files = array_values($this->_files); + if ($this->_quota) { + $this->_addQuotaEntry(0 - (int)$size, -1); + } + } + + /** + * enable/disable quota and set a quota value if wanted or needed + * + * You can enable/disable quota with true/false. If you don't have + * a MDA or want to enforce a quota value you can also set this value + * here. Use array('size' => SIZE_QUOTA, 'count' => MAX_MESSAGE) do + * define your quota. Order of these fields does matter! + * + * @param bool|array $value new quota value + * @return null + */ + public function setQuota($value) { + $this->_quota = $value; + } + + /** + * get currently set quota + * + * @see Postman_Zend_Mail_Storage_Writable_Maildir::setQuota() + * + * @return bool|array + */ + public function getQuota($fromStorage = false) { + if ($fromStorage) { + $fh = @fopen($this->_rootdir . 'maildirsize', 'r'); + if (!$fh) { + /** + * @see Postman_Zend_Mail_Storage_Exception + */ + require_once 'Zend/Mail/Storage/Exception.php'; + throw new Postman_Zend_Mail_Storage_Exception('cannot open maildirsize'); + } + $definition = fgets($fh); + fclose($fh); + $definition = explode(',', trim($definition)); + $quota = array(); + foreach ($definition as $member) { + $key = $member[strlen($member) - 1]; + if ($key == 'S' || $key == 'C') { + $key = $key == 'C' ? 'count' : 'size'; + } + $quota[$key] = substr($member, 0, -1); + } + return $quota; + } + + return $this->_quota; + } + + /** + * @see http://www.inter7.com/courierimap/README.maildirquota.html "Calculating maildirsize" + */ + protected function _calculateMaildirsize() { + $timestamps = array(); + $messages = 0; + $total_size = 0; + + if (is_array($this->_quota)) { + $quota = $this->_quota; + } else { + try { + $quota = $this->getQuota(true); + } catch (Postman_Zend_Mail_Storage_Exception $e) { + throw new Postman_Zend_Mail_Storage_Exception('no quota definition found', 0, $e); + } + } + + $folders = new RecursiveIteratorIterator($this->getFolders(), RecursiveIteratorIterator::SELF_FIRST); + foreach ($folders as $folder) { + $subdir = $folder->getGlobalName(); + if ($subdir == 'INBOX') { + $subdir = ''; + } else { + $subdir = '.' . $subdir; + } + if ($subdir == 'Trash') { + continue; + } + + foreach (array('cur', 'new') as $subsubdir) { + $dirname = $this->_rootdir . $subdir . DIRECTORY_SEPARATOR . $subsubdir . DIRECTORY_SEPARATOR; + if (!file_exists($dirname)) { + continue; + } + // NOTE: we are using mtime instead of "the latest timestamp". The latest would be atime + // and as we are accessing the directory it would make the whole calculation useless. + $timestamps[$dirname] = filemtime($dirname); + + $dh = opendir($dirname); + // NOTE: Should have been checked in constructor. Not throwing an exception here, quotas will + // therefore not be fully enforeced, but next request will fail anyway, if problem persists. + if (!$dh) { + continue; + } + + + while (($entry = readdir()) !== false) { + if ($entry[0] == '.' || !is_file($dirname . $entry)) { + continue; + } + + if (strpos($entry, ',S=')) { + strtok($entry, '='); + $filesize = strtok(':'); + if (is_numeric($filesize)) { + $total_size += $filesize; + ++$messages; + continue; + } + } + $size = filesize($dirname . $entry); + if ($size === false) { + // ignore, as we assume file got removed + continue; + } + $total_size += $size; + ++$messages; + } + } + } + + $tmp = $this->_createTmpFile(); + $fh = $tmp['handle']; + $definition = array(); + foreach ($quota as $type => $value) { + if ($type == 'size' || $type == 'count') { + $type = $type == 'count' ? 'C' : 'S'; + } + $definition[] = $value . $type; + } + $definition = implode(',', $definition); + fputs($fh, "$definition\n"); + fputs($fh, "$total_size $messages\n"); + fclose($fh); + rename($tmp['filename'], $this->_rootdir . 'maildirsize'); + foreach ($timestamps as $dir => $timestamp) { + if ($timestamp < filemtime($dir)) { + unlink($this->_rootdir . 'maildirsize'); + break; + } + } + + return array('size' => $total_size, 'count' => $messages, 'quota' => $quota); + } + + /** + * @see http://www.inter7.com/courierimap/README.maildirquota.html "Calculating the quota for a Maildir++" + */ + protected function _calculateQuota($forceRecalc = false) { + $fh = null; + $total_size = 0; + $messages = 0; + $maildirsize = ''; + if (!$forceRecalc && file_exists($this->_rootdir . 'maildirsize') && filesize($this->_rootdir . 'maildirsize') < 5120) { + $fh = fopen($this->_rootdir . 'maildirsize', 'r'); + } + if ($fh) { + $maildirsize = fread($fh, 5120); + if (strlen($maildirsize) >= 5120) { + fclose($fh); + $fh = null; + $maildirsize = ''; + } + } + if (!$fh) { + $result = $this->_calculateMaildirsize(); + $total_size = $result['size']; + $messages = $result['count']; + $quota = $result['quota']; + } else { + $maildirsize = explode("\n", $maildirsize); + if (is_array($this->_quota)) { + $quota = $this->_quota; + } else { + $definition = explode(',', $maildirsize[0]); + $quota = array(); + foreach ($definition as $member) { + $key = $member[strlen($member) - 1]; + if ($key == 'S' || $key == 'C') { + $key = $key == 'C' ? 'count' : 'size'; + } + $quota[$key] = substr($member, 0, -1); + } + } + unset($maildirsize[0]); + foreach ($maildirsize as $line) { + list($size, $count) = explode(' ', trim($line)); + $total_size += $size; + $messages += $count; + } + } + + $over_quota = false; + $over_quota = $over_quota || (isset($quota['size']) && $total_size > $quota['size']); + $over_quota = $over_quota || (isset($quota['count']) && $messages > $quota['count']); + // NOTE: $maildirsize equals false if it wasn't set (AKA we recalculated) or it's only + // one line, because $maildirsize[0] gets unsetted. + // Also we're using local time to calculate the 15 minute offset. Touching a file just for known the + // local time of the file storage isn't worth the hassle. + if ($over_quota && ($maildirsize || filemtime($this->_rootdir . 'maildirsize') > time() - 900)) { + $result = $this->_calculateMaildirsize(); + $total_size = $result['size']; + $messages = $result['count']; + $quota = $result['quota']; + $over_quota = false; + $over_quota = $over_quota || (isset($quota['size']) && $total_size > $quota['size']); + $over_quota = $over_quota || (isset($quota['count']) && $messages > $quota['count']); + } + + if ($fh) { + // TODO is there a safe way to keep the handle open for writing? + fclose($fh); + } + + return array('size' => $total_size, 'count' => $messages, 'quota' => $quota, 'over_quota' => $over_quota); + } + + protected function _addQuotaEntry($size, $count = 1) { + if (!file_exists($this->_rootdir . 'maildirsize')) { + // TODO: should get file handler from _calculateQuota + } + $size = (int)$size; + $count = (int)$count; + file_put_contents($this->_rootdir . 'maildirsize', "$size $count\n", FILE_APPEND); + } + + /** + * check if storage is currently over quota + * + * @param bool $detailedResponse return known data of quota and current size and message count @see _calculateQuota() + * @return bool|array over quota state or detailed response + */ + public function checkQuota($detailedResponse = false, $forceRecalc = false) { + $result = $this->_calculateQuota($forceRecalc); + return $detailedResponse ? $result : $result['over_quota']; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Abstract.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Abstract.php new file mode 100644 index 0000000..791d422 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Abstract.php @@ -0,0 +1,350 @@ +_mail->getType(); + if (!$type) { + if ($this->_mail->hasAttachments) { + $type = Postman_Zend_Mime::MULTIPART_MIXED; + } elseif ($this->_mail->getBodyText() && $this->_mail->getBodyHtml() ) { + $type = Postman_Zend_Mime::MULTIPART_ALTERNATIVE; + } else { + $type = Postman_Zend_Mime::MULTIPART_MIXED; + } + } + + $this->_headers['Content-Type'] = array( + $type . ';' + . $this->EOL + . " " . 'boundary="' . $boundary . '"' + ); + $this->boundary = $boundary; + } + + $this->_headers['MIME-Version'] = array('1.0'); + + return $this->_headers; + } + + /** + * Prepend header name to header value + * + * @param string $item + * @param string $key + * @param string $prefix + * @static + * @access protected + * @return void + */ + protected static function _formatHeader(&$item, $key, $prefix) + { + $item = $prefix . ': ' . $item; + } + + /** + * Prepare header string for use in transport + * + * Prepares and generates {@link $header} based on the headers provided. + * + * @param mixed $headers + * @access protected + * @return void + * @throws Postman_Zend_Mail_Transport_Exception if any header lines exceed 998 + * characters + */ + protected function _prepareHeaders($headers) + { + if (!$this->_mail) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ + require_once 'Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('Missing Postman_Zend_Mail object in _mail property'); + } + + $this->header = ''; + + foreach ($headers as $header => $content) { + if (isset($content['append'])) { + unset($content['append']); + $value = implode(',' . $this->EOL . ' ', $content); + $this->header .= $header . ': ' . $value . $this->EOL; + } else { + array_walk($content, array(get_class($this), '_formatHeader'), $header); + $this->header .= implode($this->EOL, $content) . $this->EOL; + } + } + + // Sanity check on headers -- should not be > 998 characters + $sane = true; + foreach (explode($this->EOL, $this->header) as $line) { + if (strlen(trim($line)) > 998) { + $sane = false; + break; + } + } + if (!$sane) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ + require_once 'Exception.php'; + throw new Postman_Zend_Mail_Exception('At least one mail header line is too long'); + } + } + + /** + * Generate MIME compliant message from the current configuration + * + * If both a text and HTML body are present, generates a + * multipart/alternative Postman_Zend_Mime_Part containing the headers and contents + * of each. Otherwise, uses whichever of the text or HTML parts present. + * + * The content part is then prepended to the list of Postman_Zend_Mime_Parts for + * this message. + * + * @return void + */ + protected function _buildBody() + { + if (($text = $this->_mail->getBodyText()) + && ($html = $this->_mail->getBodyHtml())) + { + // Generate unique boundary for multipart/alternative + $mime = new Postman_Zend_Mime(null); + $boundaryLine = $mime->boundaryLine($this->EOL); + $boundaryEnd = $mime->mimeEnd($this->EOL); + + $text->disposition = false; + $html->disposition = false; + + $body = $boundaryLine + . $text->getHeaders($this->EOL) + . $this->EOL + . $text->getContent($this->EOL) + . $this->EOL + . $boundaryLine + . $html->getHeaders($this->EOL) + . $this->EOL + . $html->getContent($this->EOL) + . $this->EOL + . $boundaryEnd; + + $mp = new Postman_Zend_Mime_Part($body); + $mp->type = Postman_Zend_Mime::MULTIPART_ALTERNATIVE; + $mp->boundary = $mime->boundary(); + + $this->_isMultipart = true; + + // Ensure first part contains text alternatives + array_unshift($this->_parts, $mp); + + // Get headers + $this->_headers = $this->_mail->getHeaders(); + return; + } + + // If not multipart, then get the body + if (false !== ($body = $this->_mail->getBodyHtml())) { + array_unshift($this->_parts, $body); + } elseif (false !== ($body = $this->_mail->getBodyText())) { + array_unshift($this->_parts, $body); + } + + if (!$body) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ + require_once 'Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('No body specified'); + } + + // Get headers + $this->_headers = $this->_mail->getHeaders(); + $headers = $body->getHeadersArray($this->EOL); + foreach ($headers as $header) { + // Headers in Postman_Zend_Mime_Part are kept as arrays with two elements, a + // key and a value + $this->_headers[$header[0]] = array($header[1]); + } + } + + /** + * Send a mail using this transport + * + * @param Postman_Zend_Mail $mail + * @access public + * @return void + * @throws Postman_Zend_Mail_Transport_Exception if mail is empty + */ + public function send(Postman_Zend_Mail $mail) + { + $this->_isMultipart = false; + $this->_mail = $mail; + $this->_parts = $mail->getParts(); + $mime = $mail->getMime(); + + // Build body content + $this->_buildBody(); + + // Determine number of parts and boundary + $count = count($this->_parts); + $boundary = null; + if ($count < 1) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ + require_once 'Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('Empty mail cannot be sent'); + } + + if ($count > 1) { + // Multipart message; create new MIME object and boundary + $mime = new Postman_Zend_Mime($this->_mail->getMimeBoundary()); + $boundary = $mime->boundary(); + } elseif ($this->_isMultipart) { + // multipart/alternative -- grab boundary + $boundary = $this->_parts[0]->boundary; + } + + // Determine recipients, and prepare headers + $this->recipients = implode(',', $mail->getRecipients()); + $this->_prepareHeaders($this->_getHeaders($boundary)); + + // Create message body + // This is done so that the same Postman_Zend_Mail object can be used in + // multiple transports + $message = new Postman_Zend_Mime_Message(); + $message->setParts($this->_parts); + $message->setMime($mime); + $this->body = $message->generateMessage($this->EOL); + + // Send to transport! + $this->_sendMail(); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Exception.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Exception.php new file mode 100644 index 0000000..134abbf --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Exception.php @@ -0,0 +1,39 @@ +toArray(); + } elseif (!is_array($options)) { + $options = array(); + } + + // Making sure we have some defaults to work with + if (!isset($options['path'])) { + $options['path'] = sys_get_temp_dir(); + } + if (!isset($options['callback'])) { + $options['callback'] = array($this, 'defaultCallback'); + } + + $this->setOptions($options); + } + + /** + * Sets options + * + * @param array $options + * @return void + */ + public function setOptions(array $options) + { + if (isset($options['path']) && is_dir($options['path'])) { + $this->_path = $options['path']; + } + if (isset($options['callback']) && is_callable($options['callback'])) { + $this->_callback = $options['callback']; + } + } + + /** + * Saves e-mail message to a file + * + * @return void + * @throws Postman_Zend_Mail_Transport_Exception on not writable target directory + * @throws Postman_Zend_Mail_Transport_Exception on file_put_contents() failure + */ + protected function _sendMail() + { + $file = $this->_path . DIRECTORY_SEPARATOR . call_user_func($this->_callback, $this); + + if (!is_writable(dirname($file))) { + require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception(sprintf( + 'Target directory "%s" does not exist or is not writable', + dirname($file) + )); + } + + $email = $this->header . $this->EOL . $this->body; + + if (!file_put_contents($file, $email)) { + require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('Unable to send mail'); + } + } + + /** + * Default callback for generating filenames + * + * @param Postman_Zend_Mail_Transport_File File transport instance + * @return string + */ + public function defaultCallback($transport) + { + return 'ZendMail_' . $_SERVER['REQUEST_TIME'] . '_' . mt_rand() . '.tmp'; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Sendmail.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Sendmail.php new file mode 100644 index 0000000..0af1b2c --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Sendmail.php @@ -0,0 +1,220 @@ +toArray(); + } + + if (is_array($parameters)) { + $parameters = implode(' ', $parameters); + } + + $this->parameters = $parameters; + } + + + /** + * Send mail using PHP native mail() + * + * @access public + * @return void + * @throws Postman_Zend_Mail_Transport_Exception if parameters is set + * but not a string + * @throws Postman_Zend_Mail_Transport_Exception on mail() failure + */ + public function _sendMail() + { + if ($this->parameters === null) { + set_error_handler(array($this, '_handleMailErrors')); + $result = mail( + $this->recipients, + $this->_mail->getSubject(), + $this->body, + $this->header); + restore_error_handler(); + } else { + if(!is_string($this->parameters)) { + /** + * @see Postman_Zend_Mail_Transport_Exception + * + * Exception is thrown here because + * $parameters is a public property + */ +// require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception( + 'Parameters were set but are not a string' + ); + } + + set_error_handler(array($this, '_handleMailErrors')); + $result = mail( + $this->recipients, + $this->_mail->getSubject(), + $this->body, + $this->header, + $this->parameters); + restore_error_handler(); + } + + if ($this->_errstr !== null || !$result) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ +// require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('Unable to send mail. ' . $this->_errstr); + } + } + + + /** + * Format and fix headers + * + * mail() uses its $to and $subject arguments to set the To: and Subject: + * headers, respectively. This method strips those out as a sanity check to + * prevent duplicate header entries. + * + * @access protected + * @param array $headers + * @return void + * @throws Postman_Zend_Mail_Transport_Exception + */ + protected function _prepareHeaders($headers) + { + if (!$this->_mail) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ +// require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('_prepareHeaders requires a registered Postman_Zend_Mail object'); + } + + // mail() uses its $to parameter to set the To: header, and the $subject + // parameter to set the Subject: header. We need to strip them out. + if (0 === strpos(PHP_OS, 'WIN')) { + // If the current recipients list is empty, throw an error + if (empty($this->recipients)) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ +// require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('Missing To addresses'); + } + } else { + // All others, simply grab the recipients and unset the To: header + if (!isset($headers['To'])) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ +// require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('Missing To header'); + } + + unset($headers['To']['append']); + $this->recipients = implode(',', $headers['To']); + } + + // Remove recipient header + unset($headers['To']); + + // Remove subject header, if present + if (isset($headers['Subject'])) { + unset($headers['Subject']); + } + + // Prepare headers + parent::_prepareHeaders($headers); + + // Fix issue with empty blank line ontop when using Sendmail Trnasport + $this->header = rtrim($this->header); + } + + /** + * Temporary error handler for PHP native mail(). + * + * @param int $errno + * @param string $errstr + * @param string $errfile + * @param string $errline + * @param array $errcontext + * @return true + */ + public function _handleMailErrors($errno, $errstr, $errfile = null, $errline = null, array $errcontext = null) + { + $this->_errstr = $errstr; + return true; + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Smtp.php b/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Smtp.php new file mode 100644 index 0000000..42004a4 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mail/Transport/Smtp.php @@ -0,0 +1,247 @@ +_name = $config['name']; + } else { + $this->_name = PostmanUtils::getServerName(); + } + + if (isset($config['port'])) { + $this->_port = $config['port']; + } + + if (isset($config['auth'])) { + $this->_auth = $config['auth']; + } + + $this->_host = $host; + $this->_config = $config; + } + + + /** + * Class destructor to ensure all open connections are closed + * + * @return void + */ + public function __destruct() + { + if ($this->_connection instanceof Postman_Zend_Mail_Protocol_Smtp) { + try { + $this->_connection->quit(); + } catch (Postman_Zend_Mail_Protocol_Exception $e) { + // ignore + } + $this->_connection->disconnect(); + } + } + + + /** + * Sets the connection protocol instance + * + * @param Postman_Zend_Mail_Protocol_Abstract $client + * + * @return void + */ + public function setConnection(Postman_Zend_Mail_Protocol_Abstract $connection) + { + $this->_connection = $connection; + } + + + /** + * Gets the connection protocol instance + * + * @return Postman_Zend_Mail_Protocol|null + */ + public function getConnection() + { + return $this->_connection; + } + + /** + * Send an email via the SMTP connection protocol + * + * The connection via the protocol adapter is made just-in-time to allow a + * developer to add a custom adapter if required before mail is sent. + * + * @return void + * @todo Rename this to sendMail, it's a public method... + */ + public function _sendMail() + { + // If sending multiple messages per session use existing adapter + if (!($this->_connection instanceof Postman_Zend_Mail_Protocol_Smtp)) { + // Check if authentication is required and determine required class + $connectionClass = 'Postman_Zend_Mail_Protocol_Smtp'; + if ($this->_auth) { + $connectionClass .= '_Auth_' . ucwords($this->_auth); + } + if (!class_exists($connectionClass)) { +// require_once 'Zend/Loader.php'; +// Postman_Zend_Loader::loadClass($connectionClass); + } + $this->setConnection(new $connectionClass($this->_host, $this->_port, $this->_config)); + $this->_connection->connect(); + $this->_connection->helo($this->_name); + } else { + // Reset connection to ensure reliable transaction + $this->_connection->rset(); + } + + // Set sender email address + $this->_connection->mail($this->_mail->getReturnPath()); + + // Set recipient forward paths + foreach ($this->_mail->getRecipients() as $recipient) { + $this->_connection->rcpt($recipient); + } + + // Issue DATA command to client + $this->_connection->data($this->header . Postman_Zend_Mime::LINEEND . $this->body); + } + + /** + * Format and fix headers + * + * Some SMTP servers do not strip BCC headers. Most clients do it themselves as do we. + * + * @access protected + * @param array $headers + * @return void + * @throws Postman_Zend_Transport_Exception + */ + protected function _prepareHeaders($headers) + { + if (!$this->_mail) { + /** + * @see Postman_Zend_Mail_Transport_Exception + */ +// require_once 'Zend/Mail/Transport/Exception.php'; + throw new Postman_Zend_Mail_Transport_Exception('_prepareHeaders requires a registered Postman_Zend_Mail object'); + } + + unset($headers['Bcc']); + + // Prepare headers + parent::_prepareHeaders($headers); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mime.php b/Postman/Postman-Mail/Zend-1.12.10/Mime.php new file mode 100644 index 0000000..9e0fa8c --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mime.php @@ -0,0 +1,670 @@ + 0) { + $ptr = strlen($str); + if ($ptr > $lineLength) { + $ptr = $lineLength; + } + + // Ensure we are not splitting across an encoded character + $pos = strrpos(substr($str, 0, $ptr), '='); + if ($pos !== false && $pos >= $ptr - 2) { + $ptr = $pos; + } + + // Check if there is a space at the end of the line and rewind + if ($ptr > 0 && $str[$ptr - 1] == ' ') { + --$ptr; + } + + // Add string and continue + $out .= substr($str, 0, $ptr) . '=' . $lineEnd; + $str = substr($str, $ptr); + } + + $out = rtrim($out, $lineEnd); + $out = rtrim($out, '='); + + return $out; + } + + /** + * Converts a string into quoted printable format. + * + * @param string $str + * @return string + */ + private static function _encodeQuotedPrintable($str) + { + $str = str_replace('=', '=3D', $str); + $str = str_replace(self::$qpKeys, self::$qpReplaceValues, $str); + $str = rtrim($str); + + return $str; + } + + /** + * Encode a given string with the QUOTED_PRINTABLE mechanism for Mail Headers. + * + * Mail headers depend on an extended quoted printable algorithm otherwise + * a range of bugs can occur. + * + * @param string $str + * @param string $charset + * @param int $lineLength Line length; defaults to {@link LINELENGTH} + * @param string $lineEnd Line end; defaults to {@link LINEEND} + * @return string + */ + public static function encodeQuotedPrintableHeader( + $str, $charset, $lineLength = self::LINELENGTH, $lineEnd = self::LINEEND + ) + { + // Reduce line-length by the length of the required delimiter, charsets and encoding + $prefix = sprintf('=?%s?Q?', $charset); + $lineLength = $lineLength - strlen($prefix) - 3; + + $str = self::_encodeQuotedPrintable($str); + + // Mail-Header required chars have to be encoded also: + $str = str_replace( + array('?', ' ', '_', ','), array('=3F', '=20', '=5F', '=2C'), $str + ); + + // initialize first line, we need it anyways + $lines = array(0 => ""); + + // Split encoded text into separate lines + $tmp = ""; + while (strlen($str) > 0) { + $currentLine = max(count($lines) - 1, 0); + $token = self::getNextQuotedPrintableToken($str); + $str = substr($str, strlen($token)); + + $tmp .= $token; + if ($token == '=20') { + // only if we have a single char token or space, we can append the + // tempstring it to the current line or start a new line if necessary. + if (strlen($lines[$currentLine] . $tmp) > $lineLength) { + $lines[$currentLine + 1] = $tmp; + } else { + $lines[$currentLine] .= $tmp; + } + $tmp = ""; + } + // don't forget to append the rest to the last line + if (strlen($str) == 0) { + $lines[$currentLine] .= $tmp; + } + } + + // assemble the lines together by pre- and appending delimiters, charset, encoding. + for ($i = 0; $i < count($lines); $i++) { + $lines[$i] = " " . $prefix . $lines[$i] . "?="; + } + $str = trim(implode($lineEnd, $lines)); + + return $str; + } + + /** + * Retrieves the first token from a quoted printable string. + * + * @param string $str + * @return string + */ + private static function getNextQuotedPrintableToken($str) + { + if (substr($str, 0, 1) == "=") { + $token = substr($str, 0, 3); + } else { + $token = substr($str, 0, 1); + } + + return $token; + } + + /** + * Encode a given string in mail header compatible base64 encoding. + * + * @param string $str + * @param string $charset + * @param int $lineLength Line length; defaults to {@link LINELENGTH} + * @param string $lineEnd Line end; defaults to {@link LINEEND} + * @return string + */ + public static function encodeBase64Header( + $str, $charset, $lineLength = self::LINELENGTH, $lineEnd = self::LINEEND + ) + { + $prefix = '=?' . $charset . '?B?'; + $suffix = '?='; + $remainingLength = $lineLength - strlen($prefix) - strlen($suffix); + + $encodedValue = self::encodeBase64($str, $remainingLength, $lineEnd); + $encodedValue = str_replace( + $lineEnd, $suffix . $lineEnd . ' ' . $prefix, $encodedValue + ); + $encodedValue = $prefix . $encodedValue . $suffix; + + return $encodedValue; + } + + /** + * Encode a given string in base64 encoding and break lines + * according to the maximum linelength. + * + * @param string $str + * @param int $lineLength Line length; defaults to {@link LINELENGTH} + * @param string $lineEnd Line end; defaults to {@link LINEEND} + * @return string + */ + public static function encodeBase64( + $str, $lineLength = self::LINELENGTH, $lineEnd = self::LINEEND + ) + { + return rtrim(chunk_split(base64_encode($str), $lineLength, $lineEnd)); + } + + /** + * Constructor + * + * @param null|string $boundary + */ + public function __construct($boundary = null) + { + // This string needs to be somewhat unique + if ($boundary === null) { + $this->_boundary = '=_' . md5(microtime(1) . self::$makeUnique++); + } else { + $this->_boundary = $boundary; + } + } + + /** + * Encode the given string with the given encoding. + * + * @param string $str + * @param string $encoding + * @param string $EOL Line end; defaults to {@link Postman_Zend_Mime::LINEEND} + * @return string + */ + public static function encode($str, $encoding, $EOL = self::LINEEND) + { + switch ($encoding) { + case self::ENCODING_BASE64: + return self::encodeBase64($str, self::LINELENGTH, $EOL); + + case self::ENCODING_QUOTEDPRINTABLE: + return self::encodeQuotedPrintable($str, self::LINELENGTH, $EOL); + + default: + /** + * @todo 7Bit and 8Bit is currently handled the same way. + */ + return $str; + } + } + + /** + * Return a MIME boundary + * + * @access public + * @return string + */ + public function boundary() + { + return $this->_boundary; + } + + /** + * Return a MIME boundary line + * + * @param string $EOL Line end; defaults to {@link LINEEND} + * @return string + */ + public function boundaryLine($EOL = self::LINEEND) + { + return $EOL . '--' . $this->_boundary . $EOL; + } + + /** + * Return MIME ending + * + * @param string $EOL Line end; defaults to {@link LINEEND} + * @return string + */ + public function mimeEnd($EOL = self::LINEEND) + { + return $EOL . '--' . $this->_boundary . '--' . $EOL; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mime/Decode.php b/Postman/Postman-Mail/Zend-1.12.10/Mime/Decode.php new file mode 100644 index 0000000..5fd17bd --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mime/Decode.php @@ -0,0 +1,276 @@ + array(name => value), 'body' => content), null if no parts found + * @throws Postman_Zend_Exception + */ + public static function splitMessageStruct( + $message, $boundary, $EOL = Postman_Zend_Mime::LINEEND + ) + { + $parts = self::splitMime($message, $boundary); + if (count($parts) <= 0) { + return null; + } + $result = array(); + foreach ($parts as $part) { + self::splitMessage($part, $headers, $body, $EOL); + $result[] = array( + 'header' => $headers, + 'body' => $body + ); + } + + return $result; + } + + /** + * split a message in header and body part, if no header or an + * invalid header is found $headers is empty + * + * The charset of the returned headers depend on your iconv settings. + * + * @param string $message raw message with header and optional content + * @param array $headers output param, array with headers as array(name => value) + * @param string $body output param, content of message + * @param string $EOL EOL string; defaults to {@link Postman_Zend_Mime::LINEEND} + * @return null + */ + public static function splitMessage( + $message, &$headers, &$body, $EOL = Postman_Zend_Mime::LINEEND + ) + { + // check for valid header at first line + $firstline = strtok($message, "\n"); + if (!preg_match('%^[^\s]+[^:]*:%', $firstline)) { + $headers = array(); + // TODO: we're ignoring \r for now - is this function fast enough and is it safe to asume noone needs \r? + $body = str_replace( + array( + "\r", + "\n" + ), array( + '', + $EOL + ), $message + ); + + return; + } + + // find an empty line between headers and body + // default is set new line + if (strpos($message, $EOL . $EOL)) { + list($headers, $body) = explode($EOL . $EOL, $message, 2); + // next is the standard new line + } else { + if ($EOL != "\r\n" && strpos($message, "\r\n\r\n")) { + list($headers, $body) = explode("\r\n\r\n", $message, 2); + // next is the other "standard" new line + } else { + if ($EOL != "\n" && strpos($message, "\n\n")) { + list($headers, $body) = explode("\n\n", $message, 2); + // at last resort find anything that looks like a new line + } else { + @list($headers, $body) = + @preg_split("%([\r\n]+)\\1%U", $message, 2); + } + } + } + + $headers = iconv_mime_decode_headers( + $headers, ICONV_MIME_DECODE_CONTINUE_ON_ERROR + ); + + if ($headers === false) { + // an error occurs during the decoding + return; + } + + // normalize header names + foreach ($headers as $name => $header) { + $lower = strtolower($name); + if ($lower == $name) { + continue; + } + unset($headers[$name]); + if (!isset($headers[$lower])) { + $headers[$lower] = $header; + continue; + } + if (is_array($headers[$lower])) { + $headers[$lower][] = $header; + continue; + } + $headers[$lower] = array( + $headers[$lower], + $header + ); + } + } + + /** + * split a content type in its different parts + * + * @param string $type content-type + * @param string $wantedPart the wanted part, else an array with all parts is returned + * @return string|array wanted part or all parts as array('type' => content-type, partname => value) + */ + public static function splitContentType($type, $wantedPart = null) + { + return self::splitHeaderField($type, $wantedPart, 'type'); + } + + /** + * split a header field like content type in its different parts + * + * @param string $field + * @param string $wantedPart the wanted part, else an array with all parts is returned + * @param int|string $firstName key name for the first part + * @throws Postman_Zend_Exception + * @return string|array wanted part or all parts as array($firstName => firstPart, partname => value) + */ + public static function splitHeaderField( + $field, $wantedPart = null, $firstName = 0 + ) + { + $wantedPart = strtolower($wantedPart); + $firstName = strtolower($firstName); + + // special case - a bit optimized + if ($firstName === $wantedPart) { + $field = strtok($field, ';'); + + return $field[0] == '"' ? substr($field, 1, -1) : $field; + } + + $field = $firstName . '=' . $field; + if (!preg_match_all('%([^=\s]+)\s*=\s*("[^"]+"|[^;]+)(;\s*|$)%', $field, $matches)) { + throw new Postman_Zend_Exception('not a valid header field'); + } + + if ($wantedPart) { + foreach ($matches[1] as $key => $name) { + if (strcasecmp($name, $wantedPart)) { + continue; + } + if ($matches[2][$key][0] != '"') { + return $matches[2][$key]; + } + + return substr($matches[2][$key], 1, -1); + } + + return null; + } + + $split = array(); + foreach ($matches[1] as $key => $name) { + $name = strtolower($name); + if ($matches[2][$key][0] == '"') { + $split[$name] = substr($matches[2][$key], 1, -1); + } else { + $split[$name] = $matches[2][$key]; + } + } + + return $split; + } + + /** + * decode a quoted printable encoded string + * + * The charset of the returned string depends on your iconv settings. + * + * @param string $string Encoded string + * @return string Decoded string + */ + public static function decodeQuotedPrintable($string) + { + return quoted_printable_decode($string); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mime/Exception.php b/Postman/Postman-Mail/Zend-1.12.10/Mime/Exception.php new file mode 100644 index 0000000..e8f3b00 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mime/Exception.php @@ -0,0 +1,36 @@ +_parts; + } + + /** + * Sets the given array of Postman_Zend_Mime_Parts as the array for the message + * + * @param array $parts + */ + public function setParts($parts) + { + $this->_parts = $parts; + } + + /** + * Append a new Postman_Zend_Mime_Part to the current message + * + * @param Postman_Zend_Mime_Part $part + */ + public function addPart(Postman_Zend_Mime_Part $part) + { + /** + * @todo check for duplicate object handle + */ + $this->_parts[] = $part; + } + + /** + * Check if message needs to be sent as multipart + * MIME message or if it has only one part. + * + * @return boolean + */ + public function isMultiPart() + { + return (count($this->_parts) > 1); + } + + /** + * Set Postman_Zend_Mime object for the message + * + * This can be used to set the boundary specifically or to use a subclass of + * Postman_Zend_Mime for generating the boundary. + * + * @param Postman_Zend_Mime $mime + */ + public function setMime(Postman_Zend_Mime $mime) + { + $this->_mime = $mime; + } + + /** + * Returns the Postman_Zend_Mime object in use by the message + * + * If the object was not present, it is created and returned. Can be used to + * determine the boundary used in this message. + * + * @return Postman_Zend_Mime + */ + public function getMime() + { + if ($this->_mime === null) { + $this->_mime = new Postman_Zend_Mime(); + } + + return $this->_mime; + } + + /** + * Generate MIME-compliant message from the current configuration + * + * This can be a multipart message if more than one MIME part was added. If + * only one part is present, the content of this part is returned. If no + * part had been added, an empty string is returned. + * + * Parts are seperated by the mime boundary as defined in Postman_Zend_Mime. If + * {@link setMime()} has been called before this method, the Postman_Zend_Mime + * object set by this call will be used. Otherwise, a new Postman_Zend_Mime object + * is generated and used. + * + * @param string $EOL EOL string; defaults to {@link Postman_Zend_Mime::LINEEND} + * @return string + */ + public function generateMessage($EOL = Postman_Zend_Mime::LINEEND) + { + if (!$this->isMultiPart()) { + $body = array_shift($this->_parts); + $body = $body->getContent($EOL); + } else { + $mime = $this->getMime(); + + $boundaryLine = $mime->boundaryLine($EOL); + $body = 'This is a message in Mime Format. If you see this, ' + . "your mail reader does not support this format." . $EOL; + + foreach (array_keys($this->_parts) as $p) { + $body .= $boundaryLine + . $this->getPartHeaders($p, $EOL) + . $EOL + . $this->getPartContent($p, $EOL); + } + + $body .= $mime->mimeEnd($EOL); + } + + return trim($body); + } + + /** + * Get the headers of a given part as an array + * + * @param int $partnum + * @return array + */ + public function getPartHeadersArray($partnum) + { + return $this->_parts[$partnum]->getHeadersArray(); + } + + /** + * Get the headers of a given part as a string + * + * @param int $partnum + * @param string $EOL + * @return string + */ + public function getPartHeaders($partnum, $EOL = Postman_Zend_Mime::LINEEND) + { + return $this->_parts[$partnum]->getHeaders($EOL); + } + + /** + * Get the (encoded) content of a given part as a string + * + * @param int $partnum + * @param string $EOL + * @return string + */ + public function getPartContent($partnum, $EOL = Postman_Zend_Mime::LINEEND) + { + return $this->_parts[$partnum]->getContent($EOL); + } + + /** + * Explode MIME multipart string into seperate parts + * + * Parts consist of the header and the body of each MIME part. + * + * @param string $body + * @param string $boundary + * @throws Postman_Zend_Exception + * @return array + */ + protected static function _disassembleMime($body, $boundary) + { + $start = 0; + $res = array(); + // find every mime part limiter and cut out the + // string before it. + // the part before the first boundary string is discarded: + $p = strpos($body, '--' . $boundary . "\n", $start); + if ($p === false) { + // no parts found! + return array(); + } + + // position after first boundary line + $start = $p + 3 + strlen($boundary); + + while (($p = strpos($body, '--' . $boundary . "\n", $start)) + !== false) { + $res[] = substr($body, $start, $p - $start); + $start = $p + 3 + strlen($boundary); + } + + // no more parts, find end boundary + $p = strpos($body, '--' . $boundary . '--', $start); + if ($p === false) { + throw new Postman_Zend_Exception('Not a valid Mime Message: End Missing'); + } + + // the remaining part also needs to be parsed: + $res[] = substr($body, $start, $p - $start); + + return $res; + } + + /** + * Decodes a MIME encoded string and returns a Postman_Zend_Mime_Message object with + * all the MIME parts set according to the given string + * + * @param string $message + * @param string $boundary + * @param string $EOL EOL string; defaults to {@link Postman_Zend_Mime::LINEEND} + * @throws Postman_Zend_Exception + * @return Postman_Zend_Mime_Message + */ + public static function createFromMessage( + $message, $boundary, $EOL = Postman_Zend_Mime::LINEEND + ) + { + require_once 'Zend/Mime/Decode.php'; + $parts = Postman_Zend_Mime_Decode::splitMessageStruct($message, $boundary, $EOL); + + $res = new self(); + foreach ($parts as $part) { + // now we build a new MimePart for the current Message Part: + $newPart = new Postman_Zend_Mime_Part($part['body']); + foreach ($part['header'] as $key => $value) { + /** + * @todo check for characterset and filename + */ + switch (strtolower($key)) { + case 'content-type': + $newPart->type = $value; + break; + case 'content-transfer-encoding': + $newPart->encoding = $value; + break; + case 'content-id': + $newPart->id = trim($value, '<>'); + break; + case 'content-disposition': + $newPart->disposition = $value; + break; + case 'content-description': + $newPart->description = $value; + break; + case 'content-location': + $newPart->location = $value; + break; + case 'content-language': + $newPart->language = $value; + break; + default: + throw new Postman_Zend_Exception( + 'Unknown header ignored for MimePart:' . $key + ); + } + } + $res->addPart($newPart); + } + + return $res; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mime/Part.php b/Postman/Postman-Mail/Zend-1.12.10/Mime/Part.php new file mode 100644 index 0000000..9051c28 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Mime/Part.php @@ -0,0 +1,333 @@ +_content = $content; + if (is_resource($content)) { + $this->_isStream = true; + } + } + + /** + * @todo setters/getters + * @todo error checking for setting $type + * @todo error checking for setting $encoding + */ + + /** + * check if this part can be read as a stream. + * if true, getEncodedStream can be called, otherwise + * only getContent can be used to fetch the encoded + * content of the part + * + * @return bool + */ + public function isStream() + { + return $this->_isStream; + } + + /** + * if this was created with a stream, return a filtered stream for + * reading the content. very useful for large file attachments. + * + * @return mixed Stream + * @throws Postman_Zend_Mime_Exception if not a stream or unable to append filter + */ + public function getEncodedStream() + { + if (!$this->_isStream) { + require_once 'Zend/Mime/Exception.php'; + throw new Postman_Zend_Mime_Exception( + 'Attempt to get a stream from a string part' + ); + } + + //stream_filter_remove(); // ??? is that right? + switch ($this->encoding) { + case Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE: + $filter = stream_filter_append( + $this->_content, + 'convert.quoted-printable-encode', + STREAM_FILTER_READ, + array( + 'line-length' => 76, + 'line-break-chars' => Postman_Zend_Mime::LINEEND + ) + ); + if (!is_resource($filter)) { + require_once 'Zend/Mime/Exception.php'; + throw new Postman_Zend_Mime_Exception( + 'Failed to append quoted-printable filter' + ); + } + break; + + case Postman_Zend_Mime::ENCODING_BASE64: + $filter = stream_filter_append( + $this->_content, + 'convert.base64-encode', + STREAM_FILTER_READ, + array( + 'line-length' => 76, + 'line-break-chars' => Postman_Zend_Mime::LINEEND + ) + ); + if (!is_resource($filter)) { + require_once 'Zend/Mime/Exception.php'; + throw new Postman_Zend_Mime_Exception( + 'Failed to append base64 filter' + ); + } + break; + + default: + } + + return $this->_content; + } + + /** + * Get the Content of the current Mime Part in the given encoding. + * + * @param string $EOL Line end; defaults to {@link Postman_Zend_Mime::LINEEND} + * @throws Postman_Zend_Mime_Exception + * @return string + */ + public function getContent($EOL = Postman_Zend_Mime::LINEEND) + { + if ($this->_isStream) { + return stream_get_contents($this->getEncodedStream()); + } else { + return Postman_Zend_Mime::encode($this->_content, $this->encoding, $EOL); + } + } + + /** + * Get the RAW unencoded content from this part + * + * @return string + */ + public function getRawContent() + { + if ($this->_isStream) { + return stream_get_contents($this->_content); + } else { + return $this->_content; + } + } + + /** + * Create and return the array of headers for this MIME part + * + * @param string $EOL Line end; defaults to {@link Postman_Zend_Mime::LINEEND} + * @return array + */ + public function getHeadersArray($EOL = Postman_Zend_Mime::LINEEND) + { + $headers = array(); + + $contentType = $this->type; + if ($this->charset) { + $contentType .= '; charset=' . $this->charset; + } + + if ($this->boundary) { + $contentType .= ';' . $EOL + . " boundary=\"" . $this->boundary . '"'; + } + + $headers[] = array( + 'Content-Type', + $contentType + ); + + if ($this->encoding) { + $headers[] = array( + 'Content-Transfer-Encoding', + $this->encoding + ); + } + + if ($this->id) { + $headers[] = array( + 'Content-ID', + '<' . $this->id . '>' + ); + } + + if ($this->disposition) { + $disposition = $this->disposition; + if ($this->filename) { + $disposition .= '; filename="' . $this->filename . '"'; + } + $headers[] = array( + 'Content-Disposition', + $disposition + ); + } + + if ($this->description) { + $headers[] = array( + 'Content-Description', + $this->description + ); + } + + if ($this->location) { + $headers[] = array( + 'Content-Location', + $this->location + ); + } + + if ($this->language) { + $headers[] = array( + 'Content-Language', + $this->language + ); + } + + return $headers; + } + + /** + * Return the headers for this part as a string + * + * @param string $EOL Line end; defaults to {@link Postman_Zend_Mime::LINEEND} + * @return string + */ + public function getHeaders($EOL = Postman_Zend_Mime::LINEEND) + { + $res = ''; + foreach ($this->getHeadersArray($EOL) as $header) { + $res .= $header[0] . ': ' . $header[1] . $EOL; + } + + return $res; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Registry.php b/Postman/Postman-Mail/Zend-1.12.10/Registry.php new file mode 100644 index 0000000..1506700 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Registry.php @@ -0,0 +1,209 @@ +offsetExists($index)) { + require_once 'Zend/Exception.php'; + throw new Postman_Zend_Exception("No entry is registered for key '$index'"); + } + + return $instance->offsetGet($index); + } + + /** + * setter method, basically same as offsetSet(). + * + * This method can be called from an object of type Postman_Zend_Registry, or it + * can be called statically. In the latter case, it uses the default + * static instance stored in the class. + * + * @param string $index The location in the ArrayObject in which to store + * the value. + * @param mixed $value The object to store in the ArrayObject. + * @return void + */ + public static function set($index, $value) + { + $instance = self::getInstance(); + $instance->offsetSet($index, $value); + } + + /** + * Returns TRUE if the $index is a named value in the registry, + * or FALSE if $index was not found in the registry. + * + * @param string $index + * @return boolean + */ + public static function isRegistered($index) + { + if (self::$_registry === null) { + return false; + } + return self::$_registry->offsetExists($index); + } + + /** + * Constructs a parent ArrayObject with default + * ARRAY_AS_PROPS to allow acces as an object + * + * @param array $array data array + * @param integer $flags ArrayObject flags + */ + public function __construct($array = array(), $flags = parent::ARRAY_AS_PROPS) + { + parent::__construct($array, $flags); + } + + /** + * @param string $index + * @returns mixed + * + * Workaround for http://bugs.php.net/bug.php?id=40442 (ZF-960). + */ + public function offsetExists($index) + { + return array_key_exists($index, $this); + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate.php b/Postman/Postman-Mail/Zend-1.12.10/Validate.php new file mode 100644 index 0000000..44b67bf --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate.php @@ -0,0 +1,290 @@ +_validators[] = array( + 'instance' => $validator, + 'breakChainOnFailure' => (boolean) $breakChainOnFailure + ); + return $this; + } + + /** + * Returns true if and only if $value passes all validations in the chain + * + * Validators are run in the order in which they were added to the chain (FIFO). + * + * @param mixed $value + * @return boolean + */ + public function isValid($value) + { + $this->_messages = array(); + $this->_errors = array(); + $result = true; + foreach ($this->_validators as $element) { + $validator = $element['instance']; + if ($validator->isValid($value)) { + continue; + } + $result = false; + $messages = $validator->getMessages(); + $this->_messages = array_merge($this->_messages, $messages); + $this->_errors = array_merge($this->_errors, array_keys($messages)); + if ($element['breakChainOnFailure']) { + break; + } + } + return $result; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns array of validation failure messages + * + * @return array + */ + public function getMessages() + { + return $this->_messages; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns array of validation failure message codes + * + * @return array + * @deprecated Since 1.5.0 + */ + public function getErrors() + { + return $this->_errors; + } + + /** + * Returns the set default namespaces + * + * @return array + */ + public static function getDefaultNamespaces() + { + return self::$_defaultNamespaces; + } + + /** + * Sets new default namespaces + * + * @param array|string $namespace + * @return null + */ + public static function setDefaultNamespaces($namespace) + { + if (!is_array($namespace)) { + $namespace = array((string) $namespace); + } + + self::$_defaultNamespaces = $namespace; + } + + /** + * Adds a new default namespace + * + * @param array|string $namespace + * @return null + */ + public static function addDefaultNamespaces($namespace) + { + if (!is_array($namespace)) { + $namespace = array((string) $namespace); + } + + self::$_defaultNamespaces = array_unique(array_merge(self::$_defaultNamespaces, $namespace)); + } + + /** + * Returns true when defaultNamespaces are set + * + * @return boolean + */ + public static function hasDefaultNamespaces() + { + return (!empty(self::$_defaultNamespaces)); + } + + /** + * @param mixed $value + * @param string $classBaseName + * @param array $args OPTIONAL + * @param mixed $namespaces OPTIONAL + * @return boolean + * @throws Postman_Zend_Validate_Exception + */ + public static function is($value, $classBaseName, array $args = array(), $namespaces = array()) + { + $namespaces = array_merge((array) $namespaces, self::$_defaultNamespaces, array('Postman_Zend_Validate')); + $className = ucfirst($classBaseName); + try { + if (!class_exists($className, false)) { + require_once 'Zend/Loader.php'; + foreach($namespaces as $namespace) { + $class = $namespace . '_' . $className; + $file = str_replace('_', DIRECTORY_SEPARATOR, $class) . '.php'; + if (Postman_Zend_Loader::isReadable($file)) { + Postman_Zend_Loader::loadClass($class); + $className = $class; + break; + } + } + } + + $class = new ReflectionClass($className); + if ($class->implementsInterface('Postman_Zend_Validate_Interface')) { + if ($class->hasMethod('__construct')) { + $keys = array_keys($args); + $numeric = false; + foreach($keys as $key) { + if (is_numeric($key)) { + $numeric = true; + break; + } + } + + if ($numeric) { + $object = $class->newInstanceArgs($args); + } else { + $object = $class->newInstance($args); + } + } else { + $object = $class->newInstance(); + } + + return $object->isValid($value); + } + } catch (Postman_Zend_Validate_Exception $ze) { + // if there is an exception while validating throw it + throw $ze; + } catch (Exception $e) { + // fallthrough and continue for missing validation classes + } + + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Validate class not found from basename '$classBaseName'"); + } + + /** + * Returns the maximum allowed message length + * + * @return integer + */ + public static function getMessageLength() + { + require_once 'Zend/Validate/Abstract.php'; + return Postman_Zend_Validate_Abstract::getMessageLength(); + } + + /** + * Sets the maximum allowed message length + * + * @param integer $length + */ + public static function setMessageLength($length = -1) + { + require_once 'Zend/Validate/Abstract.php'; + Postman_Zend_Validate_Abstract::setMessageLength($length); + } + + /** + * Returns the default translation object + * + * @return Postman_Zend_Translate_Adapter|null + */ + public static function getDefaultTranslator($translator = null) + { + require_once 'Zend/Validate/Abstract.php'; + return Postman_Zend_Validate_Abstract::getDefaultTranslator(); + } + + /** + * Sets a default translation object for all validation objects + * + * @param Postman_Zend_Translate|Postman_Zend_Translate_Adapter|null $translator + */ + public static function setDefaultTranslator($translator = null) + { + require_once 'Zend/Validate/Abstract.php'; + Postman_Zend_Validate_Abstract::setDefaultTranslator($translator); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Abstract.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Abstract.php new file mode 100644 index 0000000..bda7066 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Abstract.php @@ -0,0 +1,483 @@ +_messages; + } + + /** + * Returns an array of the names of variables that are used in constructing validation failure messages + * + * @return array + */ + public function getMessageVariables() + { + return array_keys($this->_messageVariables); + } + + /** + * Returns the message templates from the validator + * + * @return array + */ + public function getMessageTemplates() + { + return $this->_messageTemplates; + } + + /** + * Sets the validation failure message template for a particular key + * + * @param string $messageString + * @param string $messageKey OPTIONAL + * @return Postman_Zend_Validate_Abstract Provides a fluent interface + * @throws Postman_Zend_Validate_Exception + */ + public function setMessage($messageString, $messageKey = null) + { + if ($messageKey === null) { + $keys = array_keys($this->_messageTemplates); + foreach($keys as $key) { + $this->setMessage($messageString, $key); + } + return $this; + } + + if (!isset($this->_messageTemplates[$messageKey])) { +// require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("No message template exists for key '$messageKey'"); + } + + $this->_messageTemplates[$messageKey] = $messageString; + return $this; + } + + /** + * Sets validation failure message templates given as an array, where the array keys are the message keys, + * and the array values are the message template strings. + * + * @param array $messages + * @return Postman_Zend_Validate_Abstract + */ + public function setMessages(array $messages) + { + foreach ($messages as $key => $message) { + $this->setMessage($message, $key); + } + return $this; + } + + /** + * Magic function returns the value of the requested property, if and only if it is the value or a + * message variable. + * + * @param string $property + * @return mixed + * @throws Postman_Zend_Validate_Exception + */ + public function __get($property) + { + if ($property == 'value') { + return $this->_value; + } + if (array_key_exists($property, $this->_messageVariables)) { + return $this->{$this->_messageVariables[$property]}; + } + /** + * @see Postman_Zend_Validate_Exception + */ +// require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("No property exists by the name '$property'"); + } + + /** + * Constructs and returns a validation failure message with the given message key and value. + * + * Returns null if and only if $messageKey does not correspond to an existing template. + * + * If a translator is available and a translation exists for $messageKey, + * the translation will be used. + * + * @param string $messageKey + * @param string $value + * @return string + */ + protected function _createMessage($messageKey, $value) + { + if (!isset($this->_messageTemplates[$messageKey])) { + return null; + } + + $message = $this->_messageTemplates[$messageKey]; + + if (null !== ($translator = $this->getTranslator())) { + if ($translator->isTranslated($messageKey)) { + $message = $translator->translate($messageKey); + } else { + $message = $translator->translate($message); + } + } + + if (is_object($value)) { + if (!in_array('__toString', get_class_methods($value))) { + $value = get_class($value) . ' object'; + } else { + $value = $value->__toString(); + } + } elseif (is_array($value)) { + $value = $this->_implodeRecursive($value); + } else { + $value = implode((array) $value); + } + + if ($this->getObscureValue()) { + $value = str_repeat('*', strlen($value)); + } + + $message = str_replace('%value%', $value, $message); + foreach ($this->_messageVariables as $ident => $property) { + $message = str_replace( + "%$ident%", + implode(' ', (array) $this->$property), + $message + ); + } + + $length = self::getMessageLength(); + if (($length > -1) && (strlen($message) > $length)) { + $message = substr($message, 0, (self::getMessageLength() - 3)) . '...'; + } + + return $message; + } + + /** + * Joins elements of a multidimensional array + * + * @param array $pieces + * @return string + */ + protected function _implodeRecursive(array $pieces) + { + $values = array(); + foreach ($pieces as $item) { + if (is_array($item)) { + $values[] = $this->_implodeRecursive($item); + } else { + $values[] = $item; + } + } + + return implode(', ', $values); + } + + /** + * @param string $messageKey + * @param string $value OPTIONAL + * @return void + */ + protected function _error($messageKey, $value = null) + { + if ($messageKey === null) { + $keys = array_keys($this->_messageTemplates); + $messageKey = current($keys); + } + if ($value === null) { + $value = $this->_value; + } + $this->_errors[] = $messageKey; + $this->_messages[$messageKey] = $this->_createMessage($messageKey, $value); + } + + /** + * Sets the value to be validated and clears the messages and errors arrays + * + * @param mixed $value + * @return void + */ + protected function _setValue($value) + { + $this->_value = $value; + $this->_messages = array(); + $this->_errors = array(); + } + + /** + * Returns array of validation failure message codes + * + * @return array + * @deprecated Since 1.5.0 + */ + public function getErrors() + { + return $this->_errors; + } + + /** + * Set flag indicating whether or not value should be obfuscated in messages + * + * @param bool $flag + * @return Postman_Zend_Validate_Abstract + */ + public function setObscureValue($flag) + { + $this->_obscureValue = (bool) $flag; + return $this; + } + + /** + * Retrieve flag indicating whether or not value should be obfuscated in + * messages + * + * @return bool + */ + public function getObscureValue() + { + return $this->_obscureValue; + } + + /** + * Set translation object + * + * @param Postman_Zend_Translate|Postman_Zend_Translate_Adapter|null $translator + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_Abstract + */ + public function setTranslator($translator = null) + { + if ((null === $translator) || ($translator instanceof Postman_Zend_Translate_Adapter)) { + $this->_translator = $translator; + } elseif ($translator instanceof Postman_Zend_Translate) { + $this->_translator = $translator->getAdapter(); + } else { +// require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Invalid translator specified'); + } + return $this; + } + + /** + * Return translation object + * + * @return Postman_Zend_Translate_Adapter|null + */ + public function getTranslator() + { + if ($this->translatorIsDisabled()) { + return null; + } + + if (null === $this->_translator) { + return self::getDefaultTranslator(); + } + + return $this->_translator; + } + + /** + * Does this validator have its own specific translator? + * + * @return bool + */ + public function hasTranslator() + { + return (bool)$this->_translator; + } + + /** + * Set default translation object for all validate objects + * + * @param Postman_Zend_Translate|Postman_Zend_Translate_Adapter|null $translator + * @throws Postman_Zend_Validate_Exception + */ + public static function setDefaultTranslator($translator = null) + { + if ((null === $translator) || ($translator instanceof Postman_Zend_Translate_Adapter)) { + self::$_defaultTranslator = $translator; + } elseif ($translator instanceof Postman_Zend_Translate) { + self::$_defaultTranslator = $translator->getAdapter(); + } else { +// require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Invalid translator specified'); + } + } + + /** + * Get default translation object for all validate objects + * + * @return Postman_Zend_Translate_Adapter|null + */ + public static function getDefaultTranslator() + { + if (null === self::$_defaultTranslator) { +// require_once 'Zend/Registry.php'; + if (Postman_Zend_Registry::isRegistered('Postman_Zend_Translate')) { + $translator = Postman_Zend_Registry::get('Postman_Zend_Translate'); + if ($translator instanceof Postman_Zend_Translate_Adapter) { + return $translator; + } elseif ($translator instanceof Postman_Zend_Translate) { + return $translator->getAdapter(); + } + } + } + + return self::$_defaultTranslator; + } + + /** + * Is there a default translation object set? + * + * @return boolean + */ + public static function hasDefaultTranslator() + { + return (bool)self::$_defaultTranslator; + } + + /** + * Indicate whether or not translation should be disabled + * + * @param bool $flag + * @return Postman_Zend_Validate_Abstract + */ + public function setDisableTranslator($flag) + { + $this->_translatorDisabled = (bool) $flag; + return $this; + } + + /** + * Is translation disabled? + * + * @return bool + */ + public function translatorIsDisabled() + { + return $this->_translatorDisabled; + } + + /** + * Returns the maximum allowed message length + * + * @return integer + */ + public static function getMessageLength() + { + return self::$_messageLength; + } + + /** + * Sets the maximum allowed message length + * + * @param integer $length + */ + public static function setMessageLength($length = -1) + { + self::$_messageLength = $length; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Alnum.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Alnum.php new file mode 100644 index 0000000..fa59cdf --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Alnum.php @@ -0,0 +1,149 @@ + "Invalid type given. String, integer or float expected", + self::NOT_ALNUM => "'%value%' contains characters which are non alphabetic and no digits", + self::STRING_EMPTY => "'%value%' is an empty string", + ); + + /** + * Sets default option values for this instance + * + * @param boolean|Postman_Zend_Config $allowWhiteSpace + */ + public function __construct($allowWhiteSpace = false) + { + if ($allowWhiteSpace instanceof Postman_Zend_Config) { + $allowWhiteSpace = $allowWhiteSpace->toArray(); + } + + if (is_array($allowWhiteSpace)) { + if (array_key_exists('allowWhiteSpace', $allowWhiteSpace)) { + $allowWhiteSpace = $allowWhiteSpace['allowWhiteSpace']; + } else { + $allowWhiteSpace = false; + } + } + + $this->allowWhiteSpace = (boolean) $allowWhiteSpace; + } + + /** + * Returns the allowWhiteSpace option + * + * @return boolean + */ + public function getAllowWhiteSpace() + { + return $this->allowWhiteSpace; + } + + /** + * Sets the allowWhiteSpace option + * + * @param boolean $allowWhiteSpace + * @return Postman_Zend_Filter_Alnum Provides a fluent interface + */ + public function setAllowWhiteSpace($allowWhiteSpace) + { + $this->allowWhiteSpace = (boolean) $allowWhiteSpace; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value contains only alphabetic and digit characters + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value) && !is_int($value) && !is_float($value)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue($value); + + if ('' === $value) { + $this->_error(self::STRING_EMPTY); + return false; + } + + if (null === self::$_filter) { + /** + * @see Postman_Zend_Filter_Alnum + */ + require_once 'Zend/Filter/Alnum.php'; + self::$_filter = new Postman_Zend_Filter_Alnum(); + } + + self::$_filter->allowWhiteSpace = $this->allowWhiteSpace; + + if ($value != self::$_filter->filter($value)) { + $this->_error(self::NOT_ALNUM); + return false; + } + + return true; + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Alpha.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Alpha.php new file mode 100644 index 0000000..fe73a93 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Alpha.php @@ -0,0 +1,149 @@ + "Invalid type given. String expected", + self::NOT_ALPHA => "'%value%' contains non alphabetic characters", + self::STRING_EMPTY => "'%value%' is an empty string" + ); + + /** + * Sets default option values for this instance + * + * @param boolean|Postman_Zend_Config $allowWhiteSpace + */ + public function __construct($allowWhiteSpace = false) + { + if ($allowWhiteSpace instanceof Postman_Zend_Config) { + $allowWhiteSpace = $allowWhiteSpace->toArray(); + } + + if (is_array($allowWhiteSpace)) { + if (array_key_exists('allowWhiteSpace', $allowWhiteSpace)) { + $allowWhiteSpace = $allowWhiteSpace['allowWhiteSpace']; + } else { + $allowWhiteSpace = false; + } + } + + $this->allowWhiteSpace = (boolean) $allowWhiteSpace; + } + + /** + * Returns the allowWhiteSpace option + * + * @return boolean + */ + public function getAllowWhiteSpace() + { + return $this->allowWhiteSpace; + } + + /** + * Sets the allowWhiteSpace option + * + * @param boolean $allowWhiteSpace + * @return Postman_Zend_Filter_Alpha Provides a fluent interface + */ + public function setAllowWhiteSpace($allowWhiteSpace) + { + $this->allowWhiteSpace = (boolean) $allowWhiteSpace; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value contains only alphabetic characters + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue($value); + + if ('' === $value) { + $this->_error(self::STRING_EMPTY); + return false; + } + + if (null === self::$_filter) { + /** + * @see Postman_Zend_Filter_Alpha + */ + require_once 'Zend/Filter/Alpha.php'; + self::$_filter = new Postman_Zend_Filter_Alpha(); + } + + self::$_filter->allowWhiteSpace = $this->allowWhiteSpace; + + if ($value !== self::$_filter->filter($value)) { + $this->_error(self::NOT_ALPHA); + return false; + } + + return true; + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Barcode.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Barcode.php new file mode 100644 index 0000000..2f9fe21 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Barcode.php @@ -0,0 +1,227 @@ + "'%value%' failed checksum validation", + self::INVALID_CHARS => "'%value%' contains invalid characters", + self::INVALID_LENGTH => "'%value%' should have a length of %length% characters", + self::INVALID => "Invalid type given. String expected", + ); + + /** + * Additional variables available for validation failure messages + * + * @var array + */ + protected $_messageVariables = array( + 'length' => '_length' + ); + + /** + * Length for the set subtype + * + * @var integer + */ + protected $_length; + + /** + * Barcode adapter + * + * @var Postman_Zend_Validate_Barcode_BarcodeAdapter + */ + protected $_adapter; + + /** + * Generates the standard validator object + * + * @param string|Postman_Zend_Config| + * Postman_Zend_Validate_Barcode_BarcodeAdapter $adapter Barcode adapter to use + * @throws Postman_Zend_Validate_Exception + */ + public function __construct($adapter) + { + if ($adapter instanceof Postman_Zend_Config) { + $adapter = $adapter->toArray(); + } + + $options = null; + $checksum = null; + if (is_array($adapter)) { + if (array_key_exists('options', $adapter)) { + $options = $adapter['options']; + } + + if (array_key_exists('checksum', $adapter)) { + $checksum = $adapter['checksum']; + } + + if (array_key_exists('adapter', $adapter)) { + $adapter = $adapter['adapter']; + } else { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Missing option 'adapter'"); + } + } + + $this->setAdapter($adapter, $options); + if ($checksum !== null) { + $this->setChecksum($checksum); + } + } + + /** + * Returns the set adapter + * + * @return Postman_Zend_Validate_Barcode_BarcodeAdapter + */ + public function getAdapter() + { + return $this->_adapter; + } + + /** + * Sets a new barcode adapter + * + * @param string|Postman_Zend_Validate_Barcode $adapter Barcode adapter to use + * @param array $options Options for this adapter + * @return $this + * @throws Postman_Zend_Validate_Exception + */ + public function setAdapter($adapter, $options = null) + { + $adapter = ucfirst(strtolower($adapter)); + require_once 'Zend/Loader.php'; + if (Postman_Zend_Loader::isReadable('Zend/Validate/Barcode/' . $adapter. '.php')) { + $adapter = 'Postman_Zend_Validate_Barcode_' . $adapter; + } + + if (!class_exists($adapter)) { + Postman_Zend_Loader::loadClass($adapter); + } + + $this->_adapter = new $adapter($options); + if (!$this->_adapter instanceof Postman_Zend_Validate_Barcode_AdapterInterface) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception( + "Adapter " . $adapter . " does not implement Postman_Zend_Validate_Barcode_AdapterInterface" + ); + } + + return $this; + } + + /** + * Returns the checksum option + * + * @return boolean + */ + public function getChecksum() + { + return $this->getAdapter()->getCheck(); + } + + /** + * Sets the checksum option + * + * @param boolean $checksum + * @return Postman_Zend_Validate_Barcode + */ + public function setChecksum($checksum) + { + $this->getAdapter()->setCheck($checksum); + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value contains a valid barcode + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue($value); + $adapter = $this->getAdapter(); + $this->_length = $adapter->getLength(); + $result = $adapter->checkLength($value); + if (!$result) { + if (is_array($this->_length)) { + $temp = $this->_length; + $this->_length = ""; + foreach($temp as $length) { + $this->_length .= "/"; + $this->_length .= $length; + } + + $this->_length = substr($this->_length, 1); + } + + $this->_error(self::INVALID_LENGTH); + return false; + } + + $result = $adapter->checkChars($value); + if (!$result) { + $this->_error(self::INVALID_CHARS); + return false; + } + + if ($this->getChecksum()) { + $result = $adapter->checksum($value); + if (!$result) { + $this->_error(self::FAILED); + return false; + } + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Between.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Between.php new file mode 100644 index 0000000..8f5aa55 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Between.php @@ -0,0 +1,224 @@ + "'%value%' is not between '%min%' and '%max%', inclusively", + self::NOT_BETWEEN_STRICT => "'%value%' is not strictly between '%min%' and '%max%'" + ); + + /** + * Additional variables available for validation failure messages + * + * @var array + */ + protected $_messageVariables = array( + 'min' => '_min', + 'max' => '_max' + ); + + /** + * Minimum value + * + * @var mixed + */ + protected $_min; + + /** + * Maximum value + * + * @var mixed + */ + protected $_max; + + /** + * Whether to do inclusive comparisons, allowing equivalence to min and/or max + * + * If false, then strict comparisons are done, and the value may equal neither + * the min nor max options + * + * @var boolean + */ + protected $_inclusive; + + /** + * Sets validator options + * Accepts the following option keys: + * 'min' => scalar, minimum border + * 'max' => scalar, maximum border + * 'inclusive' => boolean, inclusive border values + * + * @param array|Postman_Zend_Config $options + * @throws Postman_Zend_Validate_Exception + */ + public function __construct($options) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } else if (!is_array($options)) { + $options = func_get_args(); + $temp['min'] = array_shift($options); + if (!empty($options)) { + $temp['max'] = array_shift($options); + } + + if (!empty($options)) { + $temp['inclusive'] = array_shift($options); + } + + $options = $temp; + } + + if (!array_key_exists('min', $options) || !array_key_exists('max', $options)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Missing option. 'min' and 'max' has to be given"); + } + + if (!array_key_exists('inclusive', $options)) { + $options['inclusive'] = true; + } + + $this->setMin($options['min']) + ->setMax($options['max']) + ->setInclusive($options['inclusive']); + } + + /** + * Returns the min option + * + * @return mixed + */ + public function getMin() + { + return $this->_min; + } + + /** + * Sets the min option + * + * @param mixed $min + * @return Postman_Zend_Validate_Between Provides a fluent interface + */ + public function setMin($min) + { + $this->_min = $min; + return $this; + } + + /** + * Returns the max option + * + * @return mixed + */ + public function getMax() + { + return $this->_max; + } + + /** + * Sets the max option + * + * @param mixed $max + * @return Postman_Zend_Validate_Between Provides a fluent interface + */ + public function setMax($max) + { + $this->_max = $max; + return $this; + } + + /** + * Returns the inclusive option + * + * @return boolean + */ + public function getInclusive() + { + return $this->_inclusive; + } + + /** + * Sets the inclusive option + * + * @param boolean $inclusive + * @return Postman_Zend_Validate_Between Provides a fluent interface + */ + public function setInclusive($inclusive) + { + $this->_inclusive = $inclusive; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is between min and max options, inclusively + * if inclusive option is true. + * + * @param mixed $value + * @return boolean + */ + public function isValid($value) + { + $this->_setValue($value); + + if ($this->_inclusive) { + if ($this->_min > $value || $value > $this->_max) { + $this->_error(self::NOT_BETWEEN); + return false; + } + } else { + if ($this->_min >= $value || $value >= $this->_max) { + $this->_error(self::NOT_BETWEEN_STRICT); + return false; + } + } + return true; + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Callback.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Callback.php new file mode 100644 index 0000000..636efca --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Callback.php @@ -0,0 +1,173 @@ + "'%value%' is not valid", + self::INVALID_CALLBACK => "An exception has been raised within the callback", + ); + + /** + * Callback in a call_user_func format + * + * @var string|array + */ + protected $_callback = null; + + /** + * Default options to set for the filter + * + * @var mixed + */ + protected $_options = array(); + + /** + * Sets validator options + * + * @param mixed $callback + * @throws Postman_Zend_Validate_Exception + */ + public function __construct($callback = null) + { + if (is_callable($callback)) { + $this->setCallback($callback); + } elseif (is_array($callback)) { + if (isset($callback['callback'])) { + $this->setCallback($callback['callback']); + } + if (isset($callback['options'])) { + $this->setOptions($callback['options']); + } + } + + if (null === ($initializedCallack = $this->getCallback())) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('No callback registered'); + } + } + + /** + * Returns the set callback + * + * @return mixed + */ + public function getCallback() + { + return $this->_callback; + } + + /** + * Sets the callback + * + * @param string|array $callback + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_Callback Provides a fluent interface + */ + public function setCallback($callback) + { + if (!is_callable($callback)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Invalid callback given'); + } + $this->_callback = $callback; + return $this; + } + + /** + * Returns the set options for the callback + * + * @return mixed + */ + public function getOptions() + { + return $this->_options; + } + + /** + * Sets options for the callback + * + * @param mixed $options + * @return Postman_Zend_Validate_Callback Provides a fluent interface + */ + public function setOptions($options) + { + $this->_options = (array) $options; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if the set callback returns + * for the provided $value + * + * @param mixed $value + * @return boolean + */ + public function isValid($value) + { + $this->_setValue($value); + + $options = $this->getOptions(); + $callback = $this->getCallback(); + $args = func_get_args(); + $options = array_merge($args, $options); + + try { + if (!call_user_func_array($callback, $options)) { + $this->_error(self::INVALID_VALUE); + return false; + } + } catch (Exception $e) { + $this->_error(self::INVALID_CALLBACK); + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Ccnum.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Ccnum.php new file mode 100644 index 0000000..e3ad1e5 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Ccnum.php @@ -0,0 +1,112 @@ + "'%value%' must contain between 13 and 19 digits", + self::CHECKSUM => "Luhn algorithm (mod-10 checksum) failed on '%value%'" + ); + + public function __construct() + { + trigger_error('Using the Ccnum validator is deprecated in favor of the CreditCard validator'); + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value follows the Luhn algorithm (mod-10 checksum) + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + $this->_setValue($value); + + if (null === self::$_filter) { + /** + * @see Postman_Zend_Filter_Digits + */ + require_once 'Zend/Filter/Digits.php'; + self::$_filter = new Postman_Zend_Filter_Digits(); + } + + $valueFiltered = self::$_filter->filter($value); + + $length = strlen($valueFiltered); + + if ($length < 13 || $length > 19) { + $this->_error(self::LENGTH); + return false; + } + + $sum = 0; + $weight = 2; + + for ($i = $length - 2; $i >= 0; $i--) { + $digit = $weight * $valueFiltered[$i]; + $sum += floor($digit / 10) + $digit % 10; + $weight = $weight % 2 + 1; + } + + if ((10 - $sum % 10) % 10 != $valueFiltered[$length - 1]) { + $this->_error(self::CHECKSUM, $valueFiltered); + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/CreditCard.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/CreditCard.php new file mode 100644 index 0000000..a77e2a6 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/CreditCard.php @@ -0,0 +1,319 @@ + "'%value%' seems to contain an invalid checksum", + self::CONTENT => "'%value%' must contain only digits", + self::INVALID => "Invalid type given. String expected", + self::LENGTH => "'%value%' contains an invalid amount of digits", + self::PREFIX => "'%value%' is not from an allowed institute", + self::SERVICE => "'%value%' seems to be an invalid creditcard number", + self::SERVICEFAILURE => "An exception has been raised while validating '%value%'", + ); + + /** + * List of allowed CCV lengths + * + * @var array + */ + protected $_cardLength = array( + self::AMERICAN_EXPRESS => array(15), + self::DINERS_CLUB => array(14), + self::DINERS_CLUB_US => array(16), + self::DISCOVER => array(16), + self::JCB => array(16), + self::LASER => array(16, 17, 18, 19), + self::MAESTRO => array(12, 13, 14, 15, 16, 17, 18, 19), + self::MASTERCARD => array(16), + self::SOLO => array(16, 18, 19), + self::UNIONPAY => array(16, 17, 18, 19), + self::VISA => array(16), + ); + + /** + * List of accepted CCV provider tags + * + * @var array + */ + protected $_cardType = array( + self::AMERICAN_EXPRESS => array('34', '37'), + self::DINERS_CLUB => array('300', '301', '302', '303', '304', '305', '36'), + self::DINERS_CLUB_US => array('54', '55'), + self::DISCOVER => array('6011', '622126', '622127', '622128', '622129', '62213', + '62214', '62215', '62216', '62217', '62218', '62219', + '6222', '6223', '6224', '6225', '6226', '6227', '6228', + '62290', '62291', '622920', '622921', '622922', '622923', + '622924', '622925', '644', '645', '646', '647', '648', + '649', '65'), + self::JCB => array('3528', '3529', '353', '354', '355', '356', '357', '358'), + self::LASER => array('6304', '6706', '6771', '6709'), + self::MAESTRO => array('5018', '5020', '5038', '6304', '6759', '6761', '6763'), + self::MASTERCARD => array('51', '52', '53', '54', '55'), + self::SOLO => array('6334', '6767'), + self::UNIONPAY => array('622126', '622127', '622128', '622129', '62213', '62214', + '62215', '62216', '62217', '62218', '62219', '6222', '6223', + '6224', '6225', '6226', '6227', '6228', '62290', '62291', + '622920', '622921', '622922', '622923', '622924', '622925'), + self::VISA => array('4'), + ); + + /** + * CCIs which are accepted by validation + * + * @var array + */ + protected $_type = array(); + + /** + * Service callback for additional validation + * + * @var callback + */ + protected $_service; + + /** + * Constructor + * + * @param string|array|Postman_Zend_Config $options OPTIONAL Type of CCI to allow + */ + public function __construct($options = array()) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } else if (!is_array($options)) { + $options = func_get_args(); + $temp['type'] = array_shift($options); + if (!empty($options)) { + $temp['service'] = array_shift($options); + } + + $options = $temp; + } + + if (!array_key_exists('type', $options)) { + $options['type'] = self::ALL; + } + + $this->setType($options['type']); + if (array_key_exists('service', $options)) { + $this->setService($options['service']); + } + } + + /** + * Returns a list of accepted CCIs + * + * @return array + */ + public function getType() + { + return $this->_type; + } + + /** + * Sets CCIs which are accepted by validation + * + * @param string|array $type Type to allow for validation + * @return Postman_Zend_Validate_CreditCard Provides a fluent interface + */ + public function setType($type) + { + $this->_type = array(); + return $this->addType($type); + } + + /** + * Adds a CCI to be accepted by validation + * + * @param string|array $type Type to allow for validation + * @return Postman_Zend_Validate_CreditCard Provides a fluent interface + */ + public function addType($type) + { + if (is_string($type)) { + $type = array($type); + } + + foreach($type as $typ) { + if (defined('self::' . strtoupper($typ)) && !in_array($typ, $this->_type)) { + $this->_type[] = $typ; + } + + if (($typ == self::ALL)) { + $this->_type = array_keys($this->_cardLength); + } + } + + return $this; + } + + /** + * Returns the actual set service + * + * @return callback + */ + public function getService() + { + return $this->_service; + } + + /** + * Sets a new callback for service validation + * + * @param mixed $service + * @throws Postman_Zend_Validate_Exception + * @return $this + */ + public function setService($service) + { + if (!is_callable($service)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Invalid callback given'); + } + + $this->_service = $service; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value follows the Luhn algorithm (mod-10 checksum) + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + $this->_setValue($value); + + if (!is_string($value)) { + $this->_error(self::INVALID, $value); + return false; + } + + if (!ctype_digit($value)) { + $this->_error(self::CONTENT, $value); + return false; + } + + $length = strlen($value); + $types = $this->getType(); + $foundp = false; + $foundl = false; + foreach ($types as $type) { + foreach ($this->_cardType[$type] as $prefix) { + if (substr($value, 0, strlen($prefix)) == $prefix) { + $foundp = true; + if (in_array($length, $this->_cardLength[$type])) { + $foundl = true; + break 2; + } + } + } + } + + if ($foundp == false){ + $this->_error(self::PREFIX, $value); + return false; + } + + if ($foundl == false) { + $this->_error(self::LENGTH, $value); + return false; + } + + $sum = 0; + $weight = 2; + + for ($i = $length - 2; $i >= 0; $i--) { + $digit = $weight * $value[$i]; + $sum += floor($digit / 10) + $digit % 10; + $weight = $weight % 2 + 1; + } + + if ((10 - $sum % 10) % 10 != $value[$length - 1]) { + $this->_error(self::CHECKSUM, $value); + return false; + } + + if (!empty($this->_service)) { + try { + require_once 'Zend/Validate/Callback.php'; + $callback = new Postman_Zend_Validate_Callback($this->_service); + $callback->setOptions($this->_type); + if (!$callback->isValid($value)) { + $this->_error(self::SERVICE, $value); + return false; + } + } catch (Postman_Zend_Exception $e) { + $this->_error(self::SERVICEFAILURE, $value); + return false; + } + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Date.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Date.php new file mode 100644 index 0000000..fb42ab5 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Date.php @@ -0,0 +1,258 @@ + "Invalid type given. String, integer, array or Postman_Zend_Date expected", + self::INVALID_DATE => "'%value%' does not appear to be a valid date", + self::FALSEFORMAT => "'%value%' does not fit the date format '%format%'", + ); + + /** + * @var array + */ + protected $_messageVariables = array( + 'format' => '_format' + ); + + /** + * Optional format + * + * @var string|null + */ + protected $_format; + + /** + * Optional locale + * + * @var string|Postman_Zend_Locale|null + */ + protected $_locale; + + /** + * Sets validator options + * + * @param string|array|Postman_Zend_Config $options OPTIONAL + */ + public function __construct($options = array()) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } else if (!is_array($options)) { + $options = func_get_args(); + $temp['format'] = array_shift($options); + if (!empty($options)) { + $temp['locale'] = array_shift($options); + } + + $options = $temp; + } + + if (array_key_exists('format', $options)) { + $this->setFormat($options['format']); + } + + if (!array_key_exists('locale', $options)) { + require_once 'Zend/Registry.php'; + if (Postman_Zend_Registry::isRegistered('Postman_Zend_Locale')) { + $options['locale'] = Postman_Zend_Registry::get('Postman_Zend_Locale'); + } + } + + if (array_key_exists('locale', $options)) { + $this->setLocale($options['locale']); + } + } + + /** + * Returns the locale option + * + * @return string|Postman_Zend_Locale|null + */ + public function getLocale() + { + return $this->_locale; + } + + /** + * Sets the locale option + * + * @param string|Postman_Zend_Locale $locale + * @return Postman_Zend_Validate_Date provides a fluent interface + */ + public function setLocale($locale = null) + { + require_once 'Zend/Locale.php'; + $this->_locale = Postman_Zend_Locale::findLocale($locale); + return $this; + } + + /** + * Returns the locale option + * + * @return string|null + */ + public function getFormat() + { + return $this->_format; + } + + /** + * Sets the format option + * + * @param string $format + * @return Postman_Zend_Validate_Date provides a fluent interface + */ + public function setFormat($format = null) + { + $this->_format = $format; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if $value is a valid date of the format YYYY-MM-DD + * If optional $format or $locale is set the date format is checked + * according to Postman_Zend_Date, see Postman_Zend_Date::isDate() + * + * @param string|array|Postman_Zend_Date $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value) && !is_int($value) && !is_float($value) && + !is_array($value) && !($value instanceof Postman_Zend_Date)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue($value); + + if (($this->_format !== null) || ($this->_locale !== null) || is_array($value) || + $value instanceof Postman_Zend_Date) { + require_once 'Zend/Date.php'; + if (!Postman_Zend_Date::isDate($value, $this->_format, $this->_locale)) { + if ($this->_checkFormat($value) === false) { + $this->_error(self::FALSEFORMAT); + } else { + $this->_error(self::INVALID_DATE); + } + return false; + } + } else { + if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $value)) { + $this->_format = 'yyyy-MM-dd'; + $this->_error(self::FALSEFORMAT); + $this->_format = null; + return false; + } + + list($year, $month, $day) = sscanf($value, '%d-%d-%d'); + + if (!checkdate($month, $day, $year)) { + $this->_error(self::INVALID_DATE); + return false; + } + } + + return true; + } + + /** + * Check if the given date fits the given format + * + * @param string $value Date to check + * @return boolean False when date does not fit the format + */ + private function _checkFormat($value) + { + try { + require_once 'Zend/Locale/Format.php'; + $parsed = Postman_Zend_Locale_Format::getDate($value, array( + 'date_format' => $this->_format, 'format_type' => 'iso', + 'fix_date' => false)); + if (isset($parsed['year']) and ((strpos(strtoupper($this->_format), 'YY') !== false) and + (strpos(strtoupper($this->_format), 'YYYY') === false))) { + $parsed['year'] = Postman_Zend_Date::getFullYear($parsed['year']); + } + } catch (Exception $e) { + // Date can not be parsed + return false; + } + + if (((strpos($this->_format, 'Y') !== false) or (strpos($this->_format, 'y') !== false)) and + (!isset($parsed['year']))) { + // Year expected but not found + return false; + } + + if ((strpos($this->_format, 'M') !== false) and (!isset($parsed['month']))) { + // Month expected but not found + return false; + } + + if ((strpos($this->_format, 'd') !== false) and (!isset($parsed['day']))) { + // Day expected but not found + return false; + } + + if (((strpos($this->_format, 'H') !== false) or (strpos($this->_format, 'h') !== false)) and + (!isset($parsed['hour']))) { + // Hour expected but not found + return false; + } + + if ((strpos($this->_format, 'm') !== false) and (!isset($parsed['minute']))) { + // Minute expected but not found + return false; + } + + if ((strpos($this->_format, 's') !== false) and (!isset($parsed['second']))) { + // Second expected but not found + return false; + } + + // Date fits the format + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Digits.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Digits.php new file mode 100644 index 0000000..ba253a8 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Digits.php @@ -0,0 +1,91 @@ + "'%value%' must contain only digits", + self::STRING_EMPTY => "'%value%' is an empty string", + self::INVALID => "Invalid type given. String, integer or float expected", + ); + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value only contains digit characters + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value) && !is_int($value) && !is_float($value)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue((string) $value); + + if ('' === $this->_value) { + $this->_error(self::STRING_EMPTY); + return false; + } + + if (null === self::$_filter) { + require_once 'Zend/Filter/Digits.php'; + self::$_filter = new Postman_Zend_Filter_Digits(); + } + + if ($this->_value !== self::$_filter->filter($this->_value)) { + $this->_error(self::NOT_DIGITS); + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/EmailAddress.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/EmailAddress.php new file mode 100644 index 0000000..f51645b --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/EmailAddress.php @@ -0,0 +1,574 @@ + "Invalid type given. String expected", + self::INVALID_FORMAT => "'%value%' is not a valid email address in the basic format local-part@hostname", + self::INVALID_HOSTNAME => "'%hostname%' is not a valid hostname for email address '%value%'", + self::INVALID_MX_RECORD => "'%hostname%' does not appear to have a valid MX record for the email address '%value%'", + self::INVALID_SEGMENT => "'%hostname%' is not in a routable network segment. The email address '%value%' should not be resolved from public network", + self::DOT_ATOM => "'%localPart%' can not be matched against dot-atom format", + self::QUOTED_STRING => "'%localPart%' can not be matched against quoted-string format", + self::INVALID_LOCAL_PART => "'%localPart%' is not a valid local part for email address '%value%'", + self::LENGTH_EXCEEDED => "'%value%' exceeds the allowed length", + ); + + /** + * As of RFC5753 (JAN 2010), the following blocks are no logner reserved: + * - 128.0.0.0/16 + * - 191.255.0.0/16 + * - 223.255.255.0/24 + * @see http://tools.ietf.org/html/rfc5735#page-6 + * + * As of RFC6598 (APR 2012), the following blocks are now reserved: + * - 100.64.0.0/10 + * @see http://tools.ietf.org/html/rfc6598#section-7 + * + * @see http://en.wikipedia.org/wiki/IPv4 + * @var array + */ + protected $_invalidIp = array( + '0' => '0.0.0.0/8', + '10' => '10.0.0.0/8', + '100' => '100.64.0.0/10', + '127' => '127.0.0.0/8', + '169' => '169.254.0.0/16', + '172' => '172.16.0.0/12', + '192' => array( + '192.0.0.0/24', + '192.0.2.0/24', + '192.88.99.0/24', + '192.168.0.0/16' + ), + '198' => '198.18.0.0/15', + '224' => '224.0.0.0/4', + '240' => '240.0.0.0/4' + ); + + /** + * @var array + */ + protected $_messageVariables = array( + 'hostname' => '_hostname', + 'localPart' => '_localPart' + ); + + /** + * @var string + */ + protected $_hostname; + + /** + * @var string + */ + protected $_localPart; + + /** + * Internal options array + */ + protected $_options = array( + 'mx' => false, + 'deep' => false, + 'domain' => true, + 'allow' => Postman_Zend_Validate_Hostname::ALLOW_DNS, + 'hostname' => null + ); + + /** + * Instantiates hostname validator for local use + * + * The following option keys are supported: + * 'hostname' => A hostname validator, see Postman_Zend_Validate_Hostname + * 'allow' => Options for the hostname validator, see Postman_Zend_Validate_Hostname::ALLOW_* + * 'mx' => If MX check should be enabled, boolean + * 'deep' => If a deep MX check should be done, boolean + * + * @param array|string|Postman_Zend_Config $options OPTIONAL + */ + public function __construct($options = array()) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } else if (!is_array($options)) { + $options = func_get_args(); + $temp['allow'] = array_shift($options); + if (!empty($options)) { + $temp['mx'] = array_shift($options); + } + + if (!empty($options)) { + $temp['hostname'] = array_shift($options); + } + + $options = $temp; + } + + $options += $this->_options; + $this->setOptions($options); + } + + /** + * Returns all set Options + * + * @return array + */ + public function getOptions() + { + return $this->_options; + } + + /** + * Set options for the email validator + * + * @param array $options + * @return Postman_Zend_Validate_EmailAddress Provides a fluent inteface + */ + public function setOptions(array $options = array()) + { + if (array_key_exists('messages', $options)) { + $this->setMessages($options['messages']); + } + + if (array_key_exists('hostname', $options)) { + if (array_key_exists('allow', $options)) { + $this->setHostnameValidator($options['hostname'], $options['allow']); + } else { + $this->setHostnameValidator($options['hostname']); + } + } elseif ($this->_options['hostname'] == null) { + $this->setHostnameValidator(); + } + + if (array_key_exists('mx', $options)) { + $this->setValidateMx($options['mx']); + } + + if (array_key_exists('deep', $options)) { + $this->setDeepMxCheck($options['deep']); + } + + if (array_key_exists('domain', $options)) { + $this->setDomainCheck($options['domain']); + } + + return $this; + } + + /** + * Sets the validation failure message template for a particular key + * Adds the ability to set messages to the attached hostname validator + * + * @param string $messageString + * @param string $messageKey OPTIONAL + * @return Postman_Zend_Validate_Abstract Provides a fluent interface + * @throws Postman_Zend_Validate_Exception + */ + public function setMessage($messageString, $messageKey = null) + { + if ($messageKey === null) { + $this->_options['hostname']->setMessage($messageString); + parent::setMessage($messageString); + return $this; + } + + if (!isset($this->_messageTemplates[$messageKey])) { + $this->_options['hostname']->setMessage($messageString, $messageKey); + } + + $this->_messageTemplates[$messageKey] = $messageString; + return $this; + } + + /** + * Returns the set hostname validator + * + * @return Postman_Zend_Validate_Hostname + */ + public function getHostnameValidator() + { + return $this->_options['hostname']; + } + + /** + * @param Postman_Zend_Validate_Hostname $hostnameValidator OPTIONAL + * @param int $allow OPTIONAL + * @return $this + */ + public function setHostnameValidator(Postman_Zend_Validate_Hostname $hostnameValidator = null, $allow = Postman_Zend_Validate_Hostname::ALLOW_DNS) + { + if (!$hostnameValidator) { + $hostnameValidator = new Postman_Zend_Validate_Hostname($allow); + } + + $this->_options['hostname'] = $hostnameValidator; + $this->_options['allow'] = $allow; + return $this; + } + + /** + * Whether MX checking via getmxrr is supported or not + * + * This currently only works on UNIX systems + * + * @return boolean + */ + public function validateMxSupported() + { + return function_exists('getmxrr'); + } + + /** + * Returns the set validateMx option + * + * @return boolean + */ + public function getValidateMx() + { + return $this->_options['mx']; + } + + /** + * Set whether we check for a valid MX record via DNS + * + * This only applies when DNS hostnames are validated + * + * @param boolean $mx Set allowed to true to validate for MX records, and false to not validate them + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_EmailAddress Provides a fluent inteface + */ + public function setValidateMx($mx) + { + if ((bool) $mx && !$this->validateMxSupported()) { + // require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('MX checking not available on this system'); + } + + $this->_options['mx'] = (bool) $mx; + return $this; + } + + /** + * Returns the set deepMxCheck option + * + * @return boolean + */ + public function getDeepMxCheck() + { + return $this->_options['deep']; + } + + /** + * Set whether we check MX record should be a deep validation + * + * @param boolean $deep Set deep to true to perform a deep validation process for MX records + * @return Postman_Zend_Validate_EmailAddress Provides a fluent inteface + */ + public function setDeepMxCheck($deep) + { + $this->_options['deep'] = (bool) $deep; + return $this; + } + + /** + * Returns the set domainCheck option + * + * @return mixed + */ + public function getDomainCheck() + { + return $this->_options['domain']; + } + + /** + * Sets if the domain should also be checked + * or only the local part of the email address + * + * @param boolean $domain + * @return Postman_Zend_Validate_EmailAddress Provides a fluent inteface + */ + public function setDomainCheck($domain = true) + { + $this->_options['domain'] = (boolean) $domain; + return $this; + } + + /** + * Returns if the given host is reserved + * + * @param string $host + * @return boolean + */ + private function _isReserved($host){ + if (!preg_match('/^([0-9]{1,3}\.){3}[0-9]{1,3}$/', $host)) { + $host = gethostbyname($host); + } + + $octet = explode('.',$host); + if ((int)$octet[0] >= 224) { + return true; + } else if (array_key_exists($octet[0], $this->_invalidIp)) { + foreach ((array)$this->_invalidIp[$octet[0]] as $subnetData) { + // we skip the first loop as we already know that octet matches + for ($i = 1; $i < 4; $i++) { + if (strpos($subnetData, $octet[$i]) !== $i * 4) { + break; + } + } + + $host = explode("/", $subnetData); + $binaryHost = ""; + $tmp = explode(".", $host[0]); + for ($i = 0; $i < 4 ; $i++) { + $binaryHost .= str_pad(decbin($tmp[$i]), 8, "0", STR_PAD_LEFT); + } + + $segmentData = array( + 'network' => (int)$this->_toIp(str_pad(substr($binaryHost, 0, $host[1]), 32, 0)), + 'broadcast' => (int)$this->_toIp(str_pad(substr($binaryHost, 0, $host[1]), 32, 1)) + ); + + for ($j = $i; $j < 4; $j++) { + if ((int)$octet[$j] < $segmentData['network'][$j] || + (int)$octet[$j] > $segmentData['broadcast'][$j]) { + return false; + } + } + } + + return true; + } else { + return false; + } + } + + /** + * Converts a binary string to an IP address + * + * @param string $binary + * @return mixed + */ + private function _toIp($binary) + { + $ip = array(); + $tmp = explode(".", chunk_split($binary, 8, ".")); + for ($i = 0; $i < 4 ; $i++) { + $ip[$i] = bindec($tmp[$i]); + } + + return $ip; + } + + /** + * Internal method to validate the local part of the email address + * + * @return boolean + */ + private function _validateLocalPart() + { + // First try to match the local part on the common dot-atom format + $result = false; + + // Dot-atom characters are: 1*atext *("." 1*atext) + // atext: ALPHA / DIGIT / and "!", "#", "$", "%", "&", "'", "*", + // "+", "-", "/", "=", "?", "^", "_", "`", "{", "|", "}", "~" + $atext = 'a-zA-Z0-9\x21\x23\x24\x25\x26\x27\x2a\x2b\x2d\x2f\x3d\x3f\x5e\x5f\x60\x7b\x7c\x7d\x7e'; + if (preg_match('/^[' . $atext . ']+(\x2e+[' . $atext . ']+)*$/', $this->_localPart)) { + $result = true; + } else { + // Try quoted string format (RFC 5321 Chapter 4.1.2) + + // Quoted-string characters are: DQUOTE *(qtext/quoted-pair) DQUOTE + $qtext = '\x20-\x21\x23-\x5b\x5d-\x7e'; // %d32-33 / %d35-91 / %d93-126 + $quotedPair = '\x20-\x7e'; // %d92 %d32-126 + if (preg_match('/^"(['. $qtext .']|\x5c[' . $quotedPair . '])*"$/', $this->localPart)) { + $result = true; + } else { + $this->_error(self::DOT_ATOM); + $this->_error(self::QUOTED_STRING); + $this->_error(self::INVALID_LOCAL_PART); + } + } + + return $result; + } + + /** + * Internal method to validate the servers MX records + * + * @return boolean + */ + private function _validateMXRecords() + { + $mxHosts = array(); + $hostname = $this->_hostname; + + //decode IDN domain name if possible + if (function_exists('idn_to_ascii')) { + $hostname = idn_to_ascii($this->_hostname); + } + + $result = getmxrr($hostname, $mxHosts); + if (!$result) { + $this->_error(self::INVALID_MX_RECORD); + } else if ($this->_options['deep'] && function_exists('checkdnsrr')) { + $validAddress = false; + $reserved = true; + foreach ($mxHosts as $hostname) { + $res = $this->_isReserved($hostname); + if (!$res) { + $reserved = false; + } + + if (!$res + && (checkdnsrr($hostname, "A") + || checkdnsrr($hostname, "AAAA") + || checkdnsrr($hostname, "A6"))) { + $validAddress = true; + break; + } + } + + if (!$validAddress) { + $result = false; + if ($reserved) { + $this->_error(self::INVALID_SEGMENT); + } else { + $this->_error(self::INVALID_MX_RECORD); + } + } + } + + return $result; + } + + /** + * Internal method to validate the hostname part of the email address + * + * @return boolean + */ + private function _validateHostnamePart() + { + $hostname = $this->_options['hostname']->setTranslator($this->getTranslator()) + ->isValid($this->_hostname); + if (!$hostname) { + $this->_error(self::INVALID_HOSTNAME); + + // Get messages and errors from hostnameValidator + foreach ($this->_options['hostname']->getMessages() as $code => $message) { + $this->_messages[$code] = $message; + } + + foreach ($this->_options['hostname']->getErrors() as $error) { + $this->_errors[] = $error; + } + } else if ($this->_options['mx']) { + // MX check on hostname + $hostname = $this->_validateMXRecords(); + } + + return $hostname; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is a valid email address + * according to RFC2822 + * + * @link http://www.ietf.org/rfc/rfc2822.txt RFC2822 + * @link http://www.columbia.edu/kermit/ascii.html US-ASCII characters + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value)) { + $this->_error(self::INVALID); + return false; + } + + $matches = array(); + $length = true; + $this->_setValue($value); + + // Split email address up and disallow '..' + if ((strpos($value, '..') !== false) or + (!preg_match('/^(.+)@([^@]+)$/', $value, $matches))) { + $this->_error(self::INVALID_FORMAT); + return false; + } + + $this->_localPart = $matches[1]; + $this->_hostname = $matches[2]; + + if ((strlen($this->_localPart) > 64) || (strlen($this->_hostname) > 255)) { + $length = false; + $this->_error(self::LENGTH_EXCEEDED); + } + + // Match hostname part + if ($this->_options['domain']) { + $hostname = $this->_validateHostnamePart(); + } + + $local = $this->_validateLocalPart(); + + // If both parts valid, return true + if ($local && $length) { + if (($this->_options['domain'] && $hostname) || !$this->_options['domain']) { + return true; + } + } + + return false; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Exception.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Exception.php new file mode 100644 index 0000000..a0abb61 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Exception.php @@ -0,0 +1,34 @@ + "Invalid type given. String, integer or float expected", + self::NOT_FLOAT => "'%value%' does not appear to be a float", + ); + + protected $_locale; + + /** + * Constructor for the float validator + * + * @param string|Postman_Zend_Config|Postman_Zend_Locale $locale + */ + public function __construct($locale = null) + { + if ($locale instanceof Postman_Zend_Config) { + $locale = $locale->toArray(); + } + + if (is_array($locale)) { + if (array_key_exists('locale', $locale)) { + $locale = $locale['locale']; + } else { + $locale = null; + } + } + + if (empty($locale)) { + require_once 'Zend/Registry.php'; + if (Postman_Zend_Registry::isRegistered('Postman_Zend_Locale')) { + $locale = Postman_Zend_Registry::get('Postman_Zend_Locale'); + } + } + + $this->setLocale($locale); + } + + /** + * Returns the set locale + */ + public function getLocale() + { + return $this->_locale; + } + + /** + * Sets the locale to use + * + * @param string|Postman_Zend_Locale $locale + * @return $this + */ + public function setLocale($locale = null) + { + require_once 'Zend/Locale.php'; + $this->_locale = Postman_Zend_Locale::findLocale($locale); + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is a floating-point value + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value) && !is_int($value) && !is_float($value)) { + $this->_error(self::INVALID); + return false; + } + + if (is_float($value)) { + return true; + } + + $this->_setValue($value); + try { + if (!Postman_Zend_Locale_Format::isFloat($value, array('locale' => $this->_locale))) { + $this->_error(self::NOT_FLOAT); + return false; + } + } catch (Postman_Zend_Locale_Exception $e) { + $this->_error(self::NOT_FLOAT); + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/GreaterThan.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/GreaterThan.php new file mode 100644 index 0000000..e5f5d1a --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/GreaterThan.php @@ -0,0 +1,124 @@ + "'%value%' is not greater than '%min%'", + ); + + /** + * @var array + */ + protected $_messageVariables = array( + 'min' => '_min' + ); + + /** + * Minimum value + * + * @var mixed + */ + protected $_min; + + /** + * Sets validator options + * + * @param mixed|Postman_Zend_Config $min + * @throws Postman_Zend_Validate_Exception + */ + public function __construct($min) + { + if ($min instanceof Postman_Zend_Config) { + $min = $min->toArray(); + } + + if (is_array($min)) { + if (array_key_exists('min', $min)) { + $min = $min['min']; + } else { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Missing option 'min'"); + } + } + + $this->setMin($min); + } + + /** + * Returns the min option + * + * @return mixed + */ + public function getMin() + { + return $this->_min; + } + + /** + * Sets the min option + * + * @param mixed $min + * @return Postman_Zend_Validate_GreaterThan Provides a fluent interface + */ + public function setMin($min) + { + $this->_min = $min; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is greater than min option + * + * @param mixed $value + * @return boolean + */ + public function isValid($value) + { + $this->_setValue($value); + + if ($this->_min >= $value) { + $this->_error(self::NOT_GREATER); + return false; + } + return true; + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Hex.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hex.php new file mode 100644 index 0000000..1917e98 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hex.php @@ -0,0 +1,72 @@ + "Invalid type given. String expected", + self::NOT_HEX => "'%value%' has not only hexadecimal digit characters", + ); + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value contains only hexadecimal digit characters + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value) && !is_int($value)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue($value); + if (!ctype_xdigit((string) $value)) { + $this->_error(self::NOT_HEX); + return false; + } + + return true; + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname.php new file mode 100644 index 0000000..937f9bd --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname.php @@ -0,0 +1,2359 @@ + "'%value%' appears to be a DNS hostname but the given punycode notation cannot be decoded", + self::INVALID => 'Invalid type given. String expected', + self::INVALID_DASH => "'%value%' appears to be a DNS hostname but contains a dash in an invalid position", + self::INVALID_HOSTNAME => "'%value%' does not match the expected structure for a DNS hostname", + self::INVALID_HOSTNAME_SCHEMA => "'%value%' appears to be a DNS hostname but cannot match against hostname schema for TLD '%tld%'", + self::INVALID_LOCAL_NAME => "'%value%' does not appear to be a valid local network name", + self::INVALID_URI => "'%value%' does not appear to be a valid URI hostname", + self::IP_ADDRESS_NOT_ALLOWED => "'%value%' appears to be an IP address, but IP addresses are not allowed", + self::LOCAL_NAME_NOT_ALLOWED => "'%value%' appears to be a local network name but local network names are not allowed", + self::UNDECIPHERABLE_TLD => "'%value%' appears to be a DNS hostname but cannot extract TLD part", + self::UNKNOWN_TLD => "'%value%' appears to be a DNS hostname but cannot match TLD against known list", + ); + + /** + * @var array + */ + protected $_messageVariables = array( + 'tld' => '_tld', + ); + + /** + * Allows Internet domain names (e.g., example.com) + */ + const ALLOW_DNS = 1; + + /** + * Allows IP addresses + */ + const ALLOW_IP = 2; + + /** + * Allows local network names (e.g., localhost, www.localdomain) + */ + const ALLOW_LOCAL = 4; + + /** + * Allows all types of hostnames + */ + const ALLOW_URI = 8; + + /** + * Allows all types of hostnames + */ + const ALLOW_ALL = 15; + + /** + * Array of valid top-level-domains + * + * Version 2014112800, Last Updated Fri Nov 28 07:07:01 2014 UTC + * + * @see http://data.iana.org/TLD/tlds-alpha-by-domain.txt List of all TLDs by domain + * @see http://www.iana.org/domains/root/db/ Official list of supported TLDs + * @var array + */ + protected $_validTlds = array( + 'aaa', + 'aarp', + 'abarth', + 'abb', + 'abbott', + 'abbvie', + 'abc', + 'able', + 'abogado', + 'abudhabi', + 'ac', + 'academy', + 'accenture', + 'accountant', + 'accountants', + 'aco', + 'active', + 'actor', + 'ad', + 'adac', + 'ads', + 'adult', + 'ae', + 'aeg', + 'aero', + 'aetna', + 'af', + 'afamilycompany', + 'afl', + 'africa', + 'ag', + 'agakhan', + 'agency', + 'ai', + 'aig', + 'aigo', + 'airbus', + 'airforce', + 'airtel', + 'akdn', + 'al', + 'alfaromeo', + 'alibaba', + 'alipay', + 'allfinanz', + 'allstate', + 'ally', + 'alsace', + 'alstom', + 'am', + 'americanexpress', + 'americanfamily', + 'amex', + 'amfam', + 'amica', + 'amsterdam', + 'analytics', + 'android', + 'anquan', + 'anz', + 'ao', + 'aol', + 'apartments', + 'app', + 'apple', + 'aq', + 'aquarelle', + 'ar', + 'arab', + 'aramco', + 'archi', + 'army', + 'arpa', + 'art', + 'arte', + 'as', + 'asda', + 'asia', + 'associates', + 'at', + 'athleta', + 'attorney', + 'au', + 'auction', + 'audi', + 'audible', + 'audio', + 'auspost', + 'author', + 'auto', + 'autos', + 'avianca', + 'aw', + 'aws', + 'ax', + 'axa', + 'az', + 'azure', + 'ba', + 'baby', + 'baidu', + 'banamex', + 'bananarepublic', + 'band', + 'bank', + 'bar', + 'barcelona', + 'barclaycard', + 'barclays', + 'barefoot', + 'bargains', + 'baseball', + 'basketball', + 'bauhaus', + 'bayern', + 'bb', + 'bbc', + 'bbt', + 'bbva', + 'bcg', + 'bcn', + 'bd', + 'be', + 'beats', + 'beauty', + 'beer', + 'bentley', + 'berlin', + 'best', + 'bestbuy', + 'bet', + 'bf', + 'bg', + 'bh', + 'bharti', + 'bi', + 'bible', + 'bid', + 'bike', + 'bing', + 'bingo', + 'bio', + 'biz', + 'bj', + 'black', + 'blackfriday', + 'blanco', + 'blockbuster', + 'blog', + 'bloomberg', + 'blue', + 'bm', + 'bms', + 'bmw', + 'bn', + 'bnl', + 'bnpparibas', + 'bo', + 'boats', + 'boehringer', + 'bofa', + 'bom', + 'bond', + 'boo', + 'book', + 'booking', + 'boots', + 'bosch', + 'bostik', + 'boston', + 'bot', + 'boutique', + 'box', + 'br', + 'bradesco', + 'bridgestone', + 'broadway', + 'broker', + 'brother', + 'brussels', + 'bs', + 'bt', + 'budapest', + 'bugatti', + 'build', + 'builders', + 'business', + 'buy', + 'buzz', + 'bv', + 'bw', + 'by', + 'bz', + 'bzh', + 'ca', + 'cab', + 'cafe', + 'cal', + 'call', + 'calvinklein', + 'cam', + 'camera', + 'camp', + 'cancerresearch', + 'canon', + 'capetown', + 'capital', + 'capitalone', + 'car', + 'caravan', + 'cards', + 'care', + 'career', + 'careers', + 'cars', + 'cartier', + 'casa', + 'case', + 'caseih', + 'cash', + 'casino', + 'cat', + 'catering', + 'catholic', + 'cba', + 'cbn', + 'cbre', + 'cbs', + 'cc', + 'cd', + 'ceb', + 'center', + 'ceo', + 'cern', + 'cf', + 'cfa', + 'cfd', + 'cg', + 'ch', + 'chanel', + 'channel', + 'chase', + 'chat', + 'cheap', + 'chintai', + 'chloe', + 'christmas', + 'chrome', + 'chrysler', + 'church', + 'ci', + 'cipriani', + 'circle', + 'cisco', + 'citadel', + 'citi', + 'citic', + 'city', + 'cityeats', + 'ck', + 'cl', + 'claims', + 'cleaning', + 'click', + 'clinic', + 'clinique', + 'clothing', + 'cloud', + 'club', + 'clubmed', + 'cm', + 'cn', + 'co', + 'coach', + 'codes', + 'coffee', + 'college', + 'cologne', + 'com', + 'comcast', + 'commbank', + 'community', + 'company', + 'compare', + 'computer', + 'comsec', + 'condos', + 'construction', + 'consulting', + 'contact', + 'contractors', + 'cooking', + 'cookingchannel', + 'cool', + 'coop', + 'corsica', + 'country', + 'coupon', + 'coupons', + 'courses', + 'cr', + 'credit', + 'creditcard', + 'creditunion', + 'cricket', + 'crown', + 'crs', + 'cruise', + 'cruises', + 'csc', + 'cu', + 'cuisinella', + 'cv', + 'cw', + 'cx', + 'cy', + 'cymru', + 'cyou', + 'cz', + 'dabur', + 'dad', + 'dance', + 'data', + 'date', + 'dating', + 'datsun', + 'day', + 'dclk', + 'dds', + 'de', + 'deal', + 'dealer', + 'deals', + 'degree', + 'delivery', + 'dell', + 'deloitte', + 'delta', + 'democrat', + 'dental', + 'dentist', + 'desi', + 'design', + 'dev', + 'dhl', + 'diamonds', + 'diet', + 'digital', + 'direct', + 'directory', + 'discount', + 'discover', + 'dish', + 'diy', + 'dj', + 'dk', + 'dm', + 'dnp', + 'do', + 'docs', + 'doctor', + 'dodge', + 'dog', + 'doha', + 'domains', + 'dot', + 'download', + 'drive', + 'dtv', + 'dubai', + 'duck', + 'dunlop', + 'duns', + 'dupont', + 'durban', + 'dvag', + 'dvr', + 'dz', + 'earth', + 'eat', + 'ec', + 'eco', + 'edeka', + 'edu', + 'education', + 'ee', + 'eg', + 'email', + 'emerck', + 'energy', + 'engineer', + 'engineering', + 'enterprises', + 'epost', + 'epson', + 'equipment', + 'er', + 'ericsson', + 'erni', + 'es', + 'esq', + 'estate', + 'esurance', + 'et', + 'etisalat', + 'eu', + 'eurovision', + 'eus', + 'events', + 'everbank', + 'exchange', + 'expert', + 'exposed', + 'express', + 'extraspace', + 'fage', + 'fail', + 'fairwinds', + 'faith', + 'family', + 'fan', + 'fans', + 'farm', + 'farmers', + 'fashion', + 'fast', + 'fedex', + 'feedback', + 'ferrari', + 'ferrero', + 'fi', + 'fiat', + 'fidelity', + 'fido', + 'film', + 'final', + 'finance', + 'financial', + 'fire', + 'firestone', + 'firmdale', + 'fish', + 'fishing', + 'fit', + 'fitness', + 'fj', + 'fk', + 'flickr', + 'flights', + 'flir', + 'florist', + 'flowers', + 'fly', + 'fm', + 'fo', + 'foo', + 'food', + 'foodnetwork', + 'football', + 'ford', + 'forex', + 'forsale', + 'forum', + 'foundation', + 'fox', + 'fr', + 'free', + 'fresenius', + 'frl', + 'frogans', + 'frontdoor', + 'frontier', + 'ftr', + 'fujitsu', + 'fujixerox', + 'fun', + 'fund', + 'furniture', + 'futbol', + 'fyi', + 'ga', + 'gal', + 'gallery', + 'gallo', + 'gallup', + 'game', + 'games', + 'gap', + 'garden', + 'gb', + 'gbiz', + 'gd', + 'gdn', + 'ge', + 'gea', + 'gent', + 'genting', + 'george', + 'gf', + 'gg', + 'ggee', + 'gh', + 'gi', + 'gift', + 'gifts', + 'gives', + 'giving', + 'gl', + 'glade', + 'glass', + 'gle', + 'global', + 'globo', + 'gm', + 'gmail', + 'gmbh', + 'gmo', + 'gmx', + 'gn', + 'godaddy', + 'gold', + 'goldpoint', + 'golf', + 'goo', + 'goodhands', + 'goodyear', + 'goog', + 'google', + 'gop', + 'got', + 'gov', + 'gp', + 'gq', + 'gr', + 'grainger', + 'graphics', + 'gratis', + 'green', + 'gripe', + 'grocery', + 'group', + 'gs', + 'gt', + 'gu', + 'guardian', + 'gucci', + 'guge', + 'guide', + 'guitars', + 'guru', + 'gw', + 'gy', + 'hair', + 'hamburg', + 'hangout', + 'haus', + 'hbo', + 'hdfc', + 'hdfcbank', + 'health', + 'healthcare', + 'help', + 'helsinki', + 'here', + 'hermes', + 'hgtv', + 'hiphop', + 'hisamitsu', + 'hitachi', + 'hiv', + 'hk', + 'hkt', + 'hm', + 'hn', + 'hockey', + 'holdings', + 'holiday', + 'homedepot', + 'homegoods', + 'homes', + 'homesense', + 'honda', + 'honeywell', + 'horse', + 'hospital', + 'host', + 'hosting', + 'hot', + 'hoteles', + 'hotels', + 'hotmail', + 'house', + 'how', + 'hr', + 'hsbc', + 'ht', + 'htc', + 'hu', + 'hughes', + 'hyatt', + 'hyundai', + 'ibm', + 'icbc', + 'ice', + 'icu', + 'id', + 'ie', + 'ieee', + 'ifm', + 'ikano', + 'il', + 'im', + 'imamat', + 'imdb', + 'immo', + 'immobilien', + 'in', + 'industries', + 'infiniti', + 'info', + 'ing', + 'ink', + 'institute', + 'insurance', + 'insure', + 'int', + 'intel', + 'international', + 'intuit', + 'investments', + 'io', + 'ipiranga', + 'iq', + 'ir', + 'irish', + 'is', + 'iselect', + 'ismaili', + 'ist', + 'istanbul', + 'it', + 'itau', + 'itv', + 'iveco', + 'iwc', + 'jaguar', + 'java', + 'jcb', + 'jcp', + 'je', + 'jeep', + 'jetzt', + 'jewelry', + 'jio', + 'jlc', + 'jll', + 'jm', + 'jmp', + 'jnj', + 'jo', + 'jobs', + 'joburg', + 'jot', + 'joy', + 'jp', + 'jpmorgan', + 'jprs', + 'juegos', + 'juniper', + 'kaufen', + 'kddi', + 'ke', + 'kerryhotels', + 'kerrylogistics', + 'kerryproperties', + 'kfh', + 'kg', + 'kh', + 'ki', + 'kia', + 'kim', + 'kinder', + 'kindle', + 'kitchen', + 'kiwi', + 'km', + 'kn', + 'koeln', + 'komatsu', + 'kosher', + 'kp', + 'kpmg', + 'kpn', + 'kr', + 'krd', + 'kred', + 'kuokgroup', + 'kw', + 'ky', + 'kyoto', + 'kz', + 'la', + 'lacaixa', + 'ladbrokes', + 'lamborghini', + 'lamer', + 'lancaster', + 'lancia', + 'lancome', + 'land', + 'landrover', + 'lanxess', + 'lasalle', + 'lat', + 'latino', + 'latrobe', + 'law', + 'lawyer', + 'lb', + 'lc', + 'lds', + 'lease', + 'leclerc', + 'lefrak', + 'legal', + 'lego', + 'lexus', + 'lgbt', + 'li', + 'liaison', + 'lidl', + 'life', + 'lifeinsurance', + 'lifestyle', + 'lighting', + 'like', + 'lilly', + 'limited', + 'limo', + 'lincoln', + 'linde', + 'link', + 'lipsy', + 'live', + 'living', + 'lixil', + 'lk', + 'loan', + 'loans', + 'locker', + 'locus', + 'loft', + 'lol', + 'london', + 'lotte', + 'lotto', + 'love', + 'lpl', + 'lplfinancial', + 'lr', + 'ls', + 'lt', + 'ltd', + 'ltda', + 'lu', + 'lundbeck', + 'lupin', + 'luxe', + 'luxury', + 'lv', + 'ly', + 'ma', + 'macys', + 'madrid', + 'maif', + 'maison', + 'makeup', + 'man', + 'management', + 'mango', + 'map', + 'market', + 'marketing', + 'markets', + 'marriott', + 'marshalls', + 'maserati', + 'mattel', + 'mba', + 'mc', + 'mcd', + 'mcdonalds', + 'mckinsey', + 'md', + 'me', + 'med', + 'media', + 'meet', + 'melbourne', + 'meme', + 'memorial', + 'men', + 'menu', + 'meo', + 'merckmsd', + 'metlife', + 'mg', + 'mh', + 'miami', + 'microsoft', + 'mil', + 'mini', + 'mint', + 'mit', + 'mitsubishi', + 'mk', + 'ml', + 'mlb', + 'mls', + 'mm', + 'mma', + 'mn', + 'mo', + 'mobi', + 'mobile', + 'mobily', + 'moda', + 'moe', + 'moi', + 'mom', + 'monash', + 'money', + 'monster', + 'montblanc', + 'mopar', + 'mormon', + 'mortgage', + 'moscow', + 'moto', + 'motorcycles', + 'mov', + 'movie', + 'movistar', + 'mp', + 'mq', + 'mr', + 'ms', + 'msd', + 'mt', + 'mtn', + 'mtr', + 'mu', + 'museum', + 'mutual', + 'mv', + 'mw', + 'mx', + 'my', + 'mz', + 'na', + 'nab', + 'nadex', + 'nagoya', + 'name', + 'nationwide', + 'natura', + 'navy', + 'nba', + 'nc', + 'ne', + 'nec', + 'net', + 'netbank', + 'netflix', + 'network', + 'neustar', + 'new', + 'newholland', + 'news', + 'next', + 'nextdirect', + 'nexus', + 'nf', + 'nfl', + 'ng', + 'ngo', + 'nhk', + 'ni', + 'nico', + 'nike', + 'nikon', + 'ninja', + 'nissan', + 'nissay', + 'nl', + 'no', + 'nokia', + 'northwesternmutual', + 'norton', + 'now', + 'nowruz', + 'nowtv', + 'np', + 'nr', + 'nra', + 'nrw', + 'ntt', + 'nu', + 'nyc', + 'nz', + 'obi', + 'observer', + 'off', + 'office', + 'okinawa', + 'olayan', + 'olayangroup', + 'oldnavy', + 'ollo', + 'om', + 'omega', + 'one', + 'ong', + 'onl', + 'online', + 'onyourside', + 'ooo', + 'open', + 'oracle', + 'orange', + 'org', + 'organic', + 'origins', + 'osaka', + 'otsuka', + 'ott', + 'ovh', + 'pa', + 'page', + 'pamperedchef', + 'panasonic', + 'panerai', + 'paris', + 'pars', + 'partners', + 'parts', + 'party', + 'passagens', + 'pay', + 'pccw', + 'pe', + 'pet', + 'pf', + 'pfizer', + 'pg', + 'ph', + 'pharmacy', + 'phd', + 'philips', + 'phone', + 'photo', + 'photography', + 'photos', + 'physio', + 'piaget', + 'pics', + 'pictet', + 'pictures', + 'pid', + 'pin', + 'ping', + 'pink', + 'pioneer', + 'pizza', + 'pk', + 'pl', + 'place', + 'play', + 'playstation', + 'plumbing', + 'plus', + 'pm', + 'pn', + 'pnc', + 'pohl', + 'poker', + 'politie', + 'porn', + 'post', + 'pr', + 'pramerica', + 'praxi', + 'press', + 'prime', + 'pro', + 'prod', + 'productions', + 'prof', + 'progressive', + 'promo', + 'properties', + 'property', + 'protection', + 'pru', + 'prudential', + 'ps', + 'pt', + 'pub', + 'pw', + 'pwc', + 'py', + 'qa', + 'qpon', + 'quebec', + 'quest', + 'qvc', + 'racing', + 'radio', + 'raid', + 're', + 'read', + 'realestate', + 'realtor', + 'realty', + 'recipes', + 'red', + 'redstone', + 'redumbrella', + 'rehab', + 'reise', + 'reisen', + 'reit', + 'reliance', + 'ren', + 'rent', + 'rentals', + 'repair', + 'report', + 'republican', + 'rest', + 'restaurant', + 'review', + 'reviews', + 'rexroth', + 'rich', + 'richardli', + 'ricoh', + 'rightathome', + 'ril', + 'rio', + 'rip', + 'rmit', + 'ro', + 'rocher', + 'rocks', + 'rodeo', + 'rogers', + 'room', + 'rs', + 'rsvp', + 'ru', + 'rugby', + 'ruhr', + 'run', + 'rw', + 'rwe', + 'ryukyu', + 'sa', + 'saarland', + 'safe', + 'safety', + 'sakura', + 'sale', + 'salon', + 'samsclub', + 'samsung', + 'sandvik', + 'sandvikcoromant', + 'sanofi', + 'sap', + 'sapo', + 'sarl', + 'sas', + 'save', + 'saxo', + 'sb', + 'sbi', + 'sbs', + 'sc', + 'sca', + 'scb', + 'schaeffler', + 'schmidt', + 'scholarships', + 'school', + 'schule', + 'schwarz', + 'science', + 'scjohnson', + 'scor', + 'scot', + 'sd', + 'se', + 'search', + 'seat', + 'secure', + 'security', + 'seek', + 'select', + 'sener', + 'services', + 'ses', + 'seven', + 'sew', + 'sex', + 'sexy', + 'sfr', + 'sg', + 'sh', + 'shangrila', + 'sharp', + 'shaw', + 'shell', + 'shia', + 'shiksha', + 'shoes', + 'shop', + 'shopping', + 'shouji', + 'show', + 'showtime', + 'shriram', + 'si', + 'silk', + 'sina', + 'singles', + 'site', + 'sj', + 'sk', + 'ski', + 'skin', + 'sky', + 'skype', + 'sl', + 'sling', + 'sm', + 'smart', + 'smile', + 'sn', + 'sncf', + 'so', + 'soccer', + 'social', + 'softbank', + 'software', + 'sohu', + 'solar', + 'solutions', + 'song', + 'sony', + 'soy', + 'space', + 'spiegel', + 'spot', + 'spreadbetting', + 'sr', + 'srl', + 'srt', + 'st', + 'stada', + 'staples', + 'star', + 'starhub', + 'statebank', + 'statefarm', + 'statoil', + 'stc', + 'stcgroup', + 'stockholm', + 'storage', + 'store', + 'stream', + 'studio', + 'study', + 'style', + 'su', + 'sucks', + 'supplies', + 'supply', + 'support', + 'surf', + 'surgery', + 'suzuki', + 'sv', + 'swatch', + 'swiftcover', + 'swiss', + 'sx', + 'sy', + 'sydney', + 'symantec', + 'systems', + 'sz', + 'tab', + 'taipei', + 'talk', + 'taobao', + 'target', + 'tatamotors', + 'tatar', + 'tattoo', + 'tax', + 'taxi', + 'tc', + 'tci', + 'td', + 'tdk', + 'team', + 'tech', + 'technology', + 'tel', + 'telecity', + 'telefonica', + 'temasek', + 'tennis', + 'teva', + 'tf', + 'tg', + 'th', + 'thd', + 'theater', + 'theatre', + 'tiaa', + 'tickets', + 'tienda', + 'tiffany', + 'tips', + 'tires', + 'tirol', + 'tj', + 'tjmaxx', + 'tjx', + 'tk', + 'tkmaxx', + 'tl', + 'tm', + 'tmall', + 'tn', + 'to', + 'today', + 'tokyo', + 'tools', + 'top', + 'toray', + 'toshiba', + 'total', + 'tours', + 'town', + 'toyota', + 'toys', + 'tr', + 'trade', + 'trading', + 'training', + 'travel', + 'travelchannel', + 'travelers', + 'travelersinsurance', + 'trust', + 'trv', + 'tt', + 'tube', + 'tui', + 'tunes', + 'tushu', + 'tv', + 'tvs', + 'tw', + 'tz', + 'ua', + 'ubank', + 'ubs', + 'uconnect', + 'ug', + 'uk', + 'unicom', + 'university', + 'uno', + 'uol', + 'ups', + 'us', + 'uy', + 'uz', + 'va', + 'vacations', + 'vana', + 'vanguard', + 'vc', + 've', + 'vegas', + 'ventures', + 'verisign', + 'versicherung', + 'vet', + 'vg', + 'vi', + 'viajes', + 'video', + 'vig', + 'viking', + 'villas', + 'vin', + 'vip', + 'virgin', + 'visa', + 'vision', + 'vista', + 'vistaprint', + 'viva', + 'vivo', + 'vlaanderen', + 'vn', + 'vodka', + 'volkswagen', + 'volvo', + 'vote', + 'voting', + 'voto', + 'voyage', + 'vu', + 'vuelos', + 'wales', + 'walmart', + 'walter', + 'wang', + 'wanggou', + 'warman', + 'watch', + 'watches', + 'weather', + 'weatherchannel', + 'webcam', + 'weber', + 'website', + 'wed', + 'wedding', + 'weibo', + 'weir', + 'wf', + 'whoswho', + 'wien', + 'wiki', + 'williamhill', + 'win', + 'windows', + 'wine', + 'winners', + 'wme', + 'wolterskluwer', + 'woodside', + 'work', + 'works', + 'world', + 'wow', + 'ws', + 'wtc', + 'wtf', + 'xbox', + 'xerox', + 'xfinity', + 'xihuan', + 'xin', + 'कॉम', + 'セール', + '佛山', + 'ಭಾರತ', + '慈善', + '集团', + '在线', + '한국', + 'ଭାରତ', + '大众汽车', + '点看', + 'คอม', + 'ভাৰত', + 'ভারত', + '八卦', + 'موقع', + 'বাংলা', + '公益', + '公司', + '香格里拉', + '网站', + '移动', + '我爱你', + 'москва', + 'қаз', + 'католик', + 'онлайн', + 'сайт', + '联通', + 'срб', + 'бг', + 'бел', + 'קום', + '时尚', + '微博', + '淡马锡', + 'ファッション', + 'орг', + 'नेट', + 'ストア', + '삼성', + 'சிங்கப்பூர்', + '商标', + '商店', + '商城', + 'дети', + 'мкд', + 'ею', + 'ポイント', + '新闻', + '工行', + '家電', + 'كوم', + '中文网', + '中信', + '中国', + '中國', + '娱乐', + '谷歌', + 'భారత్', + 'ලංකා', + '電訊盈科', + '购物', + 'クラウド', + 'ભારત', + '通販', + 'भारतम्', + 'भारत', + 'भारोत', + '网店', + 'संगठन', + '餐厅', + '网络', + 'ком', + 'укр', + '香港', + '诺基亚', + '食品', + '飞利浦', + '台湾', + '台灣', + '手表', + '手机', + 'мон', + 'الجزائر', + 'عمان', + 'ارامكو', + 'ایران', + 'العليان', + 'اتصالات', + 'امارات', + 'بازار', + 'پاکستان', + 'الاردن', + 'موبايلي', + 'بارت', + 'بھارت', + 'المغرب', + 'ابوظبي', + 'السعودية', + 'ڀارت', + 'كاثوليك', + 'سودان', + 'همراه', + 'عراق', + 'مليسيا', + '澳門', + '닷컴', + '政府', + 'شبكة', + 'بيتك', + 'عرب', + 'გე', + '机构', + '组织机构', + '健康', + 'ไทย', + 'سورية', + 'рус', + 'рф', + '珠宝', + 'تونس', + '大拿', + 'みんな', + 'グーグル', + 'ελ', + '世界', + '書籍', + 'ഭാരതം', + 'ਭਾਰਤ', + '网址', + '닷넷', + 'コム', + '天主教', + '游戏', + 'vermögensberater', + 'vermögensberatung', + '企业', + '信息', + '嘉里大酒店', + '嘉里', + 'مصر', + 'قطر', + '广东', + 'இலங்கை', + 'இந்தியா', + 'հայ', + '新加坡', + 'فلسطين', + '政务', + 'xperia', + 'xxx', + 'xyz', + 'yachts', + 'yahoo', + 'yamaxun', + 'yandex', + 'ye', + 'yodobashi', + 'yoga', + 'yokohama', + 'you', + 'youtube', + 'yt', + 'yun', + 'za', + 'zappos', + 'zara', + 'zero', + 'zip', + 'zippo', + 'zm', + 'zone', + 'zuerich', + 'zw', + ); + + /** + * @var string + */ + protected $_tld; + + /** + * Array for valid Idns + * + * @see http://www.iana.org/domains/idn-tables/ Official list of supported IDN Chars + * (.AC) Ascension Island http://www.nic.ac/pdf/AC-IDN-Policy.pdf + * (.AR) Argentinia http://www.nic.ar/faqidn.html + * (.AS) American Samoa http://www.nic.as/idn/chars.cfm + * (.AT) Austria http://www.nic.at/en/service/technical_information/idn/charset_converter/ + * (.BIZ) International http://www.iana.org/domains/idn-tables/ + * (.BR) Brazil http://registro.br/faq/faq6.html + * (.BV) Bouvett Island http://www.norid.no/domeneregistrering/idn/idn_nyetegn.en.html + * (.CA) Canada http://www.iana.org/domains/idn-tables/tables/ca_fr_1.0.html + * (.CAT) Catalan http://www.iana.org/domains/idn-tables/tables/cat_ca_1.0.html + * (.CH) Switzerland https://nic.switch.ch/reg/ocView.action?res=EF6GW2JBPVTG67DLNIQXU234MN6SC33JNQQGI7L6#anhang1 + * (.CL) Chile http://www.iana.org/domains/idn-tables/tables/cl_latn_1.0.html + * (.COM) International http://www.verisign.com/information-services/naming-services/internationalized-domain-names/index.html + * (.DE) Germany http://www.denic.de/en/domains/idns/liste.html + * (.DK) Danmark http://www.dk-hostmaster.dk/index.php?id=151 + * (.ES) Spain https://www.nic.es/media/2008-05/1210147705287.pdf + * (.FI) Finland http://www.ficora.fi/en/index/palvelut/fiverkkotunnukset/aakkostenkaytto.html + * (.GR) Greece https://grweb.ics.forth.gr/CharacterTable1_en.jsp + * (.HU) Hungary http://www.domain.hu/domain/English/szabalyzat/szabalyzat.html + * (.INFO) International http://www.nic.info/info/idn + * (.IO) British Indian Ocean Territory http://www.nic.io/IO-IDN-Policy.pdf + * (.IR) Iran http://www.nic.ir/Allowable_Characters_dot-iran + * (.IS) Iceland http://www.isnic.is/domain/rules.php + * (.KR) Korea http://www.iana.org/domains/idn-tables/tables/kr_ko-kr_1.0.html + * (.LI) Liechtenstein https://nic.switch.ch/reg/ocView.action?res=EF6GW2JBPVTG67DLNIQXU234MN6SC33JNQQGI7L6#anhang1 + * (.LT) Lithuania http://www.domreg.lt/static/doc/public/idn_symbols-en.pdf + * (.MD) Moldova http://www.register.md/ + * (.MUSEUM) International http://www.iana.org/domains/idn-tables/tables/museum_latn_1.0.html + * (.NET) International http://www.verisign.com/information-services/naming-services/internationalized-domain-names/index.html + * (.NO) Norway http://www.norid.no/domeneregistrering/idn/idn_nyetegn.en.html + * (.NU) Niue http://www.worldnames.net/ + * (.ORG) International http://www.pir.org/index.php?db=content/FAQs&tbl=FAQs_Registrant&id=2 + * (.PE) Peru https://www.nic.pe/nuevas_politicas_faq_2.php + * (.PL) Poland http://www.dns.pl/IDN/allowed_character_sets.pdf + * (.PR) Puerto Rico http://www.nic.pr/idn_rules.asp + * (.PT) Portugal https://online.dns.pt/dns_2008/do?com=DS;8216320233;111;+PAGE(4000058)+K-CAT-CODIGO(C.125)+RCNT(100); + * (.RU) Russia http://www.iana.org/domains/idn-tables/tables/ru_ru-ru_1.0.html + * (.RS) Serbia http://www.iana.org/domains/idn-tables/tables/rs_sr-rs_1.0.pdf + * (.SA) Saudi Arabia http://www.iana.org/domains/idn-tables/tables/sa_ar_1.0.html + * (.SE) Sweden http://www.iis.se/english/IDN_campaignsite.shtml?lang=en + * (.SH) Saint Helena http://www.nic.sh/SH-IDN-Policy.pdf + * (.SJ) Svalbard and Jan Mayen http://www.norid.no/domeneregistrering/idn/idn_nyetegn.en.html + * (.TH) Thailand http://www.iana.org/domains/idn-tables/tables/th_th-th_1.0.html + * (.TM) Turkmenistan http://www.nic.tm/TM-IDN-Policy.pdf + * (.TR) Turkey https://www.nic.tr/index.php + * (.UA) Ukraine http://www.iana.org/domains/idn-tables/tables/ua_cyrl_1.2.html + * (.VE) Venice http://www.iana.org/domains/idn-tables/tables/ve_es_1.0.html + * (.VN) Vietnam http://www.vnnic.vn/english/5-6-300-2-2-04-20071115.htm#1.%20Introduction + * + * @var array + */ + protected $_validIdns = array( + 'AC' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿāăąćĉċčďđēėęěĝġģĥħīįĵķĺļľŀłńņňŋőœŕŗřśŝşšţťŧūŭůűųŵŷźżž]{1,63}$/iu' ), + 'AR' => array( 1 => '/^[\x{002d}0-9a-zà-ãç-êìíñ-õü]{1,63}$/iu' ), + 'AS' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿāăąćĉċčďđēĕėęěĝğġģĥħĩīĭįıĵķĸĺļľłńņňŋōŏőœŕŗřśŝşšţťŧũūŭůűųŵŷźż]{1,63}$/iu' ), + 'AT' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿœšž]{1,63}$/iu' ), + 'BIZ' => 'Hostname/Biz.php', + 'BR' => array( 1 => '/^[\x{002d}0-9a-zà-ãçéíó-õúü]{1,63}$/iu' ), + 'BV' => array( 1 => '/^[\x{002d}0-9a-zàáä-éêñ-ôöøüčđńŋšŧž]{1,63}$/iu' ), + 'CA' => array( 1 => '/^[\x{002d}0-9a-zàâæçéèêëîïôœùûüÿ\x{00E0}\x{00E2}\x{00E7}\x{00E8}\x{00E9}\x{00EA}\x{00EB}\x{00EE}\x{00EF}\x{00F4}\x{00F9}\x{00FB}\x{00FC}\x{00E6}\x{0153}\x{00FF}]{1,63}$/iu' ), + 'CAT' => array( 1 => '/^[\x{002d}0-9a-z·àç-éíïòóúü]{1,63}$/iu' ), + 'CH' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿœ]{1,63}$/iu' ), + 'CL' => array( 1 => '/^[\x{002d}0-9a-záéíñóúü]{1,63}$/iu' ), + 'CN' => 'Hostname/Cn.php', + 'COM' => 'Hostname/Com.php', + 'DE' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿăąāćĉčċďđĕěėęēğĝġģĥħĭĩįīıĵķĺľļłńňņŋŏőōœĸŕřŗśŝšşťţŧŭůűũųūŵŷźžż]{1,63}$/iu' ), + 'DK' => array( 1 => '/^[\x{002d}0-9a-zäéöüæøå]{1,63}$/iu' ), + 'ES' => array( 1 => '/^[\x{002d}0-9a-zàáçèéíïñòóúü·]{1,63}$/iu' ), + 'EU' => array( + 1 => '/^[\x{002d}0-9a-zà-öø-ÿ]{1,63}$/iu', + 2 => '/^[\x{002d}0-9a-zāăąćĉċčďđēĕėęěĝğġģĥħĩīĭįıĵķĺļľŀłńņňʼnŋōŏőœŕŗřśŝšťŧũūŭůűųŵŷźżž]{1,63}$/iu', + 3 => '/^[\x{002d}0-9a-zșț]{1,63}$/iu', + 4 => '/^[\x{002d}0-9a-zΐάέήίΰαβγδεζηθικλμνξοπρςστυφχψωϊϋόύώ]{1,63}$/iu', + 5 => '/^[\x{002d}0-9a-zабвгдежзийклмнопрстуфхцчшщъыьэюя]{1,63}$/iu', + 6 => '/^[\x{002d}0-9a-zἀ-ἇἐ-ἕἠ-ἧἰ-ἷὀ-ὅὐ-ὗὠ-ὧὰ-ὼώᾀ-ᾇᾐ-ᾗᾠ-ᾧᾰ-ᾴᾶᾷῂῃῄῆῇῐ-ῒΐῖῗῠ-ῧῲῳῴῶῷ]{1,63}$/iu', + ), + 'FI' => array( 1 => '/^[\x{002d}0-9a-zäåö]{1,63}$/iu' ), + 'GR' => array( 1 => '/^[\x{002d}0-9a-zΆΈΉΊΌΎ-ΡΣ-ώἀ-ἕἘ-Ἕἠ-ὅὈ-Ὅὐ-ὗὙὛὝὟ-ώᾀ-ᾴᾶ-ᾼῂῃῄῆ-ῌῐ-ΐῖ-Ίῠ-Ῥῲῳῴῶ-ῼ]{1,63}$/iu' ), + 'HK' => 'Hostname/Cn.php', + 'HU' => array( 1 => '/^[\x{002d}0-9a-záéíóöúüőű]{1,63}$/iu' ), + 'IL' => array( + 1 => '/^[\x{002d}0-9\x{05D0}-\x{05EA}]{1,63}$/iu', + 2 => '/^[\x{002d}0-9a-z]{1,63}$/i', + ), + 'INFO' => array( + 1 => '/^[\x{002d}0-9a-zäåæéöøü]{1,63}$/iu', + 2 => '/^[\x{002d}0-9a-záéíóöúüőű]{1,63}$/iu', + 3 => '/^[\x{002d}0-9a-záæéíðóöúýþ]{1,63}$/iu', + 4 => '/^[\x{AC00}-\x{D7A3}]{1,17}$/iu', + 5 => '/^[\x{002d}0-9a-zāčēģīķļņōŗšūž]{1,63}$/iu', + 6 => '/^[\x{002d}0-9a-ząčėęįšūųž]{1,63}$/iu', + 7 => '/^[\x{002d}0-9a-zóąćęłńśźż]{1,63}$/iu', + 8 => '/^[\x{002d}0-9a-záéíñóúü]{1,63}$/iu', + ), + 'IO' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿăąāćĉčċďđĕěėęēğĝġģĥħĭĩįīıĵķĺľļłńňņŋŏőōœĸŕřŗśŝšşťţŧŭůűũųūŵŷźžż]{1,63}$/iu' ), + 'IS' => array( 1 => '/^[\x{002d}0-9a-záéýúíóþæöð]{1,63}$/iu' ), + 'IT' => array( 1 => '/^[\x{002d}0-9a-zàâäèéêëìîïòôöùûüæœçÿß-]{1,63}$/iu' ), + 'JP' => 'Hostname/Jp.php', + 'KR' => array( 1 => '/^[\x{AC00}-\x{D7A3}]{1,17}$/iu' ), + 'LI' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿœ]{1,63}$/iu' ), + 'LT' => array( 1 => '/^[\x{002d}0-9ąčęėįšųūž]{1,63}$/iu' ), + 'MD' => array( 1 => '/^[\x{002d}0-9ăâîşţ]{1,63}$/iu' ), + 'MUSEUM' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿāăąćċčďđēėęěğġģħīįıķĺļľłńņňŋōőœŕŗřśşšţťŧūůűųŵŷźżžǎǐǒǔ\x{01E5}\x{01E7}\x{01E9}\x{01EF}ə\x{0292}ẁẃẅỳ]{1,63}$/iu' ), + 'NET' => 'Hostname/Com.php', + 'NO' => array( 1 => '/^[\x{002d}0-9a-zàáä-éêñ-ôöøüčđńŋšŧž]{1,63}$/iu' ), + 'NU' => 'Hostname/Com.php', + 'ORG' => array( + 1 => '/^[\x{002d}0-9a-záéíñóúü]{1,63}$/iu', + 2 => '/^[\x{002d}0-9a-zóąćęłńśźż]{1,63}$/iu', + 3 => '/^[\x{002d}0-9a-záäåæéëíðóöøúüýþ]{1,63}$/iu', + 4 => '/^[\x{002d}0-9a-záéíóöúüőű]{1,63}$/iu', + 5 => '/^[\x{002d}0-9a-ząčėęįšūųž]{1,63}$/iu', + 6 => '/^[\x{AC00}-\x{D7A3}]{1,17}$/iu', + 7 => '/^[\x{002d}0-9a-zāčēģīķļņōŗšūž]{1,63}$/iu', + ), + 'PE' => array( 1 => '/^[\x{002d}0-9a-zñáéíóúü]{1,63}$/iu' ), + 'PL' => array( + 1 => '/^[\x{002d}0-9a-zāčēģīķļņōŗšūž]{1,63}$/iu', + 2 => '/^[\x{002d}а-ик-ш\x{0450}ѓѕјљњќџ]{1,63}$/iu', + 3 => '/^[\x{002d}0-9a-zâîăşţ]{1,63}$/iu', + 4 => '/^[\x{002d}0-9а-яё\x{04C2}]{1,63}$/iu', + 5 => '/^[\x{002d}0-9a-zàáâèéêìíîòóôùúûċġħż]{1,63}$/iu', + 6 => '/^[\x{002d}0-9a-zàäåæéêòóôöøü]{1,63}$/iu', + 7 => '/^[\x{002d}0-9a-zóąćęłńśźż]{1,63}$/iu', + 8 => '/^[\x{002d}0-9a-zàáâãçéêíòóôõúü]{1,63}$/iu', + 9 => '/^[\x{002d}0-9a-zâîăşţ]{1,63}$/iu', + 10 => '/^[\x{002d}0-9a-záäéíóôúýčďĺľňŕšťž]{1,63}$/iu', + 11 => '/^[\x{002d}0-9a-zçë]{1,63}$/iu', + 12 => '/^[\x{002d}0-9а-ик-шђјљњћџ]{1,63}$/iu', + 13 => '/^[\x{002d}0-9a-zćčđšž]{1,63}$/iu', + 14 => '/^[\x{002d}0-9a-zâçöûüğış]{1,63}$/iu', + 15 => '/^[\x{002d}0-9a-záéíñóúü]{1,63}$/iu', + 16 => '/^[\x{002d}0-9a-zäõöüšž]{1,63}$/iu', + 17 => '/^[\x{002d}0-9a-zĉĝĥĵŝŭ]{1,63}$/iu', + 18 => '/^[\x{002d}0-9a-zâäéëîô]{1,63}$/iu', + 19 => '/^[\x{002d}0-9a-zàáâäåæçèéêëìíîïðñòôöøùúûüýćčłńřśš]{1,63}$/iu', + 20 => '/^[\x{002d}0-9a-zäåæõöøüšž]{1,63}$/iu', + 21 => '/^[\x{002d}0-9a-zàáçèéìíòóùú]{1,63}$/iu', + 22 => '/^[\x{002d}0-9a-zàáéíóöúüőű]{1,63}$/iu', + 23 => '/^[\x{002d}0-9ΐά-ώ]{1,63}$/iu', + 24 => '/^[\x{002d}0-9a-zàáâåæçèéêëðóôöøüþœ]{1,63}$/iu', + 25 => '/^[\x{002d}0-9a-záäéíóöúüýčďěňřšťůž]{1,63}$/iu', + 26 => '/^[\x{002d}0-9a-z·àçèéíïòóúü]{1,63}$/iu', + 27 => '/^[\x{002d}0-9а-ъьюя\x{0450}\x{045D}]{1,63}$/iu', + 28 => '/^[\x{002d}0-9а-яёіў]{1,63}$/iu', + 29 => '/^[\x{002d}0-9a-ząčėęįšūųž]{1,63}$/iu', + 30 => '/^[\x{002d}0-9a-záäåæéëíðóöøúüýþ]{1,63}$/iu', + 31 => '/^[\x{002d}0-9a-zàâæçèéêëîïñôùûüÿœ]{1,63}$/iu', + 32 => '/^[\x{002d}0-9а-щъыьэюяёєіїґ]{1,63}$/iu', + 33 => '/^[\x{002d}0-9א-ת]{1,63}$/iu', + ), + 'PR' => array( 1 => '/^[\x{002d}0-9a-záéíóúñäëïüöâêîôûàèùæçœãõ]{1,63}$/iu' ), + 'PT' => array( 1 => '/^[\x{002d}0-9a-záàâãçéêíóôõú]{1,63}$/iu' ), + 'RS' => array( 1 => '/^[\x{002D}\x{0030}-\x{0039}\x{0061}-\x{007A}\x{0107}\x{010D}\x{0111}\x{0161}\x{017E}]{1,63}$/iu)' ), + 'RU' => array( 1 => '/^[\x{002d}0-9а-яё]{1,63}$/iu' ), + 'SA' => array( 1 => '/^[\x{002d}.0-9\x{0621}-\x{063A}\x{0641}-\x{064A}\x{0660}-\x{0669}]{1,63}$/iu' ), + 'SE' => array( 1 => '/^[\x{002d}0-9a-zäåéöü]{1,63}$/iu' ), + 'SH' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿăąāćĉčċďđĕěėęēğĝġģĥħĭĩįīıĵķĺľļłńňņŋŏőōœĸŕřŗśŝšşťţŧŭůűũųūŵŷźžż]{1,63}$/iu' ), + 'SI' => array( + 1 => '/^[\x{002d}0-9a-zà-öø-ÿ]{1,63}$/iu', + 2 => '/^[\x{002d}0-9a-zāăąćĉċčďđēĕėęěĝğġģĥħĩīĭįıĵķĺļľŀłńņňʼnŋōŏőœŕŗřśŝšťŧũūŭůűųŵŷźżž]{1,63}$/iu', + 3 => '/^[\x{002d}0-9a-zșț]{1,63}$/iu', + ), + 'SJ' => array( 1 => '/^[\x{002d}0-9a-zàáä-éêñ-ôöøüčđńŋšŧž]{1,63}$/iu' ), + 'TH' => array( 1 => '/^[\x{002d}0-9a-z\x{0E01}-\x{0E3A}\x{0E40}-\x{0E4D}\x{0E50}-\x{0E59}]{1,63}$/iu' ), + 'TM' => array( 1 => '/^[\x{002d}0-9a-zà-öø-ÿāăąćĉċčďđēėęěĝġģĥħīįĵķĺļľŀłńņňŋőœŕŗřśŝşšţťŧūŭůűųŵŷźżž]{1,63}$/iu' ), + 'TW' => 'Hostname/Cn.php', + 'TR' => array( 1 => '/^[\x{002d}0-9a-zğıüşöç]{1,63}$/iu' ), + 'UA' => array( 1 => '/^[\x{002d}0-9a-zабвгдежзийклмнопрстуфхцчшщъыьэюяѐёђѓєѕіїјљњћќѝўџґӂʼ]{1,63}$/iu' ), + 'VE' => array( 1 => '/^[\x{002d}0-9a-záéíóúüñ]{1,63}$/iu' ), + 'VN' => array( 1 => '/^[ÀÁÂÃÈÉÊÌÍÒÓÔÕÙÚÝàáâãèéêìíòóôõùúýĂăĐđĨĩŨũƠơƯư\x{1EA0}-\x{1EF9}]{1,63}$/iu' ), + 'мон' => array( 1 => '/^[\x{002d}0-9\x{0430}-\x{044F}]{1,63}$/iu' ), + 'срб' => array( 1 => '/^[\x{002d}0-9а-ик-шђјљњћџ]{1,63}$/iu' ), + 'сайт' => array( 1 => '/^[\x{002d}0-9а-яёіїѝйўґг]{1,63}$/iu' ), + 'онлайн' => array( 1 => '/^[\x{002d}0-9а-яёіїѝйўґг]{1,63}$/iu' ), + '中国' => 'Hostname/Cn.php', + '中國' => 'Hostname/Cn.php', + 'ලංකා' => array( 1 => '/^[\x{0d80}-\x{0dff}]{1,63}$/iu' ), + '香港' => 'Hostname/Cn.php', + '台湾' => 'Hostname/Cn.php', + '台灣' => 'Hostname/Cn.php', + 'امارات' => array( 1 => '/^[\x{0621}-\x{0624}\x{0626}-\x{063A}\x{0641}\x{0642}\x{0644}-\x{0648}\x{067E}\x{0686}\x{0698}\x{06A9}\x{06AF}\x{06CC}\x{06F0}-\x{06F9}]{1,30}$/iu' ), + 'الاردن' => array( 1 => '/^[\x{0621}-\x{0624}\x{0626}-\x{063A}\x{0641}\x{0642}\x{0644}-\x{0648}\x{067E}\x{0686}\x{0698}\x{06A9}\x{06AF}\x{06CC}\x{06F0}-\x{06F9}]{1,30}$/iu' ), + 'السعودية' => array( 1 => '/^[\x{0621}-\x{0624}\x{0626}-\x{063A}\x{0641}\x{0642}\x{0644}-\x{0648}\x{067E}\x{0686}\x{0698}\x{06A9}\x{06AF}\x{06CC}\x{06F0}-\x{06F9}]{1,30}$/iu' ), + 'ไทย' => array( 1 => '/^[\x{002d}0-9a-z\x{0E01}-\x{0E3A}\x{0E40}-\x{0E4D}\x{0E50}-\x{0E59}]{1,63}$/iu' ), + 'рф' => array( 1 => '/^[\x{002d}0-9а-яё]{1,63}$/iu' ), + 'تونس' => array( 1 => '/^[\x{0621}-\x{0624}\x{0626}-\x{063A}\x{0641}\x{0642}\x{0644}-\x{0648}\x{067E}\x{0686}\x{0698}\x{06A9}\x{06AF}\x{06CC}\x{06F0}-\x{06F9}]{1,30}$/iu' ), + 'مصر' => array( 1 => '/^[\x{0621}-\x{0624}\x{0626}-\x{063A}\x{0641}\x{0642}\x{0644}-\x{0648}\x{067E}\x{0686}\x{0698}\x{06A9}\x{06AF}\x{06CC}\x{06F0}-\x{06F9}]{1,30}$/iu' ), + 'இலங்கை' => array( 1 => '/^[\x{0b80}-\x{0bff}]{1,63}$/iu' ), + 'فلسطين' => array( 1 => '/^[\x{0621}-\x{0624}\x{0626}-\x{063A}\x{0641}\x{0642}\x{0644}-\x{0648}\x{067E}\x{0686}\x{0698}\x{06A9}\x{06AF}\x{06CC}\x{06F0}-\x{06F9}]{1,30}$/iu' ), + 'شبكة' => array( 1 => '/^[\x{0621}-\x{0624}\x{0626}-\x{063A}\x{0641}\x{0642}\x{0644}-\x{0648}\x{067E}\x{0686}\x{0698}\x{06A9}\x{06AF}\x{06CC}\x{06F0}-\x{06F9}]{1,30}$/iu' ), + ); + + protected $_idnLength = array( + 'BIZ' => array( 5 => 17, 11 => 15, 12 => 20 ), + 'CN' => array( 1 => 20 ), + 'COM' => array( 3 => 17, 5 => 20 ), + 'HK' => array( 1 => 15 ), + 'INFO' => array( 4 => 17 ), + 'KR' => array( 1 => 17 ), + 'NET' => array( 3 => 17, 5 => 20 ), + 'ORG' => array( 6 => 17 ), + 'TW' => array( 1 => 20 ), + 'ایران' => array( 1 => 30 ), + '中国' => array( 1 => 20 ), + '公司' => array( 1 => 20 ), + '网络' => array( 1 => 20 ), + ); + + protected $_options = array( + 'allow' => self::ALLOW_DNS, + 'idn' => true, + 'tld' => true, + 'ip' => null, + ); + + /** + * Sets validator options + * + * @see http://www.iana.org/cctld/specifications-policies-cctlds-01apr02.htm Technical Specifications for ccTLDs + * @param array $options Validator options + */ + public function __construct( $options = array() ) { + if ( $options instanceof Postman_Zend_Config ) { + $options = $options->toArray(); + } else if ( ! is_array( $options ) ) { + $options = func_get_args(); + $temp['allow'] = array_shift( $options ); + if ( ! empty( $options ) ) { + $temp['idn'] = array_shift( $options ); + } + + if ( ! empty( $options ) ) { + $temp['tld'] = array_shift( $options ); + } + + if ( ! empty( $options ) ) { + $temp['ip'] = array_shift( $options ); + } + + $options = $temp; + } + + $options += $this->_options; + $this->setOptions( $options ); + } + + /** + * Returns all set options + * + * @return array + */ + public function getOptions() { + + return $this->_options; + } + + /** + * Sets the options for this validator + * + * @param array $options + * @return Postman_Zend_Validate_Hostname + */ + public function setOptions( $options ) { + if ( array_key_exists( 'allow', $options ) ) { + $this->setAllow( $options['allow'] ); + } + + if ( array_key_exists( 'idn', $options ) ) { + $this->setValidateIdn( $options['idn'] ); + } + + if ( array_key_exists( 'tld', $options ) ) { + $this->setValidateTld( $options['tld'] ); + } + + if ( array_key_exists( 'ip', $options ) ) { + $this->setIpValidator( $options['ip'] ); + } + + return $this; + } + + /** + * Returns the set ip validator + * + * @return Postman_Zend_Validate_Ip + */ + public function getIpValidator() { + + return $this->_options['ip']; + } + + /** + * @param Postman_Zend_Validate_Ip $ipValidator OPTIONAL + * @return Postman_Zend_Validate_Hostname + */ + public function setIpValidator( Postman_Zend_Validate_Ip $ipValidator = null ) { + if ( $ipValidator === null ) { + $ipValidator = new Postman_Zend_Validate_Ip(); + } + + $this->_options['ip'] = $ipValidator; + return $this; + } + + /** + * Returns the allow option + * + * @return integer + */ + public function getAllow() { + + return $this->_options['allow']; + } + + /** + * Sets the allow option + * + * @param integer $allow + * @return Postman_Zend_Validate_Hostname Provides a fluent interface + */ + public function setAllow( $allow ) { + $this->_options['allow'] = $allow; + return $this; + } + + /** + * Returns the set idn option + * + * @return boolean + */ + public function getValidateIdn() { + + return $this->_options['idn']; + } + + /** + * Set whether IDN domains are validated + * + * This only applies when DNS hostnames are validated + * + * @param boolean $allowed Set allowed to true to validate IDNs, and false to not validate them + * @return $this + */ + public function setValidateIdn( $allowed ) { + $this->_options['idn'] = (bool) $allowed; + return $this; + } + + /** + * Returns the set tld option + * + * @return boolean + */ + public function getValidateTld() { + + return $this->_options['tld']; + } + + /** + * Set whether the TLD element of a hostname is validated + * + * This only applies when DNS hostnames are validated + * + * @param boolean $allowed Set allowed to true to validate TLDs, and false to not validate them + * @return $this + */ + public function setValidateTld( $allowed ) { + $this->_options['tld'] = (bool) $allowed; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if the $value is a valid hostname with respect to the current allow option + * + * @param string $value + * @throws Postman_Zend_Validate_Exception if a fatal error occurs for validation process + * @return boolean + */ + public function isValid( $value ) { + if ( ! is_string( $value ) ) { + $this->_error( self::INVALID ); + return false; + } + + $this->_setValue( $value ); + // Check input against IP address schema + if ( preg_match( '/^[0-9a-f:.]*$/i', $value ) && + $this->_options['ip']->setTranslator( $this->getTranslator() )->isValid( $value ) ) { + if ( ! ($this->_options['allow'] & self::ALLOW_IP) ) { + $this->_error( self::IP_ADDRESS_NOT_ALLOWED ); + return false; + } else { + return true; + } + } + + // RFC3986 3.2.2 states: + // + // The rightmost domain label of a fully qualified domain name + // in DNS may be followed by a single "." and should be if it is + // necessary to distinguish between the complete domain name and + // some local domain. + // + // (see ZF-6363) + // Local hostnames are allowed to be partitial (ending '.') + if ( $this->_options['allow'] & self::ALLOW_LOCAL ) { + if ( substr( $value, -1 ) === '.' ) { + $value = substr( $value, 0, -1 ); + if ( substr( $value, -1 ) === '.' ) { + // Empty hostnames (ending '..') are not allowed + $this->_error( self::INVALID_LOCAL_NAME ); + return false; + } + } + } + + $domainParts = explode( '.', $value ); + + // Prevent partitial IP V4 adresses (ending '.') + if ( (count( $domainParts ) == 4) && preg_match( '/^[0-9.a-e:.]*$/i', $value ) && + $this->_options['ip']->setTranslator( $this->getTranslator() )->isValid( $value ) ) { + $this->_error( self::INVALID_LOCAL_NAME ); + } + + // Check input against DNS hostname schema + if ( (count( $domainParts ) > 1) && (strlen( $value ) >= 4) && (strlen( $value ) <= 254) ) { + $status = false; + + $origenc = PHP_VERSION_ID < 50600 + ? iconv_get_encoding( 'internal_encoding' ) + : ini_get( 'default_charset' ); + if ( PHP_VERSION_ID < 50600 ) { + iconv_set_encoding( 'internal_encoding', 'UTF-8' ); + } else { + // jason was here + @ini_set( 'default_charset', 'UTF-8' ); + } + do { + // First check TLD + $matches = array(); + if ( preg_match( '/([^.]{2,63})$/iu', end( $domainParts ), $matches ) + || (array_key_exists( end( $domainParts ), $this->_validIdns )) ) { + reset( $domainParts ); + + // Hostname characters are: *(label dot)(label dot label); max 254 chars + // label: id-prefix [*ldh{61} id-prefix]; max 63 chars + // id-prefix: alpha / digit + // ldh: alpha / digit / dash + // Match TLD against known list + $this->_tld = $matches[1]; + if ( $this->_options['tld'] ) { + if ( ! in_array( strtolower( $this->_tld ), $this->_validTlds ) + && ! in_array( $this->_tld, $this->_validTlds ) ) { + $this->_error( self::UNKNOWN_TLD ); + $status = false; + break; + } + // We have already validated that the TLD is fine. We don't want it to go through the below + // checks as new UTF-8 TLDs will incorrectly fail if there is no IDN regex for it. + array_pop( $domainParts ); + } + + /** + * Match against IDN hostnames + * Note: Keep label regex short to avoid issues with long patterns when matching IDN hostnames + * + * @see Postman_Zend_Validate_Hostname_Interface + */ + $regexChars = array( 0 => '/^[a-z0-9\x2d]{1,63}$/i' ); + if ( $this->_options['idn'] && isset( $this->_validIdns[ strtoupper( $this->_tld ) ] ) ) { + if ( is_string( $this->_validIdns[ strtoupper( $this->_tld ) ] ) ) { + $regexChars += include( $this->_validIdns[ strtoupper( $this->_tld ) ] ); + } else { + $regexChars += $this->_validIdns[ strtoupper( $this->_tld ) ]; + } + } + + // Check each hostname part + $check = 0; + foreach ( $domainParts as $domainPart ) { + // If some domain part is empty (i.e. zend..com), it's invalid + if ( empty( $domainPart ) ) { + $this->_error( self::INVALID_HOSTNAME ); + return false; + } + + // Decode Punycode domainnames to IDN + if ( strpos( $domainPart, 'xn--' ) === 0 ) { + $domainPart = $this->decodePunycode( substr( $domainPart, 4 ) ); + if ( $domainPart === false ) { + return false; + } + } + + // Check dash (-) does not start, end or appear in 3rd and 4th positions + if ( (strpos( $domainPart, '-' ) === 0) + || ((strlen( $domainPart ) > 2) && (strpos( $domainPart, '-', 2 ) == 2) && (strpos( $domainPart, '-', 3 ) == 3)) + || (strpos( $domainPart, '-' ) === (strlen( $domainPart ) - 1)) ) { + $this->_error( self::INVALID_DASH ); + $status = false; + break 2; + } + + // Check each domain part + $checked = false; + foreach ( $regexChars as $regexKey => $regexChar ) { + $status = preg_match( $regexChar, $domainPart ); + if ( $status > 0 ) { + $length = 63; + if ( array_key_exists( strtoupper( $this->_tld ), $this->_idnLength ) + && (array_key_exists( $regexKey, $this->_idnLength[ strtoupper( $this->_tld ) ] )) ) { + $length = $this->_idnLength[ strtoupper( $this->_tld ) ]; + } + + if ( iconv_strlen( $domainPart, 'UTF-8' ) > $length ) { + $this->_error( self::INVALID_HOSTNAME ); + } else { + $checked = true; + break; + } + } + } + + if ( $checked ) { + ++$check; + } + } + + // If one of the labels doesn't match, the hostname is invalid + if ( $check !== count( $domainParts ) ) { + $this->_error( self::INVALID_HOSTNAME_SCHEMA ); + $status = false; + } + } else { + // Hostname not long enough + $this->_error( self::UNDECIPHERABLE_TLD ); + $status = false; + } + } while (false); + + if ( PHP_VERSION_ID < 50600 ) { + iconv_set_encoding( 'internal_encoding', $origenc ); + } else { + // jason was here + @ini_set( 'default_charset', $origenc ); + } + // If the input passes as an Internet domain name, and domain names are allowed, then the hostname + // passes validation + if ( $status && ($this->_options['allow'] & self::ALLOW_DNS) ) { + return true; + } + } else if ( $this->_options['allow'] & self::ALLOW_DNS ) { + $this->_error( self::INVALID_HOSTNAME ); + } + + // Check for URI Syntax (RFC3986) + if ( $this->_options['allow'] & self::ALLOW_URI ) { + if ( preg_match( "/^([a-zA-Z0-9-._~!$&\'()*+,;=]|%[[:xdigit:]]{2}){1,254}$/i", $value ) ) { + return true; + } else { + $this->_error( self::INVALID_URI ); + } + } + + // Check input against local network name schema; last chance to pass validation + $regexLocal = '/^(([a-zA-Z0-9\x2d]{1,63}\x2e)*[a-zA-Z0-9\x2d]{1,63}[\x2e]{0,1}){1,254}$/'; + $status = @preg_match( $regexLocal, $value ); + + // If the input passes as a local network name, and local network names are allowed, then the + // hostname passes validation + $allowLocal = $this->_options['allow'] & self::ALLOW_LOCAL; + if ( $status && $allowLocal ) { + return true; + } + + // If the input does not pass as a local network name, add a message + if ( ! $status ) { + $this->_error( self::INVALID_LOCAL_NAME ); + } + + // If local network names are not allowed, add a message + if ( $status && ! $allowLocal ) { + $this->_error( self::LOCAL_NAME_NOT_ALLOWED ); + } + + return false; + } + + /** + * Decodes a punycode encoded string to it's original utf8 string + * In case of a decoding failure the original string is returned + * + * @param string $encoded Punycode encoded string to decode + * @return string + */ + protected function decodePunycode( $encoded ) { + if ( ! preg_match( '/^[a-z0-9-]+$/i', $encoded ) ) { + // no punycode encoded string + $this->_error( self::CANNOT_DECODE_PUNYCODE ); + return false; + } + + $decoded = array(); + $separator = strrpos( $encoded, '-' ); + if ( $separator > 0 ) { + for ( $x = 0; $x < $separator; ++$x ) { + // prepare decoding matrix + $decoded[] = ord( $encoded[ $x ] ); + } + } + + $lengthd = count( $decoded ); + $lengthe = strlen( $encoded ); + + // decoding + $init = true; + $base = 72; + $index = 0; + $char = 0x80; + + for ( $indexe = ($separator) ? ($separator + 1) : 0; $indexe < $lengthe; ++$lengthd ) { + for ( $old_index = $index, $pos = 1, $key = 36; 1 ; $key += 36 ) { + $hex = ord( $encoded[ $indexe++ ] ); + $digit = ($hex - 48 < 10) ? $hex - 22 + : (($hex - 65 < 26) ? $hex - 65 + : (($hex - 97 < 26) ? $hex - 97 + : 36)); + + $index += $digit * $pos; + $tag = ($key <= $base) ? 1 : (($key >= $base + 26) ? 26 : ($key - $base)); + if ( $digit < $tag ) { + break; + } + + $pos = (int) ($pos * (36 - $tag)); + } + + $delta = intval( $init ? (($index - $old_index) / 700) : (($index - $old_index) / 2) ); + $delta += intval( $delta / ($lengthd + 1) ); + for ( $key = 0; $delta > 910 / 2; $key += 36 ) { + $delta = intval( $delta / 35 ); + } + + $base = intval( $key + 36 * $delta / ($delta + 38) ); + $init = false; + $char += (int) ($index / ($lengthd + 1)); + $index %= ($lengthd + 1); + if ( $lengthd > 0 ) { + for ( $i = $lengthd; $i > $index; $i-- ) { + $decoded[ $i ] = $decoded[ ($i - 1) ]; + } + } + + $decoded[ $index++ ] = $char; + } + + // convert decoded ucs4 to utf8 string + foreach ( $decoded as $key => $value ) { + if ( $value < 128 ) { + $decoded[ $key ] = chr( $value ); + } elseif ( $value < (1 << 11) ) { + $decoded[ $key ] = chr( 192 + ($value >> 6) ); + $decoded[ $key ] .= chr( 128 + ($value & 63) ); + } elseif ( $value < (1 << 16) ) { + $decoded[ $key ] = chr( 224 + ($value >> 12) ); + $decoded[ $key ] .= chr( 128 + (($value >> 6) & 63) ); + $decoded[ $key ] .= chr( 128 + ($value & 63) ); + } elseif ( $value < (1 << 21) ) { + $decoded[ $key ] = chr( 240 + ($value >> 18) ); + $decoded[ $key ] .= chr( 128 + (($value >> 12) & 63) ); + $decoded[ $key ] .= chr( 128 + (($value >> 6) & 63) ); + $decoded[ $key ] .= chr( 128 + ($value & 63) ); + } else { + $this->_error( self::CANNOT_DECODE_PUNYCODE ); + return false; + } + } + + return implode( $decoded ); + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Biz.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Biz.php new file mode 100644 index 0000000..05fbe92 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Biz.php @@ -0,0 +1,2917 @@ + '/^[\x{002d}0-9a-zäåæéöøü]{1,63}$/iu', + 2 => '/^[\x{002d}0-9a-záéíñóúü]{1,63}$/iu', + 3 => '/^[\x{002d}0-9a-záéíóöúüőű]{1,63}$/iu', + 4 => '/^[\x{002d}0-9a-záæéíðóöúýþ]{1,63}$/iu', + 5 => '/^[\x{AC00}-\x{D7A3}]{1,17}$/iu', + 6 => '/^[\x{002d}0-9a-ząčėęįšūųž]{1,63}$/iu', + 7 => '/^[\x{002d}0-9a-zāčēģīķļņōŗšūž]{1,63}$/iu', + 8 => '/^[\x{002d}0-9a-zàáä-éêñ-ôöøüčđńŋšŧž]{1,63}$/iu', + 9 => '/^[\x{002d}0-9a-zóąćęłńśźż]{1,63}$/iu', + 10 => '/^[\x{002d}0-9a-záàâãçéêíóôõú]{1,63}$/iu', + 11 => '/^[\x{002d}0-9a-z\x{3005}-\x{3007}\x{3041}-\x{3093}\x{309D}\x{309E}\x{30A1}-\x{30F6}\x{30FC}' . +'\x{30FD}\x{30FE}\x{4E00}\x{4E01}\x{4E03}\x{4E07}\x{4E08}\x{4E09}\x{4E0A}' . +'\x{4E0B}\x{4E0D}\x{4E0E}\x{4E10}\x{4E11}\x{4E14}\x{4E15}\x{4E16}\x{4E17}' . +'\x{4E18}\x{4E19}\x{4E1E}\x{4E21}\x{4E26}\x{4E2A}\x{4E2D}\x{4E31}\x{4E32}' . +'\x{4E36}\x{4E38}\x{4E39}\x{4E3B}\x{4E3C}\x{4E3F}\x{4E42}\x{4E43}\x{4E45}' . +'\x{4E4B}\x{4E4D}\x{4E4E}\x{4E4F}\x{4E55}\x{4E56}\x{4E57}\x{4E58}\x{4E59}' . +'\x{4E5D}\x{4E5E}\x{4E5F}\x{4E62}\x{4E71}\x{4E73}\x{4E7E}\x{4E80}\x{4E82}' . +'\x{4E85}\x{4E86}\x{4E88}\x{4E89}\x{4E8A}\x{4E8B}\x{4E8C}\x{4E8E}\x{4E91}' . +'\x{4E92}\x{4E94}\x{4E95}\x{4E98}\x{4E99}\x{4E9B}\x{4E9C}\x{4E9E}\x{4E9F}' . +'\x{4EA0}\x{4EA1}\x{4EA2}\x{4EA4}\x{4EA5}\x{4EA6}\x{4EA8}\x{4EAB}\x{4EAC}' . +'\x{4EAD}\x{4EAE}\x{4EB0}\x{4EB3}\x{4EB6}\x{4EBA}\x{4EC0}\x{4EC1}\x{4EC2}' . +'\x{4EC4}\x{4EC6}\x{4EC7}\x{4ECA}\x{4ECB}\x{4ECD}\x{4ECE}\x{4ECF}\x{4ED4}' . +'\x{4ED5}\x{4ED6}\x{4ED7}\x{4ED8}\x{4ED9}\x{4EDD}\x{4EDE}\x{4EDF}\x{4EE3}' . +'\x{4EE4}\x{4EE5}\x{4EED}\x{4EEE}\x{4EF0}\x{4EF2}\x{4EF6}\x{4EF7}\x{4EFB}' . +'\x{4F01}\x{4F09}\x{4F0A}\x{4F0D}\x{4F0E}\x{4F0F}\x{4F10}\x{4F11}\x{4F1A}' . +'\x{4F1C}\x{4F1D}\x{4F2F}\x{4F30}\x{4F34}\x{4F36}\x{4F38}\x{4F3A}\x{4F3C}' . +'\x{4F3D}\x{4F43}\x{4F46}\x{4F47}\x{4F4D}\x{4F4E}\x{4F4F}\x{4F50}\x{4F51}' . +'\x{4F53}\x{4F55}\x{4F57}\x{4F59}\x{4F5A}\x{4F5B}\x{4F5C}\x{4F5D}\x{4F5E}' . +'\x{4F69}\x{4F6F}\x{4F70}\x{4F73}\x{4F75}\x{4F76}\x{4F7B}\x{4F7C}\x{4F7F}' . +'\x{4F83}\x{4F86}\x{4F88}\x{4F8B}\x{4F8D}\x{4F8F}\x{4F91}\x{4F96}\x{4F98}' . +'\x{4F9B}\x{4F9D}\x{4FA0}\x{4FA1}\x{4FAB}\x{4FAD}\x{4FAE}\x{4FAF}\x{4FB5}' . +'\x{4FB6}\x{4FBF}\x{4FC2}\x{4FC3}\x{4FC4}\x{4FCA}\x{4FCE}\x{4FD0}\x{4FD1}' . +'\x{4FD4}\x{4FD7}\x{4FD8}\x{4FDA}\x{4FDB}\x{4FDD}\x{4FDF}\x{4FE1}\x{4FE3}' . +'\x{4FE4}\x{4FE5}\x{4FEE}\x{4FEF}\x{4FF3}\x{4FF5}\x{4FF6}\x{4FF8}\x{4FFA}' . +'\x{4FFE}\x{5005}\x{5006}\x{5009}\x{500B}\x{500D}\x{500F}\x{5011}\x{5012}' . +'\x{5014}\x{5016}\x{5019}\x{501A}\x{501F}\x{5021}\x{5023}\x{5024}\x{5025}' . +'\x{5026}\x{5028}\x{5029}\x{502A}\x{502B}\x{502C}\x{502D}\x{5036}\x{5039}' . +'\x{5043}\x{5047}\x{5048}\x{5049}\x{504F}\x{5050}\x{5055}\x{5056}\x{505A}' . +'\x{505C}\x{5065}\x{506C}\x{5072}\x{5074}\x{5075}\x{5076}\x{5078}\x{507D}' . +'\x{5080}\x{5085}\x{508D}\x{5091}\x{5098}\x{5099}\x{509A}\x{50AC}\x{50AD}' . +'\x{50B2}\x{50B3}\x{50B4}\x{50B5}\x{50B7}\x{50BE}\x{50C2}\x{50C5}\x{50C9}' . +'\x{50CA}\x{50CD}\x{50CF}\x{50D1}\x{50D5}\x{50D6}\x{50DA}\x{50DE}\x{50E3}' . +'\x{50E5}\x{50E7}\x{50ED}\x{50EE}\x{50F5}\x{50F9}\x{50FB}\x{5100}\x{5101}' . +'\x{5102}\x{5104}\x{5109}\x{5112}\x{5114}\x{5115}\x{5116}\x{5118}\x{511A}' . +'\x{511F}\x{5121}\x{512A}\x{5132}\x{5137}\x{513A}\x{513B}\x{513C}\x{513F}' . +'\x{5140}\x{5141}\x{5143}\x{5144}\x{5145}\x{5146}\x{5147}\x{5148}\x{5149}' . +'\x{514B}\x{514C}\x{514D}\x{514E}\x{5150}\x{5152}\x{5154}\x{515A}\x{515C}' . +'\x{5162}\x{5165}\x{5168}\x{5169}\x{516A}\x{516B}\x{516C}\x{516D}\x{516E}' . +'\x{5171}\x{5175}\x{5176}\x{5177}\x{5178}\x{517C}\x{5180}\x{5182}\x{5185}' . +'\x{5186}\x{5189}\x{518A}\x{518C}\x{518D}\x{518F}\x{5190}\x{5191}\x{5192}' . +'\x{5193}\x{5195}\x{5196}\x{5197}\x{5199}\x{51A0}\x{51A2}\x{51A4}\x{51A5}' . +'\x{51A6}\x{51A8}\x{51A9}\x{51AA}\x{51AB}\x{51AC}\x{51B0}\x{51B1}\x{51B2}' . +'\x{51B3}\x{51B4}\x{51B5}\x{51B6}\x{51B7}\x{51BD}\x{51C4}\x{51C5}\x{51C6}' . +'\x{51C9}\x{51CB}\x{51CC}\x{51CD}\x{51D6}\x{51DB}\x{51DC}\x{51DD}\x{51E0}' . +'\x{51E1}\x{51E6}\x{51E7}\x{51E9}\x{51EA}\x{51ED}\x{51F0}\x{51F1}\x{51F5}' . +'\x{51F6}\x{51F8}\x{51F9}\x{51FA}\x{51FD}\x{51FE}\x{5200}\x{5203}\x{5204}' . +'\x{5206}\x{5207}\x{5208}\x{520A}\x{520B}\x{520E}\x{5211}\x{5214}\x{5217}' . +'\x{521D}\x{5224}\x{5225}\x{5227}\x{5229}\x{522A}\x{522E}\x{5230}\x{5233}' . +'\x{5236}\x{5237}\x{5238}\x{5239}\x{523A}\x{523B}\x{5243}\x{5244}\x{5247}' . +'\x{524A}\x{524B}\x{524C}\x{524D}\x{524F}\x{5254}\x{5256}\x{525B}\x{525E}' . +'\x{5263}\x{5264}\x{5265}\x{5269}\x{526A}\x{526F}\x{5270}\x{5271}\x{5272}' . +'\x{5273}\x{5274}\x{5275}\x{527D}\x{527F}\x{5283}\x{5287}\x{5288}\x{5289}' . +'\x{528D}\x{5291}\x{5292}\x{5294}\x{529B}\x{529F}\x{52A0}\x{52A3}\x{52A9}' . +'\x{52AA}\x{52AB}\x{52AC}\x{52AD}\x{52B1}\x{52B4}\x{52B5}\x{52B9}\x{52BC}' . +'\x{52BE}\x{52C1}\x{52C3}\x{52C5}\x{52C7}\x{52C9}\x{52CD}\x{52D2}\x{52D5}' . +'\x{52D7}\x{52D8}\x{52D9}\x{52DD}\x{52DE}\x{52DF}\x{52E0}\x{52E2}\x{52E3}' . +'\x{52E4}\x{52E6}\x{52E7}\x{52F2}\x{52F3}\x{52F5}\x{52F8}\x{52F9}\x{52FA}' . +'\x{52FE}\x{52FF}\x{5301}\x{5302}\x{5305}\x{5306}\x{5308}\x{530D}\x{530F}' . +'\x{5310}\x{5315}\x{5316}\x{5317}\x{5319}\x{531A}\x{531D}\x{5320}\x{5321}' . +'\x{5323}\x{532A}\x{532F}\x{5331}\x{5333}\x{5338}\x{5339}\x{533A}\x{533B}' . +'\x{533F}\x{5340}\x{5341}\x{5343}\x{5345}\x{5346}\x{5347}\x{5348}\x{5349}' . +'\x{534A}\x{534D}\x{5351}\x{5352}\x{5353}\x{5354}\x{5357}\x{5358}\x{535A}' . +'\x{535C}\x{535E}\x{5360}\x{5366}\x{5369}\x{536E}\x{536F}\x{5370}\x{5371}' . +'\x{5373}\x{5374}\x{5375}\x{5377}\x{5378}\x{537B}\x{537F}\x{5382}\x{5384}' . +'\x{5396}\x{5398}\x{539A}\x{539F}\x{53A0}\x{53A5}\x{53A6}\x{53A8}\x{53A9}' . +'\x{53AD}\x{53AE}\x{53B0}\x{53B3}\x{53B6}\x{53BB}\x{53C2}\x{53C3}\x{53C8}' . +'\x{53C9}\x{53CA}\x{53CB}\x{53CC}\x{53CD}\x{53CE}\x{53D4}\x{53D6}\x{53D7}' . +'\x{53D9}\x{53DB}\x{53DF}\x{53E1}\x{53E2}\x{53E3}\x{53E4}\x{53E5}\x{53E8}' . +'\x{53E9}\x{53EA}\x{53EB}\x{53EC}\x{53ED}\x{53EE}\x{53EF}\x{53F0}\x{53F1}' . +'\x{53F2}\x{53F3}\x{53F6}\x{53F7}\x{53F8}\x{53FA}\x{5401}\x{5403}\x{5404}' . +'\x{5408}\x{5409}\x{540A}\x{540B}\x{540C}\x{540D}\x{540E}\x{540F}\x{5410}' . +'\x{5411}\x{541B}\x{541D}\x{541F}\x{5420}\x{5426}\x{5429}\x{542B}\x{542C}' . +'\x{542D}\x{542E}\x{5436}\x{5438}\x{5439}\x{543B}\x{543C}\x{543D}\x{543E}' . +'\x{5440}\x{5442}\x{5446}\x{5448}\x{5449}\x{544A}\x{544E}\x{5451}\x{545F}' . +'\x{5468}\x{546A}\x{5470}\x{5471}\x{5473}\x{5475}\x{5476}\x{5477}\x{547B}' . +'\x{547C}\x{547D}\x{5480}\x{5484}\x{5486}\x{548B}\x{548C}\x{548E}\x{548F}' . +'\x{5490}\x{5492}\x{54A2}\x{54A4}\x{54A5}\x{54A8}\x{54AB}\x{54AC}\x{54AF}' . +'\x{54B2}\x{54B3}\x{54B8}\x{54BC}\x{54BD}\x{54BE}\x{54C0}\x{54C1}\x{54C2}' . +'\x{54C4}\x{54C7}\x{54C8}\x{54C9}\x{54D8}\x{54E1}\x{54E2}\x{54E5}\x{54E6}' . +'\x{54E8}\x{54E9}\x{54ED}\x{54EE}\x{54F2}\x{54FA}\x{54FD}\x{5504}\x{5506}' . +'\x{5507}\x{550F}\x{5510}\x{5514}\x{5516}\x{552E}\x{552F}\x{5531}\x{5533}' . +'\x{5538}\x{5539}\x{553E}\x{5540}\x{5544}\x{5545}\x{5546}\x{554C}\x{554F}' . +'\x{5553}\x{5556}\x{5557}\x{555C}\x{555D}\x{5563}\x{557B}\x{557C}\x{557E}' . +'\x{5580}\x{5583}\x{5584}\x{5587}\x{5589}\x{558A}\x{558B}\x{5598}\x{5599}' . +'\x{559A}\x{559C}\x{559D}\x{559E}\x{559F}\x{55A7}\x{55A8}\x{55A9}\x{55AA}' . +'\x{55AB}\x{55AC}\x{55AE}\x{55B0}\x{55B6}\x{55C4}\x{55C5}\x{55C7}\x{55D4}' . +'\x{55DA}\x{55DC}\x{55DF}\x{55E3}\x{55E4}\x{55F7}\x{55F9}\x{55FD}\x{55FE}' . +'\x{5606}\x{5609}\x{5614}\x{5616}\x{5617}\x{5618}\x{561B}\x{5629}\x{562F}' . +'\x{5631}\x{5632}\x{5634}\x{5636}\x{5638}\x{5642}\x{564C}\x{564E}\x{5650}' . +'\x{565B}\x{5664}\x{5668}\x{566A}\x{566B}\x{566C}\x{5674}\x{5678}\x{567A}' . +'\x{5680}\x{5686}\x{5687}\x{568A}\x{568F}\x{5694}\x{56A0}\x{56A2}\x{56A5}' . +'\x{56AE}\x{56B4}\x{56B6}\x{56BC}\x{56C0}\x{56C1}\x{56C2}\x{56C3}\x{56C8}' . +'\x{56CE}\x{56D1}\x{56D3}\x{56D7}\x{56D8}\x{56DA}\x{56DB}\x{56DE}\x{56E0}' . +'\x{56E3}\x{56EE}\x{56F0}\x{56F2}\x{56F3}\x{56F9}\x{56FA}\x{56FD}\x{56FF}' . +'\x{5700}\x{5703}\x{5704}\x{5708}\x{5709}\x{570B}\x{570D}\x{570F}\x{5712}' . +'\x{5713}\x{5716}\x{5718}\x{571C}\x{571F}\x{5726}\x{5727}\x{5728}\x{572D}' . +'\x{5730}\x{5737}\x{5738}\x{573B}\x{5740}\x{5742}\x{5747}\x{574A}\x{574E}' . +'\x{574F}\x{5750}\x{5751}\x{5761}\x{5764}\x{5766}\x{5769}\x{576A}\x{577F}' . +'\x{5782}\x{5788}\x{5789}\x{578B}\x{5793}\x{57A0}\x{57A2}\x{57A3}\x{57A4}' . +'\x{57AA}\x{57B0}\x{57B3}\x{57C0}\x{57C3}\x{57C6}\x{57CB}\x{57CE}\x{57D2}' . +'\x{57D3}\x{57D4}\x{57D6}\x{57DC}\x{57DF}\x{57E0}\x{57E3}\x{57F4}\x{57F7}' . +'\x{57F9}\x{57FA}\x{57FC}\x{5800}\x{5802}\x{5805}\x{5806}\x{580A}\x{580B}' . +'\x{5815}\x{5819}\x{581D}\x{5821}\x{5824}\x{582A}\x{582F}\x{5830}\x{5831}' . +'\x{5834}\x{5835}\x{583A}\x{583D}\x{5840}\x{5841}\x{584A}\x{584B}\x{5851}' . +'\x{5852}\x{5854}\x{5857}\x{5858}\x{5859}\x{585A}\x{585E}\x{5862}\x{5869}' . +'\x{586B}\x{5870}\x{5872}\x{5875}\x{5879}\x{587E}\x{5883}\x{5885}\x{5893}' . +'\x{5897}\x{589C}\x{589F}\x{58A8}\x{58AB}\x{58AE}\x{58B3}\x{58B8}\x{58B9}' . +'\x{58BA}\x{58BB}\x{58BE}\x{58C1}\x{58C5}\x{58C7}\x{58CA}\x{58CC}\x{58D1}' . +'\x{58D3}\x{58D5}\x{58D7}\x{58D8}\x{58D9}\x{58DC}\x{58DE}\x{58DF}\x{58E4}' . +'\x{58E5}\x{58EB}\x{58EC}\x{58EE}\x{58EF}\x{58F0}\x{58F1}\x{58F2}\x{58F7}' . +'\x{58F9}\x{58FA}\x{58FB}\x{58FC}\x{58FD}\x{5902}\x{5909}\x{590A}\x{590F}' . +'\x{5910}\x{5915}\x{5916}\x{5918}\x{5919}\x{591A}\x{591B}\x{591C}\x{5922}' . +'\x{5925}\x{5927}\x{5929}\x{592A}\x{592B}\x{592C}\x{592D}\x{592E}\x{5931}' . +'\x{5932}\x{5937}\x{5938}\x{593E}\x{5944}\x{5947}\x{5948}\x{5949}\x{594E}' . +'\x{594F}\x{5950}\x{5951}\x{5954}\x{5955}\x{5957}\x{5958}\x{595A}\x{5960}' . +'\x{5962}\x{5965}\x{5967}\x{5968}\x{5969}\x{596A}\x{596C}\x{596E}\x{5973}' . +'\x{5974}\x{5978}\x{597D}\x{5981}\x{5982}\x{5983}\x{5984}\x{598A}\x{598D}' . +'\x{5993}\x{5996}\x{5999}\x{599B}\x{599D}\x{59A3}\x{59A5}\x{59A8}\x{59AC}' . +'\x{59B2}\x{59B9}\x{59BB}\x{59BE}\x{59C6}\x{59C9}\x{59CB}\x{59D0}\x{59D1}' . +'\x{59D3}\x{59D4}\x{59D9}\x{59DA}\x{59DC}\x{59E5}\x{59E6}\x{59E8}\x{59EA}' . +'\x{59EB}\x{59F6}\x{59FB}\x{59FF}\x{5A01}\x{5A03}\x{5A09}\x{5A11}\x{5A18}' . +'\x{5A1A}\x{5A1C}\x{5A1F}\x{5A20}\x{5A25}\x{5A29}\x{5A2F}\x{5A35}\x{5A36}' . +'\x{5A3C}\x{5A40}\x{5A41}\x{5A46}\x{5A49}\x{5A5A}\x{5A62}\x{5A66}\x{5A6A}' . +'\x{5A6C}\x{5A7F}\x{5A92}\x{5A9A}\x{5A9B}\x{5ABC}\x{5ABD}\x{5ABE}\x{5AC1}' . +'\x{5AC2}\x{5AC9}\x{5ACB}\x{5ACC}\x{5AD0}\x{5AD6}\x{5AD7}\x{5AE1}\x{5AE3}' . +'\x{5AE6}\x{5AE9}\x{5AFA}\x{5AFB}\x{5B09}\x{5B0B}\x{5B0C}\x{5B16}\x{5B22}' . +'\x{5B2A}\x{5B2C}\x{5B30}\x{5B32}\x{5B36}\x{5B3E}\x{5B40}\x{5B43}\x{5B45}' . +'\x{5B50}\x{5B51}\x{5B54}\x{5B55}\x{5B57}\x{5B58}\x{5B5A}\x{5B5B}\x{5B5C}' . +'\x{5B5D}\x{5B5F}\x{5B63}\x{5B64}\x{5B65}\x{5B66}\x{5B69}\x{5B6B}\x{5B70}' . +'\x{5B71}\x{5B73}\x{5B75}\x{5B78}\x{5B7A}\x{5B80}\x{5B83}\x{5B85}\x{5B87}' . +'\x{5B88}\x{5B89}\x{5B8B}\x{5B8C}\x{5B8D}\x{5B8F}\x{5B95}\x{5B97}\x{5B98}' . +'\x{5B99}\x{5B9A}\x{5B9B}\x{5B9C}\x{5B9D}\x{5B9F}\x{5BA2}\x{5BA3}\x{5BA4}' . +'\x{5BA5}\x{5BA6}\x{5BAE}\x{5BB0}\x{5BB3}\x{5BB4}\x{5BB5}\x{5BB6}\x{5BB8}' . +'\x{5BB9}\x{5BBF}\x{5BC2}\x{5BC3}\x{5BC4}\x{5BC5}\x{5BC6}\x{5BC7}\x{5BC9}' . +'\x{5BCC}\x{5BD0}\x{5BD2}\x{5BD3}\x{5BD4}\x{5BDB}\x{5BDD}\x{5BDE}\x{5BDF}' . +'\x{5BE1}\x{5BE2}\x{5BE4}\x{5BE5}\x{5BE6}\x{5BE7}\x{5BE8}\x{5BE9}\x{5BEB}' . +'\x{5BEE}\x{5BF0}\x{5BF3}\x{5BF5}\x{5BF6}\x{5BF8}\x{5BFA}\x{5BFE}\x{5BFF}' . +'\x{5C01}\x{5C02}\x{5C04}\x{5C05}\x{5C06}\x{5C07}\x{5C08}\x{5C09}\x{5C0A}' . +'\x{5C0B}\x{5C0D}\x{5C0E}\x{5C0F}\x{5C11}\x{5C13}\x{5C16}\x{5C1A}\x{5C20}' . +'\x{5C22}\x{5C24}\x{5C28}\x{5C2D}\x{5C31}\x{5C38}\x{5C39}\x{5C3A}\x{5C3B}' . +'\x{5C3C}\x{5C3D}\x{5C3E}\x{5C3F}\x{5C40}\x{5C41}\x{5C45}\x{5C46}\x{5C48}' . +'\x{5C4A}\x{5C4B}\x{5C4D}\x{5C4E}\x{5C4F}\x{5C50}\x{5C51}\x{5C53}\x{5C55}' . +'\x{5C5E}\x{5C60}\x{5C61}\x{5C64}\x{5C65}\x{5C6C}\x{5C6E}\x{5C6F}\x{5C71}' . +'\x{5C76}\x{5C79}\x{5C8C}\x{5C90}\x{5C91}\x{5C94}\x{5CA1}\x{5CA8}\x{5CA9}' . +'\x{5CAB}\x{5CAC}\x{5CB1}\x{5CB3}\x{5CB6}\x{5CB7}\x{5CB8}\x{5CBB}\x{5CBC}' . +'\x{5CBE}\x{5CC5}\x{5CC7}\x{5CD9}\x{5CE0}\x{5CE1}\x{5CE8}\x{5CE9}\x{5CEA}' . +'\x{5CED}\x{5CEF}\x{5CF0}\x{5CF6}\x{5CFA}\x{5CFB}\x{5CFD}\x{5D07}\x{5D0B}' . +'\x{5D0E}\x{5D11}\x{5D14}\x{5D15}\x{5D16}\x{5D17}\x{5D18}\x{5D19}\x{5D1A}' . +'\x{5D1B}\x{5D1F}\x{5D22}\x{5D29}\x{5D4B}\x{5D4C}\x{5D4E}\x{5D50}\x{5D52}' . +'\x{5D5C}\x{5D69}\x{5D6C}\x{5D6F}\x{5D73}\x{5D76}\x{5D82}\x{5D84}\x{5D87}' . +'\x{5D8B}\x{5D8C}\x{5D90}\x{5D9D}\x{5DA2}\x{5DAC}\x{5DAE}\x{5DB7}\x{5DBA}' . +'\x{5DBC}\x{5DBD}\x{5DC9}\x{5DCC}\x{5DCD}\x{5DD2}\x{5DD3}\x{5DD6}\x{5DDB}' . +'\x{5DDD}\x{5DDE}\x{5DE1}\x{5DE3}\x{5DE5}\x{5DE6}\x{5DE7}\x{5DE8}\x{5DEB}' . +'\x{5DEE}\x{5DF1}\x{5DF2}\x{5DF3}\x{5DF4}\x{5DF5}\x{5DF7}\x{5DFB}\x{5DFD}' . +'\x{5DFE}\x{5E02}\x{5E03}\x{5E06}\x{5E0B}\x{5E0C}\x{5E11}\x{5E16}\x{5E19}' . +'\x{5E1A}\x{5E1B}\x{5E1D}\x{5E25}\x{5E2B}\x{5E2D}\x{5E2F}\x{5E30}\x{5E33}' . +'\x{5E36}\x{5E37}\x{5E38}\x{5E3D}\x{5E40}\x{5E43}\x{5E44}\x{5E45}\x{5E47}' . +'\x{5E4C}\x{5E4E}\x{5E54}\x{5E55}\x{5E57}\x{5E5F}\x{5E61}\x{5E62}\x{5E63}' . +'\x{5E64}\x{5E72}\x{5E73}\x{5E74}\x{5E75}\x{5E76}\x{5E78}\x{5E79}\x{5E7A}' . +'\x{5E7B}\x{5E7C}\x{5E7D}\x{5E7E}\x{5E7F}\x{5E81}\x{5E83}\x{5E84}\x{5E87}' . +'\x{5E8A}\x{5E8F}\x{5E95}\x{5E96}\x{5E97}\x{5E9A}\x{5E9C}\x{5EA0}\x{5EA6}' . +'\x{5EA7}\x{5EAB}\x{5EAD}\x{5EB5}\x{5EB6}\x{5EB7}\x{5EB8}\x{5EC1}\x{5EC2}' . +'\x{5EC3}\x{5EC8}\x{5EC9}\x{5ECA}\x{5ECF}\x{5ED0}\x{5ED3}\x{5ED6}\x{5EDA}' . +'\x{5EDB}\x{5EDD}\x{5EDF}\x{5EE0}\x{5EE1}\x{5EE2}\x{5EE3}\x{5EE8}\x{5EE9}' . +'\x{5EEC}\x{5EF0}\x{5EF1}\x{5EF3}\x{5EF4}\x{5EF6}\x{5EF7}\x{5EF8}\x{5EFA}' . +'\x{5EFB}\x{5EFC}\x{5EFE}\x{5EFF}\x{5F01}\x{5F03}\x{5F04}\x{5F09}\x{5F0A}' . +'\x{5F0B}\x{5F0C}\x{5F0D}\x{5F0F}\x{5F10}\x{5F11}\x{5F13}\x{5F14}\x{5F15}' . +'\x{5F16}\x{5F17}\x{5F18}\x{5F1B}\x{5F1F}\x{5F25}\x{5F26}\x{5F27}\x{5F29}' . +'\x{5F2D}\x{5F2F}\x{5F31}\x{5F35}\x{5F37}\x{5F38}\x{5F3C}\x{5F3E}\x{5F41}' . +'\x{5F48}\x{5F4A}\x{5F4C}\x{5F4E}\x{5F51}\x{5F53}\x{5F56}\x{5F57}\x{5F59}' . +'\x{5F5C}\x{5F5D}\x{5F61}\x{5F62}\x{5F66}\x{5F69}\x{5F6A}\x{5F6B}\x{5F6C}' . +'\x{5F6D}\x{5F70}\x{5F71}\x{5F73}\x{5F77}\x{5F79}\x{5F7C}\x{5F7F}\x{5F80}' . +'\x{5F81}\x{5F82}\x{5F83}\x{5F84}\x{5F85}\x{5F87}\x{5F88}\x{5F8A}\x{5F8B}' . +'\x{5F8C}\x{5F90}\x{5F91}\x{5F92}\x{5F93}\x{5F97}\x{5F98}\x{5F99}\x{5F9E}' . +'\x{5FA0}\x{5FA1}\x{5FA8}\x{5FA9}\x{5FAA}\x{5FAD}\x{5FAE}\x{5FB3}\x{5FB4}' . +'\x{5FB9}\x{5FBC}\x{5FBD}\x{5FC3}\x{5FC5}\x{5FCC}\x{5FCD}\x{5FD6}\x{5FD7}' . +'\x{5FD8}\x{5FD9}\x{5FDC}\x{5FDD}\x{5FE0}\x{5FE4}\x{5FEB}\x{5FF0}\x{5FF1}' . +'\x{5FF5}\x{5FF8}\x{5FFB}\x{5FFD}\x{5FFF}\x{600E}\x{600F}\x{6010}\x{6012}' . +'\x{6015}\x{6016}\x{6019}\x{601B}\x{601C}\x{601D}\x{6020}\x{6021}\x{6025}' . +'\x{6026}\x{6027}\x{6028}\x{6029}\x{602A}\x{602B}\x{602F}\x{6031}\x{603A}' . +'\x{6041}\x{6042}\x{6043}\x{6046}\x{604A}\x{604B}\x{604D}\x{6050}\x{6052}' . +'\x{6055}\x{6059}\x{605A}\x{605F}\x{6060}\x{6062}\x{6063}\x{6064}\x{6065}' . +'\x{6068}\x{6069}\x{606A}\x{606B}\x{606C}\x{606D}\x{606F}\x{6070}\x{6075}' . +'\x{6077}\x{6081}\x{6083}\x{6084}\x{6089}\x{608B}\x{608C}\x{608D}\x{6092}' . +'\x{6094}\x{6096}\x{6097}\x{609A}\x{609B}\x{609F}\x{60A0}\x{60A3}\x{60A6}' . +'\x{60A7}\x{60A9}\x{60AA}\x{60B2}\x{60B3}\x{60B4}\x{60B5}\x{60B6}\x{60B8}' . +'\x{60BC}\x{60BD}\x{60C5}\x{60C6}\x{60C7}\x{60D1}\x{60D3}\x{60D8}\x{60DA}' . +'\x{60DC}\x{60DF}\x{60E0}\x{60E1}\x{60E3}\x{60E7}\x{60E8}\x{60F0}\x{60F1}' . +'\x{60F3}\x{60F4}\x{60F6}\x{60F7}\x{60F9}\x{60FA}\x{60FB}\x{6100}\x{6101}' . +'\x{6103}\x{6106}\x{6108}\x{6109}\x{610D}\x{610E}\x{610F}\x{6115}\x{611A}' . +'\x{611B}\x{611F}\x{6121}\x{6127}\x{6128}\x{612C}\x{6134}\x{613C}\x{613D}' . +'\x{613E}\x{613F}\x{6142}\x{6144}\x{6147}\x{6148}\x{614A}\x{614B}\x{614C}' . +'\x{614D}\x{614E}\x{6153}\x{6155}\x{6158}\x{6159}\x{615A}\x{615D}\x{615F}' . +'\x{6162}\x{6163}\x{6165}\x{6167}\x{6168}\x{616B}\x{616E}\x{616F}\x{6170}' . +'\x{6171}\x{6173}\x{6174}\x{6175}\x{6176}\x{6177}\x{617E}\x{6182}\x{6187}' . +'\x{618A}\x{618E}\x{6190}\x{6191}\x{6194}\x{6196}\x{6199}\x{619A}\x{61A4}' . +'\x{61A7}\x{61A9}\x{61AB}\x{61AC}\x{61AE}\x{61B2}\x{61B6}\x{61BA}\x{61BE}' . +'\x{61C3}\x{61C6}\x{61C7}\x{61C8}\x{61C9}\x{61CA}\x{61CB}\x{61CC}\x{61CD}' . +'\x{61D0}\x{61E3}\x{61E6}\x{61F2}\x{61F4}\x{61F6}\x{61F7}\x{61F8}\x{61FA}' . +'\x{61FC}\x{61FD}\x{61FE}\x{61FF}\x{6200}\x{6208}\x{6209}\x{620A}\x{620C}' . +'\x{620D}\x{620E}\x{6210}\x{6211}\x{6212}\x{6214}\x{6216}\x{621A}\x{621B}' . +'\x{621D}\x{621E}\x{621F}\x{6221}\x{6226}\x{622A}\x{622E}\x{622F}\x{6230}' . +'\x{6232}\x{6233}\x{6234}\x{6238}\x{623B}\x{623F}\x{6240}\x{6241}\x{6247}' . +'\x{6248}\x{6249}\x{624B}\x{624D}\x{624E}\x{6253}\x{6255}\x{6258}\x{625B}' . +'\x{625E}\x{6260}\x{6263}\x{6268}\x{626E}\x{6271}\x{6276}\x{6279}\x{627C}' . +'\x{627E}\x{627F}\x{6280}\x{6282}\x{6283}\x{6284}\x{6289}\x{628A}\x{6291}' . +'\x{6292}\x{6293}\x{6294}\x{6295}\x{6296}\x{6297}\x{6298}\x{629B}\x{629C}' . +'\x{629E}\x{62AB}\x{62AC}\x{62B1}\x{62B5}\x{62B9}\x{62BB}\x{62BC}\x{62BD}' . +'\x{62C2}\x{62C5}\x{62C6}\x{62C7}\x{62C8}\x{62C9}\x{62CA}\x{62CC}\x{62CD}' . +'\x{62CF}\x{62D0}\x{62D1}\x{62D2}\x{62D3}\x{62D4}\x{62D7}\x{62D8}\x{62D9}' . +'\x{62DB}\x{62DC}\x{62DD}\x{62E0}\x{62E1}\x{62EC}\x{62ED}\x{62EE}\x{62EF}' . +'\x{62F1}\x{62F3}\x{62F5}\x{62F6}\x{62F7}\x{62FE}\x{62FF}\x{6301}\x{6302}' . +'\x{6307}\x{6308}\x{6309}\x{630C}\x{6311}\x{6319}\x{631F}\x{6327}\x{6328}' . +'\x{632B}\x{632F}\x{633A}\x{633D}\x{633E}\x{633F}\x{6349}\x{634C}\x{634D}' . +'\x{634F}\x{6350}\x{6355}\x{6357}\x{635C}\x{6367}\x{6368}\x{6369}\x{636B}' . +'\x{636E}\x{6372}\x{6376}\x{6377}\x{637A}\x{637B}\x{6380}\x{6383}\x{6388}' . +'\x{6389}\x{638C}\x{638E}\x{638F}\x{6392}\x{6396}\x{6398}\x{639B}\x{639F}' . +'\x{63A0}\x{63A1}\x{63A2}\x{63A3}\x{63A5}\x{63A7}\x{63A8}\x{63A9}\x{63AA}' . +'\x{63AB}\x{63AC}\x{63B2}\x{63B4}\x{63B5}\x{63BB}\x{63BE}\x{63C0}\x{63C3}' . +'\x{63C4}\x{63C6}\x{63C9}\x{63CF}\x{63D0}\x{63D2}\x{63D6}\x{63DA}\x{63DB}' . +'\x{63E1}\x{63E3}\x{63E9}\x{63EE}\x{63F4}\x{63F6}\x{63FA}\x{6406}\x{640D}' . +'\x{640F}\x{6413}\x{6416}\x{6417}\x{641C}\x{6426}\x{6428}\x{642C}\x{642D}' . +'\x{6434}\x{6436}\x{643A}\x{643E}\x{6442}\x{644E}\x{6458}\x{6467}\x{6469}' . +'\x{646F}\x{6476}\x{6478}\x{647A}\x{6483}\x{6488}\x{6492}\x{6493}\x{6495}' . +'\x{649A}\x{649E}\x{64A4}\x{64A5}\x{64A9}\x{64AB}\x{64AD}\x{64AE}\x{64B0}' . +'\x{64B2}\x{64B9}\x{64BB}\x{64BC}\x{64C1}\x{64C2}\x{64C5}\x{64C7}\x{64CD}' . +'\x{64D2}\x{64D4}\x{64D8}\x{64DA}\x{64E0}\x{64E1}\x{64E2}\x{64E3}\x{64E6}' . +'\x{64E7}\x{64EC}\x{64EF}\x{64F1}\x{64F2}\x{64F4}\x{64F6}\x{64FA}\x{64FD}' . +'\x{64FE}\x{6500}\x{6505}\x{6518}\x{651C}\x{651D}\x{6523}\x{6524}\x{652A}' . +'\x{652B}\x{652C}\x{652F}\x{6534}\x{6535}\x{6536}\x{6537}\x{6538}\x{6539}' . +'\x{653B}\x{653E}\x{653F}\x{6545}\x{6548}\x{654D}\x{654F}\x{6551}\x{6555}' . +'\x{6556}\x{6557}\x{6558}\x{6559}\x{655D}\x{655E}\x{6562}\x{6563}\x{6566}' . +'\x{656C}\x{6570}\x{6572}\x{6574}\x{6575}\x{6577}\x{6578}\x{6582}\x{6583}' . +'\x{6587}\x{6588}\x{6589}\x{658C}\x{658E}\x{6590}\x{6591}\x{6597}\x{6599}' . +'\x{659B}\x{659C}\x{659F}\x{65A1}\x{65A4}\x{65A5}\x{65A7}\x{65AB}\x{65AC}' . +'\x{65AD}\x{65AF}\x{65B0}\x{65B7}\x{65B9}\x{65BC}\x{65BD}\x{65C1}\x{65C3}' . +'\x{65C4}\x{65C5}\x{65C6}\x{65CB}\x{65CC}\x{65CF}\x{65D2}\x{65D7}\x{65D9}' . +'\x{65DB}\x{65E0}\x{65E1}\x{65E2}\x{65E5}\x{65E6}\x{65E7}\x{65E8}\x{65E9}' . +'\x{65EC}\x{65ED}\x{65F1}\x{65FA}\x{65FB}\x{6602}\x{6603}\x{6606}\x{6607}' . +'\x{660A}\x{660C}\x{660E}\x{660F}\x{6613}\x{6614}\x{661C}\x{661F}\x{6620}' . +'\x{6625}\x{6627}\x{6628}\x{662D}\x{662F}\x{6634}\x{6635}\x{6636}\x{663C}' . +'\x{663F}\x{6641}\x{6642}\x{6643}\x{6644}\x{6649}\x{664B}\x{664F}\x{6652}' . +'\x{665D}\x{665E}\x{665F}\x{6662}\x{6664}\x{6666}\x{6667}\x{6668}\x{6669}' . +'\x{666E}\x{666F}\x{6670}\x{6674}\x{6676}\x{667A}\x{6681}\x{6683}\x{6684}' . +'\x{6687}\x{6688}\x{6689}\x{668E}\x{6691}\x{6696}\x{6697}\x{6698}\x{669D}' . +'\x{66A2}\x{66A6}\x{66AB}\x{66AE}\x{66B4}\x{66B8}\x{66B9}\x{66BC}\x{66BE}' . +'\x{66C1}\x{66C4}\x{66C7}\x{66C9}\x{66D6}\x{66D9}\x{66DA}\x{66DC}\x{66DD}' . +'\x{66E0}\x{66E6}\x{66E9}\x{66F0}\x{66F2}\x{66F3}\x{66F4}\x{66F5}\x{66F7}' . +'\x{66F8}\x{66F9}\x{66FC}\x{66FD}\x{66FE}\x{66FF}\x{6700}\x{6703}\x{6708}' . +'\x{6709}\x{670B}\x{670D}\x{670F}\x{6714}\x{6715}\x{6716}\x{6717}\x{671B}' . +'\x{671D}\x{671E}\x{671F}\x{6726}\x{6727}\x{6728}\x{672A}\x{672B}\x{672C}' . +'\x{672D}\x{672E}\x{6731}\x{6734}\x{6736}\x{6737}\x{6738}\x{673A}\x{673D}' . +'\x{673F}\x{6741}\x{6746}\x{6749}\x{674E}\x{674F}\x{6750}\x{6751}\x{6753}' . +'\x{6756}\x{6759}\x{675C}\x{675E}\x{675F}\x{6760}\x{6761}\x{6762}\x{6763}' . +'\x{6764}\x{6765}\x{676A}\x{676D}\x{676F}\x{6770}\x{6771}\x{6772}\x{6773}' . +'\x{6775}\x{6777}\x{677C}\x{677E}\x{677F}\x{6785}\x{6787}\x{6789}\x{678B}' . +'\x{678C}\x{6790}\x{6795}\x{6797}\x{679A}\x{679C}\x{679D}\x{67A0}\x{67A1}' . +'\x{67A2}\x{67A6}\x{67A9}\x{67AF}\x{67B3}\x{67B4}\x{67B6}\x{67B7}\x{67B8}' . +'\x{67B9}\x{67C1}\x{67C4}\x{67C6}\x{67CA}\x{67CE}\x{67CF}\x{67D0}\x{67D1}' . +'\x{67D3}\x{67D4}\x{67D8}\x{67DA}\x{67DD}\x{67DE}\x{67E2}\x{67E4}\x{67E7}' . +'\x{67E9}\x{67EC}\x{67EE}\x{67EF}\x{67F1}\x{67F3}\x{67F4}\x{67F5}\x{67FB}' . +'\x{67FE}\x{67FF}\x{6802}\x{6803}\x{6804}\x{6813}\x{6816}\x{6817}\x{681E}' . +'\x{6821}\x{6822}\x{6829}\x{682A}\x{682B}\x{6832}\x{6834}\x{6838}\x{6839}' . +'\x{683C}\x{683D}\x{6840}\x{6841}\x{6842}\x{6843}\x{6846}\x{6848}\x{684D}' . +'\x{684E}\x{6850}\x{6851}\x{6853}\x{6854}\x{6859}\x{685C}\x{685D}\x{685F}' . +'\x{6863}\x{6867}\x{6874}\x{6876}\x{6877}\x{687E}\x{687F}\x{6881}\x{6883}' . +'\x{6885}\x{688D}\x{688F}\x{6893}\x{6894}\x{6897}\x{689B}\x{689D}\x{689F}' . +'\x{68A0}\x{68A2}\x{68A6}\x{68A7}\x{68A8}\x{68AD}\x{68AF}\x{68B0}\x{68B1}' . +'\x{68B3}\x{68B5}\x{68B6}\x{68B9}\x{68BA}\x{68BC}\x{68C4}\x{68C6}\x{68C9}' . +'\x{68CA}\x{68CB}\x{68CD}\x{68D2}\x{68D4}\x{68D5}\x{68D7}\x{68D8}\x{68DA}' . +'\x{68DF}\x{68E0}\x{68E1}\x{68E3}\x{68E7}\x{68EE}\x{68EF}\x{68F2}\x{68F9}' . +'\x{68FA}\x{6900}\x{6901}\x{6904}\x{6905}\x{6908}\x{690B}\x{690C}\x{690D}' . +'\x{690E}\x{690F}\x{6912}\x{6919}\x{691A}\x{691B}\x{691C}\x{6921}\x{6922}' . +'\x{6923}\x{6925}\x{6926}\x{6928}\x{692A}\x{6930}\x{6934}\x{6936}\x{6939}' . +'\x{693D}\x{693F}\x{694A}\x{6953}\x{6954}\x{6955}\x{6959}\x{695A}\x{695C}' . +'\x{695D}\x{695E}\x{6960}\x{6961}\x{6962}\x{696A}\x{696B}\x{696D}\x{696E}' . +'\x{696F}\x{6973}\x{6974}\x{6975}\x{6977}\x{6978}\x{6979}\x{697C}\x{697D}' . +'\x{697E}\x{6981}\x{6982}\x{698A}\x{698E}\x{6991}\x{6994}\x{6995}\x{699B}' . +'\x{699C}\x{69A0}\x{69A7}\x{69AE}\x{69B1}\x{69B2}\x{69B4}\x{69BB}\x{69BE}' . +'\x{69BF}\x{69C1}\x{69C3}\x{69C7}\x{69CA}\x{69CB}\x{69CC}\x{69CD}\x{69CE}' . +'\x{69D0}\x{69D3}\x{69D8}\x{69D9}\x{69DD}\x{69DE}\x{69E7}\x{69E8}\x{69EB}' . +'\x{69ED}\x{69F2}\x{69F9}\x{69FB}\x{69FD}\x{69FF}\x{6A02}\x{6A05}\x{6A0A}' . +'\x{6A0B}\x{6A0C}\x{6A12}\x{6A13}\x{6A14}\x{6A17}\x{6A19}\x{6A1B}\x{6A1E}' . +'\x{6A1F}\x{6A21}\x{6A22}\x{6A23}\x{6A29}\x{6A2A}\x{6A2B}\x{6A2E}\x{6A35}' . +'\x{6A36}\x{6A38}\x{6A39}\x{6A3A}\x{6A3D}\x{6A44}\x{6A47}\x{6A48}\x{6A4B}' . +'\x{6A58}\x{6A59}\x{6A5F}\x{6A61}\x{6A62}\x{6A66}\x{6A72}\x{6A78}\x{6A7F}' . +'\x{6A80}\x{6A84}\x{6A8D}\x{6A8E}\x{6A90}\x{6A97}\x{6A9C}\x{6AA0}\x{6AA2}' . +'\x{6AA3}\x{6AAA}\x{6AAC}\x{6AAE}\x{6AB3}\x{6AB8}\x{6ABB}\x{6AC1}\x{6AC2}' . +'\x{6AC3}\x{6AD1}\x{6AD3}\x{6ADA}\x{6ADB}\x{6ADE}\x{6ADF}\x{6AE8}\x{6AEA}' . +'\x{6AFA}\x{6AFB}\x{6B04}\x{6B05}\x{6B0A}\x{6B12}\x{6B16}\x{6B1D}\x{6B1F}' . +'\x{6B20}\x{6B21}\x{6B23}\x{6B27}\x{6B32}\x{6B37}\x{6B38}\x{6B39}\x{6B3A}' . +'\x{6B3D}\x{6B3E}\x{6B43}\x{6B47}\x{6B49}\x{6B4C}\x{6B4E}\x{6B50}\x{6B53}' . +'\x{6B54}\x{6B59}\x{6B5B}\x{6B5F}\x{6B61}\x{6B62}\x{6B63}\x{6B64}\x{6B66}' . +'\x{6B69}\x{6B6A}\x{6B6F}\x{6B73}\x{6B74}\x{6B78}\x{6B79}\x{6B7B}\x{6B7F}' . +'\x{6B80}\x{6B83}\x{6B84}\x{6B86}\x{6B89}\x{6B8A}\x{6B8B}\x{6B8D}\x{6B95}' . +'\x{6B96}\x{6B98}\x{6B9E}\x{6BA4}\x{6BAA}\x{6BAB}\x{6BAF}\x{6BB1}\x{6BB2}' . +'\x{6BB3}\x{6BB4}\x{6BB5}\x{6BB7}\x{6BBA}\x{6BBB}\x{6BBC}\x{6BBF}\x{6BC0}' . +'\x{6BC5}\x{6BC6}\x{6BCB}\x{6BCD}\x{6BCE}\x{6BD2}\x{6BD3}\x{6BD4}\x{6BD8}' . +'\x{6BDB}\x{6BDF}\x{6BEB}\x{6BEC}\x{6BEF}\x{6BF3}\x{6C08}\x{6C0F}\x{6C11}' . +'\x{6C13}\x{6C14}\x{6C17}\x{6C1B}\x{6C23}\x{6C24}\x{6C34}\x{6C37}\x{6C38}' . +'\x{6C3E}\x{6C40}\x{6C41}\x{6C42}\x{6C4E}\x{6C50}\x{6C55}\x{6C57}\x{6C5A}' . +'\x{6C5D}\x{6C5E}\x{6C5F}\x{6C60}\x{6C62}\x{6C68}\x{6C6A}\x{6C70}\x{6C72}' . +'\x{6C73}\x{6C7A}\x{6C7D}\x{6C7E}\x{6C81}\x{6C82}\x{6C83}\x{6C88}\x{6C8C}' . +'\x{6C8D}\x{6C90}\x{6C92}\x{6C93}\x{6C96}\x{6C99}\x{6C9A}\x{6C9B}\x{6CA1}' . +'\x{6CA2}\x{6CAB}\x{6CAE}\x{6CB1}\x{6CB3}\x{6CB8}\x{6CB9}\x{6CBA}\x{6CBB}' . +'\x{6CBC}\x{6CBD}\x{6CBE}\x{6CBF}\x{6CC1}\x{6CC4}\x{6CC5}\x{6CC9}\x{6CCA}' . +'\x{6CCC}\x{6CD3}\x{6CD5}\x{6CD7}\x{6CD9}\x{6CDB}\x{6CDD}\x{6CE1}\x{6CE2}' . +'\x{6CE3}\x{6CE5}\x{6CE8}\x{6CEA}\x{6CEF}\x{6CF0}\x{6CF1}\x{6CF3}\x{6D0B}' . +'\x{6D0C}\x{6D12}\x{6D17}\x{6D19}\x{6D1B}\x{6D1E}\x{6D1F}\x{6D25}\x{6D29}' . +'\x{6D2A}\x{6D2B}\x{6D32}\x{6D33}\x{6D35}\x{6D36}\x{6D38}\x{6D3B}\x{6D3D}' . +'\x{6D3E}\x{6D41}\x{6D44}\x{6D45}\x{6D59}\x{6D5A}\x{6D5C}\x{6D63}\x{6D64}' . +'\x{6D66}\x{6D69}\x{6D6A}\x{6D6C}\x{6D6E}\x{6D74}\x{6D77}\x{6D78}\x{6D79}' . +'\x{6D85}\x{6D88}\x{6D8C}\x{6D8E}\x{6D93}\x{6D95}\x{6D99}\x{6D9B}\x{6D9C}' . +'\x{6DAF}\x{6DB2}\x{6DB5}\x{6DB8}\x{6DBC}\x{6DC0}\x{6DC5}\x{6DC6}\x{6DC7}' . +'\x{6DCB}\x{6DCC}\x{6DD1}\x{6DD2}\x{6DD5}\x{6DD8}\x{6DD9}\x{6DDE}\x{6DE1}' . +'\x{6DE4}\x{6DE6}\x{6DE8}\x{6DEA}\x{6DEB}\x{6DEC}\x{6DEE}\x{6DF1}\x{6DF3}' . +'\x{6DF5}\x{6DF7}\x{6DF9}\x{6DFA}\x{6DFB}\x{6E05}\x{6E07}\x{6E08}\x{6E09}' . +'\x{6E0A}\x{6E0B}\x{6E13}\x{6E15}\x{6E19}\x{6E1A}\x{6E1B}\x{6E1D}\x{6E1F}' . +'\x{6E20}\x{6E21}\x{6E23}\x{6E24}\x{6E25}\x{6E26}\x{6E29}\x{6E2B}\x{6E2C}' . +'\x{6E2D}\x{6E2E}\x{6E2F}\x{6E38}\x{6E3A}\x{6E3E}\x{6E43}\x{6E4A}\x{6E4D}' . +'\x{6E4E}\x{6E56}\x{6E58}\x{6E5B}\x{6E5F}\x{6E67}\x{6E6B}\x{6E6E}\x{6E6F}' . +'\x{6E72}\x{6E76}\x{6E7E}\x{6E7F}\x{6E80}\x{6E82}\x{6E8C}\x{6E8F}\x{6E90}' . +'\x{6E96}\x{6E98}\x{6E9C}\x{6E9D}\x{6E9F}\x{6EA2}\x{6EA5}\x{6EAA}\x{6EAF}' . +'\x{6EB2}\x{6EB6}\x{6EB7}\x{6EBA}\x{6EBD}\x{6EC2}\x{6EC4}\x{6EC5}\x{6EC9}' . +'\x{6ECB}\x{6ECC}\x{6ED1}\x{6ED3}\x{6ED4}\x{6ED5}\x{6EDD}\x{6EDE}\x{6EEC}' . +'\x{6EEF}\x{6EF2}\x{6EF4}\x{6EF7}\x{6EF8}\x{6EFE}\x{6EFF}\x{6F01}\x{6F02}' . +'\x{6F06}\x{6F09}\x{6F0F}\x{6F11}\x{6F13}\x{6F14}\x{6F15}\x{6F20}\x{6F22}' . +'\x{6F23}\x{6F2B}\x{6F2C}\x{6F31}\x{6F32}\x{6F38}\x{6F3E}\x{6F3F}\x{6F41}' . +'\x{6F45}\x{6F54}\x{6F58}\x{6F5B}\x{6F5C}\x{6F5F}\x{6F64}\x{6F66}\x{6F6D}' . +'\x{6F6E}\x{6F6F}\x{6F70}\x{6F74}\x{6F78}\x{6F7A}\x{6F7C}\x{6F80}\x{6F81}' . +'\x{6F82}\x{6F84}\x{6F86}\x{6F8E}\x{6F91}\x{6F97}\x{6FA1}\x{6FA3}\x{6FA4}' . +'\x{6FAA}\x{6FB1}\x{6FB3}\x{6FB9}\x{6FC0}\x{6FC1}\x{6FC2}\x{6FC3}\x{6FC6}' . +'\x{6FD4}\x{6FD5}\x{6FD8}\x{6FDB}\x{6FDF}\x{6FE0}\x{6FE1}\x{6FE4}\x{6FEB}' . +'\x{6FEC}\x{6FEE}\x{6FEF}\x{6FF1}\x{6FF3}\x{6FF6}\x{6FFA}\x{6FFE}\x{7001}' . +'\x{7009}\x{700B}\x{700F}\x{7011}\x{7015}\x{7018}\x{701A}\x{701B}\x{701D}' . +'\x{701E}\x{701F}\x{7026}\x{7027}\x{702C}\x{7030}\x{7032}\x{703E}\x{704C}' . +'\x{7051}\x{7058}\x{7063}\x{706B}\x{706F}\x{7070}\x{7078}\x{707C}\x{707D}' . +'\x{7089}\x{708A}\x{708E}\x{7092}\x{7099}\x{70AC}\x{70AD}\x{70AE}\x{70AF}' . +'\x{70B3}\x{70B8}\x{70B9}\x{70BA}\x{70C8}\x{70CB}\x{70CF}\x{70D9}\x{70DD}' . +'\x{70DF}\x{70F1}\x{70F9}\x{70FD}\x{7109}\x{7114}\x{7119}\x{711A}\x{711C}' . +'\x{7121}\x{7126}\x{7136}\x{713C}\x{7149}\x{714C}\x{714E}\x{7155}\x{7156}' . +'\x{7159}\x{7162}\x{7164}\x{7165}\x{7166}\x{7167}\x{7169}\x{716C}\x{716E}' . +'\x{717D}\x{7184}\x{7188}\x{718A}\x{718F}\x{7194}\x{7195}\x{7199}\x{719F}' . +'\x{71A8}\x{71AC}\x{71B1}\x{71B9}\x{71BE}\x{71C3}\x{71C8}\x{71C9}\x{71CE}' . +'\x{71D0}\x{71D2}\x{71D4}\x{71D5}\x{71D7}\x{71DF}\x{71E0}\x{71E5}\x{71E6}' . +'\x{71E7}\x{71EC}\x{71ED}\x{71EE}\x{71F5}\x{71F9}\x{71FB}\x{71FC}\x{71FF}' . +'\x{7206}\x{720D}\x{7210}\x{721B}\x{7228}\x{722A}\x{722C}\x{722D}\x{7230}' . +'\x{7232}\x{7235}\x{7236}\x{723A}\x{723B}\x{723C}\x{723D}\x{723E}\x{723F}' . +'\x{7240}\x{7246}\x{7247}\x{7248}\x{724B}\x{724C}\x{7252}\x{7258}\x{7259}' . +'\x{725B}\x{725D}\x{725F}\x{7261}\x{7262}\x{7267}\x{7269}\x{7272}\x{7274}' . +'\x{7279}\x{727D}\x{727E}\x{7280}\x{7281}\x{7282}\x{7287}\x{7292}\x{7296}' . +'\x{72A0}\x{72A2}\x{72A7}\x{72AC}\x{72AF}\x{72B2}\x{72B6}\x{72B9}\x{72C2}' . +'\x{72C3}\x{72C4}\x{72C6}\x{72CE}\x{72D0}\x{72D2}\x{72D7}\x{72D9}\x{72DB}' . +'\x{72E0}\x{72E1}\x{72E2}\x{72E9}\x{72EC}\x{72ED}\x{72F7}\x{72F8}\x{72F9}' . +'\x{72FC}\x{72FD}\x{730A}\x{7316}\x{7317}\x{731B}\x{731C}\x{731D}\x{731F}' . +'\x{7325}\x{7329}\x{732A}\x{732B}\x{732E}\x{732F}\x{7334}\x{7336}\x{7337}' . +'\x{733E}\x{733F}\x{7344}\x{7345}\x{734E}\x{734F}\x{7357}\x{7363}\x{7368}' . +'\x{736A}\x{7370}\x{7372}\x{7375}\x{7378}\x{737A}\x{737B}\x{7384}\x{7387}' . +'\x{7389}\x{738B}\x{7396}\x{73A9}\x{73B2}\x{73B3}\x{73BB}\x{73C0}\x{73C2}' . +'\x{73C8}\x{73CA}\x{73CD}\x{73CE}\x{73DE}\x{73E0}\x{73E5}\x{73EA}\x{73ED}' . +'\x{73EE}\x{73F1}\x{73F8}\x{73FE}\x{7403}\x{7405}\x{7406}\x{7409}\x{7422}' . +'\x{7425}\x{7432}\x{7433}\x{7434}\x{7435}\x{7436}\x{743A}\x{743F}\x{7441}' . +'\x{7455}\x{7459}\x{745A}\x{745B}\x{745C}\x{745E}\x{745F}\x{7460}\x{7463}' . +'\x{7464}\x{7469}\x{746A}\x{746F}\x{7470}\x{7473}\x{7476}\x{747E}\x{7483}' . +'\x{748B}\x{749E}\x{74A2}\x{74A7}\x{74B0}\x{74BD}\x{74CA}\x{74CF}\x{74D4}' . +'\x{74DC}\x{74E0}\x{74E2}\x{74E3}\x{74E6}\x{74E7}\x{74E9}\x{74EE}\x{74F0}' . +'\x{74F1}\x{74F2}\x{74F6}\x{74F7}\x{74F8}\x{7503}\x{7504}\x{7505}\x{750C}' . +'\x{750D}\x{750E}\x{7511}\x{7513}\x{7515}\x{7518}\x{751A}\x{751C}\x{751E}' . +'\x{751F}\x{7523}\x{7525}\x{7526}\x{7528}\x{752B}\x{752C}\x{7530}\x{7531}' . +'\x{7532}\x{7533}\x{7537}\x{7538}\x{753A}\x{753B}\x{753C}\x{7544}\x{7546}' . +'\x{7549}\x{754A}\x{754B}\x{754C}\x{754D}\x{754F}\x{7551}\x{7554}\x{7559}' . +'\x{755A}\x{755B}\x{755C}\x{755D}\x{7560}\x{7562}\x{7564}\x{7565}\x{7566}' . +'\x{7567}\x{7569}\x{756A}\x{756B}\x{756D}\x{7570}\x{7573}\x{7574}\x{7576}' . +'\x{7577}\x{7578}\x{757F}\x{7582}\x{7586}\x{7587}\x{7589}\x{758A}\x{758B}' . +'\x{758E}\x{758F}\x{7591}\x{7594}\x{759A}\x{759D}\x{75A3}\x{75A5}\x{75AB}' . +'\x{75B1}\x{75B2}\x{75B3}\x{75B5}\x{75B8}\x{75B9}\x{75BC}\x{75BD}\x{75BE}' . +'\x{75C2}\x{75C3}\x{75C5}\x{75C7}\x{75CA}\x{75CD}\x{75D2}\x{75D4}\x{75D5}' . +'\x{75D8}\x{75D9}\x{75DB}\x{75DE}\x{75E2}\x{75E3}\x{75E9}\x{75F0}\x{75F2}' . +'\x{75F3}\x{75F4}\x{75FA}\x{75FC}\x{75FE}\x{75FF}\x{7601}\x{7609}\x{760B}' . +'\x{760D}\x{761F}\x{7620}\x{7621}\x{7622}\x{7624}\x{7627}\x{7630}\x{7634}' . +'\x{763B}\x{7642}\x{7646}\x{7647}\x{7648}\x{764C}\x{7652}\x{7656}\x{7658}' . +'\x{765C}\x{7661}\x{7662}\x{7667}\x{7668}\x{7669}\x{766A}\x{766C}\x{7670}' . +'\x{7672}\x{7676}\x{7678}\x{767A}\x{767B}\x{767C}\x{767D}\x{767E}\x{7680}' . +'\x{7683}\x{7684}\x{7686}\x{7687}\x{7688}\x{768B}\x{768E}\x{7690}\x{7693}' . +'\x{7696}\x{7699}\x{769A}\x{76AE}\x{76B0}\x{76B4}\x{76B7}\x{76B8}\x{76B9}' . +'\x{76BA}\x{76BF}\x{76C2}\x{76C3}\x{76C6}\x{76C8}\x{76CA}\x{76CD}\x{76D2}' . +'\x{76D6}\x{76D7}\x{76DB}\x{76DC}\x{76DE}\x{76DF}\x{76E1}\x{76E3}\x{76E4}' . +'\x{76E5}\x{76E7}\x{76EA}\x{76EE}\x{76F2}\x{76F4}\x{76F8}\x{76FB}\x{76FE}' . +'\x{7701}\x{7704}\x{7707}\x{7708}\x{7709}\x{770B}\x{770C}\x{771B}\x{771E}' . +'\x{771F}\x{7720}\x{7724}\x{7725}\x{7726}\x{7729}\x{7737}\x{7738}\x{773A}' . +'\x{773C}\x{7740}\x{7747}\x{775A}\x{775B}\x{7761}\x{7763}\x{7765}\x{7766}' . +'\x{7768}\x{776B}\x{7779}\x{777E}\x{777F}\x{778B}\x{778E}\x{7791}\x{779E}' . +'\x{77A0}\x{77A5}\x{77AC}\x{77AD}\x{77B0}\x{77B3}\x{77B6}\x{77B9}\x{77BB}' . +'\x{77BC}\x{77BD}\x{77BF}\x{77C7}\x{77CD}\x{77D7}\x{77DA}\x{77DB}\x{77DC}' . +'\x{77E2}\x{77E3}\x{77E5}\x{77E7}\x{77E9}\x{77ED}\x{77EE}\x{77EF}\x{77F3}' . +'\x{77FC}\x{7802}\x{780C}\x{7812}\x{7814}\x{7815}\x{7820}\x{7825}\x{7826}' . +'\x{7827}\x{7832}\x{7834}\x{783A}\x{783F}\x{7845}\x{785D}\x{786B}\x{786C}' . +'\x{786F}\x{7872}\x{7874}\x{787C}\x{7881}\x{7886}\x{7887}\x{788C}\x{788D}' . +'\x{788E}\x{7891}\x{7893}\x{7895}\x{7897}\x{789A}\x{78A3}\x{78A7}\x{78A9}' . +'\x{78AA}\x{78AF}\x{78B5}\x{78BA}\x{78BC}\x{78BE}\x{78C1}\x{78C5}\x{78C6}' . +'\x{78CA}\x{78CB}\x{78D0}\x{78D1}\x{78D4}\x{78DA}\x{78E7}\x{78E8}\x{78EC}' . +'\x{78EF}\x{78F4}\x{78FD}\x{7901}\x{7907}\x{790E}\x{7911}\x{7912}\x{7919}' . +'\x{7926}\x{792A}\x{792B}\x{792C}\x{793A}\x{793C}\x{793E}\x{7940}\x{7941}' . +'\x{7947}\x{7948}\x{7949}\x{7950}\x{7953}\x{7955}\x{7956}\x{7957}\x{795A}' . +'\x{795D}\x{795E}\x{795F}\x{7960}\x{7962}\x{7965}\x{7968}\x{796D}\x{7977}' . +'\x{797A}\x{797F}\x{7980}\x{7981}\x{7984}\x{7985}\x{798A}\x{798D}\x{798E}' . +'\x{798F}\x{799D}\x{79A6}\x{79A7}\x{79AA}\x{79AE}\x{79B0}\x{79B3}\x{79B9}' . +'\x{79BA}\x{79BD}\x{79BE}\x{79BF}\x{79C0}\x{79C1}\x{79C9}\x{79CB}\x{79D1}' . +'\x{79D2}\x{79D5}\x{79D8}\x{79DF}\x{79E1}\x{79E3}\x{79E4}\x{79E6}\x{79E7}' . +'\x{79E9}\x{79EC}\x{79F0}\x{79FB}\x{7A00}\x{7A08}\x{7A0B}\x{7A0D}\x{7A0E}' . +'\x{7A14}\x{7A17}\x{7A18}\x{7A19}\x{7A1A}\x{7A1C}\x{7A1F}\x{7A20}\x{7A2E}' . +'\x{7A31}\x{7A32}\x{7A37}\x{7A3B}\x{7A3C}\x{7A3D}\x{7A3E}\x{7A3F}\x{7A40}' . +'\x{7A42}\x{7A43}\x{7A46}\x{7A49}\x{7A4D}\x{7A4E}\x{7A4F}\x{7A50}\x{7A57}' . +'\x{7A61}\x{7A62}\x{7A63}\x{7A69}\x{7A6B}\x{7A70}\x{7A74}\x{7A76}\x{7A79}' . +'\x{7A7A}\x{7A7D}\x{7A7F}\x{7A81}\x{7A83}\x{7A84}\x{7A88}\x{7A92}\x{7A93}' . +'\x{7A95}\x{7A96}\x{7A97}\x{7A98}\x{7A9F}\x{7AA9}\x{7AAA}\x{7AAE}\x{7AAF}' . +'\x{7AB0}\x{7AB6}\x{7ABA}\x{7ABF}\x{7AC3}\x{7AC4}\x{7AC5}\x{7AC7}\x{7AC8}' . +'\x{7ACA}\x{7ACB}\x{7ACD}\x{7ACF}\x{7AD2}\x{7AD3}\x{7AD5}\x{7AD9}\x{7ADA}' . +'\x{7ADC}\x{7ADD}\x{7ADF}\x{7AE0}\x{7AE1}\x{7AE2}\x{7AE3}\x{7AE5}\x{7AE6}' . +'\x{7AEA}\x{7AED}\x{7AEF}\x{7AF0}\x{7AF6}\x{7AF8}\x{7AF9}\x{7AFA}\x{7AFF}' . +'\x{7B02}\x{7B04}\x{7B06}\x{7B08}\x{7B0A}\x{7B0B}\x{7B0F}\x{7B11}\x{7B18}' . +'\x{7B19}\x{7B1B}\x{7B1E}\x{7B20}\x{7B25}\x{7B26}\x{7B28}\x{7B2C}\x{7B33}' . +'\x{7B35}\x{7B36}\x{7B39}\x{7B45}\x{7B46}\x{7B48}\x{7B49}\x{7B4B}\x{7B4C}' . +'\x{7B4D}\x{7B4F}\x{7B50}\x{7B51}\x{7B52}\x{7B54}\x{7B56}\x{7B5D}\x{7B65}' . +'\x{7B67}\x{7B6C}\x{7B6E}\x{7B70}\x{7B71}\x{7B74}\x{7B75}\x{7B7A}\x{7B86}' . +'\x{7B87}\x{7B8B}\x{7B8D}\x{7B8F}\x{7B92}\x{7B94}\x{7B95}\x{7B97}\x{7B98}' . +'\x{7B99}\x{7B9A}\x{7B9C}\x{7B9D}\x{7B9F}\x{7BA1}\x{7BAA}\x{7BAD}\x{7BB1}' . +'\x{7BB4}\x{7BB8}\x{7BC0}\x{7BC1}\x{7BC4}\x{7BC6}\x{7BC7}\x{7BC9}\x{7BCB}' . +'\x{7BCC}\x{7BCF}\x{7BDD}\x{7BE0}\x{7BE4}\x{7BE5}\x{7BE6}\x{7BE9}\x{7BED}' . +'\x{7BF3}\x{7BF6}\x{7BF7}\x{7C00}\x{7C07}\x{7C0D}\x{7C11}\x{7C12}\x{7C13}' . +'\x{7C14}\x{7C17}\x{7C1F}\x{7C21}\x{7C23}\x{7C27}\x{7C2A}\x{7C2B}\x{7C37}' . +'\x{7C38}\x{7C3D}\x{7C3E}\x{7C3F}\x{7C40}\x{7C43}\x{7C4C}\x{7C4D}\x{7C4F}' . +'\x{7C50}\x{7C54}\x{7C56}\x{7C58}\x{7C5F}\x{7C60}\x{7C64}\x{7C65}\x{7C6C}' . +'\x{7C73}\x{7C75}\x{7C7E}\x{7C81}\x{7C82}\x{7C83}\x{7C89}\x{7C8B}\x{7C8D}' . +'\x{7C90}\x{7C92}\x{7C95}\x{7C97}\x{7C98}\x{7C9B}\x{7C9F}\x{7CA1}\x{7CA2}' . +'\x{7CA4}\x{7CA5}\x{7CA7}\x{7CA8}\x{7CAB}\x{7CAD}\x{7CAE}\x{7CB1}\x{7CB2}' . +'\x{7CB3}\x{7CB9}\x{7CBD}\x{7CBE}\x{7CC0}\x{7CC2}\x{7CC5}\x{7CCA}\x{7CCE}' . +'\x{7CD2}\x{7CD6}\x{7CD8}\x{7CDC}\x{7CDE}\x{7CDF}\x{7CE0}\x{7CE2}\x{7CE7}' . +'\x{7CEF}\x{7CF2}\x{7CF4}\x{7CF6}\x{7CF8}\x{7CFA}\x{7CFB}\x{7CFE}\x{7D00}' . +'\x{7D02}\x{7D04}\x{7D05}\x{7D06}\x{7D0A}\x{7D0B}\x{7D0D}\x{7D10}\x{7D14}' . +'\x{7D15}\x{7D17}\x{7D18}\x{7D19}\x{7D1A}\x{7D1B}\x{7D1C}\x{7D20}\x{7D21}' . +'\x{7D22}\x{7D2B}\x{7D2C}\x{7D2E}\x{7D2F}\x{7D30}\x{7D32}\x{7D33}\x{7D35}' . +'\x{7D39}\x{7D3A}\x{7D3F}\x{7D42}\x{7D43}\x{7D44}\x{7D45}\x{7D46}\x{7D4B}' . +'\x{7D4C}\x{7D4E}\x{7D4F}\x{7D50}\x{7D56}\x{7D5B}\x{7D5E}\x{7D61}\x{7D62}' . +'\x{7D63}\x{7D66}\x{7D68}\x{7D6E}\x{7D71}\x{7D72}\x{7D73}\x{7D75}\x{7D76}' . +'\x{7D79}\x{7D7D}\x{7D89}\x{7D8F}\x{7D93}\x{7D99}\x{7D9A}\x{7D9B}\x{7D9C}' . +'\x{7D9F}\x{7DA2}\x{7DA3}\x{7DAB}\x{7DAC}\x{7DAD}\x{7DAE}\x{7DAF}\x{7DB0}' . +'\x{7DB1}\x{7DB2}\x{7DB4}\x{7DB5}\x{7DB8}\x{7DBA}\x{7DBB}\x{7DBD}\x{7DBE}' . +'\x{7DBF}\x{7DC7}\x{7DCA}\x{7DCB}\x{7DCF}\x{7DD1}\x{7DD2}\x{7DD5}\x{7DD8}' . +'\x{7DDA}\x{7DDC}\x{7DDD}\x{7DDE}\x{7DE0}\x{7DE1}\x{7DE4}\x{7DE8}\x{7DE9}' . +'\x{7DEC}\x{7DEF}\x{7DF2}\x{7DF4}\x{7DFB}\x{7E01}\x{7E04}\x{7E05}\x{7E09}' . +'\x{7E0A}\x{7E0B}\x{7E12}\x{7E1B}\x{7E1E}\x{7E1F}\x{7E21}\x{7E22}\x{7E23}' . +'\x{7E26}\x{7E2B}\x{7E2E}\x{7E31}\x{7E32}\x{7E35}\x{7E37}\x{7E39}\x{7E3A}' . +'\x{7E3B}\x{7E3D}\x{7E3E}\x{7E41}\x{7E43}\x{7E46}\x{7E4A}\x{7E4B}\x{7E4D}' . +'\x{7E54}\x{7E55}\x{7E56}\x{7E59}\x{7E5A}\x{7E5D}\x{7E5E}\x{7E66}\x{7E67}' . +'\x{7E69}\x{7E6A}\x{7E6D}\x{7E70}\x{7E79}\x{7E7B}\x{7E7C}\x{7E7D}\x{7E7F}' . +'\x{7E82}\x{7E83}\x{7E88}\x{7E89}\x{7E8C}\x{7E8E}\x{7E8F}\x{7E90}\x{7E92}' . +'\x{7E93}\x{7E94}\x{7E96}\x{7E9B}\x{7E9C}\x{7F36}\x{7F38}\x{7F3A}\x{7F45}' . +'\x{7F4C}\x{7F4D}\x{7F4E}\x{7F50}\x{7F51}\x{7F54}\x{7F55}\x{7F58}\x{7F5F}' . +'\x{7F60}\x{7F67}\x{7F68}\x{7F69}\x{7F6A}\x{7F6B}\x{7F6E}\x{7F70}\x{7F72}' . +'\x{7F75}\x{7F77}\x{7F78}\x{7F79}\x{7F82}\x{7F83}\x{7F85}\x{7F86}\x{7F87}' . +'\x{7F88}\x{7F8A}\x{7F8C}\x{7F8E}\x{7F94}\x{7F9A}\x{7F9D}\x{7F9E}\x{7FA3}' . +'\x{7FA4}\x{7FA8}\x{7FA9}\x{7FAE}\x{7FAF}\x{7FB2}\x{7FB6}\x{7FB8}\x{7FB9}' . +'\x{7FBD}\x{7FC1}\x{7FC5}\x{7FC6}\x{7FCA}\x{7FCC}\x{7FD2}\x{7FD4}\x{7FD5}' . +'\x{7FE0}\x{7FE1}\x{7FE6}\x{7FE9}\x{7FEB}\x{7FF0}\x{7FF3}\x{7FF9}\x{7FFB}' . +'\x{7FFC}\x{8000}\x{8001}\x{8003}\x{8004}\x{8005}\x{8006}\x{800B}\x{800C}' . +'\x{8010}\x{8012}\x{8015}\x{8017}\x{8018}\x{8019}\x{801C}\x{8021}\x{8028}' . +'\x{8033}\x{8036}\x{803B}\x{803D}\x{803F}\x{8046}\x{804A}\x{8052}\x{8056}' . +'\x{8058}\x{805A}\x{805E}\x{805F}\x{8061}\x{8062}\x{8068}\x{806F}\x{8070}' . +'\x{8072}\x{8073}\x{8074}\x{8076}\x{8077}\x{8079}\x{807D}\x{807E}\x{807F}' . +'\x{8084}\x{8085}\x{8086}\x{8087}\x{8089}\x{808B}\x{808C}\x{8093}\x{8096}' . +'\x{8098}\x{809A}\x{809B}\x{809D}\x{80A1}\x{80A2}\x{80A5}\x{80A9}\x{80AA}' . +'\x{80AC}\x{80AD}\x{80AF}\x{80B1}\x{80B2}\x{80B4}\x{80BA}\x{80C3}\x{80C4}' . +'\x{80C6}\x{80CC}\x{80CE}\x{80D6}\x{80D9}\x{80DA}\x{80DB}\x{80DD}\x{80DE}' . +'\x{80E1}\x{80E4}\x{80E5}\x{80EF}\x{80F1}\x{80F4}\x{80F8}\x{80FC}\x{80FD}' . +'\x{8102}\x{8105}\x{8106}\x{8107}\x{8108}\x{8109}\x{810A}\x{811A}\x{811B}' . +'\x{8123}\x{8129}\x{812F}\x{8131}\x{8133}\x{8139}\x{813E}\x{8146}\x{814B}' . +'\x{814E}\x{8150}\x{8151}\x{8153}\x{8154}\x{8155}\x{815F}\x{8165}\x{8166}' . +'\x{816B}\x{816E}\x{8170}\x{8171}\x{8174}\x{8178}\x{8179}\x{817A}\x{817F}' . +'\x{8180}\x{8182}\x{8183}\x{8188}\x{818A}\x{818F}\x{8193}\x{8195}\x{819A}' . +'\x{819C}\x{819D}\x{81A0}\x{81A3}\x{81A4}\x{81A8}\x{81A9}\x{81B0}\x{81B3}' . +'\x{81B5}\x{81B8}\x{81BA}\x{81BD}\x{81BE}\x{81BF}\x{81C0}\x{81C2}\x{81C6}' . +'\x{81C8}\x{81C9}\x{81CD}\x{81D1}\x{81D3}\x{81D8}\x{81D9}\x{81DA}\x{81DF}' . +'\x{81E0}\x{81E3}\x{81E5}\x{81E7}\x{81E8}\x{81EA}\x{81ED}\x{81F3}\x{81F4}' . +'\x{81FA}\x{81FB}\x{81FC}\x{81FE}\x{8201}\x{8202}\x{8205}\x{8207}\x{8208}' . +'\x{8209}\x{820A}\x{820C}\x{820D}\x{820E}\x{8210}\x{8212}\x{8216}\x{8217}' . +'\x{8218}\x{821B}\x{821C}\x{821E}\x{821F}\x{8229}\x{822A}\x{822B}\x{822C}' . +'\x{822E}\x{8233}\x{8235}\x{8236}\x{8237}\x{8238}\x{8239}\x{8240}\x{8247}' . +'\x{8258}\x{8259}\x{825A}\x{825D}\x{825F}\x{8262}\x{8264}\x{8266}\x{8268}' . +'\x{826A}\x{826B}\x{826E}\x{826F}\x{8271}\x{8272}\x{8276}\x{8277}\x{8278}' . +'\x{827E}\x{828B}\x{828D}\x{8292}\x{8299}\x{829D}\x{829F}\x{82A5}\x{82A6}' . +'\x{82AB}\x{82AC}\x{82AD}\x{82AF}\x{82B1}\x{82B3}\x{82B8}\x{82B9}\x{82BB}' . +'\x{82BD}\x{82C5}\x{82D1}\x{82D2}\x{82D3}\x{82D4}\x{82D7}\x{82D9}\x{82DB}' . +'\x{82DC}\x{82DE}\x{82DF}\x{82E1}\x{82E3}\x{82E5}\x{82E6}\x{82E7}\x{82EB}' . +'\x{82F1}\x{82F3}\x{82F4}\x{82F9}\x{82FA}\x{82FB}\x{8302}\x{8303}\x{8304}' . +'\x{8305}\x{8306}\x{8309}\x{830E}\x{8316}\x{8317}\x{8318}\x{831C}\x{8323}' . +'\x{8328}\x{832B}\x{832F}\x{8331}\x{8332}\x{8334}\x{8335}\x{8336}\x{8338}' . +'\x{8339}\x{8340}\x{8345}\x{8349}\x{834A}\x{834F}\x{8350}\x{8352}\x{8358}' . +'\x{8373}\x{8375}\x{8377}\x{837B}\x{837C}\x{8385}\x{8387}\x{8389}\x{838A}' . +'\x{838E}\x{8393}\x{8396}\x{839A}\x{839E}\x{839F}\x{83A0}\x{83A2}\x{83A8}' . +'\x{83AA}\x{83AB}\x{83B1}\x{83B5}\x{83BD}\x{83C1}\x{83C5}\x{83CA}\x{83CC}' . +'\x{83CE}\x{83D3}\x{83D6}\x{83D8}\x{83DC}\x{83DF}\x{83E0}\x{83E9}\x{83EB}' . +'\x{83EF}\x{83F0}\x{83F1}\x{83F2}\x{83F4}\x{83F7}\x{83FB}\x{83FD}\x{8403}' . +'\x{8404}\x{8407}\x{840B}\x{840C}\x{840D}\x{840E}\x{8413}\x{8420}\x{8422}' . +'\x{8429}\x{842A}\x{842C}\x{8431}\x{8435}\x{8438}\x{843C}\x{843D}\x{8446}' . +'\x{8449}\x{844E}\x{8457}\x{845B}\x{8461}\x{8462}\x{8463}\x{8466}\x{8469}' . +'\x{846B}\x{846C}\x{846D}\x{846E}\x{846F}\x{8471}\x{8475}\x{8477}\x{8479}' . +'\x{847A}\x{8482}\x{8484}\x{848B}\x{8490}\x{8494}\x{8499}\x{849C}\x{849F}' . +'\x{84A1}\x{84AD}\x{84B2}\x{84B8}\x{84B9}\x{84BB}\x{84BC}\x{84BF}\x{84C1}' . +'\x{84C4}\x{84C6}\x{84C9}\x{84CA}\x{84CB}\x{84CD}\x{84D0}\x{84D1}\x{84D6}' . +'\x{84D9}\x{84DA}\x{84EC}\x{84EE}\x{84F4}\x{84FC}\x{84FF}\x{8500}\x{8506}' . +'\x{8511}\x{8513}\x{8514}\x{8515}\x{8517}\x{8518}\x{851A}\x{851F}\x{8521}' . +'\x{8526}\x{852C}\x{852D}\x{8535}\x{853D}\x{8540}\x{8541}\x{8543}\x{8548}' . +'\x{8549}\x{854A}\x{854B}\x{854E}\x{8555}\x{8557}\x{8558}\x{855A}\x{8563}' . +'\x{8568}\x{8569}\x{856A}\x{856D}\x{8577}\x{857E}\x{8580}\x{8584}\x{8587}' . +'\x{8588}\x{858A}\x{8590}\x{8591}\x{8594}\x{8597}\x{8599}\x{859B}\x{859C}' . +'\x{85A4}\x{85A6}\x{85A8}\x{85A9}\x{85AA}\x{85AB}\x{85AC}\x{85AE}\x{85AF}' . +'\x{85B9}\x{85BA}\x{85C1}\x{85C9}\x{85CD}\x{85CF}\x{85D0}\x{85D5}\x{85DC}' . +'\x{85DD}\x{85E4}\x{85E5}\x{85E9}\x{85EA}\x{85F7}\x{85F9}\x{85FA}\x{85FB}' . +'\x{85FE}\x{8602}\x{8606}\x{8607}\x{860A}\x{860B}\x{8613}\x{8616}\x{8617}' . +'\x{861A}\x{8622}\x{862D}\x{862F}\x{8630}\x{863F}\x{864D}\x{864E}\x{8650}' . +'\x{8654}\x{8655}\x{865A}\x{865C}\x{865E}\x{865F}\x{8667}\x{866B}\x{8671}' . +'\x{8679}\x{867B}\x{868A}\x{868B}\x{868C}\x{8693}\x{8695}\x{86A3}\x{86A4}' . +'\x{86A9}\x{86AA}\x{86AB}\x{86AF}\x{86B0}\x{86B6}\x{86C4}\x{86C6}\x{86C7}' . +'\x{86C9}\x{86CB}\x{86CD}\x{86CE}\x{86D4}\x{86D9}\x{86DB}\x{86DE}\x{86DF}' . +'\x{86E4}\x{86E9}\x{86EC}\x{86ED}\x{86EE}\x{86EF}\x{86F8}\x{86F9}\x{86FB}' . +'\x{86FE}\x{8700}\x{8702}\x{8703}\x{8706}\x{8708}\x{8709}\x{870A}\x{870D}' . +'\x{8711}\x{8712}\x{8718}\x{871A}\x{871C}\x{8725}\x{8729}\x{8734}\x{8737}' . +'\x{873B}\x{873F}\x{8749}\x{874B}\x{874C}\x{874E}\x{8753}\x{8755}\x{8757}' . +'\x{8759}\x{875F}\x{8760}\x{8763}\x{8766}\x{8768}\x{876A}\x{876E}\x{8774}' . +'\x{8776}\x{8778}\x{877F}\x{8782}\x{878D}\x{879F}\x{87A2}\x{87AB}\x{87AF}' . +'\x{87B3}\x{87BA}\x{87BB}\x{87BD}\x{87C0}\x{87C4}\x{87C6}\x{87C7}\x{87CB}' . +'\x{87D0}\x{87D2}\x{87E0}\x{87EF}\x{87F2}\x{87F6}\x{87F7}\x{87F9}\x{87FB}' . +'\x{87FE}\x{8805}\x{880D}\x{880E}\x{880F}\x{8811}\x{8815}\x{8816}\x{8821}' . +'\x{8822}\x{8823}\x{8827}\x{8831}\x{8836}\x{8839}\x{883B}\x{8840}\x{8842}' . +'\x{8844}\x{8846}\x{884C}\x{884D}\x{8852}\x{8853}\x{8857}\x{8859}\x{885B}' . +'\x{885D}\x{885E}\x{8861}\x{8862}\x{8863}\x{8868}\x{886B}\x{8870}\x{8872}' . +'\x{8875}\x{8877}\x{887D}\x{887E}\x{887F}\x{8881}\x{8882}\x{8888}\x{888B}' . +'\x{888D}\x{8892}\x{8896}\x{8897}\x{8899}\x{889E}\x{88A2}\x{88A4}\x{88AB}' . +'\x{88AE}\x{88B0}\x{88B1}\x{88B4}\x{88B5}\x{88B7}\x{88BF}\x{88C1}\x{88C2}' . +'\x{88C3}\x{88C4}\x{88C5}\x{88CF}\x{88D4}\x{88D5}\x{88D8}\x{88D9}\x{88DC}' . +'\x{88DD}\x{88DF}\x{88E1}\x{88E8}\x{88F2}\x{88F3}\x{88F4}\x{88F8}\x{88F9}' . +'\x{88FC}\x{88FD}\x{88FE}\x{8902}\x{8904}\x{8907}\x{890A}\x{890C}\x{8910}' . +'\x{8912}\x{8913}\x{891D}\x{891E}\x{8925}\x{892A}\x{892B}\x{8936}\x{8938}' . +'\x{893B}\x{8941}\x{8943}\x{8944}\x{894C}\x{894D}\x{8956}\x{895E}\x{895F}' . +'\x{8960}\x{8964}\x{8966}\x{896A}\x{896D}\x{896F}\x{8972}\x{8974}\x{8977}' . +'\x{897E}\x{897F}\x{8981}\x{8983}\x{8986}\x{8987}\x{8988}\x{898A}\x{898B}' . +'\x{898F}\x{8993}\x{8996}\x{8997}\x{8998}\x{899A}\x{89A1}\x{89A6}\x{89A7}' . +'\x{89A9}\x{89AA}\x{89AC}\x{89AF}\x{89B2}\x{89B3}\x{89BA}\x{89BD}\x{89BF}' . +'\x{89C0}\x{89D2}\x{89DA}\x{89DC}\x{89DD}\x{89E3}\x{89E6}\x{89E7}\x{89F4}' . +'\x{89F8}\x{8A00}\x{8A02}\x{8A03}\x{8A08}\x{8A0A}\x{8A0C}\x{8A0E}\x{8A10}' . +'\x{8A13}\x{8A16}\x{8A17}\x{8A18}\x{8A1B}\x{8A1D}\x{8A1F}\x{8A23}\x{8A25}' . +'\x{8A2A}\x{8A2D}\x{8A31}\x{8A33}\x{8A34}\x{8A36}\x{8A3A}\x{8A3B}\x{8A3C}' . +'\x{8A41}\x{8A46}\x{8A48}\x{8A50}\x{8A51}\x{8A52}\x{8A54}\x{8A55}\x{8A5B}' . +'\x{8A5E}\x{8A60}\x{8A62}\x{8A63}\x{8A66}\x{8A69}\x{8A6B}\x{8A6C}\x{8A6D}' . +'\x{8A6E}\x{8A70}\x{8A71}\x{8A72}\x{8A73}\x{8A7C}\x{8A82}\x{8A84}\x{8A85}' . +'\x{8A87}\x{8A89}\x{8A8C}\x{8A8D}\x{8A91}\x{8A93}\x{8A95}\x{8A98}\x{8A9A}' . +'\x{8A9E}\x{8AA0}\x{8AA1}\x{8AA3}\x{8AA4}\x{8AA5}\x{8AA6}\x{8AA8}\x{8AAC}' . +'\x{8AAD}\x{8AB0}\x{8AB2}\x{8AB9}\x{8ABC}\x{8ABF}\x{8AC2}\x{8AC4}\x{8AC7}' . +'\x{8ACB}\x{8ACC}\x{8ACD}\x{8ACF}\x{8AD2}\x{8AD6}\x{8ADA}\x{8ADB}\x{8ADC}' . +'\x{8ADE}\x{8AE0}\x{8AE1}\x{8AE2}\x{8AE4}\x{8AE6}\x{8AE7}\x{8AEB}\x{8AED}' . +'\x{8AEE}\x{8AF1}\x{8AF3}\x{8AF7}\x{8AF8}\x{8AFA}\x{8AFE}\x{8B00}\x{8B01}' . +'\x{8B02}\x{8B04}\x{8B07}\x{8B0C}\x{8B0E}\x{8B10}\x{8B14}\x{8B16}\x{8B17}' . +'\x{8B19}\x{8B1A}\x{8B1B}\x{8B1D}\x{8B20}\x{8B21}\x{8B26}\x{8B28}\x{8B2B}' . +'\x{8B2C}\x{8B33}\x{8B39}\x{8B3E}\x{8B41}\x{8B49}\x{8B4C}\x{8B4E}\x{8B4F}' . +'\x{8B56}\x{8B58}\x{8B5A}\x{8B5B}\x{8B5C}\x{8B5F}\x{8B66}\x{8B6B}\x{8B6C}' . +'\x{8B6F}\x{8B70}\x{8B71}\x{8B72}\x{8B74}\x{8B77}\x{8B7D}\x{8B80}\x{8B83}' . +'\x{8B8A}\x{8B8C}\x{8B8E}\x{8B90}\x{8B92}\x{8B93}\x{8B96}\x{8B99}\x{8B9A}' . +'\x{8C37}\x{8C3A}\x{8C3F}\x{8C41}\x{8C46}\x{8C48}\x{8C4A}\x{8C4C}\x{8C4E}' . +'\x{8C50}\x{8C55}\x{8C5A}\x{8C61}\x{8C62}\x{8C6A}\x{8C6B}\x{8C6C}\x{8C78}' . +'\x{8C79}\x{8C7A}\x{8C7C}\x{8C82}\x{8C85}\x{8C89}\x{8C8A}\x{8C8C}\x{8C8D}' . +'\x{8C8E}\x{8C94}\x{8C98}\x{8C9D}\x{8C9E}\x{8CA0}\x{8CA1}\x{8CA2}\x{8CA7}' . +'\x{8CA8}\x{8CA9}\x{8CAA}\x{8CAB}\x{8CAC}\x{8CAD}\x{8CAE}\x{8CAF}\x{8CB0}' . +'\x{8CB2}\x{8CB3}\x{8CB4}\x{8CB6}\x{8CB7}\x{8CB8}\x{8CBB}\x{8CBC}\x{8CBD}' . +'\x{8CBF}\x{8CC0}\x{8CC1}\x{8CC2}\x{8CC3}\x{8CC4}\x{8CC7}\x{8CC8}\x{8CCA}' . +'\x{8CCD}\x{8CCE}\x{8CD1}\x{8CD3}\x{8CDA}\x{8CDB}\x{8CDC}\x{8CDE}\x{8CE0}' . +'\x{8CE2}\x{8CE3}\x{8CE4}\x{8CE6}\x{8CEA}\x{8CED}\x{8CFA}\x{8CFB}\x{8CFC}' . +'\x{8CFD}\x{8D04}\x{8D05}\x{8D07}\x{8D08}\x{8D0A}\x{8D0B}\x{8D0D}\x{8D0F}' . +'\x{8D10}\x{8D13}\x{8D14}\x{8D16}\x{8D64}\x{8D66}\x{8D67}\x{8D6B}\x{8D6D}' . +'\x{8D70}\x{8D71}\x{8D73}\x{8D74}\x{8D77}\x{8D81}\x{8D85}\x{8D8A}\x{8D99}' . +'\x{8DA3}\x{8DA8}\x{8DB3}\x{8DBA}\x{8DBE}\x{8DC2}\x{8DCB}\x{8DCC}\x{8DCF}' . +'\x{8DD6}\x{8DDA}\x{8DDB}\x{8DDD}\x{8DDF}\x{8DE1}\x{8DE3}\x{8DE8}\x{8DEA}' . +'\x{8DEB}\x{8DEF}\x{8DF3}\x{8DF5}\x{8DFC}\x{8DFF}\x{8E08}\x{8E09}\x{8E0A}' . +'\x{8E0F}\x{8E10}\x{8E1D}\x{8E1E}\x{8E1F}\x{8E2A}\x{8E30}\x{8E34}\x{8E35}' . +'\x{8E42}\x{8E44}\x{8E47}\x{8E48}\x{8E49}\x{8E4A}\x{8E4C}\x{8E50}\x{8E55}' . +'\x{8E59}\x{8E5F}\x{8E60}\x{8E63}\x{8E64}\x{8E72}\x{8E74}\x{8E76}\x{8E7C}' . +'\x{8E81}\x{8E84}\x{8E85}\x{8E87}\x{8E8A}\x{8E8B}\x{8E8D}\x{8E91}\x{8E93}' . +'\x{8E94}\x{8E99}\x{8EA1}\x{8EAA}\x{8EAB}\x{8EAC}\x{8EAF}\x{8EB0}\x{8EB1}' . +'\x{8EBE}\x{8EC5}\x{8EC6}\x{8EC8}\x{8ECA}\x{8ECB}\x{8ECC}\x{8ECD}\x{8ED2}' . +'\x{8EDB}\x{8EDF}\x{8EE2}\x{8EE3}\x{8EEB}\x{8EF8}\x{8EFB}\x{8EFC}\x{8EFD}' . +'\x{8EFE}\x{8F03}\x{8F05}\x{8F09}\x{8F0A}\x{8F0C}\x{8F12}\x{8F13}\x{8F14}' . +'\x{8F15}\x{8F19}\x{8F1B}\x{8F1C}\x{8F1D}\x{8F1F}\x{8F26}\x{8F29}\x{8F2A}' . +'\x{8F2F}\x{8F33}\x{8F38}\x{8F39}\x{8F3B}\x{8F3E}\x{8F3F}\x{8F42}\x{8F44}' . +'\x{8F45}\x{8F46}\x{8F49}\x{8F4C}\x{8F4D}\x{8F4E}\x{8F57}\x{8F5C}\x{8F5F}' . +'\x{8F61}\x{8F62}\x{8F63}\x{8F64}\x{8F9B}\x{8F9C}\x{8F9E}\x{8F9F}\x{8FA3}' . +'\x{8FA7}\x{8FA8}\x{8FAD}\x{8FAE}\x{8FAF}\x{8FB0}\x{8FB1}\x{8FB2}\x{8FB7}' . +'\x{8FBA}\x{8FBB}\x{8FBC}\x{8FBF}\x{8FC2}\x{8FC4}\x{8FC5}\x{8FCE}\x{8FD1}' . +'\x{8FD4}\x{8FDA}\x{8FE2}\x{8FE5}\x{8FE6}\x{8FE9}\x{8FEA}\x{8FEB}\x{8FED}' . +'\x{8FEF}\x{8FF0}\x{8FF4}\x{8FF7}\x{8FF8}\x{8FF9}\x{8FFA}\x{8FFD}\x{9000}' . +'\x{9001}\x{9003}\x{9005}\x{9006}\x{900B}\x{900D}\x{900E}\x{900F}\x{9010}' . +'\x{9011}\x{9013}\x{9014}\x{9015}\x{9016}\x{9017}\x{9019}\x{901A}\x{901D}' . +'\x{901E}\x{901F}\x{9020}\x{9021}\x{9022}\x{9023}\x{9027}\x{902E}\x{9031}' . +'\x{9032}\x{9035}\x{9036}\x{9038}\x{9039}\x{903C}\x{903E}\x{9041}\x{9042}' . +'\x{9045}\x{9047}\x{9049}\x{904A}\x{904B}\x{904D}\x{904E}\x{904F}\x{9050}' . +'\x{9051}\x{9052}\x{9053}\x{9054}\x{9055}\x{9056}\x{9058}\x{9059}\x{905C}' . +'\x{905E}\x{9060}\x{9061}\x{9063}\x{9065}\x{9068}\x{9069}\x{906D}\x{906E}' . +'\x{906F}\x{9072}\x{9075}\x{9076}\x{9077}\x{9078}\x{907A}\x{907C}\x{907D}' . +'\x{907F}\x{9080}\x{9081}\x{9082}\x{9083}\x{9084}\x{9087}\x{9089}\x{908A}' . +'\x{908F}\x{9091}\x{90A3}\x{90A6}\x{90A8}\x{90AA}\x{90AF}\x{90B1}\x{90B5}' . +'\x{90B8}\x{90C1}\x{90CA}\x{90CE}\x{90DB}\x{90E1}\x{90E2}\x{90E4}\x{90E8}' . +'\x{90ED}\x{90F5}\x{90F7}\x{90FD}\x{9102}\x{9112}\x{9119}\x{912D}\x{9130}' . +'\x{9132}\x{9149}\x{914A}\x{914B}\x{914C}\x{914D}\x{914E}\x{9152}\x{9154}' . +'\x{9156}\x{9158}\x{9162}\x{9163}\x{9165}\x{9169}\x{916A}\x{916C}\x{9172}' . +'\x{9173}\x{9175}\x{9177}\x{9178}\x{9182}\x{9187}\x{9189}\x{918B}\x{918D}' . +'\x{9190}\x{9192}\x{9197}\x{919C}\x{91A2}\x{91A4}\x{91AA}\x{91AB}\x{91AF}' . +'\x{91B4}\x{91B5}\x{91B8}\x{91BA}\x{91C0}\x{91C1}\x{91C6}\x{91C7}\x{91C8}' . +'\x{91C9}\x{91CB}\x{91CC}\x{91CD}\x{91CE}\x{91CF}\x{91D0}\x{91D1}\x{91D6}' . +'\x{91D8}\x{91DB}\x{91DC}\x{91DD}\x{91DF}\x{91E1}\x{91E3}\x{91E6}\x{91E7}' . +'\x{91F5}\x{91F6}\x{91FC}\x{91FF}\x{920D}\x{920E}\x{9211}\x{9214}\x{9215}' . +'\x{921E}\x{9229}\x{922C}\x{9234}\x{9237}\x{923F}\x{9244}\x{9245}\x{9248}' . +'\x{9249}\x{924B}\x{9250}\x{9257}\x{925A}\x{925B}\x{925E}\x{9262}\x{9264}' . +'\x{9266}\x{9271}\x{927E}\x{9280}\x{9283}\x{9285}\x{9291}\x{9293}\x{9295}' . +'\x{9296}\x{9298}\x{929A}\x{929B}\x{929C}\x{92AD}\x{92B7}\x{92B9}\x{92CF}' . +'\x{92D2}\x{92E4}\x{92E9}\x{92EA}\x{92ED}\x{92F2}\x{92F3}\x{92F8}\x{92FA}' . +'\x{92FC}\x{9306}\x{930F}\x{9310}\x{9318}\x{9319}\x{931A}\x{9320}\x{9322}' . +'\x{9323}\x{9326}\x{9328}\x{932B}\x{932C}\x{932E}\x{932F}\x{9332}\x{9335}' . +'\x{933A}\x{933B}\x{9344}\x{934B}\x{934D}\x{9354}\x{9356}\x{935B}\x{935C}' . +'\x{9360}\x{936C}\x{936E}\x{9375}\x{937C}\x{937E}\x{938C}\x{9394}\x{9396}' . +'\x{9397}\x{939A}\x{93A7}\x{93AC}\x{93AD}\x{93AE}\x{93B0}\x{93B9}\x{93C3}' . +'\x{93C8}\x{93D0}\x{93D1}\x{93D6}\x{93D7}\x{93D8}\x{93DD}\x{93E1}\x{93E4}' . +'\x{93E5}\x{93E8}\x{9403}\x{9407}\x{9410}\x{9413}\x{9414}\x{9418}\x{9419}' . +'\x{941A}\x{9421}\x{942B}\x{9435}\x{9436}\x{9438}\x{943A}\x{9441}\x{9444}' . +'\x{9451}\x{9452}\x{9453}\x{945A}\x{945B}\x{945E}\x{9460}\x{9462}\x{946A}' . +'\x{9470}\x{9475}\x{9477}\x{947C}\x{947D}\x{947E}\x{947F}\x{9481}\x{9577}' . +'\x{9580}\x{9582}\x{9583}\x{9587}\x{9589}\x{958A}\x{958B}\x{958F}\x{9591}' . +'\x{9593}\x{9594}\x{9596}\x{9598}\x{9599}\x{95A0}\x{95A2}\x{95A3}\x{95A4}' . +'\x{95A5}\x{95A7}\x{95A8}\x{95AD}\x{95B2}\x{95B9}\x{95BB}\x{95BC}\x{95BE}' . +'\x{95C3}\x{95C7}\x{95CA}\x{95CC}\x{95CD}\x{95D4}\x{95D5}\x{95D6}\x{95D8}' . +'\x{95DC}\x{95E1}\x{95E2}\x{95E5}\x{961C}\x{9621}\x{9628}\x{962A}\x{962E}' . +'\x{962F}\x{9632}\x{963B}\x{963F}\x{9640}\x{9642}\x{9644}\x{964B}\x{964C}' . +'\x{964D}\x{964F}\x{9650}\x{965B}\x{965C}\x{965D}\x{965E}\x{965F}\x{9662}' . +'\x{9663}\x{9664}\x{9665}\x{9666}\x{966A}\x{966C}\x{9670}\x{9672}\x{9673}' . +'\x{9675}\x{9676}\x{9677}\x{9678}\x{967A}\x{967D}\x{9685}\x{9686}\x{9688}' . +'\x{968A}\x{968B}\x{968D}\x{968E}\x{968F}\x{9694}\x{9695}\x{9697}\x{9698}' . +'\x{9699}\x{969B}\x{969C}\x{96A0}\x{96A3}\x{96A7}\x{96A8}\x{96AA}\x{96B0}' . +'\x{96B1}\x{96B2}\x{96B4}\x{96B6}\x{96B7}\x{96B8}\x{96B9}\x{96BB}\x{96BC}' . +'\x{96C0}\x{96C1}\x{96C4}\x{96C5}\x{96C6}\x{96C7}\x{96C9}\x{96CB}\x{96CC}' . +'\x{96CD}\x{96CE}\x{96D1}\x{96D5}\x{96D6}\x{96D9}\x{96DB}\x{96DC}\x{96E2}' . +'\x{96E3}\x{96E8}\x{96EA}\x{96EB}\x{96F0}\x{96F2}\x{96F6}\x{96F7}\x{96F9}' . +'\x{96FB}\x{9700}\x{9704}\x{9706}\x{9707}\x{9708}\x{970A}\x{970D}\x{970E}' . +'\x{970F}\x{9711}\x{9713}\x{9716}\x{9719}\x{971C}\x{971E}\x{9724}\x{9727}' . +'\x{972A}\x{9730}\x{9732}\x{9738}\x{9739}\x{973D}\x{973E}\x{9742}\x{9744}' . +'\x{9746}\x{9748}\x{9749}\x{9752}\x{9756}\x{9759}\x{975C}\x{975E}\x{9760}' . +'\x{9761}\x{9762}\x{9764}\x{9766}\x{9768}\x{9769}\x{976B}\x{976D}\x{9771}' . +'\x{9774}\x{9779}\x{977A}\x{977C}\x{9781}\x{9784}\x{9785}\x{9786}\x{978B}' . +'\x{978D}\x{978F}\x{9790}\x{9798}\x{979C}\x{97A0}\x{97A3}\x{97A6}\x{97A8}' . +'\x{97AB}\x{97AD}\x{97B3}\x{97B4}\x{97C3}\x{97C6}\x{97C8}\x{97CB}\x{97D3}' . +'\x{97DC}\x{97ED}\x{97EE}\x{97F2}\x{97F3}\x{97F5}\x{97F6}\x{97FB}\x{97FF}' . +'\x{9801}\x{9802}\x{9803}\x{9805}\x{9806}\x{9808}\x{980C}\x{980F}\x{9810}' . +'\x{9811}\x{9812}\x{9813}\x{9817}\x{9818}\x{981A}\x{9821}\x{9824}\x{982C}' . +'\x{982D}\x{9834}\x{9837}\x{9838}\x{983B}\x{983C}\x{983D}\x{9846}\x{984B}' . +'\x{984C}\x{984D}\x{984E}\x{984F}\x{9854}\x{9855}\x{9858}\x{985B}\x{985E}' . +'\x{9867}\x{986B}\x{986F}\x{9870}\x{9871}\x{9873}\x{9874}\x{98A8}\x{98AA}' . +'\x{98AF}\x{98B1}\x{98B6}\x{98C3}\x{98C4}\x{98C6}\x{98DB}\x{98DC}\x{98DF}' . +'\x{98E2}\x{98E9}\x{98EB}\x{98ED}\x{98EE}\x{98EF}\x{98F2}\x{98F4}\x{98FC}' . +'\x{98FD}\x{98FE}\x{9903}\x{9905}\x{9909}\x{990A}\x{990C}\x{9910}\x{9912}' . +'\x{9913}\x{9914}\x{9918}\x{991D}\x{991E}\x{9920}\x{9921}\x{9924}\x{9928}' . +'\x{992C}\x{992E}\x{993D}\x{993E}\x{9942}\x{9945}\x{9949}\x{994B}\x{994C}' . +'\x{9950}\x{9951}\x{9952}\x{9955}\x{9957}\x{9996}\x{9997}\x{9998}\x{9999}' . +'\x{99A5}\x{99A8}\x{99AC}\x{99AD}\x{99AE}\x{99B3}\x{99B4}\x{99BC}\x{99C1}' . +'\x{99C4}\x{99C5}\x{99C6}\x{99C8}\x{99D0}\x{99D1}\x{99D2}\x{99D5}\x{99D8}' . +'\x{99DB}\x{99DD}\x{99DF}\x{99E2}\x{99ED}\x{99EE}\x{99F1}\x{99F2}\x{99F8}' . +'\x{99FB}\x{99FF}\x{9A01}\x{9A05}\x{9A0E}\x{9A0F}\x{9A12}\x{9A13}\x{9A19}' . +'\x{9A28}\x{9A2B}\x{9A30}\x{9A37}\x{9A3E}\x{9A40}\x{9A42}\x{9A43}\x{9A45}' . +'\x{9A4D}\x{9A55}\x{9A57}\x{9A5A}\x{9A5B}\x{9A5F}\x{9A62}\x{9A64}\x{9A65}' . +'\x{9A69}\x{9A6A}\x{9A6B}\x{9AA8}\x{9AAD}\x{9AB0}\x{9AB8}\x{9ABC}\x{9AC0}' . +'\x{9AC4}\x{9ACF}\x{9AD1}\x{9AD3}\x{9AD4}\x{9AD8}\x{9ADE}\x{9ADF}\x{9AE2}' . +'\x{9AE3}\x{9AE6}\x{9AEA}\x{9AEB}\x{9AED}\x{9AEE}\x{9AEF}\x{9AF1}\x{9AF4}' . +'\x{9AF7}\x{9AFB}\x{9B06}\x{9B18}\x{9B1A}\x{9B1F}\x{9B22}\x{9B23}\x{9B25}' . +'\x{9B27}\x{9B28}\x{9B29}\x{9B2A}\x{9B2E}\x{9B2F}\x{9B31}\x{9B32}\x{9B3B}' . +'\x{9B3C}\x{9B41}\x{9B42}\x{9B43}\x{9B44}\x{9B45}\x{9B4D}\x{9B4E}\x{9B4F}' . +'\x{9B51}\x{9B54}\x{9B58}\x{9B5A}\x{9B6F}\x{9B74}\x{9B83}\x{9B8E}\x{9B91}' . +'\x{9B92}\x{9B93}\x{9B96}\x{9B97}\x{9B9F}\x{9BA0}\x{9BA8}\x{9BAA}\x{9BAB}' . +'\x{9BAD}\x{9BAE}\x{9BB4}\x{9BB9}\x{9BC0}\x{9BC6}\x{9BC9}\x{9BCA}\x{9BCF}' . +'\x{9BD1}\x{9BD2}\x{9BD4}\x{9BD6}\x{9BDB}\x{9BE1}\x{9BE2}\x{9BE3}\x{9BE4}' . +'\x{9BE8}\x{9BF0}\x{9BF1}\x{9BF2}\x{9BF5}\x{9C04}\x{9C06}\x{9C08}\x{9C09}' . +'\x{9C0A}\x{9C0C}\x{9C0D}\x{9C10}\x{9C12}\x{9C13}\x{9C14}\x{9C15}\x{9C1B}' . +'\x{9C21}\x{9C24}\x{9C25}\x{9C2D}\x{9C2E}\x{9C2F}\x{9C30}\x{9C32}\x{9C39}' . +'\x{9C3A}\x{9C3B}\x{9C3E}\x{9C46}\x{9C47}\x{9C48}\x{9C52}\x{9C57}\x{9C5A}' . +'\x{9C60}\x{9C67}\x{9C76}\x{9C78}\x{9CE5}\x{9CE7}\x{9CE9}\x{9CEB}\x{9CEC}' . +'\x{9CF0}\x{9CF3}\x{9CF4}\x{9CF6}\x{9D03}\x{9D06}\x{9D07}\x{9D08}\x{9D09}' . +'\x{9D0E}\x{9D12}\x{9D15}\x{9D1B}\x{9D1F}\x{9D23}\x{9D26}\x{9D28}\x{9D2A}' . +'\x{9D2B}\x{9D2C}\x{9D3B}\x{9D3E}\x{9D3F}\x{9D41}\x{9D44}\x{9D46}\x{9D48}' . +'\x{9D50}\x{9D51}\x{9D59}\x{9D5C}\x{9D5D}\x{9D5E}\x{9D60}\x{9D61}\x{9D64}' . +'\x{9D6C}\x{9D6F}\x{9D72}\x{9D7A}\x{9D87}\x{9D89}\x{9D8F}\x{9D9A}\x{9DA4}' . +'\x{9DA9}\x{9DAB}\x{9DAF}\x{9DB2}\x{9DB4}\x{9DB8}\x{9DBA}\x{9DBB}\x{9DC1}' . +'\x{9DC2}\x{9DC4}\x{9DC6}\x{9DCF}\x{9DD3}\x{9DD9}\x{9DE6}\x{9DED}\x{9DEF}' . +'\x{9DF2}\x{9DF8}\x{9DF9}\x{9DFA}\x{9DFD}\x{9E1A}\x{9E1B}\x{9E1E}\x{9E75}' . +'\x{9E78}\x{9E79}\x{9E7D}\x{9E7F}\x{9E81}\x{9E88}\x{9E8B}\x{9E8C}\x{9E91}' . +'\x{9E92}\x{9E93}\x{9E95}\x{9E97}\x{9E9D}\x{9E9F}\x{9EA5}\x{9EA6}\x{9EA9}' . +'\x{9EAA}\x{9EAD}\x{9EB8}\x{9EB9}\x{9EBA}\x{9EBB}\x{9EBC}\x{9EBE}\x{9EBF}' . +'\x{9EC4}\x{9ECC}\x{9ECD}\x{9ECE}\x{9ECF}\x{9ED0}\x{9ED2}\x{9ED4}\x{9ED8}' . +'\x{9ED9}\x{9EDB}\x{9EDC}\x{9EDD}\x{9EDE}\x{9EE0}\x{9EE5}\x{9EE8}\x{9EEF}' . +'\x{9EF4}\x{9EF6}\x{9EF7}\x{9EF9}\x{9EFB}\x{9EFC}\x{9EFD}\x{9F07}\x{9F08}' . +'\x{9F0E}\x{9F13}\x{9F15}\x{9F20}\x{9F21}\x{9F2C}\x{9F3B}\x{9F3E}\x{9F4A}' . +'\x{9F4B}\x{9F4E}\x{9F4F}\x{9F52}\x{9F54}\x{9F5F}\x{9F60}\x{9F61}\x{9F62}' . +'\x{9F63}\x{9F66}\x{9F67}\x{9F6A}\x{9F6C}\x{9F72}\x{9F76}\x{9F77}\x{9F8D}' . +'\x{9F95}\x{9F9C}\x{9F9D}\x{9FA0}]{1,15}$/iu', + 12 => '/^[\x{002d}0-9a-z\x{3447}\x{3473}\x{359E}\x{360E}\x{361A}\x{3918}\x{396E}\x{39CF}\x{39D0}' . +'\x{39DF}\x{3A73}\x{3B4E}\x{3C6E}\x{3CE0}\x{4056}\x{415F}\x{4337}\x{43AC}' . +'\x{43B1}\x{43DD}\x{44D6}\x{464C}\x{4661}\x{4723}\x{4729}\x{477C}\x{478D}' . +'\x{4947}\x{497A}\x{497D}\x{4982}\x{4983}\x{4985}\x{4986}\x{499B}\x{499F}' . +'\x{49B6}\x{49B7}\x{4C77}\x{4C9F}\x{4CA0}\x{4CA1}\x{4CA2}\x{4CA3}\x{4D13}' . +'\x{4D14}\x{4D15}\x{4D16}\x{4D17}\x{4D18}\x{4D19}\x{4DAE}\x{4E00}\x{4E01}' . +'\x{4E02}\x{4E03}\x{4E04}\x{4E05}\x{4E06}\x{4E07}\x{4E08}\x{4E09}\x{4E0A}' . +'\x{4E0B}\x{4E0C}\x{4E0D}\x{4E0E}\x{4E0F}\x{4E10}\x{4E11}\x{4E13}\x{4E14}' . +'\x{4E15}\x{4E16}\x{4E17}\x{4E18}\x{4E19}\x{4E1A}\x{4E1B}\x{4E1C}\x{4E1D}' . +'\x{4E1E}\x{4E1F}\x{4E20}\x{4E21}\x{4E22}\x{4E23}\x{4E24}\x{4E25}\x{4E26}' . +'\x{4E27}\x{4E28}\x{4E2A}\x{4E2B}\x{4E2C}\x{4E2D}\x{4E2E}\x{4E2F}\x{4E30}' . +'\x{4E31}\x{4E32}\x{4E33}\x{4E34}\x{4E35}\x{4E36}\x{4E37}\x{4E38}\x{4E39}' . +'\x{4E3A}\x{4E3B}\x{4E3C}\x{4E3D}\x{4E3E}\x{4E3F}\x{4E40}\x{4E41}\x{4E42}' . +'\x{4E43}\x{4E44}\x{4E45}\x{4E46}\x{4E47}\x{4E48}\x{4E49}\x{4E4A}\x{4E4B}' . +'\x{4E4C}\x{4E4D}\x{4E4E}\x{4E4F}\x{4E50}\x{4E51}\x{4E52}\x{4E53}\x{4E54}' . +'\x{4E56}\x{4E57}\x{4E58}\x{4E59}\x{4E5A}\x{4E5B}\x{4E5C}\x{4E5D}\x{4E5E}' . +'\x{4E5F}\x{4E60}\x{4E61}\x{4E62}\x{4E63}\x{4E64}\x{4E65}\x{4E66}\x{4E67}' . +'\x{4E69}\x{4E6A}\x{4E6B}\x{4E6C}\x{4E6D}\x{4E6E}\x{4E6F}\x{4E70}\x{4E71}' . +'\x{4E72}\x{4E73}\x{4E74}\x{4E75}\x{4E76}\x{4E77}\x{4E78}\x{4E7A}\x{4E7B}' . +'\x{4E7C}\x{4E7D}\x{4E7E}\x{4E7F}\x{4E80}\x{4E81}\x{4E82}\x{4E83}\x{4E84}' . +'\x{4E85}\x{4E86}\x{4E87}\x{4E88}\x{4E89}\x{4E8B}\x{4E8C}\x{4E8D}\x{4E8E}' . +'\x{4E8F}\x{4E90}\x{4E91}\x{4E92}\x{4E93}\x{4E94}\x{4E95}\x{4E97}\x{4E98}' . +'\x{4E99}\x{4E9A}\x{4E9B}\x{4E9C}\x{4E9D}\x{4E9E}\x{4E9F}\x{4EA0}\x{4EA1}' . +'\x{4EA2}\x{4EA4}\x{4EA5}\x{4EA6}\x{4EA7}\x{4EA8}\x{4EA9}\x{4EAA}\x{4EAB}' . +'\x{4EAC}\x{4EAD}\x{4EAE}\x{4EAF}\x{4EB0}\x{4EB1}\x{4EB2}\x{4EB3}\x{4EB4}' . +'\x{4EB5}\x{4EB6}\x{4EB7}\x{4EB8}\x{4EB9}\x{4EBA}\x{4EBB}\x{4EBD}\x{4EBE}' . +'\x{4EBF}\x{4EC0}\x{4EC1}\x{4EC2}\x{4EC3}\x{4EC4}\x{4EC5}\x{4EC6}\x{4EC7}' . +'\x{4EC8}\x{4EC9}\x{4ECA}\x{4ECB}\x{4ECD}\x{4ECE}\x{4ECF}\x{4ED0}\x{4ED1}' . +'\x{4ED2}\x{4ED3}\x{4ED4}\x{4ED5}\x{4ED6}\x{4ED7}\x{4ED8}\x{4ED9}\x{4EDA}' . +'\x{4EDB}\x{4EDC}\x{4EDD}\x{4EDE}\x{4EDF}\x{4EE0}\x{4EE1}\x{4EE2}\x{4EE3}' . +'\x{4EE4}\x{4EE5}\x{4EE6}\x{4EE8}\x{4EE9}\x{4EEA}\x{4EEB}\x{4EEC}\x{4EEF}' . +'\x{4EF0}\x{4EF1}\x{4EF2}\x{4EF3}\x{4EF4}\x{4EF5}\x{4EF6}\x{4EF7}\x{4EFB}' . +'\x{4EFD}\x{4EFF}\x{4F00}\x{4F01}\x{4F02}\x{4F03}\x{4F04}\x{4F05}\x{4F06}' . +'\x{4F08}\x{4F09}\x{4F0A}\x{4F0B}\x{4F0C}\x{4F0D}\x{4F0E}\x{4F0F}\x{4F10}' . +'\x{4F11}\x{4F12}\x{4F13}\x{4F14}\x{4F15}\x{4F17}\x{4F18}\x{4F19}\x{4F1A}' . +'\x{4F1B}\x{4F1C}\x{4F1D}\x{4F1E}\x{4F1F}\x{4F20}\x{4F21}\x{4F22}\x{4F23}' . +'\x{4F24}\x{4F25}\x{4F26}\x{4F27}\x{4F29}\x{4F2A}\x{4F2B}\x{4F2C}\x{4F2D}' . +'\x{4F2E}\x{4F2F}\x{4F30}\x{4F32}\x{4F33}\x{4F34}\x{4F36}\x{4F38}\x{4F39}' . +'\x{4F3A}\x{4F3B}\x{4F3C}\x{4F3D}\x{4F3E}\x{4F3F}\x{4F41}\x{4F42}\x{4F43}' . +'\x{4F45}\x{4F46}\x{4F47}\x{4F48}\x{4F49}\x{4F4A}\x{4F4B}\x{4F4C}\x{4F4D}' . +'\x{4F4E}\x{4F4F}\x{4F50}\x{4F51}\x{4F52}\x{4F53}\x{4F54}\x{4F55}\x{4F56}' . +'\x{4F57}\x{4F58}\x{4F59}\x{4F5A}\x{4F5B}\x{4F5C}\x{4F5D}\x{4F5E}\x{4F5F}' . +'\x{4F60}\x{4F61}\x{4F62}\x{4F63}\x{4F64}\x{4F65}\x{4F66}\x{4F67}\x{4F68}' . +'\x{4F69}\x{4F6A}\x{4F6B}\x{4F6C}\x{4F6D}\x{4F6E}\x{4F6F}\x{4F70}\x{4F72}' . +'\x{4F73}\x{4F74}\x{4F75}\x{4F76}\x{4F77}\x{4F78}\x{4F79}\x{4F7A}\x{4F7B}' . +'\x{4F7C}\x{4F7D}\x{4F7E}\x{4F7F}\x{4F80}\x{4F81}\x{4F82}\x{4F83}\x{4F84}' . +'\x{4F85}\x{4F86}\x{4F87}\x{4F88}\x{4F89}\x{4F8A}\x{4F8B}\x{4F8D}\x{4F8F}' . +'\x{4F90}\x{4F91}\x{4F92}\x{4F93}\x{4F94}\x{4F95}\x{4F96}\x{4F97}\x{4F98}' . +'\x{4F99}\x{4F9A}\x{4F9B}\x{4F9C}\x{4F9D}\x{4F9E}\x{4F9F}\x{4FA0}\x{4FA1}' . +'\x{4FA3}\x{4FA4}\x{4FA5}\x{4FA6}\x{4FA7}\x{4FA8}\x{4FA9}\x{4FAA}\x{4FAB}' . +'\x{4FAC}\x{4FAE}\x{4FAF}\x{4FB0}\x{4FB1}\x{4FB2}\x{4FB3}\x{4FB4}\x{4FB5}' . +'\x{4FB6}\x{4FB7}\x{4FB8}\x{4FB9}\x{4FBA}\x{4FBB}\x{4FBC}\x{4FBE}\x{4FBF}' . +'\x{4FC0}\x{4FC1}\x{4FC2}\x{4FC3}\x{4FC4}\x{4FC5}\x{4FC7}\x{4FC9}\x{4FCA}' . +'\x{4FCB}\x{4FCD}\x{4FCE}\x{4FCF}\x{4FD0}\x{4FD1}\x{4FD2}\x{4FD3}\x{4FD4}' . +'\x{4FD5}\x{4FD6}\x{4FD7}\x{4FD8}\x{4FD9}\x{4FDA}\x{4FDB}\x{4FDC}\x{4FDD}' . +'\x{4FDE}\x{4FDF}\x{4FE0}\x{4FE1}\x{4FE3}\x{4FE4}\x{4FE5}\x{4FE6}\x{4FE7}' . +'\x{4FE8}\x{4FE9}\x{4FEA}\x{4FEB}\x{4FEC}\x{4FED}\x{4FEE}\x{4FEF}\x{4FF0}' . +'\x{4FF1}\x{4FF2}\x{4FF3}\x{4FF4}\x{4FF5}\x{4FF6}\x{4FF7}\x{4FF8}\x{4FF9}' . +'\x{4FFA}\x{4FFB}\x{4FFE}\x{4FFF}\x{5000}\x{5001}\x{5002}\x{5003}\x{5004}' . +'\x{5005}\x{5006}\x{5007}\x{5008}\x{5009}\x{500A}\x{500B}\x{500C}\x{500D}' . +'\x{500E}\x{500F}\x{5011}\x{5012}\x{5013}\x{5014}\x{5015}\x{5016}\x{5017}' . +'\x{5018}\x{5019}\x{501A}\x{501B}\x{501C}\x{501D}\x{501E}\x{501F}\x{5020}' . +'\x{5021}\x{5022}\x{5023}\x{5024}\x{5025}\x{5026}\x{5027}\x{5028}\x{5029}' . +'\x{502A}\x{502B}\x{502C}\x{502D}\x{502E}\x{502F}\x{5030}\x{5031}\x{5032}' . +'\x{5033}\x{5035}\x{5036}\x{5037}\x{5039}\x{503A}\x{503B}\x{503C}\x{503E}' . +'\x{503F}\x{5040}\x{5041}\x{5043}\x{5044}\x{5045}\x{5046}\x{5047}\x{5048}' . +'\x{5049}\x{504A}\x{504B}\x{504C}\x{504D}\x{504E}\x{504F}\x{5051}\x{5053}' . +'\x{5054}\x{5055}\x{5056}\x{5057}\x{5059}\x{505A}\x{505B}\x{505C}\x{505D}' . +'\x{505E}\x{505F}\x{5060}\x{5061}\x{5062}\x{5063}\x{5064}\x{5065}\x{5066}' . +'\x{5067}\x{5068}\x{5069}\x{506A}\x{506B}\x{506C}\x{506D}\x{506E}\x{506F}' . +'\x{5070}\x{5071}\x{5072}\x{5073}\x{5074}\x{5075}\x{5076}\x{5077}\x{5078}' . +'\x{5079}\x{507A}\x{507B}\x{507D}\x{507E}\x{507F}\x{5080}\x{5082}\x{5083}' . +'\x{5084}\x{5085}\x{5086}\x{5087}\x{5088}\x{5089}\x{508A}\x{508B}\x{508C}' . +'\x{508D}\x{508E}\x{508F}\x{5090}\x{5091}\x{5092}\x{5094}\x{5095}\x{5096}' . +'\x{5098}\x{5099}\x{509A}\x{509B}\x{509C}\x{509D}\x{509E}\x{50A2}\x{50A3}' . +'\x{50A4}\x{50A5}\x{50A6}\x{50A7}\x{50A8}\x{50A9}\x{50AA}\x{50AB}\x{50AC}' . +'\x{50AD}\x{50AE}\x{50AF}\x{50B0}\x{50B1}\x{50B2}\x{50B3}\x{50B4}\x{50B5}' . +'\x{50B6}\x{50B7}\x{50B8}\x{50BA}\x{50BB}\x{50BC}\x{50BD}\x{50BE}\x{50BF}' . +'\x{50C0}\x{50C1}\x{50C2}\x{50C4}\x{50C5}\x{50C6}\x{50C7}\x{50C8}\x{50C9}' . +'\x{50CA}\x{50CB}\x{50CC}\x{50CD}\x{50CE}\x{50CF}\x{50D0}\x{50D1}\x{50D2}' . +'\x{50D3}\x{50D4}\x{50D5}\x{50D6}\x{50D7}\x{50D9}\x{50DA}\x{50DB}\x{50DC}' . +'\x{50DD}\x{50DE}\x{50E0}\x{50E3}\x{50E4}\x{50E5}\x{50E6}\x{50E7}\x{50E8}' . +'\x{50E9}\x{50EA}\x{50EC}\x{50ED}\x{50EE}\x{50EF}\x{50F0}\x{50F1}\x{50F2}' . +'\x{50F3}\x{50F5}\x{50F6}\x{50F8}\x{50F9}\x{50FA}\x{50FB}\x{50FC}\x{50FD}' . +'\x{50FE}\x{50FF}\x{5100}\x{5101}\x{5102}\x{5103}\x{5104}\x{5105}\x{5106}' . +'\x{5107}\x{5108}\x{5109}\x{510A}\x{510B}\x{510C}\x{510D}\x{510E}\x{510F}' . +'\x{5110}\x{5111}\x{5112}\x{5113}\x{5114}\x{5115}\x{5116}\x{5117}\x{5118}' . +'\x{5119}\x{511A}\x{511C}\x{511D}\x{511E}\x{511F}\x{5120}\x{5121}\x{5122}' . +'\x{5123}\x{5124}\x{5125}\x{5126}\x{5127}\x{5129}\x{512A}\x{512C}\x{512D}' . +'\x{512E}\x{512F}\x{5130}\x{5131}\x{5132}\x{5133}\x{5134}\x{5135}\x{5136}' . +'\x{5137}\x{5138}\x{5139}\x{513A}\x{513B}\x{513C}\x{513D}\x{513E}\x{513F}' . +'\x{5140}\x{5141}\x{5143}\x{5144}\x{5145}\x{5146}\x{5147}\x{5148}\x{5149}' . +'\x{514B}\x{514C}\x{514D}\x{514E}\x{5150}\x{5151}\x{5152}\x{5154}\x{5155}' . +'\x{5156}\x{5157}\x{5159}\x{515A}\x{515B}\x{515C}\x{515D}\x{515E}\x{515F}' . +'\x{5161}\x{5162}\x{5163}\x{5165}\x{5166}\x{5167}\x{5168}\x{5169}\x{516A}' . +'\x{516B}\x{516C}\x{516D}\x{516E}\x{516F}\x{5170}\x{5171}\x{5173}\x{5174}' . +'\x{5175}\x{5176}\x{5177}\x{5178}\x{5179}\x{517A}\x{517B}\x{517C}\x{517D}' . +'\x{517F}\x{5180}\x{5181}\x{5182}\x{5185}\x{5186}\x{5187}\x{5188}\x{5189}' . +'\x{518A}\x{518B}\x{518C}\x{518D}\x{518F}\x{5190}\x{5191}\x{5192}\x{5193}' . +'\x{5194}\x{5195}\x{5196}\x{5197}\x{5198}\x{5199}\x{519A}\x{519B}\x{519C}' . +'\x{519D}\x{519E}\x{519F}\x{51A0}\x{51A2}\x{51A4}\x{51A5}\x{51A6}\x{51A7}' . +'\x{51A8}\x{51AA}\x{51AB}\x{51AC}\x{51AE}\x{51AF}\x{51B0}\x{51B1}\x{51B2}' . +'\x{51B3}\x{51B5}\x{51B6}\x{51B7}\x{51B9}\x{51BB}\x{51BC}\x{51BD}\x{51BE}' . +'\x{51BF}\x{51C0}\x{51C1}\x{51C3}\x{51C4}\x{51C5}\x{51C6}\x{51C7}\x{51C8}' . +'\x{51C9}\x{51CA}\x{51CB}\x{51CC}\x{51CD}\x{51CE}\x{51CF}\x{51D0}\x{51D1}' . +'\x{51D4}\x{51D5}\x{51D6}\x{51D7}\x{51D8}\x{51D9}\x{51DA}\x{51DB}\x{51DC}' . +'\x{51DD}\x{51DE}\x{51E0}\x{51E1}\x{51E2}\x{51E3}\x{51E4}\x{51E5}\x{51E7}' . +'\x{51E8}\x{51E9}\x{51EA}\x{51EB}\x{51ED}\x{51EF}\x{51F0}\x{51F1}\x{51F3}' . +'\x{51F4}\x{51F5}\x{51F6}\x{51F7}\x{51F8}\x{51F9}\x{51FA}\x{51FB}\x{51FC}' . +'\x{51FD}\x{51FE}\x{51FF}\x{5200}\x{5201}\x{5202}\x{5203}\x{5204}\x{5205}' . +'\x{5206}\x{5207}\x{5208}\x{5209}\x{520A}\x{520B}\x{520C}\x{520D}\x{520E}' . +'\x{520F}\x{5210}\x{5211}\x{5212}\x{5213}\x{5214}\x{5215}\x{5216}\x{5217}' . +'\x{5218}\x{5219}\x{521A}\x{521B}\x{521C}\x{521D}\x{521E}\x{521F}\x{5220}' . +'\x{5221}\x{5222}\x{5223}\x{5224}\x{5225}\x{5226}\x{5228}\x{5229}\x{522A}' . +'\x{522B}\x{522C}\x{522D}\x{522E}\x{522F}\x{5230}\x{5231}\x{5232}\x{5233}' . +'\x{5234}\x{5235}\x{5236}\x{5237}\x{5238}\x{5239}\x{523A}\x{523B}\x{523C}' . +'\x{523D}\x{523E}\x{523F}\x{5240}\x{5241}\x{5242}\x{5243}\x{5244}\x{5245}' . +'\x{5246}\x{5247}\x{5248}\x{5249}\x{524A}\x{524B}\x{524C}\x{524D}\x{524E}' . +'\x{5250}\x{5251}\x{5252}\x{5254}\x{5255}\x{5256}\x{5257}\x{5258}\x{5259}' . +'\x{525A}\x{525B}\x{525C}\x{525D}\x{525E}\x{525F}\x{5260}\x{5261}\x{5262}' . +'\x{5263}\x{5264}\x{5265}\x{5267}\x{5268}\x{5269}\x{526A}\x{526B}\x{526C}' . +'\x{526D}\x{526E}\x{526F}\x{5270}\x{5272}\x{5273}\x{5274}\x{5275}\x{5276}' . +'\x{5277}\x{5278}\x{527A}\x{527B}\x{527C}\x{527D}\x{527E}\x{527F}\x{5280}' . +'\x{5281}\x{5282}\x{5283}\x{5284}\x{5286}\x{5287}\x{5288}\x{5289}\x{528A}' . +'\x{528B}\x{528C}\x{528D}\x{528F}\x{5290}\x{5291}\x{5292}\x{5293}\x{5294}' . +'\x{5295}\x{5296}\x{5297}\x{5298}\x{5299}\x{529A}\x{529B}\x{529C}\x{529D}' . +'\x{529E}\x{529F}\x{52A0}\x{52A1}\x{52A2}\x{52A3}\x{52A5}\x{52A6}\x{52A7}' . +'\x{52A8}\x{52A9}\x{52AA}\x{52AB}\x{52AC}\x{52AD}\x{52AE}\x{52AF}\x{52B0}' . +'\x{52B1}\x{52B2}\x{52B3}\x{52B4}\x{52B5}\x{52B6}\x{52B7}\x{52B8}\x{52B9}' . +'\x{52BA}\x{52BB}\x{52BC}\x{52BD}\x{52BE}\x{52BF}\x{52C0}\x{52C1}\x{52C2}' . +'\x{52C3}\x{52C6}\x{52C7}\x{52C9}\x{52CA}\x{52CB}\x{52CD}\x{52CF}\x{52D0}' . +'\x{52D2}\x{52D3}\x{52D5}\x{52D6}\x{52D7}\x{52D8}\x{52D9}\x{52DA}\x{52DB}' . +'\x{52DC}\x{52DD}\x{52DE}\x{52DF}\x{52E0}\x{52E2}\x{52E3}\x{52E4}\x{52E6}' . +'\x{52E7}\x{52E8}\x{52E9}\x{52EA}\x{52EB}\x{52EC}\x{52ED}\x{52EF}\x{52F0}' . +'\x{52F1}\x{52F2}\x{52F3}\x{52F4}\x{52F5}\x{52F6}\x{52F7}\x{52F8}\x{52F9}' . +'\x{52FA}\x{52FB}\x{52FC}\x{52FD}\x{52FE}\x{52FF}\x{5300}\x{5301}\x{5302}' . +'\x{5305}\x{5306}\x{5307}\x{5308}\x{5309}\x{530A}\x{530B}\x{530C}\x{530D}' . +'\x{530E}\x{530F}\x{5310}\x{5311}\x{5312}\x{5313}\x{5314}\x{5315}\x{5316}' . +'\x{5317}\x{5319}\x{531A}\x{531C}\x{531D}\x{531F}\x{5320}\x{5321}\x{5322}' . +'\x{5323}\x{5324}\x{5325}\x{5326}\x{5328}\x{532A}\x{532B}\x{532C}\x{532D}' . +'\x{532E}\x{532F}\x{5330}\x{5331}\x{5333}\x{5334}\x{5337}\x{5339}\x{533A}' . +'\x{533B}\x{533C}\x{533D}\x{533E}\x{533F}\x{5340}\x{5341}\x{5343}\x{5344}' . +'\x{5345}\x{5346}\x{5347}\x{5348}\x{5349}\x{534A}\x{534B}\x{534C}\x{534D}' . +'\x{534E}\x{534F}\x{5350}\x{5351}\x{5352}\x{5353}\x{5354}\x{5355}\x{5356}' . +'\x{5357}\x{5358}\x{5359}\x{535A}\x{535C}\x{535E}\x{535F}\x{5360}\x{5361}' . +'\x{5362}\x{5363}\x{5364}\x{5365}\x{5366}\x{5367}\x{5369}\x{536B}\x{536C}' . +'\x{536E}\x{536F}\x{5370}\x{5371}\x{5372}\x{5373}\x{5374}\x{5375}\x{5376}' . +'\x{5377}\x{5378}\x{5379}\x{537A}\x{537B}\x{537C}\x{537D}\x{537E}\x{537F}' . +'\x{5381}\x{5382}\x{5383}\x{5384}\x{5385}\x{5386}\x{5387}\x{5388}\x{5389}' . +'\x{538A}\x{538B}\x{538C}\x{538D}\x{538E}\x{538F}\x{5390}\x{5391}\x{5392}' . +'\x{5393}\x{5394}\x{5395}\x{5396}\x{5397}\x{5398}\x{5399}\x{539A}\x{539B}' . +'\x{539C}\x{539D}\x{539E}\x{539F}\x{53A0}\x{53A2}\x{53A3}\x{53A4}\x{53A5}' . +'\x{53A6}\x{53A7}\x{53A8}\x{53A9}\x{53AC}\x{53AD}\x{53AE}\x{53B0}\x{53B1}' . +'\x{53B2}\x{53B3}\x{53B4}\x{53B5}\x{53B6}\x{53B7}\x{53B8}\x{53B9}\x{53BB}' . +'\x{53BC}\x{53BD}\x{53BE}\x{53BF}\x{53C0}\x{53C1}\x{53C2}\x{53C3}\x{53C4}' . +'\x{53C6}\x{53C7}\x{53C8}\x{53C9}\x{53CA}\x{53CB}\x{53CC}\x{53CD}\x{53CE}' . +'\x{53D0}\x{53D1}\x{53D2}\x{53D3}\x{53D4}\x{53D5}\x{53D6}\x{53D7}\x{53D8}' . +'\x{53D9}\x{53DB}\x{53DC}\x{53DF}\x{53E0}\x{53E1}\x{53E2}\x{53E3}\x{53E4}' . +'\x{53E5}\x{53E6}\x{53E8}\x{53E9}\x{53EA}\x{53EB}\x{53EC}\x{53ED}\x{53EE}' . +'\x{53EF}\x{53F0}\x{53F1}\x{53F2}\x{53F3}\x{53F4}\x{53F5}\x{53F6}\x{53F7}' . +'\x{53F8}\x{53F9}\x{53FA}\x{53FB}\x{53FC}\x{53FD}\x{53FE}\x{5401}\x{5402}' . +'\x{5403}\x{5404}\x{5405}\x{5406}\x{5407}\x{5408}\x{5409}\x{540A}\x{540B}' . +'\x{540C}\x{540D}\x{540E}\x{540F}\x{5410}\x{5411}\x{5412}\x{5413}\x{5414}' . +'\x{5415}\x{5416}\x{5417}\x{5418}\x{5419}\x{541B}\x{541C}\x{541D}\x{541E}' . +'\x{541F}\x{5420}\x{5421}\x{5423}\x{5424}\x{5425}\x{5426}\x{5427}\x{5428}' . +'\x{5429}\x{542A}\x{542B}\x{542C}\x{542D}\x{542E}\x{542F}\x{5430}\x{5431}' . +'\x{5432}\x{5433}\x{5434}\x{5435}\x{5436}\x{5437}\x{5438}\x{5439}\x{543A}' . +'\x{543B}\x{543C}\x{543D}\x{543E}\x{543F}\x{5440}\x{5441}\x{5442}\x{5443}' . +'\x{5444}\x{5445}\x{5446}\x{5447}\x{5448}\x{5449}\x{544A}\x{544B}\x{544D}' . +'\x{544E}\x{544F}\x{5450}\x{5451}\x{5452}\x{5453}\x{5454}\x{5455}\x{5456}' . +'\x{5457}\x{5458}\x{5459}\x{545A}\x{545B}\x{545C}\x{545E}\x{545F}\x{5460}' . +'\x{5461}\x{5462}\x{5463}\x{5464}\x{5465}\x{5466}\x{5467}\x{5468}\x{546A}' . +'\x{546B}\x{546C}\x{546D}\x{546E}\x{546F}\x{5470}\x{5471}\x{5472}\x{5473}' . +'\x{5474}\x{5475}\x{5476}\x{5477}\x{5478}\x{5479}\x{547A}\x{547B}\x{547C}' . +'\x{547D}\x{547E}\x{547F}\x{5480}\x{5481}\x{5482}\x{5483}\x{5484}\x{5485}' . +'\x{5486}\x{5487}\x{5488}\x{5489}\x{548B}\x{548C}\x{548D}\x{548E}\x{548F}' . +'\x{5490}\x{5491}\x{5492}\x{5493}\x{5494}\x{5495}\x{5496}\x{5497}\x{5498}' . +'\x{5499}\x{549A}\x{549B}\x{549C}\x{549D}\x{549E}\x{549F}\x{54A0}\x{54A1}' . +'\x{54A2}\x{54A3}\x{54A4}\x{54A5}\x{54A6}\x{54A7}\x{54A8}\x{54A9}\x{54AA}' . +'\x{54AB}\x{54AC}\x{54AD}\x{54AE}\x{54AF}\x{54B0}\x{54B1}\x{54B2}\x{54B3}' . +'\x{54B4}\x{54B6}\x{54B7}\x{54B8}\x{54B9}\x{54BA}\x{54BB}\x{54BC}\x{54BD}' . +'\x{54BE}\x{54BF}\x{54C0}\x{54C1}\x{54C2}\x{54C3}\x{54C4}\x{54C5}\x{54C6}' . +'\x{54C7}\x{54C8}\x{54C9}\x{54CA}\x{54CB}\x{54CC}\x{54CD}\x{54CE}\x{54CF}' . +'\x{54D0}\x{54D1}\x{54D2}\x{54D3}\x{54D4}\x{54D5}\x{54D6}\x{54D7}\x{54D8}' . +'\x{54D9}\x{54DA}\x{54DB}\x{54DC}\x{54DD}\x{54DE}\x{54DF}\x{54E0}\x{54E1}' . +'\x{54E2}\x{54E3}\x{54E4}\x{54E5}\x{54E6}\x{54E7}\x{54E8}\x{54E9}\x{54EA}' . +'\x{54EB}\x{54EC}\x{54ED}\x{54EE}\x{54EF}\x{54F0}\x{54F1}\x{54F2}\x{54F3}' . +'\x{54F4}\x{54F5}\x{54F7}\x{54F8}\x{54F9}\x{54FA}\x{54FB}\x{54FC}\x{54FD}' . +'\x{54FE}\x{54FF}\x{5500}\x{5501}\x{5502}\x{5503}\x{5504}\x{5505}\x{5506}' . +'\x{5507}\x{5508}\x{5509}\x{550A}\x{550B}\x{550C}\x{550D}\x{550E}\x{550F}' . +'\x{5510}\x{5511}\x{5512}\x{5513}\x{5514}\x{5516}\x{5517}\x{551A}\x{551B}' . +'\x{551C}\x{551D}\x{551E}\x{551F}\x{5520}\x{5521}\x{5522}\x{5523}\x{5524}' . +'\x{5525}\x{5526}\x{5527}\x{5528}\x{5529}\x{552A}\x{552B}\x{552C}\x{552D}' . +'\x{552E}\x{552F}\x{5530}\x{5531}\x{5532}\x{5533}\x{5534}\x{5535}\x{5536}' . +'\x{5537}\x{5538}\x{5539}\x{553A}\x{553B}\x{553C}\x{553D}\x{553E}\x{553F}' . +'\x{5540}\x{5541}\x{5542}\x{5543}\x{5544}\x{5545}\x{5546}\x{5548}\x{5549}' . +'\x{554A}\x{554B}\x{554C}\x{554D}\x{554E}\x{554F}\x{5550}\x{5551}\x{5552}' . +'\x{5553}\x{5554}\x{5555}\x{5556}\x{5557}\x{5558}\x{5559}\x{555A}\x{555B}' . +'\x{555C}\x{555D}\x{555E}\x{555F}\x{5561}\x{5562}\x{5563}\x{5564}\x{5565}' . +'\x{5566}\x{5567}\x{5568}\x{5569}\x{556A}\x{556B}\x{556C}\x{556D}\x{556E}' . +'\x{556F}\x{5570}\x{5571}\x{5572}\x{5573}\x{5574}\x{5575}\x{5576}\x{5577}' . +'\x{5578}\x{5579}\x{557B}\x{557C}\x{557D}\x{557E}\x{557F}\x{5580}\x{5581}' . +'\x{5582}\x{5583}\x{5584}\x{5585}\x{5586}\x{5587}\x{5588}\x{5589}\x{558A}' . +'\x{558B}\x{558C}\x{558D}\x{558E}\x{558F}\x{5590}\x{5591}\x{5592}\x{5593}' . +'\x{5594}\x{5595}\x{5596}\x{5597}\x{5598}\x{5599}\x{559A}\x{559B}\x{559C}' . +'\x{559D}\x{559E}\x{559F}\x{55A0}\x{55A1}\x{55A2}\x{55A3}\x{55A4}\x{55A5}' . +'\x{55A6}\x{55A7}\x{55A8}\x{55A9}\x{55AA}\x{55AB}\x{55AC}\x{55AD}\x{55AE}' . +'\x{55AF}\x{55B0}\x{55B1}\x{55B2}\x{55B3}\x{55B4}\x{55B5}\x{55B6}\x{55B7}' . +'\x{55B8}\x{55B9}\x{55BA}\x{55BB}\x{55BC}\x{55BD}\x{55BE}\x{55BF}\x{55C0}' . +'\x{55C1}\x{55C2}\x{55C3}\x{55C4}\x{55C5}\x{55C6}\x{55C7}\x{55C8}\x{55C9}' . +'\x{55CA}\x{55CB}\x{55CC}\x{55CD}\x{55CE}\x{55CF}\x{55D0}\x{55D1}\x{55D2}' . +'\x{55D3}\x{55D4}\x{55D5}\x{55D6}\x{55D7}\x{55D8}\x{55D9}\x{55DA}\x{55DB}' . +'\x{55DC}\x{55DD}\x{55DE}\x{55DF}\x{55E1}\x{55E2}\x{55E3}\x{55E4}\x{55E5}' . +'\x{55E6}\x{55E7}\x{55E8}\x{55E9}\x{55EA}\x{55EB}\x{55EC}\x{55ED}\x{55EE}' . +'\x{55EF}\x{55F0}\x{55F1}\x{55F2}\x{55F3}\x{55F4}\x{55F5}\x{55F6}\x{55F7}' . +'\x{55F9}\x{55FA}\x{55FB}\x{55FC}\x{55FD}\x{55FE}\x{55FF}\x{5600}\x{5601}' . +'\x{5602}\x{5603}\x{5604}\x{5606}\x{5607}\x{5608}\x{5609}\x{560C}\x{560D}' . +'\x{560E}\x{560F}\x{5610}\x{5611}\x{5612}\x{5613}\x{5614}\x{5615}\x{5616}' . +'\x{5617}\x{5618}\x{5619}\x{561A}\x{561B}\x{561C}\x{561D}\x{561E}\x{561F}' . +'\x{5621}\x{5622}\x{5623}\x{5624}\x{5625}\x{5626}\x{5627}\x{5628}\x{5629}' . +'\x{562A}\x{562C}\x{562D}\x{562E}\x{562F}\x{5630}\x{5631}\x{5632}\x{5633}' . +'\x{5634}\x{5635}\x{5636}\x{5638}\x{5639}\x{563A}\x{563B}\x{563D}\x{563E}' . +'\x{563F}\x{5640}\x{5641}\x{5642}\x{5643}\x{5645}\x{5646}\x{5647}\x{5648}' . +'\x{5649}\x{564A}\x{564C}\x{564D}\x{564E}\x{564F}\x{5650}\x{5652}\x{5653}' . +'\x{5654}\x{5655}\x{5657}\x{5658}\x{5659}\x{565A}\x{565B}\x{565C}\x{565D}' . +'\x{565E}\x{5660}\x{5662}\x{5663}\x{5664}\x{5665}\x{5666}\x{5667}\x{5668}' . +'\x{5669}\x{566A}\x{566B}\x{566C}\x{566D}\x{566E}\x{566F}\x{5670}\x{5671}' . +'\x{5672}\x{5673}\x{5674}\x{5676}\x{5677}\x{5678}\x{5679}\x{567A}\x{567B}' . +'\x{567C}\x{567E}\x{567F}\x{5680}\x{5681}\x{5682}\x{5683}\x{5684}\x{5685}' . +'\x{5686}\x{5687}\x{568A}\x{568C}\x{568D}\x{568E}\x{568F}\x{5690}\x{5691}' . +'\x{5692}\x{5693}\x{5694}\x{5695}\x{5697}\x{5698}\x{5699}\x{569A}\x{569B}' . +'\x{569C}\x{569D}\x{569F}\x{56A0}\x{56A1}\x{56A3}\x{56A4}\x{56A5}\x{56A6}' . +'\x{56A7}\x{56A8}\x{56A9}\x{56AA}\x{56AB}\x{56AC}\x{56AD}\x{56AE}\x{56AF}' . +'\x{56B0}\x{56B1}\x{56B2}\x{56B3}\x{56B4}\x{56B5}\x{56B6}\x{56B7}\x{56B8}' . +'\x{56B9}\x{56BB}\x{56BC}\x{56BD}\x{56BE}\x{56BF}\x{56C0}\x{56C1}\x{56C2}' . +'\x{56C3}\x{56C4}\x{56C5}\x{56C6}\x{56C7}\x{56C8}\x{56C9}\x{56CA}\x{56CB}' . +'\x{56CC}\x{56CD}\x{56CE}\x{56D0}\x{56D1}\x{56D2}\x{56D3}\x{56D4}\x{56D5}' . +'\x{56D6}\x{56D7}\x{56D8}\x{56DA}\x{56DB}\x{56DC}\x{56DD}\x{56DE}\x{56DF}' . +'\x{56E0}\x{56E1}\x{56E2}\x{56E3}\x{56E4}\x{56E5}\x{56E7}\x{56E8}\x{56E9}' . +'\x{56EA}\x{56EB}\x{56EC}\x{56ED}\x{56EE}\x{56EF}\x{56F0}\x{56F1}\x{56F2}' . +'\x{56F3}\x{56F4}\x{56F5}\x{56F7}\x{56F9}\x{56FA}\x{56FD}\x{56FE}\x{56FF}' . +'\x{5700}\x{5701}\x{5702}\x{5703}\x{5704}\x{5706}\x{5707}\x{5708}\x{5709}' . +'\x{570A}\x{570B}\x{570C}\x{570D}\x{570E}\x{570F}\x{5710}\x{5712}\x{5713}' . +'\x{5714}\x{5715}\x{5716}\x{5718}\x{5719}\x{571A}\x{571B}\x{571C}\x{571D}' . +'\x{571E}\x{571F}\x{5720}\x{5722}\x{5723}\x{5725}\x{5726}\x{5727}\x{5728}' . +'\x{5729}\x{572A}\x{572B}\x{572C}\x{572D}\x{572E}\x{572F}\x{5730}\x{5731}' . +'\x{5732}\x{5733}\x{5734}\x{5735}\x{5736}\x{5737}\x{5738}\x{5739}\x{573A}' . +'\x{573B}\x{573C}\x{573E}\x{573F}\x{5740}\x{5741}\x{5742}\x{5744}\x{5745}' . +'\x{5746}\x{5747}\x{5749}\x{574A}\x{574B}\x{574C}\x{574D}\x{574E}\x{574F}' . +'\x{5750}\x{5751}\x{5752}\x{5753}\x{5754}\x{5757}\x{5759}\x{575A}\x{575B}' . +'\x{575C}\x{575D}\x{575E}\x{575F}\x{5760}\x{5761}\x{5762}\x{5764}\x{5765}' . +'\x{5766}\x{5767}\x{5768}\x{5769}\x{576A}\x{576B}\x{576C}\x{576D}\x{576F}' . +'\x{5770}\x{5771}\x{5772}\x{5773}\x{5774}\x{5775}\x{5776}\x{5777}\x{5779}' . +'\x{577A}\x{577B}\x{577C}\x{577D}\x{577E}\x{577F}\x{5780}\x{5782}\x{5783}' . +'\x{5784}\x{5785}\x{5786}\x{5788}\x{5789}\x{578A}\x{578B}\x{578C}\x{578D}' . +'\x{578E}\x{578F}\x{5790}\x{5791}\x{5792}\x{5793}\x{5794}\x{5795}\x{5797}' . +'\x{5798}\x{5799}\x{579A}\x{579B}\x{579C}\x{579D}\x{579E}\x{579F}\x{57A0}' . +'\x{57A1}\x{57A2}\x{57A3}\x{57A4}\x{57A5}\x{57A6}\x{57A7}\x{57A9}\x{57AA}' . +'\x{57AB}\x{57AC}\x{57AD}\x{57AE}\x{57AF}\x{57B0}\x{57B1}\x{57B2}\x{57B3}' . +'\x{57B4}\x{57B5}\x{57B6}\x{57B7}\x{57B8}\x{57B9}\x{57BA}\x{57BB}\x{57BC}' . +'\x{57BD}\x{57BE}\x{57BF}\x{57C0}\x{57C1}\x{57C2}\x{57C3}\x{57C4}\x{57C5}' . +'\x{57C6}\x{57C7}\x{57C8}\x{57C9}\x{57CB}\x{57CC}\x{57CD}\x{57CE}\x{57CF}' . +'\x{57D0}\x{57D2}\x{57D3}\x{57D4}\x{57D5}\x{57D6}\x{57D8}\x{57D9}\x{57DA}' . +'\x{57DC}\x{57DD}\x{57DF}\x{57E0}\x{57E1}\x{57E2}\x{57E3}\x{57E4}\x{57E5}' . +'\x{57E6}\x{57E7}\x{57E8}\x{57E9}\x{57EA}\x{57EB}\x{57EC}\x{57ED}\x{57EE}' . +'\x{57EF}\x{57F0}\x{57F1}\x{57F2}\x{57F3}\x{57F4}\x{57F5}\x{57F6}\x{57F7}' . +'\x{57F8}\x{57F9}\x{57FA}\x{57FB}\x{57FC}\x{57FD}\x{57FE}\x{57FF}\x{5800}' . +'\x{5801}\x{5802}\x{5803}\x{5804}\x{5805}\x{5806}\x{5807}\x{5808}\x{5809}' . +'\x{580A}\x{580B}\x{580C}\x{580D}\x{580E}\x{580F}\x{5810}\x{5811}\x{5812}' . +'\x{5813}\x{5814}\x{5815}\x{5816}\x{5819}\x{581A}\x{581B}\x{581C}\x{581D}' . +'\x{581E}\x{581F}\x{5820}\x{5821}\x{5822}\x{5823}\x{5824}\x{5825}\x{5826}' . +'\x{5827}\x{5828}\x{5829}\x{582A}\x{582B}\x{582C}\x{582D}\x{582E}\x{582F}' . +'\x{5830}\x{5831}\x{5832}\x{5833}\x{5834}\x{5835}\x{5836}\x{5837}\x{5838}' . +'\x{5839}\x{583A}\x{583B}\x{583C}\x{583D}\x{583E}\x{583F}\x{5840}\x{5842}' . +'\x{5843}\x{5844}\x{5845}\x{5846}\x{5847}\x{5848}\x{5849}\x{584A}\x{584B}' . +'\x{584C}\x{584D}\x{584E}\x{584F}\x{5851}\x{5852}\x{5853}\x{5854}\x{5855}' . +'\x{5857}\x{5858}\x{5859}\x{585A}\x{585B}\x{585C}\x{585D}\x{585E}\x{585F}' . +'\x{5861}\x{5862}\x{5863}\x{5864}\x{5865}\x{5868}\x{5869}\x{586A}\x{586B}' . +'\x{586C}\x{586D}\x{586E}\x{586F}\x{5870}\x{5871}\x{5872}\x{5873}\x{5874}' . +'\x{5875}\x{5876}\x{5878}\x{5879}\x{587A}\x{587B}\x{587C}\x{587D}\x{587E}' . +'\x{587F}\x{5880}\x{5881}\x{5882}\x{5883}\x{5884}\x{5885}\x{5886}\x{5887}' . +'\x{5888}\x{5889}\x{588A}\x{588B}\x{588C}\x{588D}\x{588E}\x{588F}\x{5890}' . +'\x{5891}\x{5892}\x{5893}\x{5894}\x{5896}\x{5897}\x{5898}\x{5899}\x{589A}' . +'\x{589B}\x{589C}\x{589D}\x{589E}\x{589F}\x{58A0}\x{58A1}\x{58A2}\x{58A3}' . +'\x{58A4}\x{58A5}\x{58A6}\x{58A7}\x{58A8}\x{58A9}\x{58AB}\x{58AC}\x{58AD}' . +'\x{58AE}\x{58AF}\x{58B0}\x{58B1}\x{58B2}\x{58B3}\x{58B4}\x{58B7}\x{58B8}' . +'\x{58B9}\x{58BA}\x{58BB}\x{58BC}\x{58BD}\x{58BE}\x{58BF}\x{58C1}\x{58C2}' . +'\x{58C5}\x{58C6}\x{58C7}\x{58C8}\x{58C9}\x{58CA}\x{58CB}\x{58CE}\x{58CF}' . +'\x{58D1}\x{58D2}\x{58D3}\x{58D4}\x{58D5}\x{58D6}\x{58D7}\x{58D8}\x{58D9}' . +'\x{58DA}\x{58DB}\x{58DD}\x{58DE}\x{58DF}\x{58E0}\x{58E2}\x{58E3}\x{58E4}' . +'\x{58E5}\x{58E7}\x{58E8}\x{58E9}\x{58EA}\x{58EB}\x{58EC}\x{58ED}\x{58EE}' . +'\x{58EF}\x{58F0}\x{58F1}\x{58F2}\x{58F3}\x{58F4}\x{58F6}\x{58F7}\x{58F8}' . +'\x{58F9}\x{58FA}\x{58FB}\x{58FC}\x{58FD}\x{58FE}\x{58FF}\x{5900}\x{5902}' . +'\x{5903}\x{5904}\x{5906}\x{5907}\x{5909}\x{590A}\x{590B}\x{590C}\x{590D}' . +'\x{590E}\x{590F}\x{5910}\x{5912}\x{5914}\x{5915}\x{5916}\x{5917}\x{5918}' . +'\x{5919}\x{591A}\x{591B}\x{591C}\x{591D}\x{591E}\x{591F}\x{5920}\x{5921}' . +'\x{5922}\x{5924}\x{5925}\x{5926}\x{5927}\x{5928}\x{5929}\x{592A}\x{592B}' . +'\x{592C}\x{592D}\x{592E}\x{592F}\x{5930}\x{5931}\x{5932}\x{5934}\x{5935}' . +'\x{5937}\x{5938}\x{5939}\x{593A}\x{593B}\x{593C}\x{593D}\x{593E}\x{593F}' . +'\x{5940}\x{5941}\x{5942}\x{5943}\x{5944}\x{5945}\x{5946}\x{5947}\x{5948}' . +'\x{5949}\x{594A}\x{594B}\x{594C}\x{594D}\x{594E}\x{594F}\x{5950}\x{5951}' . +'\x{5952}\x{5953}\x{5954}\x{5955}\x{5956}\x{5957}\x{5958}\x{595A}\x{595C}' . +'\x{595D}\x{595E}\x{595F}\x{5960}\x{5961}\x{5962}\x{5963}\x{5964}\x{5965}' . +'\x{5966}\x{5967}\x{5968}\x{5969}\x{596A}\x{596B}\x{596C}\x{596D}\x{596E}' . +'\x{596F}\x{5970}\x{5971}\x{5972}\x{5973}\x{5974}\x{5975}\x{5976}\x{5977}' . +'\x{5978}\x{5979}\x{597A}\x{597B}\x{597C}\x{597D}\x{597E}\x{597F}\x{5980}' . +'\x{5981}\x{5982}\x{5983}\x{5984}\x{5985}\x{5986}\x{5987}\x{5988}\x{5989}' . +'\x{598A}\x{598B}\x{598C}\x{598D}\x{598E}\x{598F}\x{5990}\x{5991}\x{5992}' . +'\x{5993}\x{5994}\x{5995}\x{5996}\x{5997}\x{5998}\x{5999}\x{599A}\x{599C}' . +'\x{599D}\x{599E}\x{599F}\x{59A0}\x{59A1}\x{59A2}\x{59A3}\x{59A4}\x{59A5}' . +'\x{59A6}\x{59A7}\x{59A8}\x{59A9}\x{59AA}\x{59AB}\x{59AC}\x{59AD}\x{59AE}' . +'\x{59AF}\x{59B0}\x{59B1}\x{59B2}\x{59B3}\x{59B4}\x{59B5}\x{59B6}\x{59B8}' . +'\x{59B9}\x{59BA}\x{59BB}\x{59BC}\x{59BD}\x{59BE}\x{59BF}\x{59C0}\x{59C1}' . +'\x{59C2}\x{59C3}\x{59C4}\x{59C5}\x{59C6}\x{59C7}\x{59C8}\x{59C9}\x{59CA}' . +'\x{59CB}\x{59CC}\x{59CD}\x{59CE}\x{59CF}\x{59D0}\x{59D1}\x{59D2}\x{59D3}' . +'\x{59D4}\x{59D5}\x{59D6}\x{59D7}\x{59D8}\x{59D9}\x{59DA}\x{59DB}\x{59DC}' . +'\x{59DD}\x{59DE}\x{59DF}\x{59E0}\x{59E1}\x{59E2}\x{59E3}\x{59E4}\x{59E5}' . +'\x{59E6}\x{59E8}\x{59E9}\x{59EA}\x{59EB}\x{59EC}\x{59ED}\x{59EE}\x{59EF}' . +'\x{59F0}\x{59F1}\x{59F2}\x{59F3}\x{59F4}\x{59F5}\x{59F6}\x{59F7}\x{59F8}' . +'\x{59F9}\x{59FA}\x{59FB}\x{59FC}\x{59FD}\x{59FE}\x{59FF}\x{5A00}\x{5A01}' . +'\x{5A02}\x{5A03}\x{5A04}\x{5A05}\x{5A06}\x{5A07}\x{5A08}\x{5A09}\x{5A0A}' . +'\x{5A0B}\x{5A0C}\x{5A0D}\x{5A0E}\x{5A0F}\x{5A10}\x{5A11}\x{5A12}\x{5A13}' . +'\x{5A14}\x{5A15}\x{5A16}\x{5A17}\x{5A18}\x{5A19}\x{5A1A}\x{5A1B}\x{5A1C}' . +'\x{5A1D}\x{5A1E}\x{5A1F}\x{5A20}\x{5A21}\x{5A22}\x{5A23}\x{5A25}\x{5A27}' . +'\x{5A28}\x{5A29}\x{5A2A}\x{5A2B}\x{5A2D}\x{5A2E}\x{5A2F}\x{5A31}\x{5A32}' . +'\x{5A33}\x{5A34}\x{5A35}\x{5A36}\x{5A37}\x{5A38}\x{5A39}\x{5A3A}\x{5A3B}' . +'\x{5A3C}\x{5A3D}\x{5A3E}\x{5A3F}\x{5A40}\x{5A41}\x{5A42}\x{5A43}\x{5A44}' . +'\x{5A45}\x{5A46}\x{5A47}\x{5A48}\x{5A49}\x{5A4A}\x{5A4B}\x{5A4C}\x{5A4D}' . +'\x{5A4E}\x{5A4F}\x{5A50}\x{5A51}\x{5A52}\x{5A53}\x{5A55}\x{5A56}\x{5A57}' . +'\x{5A58}\x{5A5A}\x{5A5B}\x{5A5C}\x{5A5D}\x{5A5E}\x{5A5F}\x{5A60}\x{5A61}' . +'\x{5A62}\x{5A63}\x{5A64}\x{5A65}\x{5A66}\x{5A67}\x{5A68}\x{5A69}\x{5A6A}' . +'\x{5A6B}\x{5A6C}\x{5A6D}\x{5A6E}\x{5A70}\x{5A72}\x{5A73}\x{5A74}\x{5A75}' . +'\x{5A76}\x{5A77}\x{5A78}\x{5A79}\x{5A7A}\x{5A7B}\x{5A7C}\x{5A7D}\x{5A7E}' . +'\x{5A7F}\x{5A80}\x{5A81}\x{5A82}\x{5A83}\x{5A84}\x{5A85}\x{5A86}\x{5A88}' . +'\x{5A89}\x{5A8A}\x{5A8B}\x{5A8C}\x{5A8E}\x{5A8F}\x{5A90}\x{5A91}\x{5A92}' . +'\x{5A93}\x{5A94}\x{5A95}\x{5A96}\x{5A97}\x{5A98}\x{5A99}\x{5A9A}\x{5A9B}' . +'\x{5A9C}\x{5A9D}\x{5A9E}\x{5A9F}\x{5AA0}\x{5AA1}\x{5AA2}\x{5AA3}\x{5AA4}' . +'\x{5AA5}\x{5AA6}\x{5AA7}\x{5AA8}\x{5AA9}\x{5AAA}\x{5AAC}\x{5AAD}\x{5AAE}' . +'\x{5AAF}\x{5AB0}\x{5AB1}\x{5AB2}\x{5AB3}\x{5AB4}\x{5AB5}\x{5AB6}\x{5AB7}' . +'\x{5AB8}\x{5AB9}\x{5ABA}\x{5ABB}\x{5ABC}\x{5ABD}\x{5ABE}\x{5ABF}\x{5AC0}' . +'\x{5AC1}\x{5AC2}\x{5AC3}\x{5AC4}\x{5AC5}\x{5AC6}\x{5AC7}\x{5AC8}\x{5AC9}' . +'\x{5ACA}\x{5ACB}\x{5ACC}\x{5ACD}\x{5ACE}\x{5ACF}\x{5AD1}\x{5AD2}\x{5AD4}' . +'\x{5AD5}\x{5AD6}\x{5AD7}\x{5AD8}\x{5AD9}\x{5ADA}\x{5ADB}\x{5ADC}\x{5ADD}' . +'\x{5ADE}\x{5ADF}\x{5AE0}\x{5AE1}\x{5AE2}\x{5AE3}\x{5AE4}\x{5AE5}\x{5AE6}' . +'\x{5AE7}\x{5AE8}\x{5AE9}\x{5AEA}\x{5AEB}\x{5AEC}\x{5AED}\x{5AEE}\x{5AF1}' . +'\x{5AF2}\x{5AF3}\x{5AF4}\x{5AF5}\x{5AF6}\x{5AF7}\x{5AF8}\x{5AF9}\x{5AFA}' . +'\x{5AFB}\x{5AFC}\x{5AFD}\x{5AFE}\x{5AFF}\x{5B00}\x{5B01}\x{5B02}\x{5B03}' . +'\x{5B04}\x{5B05}\x{5B06}\x{5B07}\x{5B08}\x{5B09}\x{5B0B}\x{5B0C}\x{5B0E}' . +'\x{5B0F}\x{5B10}\x{5B11}\x{5B12}\x{5B13}\x{5B14}\x{5B15}\x{5B16}\x{5B17}' . +'\x{5B18}\x{5B19}\x{5B1A}\x{5B1B}\x{5B1C}\x{5B1D}\x{5B1E}\x{5B1F}\x{5B20}' . +'\x{5B21}\x{5B22}\x{5B23}\x{5B24}\x{5B25}\x{5B26}\x{5B27}\x{5B28}\x{5B29}' . +'\x{5B2A}\x{5B2B}\x{5B2C}\x{5B2D}\x{5B2E}\x{5B2F}\x{5B30}\x{5B31}\x{5B32}' . +'\x{5B33}\x{5B34}\x{5B35}\x{5B36}\x{5B37}\x{5B38}\x{5B3A}\x{5B3B}\x{5B3C}' . +'\x{5B3D}\x{5B3E}\x{5B3F}\x{5B40}\x{5B41}\x{5B42}\x{5B43}\x{5B44}\x{5B45}' . +'\x{5B47}\x{5B48}\x{5B49}\x{5B4A}\x{5B4B}\x{5B4C}\x{5B4D}\x{5B4E}\x{5B50}' . +'\x{5B51}\x{5B53}\x{5B54}\x{5B55}\x{5B56}\x{5B57}\x{5B58}\x{5B59}\x{5B5A}' . +'\x{5B5B}\x{5B5C}\x{5B5D}\x{5B5E}\x{5B5F}\x{5B62}\x{5B63}\x{5B64}\x{5B65}' . +'\x{5B66}\x{5B67}\x{5B68}\x{5B69}\x{5B6A}\x{5B6B}\x{5B6C}\x{5B6D}\x{5B6E}' . +'\x{5B70}\x{5B71}\x{5B72}\x{5B73}\x{5B74}\x{5B75}\x{5B76}\x{5B77}\x{5B78}' . +'\x{5B7A}\x{5B7B}\x{5B7C}\x{5B7D}\x{5B7F}\x{5B80}\x{5B81}\x{5B82}\x{5B83}' . +'\x{5B84}\x{5B85}\x{5B87}\x{5B88}\x{5B89}\x{5B8A}\x{5B8B}\x{5B8C}\x{5B8D}' . +'\x{5B8E}\x{5B8F}\x{5B91}\x{5B92}\x{5B93}\x{5B94}\x{5B95}\x{5B96}\x{5B97}' . +'\x{5B98}\x{5B99}\x{5B9A}\x{5B9B}\x{5B9C}\x{5B9D}\x{5B9E}\x{5B9F}\x{5BA0}' . +'\x{5BA1}\x{5BA2}\x{5BA3}\x{5BA4}\x{5BA5}\x{5BA6}\x{5BA7}\x{5BA8}\x{5BAA}' . +'\x{5BAB}\x{5BAC}\x{5BAD}\x{5BAE}\x{5BAF}\x{5BB0}\x{5BB1}\x{5BB3}\x{5BB4}' . +'\x{5BB5}\x{5BB6}\x{5BB8}\x{5BB9}\x{5BBA}\x{5BBB}\x{5BBD}\x{5BBE}\x{5BBF}' . +'\x{5BC0}\x{5BC1}\x{5BC2}\x{5BC3}\x{5BC4}\x{5BC5}\x{5BC6}\x{5BC7}\x{5BCA}' . +'\x{5BCB}\x{5BCC}\x{5BCD}\x{5BCE}\x{5BCF}\x{5BD0}\x{5BD1}\x{5BD2}\x{5BD3}' . +'\x{5BD4}\x{5BD5}\x{5BD6}\x{5BD8}\x{5BD9}\x{5BDB}\x{5BDC}\x{5BDD}\x{5BDE}' . +'\x{5BDF}\x{5BE0}\x{5BE1}\x{5BE2}\x{5BE3}\x{5BE4}\x{5BE5}\x{5BE6}\x{5BE7}' . +'\x{5BE8}\x{5BE9}\x{5BEA}\x{5BEB}\x{5BEC}\x{5BED}\x{5BEE}\x{5BEF}\x{5BF0}' . +'\x{5BF1}\x{5BF2}\x{5BF3}\x{5BF4}\x{5BF5}\x{5BF6}\x{5BF7}\x{5BF8}\x{5BF9}' . +'\x{5BFA}\x{5BFB}\x{5BFC}\x{5BFD}\x{5BFF}\x{5C01}\x{5C03}\x{5C04}\x{5C05}' . +'\x{5C06}\x{5C07}\x{5C08}\x{5C09}\x{5C0A}\x{5C0B}\x{5C0C}\x{5C0D}\x{5C0E}' . +'\x{5C0F}\x{5C10}\x{5C11}\x{5C12}\x{5C13}\x{5C14}\x{5C15}\x{5C16}\x{5C17}' . +'\x{5C18}\x{5C19}\x{5C1A}\x{5C1C}\x{5C1D}\x{5C1E}\x{5C1F}\x{5C20}\x{5C21}' . +'\x{5C22}\x{5C24}\x{5C25}\x{5C27}\x{5C28}\x{5C2A}\x{5C2B}\x{5C2C}\x{5C2D}' . +'\x{5C2E}\x{5C2F}\x{5C30}\x{5C31}\x{5C32}\x{5C33}\x{5C34}\x{5C35}\x{5C37}' . +'\x{5C38}\x{5C39}\x{5C3A}\x{5C3B}\x{5C3C}\x{5C3D}\x{5C3E}\x{5C3F}\x{5C40}' . +'\x{5C41}\x{5C42}\x{5C43}\x{5C44}\x{5C45}\x{5C46}\x{5C47}\x{5C48}\x{5C49}' . +'\x{5C4A}\x{5C4B}\x{5C4C}\x{5C4D}\x{5C4E}\x{5C4F}\x{5C50}\x{5C51}\x{5C52}' . +'\x{5C53}\x{5C54}\x{5C55}\x{5C56}\x{5C57}\x{5C58}\x{5C59}\x{5C5B}\x{5C5C}' . +'\x{5C5D}\x{5C5E}\x{5C5F}\x{5C60}\x{5C61}\x{5C62}\x{5C63}\x{5C64}\x{5C65}' . +'\x{5C66}\x{5C67}\x{5C68}\x{5C69}\x{5C6A}\x{5C6B}\x{5C6C}\x{5C6D}\x{5C6E}' . +'\x{5C6F}\x{5C70}\x{5C71}\x{5C72}\x{5C73}\x{5C74}\x{5C75}\x{5C76}\x{5C77}' . +'\x{5C78}\x{5C79}\x{5C7A}\x{5C7B}\x{5C7C}\x{5C7D}\x{5C7E}\x{5C7F}\x{5C80}' . +'\x{5C81}\x{5C82}\x{5C83}\x{5C84}\x{5C86}\x{5C87}\x{5C88}\x{5C89}\x{5C8A}' . +'\x{5C8B}\x{5C8C}\x{5C8D}\x{5C8E}\x{5C8F}\x{5C90}\x{5C91}\x{5C92}\x{5C93}' . +'\x{5C94}\x{5C95}\x{5C96}\x{5C97}\x{5C98}\x{5C99}\x{5C9A}\x{5C9B}\x{5C9C}' . +'\x{5C9D}\x{5C9E}\x{5C9F}\x{5CA0}\x{5CA1}\x{5CA2}\x{5CA3}\x{5CA4}\x{5CA5}' . +'\x{5CA6}\x{5CA7}\x{5CA8}\x{5CA9}\x{5CAA}\x{5CAB}\x{5CAC}\x{5CAD}\x{5CAE}' . +'\x{5CAF}\x{5CB0}\x{5CB1}\x{5CB2}\x{5CB3}\x{5CB5}\x{5CB6}\x{5CB7}\x{5CB8}' . +'\x{5CBA}\x{5CBB}\x{5CBC}\x{5CBD}\x{5CBE}\x{5CBF}\x{5CC1}\x{5CC2}\x{5CC3}' . +'\x{5CC4}\x{5CC5}\x{5CC6}\x{5CC7}\x{5CC8}\x{5CC9}\x{5CCA}\x{5CCB}\x{5CCC}' . +'\x{5CCD}\x{5CCE}\x{5CCF}\x{5CD0}\x{5CD1}\x{5CD2}\x{5CD3}\x{5CD4}\x{5CD6}' . +'\x{5CD7}\x{5CD8}\x{5CD9}\x{5CDA}\x{5CDB}\x{5CDC}\x{5CDE}\x{5CDF}\x{5CE0}' . +'\x{5CE1}\x{5CE2}\x{5CE3}\x{5CE4}\x{5CE5}\x{5CE6}\x{5CE7}\x{5CE8}\x{5CE9}' . +'\x{5CEA}\x{5CEB}\x{5CEC}\x{5CED}\x{5CEE}\x{5CEF}\x{5CF0}\x{5CF1}\x{5CF2}' . +'\x{5CF3}\x{5CF4}\x{5CF6}\x{5CF7}\x{5CF8}\x{5CF9}\x{5CFA}\x{5CFB}\x{5CFC}' . +'\x{5CFD}\x{5CFE}\x{5CFF}\x{5D00}\x{5D01}\x{5D02}\x{5D03}\x{5D04}\x{5D05}' . +'\x{5D06}\x{5D07}\x{5D08}\x{5D09}\x{5D0A}\x{5D0B}\x{5D0C}\x{5D0D}\x{5D0E}' . +'\x{5D0F}\x{5D10}\x{5D11}\x{5D12}\x{5D13}\x{5D14}\x{5D15}\x{5D16}\x{5D17}' . +'\x{5D18}\x{5D19}\x{5D1A}\x{5D1B}\x{5D1C}\x{5D1D}\x{5D1E}\x{5D1F}\x{5D20}' . +'\x{5D21}\x{5D22}\x{5D23}\x{5D24}\x{5D25}\x{5D26}\x{5D27}\x{5D28}\x{5D29}' . +'\x{5D2A}\x{5D2C}\x{5D2D}\x{5D2E}\x{5D30}\x{5D31}\x{5D32}\x{5D33}\x{5D34}' . +'\x{5D35}\x{5D36}\x{5D37}\x{5D38}\x{5D39}\x{5D3A}\x{5D3C}\x{5D3D}\x{5D3E}' . +'\x{5D3F}\x{5D40}\x{5D41}\x{5D42}\x{5D43}\x{5D44}\x{5D45}\x{5D46}\x{5D47}' . +'\x{5D48}\x{5D49}\x{5D4A}\x{5D4B}\x{5D4C}\x{5D4D}\x{5D4E}\x{5D4F}\x{5D50}' . +'\x{5D51}\x{5D52}\x{5D54}\x{5D55}\x{5D56}\x{5D58}\x{5D59}\x{5D5A}\x{5D5B}' . +'\x{5D5D}\x{5D5E}\x{5D5F}\x{5D61}\x{5D62}\x{5D63}\x{5D64}\x{5D65}\x{5D66}' . +'\x{5D67}\x{5D68}\x{5D69}\x{5D6A}\x{5D6B}\x{5D6C}\x{5D6D}\x{5D6E}\x{5D6F}' . +'\x{5D70}\x{5D71}\x{5D72}\x{5D73}\x{5D74}\x{5D75}\x{5D76}\x{5D77}\x{5D78}' . +'\x{5D79}\x{5D7A}\x{5D7B}\x{5D7C}\x{5D7D}\x{5D7E}\x{5D7F}\x{5D80}\x{5D81}' . +'\x{5D82}\x{5D84}\x{5D85}\x{5D86}\x{5D87}\x{5D88}\x{5D89}\x{5D8A}\x{5D8B}' . +'\x{5D8C}\x{5D8D}\x{5D8E}\x{5D8F}\x{5D90}\x{5D91}\x{5D92}\x{5D93}\x{5D94}' . +'\x{5D95}\x{5D97}\x{5D98}\x{5D99}\x{5D9A}\x{5D9B}\x{5D9C}\x{5D9D}\x{5D9E}' . +'\x{5D9F}\x{5DA0}\x{5DA1}\x{5DA2}\x{5DA5}\x{5DA6}\x{5DA7}\x{5DA8}\x{5DA9}' . +'\x{5DAA}\x{5DAC}\x{5DAD}\x{5DAE}\x{5DAF}\x{5DB0}\x{5DB1}\x{5DB2}\x{5DB4}' . +'\x{5DB5}\x{5DB6}\x{5DB7}\x{5DB8}\x{5DBA}\x{5DBB}\x{5DBC}\x{5DBD}\x{5DBE}' . +'\x{5DBF}\x{5DC0}\x{5DC1}\x{5DC2}\x{5DC3}\x{5DC5}\x{5DC6}\x{5DC7}\x{5DC8}' . +'\x{5DC9}\x{5DCA}\x{5DCB}\x{5DCC}\x{5DCD}\x{5DCE}\x{5DCF}\x{5DD0}\x{5DD1}' . +'\x{5DD2}\x{5DD3}\x{5DD4}\x{5DD5}\x{5DD6}\x{5DD8}\x{5DD9}\x{5DDB}\x{5DDD}' . +'\x{5DDE}\x{5DDF}\x{5DE0}\x{5DE1}\x{5DE2}\x{5DE3}\x{5DE4}\x{5DE5}\x{5DE6}' . +'\x{5DE7}\x{5DE8}\x{5DE9}\x{5DEA}\x{5DEB}\x{5DEC}\x{5DED}\x{5DEE}\x{5DEF}' . +'\x{5DF0}\x{5DF1}\x{5DF2}\x{5DF3}\x{5DF4}\x{5DF5}\x{5DF7}\x{5DF8}\x{5DF9}' . +'\x{5DFA}\x{5DFB}\x{5DFC}\x{5DFD}\x{5DFE}\x{5DFF}\x{5E00}\x{5E01}\x{5E02}' . +'\x{5E03}\x{5E04}\x{5E05}\x{5E06}\x{5E07}\x{5E08}\x{5E09}\x{5E0A}\x{5E0B}' . +'\x{5E0C}\x{5E0D}\x{5E0E}\x{5E0F}\x{5E10}\x{5E11}\x{5E13}\x{5E14}\x{5E15}' . +'\x{5E16}\x{5E17}\x{5E18}\x{5E19}\x{5E1A}\x{5E1B}\x{5E1C}\x{5E1D}\x{5E1E}' . +'\x{5E1F}\x{5E20}\x{5E21}\x{5E22}\x{5E23}\x{5E24}\x{5E25}\x{5E26}\x{5E27}' . +'\x{5E28}\x{5E29}\x{5E2A}\x{5E2B}\x{5E2C}\x{5E2D}\x{5E2E}\x{5E2F}\x{5E30}' . +'\x{5E31}\x{5E32}\x{5E33}\x{5E34}\x{5E35}\x{5E36}\x{5E37}\x{5E38}\x{5E39}' . +'\x{5E3A}\x{5E3B}\x{5E3C}\x{5E3D}\x{5E3E}\x{5E40}\x{5E41}\x{5E42}\x{5E43}' . +'\x{5E44}\x{5E45}\x{5E46}\x{5E47}\x{5E49}\x{5E4A}\x{5E4B}\x{5E4C}\x{5E4D}' . +'\x{5E4E}\x{5E4F}\x{5E50}\x{5E52}\x{5E53}\x{5E54}\x{5E55}\x{5E56}\x{5E57}' . +'\x{5E58}\x{5E59}\x{5E5A}\x{5E5B}\x{5E5C}\x{5E5D}\x{5E5E}\x{5E5F}\x{5E60}' . +'\x{5E61}\x{5E62}\x{5E63}\x{5E64}\x{5E65}\x{5E66}\x{5E67}\x{5E68}\x{5E69}' . +'\x{5E6A}\x{5E6B}\x{5E6C}\x{5E6D}\x{5E6E}\x{5E6F}\x{5E70}\x{5E71}\x{5E72}' . +'\x{5E73}\x{5E74}\x{5E75}\x{5E76}\x{5E77}\x{5E78}\x{5E79}\x{5E7A}\x{5E7B}' . +'\x{5E7C}\x{5E7D}\x{5E7E}\x{5E7F}\x{5E80}\x{5E81}\x{5E82}\x{5E83}\x{5E84}' . +'\x{5E85}\x{5E86}\x{5E87}\x{5E88}\x{5E89}\x{5E8A}\x{5E8B}\x{5E8C}\x{5E8D}' . +'\x{5E8E}\x{5E8F}\x{5E90}\x{5E91}\x{5E93}\x{5E94}\x{5E95}\x{5E96}\x{5E97}' . +'\x{5E98}\x{5E99}\x{5E9A}\x{5E9B}\x{5E9C}\x{5E9D}\x{5E9E}\x{5E9F}\x{5EA0}' . +'\x{5EA1}\x{5EA2}\x{5EA3}\x{5EA4}\x{5EA5}\x{5EA6}\x{5EA7}\x{5EA8}\x{5EA9}' . +'\x{5EAA}\x{5EAB}\x{5EAC}\x{5EAD}\x{5EAE}\x{5EAF}\x{5EB0}\x{5EB1}\x{5EB2}' . +'\x{5EB3}\x{5EB4}\x{5EB5}\x{5EB6}\x{5EB7}\x{5EB8}\x{5EB9}\x{5EBB}\x{5EBC}' . +'\x{5EBD}\x{5EBE}\x{5EBF}\x{5EC1}\x{5EC2}\x{5EC3}\x{5EC4}\x{5EC5}\x{5EC6}' . +'\x{5EC7}\x{5EC8}\x{5EC9}\x{5ECA}\x{5ECB}\x{5ECC}\x{5ECD}\x{5ECE}\x{5ECF}' . +'\x{5ED0}\x{5ED1}\x{5ED2}\x{5ED3}\x{5ED4}\x{5ED5}\x{5ED6}\x{5ED7}\x{5ED8}' . +'\x{5ED9}\x{5EDA}\x{5EDB}\x{5EDC}\x{5EDD}\x{5EDE}\x{5EDF}\x{5EE0}\x{5EE1}' . +'\x{5EE2}\x{5EE3}\x{5EE4}\x{5EE5}\x{5EE6}\x{5EE7}\x{5EE8}\x{5EE9}\x{5EEA}' . +'\x{5EEC}\x{5EED}\x{5EEE}\x{5EEF}\x{5EF0}\x{5EF1}\x{5EF2}\x{5EF3}\x{5EF4}' . +'\x{5EF5}\x{5EF6}\x{5EF7}\x{5EF8}\x{5EFA}\x{5EFB}\x{5EFC}\x{5EFD}\x{5EFE}' . +'\x{5EFF}\x{5F00}\x{5F01}\x{5F02}\x{5F03}\x{5F04}\x{5F05}\x{5F06}\x{5F07}' . +'\x{5F08}\x{5F0A}\x{5F0B}\x{5F0C}\x{5F0D}\x{5F0F}\x{5F11}\x{5F12}\x{5F13}' . +'\x{5F14}\x{5F15}\x{5F16}\x{5F17}\x{5F18}\x{5F19}\x{5F1A}\x{5F1B}\x{5F1C}' . +'\x{5F1D}\x{5F1E}\x{5F1F}\x{5F20}\x{5F21}\x{5F22}\x{5F23}\x{5F24}\x{5F25}' . +'\x{5F26}\x{5F27}\x{5F28}\x{5F29}\x{5F2A}\x{5F2B}\x{5F2C}\x{5F2D}\x{5F2E}' . +'\x{5F2F}\x{5F30}\x{5F31}\x{5F32}\x{5F33}\x{5F34}\x{5F35}\x{5F36}\x{5F37}' . +'\x{5F38}\x{5F39}\x{5F3A}\x{5F3C}\x{5F3E}\x{5F3F}\x{5F40}\x{5F41}\x{5F42}' . +'\x{5F43}\x{5F44}\x{5F45}\x{5F46}\x{5F47}\x{5F48}\x{5F49}\x{5F4A}\x{5F4B}' . +'\x{5F4C}\x{5F4D}\x{5F4E}\x{5F4F}\x{5F50}\x{5F51}\x{5F52}\x{5F53}\x{5F54}' . +'\x{5F55}\x{5F56}\x{5F57}\x{5F58}\x{5F59}\x{5F5A}\x{5F5B}\x{5F5C}\x{5F5D}' . +'\x{5F5E}\x{5F5F}\x{5F60}\x{5F61}\x{5F62}\x{5F63}\x{5F64}\x{5F65}\x{5F66}' . +'\x{5F67}\x{5F68}\x{5F69}\x{5F6A}\x{5F6B}\x{5F6C}\x{5F6D}\x{5F6E}\x{5F6F}' . +'\x{5F70}\x{5F71}\x{5F72}\x{5F73}\x{5F74}\x{5F75}\x{5F76}\x{5F77}\x{5F78}' . +'\x{5F79}\x{5F7A}\x{5F7B}\x{5F7C}\x{5F7D}\x{5F7E}\x{5F7F}\x{5F80}\x{5F81}' . +'\x{5F82}\x{5F83}\x{5F84}\x{5F85}\x{5F86}\x{5F87}\x{5F88}\x{5F89}\x{5F8A}' . +'\x{5F8B}\x{5F8C}\x{5F8D}\x{5F8E}\x{5F90}\x{5F91}\x{5F92}\x{5F93}\x{5F94}' . +'\x{5F95}\x{5F96}\x{5F97}\x{5F98}\x{5F99}\x{5F9B}\x{5F9C}\x{5F9D}\x{5F9E}' . +'\x{5F9F}\x{5FA0}\x{5FA1}\x{5FA2}\x{5FA5}\x{5FA6}\x{5FA7}\x{5FA8}\x{5FA9}' . +'\x{5FAA}\x{5FAB}\x{5FAC}\x{5FAD}\x{5FAE}\x{5FAF}\x{5FB1}\x{5FB2}\x{5FB3}' . +'\x{5FB4}\x{5FB5}\x{5FB6}\x{5FB7}\x{5FB8}\x{5FB9}\x{5FBA}\x{5FBB}\x{5FBC}' . +'\x{5FBD}\x{5FBE}\x{5FBF}\x{5FC0}\x{5FC1}\x{5FC3}\x{5FC4}\x{5FC5}\x{5FC6}' . +'\x{5FC7}\x{5FC8}\x{5FC9}\x{5FCA}\x{5FCB}\x{5FCC}\x{5FCD}\x{5FCF}\x{5FD0}' . +'\x{5FD1}\x{5FD2}\x{5FD3}\x{5FD4}\x{5FD5}\x{5FD6}\x{5FD7}\x{5FD8}\x{5FD9}' . +'\x{5FDA}\x{5FDC}\x{5FDD}\x{5FDE}\x{5FE0}\x{5FE1}\x{5FE3}\x{5FE4}\x{5FE5}' . +'\x{5FE6}\x{5FE7}\x{5FE8}\x{5FE9}\x{5FEA}\x{5FEB}\x{5FED}\x{5FEE}\x{5FEF}' . +'\x{5FF0}\x{5FF1}\x{5FF2}\x{5FF3}\x{5FF4}\x{5FF5}\x{5FF6}\x{5FF7}\x{5FF8}' . +'\x{5FF9}\x{5FFA}\x{5FFB}\x{5FFD}\x{5FFE}\x{5FFF}\x{6000}\x{6001}\x{6002}' . +'\x{6003}\x{6004}\x{6005}\x{6006}\x{6007}\x{6008}\x{6009}\x{600A}\x{600B}' . +'\x{600C}\x{600D}\x{600E}\x{600F}\x{6010}\x{6011}\x{6012}\x{6013}\x{6014}' . +'\x{6015}\x{6016}\x{6017}\x{6018}\x{6019}\x{601A}\x{601B}\x{601C}\x{601D}' . +'\x{601E}\x{601F}\x{6020}\x{6021}\x{6022}\x{6024}\x{6025}\x{6026}\x{6027}' . +'\x{6028}\x{6029}\x{602A}\x{602B}\x{602C}\x{602D}\x{602E}\x{602F}\x{6030}' . +'\x{6031}\x{6032}\x{6033}\x{6034}\x{6035}\x{6036}\x{6037}\x{6038}\x{6039}' . +'\x{603A}\x{603B}\x{603C}\x{603D}\x{603E}\x{603F}\x{6040}\x{6041}\x{6042}' . +'\x{6043}\x{6044}\x{6045}\x{6046}\x{6047}\x{6048}\x{6049}\x{604A}\x{604B}' . +'\x{604C}\x{604D}\x{604E}\x{604F}\x{6050}\x{6051}\x{6052}\x{6053}\x{6054}' . +'\x{6055}\x{6057}\x{6058}\x{6059}\x{605A}\x{605B}\x{605C}\x{605D}\x{605E}' . +'\x{605F}\x{6062}\x{6063}\x{6064}\x{6065}\x{6066}\x{6067}\x{6068}\x{6069}' . +'\x{606A}\x{606B}\x{606C}\x{606D}\x{606E}\x{606F}\x{6070}\x{6072}\x{6073}' . +'\x{6075}\x{6076}\x{6077}\x{6078}\x{6079}\x{607A}\x{607B}\x{607C}\x{607D}' . +'\x{607E}\x{607F}\x{6080}\x{6081}\x{6082}\x{6083}\x{6084}\x{6085}\x{6086}' . +'\x{6087}\x{6088}\x{6089}\x{608A}\x{608B}\x{608C}\x{608D}\x{608E}\x{608F}' . +'\x{6090}\x{6092}\x{6094}\x{6095}\x{6096}\x{6097}\x{6098}\x{6099}\x{609A}' . +'\x{609B}\x{609C}\x{609D}\x{609E}\x{609F}\x{60A0}\x{60A1}\x{60A2}\x{60A3}' . +'\x{60A4}\x{60A6}\x{60A7}\x{60A8}\x{60AA}\x{60AB}\x{60AC}\x{60AD}\x{60AE}' . +'\x{60AF}\x{60B0}\x{60B1}\x{60B2}\x{60B3}\x{60B4}\x{60B5}\x{60B6}\x{60B7}' . +'\x{60B8}\x{60B9}\x{60BA}\x{60BB}\x{60BC}\x{60BD}\x{60BE}\x{60BF}\x{60C0}' . +'\x{60C1}\x{60C2}\x{60C3}\x{60C4}\x{60C5}\x{60C6}\x{60C7}\x{60C8}\x{60C9}' . +'\x{60CA}\x{60CB}\x{60CC}\x{60CD}\x{60CE}\x{60CF}\x{60D0}\x{60D1}\x{60D3}' . +'\x{60D4}\x{60D5}\x{60D7}\x{60D8}\x{60D9}\x{60DA}\x{60DB}\x{60DC}\x{60DD}' . +'\x{60DF}\x{60E0}\x{60E1}\x{60E2}\x{60E4}\x{60E6}\x{60E7}\x{60E8}\x{60E9}' . +'\x{60EA}\x{60EB}\x{60EC}\x{60ED}\x{60EE}\x{60EF}\x{60F0}\x{60F1}\x{60F2}' . +'\x{60F3}\x{60F4}\x{60F5}\x{60F6}\x{60F7}\x{60F8}\x{60F9}\x{60FA}\x{60FB}' . +'\x{60FC}\x{60FE}\x{60FF}\x{6100}\x{6101}\x{6103}\x{6104}\x{6105}\x{6106}' . +'\x{6108}\x{6109}\x{610A}\x{610B}\x{610C}\x{610D}\x{610E}\x{610F}\x{6110}' . +'\x{6112}\x{6113}\x{6114}\x{6115}\x{6116}\x{6117}\x{6118}\x{6119}\x{611A}' . +'\x{611B}\x{611C}\x{611D}\x{611F}\x{6120}\x{6122}\x{6123}\x{6124}\x{6125}' . +'\x{6126}\x{6127}\x{6128}\x{6129}\x{612A}\x{612B}\x{612C}\x{612D}\x{612E}' . +'\x{612F}\x{6130}\x{6132}\x{6134}\x{6136}\x{6137}\x{613A}\x{613B}\x{613C}' . +'\x{613D}\x{613E}\x{613F}\x{6140}\x{6141}\x{6142}\x{6143}\x{6144}\x{6145}' . +'\x{6146}\x{6147}\x{6148}\x{6149}\x{614A}\x{614B}\x{614C}\x{614D}\x{614E}' . +'\x{614F}\x{6150}\x{6151}\x{6152}\x{6153}\x{6154}\x{6155}\x{6156}\x{6157}' . +'\x{6158}\x{6159}\x{615A}\x{615B}\x{615C}\x{615D}\x{615E}\x{615F}\x{6161}' . +'\x{6162}\x{6163}\x{6164}\x{6165}\x{6166}\x{6167}\x{6168}\x{6169}\x{616A}' . +'\x{616B}\x{616C}\x{616D}\x{616E}\x{6170}\x{6171}\x{6172}\x{6173}\x{6174}' . +'\x{6175}\x{6176}\x{6177}\x{6178}\x{6179}\x{617A}\x{617C}\x{617E}\x{6180}' . +'\x{6181}\x{6182}\x{6183}\x{6184}\x{6185}\x{6187}\x{6188}\x{6189}\x{618A}' . +'\x{618B}\x{618C}\x{618D}\x{618E}\x{618F}\x{6190}\x{6191}\x{6192}\x{6193}' . +'\x{6194}\x{6195}\x{6196}\x{6198}\x{6199}\x{619A}\x{619B}\x{619D}\x{619E}' . +'\x{619F}\x{61A0}\x{61A1}\x{61A2}\x{61A3}\x{61A4}\x{61A5}\x{61A6}\x{61A7}' . +'\x{61A8}\x{61A9}\x{61AA}\x{61AB}\x{61AC}\x{61AD}\x{61AE}\x{61AF}\x{61B0}' . +'\x{61B1}\x{61B2}\x{61B3}\x{61B4}\x{61B5}\x{61B6}\x{61B7}\x{61B8}\x{61BA}' . +'\x{61BC}\x{61BD}\x{61BE}\x{61BF}\x{61C0}\x{61C1}\x{61C2}\x{61C3}\x{61C4}' . +'\x{61C5}\x{61C6}\x{61C7}\x{61C8}\x{61C9}\x{61CA}\x{61CB}\x{61CC}\x{61CD}' . +'\x{61CE}\x{61CF}\x{61D0}\x{61D1}\x{61D2}\x{61D4}\x{61D6}\x{61D7}\x{61D8}' . +'\x{61D9}\x{61DA}\x{61DB}\x{61DC}\x{61DD}\x{61DE}\x{61DF}\x{61E0}\x{61E1}' . +'\x{61E2}\x{61E3}\x{61E4}\x{61E5}\x{61E6}\x{61E7}\x{61E8}\x{61E9}\x{61EA}' . +'\x{61EB}\x{61ED}\x{61EE}\x{61F0}\x{61F1}\x{61F2}\x{61F3}\x{61F5}\x{61F6}' . +'\x{61F7}\x{61F8}\x{61F9}\x{61FA}\x{61FB}\x{61FC}\x{61FD}\x{61FE}\x{61FF}' . +'\x{6200}\x{6201}\x{6202}\x{6203}\x{6204}\x{6206}\x{6207}\x{6208}\x{6209}' . +'\x{620A}\x{620B}\x{620C}\x{620D}\x{620E}\x{620F}\x{6210}\x{6211}\x{6212}' . +'\x{6213}\x{6214}\x{6215}\x{6216}\x{6217}\x{6218}\x{6219}\x{621A}\x{621B}' . +'\x{621C}\x{621D}\x{621E}\x{621F}\x{6220}\x{6221}\x{6222}\x{6223}\x{6224}' . +'\x{6225}\x{6226}\x{6227}\x{6228}\x{6229}\x{622A}\x{622B}\x{622C}\x{622D}' . +'\x{622E}\x{622F}\x{6230}\x{6231}\x{6232}\x{6233}\x{6234}\x{6236}\x{6237}' . +'\x{6238}\x{623A}\x{623B}\x{623C}\x{623D}\x{623E}\x{623F}\x{6240}\x{6241}' . +'\x{6242}\x{6243}\x{6244}\x{6245}\x{6246}\x{6247}\x{6248}\x{6249}\x{624A}' . +'\x{624B}\x{624C}\x{624D}\x{624E}\x{624F}\x{6250}\x{6251}\x{6252}\x{6253}' . +'\x{6254}\x{6255}\x{6256}\x{6258}\x{6259}\x{625A}\x{625B}\x{625C}\x{625D}' . +'\x{625E}\x{625F}\x{6260}\x{6261}\x{6262}\x{6263}\x{6264}\x{6265}\x{6266}' . +'\x{6267}\x{6268}\x{6269}\x{626A}\x{626B}\x{626C}\x{626D}\x{626E}\x{626F}' . +'\x{6270}\x{6271}\x{6272}\x{6273}\x{6274}\x{6275}\x{6276}\x{6277}\x{6278}' . +'\x{6279}\x{627A}\x{627B}\x{627C}\x{627D}\x{627E}\x{627F}\x{6280}\x{6281}' . +'\x{6283}\x{6284}\x{6285}\x{6286}\x{6287}\x{6288}\x{6289}\x{628A}\x{628B}' . +'\x{628C}\x{628E}\x{628F}\x{6290}\x{6291}\x{6292}\x{6293}\x{6294}\x{6295}' . +'\x{6296}\x{6297}\x{6298}\x{6299}\x{629A}\x{629B}\x{629C}\x{629E}\x{629F}' . +'\x{62A0}\x{62A1}\x{62A2}\x{62A3}\x{62A4}\x{62A5}\x{62A7}\x{62A8}\x{62A9}' . +'\x{62AA}\x{62AB}\x{62AC}\x{62AD}\x{62AE}\x{62AF}\x{62B0}\x{62B1}\x{62B2}' . +'\x{62B3}\x{62B4}\x{62B5}\x{62B6}\x{62B7}\x{62B8}\x{62B9}\x{62BA}\x{62BB}' . +'\x{62BC}\x{62BD}\x{62BE}\x{62BF}\x{62C0}\x{62C1}\x{62C2}\x{62C3}\x{62C4}' . +'\x{62C5}\x{62C6}\x{62C7}\x{62C8}\x{62C9}\x{62CA}\x{62CB}\x{62CC}\x{62CD}' . +'\x{62CE}\x{62CF}\x{62D0}\x{62D1}\x{62D2}\x{62D3}\x{62D4}\x{62D5}\x{62D6}' . +'\x{62D7}\x{62D8}\x{62D9}\x{62DA}\x{62DB}\x{62DC}\x{62DD}\x{62DF}\x{62E0}' . +'\x{62E1}\x{62E2}\x{62E3}\x{62E4}\x{62E5}\x{62E6}\x{62E7}\x{62E8}\x{62E9}' . +'\x{62EB}\x{62EC}\x{62ED}\x{62EE}\x{62EF}\x{62F0}\x{62F1}\x{62F2}\x{62F3}' . +'\x{62F4}\x{62F5}\x{62F6}\x{62F7}\x{62F8}\x{62F9}\x{62FA}\x{62FB}\x{62FC}' . +'\x{62FD}\x{62FE}\x{62FF}\x{6300}\x{6301}\x{6302}\x{6303}\x{6304}\x{6305}' . +'\x{6306}\x{6307}\x{6308}\x{6309}\x{630B}\x{630C}\x{630D}\x{630E}\x{630F}' . +'\x{6310}\x{6311}\x{6312}\x{6313}\x{6314}\x{6315}\x{6316}\x{6318}\x{6319}' . +'\x{631A}\x{631B}\x{631C}\x{631D}\x{631E}\x{631F}\x{6320}\x{6321}\x{6322}' . +'\x{6323}\x{6324}\x{6325}\x{6326}\x{6327}\x{6328}\x{6329}\x{632A}\x{632B}' . +'\x{632C}\x{632D}\x{632E}\x{632F}\x{6330}\x{6332}\x{6333}\x{6334}\x{6336}' . +'\x{6338}\x{6339}\x{633A}\x{633B}\x{633C}\x{633D}\x{633E}\x{6340}\x{6341}' . +'\x{6342}\x{6343}\x{6344}\x{6345}\x{6346}\x{6347}\x{6348}\x{6349}\x{634A}' . +'\x{634B}\x{634C}\x{634D}\x{634E}\x{634F}\x{6350}\x{6351}\x{6352}\x{6353}' . +'\x{6354}\x{6355}\x{6356}\x{6357}\x{6358}\x{6359}\x{635A}\x{635C}\x{635D}' . +'\x{635E}\x{635F}\x{6360}\x{6361}\x{6362}\x{6363}\x{6364}\x{6365}\x{6366}' . +'\x{6367}\x{6368}\x{6369}\x{636A}\x{636B}\x{636C}\x{636D}\x{636E}\x{636F}' . +'\x{6370}\x{6371}\x{6372}\x{6373}\x{6374}\x{6375}\x{6376}\x{6377}\x{6378}' . +'\x{6379}\x{637A}\x{637B}\x{637C}\x{637D}\x{637E}\x{6380}\x{6381}\x{6382}' . +'\x{6383}\x{6384}\x{6385}\x{6386}\x{6387}\x{6388}\x{6389}\x{638A}\x{638C}' . +'\x{638D}\x{638E}\x{638F}\x{6390}\x{6391}\x{6392}\x{6394}\x{6395}\x{6396}' . +'\x{6397}\x{6398}\x{6399}\x{639A}\x{639B}\x{639C}\x{639D}\x{639E}\x{639F}' . +'\x{63A0}\x{63A1}\x{63A2}\x{63A3}\x{63A4}\x{63A5}\x{63A6}\x{63A7}\x{63A8}' . +'\x{63A9}\x{63AA}\x{63AB}\x{63AC}\x{63AD}\x{63AE}\x{63AF}\x{63B0}\x{63B1}' . +'\x{63B2}\x{63B3}\x{63B4}\x{63B5}\x{63B6}\x{63B7}\x{63B8}\x{63B9}\x{63BA}' . +'\x{63BC}\x{63BD}\x{63BE}\x{63BF}\x{63C0}\x{63C1}\x{63C2}\x{63C3}\x{63C4}' . +'\x{63C5}\x{63C6}\x{63C7}\x{63C8}\x{63C9}\x{63CA}\x{63CB}\x{63CC}\x{63CD}' . +'\x{63CE}\x{63CF}\x{63D0}\x{63D2}\x{63D3}\x{63D4}\x{63D5}\x{63D6}\x{63D7}' . +'\x{63D8}\x{63D9}\x{63DA}\x{63DB}\x{63DC}\x{63DD}\x{63DE}\x{63DF}\x{63E0}' . +'\x{63E1}\x{63E2}\x{63E3}\x{63E4}\x{63E5}\x{63E6}\x{63E7}\x{63E8}\x{63E9}' . +'\x{63EA}\x{63EB}\x{63EC}\x{63ED}\x{63EE}\x{63EF}\x{63F0}\x{63F1}\x{63F2}' . +'\x{63F3}\x{63F4}\x{63F5}\x{63F6}\x{63F7}\x{63F8}\x{63F9}\x{63FA}\x{63FB}' . +'\x{63FC}\x{63FD}\x{63FE}\x{63FF}\x{6400}\x{6401}\x{6402}\x{6403}\x{6404}' . +'\x{6405}\x{6406}\x{6408}\x{6409}\x{640A}\x{640B}\x{640C}\x{640D}\x{640E}' . +'\x{640F}\x{6410}\x{6411}\x{6412}\x{6413}\x{6414}\x{6415}\x{6416}\x{6417}' . +'\x{6418}\x{6419}\x{641A}\x{641B}\x{641C}\x{641D}\x{641E}\x{641F}\x{6420}' . +'\x{6421}\x{6422}\x{6423}\x{6424}\x{6425}\x{6426}\x{6427}\x{6428}\x{6429}' . +'\x{642A}\x{642B}\x{642C}\x{642D}\x{642E}\x{642F}\x{6430}\x{6431}\x{6432}' . +'\x{6433}\x{6434}\x{6435}\x{6436}\x{6437}\x{6438}\x{6439}\x{643A}\x{643D}' . +'\x{643E}\x{643F}\x{6440}\x{6441}\x{6443}\x{6444}\x{6445}\x{6446}\x{6447}' . +'\x{6448}\x{644A}\x{644B}\x{644C}\x{644D}\x{644E}\x{644F}\x{6450}\x{6451}' . +'\x{6452}\x{6453}\x{6454}\x{6455}\x{6456}\x{6457}\x{6458}\x{6459}\x{645B}' . +'\x{645C}\x{645D}\x{645E}\x{645F}\x{6460}\x{6461}\x{6462}\x{6463}\x{6464}' . +'\x{6465}\x{6466}\x{6467}\x{6468}\x{6469}\x{646A}\x{646B}\x{646C}\x{646D}' . +'\x{646E}\x{646F}\x{6470}\x{6471}\x{6472}\x{6473}\x{6474}\x{6475}\x{6476}' . +'\x{6477}\x{6478}\x{6479}\x{647A}\x{647B}\x{647C}\x{647D}\x{647F}\x{6480}' . +'\x{6481}\x{6482}\x{6483}\x{6484}\x{6485}\x{6487}\x{6488}\x{6489}\x{648A}' . +'\x{648B}\x{648C}\x{648D}\x{648E}\x{648F}\x{6490}\x{6491}\x{6492}\x{6493}' . +'\x{6494}\x{6495}\x{6496}\x{6497}\x{6498}\x{6499}\x{649A}\x{649B}\x{649C}' . +'\x{649D}\x{649E}\x{649F}\x{64A0}\x{64A2}\x{64A3}\x{64A4}\x{64A5}\x{64A6}' . +'\x{64A7}\x{64A8}\x{64A9}\x{64AA}\x{64AB}\x{64AC}\x{64AD}\x{64AE}\x{64B0}' . +'\x{64B1}\x{64B2}\x{64B3}\x{64B4}\x{64B5}\x{64B7}\x{64B8}\x{64B9}\x{64BA}' . +'\x{64BB}\x{64BC}\x{64BD}\x{64BE}\x{64BF}\x{64C0}\x{64C1}\x{64C2}\x{64C3}' . +'\x{64C4}\x{64C5}\x{64C6}\x{64C7}\x{64C9}\x{64CA}\x{64CB}\x{64CC}\x{64CD}' . +'\x{64CE}\x{64CF}\x{64D0}\x{64D1}\x{64D2}\x{64D3}\x{64D4}\x{64D6}\x{64D7}' . +'\x{64D8}\x{64D9}\x{64DA}\x{64DB}\x{64DC}\x{64DD}\x{64DE}\x{64DF}\x{64E0}' . +'\x{64E2}\x{64E3}\x{64E4}\x{64E6}\x{64E7}\x{64E8}\x{64E9}\x{64EA}\x{64EB}' . +'\x{64EC}\x{64ED}\x{64EF}\x{64F0}\x{64F1}\x{64F2}\x{64F3}\x{64F4}\x{64F6}' . +'\x{64F7}\x{64F8}\x{64FA}\x{64FB}\x{64FC}\x{64FD}\x{64FE}\x{64FF}\x{6500}' . +'\x{6501}\x{6503}\x{6504}\x{6505}\x{6506}\x{6507}\x{6508}\x{6509}\x{650B}' . +'\x{650C}\x{650D}\x{650E}\x{650F}\x{6510}\x{6511}\x{6512}\x{6513}\x{6514}' . +'\x{6515}\x{6516}\x{6517}\x{6518}\x{6519}\x{651A}\x{651B}\x{651C}\x{651D}' . +'\x{651E}\x{6520}\x{6521}\x{6522}\x{6523}\x{6524}\x{6525}\x{6526}\x{6527}' . +'\x{6529}\x{652A}\x{652B}\x{652C}\x{652D}\x{652E}\x{652F}\x{6530}\x{6531}' . +'\x{6532}\x{6533}\x{6534}\x{6535}\x{6536}\x{6537}\x{6538}\x{6539}\x{653A}' . +'\x{653B}\x{653C}\x{653D}\x{653E}\x{653F}\x{6541}\x{6543}\x{6544}\x{6545}' . +'\x{6546}\x{6547}\x{6548}\x{6549}\x{654A}\x{654B}\x{654C}\x{654D}\x{654E}' . +'\x{654F}\x{6550}\x{6551}\x{6552}\x{6553}\x{6554}\x{6555}\x{6556}\x{6557}' . +'\x{6558}\x{6559}\x{655B}\x{655C}\x{655D}\x{655E}\x{6560}\x{6561}\x{6562}' . +'\x{6563}\x{6564}\x{6565}\x{6566}\x{6567}\x{6568}\x{6569}\x{656A}\x{656B}' . +'\x{656C}\x{656E}\x{656F}\x{6570}\x{6571}\x{6572}\x{6573}\x{6574}\x{6575}' . +'\x{6576}\x{6577}\x{6578}\x{6579}\x{657A}\x{657B}\x{657C}\x{657E}\x{657F}' . +'\x{6580}\x{6581}\x{6582}\x{6583}\x{6584}\x{6585}\x{6586}\x{6587}\x{6588}' . +'\x{6589}\x{658B}\x{658C}\x{658D}\x{658E}\x{658F}\x{6590}\x{6591}\x{6592}' . +'\x{6593}\x{6594}\x{6595}\x{6596}\x{6597}\x{6598}\x{6599}\x{659B}\x{659C}' . +'\x{659D}\x{659E}\x{659F}\x{65A0}\x{65A1}\x{65A2}\x{65A3}\x{65A4}\x{65A5}' . +'\x{65A6}\x{65A7}\x{65A8}\x{65A9}\x{65AA}\x{65AB}\x{65AC}\x{65AD}\x{65AE}' . +'\x{65AF}\x{65B0}\x{65B1}\x{65B2}\x{65B3}\x{65B4}\x{65B6}\x{65B7}\x{65B8}' . +'\x{65B9}\x{65BA}\x{65BB}\x{65BC}\x{65BD}\x{65BF}\x{65C0}\x{65C1}\x{65C2}' . +'\x{65C3}\x{65C4}\x{65C5}\x{65C6}\x{65C7}\x{65CA}\x{65CB}\x{65CC}\x{65CD}' . +'\x{65CE}\x{65CF}\x{65D0}\x{65D2}\x{65D3}\x{65D4}\x{65D5}\x{65D6}\x{65D7}' . +'\x{65DA}\x{65DB}\x{65DD}\x{65DE}\x{65DF}\x{65E0}\x{65E1}\x{65E2}\x{65E3}' . +'\x{65E5}\x{65E6}\x{65E7}\x{65E8}\x{65E9}\x{65EB}\x{65EC}\x{65ED}\x{65EE}' . +'\x{65EF}\x{65F0}\x{65F1}\x{65F2}\x{65F3}\x{65F4}\x{65F5}\x{65F6}\x{65F7}' . +'\x{65F8}\x{65FA}\x{65FB}\x{65FC}\x{65FD}\x{6600}\x{6601}\x{6602}\x{6603}' . +'\x{6604}\x{6605}\x{6606}\x{6607}\x{6608}\x{6609}\x{660A}\x{660B}\x{660C}' . +'\x{660D}\x{660E}\x{660F}\x{6610}\x{6611}\x{6612}\x{6613}\x{6614}\x{6615}' . +'\x{6616}\x{6618}\x{6619}\x{661A}\x{661B}\x{661C}\x{661D}\x{661F}\x{6620}' . +'\x{6621}\x{6622}\x{6623}\x{6624}\x{6625}\x{6626}\x{6627}\x{6628}\x{6629}' . +'\x{662A}\x{662B}\x{662D}\x{662E}\x{662F}\x{6630}\x{6631}\x{6632}\x{6633}' . +'\x{6634}\x{6635}\x{6636}\x{6639}\x{663A}\x{663C}\x{663D}\x{663E}\x{6640}' . +'\x{6641}\x{6642}\x{6643}\x{6644}\x{6645}\x{6646}\x{6647}\x{6649}\x{664A}' . +'\x{664B}\x{664C}\x{664E}\x{664F}\x{6650}\x{6651}\x{6652}\x{6653}\x{6654}' . +'\x{6655}\x{6656}\x{6657}\x{6658}\x{6659}\x{665A}\x{665B}\x{665C}\x{665D}' . +'\x{665E}\x{665F}\x{6661}\x{6662}\x{6664}\x{6665}\x{6666}\x{6668}\x{6669}' . +'\x{666A}\x{666B}\x{666C}\x{666D}\x{666E}\x{666F}\x{6670}\x{6671}\x{6672}' . +'\x{6673}\x{6674}\x{6675}\x{6676}\x{6677}\x{6678}\x{6679}\x{667A}\x{667B}' . +'\x{667C}\x{667D}\x{667E}\x{667F}\x{6680}\x{6681}\x{6682}\x{6683}\x{6684}' . +'\x{6685}\x{6686}\x{6687}\x{6688}\x{6689}\x{668A}\x{668B}\x{668C}\x{668D}' . +'\x{668E}\x{668F}\x{6690}\x{6691}\x{6693}\x{6694}\x{6695}\x{6696}\x{6697}' . +'\x{6698}\x{6699}\x{669A}\x{669B}\x{669D}\x{669F}\x{66A0}\x{66A1}\x{66A2}' . +'\x{66A3}\x{66A4}\x{66A5}\x{66A6}\x{66A7}\x{66A8}\x{66A9}\x{66AA}\x{66AB}' . +'\x{66AE}\x{66AF}\x{66B0}\x{66B1}\x{66B2}\x{66B3}\x{66B4}\x{66B5}\x{66B6}' . +'\x{66B7}\x{66B8}\x{66B9}\x{66BA}\x{66BB}\x{66BC}\x{66BD}\x{66BE}\x{66BF}' . +'\x{66C0}\x{66C1}\x{66C2}\x{66C3}\x{66C4}\x{66C5}\x{66C6}\x{66C7}\x{66C8}' . +'\x{66C9}\x{66CA}\x{66CB}\x{66CC}\x{66CD}\x{66CE}\x{66CF}\x{66D1}\x{66D2}' . +'\x{66D4}\x{66D5}\x{66D6}\x{66D8}\x{66D9}\x{66DA}\x{66DB}\x{66DC}\x{66DD}' . +'\x{66DE}\x{66E0}\x{66E1}\x{66E2}\x{66E3}\x{66E4}\x{66E5}\x{66E6}\x{66E7}' . +'\x{66E8}\x{66E9}\x{66EA}\x{66EB}\x{66EC}\x{66ED}\x{66EE}\x{66F0}\x{66F1}' . +'\x{66F2}\x{66F3}\x{66F4}\x{66F5}\x{66F6}\x{66F7}\x{66F8}\x{66F9}\x{66FA}' . +'\x{66FB}\x{66FC}\x{66FE}\x{66FF}\x{6700}\x{6701}\x{6703}\x{6704}\x{6705}' . +'\x{6706}\x{6708}\x{6709}\x{670A}\x{670B}\x{670C}\x{670D}\x{670E}\x{670F}' . +'\x{6710}\x{6711}\x{6712}\x{6713}\x{6714}\x{6715}\x{6716}\x{6717}\x{6718}' . +'\x{671A}\x{671B}\x{671C}\x{671D}\x{671E}\x{671F}\x{6720}\x{6721}\x{6722}' . +'\x{6723}\x{6725}\x{6726}\x{6727}\x{6728}\x{672A}\x{672B}\x{672C}\x{672D}' . +'\x{672E}\x{672F}\x{6730}\x{6731}\x{6732}\x{6733}\x{6734}\x{6735}\x{6736}' . +'\x{6737}\x{6738}\x{6739}\x{673A}\x{673B}\x{673C}\x{673D}\x{673E}\x{673F}' . +'\x{6740}\x{6741}\x{6742}\x{6743}\x{6744}\x{6745}\x{6746}\x{6747}\x{6748}' . +'\x{6749}\x{674A}\x{674B}\x{674C}\x{674D}\x{674E}\x{674F}\x{6750}\x{6751}' . +'\x{6752}\x{6753}\x{6754}\x{6755}\x{6756}\x{6757}\x{6758}\x{6759}\x{675A}' . +'\x{675B}\x{675C}\x{675D}\x{675E}\x{675F}\x{6760}\x{6761}\x{6762}\x{6763}' . +'\x{6764}\x{6765}\x{6766}\x{6768}\x{6769}\x{676A}\x{676B}\x{676C}\x{676D}' . +'\x{676E}\x{676F}\x{6770}\x{6771}\x{6772}\x{6773}\x{6774}\x{6775}\x{6776}' . +'\x{6777}\x{6778}\x{6779}\x{677A}\x{677B}\x{677C}\x{677D}\x{677E}\x{677F}' . +'\x{6780}\x{6781}\x{6782}\x{6783}\x{6784}\x{6785}\x{6786}\x{6787}\x{6789}' . +'\x{678A}\x{678B}\x{678C}\x{678D}\x{678E}\x{678F}\x{6790}\x{6791}\x{6792}' . +'\x{6793}\x{6794}\x{6795}\x{6797}\x{6798}\x{6799}\x{679A}\x{679B}\x{679C}' . +'\x{679D}\x{679E}\x{679F}\x{67A0}\x{67A1}\x{67A2}\x{67A3}\x{67A4}\x{67A5}' . +'\x{67A6}\x{67A7}\x{67A8}\x{67AA}\x{67AB}\x{67AC}\x{67AD}\x{67AE}\x{67AF}' . +'\x{67B0}\x{67B1}\x{67B2}\x{67B3}\x{67B4}\x{67B5}\x{67B6}\x{67B7}\x{67B8}' . +'\x{67B9}\x{67BA}\x{67BB}\x{67BC}\x{67BE}\x{67C0}\x{67C1}\x{67C2}\x{67C3}' . +'\x{67C4}\x{67C5}\x{67C6}\x{67C7}\x{67C8}\x{67C9}\x{67CA}\x{67CB}\x{67CC}' . +'\x{67CD}\x{67CE}\x{67CF}\x{67D0}\x{67D1}\x{67D2}\x{67D3}\x{67D4}\x{67D6}' . +'\x{67D8}\x{67D9}\x{67DA}\x{67DB}\x{67DC}\x{67DD}\x{67DE}\x{67DF}\x{67E0}' . +'\x{67E1}\x{67E2}\x{67E3}\x{67E4}\x{67E5}\x{67E6}\x{67E7}\x{67E8}\x{67E9}' . +'\x{67EA}\x{67EB}\x{67EC}\x{67ED}\x{67EE}\x{67EF}\x{67F0}\x{67F1}\x{67F2}' . +'\x{67F3}\x{67F4}\x{67F5}\x{67F6}\x{67F7}\x{67F8}\x{67FA}\x{67FB}\x{67FC}' . +'\x{67FD}\x{67FE}\x{67FF}\x{6800}\x{6802}\x{6803}\x{6804}\x{6805}\x{6806}' . +'\x{6807}\x{6808}\x{6809}\x{680A}\x{680B}\x{680C}\x{680D}\x{680E}\x{680F}' . +'\x{6810}\x{6811}\x{6812}\x{6813}\x{6814}\x{6816}\x{6817}\x{6818}\x{6819}' . +'\x{681A}\x{681B}\x{681C}\x{681D}\x{681F}\x{6820}\x{6821}\x{6822}\x{6823}' . +'\x{6824}\x{6825}\x{6826}\x{6828}\x{6829}\x{682A}\x{682B}\x{682C}\x{682D}' . +'\x{682E}\x{682F}\x{6831}\x{6832}\x{6833}\x{6834}\x{6835}\x{6836}\x{6837}' . +'\x{6838}\x{6839}\x{683A}\x{683B}\x{683C}\x{683D}\x{683E}\x{683F}\x{6840}' . +'\x{6841}\x{6842}\x{6843}\x{6844}\x{6845}\x{6846}\x{6847}\x{6848}\x{6849}' . +'\x{684A}\x{684B}\x{684C}\x{684D}\x{684E}\x{684F}\x{6850}\x{6851}\x{6852}' . +'\x{6853}\x{6854}\x{6855}\x{6856}\x{6857}\x{685B}\x{685D}\x{6860}\x{6861}' . +'\x{6862}\x{6863}\x{6864}\x{6865}\x{6866}\x{6867}\x{6868}\x{6869}\x{686A}' . +'\x{686B}\x{686C}\x{686D}\x{686E}\x{686F}\x{6870}\x{6871}\x{6872}\x{6873}' . +'\x{6874}\x{6875}\x{6876}\x{6877}\x{6878}\x{6879}\x{687B}\x{687C}\x{687D}' . +'\x{687E}\x{687F}\x{6880}\x{6881}\x{6882}\x{6883}\x{6884}\x{6885}\x{6886}' . +'\x{6887}\x{6888}\x{6889}\x{688A}\x{688B}\x{688C}\x{688D}\x{688E}\x{688F}' . +'\x{6890}\x{6891}\x{6892}\x{6893}\x{6894}\x{6896}\x{6897}\x{6898}\x{689A}' . +'\x{689B}\x{689C}\x{689D}\x{689E}\x{689F}\x{68A0}\x{68A1}\x{68A2}\x{68A3}' . +'\x{68A4}\x{68A6}\x{68A7}\x{68A8}\x{68A9}\x{68AA}\x{68AB}\x{68AC}\x{68AD}' . +'\x{68AE}\x{68AF}\x{68B0}\x{68B1}\x{68B2}\x{68B3}\x{68B4}\x{68B5}\x{68B6}' . +'\x{68B7}\x{68B9}\x{68BB}\x{68BC}\x{68BD}\x{68BE}\x{68BF}\x{68C0}\x{68C1}' . +'\x{68C2}\x{68C4}\x{68C6}\x{68C7}\x{68C8}\x{68C9}\x{68CA}\x{68CB}\x{68CC}' . +'\x{68CD}\x{68CE}\x{68CF}\x{68D0}\x{68D1}\x{68D2}\x{68D3}\x{68D4}\x{68D5}' . +'\x{68D6}\x{68D7}\x{68D8}\x{68DA}\x{68DB}\x{68DC}\x{68DD}\x{68DE}\x{68DF}' . +'\x{68E0}\x{68E1}\x{68E3}\x{68E4}\x{68E6}\x{68E7}\x{68E8}\x{68E9}\x{68EA}' . +'\x{68EB}\x{68EC}\x{68ED}\x{68EE}\x{68EF}\x{68F0}\x{68F1}\x{68F2}\x{68F3}' . +'\x{68F4}\x{68F5}\x{68F6}\x{68F7}\x{68F8}\x{68F9}\x{68FA}\x{68FB}\x{68FC}' . +'\x{68FD}\x{68FE}\x{68FF}\x{6901}\x{6902}\x{6903}\x{6904}\x{6905}\x{6906}' . +'\x{6907}\x{6908}\x{690A}\x{690B}\x{690C}\x{690D}\x{690E}\x{690F}\x{6910}' . +'\x{6911}\x{6912}\x{6913}\x{6914}\x{6915}\x{6916}\x{6917}\x{6918}\x{6919}' . +'\x{691A}\x{691B}\x{691C}\x{691D}\x{691E}\x{691F}\x{6920}\x{6921}\x{6922}' . +'\x{6923}\x{6924}\x{6925}\x{6926}\x{6927}\x{6928}\x{6929}\x{692A}\x{692B}' . +'\x{692C}\x{692D}\x{692E}\x{692F}\x{6930}\x{6931}\x{6932}\x{6933}\x{6934}' . +'\x{6935}\x{6936}\x{6937}\x{6938}\x{6939}\x{693A}\x{693B}\x{693C}\x{693D}' . +'\x{693F}\x{6940}\x{6941}\x{6942}\x{6943}\x{6944}\x{6945}\x{6946}\x{6947}' . +'\x{6948}\x{6949}\x{694A}\x{694B}\x{694C}\x{694E}\x{694F}\x{6950}\x{6951}' . +'\x{6952}\x{6953}\x{6954}\x{6955}\x{6956}\x{6957}\x{6958}\x{6959}\x{695A}' . +'\x{695B}\x{695C}\x{695D}\x{695E}\x{695F}\x{6960}\x{6961}\x{6962}\x{6963}' . +'\x{6964}\x{6965}\x{6966}\x{6967}\x{6968}\x{6969}\x{696A}\x{696B}\x{696C}' . +'\x{696D}\x{696E}\x{696F}\x{6970}\x{6971}\x{6972}\x{6973}\x{6974}\x{6975}' . +'\x{6976}\x{6977}\x{6978}\x{6979}\x{697A}\x{697B}\x{697C}\x{697D}\x{697E}' . +'\x{697F}\x{6980}\x{6981}\x{6982}\x{6983}\x{6984}\x{6985}\x{6986}\x{6987}' . +'\x{6988}\x{6989}\x{698A}\x{698B}\x{698C}\x{698D}\x{698E}\x{698F}\x{6990}' . +'\x{6991}\x{6992}\x{6993}\x{6994}\x{6995}\x{6996}\x{6997}\x{6998}\x{6999}' . +'\x{699A}\x{699B}\x{699C}\x{699D}\x{699E}\x{69A0}\x{69A1}\x{69A3}\x{69A4}' . +'\x{69A5}\x{69A6}\x{69A7}\x{69A8}\x{69A9}\x{69AA}\x{69AB}\x{69AC}\x{69AD}' . +'\x{69AE}\x{69AF}\x{69B0}\x{69B1}\x{69B2}\x{69B3}\x{69B4}\x{69B5}\x{69B6}' . +'\x{69B7}\x{69B8}\x{69B9}\x{69BA}\x{69BB}\x{69BC}\x{69BD}\x{69BE}\x{69BF}' . +'\x{69C1}\x{69C2}\x{69C3}\x{69C4}\x{69C5}\x{69C6}\x{69C7}\x{69C8}\x{69C9}' . +'\x{69CA}\x{69CB}\x{69CC}\x{69CD}\x{69CE}\x{69CF}\x{69D0}\x{69D3}\x{69D4}' . +'\x{69D8}\x{69D9}\x{69DA}\x{69DB}\x{69DC}\x{69DD}\x{69DE}\x{69DF}\x{69E0}' . +'\x{69E1}\x{69E2}\x{69E3}\x{69E4}\x{69E5}\x{69E6}\x{69E7}\x{69E8}\x{69E9}' . +'\x{69EA}\x{69EB}\x{69EC}\x{69ED}\x{69EE}\x{69EF}\x{69F0}\x{69F1}\x{69F2}' . +'\x{69F3}\x{69F4}\x{69F5}\x{69F6}\x{69F7}\x{69F8}\x{69FA}\x{69FB}\x{69FC}' . +'\x{69FD}\x{69FE}\x{69FF}\x{6A00}\x{6A01}\x{6A02}\x{6A04}\x{6A05}\x{6A06}' . +'\x{6A07}\x{6A08}\x{6A09}\x{6A0A}\x{6A0B}\x{6A0D}\x{6A0E}\x{6A0F}\x{6A10}' . +'\x{6A11}\x{6A12}\x{6A13}\x{6A14}\x{6A15}\x{6A16}\x{6A17}\x{6A18}\x{6A19}' . +'\x{6A1A}\x{6A1B}\x{6A1D}\x{6A1E}\x{6A1F}\x{6A20}\x{6A21}\x{6A22}\x{6A23}' . +'\x{6A25}\x{6A26}\x{6A27}\x{6A28}\x{6A29}\x{6A2A}\x{6A2B}\x{6A2C}\x{6A2D}' . +'\x{6A2E}\x{6A2F}\x{6A30}\x{6A31}\x{6A32}\x{6A33}\x{6A34}\x{6A35}\x{6A36}' . +'\x{6A38}\x{6A39}\x{6A3A}\x{6A3B}\x{6A3C}\x{6A3D}\x{6A3E}\x{6A3F}\x{6A40}' . +'\x{6A41}\x{6A42}\x{6A43}\x{6A44}\x{6A45}\x{6A46}\x{6A47}\x{6A48}\x{6A49}' . +'\x{6A4B}\x{6A4C}\x{6A4D}\x{6A4E}\x{6A4F}\x{6A50}\x{6A51}\x{6A52}\x{6A54}' . +'\x{6A55}\x{6A56}\x{6A57}\x{6A58}\x{6A59}\x{6A5A}\x{6A5B}\x{6A5D}\x{6A5E}' . +'\x{6A5F}\x{6A60}\x{6A61}\x{6A62}\x{6A63}\x{6A64}\x{6A65}\x{6A66}\x{6A67}' . +'\x{6A68}\x{6A69}\x{6A6A}\x{6A6B}\x{6A6C}\x{6A6D}\x{6A6F}\x{6A71}\x{6A72}' . +'\x{6A73}\x{6A74}\x{6A75}\x{6A76}\x{6A77}\x{6A78}\x{6A79}\x{6A7A}\x{6A7B}' . +'\x{6A7C}\x{6A7D}\x{6A7E}\x{6A7F}\x{6A80}\x{6A81}\x{6A82}\x{6A83}\x{6A84}' . +'\x{6A85}\x{6A87}\x{6A88}\x{6A89}\x{6A8B}\x{6A8C}\x{6A8D}\x{6A8E}\x{6A90}' . +'\x{6A91}\x{6A92}\x{6A93}\x{6A94}\x{6A95}\x{6A96}\x{6A97}\x{6A98}\x{6A9A}' . +'\x{6A9B}\x{6A9C}\x{6A9E}\x{6A9F}\x{6AA0}\x{6AA1}\x{6AA2}\x{6AA3}\x{6AA4}' . +'\x{6AA5}\x{6AA6}\x{6AA7}\x{6AA8}\x{6AA9}\x{6AAB}\x{6AAC}\x{6AAD}\x{6AAE}' . +'\x{6AAF}\x{6AB0}\x{6AB2}\x{6AB3}\x{6AB4}\x{6AB5}\x{6AB6}\x{6AB7}\x{6AB8}' . +'\x{6AB9}\x{6ABA}\x{6ABB}\x{6ABC}\x{6ABD}\x{6ABF}\x{6AC1}\x{6AC2}\x{6AC3}' . +'\x{6AC5}\x{6AC6}\x{6AC7}\x{6ACA}\x{6ACB}\x{6ACC}\x{6ACD}\x{6ACE}\x{6ACF}' . +'\x{6AD0}\x{6AD1}\x{6AD2}\x{6AD3}\x{6AD4}\x{6AD5}\x{6AD6}\x{6AD7}\x{6AD9}' . +'\x{6ADA}\x{6ADB}\x{6ADC}\x{6ADD}\x{6ADE}\x{6ADF}\x{6AE0}\x{6AE1}\x{6AE2}' . +'\x{6AE3}\x{6AE4}\x{6AE5}\x{6AE6}\x{6AE7}\x{6AE8}\x{6AEA}\x{6AEB}\x{6AEC}' . +'\x{6AED}\x{6AEE}\x{6AEF}\x{6AF0}\x{6AF1}\x{6AF2}\x{6AF3}\x{6AF4}\x{6AF5}' . +'\x{6AF6}\x{6AF7}\x{6AF8}\x{6AF9}\x{6AFA}\x{6AFB}\x{6AFC}\x{6AFD}\x{6AFE}' . +'\x{6AFF}\x{6B00}\x{6B01}\x{6B02}\x{6B03}\x{6B04}\x{6B05}\x{6B06}\x{6B07}' . +'\x{6B08}\x{6B09}\x{6B0A}\x{6B0B}\x{6B0C}\x{6B0D}\x{6B0F}\x{6B10}\x{6B11}' . +'\x{6B12}\x{6B13}\x{6B14}\x{6B15}\x{6B16}\x{6B17}\x{6B18}\x{6B19}\x{6B1A}' . +'\x{6B1C}\x{6B1D}\x{6B1E}\x{6B1F}\x{6B20}\x{6B21}\x{6B22}\x{6B23}\x{6B24}' . +'\x{6B25}\x{6B26}\x{6B27}\x{6B28}\x{6B29}\x{6B2A}\x{6B2B}\x{6B2C}\x{6B2D}' . +'\x{6B2F}\x{6B30}\x{6B31}\x{6B32}\x{6B33}\x{6B34}\x{6B36}\x{6B37}\x{6B38}' . +'\x{6B39}\x{6B3A}\x{6B3B}\x{6B3C}\x{6B3D}\x{6B3E}\x{6B3F}\x{6B41}\x{6B42}' . +'\x{6B43}\x{6B44}\x{6B45}\x{6B46}\x{6B47}\x{6B48}\x{6B49}\x{6B4A}\x{6B4B}' . +'\x{6B4C}\x{6B4D}\x{6B4E}\x{6B4F}\x{6B50}\x{6B51}\x{6B52}\x{6B53}\x{6B54}' . +'\x{6B55}\x{6B56}\x{6B59}\x{6B5A}\x{6B5B}\x{6B5C}\x{6B5E}\x{6B5F}\x{6B60}' . +'\x{6B61}\x{6B62}\x{6B63}\x{6B64}\x{6B65}\x{6B66}\x{6B67}\x{6B69}\x{6B6A}' . +'\x{6B6B}\x{6B6D}\x{6B6F}\x{6B70}\x{6B72}\x{6B73}\x{6B74}\x{6B76}\x{6B77}' . +'\x{6B78}\x{6B79}\x{6B7A}\x{6B7B}\x{6B7C}\x{6B7E}\x{6B7F}\x{6B80}\x{6B81}' . +'\x{6B82}\x{6B83}\x{6B84}\x{6B85}\x{6B86}\x{6B87}\x{6B88}\x{6B89}\x{6B8A}' . +'\x{6B8B}\x{6B8C}\x{6B8D}\x{6B8E}\x{6B8F}\x{6B90}\x{6B91}\x{6B92}\x{6B93}' . +'\x{6B94}\x{6B95}\x{6B96}\x{6B97}\x{6B98}\x{6B99}\x{6B9A}\x{6B9B}\x{6B9C}' . +'\x{6B9D}\x{6B9E}\x{6B9F}\x{6BA0}\x{6BA1}\x{6BA2}\x{6BA3}\x{6BA4}\x{6BA5}' . +'\x{6BA6}\x{6BA7}\x{6BA8}\x{6BA9}\x{6BAA}\x{6BAB}\x{6BAC}\x{6BAD}\x{6BAE}' . +'\x{6BAF}\x{6BB0}\x{6BB2}\x{6BB3}\x{6BB4}\x{6BB5}\x{6BB6}\x{6BB7}\x{6BB9}' . +'\x{6BBA}\x{6BBB}\x{6BBC}\x{6BBD}\x{6BBE}\x{6BBF}\x{6BC0}\x{6BC1}\x{6BC2}' . +'\x{6BC3}\x{6BC4}\x{6BC5}\x{6BC6}\x{6BC7}\x{6BC8}\x{6BC9}\x{6BCA}\x{6BCB}' . +'\x{6BCC}\x{6BCD}\x{6BCE}\x{6BCF}\x{6BD0}\x{6BD1}\x{6BD2}\x{6BD3}\x{6BD4}' . +'\x{6BD5}\x{6BD6}\x{6BD7}\x{6BD8}\x{6BD9}\x{6BDA}\x{6BDB}\x{6BDC}\x{6BDD}' . +'\x{6BDE}\x{6BDF}\x{6BE0}\x{6BE1}\x{6BE2}\x{6BE3}\x{6BE4}\x{6BE5}\x{6BE6}' . +'\x{6BE7}\x{6BE8}\x{6BEA}\x{6BEB}\x{6BEC}\x{6BED}\x{6BEE}\x{6BEF}\x{6BF0}' . +'\x{6BF2}\x{6BF3}\x{6BF5}\x{6BF6}\x{6BF7}\x{6BF8}\x{6BF9}\x{6BFB}\x{6BFC}' . +'\x{6BFD}\x{6BFE}\x{6BFF}\x{6C00}\x{6C01}\x{6C02}\x{6C03}\x{6C04}\x{6C05}' . +'\x{6C06}\x{6C07}\x{6C08}\x{6C09}\x{6C0B}\x{6C0C}\x{6C0D}\x{6C0E}\x{6C0F}' . +'\x{6C10}\x{6C11}\x{6C12}\x{6C13}\x{6C14}\x{6C15}\x{6C16}\x{6C18}\x{6C19}' . +'\x{6C1A}\x{6C1B}\x{6C1D}\x{6C1E}\x{6C1F}\x{6C20}\x{6C21}\x{6C22}\x{6C23}' . +'\x{6C24}\x{6C25}\x{6C26}\x{6C27}\x{6C28}\x{6C29}\x{6C2A}\x{6C2B}\x{6C2C}' . +'\x{6C2E}\x{6C2F}\x{6C30}\x{6C31}\x{6C32}\x{6C33}\x{6C34}\x{6C35}\x{6C36}' . +'\x{6C37}\x{6C38}\x{6C3A}\x{6C3B}\x{6C3D}\x{6C3E}\x{6C3F}\x{6C40}\x{6C41}' . +'\x{6C42}\x{6C43}\x{6C44}\x{6C46}\x{6C47}\x{6C48}\x{6C49}\x{6C4A}\x{6C4B}' . +'\x{6C4C}\x{6C4D}\x{6C4E}\x{6C4F}\x{6C50}\x{6C51}\x{6C52}\x{6C53}\x{6C54}' . +'\x{6C55}\x{6C56}\x{6C57}\x{6C58}\x{6C59}\x{6C5A}\x{6C5B}\x{6C5C}\x{6C5D}' . +'\x{6C5E}\x{6C5F}\x{6C60}\x{6C61}\x{6C62}\x{6C63}\x{6C64}\x{6C65}\x{6C66}' . +'\x{6C67}\x{6C68}\x{6C69}\x{6C6A}\x{6C6B}\x{6C6D}\x{6C6F}\x{6C70}\x{6C71}' . +'\x{6C72}\x{6C73}\x{6C74}\x{6C75}\x{6C76}\x{6C77}\x{6C78}\x{6C79}\x{6C7A}' . +'\x{6C7B}\x{6C7C}\x{6C7D}\x{6C7E}\x{6C7F}\x{6C80}\x{6C81}\x{6C82}\x{6C83}' . +'\x{6C84}\x{6C85}\x{6C86}\x{6C87}\x{6C88}\x{6C89}\x{6C8A}\x{6C8B}\x{6C8C}' . +'\x{6C8D}\x{6C8E}\x{6C8F}\x{6C90}\x{6C91}\x{6C92}\x{6C93}\x{6C94}\x{6C95}' . +'\x{6C96}\x{6C97}\x{6C98}\x{6C99}\x{6C9A}\x{6C9B}\x{6C9C}\x{6C9D}\x{6C9E}' . +'\x{6C9F}\x{6CA1}\x{6CA2}\x{6CA3}\x{6CA4}\x{6CA5}\x{6CA6}\x{6CA7}\x{6CA8}' . +'\x{6CA9}\x{6CAA}\x{6CAB}\x{6CAC}\x{6CAD}\x{6CAE}\x{6CAF}\x{6CB0}\x{6CB1}' . +'\x{6CB2}\x{6CB3}\x{6CB4}\x{6CB5}\x{6CB6}\x{6CB7}\x{6CB8}\x{6CB9}\x{6CBA}' . +'\x{6CBB}\x{6CBC}\x{6CBD}\x{6CBE}\x{6CBF}\x{6CC0}\x{6CC1}\x{6CC2}\x{6CC3}' . +'\x{6CC4}\x{6CC5}\x{6CC6}\x{6CC7}\x{6CC8}\x{6CC9}\x{6CCA}\x{6CCB}\x{6CCC}' . +'\x{6CCD}\x{6CCE}\x{6CCF}\x{6CD0}\x{6CD1}\x{6CD2}\x{6CD3}\x{6CD4}\x{6CD5}' . +'\x{6CD6}\x{6CD7}\x{6CD9}\x{6CDA}\x{6CDB}\x{6CDC}\x{6CDD}\x{6CDE}\x{6CDF}' . +'\x{6CE0}\x{6CE1}\x{6CE2}\x{6CE3}\x{6CE4}\x{6CE5}\x{6CE6}\x{6CE7}\x{6CE8}' . +'\x{6CE9}\x{6CEA}\x{6CEB}\x{6CEC}\x{6CED}\x{6CEE}\x{6CEF}\x{6CF0}\x{6CF1}' . +'\x{6CF2}\x{6CF3}\x{6CF5}\x{6CF6}\x{6CF7}\x{6CF8}\x{6CF9}\x{6CFA}\x{6CFB}' . +'\x{6CFC}\x{6CFD}\x{6CFE}\x{6CFF}\x{6D00}\x{6D01}\x{6D03}\x{6D04}\x{6D05}' . +'\x{6D06}\x{6D07}\x{6D08}\x{6D09}\x{6D0A}\x{6D0B}\x{6D0C}\x{6D0D}\x{6D0E}' . +'\x{6D0F}\x{6D10}\x{6D11}\x{6D12}\x{6D13}\x{6D14}\x{6D15}\x{6D16}\x{6D17}' . +'\x{6D18}\x{6D19}\x{6D1A}\x{6D1B}\x{6D1D}\x{6D1E}\x{6D1F}\x{6D20}\x{6D21}' . +'\x{6D22}\x{6D23}\x{6D25}\x{6D26}\x{6D27}\x{6D28}\x{6D29}\x{6D2A}\x{6D2B}' . +'\x{6D2C}\x{6D2D}\x{6D2E}\x{6D2F}\x{6D30}\x{6D31}\x{6D32}\x{6D33}\x{6D34}' . +'\x{6D35}\x{6D36}\x{6D37}\x{6D38}\x{6D39}\x{6D3A}\x{6D3B}\x{6D3C}\x{6D3D}' . +'\x{6D3E}\x{6D3F}\x{6D40}\x{6D41}\x{6D42}\x{6D43}\x{6D44}\x{6D45}\x{6D46}' . +'\x{6D47}\x{6D48}\x{6D49}\x{6D4A}\x{6D4B}\x{6D4C}\x{6D4D}\x{6D4E}\x{6D4F}' . +'\x{6D50}\x{6D51}\x{6D52}\x{6D53}\x{6D54}\x{6D55}\x{6D56}\x{6D57}\x{6D58}' . +'\x{6D59}\x{6D5A}\x{6D5B}\x{6D5C}\x{6D5D}\x{6D5E}\x{6D5F}\x{6D60}\x{6D61}' . +'\x{6D62}\x{6D63}\x{6D64}\x{6D65}\x{6D66}\x{6D67}\x{6D68}\x{6D69}\x{6D6A}' . +'\x{6D6B}\x{6D6C}\x{6D6D}\x{6D6E}\x{6D6F}\x{6D70}\x{6D72}\x{6D73}\x{6D74}' . +'\x{6D75}\x{6D76}\x{6D77}\x{6D78}\x{6D79}\x{6D7A}\x{6D7B}\x{6D7C}\x{6D7D}' . +'\x{6D7E}\x{6D7F}\x{6D80}\x{6D82}\x{6D83}\x{6D84}\x{6D85}\x{6D86}\x{6D87}' . +'\x{6D88}\x{6D89}\x{6D8A}\x{6D8B}\x{6D8C}\x{6D8D}\x{6D8E}\x{6D8F}\x{6D90}' . +'\x{6D91}\x{6D92}\x{6D93}\x{6D94}\x{6D95}\x{6D97}\x{6D98}\x{6D99}\x{6D9A}' . +'\x{6D9B}\x{6D9D}\x{6D9E}\x{6D9F}\x{6DA0}\x{6DA1}\x{6DA2}\x{6DA3}\x{6DA4}' . +'\x{6DA5}\x{6DA6}\x{6DA7}\x{6DA8}\x{6DA9}\x{6DAA}\x{6DAB}\x{6DAC}\x{6DAD}' . +'\x{6DAE}\x{6DAF}\x{6DB2}\x{6DB3}\x{6DB4}\x{6DB5}\x{6DB7}\x{6DB8}\x{6DB9}' . +'\x{6DBA}\x{6DBB}\x{6DBC}\x{6DBD}\x{6DBE}\x{6DBF}\x{6DC0}\x{6DC1}\x{6DC2}' . +'\x{6DC3}\x{6DC4}\x{6DC5}\x{6DC6}\x{6DC7}\x{6DC8}\x{6DC9}\x{6DCA}\x{6DCB}' . +'\x{6DCC}\x{6DCD}\x{6DCE}\x{6DCF}\x{6DD0}\x{6DD1}\x{6DD2}\x{6DD3}\x{6DD4}' . +'\x{6DD5}\x{6DD6}\x{6DD7}\x{6DD8}\x{6DD9}\x{6DDA}\x{6DDB}\x{6DDC}\x{6DDD}' . +'\x{6DDE}\x{6DDF}\x{6DE0}\x{6DE1}\x{6DE2}\x{6DE3}\x{6DE4}\x{6DE5}\x{6DE6}' . +'\x{6DE7}\x{6DE8}\x{6DE9}\x{6DEA}\x{6DEB}\x{6DEC}\x{6DED}\x{6DEE}\x{6DEF}' . +'\x{6DF0}\x{6DF1}\x{6DF2}\x{6DF3}\x{6DF4}\x{6DF5}\x{6DF6}\x{6DF7}\x{6DF8}' . +'\x{6DF9}\x{6DFA}\x{6DFB}\x{6DFC}\x{6DFD}\x{6E00}\x{6E03}\x{6E04}\x{6E05}' . +'\x{6E07}\x{6E08}\x{6E09}\x{6E0A}\x{6E0B}\x{6E0C}\x{6E0D}\x{6E0E}\x{6E0F}' . +'\x{6E10}\x{6E11}\x{6E14}\x{6E15}\x{6E16}\x{6E17}\x{6E19}\x{6E1A}\x{6E1B}' . +'\x{6E1C}\x{6E1D}\x{6E1E}\x{6E1F}\x{6E20}\x{6E21}\x{6E22}\x{6E23}\x{6E24}' . +'\x{6E25}\x{6E26}\x{6E27}\x{6E28}\x{6E29}\x{6E2B}\x{6E2C}\x{6E2D}\x{6E2E}' . +'\x{6E2F}\x{6E30}\x{6E31}\x{6E32}\x{6E33}\x{6E34}\x{6E35}\x{6E36}\x{6E37}' . +'\x{6E38}\x{6E39}\x{6E3A}\x{6E3B}\x{6E3C}\x{6E3D}\x{6E3E}\x{6E3F}\x{6E40}' . +'\x{6E41}\x{6E42}\x{6E43}\x{6E44}\x{6E45}\x{6E46}\x{6E47}\x{6E48}\x{6E49}' . +'\x{6E4A}\x{6E4B}\x{6E4D}\x{6E4E}\x{6E4F}\x{6E50}\x{6E51}\x{6E52}\x{6E53}' . +'\x{6E54}\x{6E55}\x{6E56}\x{6E57}\x{6E58}\x{6E59}\x{6E5A}\x{6E5B}\x{6E5C}' . +'\x{6E5D}\x{6E5E}\x{6E5F}\x{6E60}\x{6E61}\x{6E62}\x{6E63}\x{6E64}\x{6E65}' . +'\x{6E66}\x{6E67}\x{6E68}\x{6E69}\x{6E6A}\x{6E6B}\x{6E6D}\x{6E6E}\x{6E6F}' . +'\x{6E70}\x{6E71}\x{6E72}\x{6E73}\x{6E74}\x{6E75}\x{6E77}\x{6E78}\x{6E79}' . +'\x{6E7E}\x{6E7F}\x{6E80}\x{6E81}\x{6E82}\x{6E83}\x{6E84}\x{6E85}\x{6E86}' . +'\x{6E87}\x{6E88}\x{6E89}\x{6E8A}\x{6E8D}\x{6E8E}\x{6E8F}\x{6E90}\x{6E91}' . +'\x{6E92}\x{6E93}\x{6E94}\x{6E96}\x{6E97}\x{6E98}\x{6E99}\x{6E9A}\x{6E9B}' . +'\x{6E9C}\x{6E9D}\x{6E9E}\x{6E9F}\x{6EA0}\x{6EA1}\x{6EA2}\x{6EA3}\x{6EA4}' . +'\x{6EA5}\x{6EA6}\x{6EA7}\x{6EA8}\x{6EA9}\x{6EAA}\x{6EAB}\x{6EAC}\x{6EAD}' . +'\x{6EAE}\x{6EAF}\x{6EB0}\x{6EB1}\x{6EB2}\x{6EB3}\x{6EB4}\x{6EB5}\x{6EB6}' . +'\x{6EB7}\x{6EB8}\x{6EB9}\x{6EBA}\x{6EBB}\x{6EBC}\x{6EBD}\x{6EBE}\x{6EBF}' . +'\x{6EC0}\x{6EC1}\x{6EC2}\x{6EC3}\x{6EC4}\x{6EC5}\x{6EC6}\x{6EC7}\x{6EC8}' . +'\x{6EC9}\x{6ECA}\x{6ECB}\x{6ECC}\x{6ECD}\x{6ECE}\x{6ECF}\x{6ED0}\x{6ED1}' . +'\x{6ED2}\x{6ED3}\x{6ED4}\x{6ED5}\x{6ED6}\x{6ED7}\x{6ED8}\x{6ED9}\x{6EDA}' . +'\x{6EDC}\x{6EDE}\x{6EDF}\x{6EE0}\x{6EE1}\x{6EE2}\x{6EE4}\x{6EE5}\x{6EE6}' . +'\x{6EE7}\x{6EE8}\x{6EE9}\x{6EEA}\x{6EEB}\x{6EEC}\x{6EED}\x{6EEE}\x{6EEF}' . +'\x{6EF0}\x{6EF1}\x{6EF2}\x{6EF3}\x{6EF4}\x{6EF5}\x{6EF6}\x{6EF7}\x{6EF8}' . +'\x{6EF9}\x{6EFA}\x{6EFB}\x{6EFC}\x{6EFD}\x{6EFE}\x{6EFF}\x{6F00}\x{6F01}' . +'\x{6F02}\x{6F03}\x{6F05}\x{6F06}\x{6F07}\x{6F08}\x{6F09}\x{6F0A}\x{6F0C}' . +'\x{6F0D}\x{6F0E}\x{6F0F}\x{6F10}\x{6F11}\x{6F12}\x{6F13}\x{6F14}\x{6F15}' . +'\x{6F16}\x{6F17}\x{6F18}\x{6F19}\x{6F1A}\x{6F1B}\x{6F1C}\x{6F1D}\x{6F1E}' . +'\x{6F1F}\x{6F20}\x{6F21}\x{6F22}\x{6F23}\x{6F24}\x{6F25}\x{6F26}\x{6F27}' . +'\x{6F28}\x{6F29}\x{6F2A}\x{6F2B}\x{6F2C}\x{6F2D}\x{6F2E}\x{6F2F}\x{6F30}' . +'\x{6F31}\x{6F32}\x{6F33}\x{6F34}\x{6F35}\x{6F36}\x{6F37}\x{6F38}\x{6F39}' . +'\x{6F3A}\x{6F3B}\x{6F3C}\x{6F3D}\x{6F3E}\x{6F3F}\x{6F40}\x{6F41}\x{6F43}' . +'\x{6F44}\x{6F45}\x{6F46}\x{6F47}\x{6F49}\x{6F4B}\x{6F4C}\x{6F4D}\x{6F4E}' . +'\x{6F4F}\x{6F50}\x{6F51}\x{6F52}\x{6F53}\x{6F54}\x{6F55}\x{6F56}\x{6F57}' . +'\x{6F58}\x{6F59}\x{6F5A}\x{6F5B}\x{6F5C}\x{6F5D}\x{6F5E}\x{6F5F}\x{6F60}' . +'\x{6F61}\x{6F62}\x{6F63}\x{6F64}\x{6F65}\x{6F66}\x{6F67}\x{6F68}\x{6F69}' . +'\x{6F6A}\x{6F6B}\x{6F6C}\x{6F6D}\x{6F6E}\x{6F6F}\x{6F70}\x{6F71}\x{6F72}' . +'\x{6F73}\x{6F74}\x{6F75}\x{6F76}\x{6F77}\x{6F78}\x{6F7A}\x{6F7B}\x{6F7C}' . +'\x{6F7D}\x{6F7E}\x{6F7F}\x{6F80}\x{6F81}\x{6F82}\x{6F83}\x{6F84}\x{6F85}' . +'\x{6F86}\x{6F87}\x{6F88}\x{6F89}\x{6F8A}\x{6F8B}\x{6F8C}\x{6F8D}\x{6F8E}' . +'\x{6F8F}\x{6F90}\x{6F91}\x{6F92}\x{6F93}\x{6F94}\x{6F95}\x{6F96}\x{6F97}' . +'\x{6F99}\x{6F9B}\x{6F9C}\x{6F9D}\x{6F9E}\x{6FA0}\x{6FA1}\x{6FA2}\x{6FA3}' . +'\x{6FA4}\x{6FA5}\x{6FA6}\x{6FA7}\x{6FA8}\x{6FA9}\x{6FAA}\x{6FAB}\x{6FAC}' . +'\x{6FAD}\x{6FAE}\x{6FAF}\x{6FB0}\x{6FB1}\x{6FB2}\x{6FB3}\x{6FB4}\x{6FB5}' . +'\x{6FB6}\x{6FB8}\x{6FB9}\x{6FBA}\x{6FBB}\x{6FBC}\x{6FBD}\x{6FBE}\x{6FBF}' . +'\x{6FC0}\x{6FC1}\x{6FC2}\x{6FC3}\x{6FC4}\x{6FC6}\x{6FC7}\x{6FC8}\x{6FC9}' . +'\x{6FCA}\x{6FCB}\x{6FCC}\x{6FCD}\x{6FCE}\x{6FCF}\x{6FD1}\x{6FD2}\x{6FD4}' . +'\x{6FD5}\x{6FD6}\x{6FD7}\x{6FD8}\x{6FD9}\x{6FDA}\x{6FDB}\x{6FDC}\x{6FDD}' . +'\x{6FDE}\x{6FDF}\x{6FE0}\x{6FE1}\x{6FE2}\x{6FE3}\x{6FE4}\x{6FE5}\x{6FE6}' . +'\x{6FE7}\x{6FE8}\x{6FE9}\x{6FEA}\x{6FEB}\x{6FEC}\x{6FED}\x{6FEE}\x{6FEF}' . +'\x{6FF0}\x{6FF1}\x{6FF2}\x{6FF3}\x{6FF4}\x{6FF6}\x{6FF7}\x{6FF8}\x{6FF9}' . +'\x{6FFA}\x{6FFB}\x{6FFC}\x{6FFE}\x{6FFF}\x{7000}\x{7001}\x{7002}\x{7003}' . +'\x{7004}\x{7005}\x{7006}\x{7007}\x{7008}\x{7009}\x{700A}\x{700B}\x{700C}' . +'\x{700D}\x{700E}\x{700F}\x{7011}\x{7012}\x{7014}\x{7015}\x{7016}\x{7017}' . +'\x{7018}\x{7019}\x{701A}\x{701B}\x{701C}\x{701D}\x{701F}\x{7020}\x{7021}' . +'\x{7022}\x{7023}\x{7024}\x{7025}\x{7026}\x{7027}\x{7028}\x{7029}\x{702A}' . +'\x{702B}\x{702C}\x{702D}\x{702E}\x{702F}\x{7030}\x{7031}\x{7032}\x{7033}' . +'\x{7034}\x{7035}\x{7036}\x{7037}\x{7038}\x{7039}\x{703A}\x{703B}\x{703C}' . +'\x{703D}\x{703E}\x{703F}\x{7040}\x{7041}\x{7042}\x{7043}\x{7044}\x{7045}' . +'\x{7046}\x{7048}\x{7049}\x{704A}\x{704C}\x{704D}\x{704F}\x{7050}\x{7051}' . +'\x{7052}\x{7053}\x{7054}\x{7055}\x{7056}\x{7057}\x{7058}\x{7059}\x{705A}' . +'\x{705B}\x{705C}\x{705D}\x{705E}\x{705F}\x{7060}\x{7061}\x{7062}\x{7063}' . +'\x{7064}\x{7065}\x{7066}\x{7067}\x{7068}\x{7069}\x{706A}\x{706B}\x{706C}' . +'\x{706D}\x{706E}\x{706F}\x{7070}\x{7071}\x{7074}\x{7075}\x{7076}\x{7077}' . +'\x{7078}\x{7079}\x{707A}\x{707C}\x{707D}\x{707E}\x{707F}\x{7080}\x{7082}' . +'\x{7083}\x{7084}\x{7085}\x{7086}\x{7087}\x{7088}\x{7089}\x{708A}\x{708B}' . +'\x{708C}\x{708E}\x{708F}\x{7090}\x{7091}\x{7092}\x{7093}\x{7094}\x{7095}' . +'\x{7096}\x{7098}\x{7099}\x{709A}\x{709C}\x{709D}\x{709E}\x{709F}\x{70A0}' . +'\x{70A1}\x{70A2}\x{70A3}\x{70A4}\x{70A5}\x{70A6}\x{70A7}\x{70A8}\x{70A9}' . +'\x{70AB}\x{70AC}\x{70AD}\x{70AE}\x{70AF}\x{70B0}\x{70B1}\x{70B3}\x{70B4}' . +'\x{70B5}\x{70B7}\x{70B8}\x{70B9}\x{70BA}\x{70BB}\x{70BC}\x{70BD}\x{70BE}' . +'\x{70BF}\x{70C0}\x{70C1}\x{70C2}\x{70C3}\x{70C4}\x{70C5}\x{70C6}\x{70C7}' . +'\x{70C8}\x{70C9}\x{70CA}\x{70CB}\x{70CC}\x{70CD}\x{70CE}\x{70CF}\x{70D0}' . +'\x{70D1}\x{70D2}\x{70D3}\x{70D4}\x{70D6}\x{70D7}\x{70D8}\x{70D9}\x{70DA}' . +'\x{70DB}\x{70DC}\x{70DD}\x{70DE}\x{70DF}\x{70E0}\x{70E1}\x{70E2}\x{70E3}' . +'\x{70E4}\x{70E5}\x{70E6}\x{70E7}\x{70E8}\x{70E9}\x{70EA}\x{70EB}\x{70EC}' . +'\x{70ED}\x{70EE}\x{70EF}\x{70F0}\x{70F1}\x{70F2}\x{70F3}\x{70F4}\x{70F5}' . +'\x{70F6}\x{70F7}\x{70F8}\x{70F9}\x{70FA}\x{70FB}\x{70FC}\x{70FD}\x{70FF}' . +'\x{7100}\x{7101}\x{7102}\x{7103}\x{7104}\x{7105}\x{7106}\x{7107}\x{7109}' . +'\x{710A}\x{710B}\x{710C}\x{710D}\x{710E}\x{710F}\x{7110}\x{7111}\x{7112}' . +'\x{7113}\x{7115}\x{7116}\x{7117}\x{7118}\x{7119}\x{711A}\x{711B}\x{711C}' . +'\x{711D}\x{711E}\x{711F}\x{7120}\x{7121}\x{7122}\x{7123}\x{7125}\x{7126}' . +'\x{7127}\x{7128}\x{7129}\x{712A}\x{712B}\x{712C}\x{712D}\x{712E}\x{712F}' . +'\x{7130}\x{7131}\x{7132}\x{7135}\x{7136}\x{7137}\x{7138}\x{7139}\x{713A}' . +'\x{713B}\x{713D}\x{713E}\x{713F}\x{7140}\x{7141}\x{7142}\x{7143}\x{7144}' . +'\x{7145}\x{7146}\x{7147}\x{7148}\x{7149}\x{714A}\x{714B}\x{714C}\x{714D}' . +'\x{714E}\x{714F}\x{7150}\x{7151}\x{7152}\x{7153}\x{7154}\x{7156}\x{7158}' . +'\x{7159}\x{715A}\x{715B}\x{715C}\x{715D}\x{715E}\x{715F}\x{7160}\x{7161}' . +'\x{7162}\x{7163}\x{7164}\x{7165}\x{7166}\x{7167}\x{7168}\x{7169}\x{716A}' . +'\x{716C}\x{716E}\x{716F}\x{7170}\x{7171}\x{7172}\x{7173}\x{7174}\x{7175}' . +'\x{7176}\x{7177}\x{7178}\x{7179}\x{717A}\x{717B}\x{717C}\x{717D}\x{717E}' . +'\x{717F}\x{7180}\x{7181}\x{7182}\x{7183}\x{7184}\x{7185}\x{7186}\x{7187}' . +'\x{7188}\x{7189}\x{718A}\x{718B}\x{718C}\x{718E}\x{718F}\x{7190}\x{7191}' . +'\x{7192}\x{7193}\x{7194}\x{7195}\x{7197}\x{7198}\x{7199}\x{719A}\x{719B}' . +'\x{719C}\x{719D}\x{719E}\x{719F}\x{71A0}\x{71A1}\x{71A2}\x{71A3}\x{71A4}' . +'\x{71A5}\x{71A7}\x{71A8}\x{71A9}\x{71AA}\x{71AC}\x{71AD}\x{71AE}\x{71AF}' . +'\x{71B0}\x{71B1}\x{71B2}\x{71B3}\x{71B4}\x{71B5}\x{71B7}\x{71B8}\x{71B9}' . +'\x{71BA}\x{71BB}\x{71BC}\x{71BD}\x{71BE}\x{71BF}\x{71C0}\x{71C1}\x{71C2}' . +'\x{71C3}\x{71C4}\x{71C5}\x{71C6}\x{71C7}\x{71C8}\x{71C9}\x{71CA}\x{71CB}' . +'\x{71CD}\x{71CE}\x{71CF}\x{71D0}\x{71D1}\x{71D2}\x{71D4}\x{71D5}\x{71D6}' . +'\x{71D7}\x{71D8}\x{71D9}\x{71DA}\x{71DB}\x{71DC}\x{71DD}\x{71DE}\x{71DF}' . +'\x{71E0}\x{71E1}\x{71E2}\x{71E3}\x{71E4}\x{71E5}\x{71E6}\x{71E7}\x{71E8}' . +'\x{71E9}\x{71EA}\x{71EB}\x{71EC}\x{71ED}\x{71EE}\x{71EF}\x{71F0}\x{71F1}' . +'\x{71F2}\x{71F4}\x{71F5}\x{71F6}\x{71F7}\x{71F8}\x{71F9}\x{71FB}\x{71FC}' . +'\x{71FD}\x{71FE}\x{71FF}\x{7201}\x{7202}\x{7203}\x{7204}\x{7205}\x{7206}' . +'\x{7207}\x{7208}\x{7209}\x{720A}\x{720C}\x{720D}\x{720E}\x{720F}\x{7210}' . +'\x{7212}\x{7213}\x{7214}\x{7216}\x{7218}\x{7219}\x{721A}\x{721B}\x{721C}' . +'\x{721D}\x{721E}\x{721F}\x{7221}\x{7222}\x{7223}\x{7226}\x{7227}\x{7228}' . +'\x{7229}\x{722A}\x{722B}\x{722C}\x{722D}\x{722E}\x{7230}\x{7231}\x{7232}' . +'\x{7233}\x{7235}\x{7236}\x{7237}\x{7238}\x{7239}\x{723A}\x{723B}\x{723C}' . +'\x{723D}\x{723E}\x{723F}\x{7240}\x{7241}\x{7242}\x{7243}\x{7244}\x{7246}' . +'\x{7247}\x{7248}\x{7249}\x{724A}\x{724B}\x{724C}\x{724D}\x{724F}\x{7251}' . +'\x{7252}\x{7253}\x{7254}\x{7256}\x{7257}\x{7258}\x{7259}\x{725A}\x{725B}' . +'\x{725C}\x{725D}\x{725E}\x{725F}\x{7260}\x{7261}\x{7262}\x{7263}\x{7264}' . +'\x{7265}\x{7266}\x{7267}\x{7268}\x{7269}\x{726A}\x{726B}\x{726C}\x{726D}' . +'\x{726E}\x{726F}\x{7270}\x{7271}\x{7272}\x{7273}\x{7274}\x{7275}\x{7276}' . +'\x{7277}\x{7278}\x{7279}\x{727A}\x{727B}\x{727C}\x{727D}\x{727E}\x{727F}' . +'\x{7280}\x{7281}\x{7282}\x{7283}\x{7284}\x{7285}\x{7286}\x{7287}\x{7288}' . +'\x{7289}\x{728A}\x{728B}\x{728C}\x{728D}\x{728E}\x{728F}\x{7290}\x{7291}' . +'\x{7292}\x{7293}\x{7294}\x{7295}\x{7296}\x{7297}\x{7298}\x{7299}\x{729A}' . +'\x{729B}\x{729C}\x{729D}\x{729E}\x{729F}\x{72A1}\x{72A2}\x{72A3}\x{72A4}' . +'\x{72A5}\x{72A6}\x{72A7}\x{72A8}\x{72A9}\x{72AA}\x{72AC}\x{72AD}\x{72AE}' . +'\x{72AF}\x{72B0}\x{72B1}\x{72B2}\x{72B3}\x{72B4}\x{72B5}\x{72B6}\x{72B7}' . +'\x{72B8}\x{72B9}\x{72BA}\x{72BB}\x{72BC}\x{72BD}\x{72BF}\x{72C0}\x{72C1}' . +'\x{72C2}\x{72C3}\x{72C4}\x{72C5}\x{72C6}\x{72C7}\x{72C8}\x{72C9}\x{72CA}' . +'\x{72CB}\x{72CC}\x{72CD}\x{72CE}\x{72CF}\x{72D0}\x{72D1}\x{72D2}\x{72D3}' . +'\x{72D4}\x{72D5}\x{72D6}\x{72D7}\x{72D8}\x{72D9}\x{72DA}\x{72DB}\x{72DC}' . +'\x{72DD}\x{72DE}\x{72DF}\x{72E0}\x{72E1}\x{72E2}\x{72E3}\x{72E4}\x{72E5}' . +'\x{72E6}\x{72E7}\x{72E8}\x{72E9}\x{72EA}\x{72EB}\x{72EC}\x{72ED}\x{72EE}' . +'\x{72EF}\x{72F0}\x{72F1}\x{72F2}\x{72F3}\x{72F4}\x{72F5}\x{72F6}\x{72F7}' . +'\x{72F8}\x{72F9}\x{72FA}\x{72FB}\x{72FC}\x{72FD}\x{72FE}\x{72FF}\x{7300}' . +'\x{7301}\x{7303}\x{7304}\x{7305}\x{7306}\x{7307}\x{7308}\x{7309}\x{730A}' . +'\x{730B}\x{730C}\x{730D}\x{730E}\x{730F}\x{7311}\x{7312}\x{7313}\x{7314}' . +'\x{7315}\x{7316}\x{7317}\x{7318}\x{7319}\x{731A}\x{731B}\x{731C}\x{731D}' . +'\x{731E}\x{7320}\x{7321}\x{7322}\x{7323}\x{7324}\x{7325}\x{7326}\x{7327}' . +'\x{7329}\x{732A}\x{732B}\x{732C}\x{732D}\x{732E}\x{7330}\x{7331}\x{7332}' . +'\x{7333}\x{7334}\x{7335}\x{7336}\x{7337}\x{7338}\x{7339}\x{733A}\x{733B}' . +'\x{733C}\x{733D}\x{733E}\x{733F}\x{7340}\x{7341}\x{7342}\x{7343}\x{7344}' . +'\x{7345}\x{7346}\x{7347}\x{7348}\x{7349}\x{734A}\x{734B}\x{734C}\x{734D}' . +'\x{734E}\x{7350}\x{7351}\x{7352}\x{7354}\x{7355}\x{7356}\x{7357}\x{7358}' . +'\x{7359}\x{735A}\x{735B}\x{735C}\x{735D}\x{735E}\x{735F}\x{7360}\x{7361}' . +'\x{7362}\x{7364}\x{7365}\x{7366}\x{7367}\x{7368}\x{7369}\x{736A}\x{736B}' . +'\x{736C}\x{736D}\x{736E}\x{736F}\x{7370}\x{7371}\x{7372}\x{7373}\x{7374}' . +'\x{7375}\x{7376}\x{7377}\x{7378}\x{7379}\x{737A}\x{737B}\x{737C}\x{737D}' . +'\x{737E}\x{737F}\x{7380}\x{7381}\x{7382}\x{7383}\x{7384}\x{7385}\x{7386}' . +'\x{7387}\x{7388}\x{7389}\x{738A}\x{738B}\x{738C}\x{738D}\x{738E}\x{738F}' . +'\x{7390}\x{7391}\x{7392}\x{7393}\x{7394}\x{7395}\x{7396}\x{7397}\x{7398}' . +'\x{7399}\x{739A}\x{739B}\x{739D}\x{739E}\x{739F}\x{73A0}\x{73A1}\x{73A2}' . +'\x{73A3}\x{73A4}\x{73A5}\x{73A6}\x{73A7}\x{73A8}\x{73A9}\x{73AA}\x{73AB}' . +'\x{73AC}\x{73AD}\x{73AE}\x{73AF}\x{73B0}\x{73B1}\x{73B2}\x{73B3}\x{73B4}' . +'\x{73B5}\x{73B6}\x{73B7}\x{73B8}\x{73B9}\x{73BA}\x{73BB}\x{73BC}\x{73BD}' . +'\x{73BE}\x{73BF}\x{73C0}\x{73C2}\x{73C3}\x{73C4}\x{73C5}\x{73C6}\x{73C7}' . +'\x{73C8}\x{73C9}\x{73CA}\x{73CB}\x{73CC}\x{73CD}\x{73CE}\x{73CF}\x{73D0}' . +'\x{73D1}\x{73D2}\x{73D3}\x{73D4}\x{73D5}\x{73D6}\x{73D7}\x{73D8}\x{73D9}' . +'\x{73DA}\x{73DB}\x{73DC}\x{73DD}\x{73DE}\x{73DF}\x{73E0}\x{73E2}\x{73E3}' . +'\x{73E5}\x{73E6}\x{73E7}\x{73E8}\x{73E9}\x{73EA}\x{73EB}\x{73EC}\x{73ED}' . +'\x{73EE}\x{73EF}\x{73F0}\x{73F1}\x{73F2}\x{73F4}\x{73F5}\x{73F6}\x{73F7}' . +'\x{73F8}\x{73F9}\x{73FA}\x{73FC}\x{73FD}\x{73FE}\x{73FF}\x{7400}\x{7401}' . +'\x{7402}\x{7403}\x{7404}\x{7405}\x{7406}\x{7407}\x{7408}\x{7409}\x{740A}' . +'\x{740B}\x{740C}\x{740D}\x{740E}\x{740F}\x{7410}\x{7411}\x{7412}\x{7413}' . +'\x{7414}\x{7415}\x{7416}\x{7417}\x{7419}\x{741A}\x{741B}\x{741C}\x{741D}' . +'\x{741E}\x{741F}\x{7420}\x{7421}\x{7422}\x{7423}\x{7424}\x{7425}\x{7426}' . +'\x{7427}\x{7428}\x{7429}\x{742A}\x{742B}\x{742C}\x{742D}\x{742E}\x{742F}' . +'\x{7430}\x{7431}\x{7432}\x{7433}\x{7434}\x{7435}\x{7436}\x{7437}\x{7438}' . +'\x{743A}\x{743B}\x{743C}\x{743D}\x{743F}\x{7440}\x{7441}\x{7442}\x{7443}' . +'\x{7444}\x{7445}\x{7446}\x{7448}\x{744A}\x{744B}\x{744C}\x{744D}\x{744E}' . +'\x{744F}\x{7450}\x{7451}\x{7452}\x{7453}\x{7454}\x{7455}\x{7456}\x{7457}' . +'\x{7459}\x{745A}\x{745B}\x{745C}\x{745D}\x{745E}\x{745F}\x{7461}\x{7462}' . +'\x{7463}\x{7464}\x{7465}\x{7466}\x{7467}\x{7468}\x{7469}\x{746A}\x{746B}' . +'\x{746C}\x{746D}\x{746E}\x{746F}\x{7470}\x{7471}\x{7472}\x{7473}\x{7474}' . +'\x{7475}\x{7476}\x{7477}\x{7478}\x{7479}\x{747A}\x{747C}\x{747D}\x{747E}' . +'\x{747F}\x{7480}\x{7481}\x{7482}\x{7483}\x{7485}\x{7486}\x{7487}\x{7488}' . +'\x{7489}\x{748A}\x{748B}\x{748C}\x{748D}\x{748E}\x{748F}\x{7490}\x{7491}' . +'\x{7492}\x{7493}\x{7494}\x{7495}\x{7497}\x{7498}\x{7499}\x{749A}\x{749B}' . +'\x{749C}\x{749E}\x{749F}\x{74A0}\x{74A1}\x{74A3}\x{74A4}\x{74A5}\x{74A6}' . +'\x{74A7}\x{74A8}\x{74A9}\x{74AA}\x{74AB}\x{74AC}\x{74AD}\x{74AE}\x{74AF}' . +'\x{74B0}\x{74B1}\x{74B2}\x{74B3}\x{74B4}\x{74B5}\x{74B6}\x{74B7}\x{74B8}' . +'\x{74B9}\x{74BA}\x{74BB}\x{74BC}\x{74BD}\x{74BE}\x{74BF}\x{74C0}\x{74C1}' . +'\x{74C2}\x{74C3}\x{74C4}\x{74C5}\x{74C6}\x{74CA}\x{74CB}\x{74CD}\x{74CE}' . +'\x{74CF}\x{74D0}\x{74D1}\x{74D2}\x{74D3}\x{74D4}\x{74D5}\x{74D6}\x{74D7}' . +'\x{74D8}\x{74D9}\x{74DA}\x{74DB}\x{74DC}\x{74DD}\x{74DE}\x{74DF}\x{74E0}' . +'\x{74E1}\x{74E2}\x{74E3}\x{74E4}\x{74E5}\x{74E6}\x{74E7}\x{74E8}\x{74E9}' . +'\x{74EA}\x{74EC}\x{74ED}\x{74EE}\x{74EF}\x{74F0}\x{74F1}\x{74F2}\x{74F3}' . +'\x{74F4}\x{74F5}\x{74F6}\x{74F7}\x{74F8}\x{74F9}\x{74FA}\x{74FB}\x{74FC}' . +'\x{74FD}\x{74FE}\x{74FF}\x{7500}\x{7501}\x{7502}\x{7503}\x{7504}\x{7505}' . +'\x{7506}\x{7507}\x{7508}\x{7509}\x{750A}\x{750B}\x{750C}\x{750D}\x{750F}' . +'\x{7510}\x{7511}\x{7512}\x{7513}\x{7514}\x{7515}\x{7516}\x{7517}\x{7518}' . +'\x{7519}\x{751A}\x{751B}\x{751C}\x{751D}\x{751E}\x{751F}\x{7521}\x{7522}' . +'\x{7523}\x{7524}\x{7525}\x{7526}\x{7527}\x{7528}\x{7529}\x{752A}\x{752B}' . +'\x{752C}\x{752D}\x{752E}\x{752F}\x{7530}\x{7531}\x{7532}\x{7533}\x{7535}' . +'\x{7536}\x{7537}\x{7538}\x{7539}\x{753A}\x{753B}\x{753C}\x{753D}\x{753E}' . +'\x{753F}\x{7540}\x{7542}\x{7543}\x{7544}\x{7545}\x{7546}\x{7547}\x{7548}' . +'\x{7549}\x{754B}\x{754C}\x{754D}\x{754E}\x{754F}\x{7550}\x{7551}\x{7553}' . +'\x{7554}\x{7556}\x{7557}\x{7558}\x{7559}\x{755A}\x{755B}\x{755C}\x{755D}' . +'\x{755F}\x{7560}\x{7562}\x{7563}\x{7564}\x{7565}\x{7566}\x{7567}\x{7568}' . +'\x{7569}\x{756A}\x{756B}\x{756C}\x{756D}\x{756E}\x{756F}\x{7570}\x{7572}' . +'\x{7574}\x{7575}\x{7576}\x{7577}\x{7578}\x{7579}\x{757C}\x{757D}\x{757E}' . +'\x{757F}\x{7580}\x{7581}\x{7582}\x{7583}\x{7584}\x{7586}\x{7587}\x{7588}' . +'\x{7589}\x{758A}\x{758B}\x{758C}\x{758D}\x{758F}\x{7590}\x{7591}\x{7592}' . +'\x{7593}\x{7594}\x{7595}\x{7596}\x{7597}\x{7598}\x{7599}\x{759A}\x{759B}' . +'\x{759C}\x{759D}\x{759E}\x{759F}\x{75A0}\x{75A1}\x{75A2}\x{75A3}\x{75A4}' . +'\x{75A5}\x{75A6}\x{75A7}\x{75A8}\x{75AA}\x{75AB}\x{75AC}\x{75AD}\x{75AE}' . +'\x{75AF}\x{75B0}\x{75B1}\x{75B2}\x{75B3}\x{75B4}\x{75B5}\x{75B6}\x{75B8}' . +'\x{75B9}\x{75BA}\x{75BB}\x{75BC}\x{75BD}\x{75BE}\x{75BF}\x{75C0}\x{75C1}' . +'\x{75C2}\x{75C3}\x{75C4}\x{75C5}\x{75C6}\x{75C7}\x{75C8}\x{75C9}\x{75CA}' . +'\x{75CB}\x{75CC}\x{75CD}\x{75CE}\x{75CF}\x{75D0}\x{75D1}\x{75D2}\x{75D3}' . +'\x{75D4}\x{75D5}\x{75D6}\x{75D7}\x{75D8}\x{75D9}\x{75DA}\x{75DB}\x{75DD}' . +'\x{75DE}\x{75DF}\x{75E0}\x{75E1}\x{75E2}\x{75E3}\x{75E4}\x{75E5}\x{75E6}' . +'\x{75E7}\x{75E8}\x{75EA}\x{75EB}\x{75EC}\x{75ED}\x{75EF}\x{75F0}\x{75F1}' . +'\x{75F2}\x{75F3}\x{75F4}\x{75F5}\x{75F6}\x{75F7}\x{75F8}\x{75F9}\x{75FA}' . +'\x{75FB}\x{75FC}\x{75FD}\x{75FE}\x{75FF}\x{7600}\x{7601}\x{7602}\x{7603}' . +'\x{7604}\x{7605}\x{7606}\x{7607}\x{7608}\x{7609}\x{760A}\x{760B}\x{760C}' . +'\x{760D}\x{760E}\x{760F}\x{7610}\x{7611}\x{7612}\x{7613}\x{7614}\x{7615}' . +'\x{7616}\x{7617}\x{7618}\x{7619}\x{761A}\x{761B}\x{761C}\x{761D}\x{761E}' . +'\x{761F}\x{7620}\x{7621}\x{7622}\x{7623}\x{7624}\x{7625}\x{7626}\x{7627}' . +'\x{7628}\x{7629}\x{762A}\x{762B}\x{762D}\x{762E}\x{762F}\x{7630}\x{7631}' . +'\x{7632}\x{7633}\x{7634}\x{7635}\x{7636}\x{7637}\x{7638}\x{7639}\x{763A}' . +'\x{763B}\x{763C}\x{763D}\x{763E}\x{763F}\x{7640}\x{7641}\x{7642}\x{7643}' . +'\x{7646}\x{7647}\x{7648}\x{7649}\x{764A}\x{764B}\x{764C}\x{764D}\x{764F}' . +'\x{7650}\x{7652}\x{7653}\x{7654}\x{7656}\x{7657}\x{7658}\x{7659}\x{765A}' . +'\x{765B}\x{765C}\x{765D}\x{765E}\x{765F}\x{7660}\x{7661}\x{7662}\x{7663}' . +'\x{7664}\x{7665}\x{7666}\x{7667}\x{7668}\x{7669}\x{766A}\x{766B}\x{766C}' . +'\x{766D}\x{766E}\x{766F}\x{7670}\x{7671}\x{7672}\x{7674}\x{7675}\x{7676}' . +'\x{7677}\x{7678}\x{7679}\x{767B}\x{767C}\x{767D}\x{767E}\x{767F}\x{7680}' . +'\x{7681}\x{7682}\x{7683}\x{7684}\x{7685}\x{7686}\x{7687}\x{7688}\x{7689}' . +'\x{768A}\x{768B}\x{768C}\x{768E}\x{768F}\x{7690}\x{7691}\x{7692}\x{7693}' . +'\x{7694}\x{7695}\x{7696}\x{7697}\x{7698}\x{7699}\x{769A}\x{769B}\x{769C}' . +'\x{769D}\x{769E}\x{769F}\x{76A0}\x{76A3}\x{76A4}\x{76A6}\x{76A7}\x{76A9}' . +'\x{76AA}\x{76AB}\x{76AC}\x{76AD}\x{76AE}\x{76AF}\x{76B0}\x{76B1}\x{76B2}' . +'\x{76B4}\x{76B5}\x{76B7}\x{76B8}\x{76BA}\x{76BB}\x{76BC}\x{76BD}\x{76BE}' . +'\x{76BF}\x{76C0}\x{76C2}\x{76C3}\x{76C4}\x{76C5}\x{76C6}\x{76C7}\x{76C8}' . +'\x{76C9}\x{76CA}\x{76CD}\x{76CE}\x{76CF}\x{76D0}\x{76D1}\x{76D2}\x{76D3}' . +'\x{76D4}\x{76D5}\x{76D6}\x{76D7}\x{76D8}\x{76DA}\x{76DB}\x{76DC}\x{76DD}' . +'\x{76DE}\x{76DF}\x{76E0}\x{76E1}\x{76E2}\x{76E3}\x{76E4}\x{76E5}\x{76E6}' . +'\x{76E7}\x{76E8}\x{76E9}\x{76EA}\x{76EC}\x{76ED}\x{76EE}\x{76EF}\x{76F0}' . +'\x{76F1}\x{76F2}\x{76F3}\x{76F4}\x{76F5}\x{76F6}\x{76F7}\x{76F8}\x{76F9}' . +'\x{76FA}\x{76FB}\x{76FC}\x{76FD}\x{76FE}\x{76FF}\x{7701}\x{7703}\x{7704}' . +'\x{7705}\x{7706}\x{7707}\x{7708}\x{7709}\x{770A}\x{770B}\x{770C}\x{770D}' . +'\x{770F}\x{7710}\x{7711}\x{7712}\x{7713}\x{7714}\x{7715}\x{7716}\x{7717}' . +'\x{7718}\x{7719}\x{771A}\x{771B}\x{771C}\x{771D}\x{771E}\x{771F}\x{7720}' . +'\x{7722}\x{7723}\x{7725}\x{7726}\x{7727}\x{7728}\x{7729}\x{772A}\x{772C}' . +'\x{772D}\x{772E}\x{772F}\x{7730}\x{7731}\x{7732}\x{7733}\x{7734}\x{7735}' . +'\x{7736}\x{7737}\x{7738}\x{7739}\x{773A}\x{773B}\x{773C}\x{773D}\x{773E}' . +'\x{7740}\x{7741}\x{7743}\x{7744}\x{7745}\x{7746}\x{7747}\x{7748}\x{7749}' . +'\x{774A}\x{774B}\x{774C}\x{774D}\x{774E}\x{774F}\x{7750}\x{7751}\x{7752}' . +'\x{7753}\x{7754}\x{7755}\x{7756}\x{7757}\x{7758}\x{7759}\x{775A}\x{775B}' . +'\x{775C}\x{775D}\x{775E}\x{775F}\x{7760}\x{7761}\x{7762}\x{7763}\x{7765}' . +'\x{7766}\x{7767}\x{7768}\x{7769}\x{776A}\x{776B}\x{776C}\x{776D}\x{776E}' . +'\x{776F}\x{7770}\x{7771}\x{7772}\x{7773}\x{7774}\x{7775}\x{7776}\x{7777}' . +'\x{7778}\x{7779}\x{777A}\x{777B}\x{777C}\x{777D}\x{777E}\x{777F}\x{7780}' . +'\x{7781}\x{7782}\x{7783}\x{7784}\x{7785}\x{7786}\x{7787}\x{7788}\x{7789}' . +'\x{778A}\x{778B}\x{778C}\x{778D}\x{778E}\x{778F}\x{7790}\x{7791}\x{7792}' . +'\x{7793}\x{7794}\x{7795}\x{7797}\x{7798}\x{7799}\x{779A}\x{779B}\x{779C}' . +'\x{779D}\x{779E}\x{779F}\x{77A0}\x{77A1}\x{77A2}\x{77A3}\x{77A5}\x{77A6}' . +'\x{77A7}\x{77A8}\x{77A9}\x{77AA}\x{77AB}\x{77AC}\x{77AD}\x{77AE}\x{77AF}' . +'\x{77B0}\x{77B1}\x{77B2}\x{77B3}\x{77B4}\x{77B5}\x{77B6}\x{77B7}\x{77B8}' . +'\x{77B9}\x{77BA}\x{77BB}\x{77BC}\x{77BD}\x{77BF}\x{77C0}\x{77C2}\x{77C3}' . +'\x{77C4}\x{77C5}\x{77C6}\x{77C7}\x{77C8}\x{77C9}\x{77CA}\x{77CB}\x{77CC}' . +'\x{77CD}\x{77CE}\x{77CF}\x{77D0}\x{77D1}\x{77D3}\x{77D4}\x{77D5}\x{77D6}' . +'\x{77D7}\x{77D8}\x{77D9}\x{77DA}\x{77DB}\x{77DC}\x{77DE}\x{77DF}\x{77E0}' . +'\x{77E1}\x{77E2}\x{77E3}\x{77E5}\x{77E7}\x{77E8}\x{77E9}\x{77EA}\x{77EB}' . +'\x{77EC}\x{77ED}\x{77EE}\x{77EF}\x{77F0}\x{77F1}\x{77F2}\x{77F3}\x{77F6}' . +'\x{77F7}\x{77F8}\x{77F9}\x{77FA}\x{77FB}\x{77FC}\x{77FD}\x{77FE}\x{77FF}' . +'\x{7800}\x{7801}\x{7802}\x{7803}\x{7804}\x{7805}\x{7806}\x{7808}\x{7809}' . +'\x{780A}\x{780B}\x{780C}\x{780D}\x{780E}\x{780F}\x{7810}\x{7811}\x{7812}' . +'\x{7813}\x{7814}\x{7815}\x{7816}\x{7817}\x{7818}\x{7819}\x{781A}\x{781B}' . +'\x{781C}\x{781D}\x{781E}\x{781F}\x{7820}\x{7821}\x{7822}\x{7823}\x{7825}' . +'\x{7826}\x{7827}\x{7828}\x{7829}\x{782A}\x{782B}\x{782C}\x{782D}\x{782E}' . +'\x{782F}\x{7830}\x{7831}\x{7832}\x{7833}\x{7834}\x{7835}\x{7837}\x{7838}' . +'\x{7839}\x{783A}\x{783B}\x{783C}\x{783D}\x{783E}\x{7840}\x{7841}\x{7843}' . +'\x{7844}\x{7845}\x{7847}\x{7848}\x{7849}\x{784A}\x{784C}\x{784D}\x{784E}' . +'\x{7850}\x{7851}\x{7852}\x{7853}\x{7854}\x{7855}\x{7856}\x{7857}\x{7858}' . +'\x{7859}\x{785A}\x{785B}\x{785C}\x{785D}\x{785E}\x{785F}\x{7860}\x{7861}' . +'\x{7862}\x{7863}\x{7864}\x{7865}\x{7866}\x{7867}\x{7868}\x{7869}\x{786A}' . +'\x{786B}\x{786C}\x{786D}\x{786E}\x{786F}\x{7870}\x{7871}\x{7872}\x{7873}' . +'\x{7874}\x{7875}\x{7877}\x{7878}\x{7879}\x{787A}\x{787B}\x{787C}\x{787D}' . +'\x{787E}\x{787F}\x{7880}\x{7881}\x{7882}\x{7883}\x{7884}\x{7885}\x{7886}' . +'\x{7887}\x{7889}\x{788A}\x{788B}\x{788C}\x{788D}\x{788E}\x{788F}\x{7890}' . +'\x{7891}\x{7892}\x{7893}\x{7894}\x{7895}\x{7896}\x{7897}\x{7898}\x{7899}' . +'\x{789A}\x{789B}\x{789C}\x{789D}\x{789E}\x{789F}\x{78A0}\x{78A1}\x{78A2}' . +'\x{78A3}\x{78A4}\x{78A5}\x{78A6}\x{78A7}\x{78A8}\x{78A9}\x{78AA}\x{78AB}' . +'\x{78AC}\x{78AD}\x{78AE}\x{78AF}\x{78B0}\x{78B1}\x{78B2}\x{78B3}\x{78B4}' . +'\x{78B5}\x{78B6}\x{78B7}\x{78B8}\x{78B9}\x{78BA}\x{78BB}\x{78BC}\x{78BD}' . +'\x{78BE}\x{78BF}\x{78C0}\x{78C1}\x{78C3}\x{78C4}\x{78C5}\x{78C6}\x{78C8}' . +'\x{78C9}\x{78CA}\x{78CB}\x{78CC}\x{78CD}\x{78CE}\x{78CF}\x{78D0}\x{78D1}' . +'\x{78D3}\x{78D4}\x{78D5}\x{78D6}\x{78D7}\x{78D8}\x{78D9}\x{78DA}\x{78DB}' . +'\x{78DC}\x{78DD}\x{78DE}\x{78DF}\x{78E0}\x{78E1}\x{78E2}\x{78E3}\x{78E4}' . +'\x{78E5}\x{78E6}\x{78E7}\x{78E8}\x{78E9}\x{78EA}\x{78EB}\x{78EC}\x{78ED}' . +'\x{78EE}\x{78EF}\x{78F1}\x{78F2}\x{78F3}\x{78F4}\x{78F5}\x{78F6}\x{78F7}' . +'\x{78F9}\x{78FA}\x{78FB}\x{78FC}\x{78FD}\x{78FE}\x{78FF}\x{7901}\x{7902}' . +'\x{7903}\x{7904}\x{7905}\x{7906}\x{7907}\x{7909}\x{790A}\x{790B}\x{790C}' . +'\x{790E}\x{790F}\x{7910}\x{7911}\x{7912}\x{7913}\x{7914}\x{7916}\x{7917}' . +'\x{7918}\x{7919}\x{791A}\x{791B}\x{791C}\x{791D}\x{791E}\x{7921}\x{7922}' . +'\x{7923}\x{7924}\x{7925}\x{7926}\x{7927}\x{7928}\x{7929}\x{792A}\x{792B}' . +'\x{792C}\x{792D}\x{792E}\x{792F}\x{7930}\x{7931}\x{7933}\x{7934}\x{7935}' . +'\x{7937}\x{7938}\x{7939}\x{793A}\x{793B}\x{793C}\x{793D}\x{793E}\x{793F}' . +'\x{7940}\x{7941}\x{7942}\x{7943}\x{7944}\x{7945}\x{7946}\x{7947}\x{7948}' . +'\x{7949}\x{794A}\x{794B}\x{794C}\x{794D}\x{794E}\x{794F}\x{7950}\x{7951}' . +'\x{7952}\x{7953}\x{7954}\x{7955}\x{7956}\x{7957}\x{7958}\x{795A}\x{795B}' . +'\x{795C}\x{795D}\x{795E}\x{795F}\x{7960}\x{7961}\x{7962}\x{7963}\x{7964}' . +'\x{7965}\x{7966}\x{7967}\x{7968}\x{7969}\x{796A}\x{796B}\x{796D}\x{796F}' . +'\x{7970}\x{7971}\x{7972}\x{7973}\x{7974}\x{7977}\x{7978}\x{7979}\x{797A}' . +'\x{797B}\x{797C}\x{797D}\x{797E}\x{797F}\x{7980}\x{7981}\x{7982}\x{7983}' . +'\x{7984}\x{7985}\x{7988}\x{7989}\x{798A}\x{798B}\x{798C}\x{798D}\x{798E}' . +'\x{798F}\x{7990}\x{7991}\x{7992}\x{7993}\x{7994}\x{7995}\x{7996}\x{7997}' . +'\x{7998}\x{7999}\x{799A}\x{799B}\x{799C}\x{799F}\x{79A0}\x{79A1}\x{79A2}' . +'\x{79A3}\x{79A4}\x{79A5}\x{79A6}\x{79A7}\x{79A8}\x{79AA}\x{79AB}\x{79AC}' . +'\x{79AD}\x{79AE}\x{79AF}\x{79B0}\x{79B1}\x{79B2}\x{79B3}\x{79B4}\x{79B5}' . +'\x{79B6}\x{79B7}\x{79B8}\x{79B9}\x{79BA}\x{79BB}\x{79BD}\x{79BE}\x{79BF}' . +'\x{79C0}\x{79C1}\x{79C2}\x{79C3}\x{79C5}\x{79C6}\x{79C8}\x{79C9}\x{79CA}' . +'\x{79CB}\x{79CD}\x{79CE}\x{79CF}\x{79D0}\x{79D1}\x{79D2}\x{79D3}\x{79D5}' . +'\x{79D6}\x{79D8}\x{79D9}\x{79DA}\x{79DB}\x{79DC}\x{79DD}\x{79DE}\x{79DF}' . +'\x{79E0}\x{79E1}\x{79E2}\x{79E3}\x{79E4}\x{79E5}\x{79E6}\x{79E7}\x{79E8}' . +'\x{79E9}\x{79EA}\x{79EB}\x{79EC}\x{79ED}\x{79EE}\x{79EF}\x{79F0}\x{79F1}' . +'\x{79F2}\x{79F3}\x{79F4}\x{79F5}\x{79F6}\x{79F7}\x{79F8}\x{79F9}\x{79FA}' . +'\x{79FB}\x{79FC}\x{79FD}\x{79FE}\x{79FF}\x{7A00}\x{7A02}\x{7A03}\x{7A04}' . +'\x{7A05}\x{7A06}\x{7A08}\x{7A0A}\x{7A0B}\x{7A0C}\x{7A0D}\x{7A0E}\x{7A0F}' . +'\x{7A10}\x{7A11}\x{7A12}\x{7A13}\x{7A14}\x{7A15}\x{7A16}\x{7A17}\x{7A18}' . +'\x{7A19}\x{7A1A}\x{7A1B}\x{7A1C}\x{7A1D}\x{7A1E}\x{7A1F}\x{7A20}\x{7A21}' . +'\x{7A22}\x{7A23}\x{7A24}\x{7A25}\x{7A26}\x{7A27}\x{7A28}\x{7A29}\x{7A2A}' . +'\x{7A2B}\x{7A2D}\x{7A2E}\x{7A2F}\x{7A30}\x{7A31}\x{7A32}\x{7A33}\x{7A34}' . +'\x{7A35}\x{7A37}\x{7A39}\x{7A3B}\x{7A3C}\x{7A3D}\x{7A3E}\x{7A3F}\x{7A40}' . +'\x{7A41}\x{7A42}\x{7A43}\x{7A44}\x{7A45}\x{7A46}\x{7A47}\x{7A48}\x{7A49}' . +'\x{7A4A}\x{7A4B}\x{7A4C}\x{7A4D}\x{7A4E}\x{7A50}\x{7A51}\x{7A52}\x{7A53}' . +'\x{7A54}\x{7A55}\x{7A56}\x{7A57}\x{7A58}\x{7A59}\x{7A5A}\x{7A5B}\x{7A5C}' . +'\x{7A5D}\x{7A5E}\x{7A5F}\x{7A60}\x{7A61}\x{7A62}\x{7A65}\x{7A66}\x{7A67}' . +'\x{7A68}\x{7A69}\x{7A6B}\x{7A6C}\x{7A6D}\x{7A6E}\x{7A70}\x{7A71}\x{7A72}' . +'\x{7A73}\x{7A74}\x{7A75}\x{7A76}\x{7A77}\x{7A78}\x{7A79}\x{7A7A}\x{7A7B}' . +'\x{7A7C}\x{7A7D}\x{7A7E}\x{7A7F}\x{7A80}\x{7A81}\x{7A83}\x{7A84}\x{7A85}' . +'\x{7A86}\x{7A87}\x{7A88}\x{7A89}\x{7A8A}\x{7A8B}\x{7A8C}\x{7A8D}\x{7A8E}' . +'\x{7A8F}\x{7A90}\x{7A91}\x{7A92}\x{7A93}\x{7A94}\x{7A95}\x{7A96}\x{7A97}' . +'\x{7A98}\x{7A99}\x{7A9C}\x{7A9D}\x{7A9E}\x{7A9F}\x{7AA0}\x{7AA1}\x{7AA2}' . +'\x{7AA3}\x{7AA4}\x{7AA5}\x{7AA6}\x{7AA7}\x{7AA8}\x{7AA9}\x{7AAA}\x{7AAB}' . +'\x{7AAC}\x{7AAD}\x{7AAE}\x{7AAF}\x{7AB0}\x{7AB1}\x{7AB2}\x{7AB3}\x{7AB4}' . +'\x{7AB5}\x{7AB6}\x{7AB7}\x{7AB8}\x{7ABA}\x{7ABE}\x{7ABF}\x{7AC0}\x{7AC1}' . +'\x{7AC4}\x{7AC5}\x{7AC7}\x{7AC8}\x{7AC9}\x{7ACA}\x{7ACB}\x{7ACC}\x{7ACD}' . +'\x{7ACE}\x{7ACF}\x{7AD0}\x{7AD1}\x{7AD2}\x{7AD3}\x{7AD4}\x{7AD5}\x{7AD6}' . +'\x{7AD8}\x{7AD9}\x{7ADB}\x{7ADC}\x{7ADD}\x{7ADE}\x{7ADF}\x{7AE0}\x{7AE1}' . +'\x{7AE2}\x{7AE3}\x{7AE4}\x{7AE5}\x{7AE6}\x{7AE7}\x{7AE8}\x{7AEA}\x{7AEB}' . +'\x{7AEC}\x{7AED}\x{7AEE}\x{7AEF}\x{7AF0}\x{7AF1}\x{7AF2}\x{7AF3}\x{7AF4}' . +'\x{7AF6}\x{7AF7}\x{7AF8}\x{7AF9}\x{7AFA}\x{7AFB}\x{7AFD}\x{7AFE}\x{7AFF}' . +'\x{7B00}\x{7B01}\x{7B02}\x{7B03}\x{7B04}\x{7B05}\x{7B06}\x{7B08}\x{7B09}' . +'\x{7B0A}\x{7B0B}\x{7B0C}\x{7B0D}\x{7B0E}\x{7B0F}\x{7B10}\x{7B11}\x{7B12}' . +'\x{7B13}\x{7B14}\x{7B15}\x{7B16}\x{7B17}\x{7B18}\x{7B19}\x{7B1A}\x{7B1B}' . +'\x{7B1C}\x{7B1D}\x{7B1E}\x{7B20}\x{7B21}\x{7B22}\x{7B23}\x{7B24}\x{7B25}' . +'\x{7B26}\x{7B28}\x{7B2A}\x{7B2B}\x{7B2C}\x{7B2D}\x{7B2E}\x{7B2F}\x{7B30}' . +'\x{7B31}\x{7B32}\x{7B33}\x{7B34}\x{7B35}\x{7B36}\x{7B37}\x{7B38}\x{7B39}' . +'\x{7B3A}\x{7B3B}\x{7B3C}\x{7B3D}\x{7B3E}\x{7B3F}\x{7B40}\x{7B41}\x{7B43}' . +'\x{7B44}\x{7B45}\x{7B46}\x{7B47}\x{7B48}\x{7B49}\x{7B4A}\x{7B4B}\x{7B4C}' . +'\x{7B4D}\x{7B4E}\x{7B4F}\x{7B50}\x{7B51}\x{7B52}\x{7B54}\x{7B55}\x{7B56}' . +'\x{7B57}\x{7B58}\x{7B59}\x{7B5A}\x{7B5B}\x{7B5C}\x{7B5D}\x{7B5E}\x{7B5F}' . +'\x{7B60}\x{7B61}\x{7B62}\x{7B63}\x{7B64}\x{7B65}\x{7B66}\x{7B67}\x{7B68}' . +'\x{7B69}\x{7B6A}\x{7B6B}\x{7B6C}\x{7B6D}\x{7B6E}\x{7B70}\x{7B71}\x{7B72}' . +'\x{7B73}\x{7B74}\x{7B75}\x{7B76}\x{7B77}\x{7B78}\x{7B79}\x{7B7B}\x{7B7C}' . +'\x{7B7D}\x{7B7E}\x{7B7F}\x{7B80}\x{7B81}\x{7B82}\x{7B83}\x{7B84}\x{7B85}' . +'\x{7B87}\x{7B88}\x{7B89}\x{7B8A}\x{7B8B}\x{7B8C}\x{7B8D}\x{7B8E}\x{7B8F}' . +'\x{7B90}\x{7B91}\x{7B93}\x{7B94}\x{7B95}\x{7B96}\x{7B97}\x{7B98}\x{7B99}' . +'\x{7B9A}\x{7B9B}\x{7B9C}\x{7B9D}\x{7B9E}\x{7B9F}\x{7BA0}\x{7BA1}\x{7BA2}' . +'\x{7BA4}\x{7BA6}\x{7BA7}\x{7BA8}\x{7BA9}\x{7BAA}\x{7BAB}\x{7BAC}\x{7BAD}' . +'\x{7BAE}\x{7BAF}\x{7BB1}\x{7BB3}\x{7BB4}\x{7BB5}\x{7BB6}\x{7BB7}\x{7BB8}' . +'\x{7BB9}\x{7BBA}\x{7BBB}\x{7BBC}\x{7BBD}\x{7BBE}\x{7BBF}\x{7BC0}\x{7BC1}' . +'\x{7BC2}\x{7BC3}\x{7BC4}\x{7BC5}\x{7BC6}\x{7BC7}\x{7BC8}\x{7BC9}\x{7BCA}' . +'\x{7BCB}\x{7BCC}\x{7BCD}\x{7BCE}\x{7BD0}\x{7BD1}\x{7BD2}\x{7BD3}\x{7BD4}' . +'\x{7BD5}\x{7BD6}\x{7BD7}\x{7BD8}\x{7BD9}\x{7BDA}\x{7BDB}\x{7BDC}\x{7BDD}' . +'\x{7BDE}\x{7BDF}\x{7BE0}\x{7BE1}\x{7BE2}\x{7BE3}\x{7BE4}\x{7BE5}\x{7BE6}' . +'\x{7BE7}\x{7BE8}\x{7BE9}\x{7BEA}\x{7BEB}\x{7BEC}\x{7BED}\x{7BEE}\x{7BEF}' . +'\x{7BF0}\x{7BF1}\x{7BF2}\x{7BF3}\x{7BF4}\x{7BF5}\x{7BF6}\x{7BF7}\x{7BF8}' . +'\x{7BF9}\x{7BFB}\x{7BFC}\x{7BFD}\x{7BFE}\x{7BFF}\x{7C00}\x{7C01}\x{7C02}' . +'\x{7C03}\x{7C04}\x{7C05}\x{7C06}\x{7C07}\x{7C08}\x{7C09}\x{7C0A}\x{7C0B}' . +'\x{7C0C}\x{7C0D}\x{7C0E}\x{7C0F}\x{7C10}\x{7C11}\x{7C12}\x{7C13}\x{7C15}' . +'\x{7C16}\x{7C17}\x{7C18}\x{7C19}\x{7C1A}\x{7C1C}\x{7C1D}\x{7C1E}\x{7C1F}' . +'\x{7C20}\x{7C21}\x{7C22}\x{7C23}\x{7C24}\x{7C25}\x{7C26}\x{7C27}\x{7C28}' . +'\x{7C29}\x{7C2A}\x{7C2B}\x{7C2C}\x{7C2D}\x{7C30}\x{7C31}\x{7C32}\x{7C33}' . +'\x{7C34}\x{7C35}\x{7C36}\x{7C37}\x{7C38}\x{7C39}\x{7C3A}\x{7C3B}\x{7C3C}' . +'\x{7C3D}\x{7C3E}\x{7C3F}\x{7C40}\x{7C41}\x{7C42}\x{7C43}\x{7C44}\x{7C45}' . +'\x{7C46}\x{7C47}\x{7C48}\x{7C49}\x{7C4A}\x{7C4B}\x{7C4C}\x{7C4D}\x{7C4E}' . +'\x{7C50}\x{7C51}\x{7C53}\x{7C54}\x{7C56}\x{7C57}\x{7C58}\x{7C59}\x{7C5A}' . +'\x{7C5B}\x{7C5C}\x{7C5E}\x{7C5F}\x{7C60}\x{7C61}\x{7C62}\x{7C63}\x{7C64}' . +'\x{7C65}\x{7C66}\x{7C67}\x{7C68}\x{7C69}\x{7C6A}\x{7C6B}\x{7C6C}\x{7C6D}' . +'\x{7C6E}\x{7C6F}\x{7C70}\x{7C71}\x{7C72}\x{7C73}\x{7C74}\x{7C75}\x{7C77}' . +'\x{7C78}\x{7C79}\x{7C7A}\x{7C7B}\x{7C7C}\x{7C7D}\x{7C7E}\x{7C7F}\x{7C80}' . +'\x{7C81}\x{7C82}\x{7C84}\x{7C85}\x{7C86}\x{7C88}\x{7C89}\x{7C8A}\x{7C8B}' . +'\x{7C8C}\x{7C8D}\x{7C8E}\x{7C8F}\x{7C90}\x{7C91}\x{7C92}\x{7C94}\x{7C95}' . +'\x{7C96}\x{7C97}\x{7C98}\x{7C99}\x{7C9B}\x{7C9C}\x{7C9D}\x{7C9E}\x{7C9F}' . +'\x{7CA0}\x{7CA1}\x{7CA2}\x{7CA3}\x{7CA4}\x{7CA5}\x{7CA6}\x{7CA7}\x{7CA8}' . +'\x{7CA9}\x{7CAA}\x{7CAD}\x{7CAE}\x{7CAF}\x{7CB0}\x{7CB1}\x{7CB2}\x{7CB3}' . +'\x{7CB4}\x{7CB5}\x{7CB6}\x{7CB7}\x{7CB8}\x{7CB9}\x{7CBA}\x{7CBB}\x{7CBC}' . +'\x{7CBD}\x{7CBE}\x{7CBF}\x{7CC0}\x{7CC1}\x{7CC2}\x{7CC3}\x{7CC4}\x{7CC5}' . +'\x{7CC6}\x{7CC7}\x{7CC8}\x{7CC9}\x{7CCA}\x{7CCB}\x{7CCC}\x{7CCD}\x{7CCE}' . +'\x{7CCF}\x{7CD0}\x{7CD1}\x{7CD2}\x{7CD4}\x{7CD5}\x{7CD6}\x{7CD7}\x{7CD8}' . +'\x{7CD9}\x{7CDC}\x{7CDD}\x{7CDE}\x{7CDF}\x{7CE0}\x{7CE2}\x{7CE4}\x{7CE7}' . +'\x{7CE8}\x{7CE9}\x{7CEA}\x{7CEB}\x{7CEC}\x{7CED}\x{7CEE}\x{7CEF}\x{7CF0}' . +'\x{7CF1}\x{7CF2}\x{7CF3}\x{7CF4}\x{7CF5}\x{7CF6}\x{7CF7}\x{7CF8}\x{7CF9}' . +'\x{7CFA}\x{7CFB}\x{7CFD}\x{7CFE}\x{7D00}\x{7D01}\x{7D02}\x{7D03}\x{7D04}' . +'\x{7D05}\x{7D06}\x{7D07}\x{7D08}\x{7D09}\x{7D0A}\x{7D0B}\x{7D0C}\x{7D0D}' . +'\x{7D0E}\x{7D0F}\x{7D10}\x{7D11}\x{7D12}\x{7D13}\x{7D14}\x{7D15}\x{7D16}' . +'\x{7D17}\x{7D18}\x{7D19}\x{7D1A}\x{7D1B}\x{7D1C}\x{7D1D}\x{7D1E}\x{7D1F}' . +'\x{7D20}\x{7D21}\x{7D22}\x{7D24}\x{7D25}\x{7D26}\x{7D27}\x{7D28}\x{7D29}' . +'\x{7D2B}\x{7D2C}\x{7D2E}\x{7D2F}\x{7D30}\x{7D31}\x{7D32}\x{7D33}\x{7D34}' . +'\x{7D35}\x{7D36}\x{7D37}\x{7D38}\x{7D39}\x{7D3A}\x{7D3B}\x{7D3C}\x{7D3D}' . +'\x{7D3E}\x{7D3F}\x{7D40}\x{7D41}\x{7D42}\x{7D43}\x{7D44}\x{7D45}\x{7D46}' . +'\x{7D47}\x{7D49}\x{7D4A}\x{7D4B}\x{7D4C}\x{7D4E}\x{7D4F}\x{7D50}\x{7D51}' . +'\x{7D52}\x{7D53}\x{7D54}\x{7D55}\x{7D56}\x{7D57}\x{7D58}\x{7D59}\x{7D5B}' . +'\x{7D5C}\x{7D5D}\x{7D5E}\x{7D5F}\x{7D60}\x{7D61}\x{7D62}\x{7D63}\x{7D65}' . +'\x{7D66}\x{7D67}\x{7D68}\x{7D69}\x{7D6A}\x{7D6B}\x{7D6C}\x{7D6D}\x{7D6E}' . +'\x{7D6F}\x{7D70}\x{7D71}\x{7D72}\x{7D73}\x{7D74}\x{7D75}\x{7D76}\x{7D77}' . +'\x{7D79}\x{7D7A}\x{7D7B}\x{7D7C}\x{7D7D}\x{7D7E}\x{7D7F}\x{7D80}\x{7D81}' . +'\x{7D83}\x{7D84}\x{7D85}\x{7D86}\x{7D87}\x{7D88}\x{7D89}\x{7D8A}\x{7D8B}' . +'\x{7D8C}\x{7D8D}\x{7D8E}\x{7D8F}\x{7D90}\x{7D91}\x{7D92}\x{7D93}\x{7D94}' . +'\x{7D96}\x{7D97}\x{7D99}\x{7D9B}\x{7D9C}\x{7D9D}\x{7D9E}\x{7D9F}\x{7DA0}' . +'\x{7DA1}\x{7DA2}\x{7DA3}\x{7DA5}\x{7DA6}\x{7DA7}\x{7DA9}\x{7DAA}\x{7DAB}' . +'\x{7DAC}\x{7DAD}\x{7DAE}\x{7DAF}\x{7DB0}\x{7DB1}\x{7DB2}\x{7DB3}\x{7DB4}' . +'\x{7DB5}\x{7DB6}\x{7DB7}\x{7DB8}\x{7DB9}\x{7DBA}\x{7DBB}\x{7DBC}\x{7DBD}' . +'\x{7DBE}\x{7DBF}\x{7DC0}\x{7DC1}\x{7DC2}\x{7DC3}\x{7DC4}\x{7DC5}\x{7DC6}' . +'\x{7DC7}\x{7DC8}\x{7DC9}\x{7DCA}\x{7DCB}\x{7DCC}\x{7DCE}\x{7DCF}\x{7DD0}' . +'\x{7DD1}\x{7DD2}\x{7DD4}\x{7DD5}\x{7DD6}\x{7DD7}\x{7DD8}\x{7DD9}\x{7DDA}' . +'\x{7DDB}\x{7DDD}\x{7DDE}\x{7DDF}\x{7DE0}\x{7DE1}\x{7DE2}\x{7DE3}\x{7DE6}' . +'\x{7DE7}\x{7DE8}\x{7DE9}\x{7DEA}\x{7DEC}\x{7DED}\x{7DEE}\x{7DEF}\x{7DF0}' . +'\x{7DF1}\x{7DF2}\x{7DF3}\x{7DF4}\x{7DF5}\x{7DF6}\x{7DF7}\x{7DF8}\x{7DF9}' . +'\x{7DFA}\x{7DFB}\x{7DFC}\x{7E00}\x{7E01}\x{7E02}\x{7E03}\x{7E04}\x{7E05}' . +'\x{7E06}\x{7E07}\x{7E08}\x{7E09}\x{7E0A}\x{7E0B}\x{7E0C}\x{7E0D}\x{7E0E}' . +'\x{7E0F}\x{7E10}\x{7E11}\x{7E12}\x{7E13}\x{7E14}\x{7E15}\x{7E16}\x{7E17}' . +'\x{7E19}\x{7E1A}\x{7E1B}\x{7E1C}\x{7E1D}\x{7E1E}\x{7E1F}\x{7E20}\x{7E21}' . +'\x{7E22}\x{7E23}\x{7E24}\x{7E25}\x{7E26}\x{7E27}\x{7E28}\x{7E29}\x{7E2A}' . +'\x{7E2B}\x{7E2C}\x{7E2D}\x{7E2E}\x{7E2F}\x{7E30}\x{7E31}\x{7E32}\x{7E33}' . +'\x{7E34}\x{7E35}\x{7E36}\x{7E37}\x{7E38}\x{7E39}\x{7E3A}\x{7E3B}\x{7E3C}' . +'\x{7E3D}\x{7E3E}\x{7E3F}\x{7E40}\x{7E41}\x{7E42}\x{7E43}\x{7E44}\x{7E45}' . +'\x{7E46}\x{7E47}\x{7E48}\x{7E49}\x{7E4C}\x{7E4D}\x{7E4E}\x{7E4F}\x{7E50}' . +'\x{7E51}\x{7E52}\x{7E53}\x{7E54}\x{7E55}\x{7E56}\x{7E57}\x{7E58}\x{7E59}' . +'\x{7E5A}\x{7E5C}\x{7E5D}\x{7E5E}\x{7E5F}\x{7E60}\x{7E61}\x{7E62}\x{7E63}' . +'\x{7E65}\x{7E66}\x{7E67}\x{7E68}\x{7E69}\x{7E6A}\x{7E6B}\x{7E6C}\x{7E6D}' . +'\x{7E6E}\x{7E6F}\x{7E70}\x{7E71}\x{7E72}\x{7E73}\x{7E74}\x{7E75}\x{7E76}' . +'\x{7E77}\x{7E78}\x{7E79}\x{7E7A}\x{7E7B}\x{7E7C}\x{7E7D}\x{7E7E}\x{7E7F}' . +'\x{7E80}\x{7E81}\x{7E82}\x{7E83}\x{7E84}\x{7E85}\x{7E86}\x{7E87}\x{7E88}' . +'\x{7E89}\x{7E8A}\x{7E8B}\x{7E8C}\x{7E8D}\x{7E8E}\x{7E8F}\x{7E90}\x{7E91}' . +'\x{7E92}\x{7E93}\x{7E94}\x{7E95}\x{7E96}\x{7E97}\x{7E98}\x{7E99}\x{7E9A}' . +'\x{7E9B}\x{7E9C}\x{7E9E}\x{7E9F}\x{7EA0}\x{7EA1}\x{7EA2}\x{7EA3}\x{7EA4}' . +'\x{7EA5}\x{7EA6}\x{7EA7}\x{7EA8}\x{7EA9}\x{7EAA}\x{7EAB}\x{7EAC}\x{7EAD}' . +'\x{7EAE}\x{7EAF}\x{7EB0}\x{7EB1}\x{7EB2}\x{7EB3}\x{7EB4}\x{7EB5}\x{7EB6}' . +'\x{7EB7}\x{7EB8}\x{7EB9}\x{7EBA}\x{7EBB}\x{7EBC}\x{7EBD}\x{7EBE}\x{7EBF}' . +'\x{7EC0}\x{7EC1}\x{7EC2}\x{7EC3}\x{7EC4}\x{7EC5}\x{7EC6}\x{7EC7}\x{7EC8}' . +'\x{7EC9}\x{7ECA}\x{7ECB}\x{7ECC}\x{7ECD}\x{7ECE}\x{7ECF}\x{7ED0}\x{7ED1}' . +'\x{7ED2}\x{7ED3}\x{7ED4}\x{7ED5}\x{7ED6}\x{7ED7}\x{7ED8}\x{7ED9}\x{7EDA}' . +'\x{7EDB}\x{7EDC}\x{7EDD}\x{7EDE}\x{7EDF}\x{7EE0}\x{7EE1}\x{7EE2}\x{7EE3}' . +'\x{7EE4}\x{7EE5}\x{7EE6}\x{7EE7}\x{7EE8}\x{7EE9}\x{7EEA}\x{7EEB}\x{7EEC}' . +'\x{7EED}\x{7EEE}\x{7EEF}\x{7EF0}\x{7EF1}\x{7EF2}\x{7EF3}\x{7EF4}\x{7EF5}' . +'\x{7EF6}\x{7EF7}\x{7EF8}\x{7EF9}\x{7EFA}\x{7EFB}\x{7EFC}\x{7EFD}\x{7EFE}' . +'\x{7EFF}\x{7F00}\x{7F01}\x{7F02}\x{7F03}\x{7F04}\x{7F05}\x{7F06}\x{7F07}' . +'\x{7F08}\x{7F09}\x{7F0A}\x{7F0B}\x{7F0C}\x{7F0D}\x{7F0E}\x{7F0F}\x{7F10}' . +'\x{7F11}\x{7F12}\x{7F13}\x{7F14}\x{7F15}\x{7F16}\x{7F17}\x{7F18}\x{7F19}' . +'\x{7F1A}\x{7F1B}\x{7F1C}\x{7F1D}\x{7F1E}\x{7F1F}\x{7F20}\x{7F21}\x{7F22}' . +'\x{7F23}\x{7F24}\x{7F25}\x{7F26}\x{7F27}\x{7F28}\x{7F29}\x{7F2A}\x{7F2B}' . +'\x{7F2C}\x{7F2D}\x{7F2E}\x{7F2F}\x{7F30}\x{7F31}\x{7F32}\x{7F33}\x{7F34}' . +'\x{7F35}\x{7F36}\x{7F37}\x{7F38}\x{7F39}\x{7F3A}\x{7F3D}\x{7F3E}\x{7F3F}' . +'\x{7F40}\x{7F42}\x{7F43}\x{7F44}\x{7F45}\x{7F47}\x{7F48}\x{7F49}\x{7F4A}' . +'\x{7F4B}\x{7F4C}\x{7F4D}\x{7F4E}\x{7F4F}\x{7F50}\x{7F51}\x{7F52}\x{7F53}' . +'\x{7F54}\x{7F55}\x{7F56}\x{7F57}\x{7F58}\x{7F5A}\x{7F5B}\x{7F5C}\x{7F5D}' . +'\x{7F5E}\x{7F5F}\x{7F60}\x{7F61}\x{7F62}\x{7F63}\x{7F64}\x{7F65}\x{7F66}' . +'\x{7F67}\x{7F68}\x{7F69}\x{7F6A}\x{7F6B}\x{7F6C}\x{7F6D}\x{7F6E}\x{7F6F}' . +'\x{7F70}\x{7F71}\x{7F72}\x{7F73}\x{7F74}\x{7F75}\x{7F76}\x{7F77}\x{7F78}' . +'\x{7F79}\x{7F7A}\x{7F7B}\x{7F7C}\x{7F7D}\x{7F7E}\x{7F7F}\x{7F80}\x{7F81}' . +'\x{7F82}\x{7F83}\x{7F85}\x{7F86}\x{7F87}\x{7F88}\x{7F89}\x{7F8A}\x{7F8B}' . +'\x{7F8C}\x{7F8D}\x{7F8E}\x{7F8F}\x{7F91}\x{7F92}\x{7F93}\x{7F94}\x{7F95}' . +'\x{7F96}\x{7F98}\x{7F9A}\x{7F9B}\x{7F9C}\x{7F9D}\x{7F9E}\x{7F9F}\x{7FA0}' . +'\x{7FA1}\x{7FA2}\x{7FA3}\x{7FA4}\x{7FA5}\x{7FA6}\x{7FA7}\x{7FA8}\x{7FA9}' . +'\x{7FAA}\x{7FAB}\x{7FAC}\x{7FAD}\x{7FAE}\x{7FAF}\x{7FB0}\x{7FB1}\x{7FB2}' . +'\x{7FB3}\x{7FB5}\x{7FB6}\x{7FB7}\x{7FB8}\x{7FB9}\x{7FBA}\x{7FBB}\x{7FBC}' . +'\x{7FBD}\x{7FBE}\x{7FBF}\x{7FC0}\x{7FC1}\x{7FC2}\x{7FC3}\x{7FC4}\x{7FC5}' . +'\x{7FC6}\x{7FC7}\x{7FC8}\x{7FC9}\x{7FCA}\x{7FCB}\x{7FCC}\x{7FCD}\x{7FCE}' . +'\x{7FCF}\x{7FD0}\x{7FD1}\x{7FD2}\x{7FD3}\x{7FD4}\x{7FD5}\x{7FD7}\x{7FD8}' . +'\x{7FD9}\x{7FDA}\x{7FDB}\x{7FDC}\x{7FDE}\x{7FDF}\x{7FE0}\x{7FE1}\x{7FE2}' . +'\x{7FE3}\x{7FE5}\x{7FE6}\x{7FE7}\x{7FE8}\x{7FE9}\x{7FEA}\x{7FEB}\x{7FEC}' . +'\x{7FED}\x{7FEE}\x{7FEF}\x{7FF0}\x{7FF1}\x{7FF2}\x{7FF3}\x{7FF4}\x{7FF5}' . +'\x{7FF6}\x{7FF7}\x{7FF8}\x{7FF9}\x{7FFA}\x{7FFB}\x{7FFC}\x{7FFD}\x{7FFE}' . +'\x{7FFF}\x{8000}\x{8001}\x{8002}\x{8003}\x{8004}\x{8005}\x{8006}\x{8007}' . +'\x{8008}\x{8009}\x{800B}\x{800C}\x{800D}\x{800E}\x{800F}\x{8010}\x{8011}' . +'\x{8012}\x{8013}\x{8014}\x{8015}\x{8016}\x{8017}\x{8018}\x{8019}\x{801A}' . +'\x{801B}\x{801C}\x{801D}\x{801E}\x{801F}\x{8020}\x{8021}\x{8022}\x{8023}' . +'\x{8024}\x{8025}\x{8026}\x{8027}\x{8028}\x{8029}\x{802A}\x{802B}\x{802C}' . +'\x{802D}\x{802E}\x{8030}\x{8031}\x{8032}\x{8033}\x{8034}\x{8035}\x{8036}' . +'\x{8037}\x{8038}\x{8039}\x{803A}\x{803B}\x{803D}\x{803E}\x{803F}\x{8041}' . +'\x{8042}\x{8043}\x{8044}\x{8045}\x{8046}\x{8047}\x{8048}\x{8049}\x{804A}' . +'\x{804B}\x{804C}\x{804D}\x{804E}\x{804F}\x{8050}\x{8051}\x{8052}\x{8053}' . +'\x{8054}\x{8055}\x{8056}\x{8057}\x{8058}\x{8059}\x{805A}\x{805B}\x{805C}' . +'\x{805D}\x{805E}\x{805F}\x{8060}\x{8061}\x{8062}\x{8063}\x{8064}\x{8065}' . +'\x{8067}\x{8068}\x{8069}\x{806A}\x{806B}\x{806C}\x{806D}\x{806E}\x{806F}' . +'\x{8070}\x{8071}\x{8072}\x{8073}\x{8074}\x{8075}\x{8076}\x{8077}\x{8078}' . +'\x{8079}\x{807A}\x{807B}\x{807C}\x{807D}\x{807E}\x{807F}\x{8080}\x{8081}' . +'\x{8082}\x{8083}\x{8084}\x{8085}\x{8086}\x{8087}\x{8089}\x{808A}\x{808B}' . +'\x{808C}\x{808D}\x{808F}\x{8090}\x{8091}\x{8092}\x{8093}\x{8095}\x{8096}' . +'\x{8097}\x{8098}\x{8099}\x{809A}\x{809B}\x{809C}\x{809D}\x{809E}\x{809F}' . +'\x{80A0}\x{80A1}\x{80A2}\x{80A3}\x{80A4}\x{80A5}\x{80A9}\x{80AA}\x{80AB}' . +'\x{80AD}\x{80AE}\x{80AF}\x{80B0}\x{80B1}\x{80B2}\x{80B4}\x{80B5}\x{80B6}' . +'\x{80B7}\x{80B8}\x{80BA}\x{80BB}\x{80BC}\x{80BD}\x{80BE}\x{80BF}\x{80C0}' . +'\x{80C1}\x{80C2}\x{80C3}\x{80C4}\x{80C5}\x{80C6}\x{80C7}\x{80C8}\x{80C9}' . +'\x{80CA}\x{80CB}\x{80CC}\x{80CD}\x{80CE}\x{80CF}\x{80D0}\x{80D1}\x{80D2}' . +'\x{80D3}\x{80D4}\x{80D5}\x{80D6}\x{80D7}\x{80D8}\x{80D9}\x{80DA}\x{80DB}' . +'\x{80DC}\x{80DD}\x{80DE}\x{80E0}\x{80E1}\x{80E2}\x{80E3}\x{80E4}\x{80E5}' . +'\x{80E6}\x{80E7}\x{80E8}\x{80E9}\x{80EA}\x{80EB}\x{80EC}\x{80ED}\x{80EE}' . +'\x{80EF}\x{80F0}\x{80F1}\x{80F2}\x{80F3}\x{80F4}\x{80F5}\x{80F6}\x{80F7}' . +'\x{80F8}\x{80F9}\x{80FA}\x{80FB}\x{80FC}\x{80FD}\x{80FE}\x{80FF}\x{8100}' . +'\x{8101}\x{8102}\x{8105}\x{8106}\x{8107}\x{8108}\x{8109}\x{810A}\x{810B}' . +'\x{810C}\x{810D}\x{810E}\x{810F}\x{8110}\x{8111}\x{8112}\x{8113}\x{8114}' . +'\x{8115}\x{8116}\x{8118}\x{8119}\x{811A}\x{811B}\x{811C}\x{811D}\x{811E}' . +'\x{811F}\x{8120}\x{8121}\x{8122}\x{8123}\x{8124}\x{8125}\x{8126}\x{8127}' . +'\x{8128}\x{8129}\x{812A}\x{812B}\x{812C}\x{812D}\x{812E}\x{812F}\x{8130}' . +'\x{8131}\x{8132}\x{8136}\x{8137}\x{8138}\x{8139}\x{813A}\x{813B}\x{813C}' . +'\x{813D}\x{813E}\x{813F}\x{8140}\x{8141}\x{8142}\x{8143}\x{8144}\x{8145}' . +'\x{8146}\x{8147}\x{8148}\x{8149}\x{814A}\x{814B}\x{814C}\x{814D}\x{814E}' . +'\x{814F}\x{8150}\x{8151}\x{8152}\x{8153}\x{8154}\x{8155}\x{8156}\x{8157}' . +'\x{8158}\x{8159}\x{815A}\x{815B}\x{815C}\x{815D}\x{815E}\x{8160}\x{8161}' . +'\x{8162}\x{8163}\x{8164}\x{8165}\x{8166}\x{8167}\x{8168}\x{8169}\x{816A}' . +'\x{816B}\x{816C}\x{816D}\x{816E}\x{816F}\x{8170}\x{8171}\x{8172}\x{8173}' . +'\x{8174}\x{8175}\x{8176}\x{8177}\x{8178}\x{8179}\x{817A}\x{817B}\x{817C}' . +'\x{817D}\x{817E}\x{817F}\x{8180}\x{8181}\x{8182}\x{8183}\x{8185}\x{8186}' . +'\x{8187}\x{8188}\x{8189}\x{818A}\x{818B}\x{818C}\x{818D}\x{818E}\x{818F}' . +'\x{8191}\x{8192}\x{8193}\x{8194}\x{8195}\x{8197}\x{8198}\x{8199}\x{819A}' . +'\x{819B}\x{819C}\x{819D}\x{819E}\x{819F}\x{81A0}\x{81A1}\x{81A2}\x{81A3}' . +'\x{81A4}\x{81A5}\x{81A6}\x{81A7}\x{81A8}\x{81A9}\x{81AA}\x{81AB}\x{81AC}' . +'\x{81AD}\x{81AE}\x{81AF}\x{81B0}\x{81B1}\x{81B2}\x{81B3}\x{81B4}\x{81B5}' . +'\x{81B6}\x{81B7}\x{81B8}\x{81B9}\x{81BA}\x{81BB}\x{81BC}\x{81BD}\x{81BE}' . +'\x{81BF}\x{81C0}\x{81C1}\x{81C2}\x{81C3}\x{81C4}\x{81C5}\x{81C6}\x{81C7}' . +'\x{81C8}\x{81C9}\x{81CA}\x{81CC}\x{81CD}\x{81CE}\x{81CF}\x{81D0}\x{81D1}' . +'\x{81D2}\x{81D4}\x{81D5}\x{81D6}\x{81D7}\x{81D8}\x{81D9}\x{81DA}\x{81DB}' . +'\x{81DC}\x{81DD}\x{81DE}\x{81DF}\x{81E0}\x{81E1}\x{81E2}\x{81E3}\x{81E5}' . +'\x{81E6}\x{81E7}\x{81E8}\x{81E9}\x{81EA}\x{81EB}\x{81EC}\x{81ED}\x{81EE}' . +'\x{81F1}\x{81F2}\x{81F3}\x{81F4}\x{81F5}\x{81F6}\x{81F7}\x{81F8}\x{81F9}' . +'\x{81FA}\x{81FB}\x{81FC}\x{81FD}\x{81FE}\x{81FF}\x{8200}\x{8201}\x{8202}' . +'\x{8203}\x{8204}\x{8205}\x{8206}\x{8207}\x{8208}\x{8209}\x{820A}\x{820B}' . +'\x{820C}\x{820D}\x{820E}\x{820F}\x{8210}\x{8211}\x{8212}\x{8214}\x{8215}' . +'\x{8216}\x{8218}\x{8219}\x{821A}\x{821B}\x{821C}\x{821D}\x{821E}\x{821F}' . +'\x{8220}\x{8221}\x{8222}\x{8223}\x{8225}\x{8226}\x{8227}\x{8228}\x{8229}' . +'\x{822A}\x{822B}\x{822C}\x{822D}\x{822F}\x{8230}\x{8231}\x{8232}\x{8233}' . +'\x{8234}\x{8235}\x{8236}\x{8237}\x{8238}\x{8239}\x{823A}\x{823B}\x{823C}' . +'\x{823D}\x{823E}\x{823F}\x{8240}\x{8242}\x{8243}\x{8244}\x{8245}\x{8246}' . +'\x{8247}\x{8248}\x{8249}\x{824A}\x{824B}\x{824C}\x{824D}\x{824E}\x{824F}' . +'\x{8250}\x{8251}\x{8252}\x{8253}\x{8254}\x{8255}\x{8256}\x{8257}\x{8258}' . +'\x{8259}\x{825A}\x{825B}\x{825C}\x{825D}\x{825E}\x{825F}\x{8260}\x{8261}' . +'\x{8263}\x{8264}\x{8266}\x{8267}\x{8268}\x{8269}\x{826A}\x{826B}\x{826C}' . +'\x{826D}\x{826E}\x{826F}\x{8270}\x{8271}\x{8272}\x{8273}\x{8274}\x{8275}' . +'\x{8276}\x{8277}\x{8278}\x{8279}\x{827A}\x{827B}\x{827C}\x{827D}\x{827E}' . +'\x{827F}\x{8280}\x{8281}\x{8282}\x{8283}\x{8284}\x{8285}\x{8286}\x{8287}' . +'\x{8288}\x{8289}\x{828A}\x{828B}\x{828D}\x{828E}\x{828F}\x{8290}\x{8291}' . +'\x{8292}\x{8293}\x{8294}\x{8295}\x{8296}\x{8297}\x{8298}\x{8299}\x{829A}' . +'\x{829B}\x{829C}\x{829D}\x{829E}\x{829F}\x{82A0}\x{82A1}\x{82A2}\x{82A3}' . +'\x{82A4}\x{82A5}\x{82A6}\x{82A7}\x{82A8}\x{82A9}\x{82AA}\x{82AB}\x{82AC}' . +'\x{82AD}\x{82AE}\x{82AF}\x{82B0}\x{82B1}\x{82B3}\x{82B4}\x{82B5}\x{82B6}' . +'\x{82B7}\x{82B8}\x{82B9}\x{82BA}\x{82BB}\x{82BC}\x{82BD}\x{82BE}\x{82BF}' . +'\x{82C0}\x{82C1}\x{82C2}\x{82C3}\x{82C4}\x{82C5}\x{82C6}\x{82C7}\x{82C8}' . +'\x{82C9}\x{82CA}\x{82CB}\x{82CC}\x{82CD}\x{82CE}\x{82CF}\x{82D0}\x{82D1}' . +'\x{82D2}\x{82D3}\x{82D4}\x{82D5}\x{82D6}\x{82D7}\x{82D8}\x{82D9}\x{82DA}' . +'\x{82DB}\x{82DC}\x{82DD}\x{82DE}\x{82DF}\x{82E0}\x{82E1}\x{82E3}\x{82E4}' . +'\x{82E5}\x{82E6}\x{82E7}\x{82E8}\x{82E9}\x{82EA}\x{82EB}\x{82EC}\x{82ED}' . +'\x{82EE}\x{82EF}\x{82F0}\x{82F1}\x{82F2}\x{82F3}\x{82F4}\x{82F5}\x{82F6}' . +'\x{82F7}\x{82F8}\x{82F9}\x{82FA}\x{82FB}\x{82FD}\x{82FE}\x{82FF}\x{8300}' . +'\x{8301}\x{8302}\x{8303}\x{8304}\x{8305}\x{8306}\x{8307}\x{8308}\x{8309}' . +'\x{830B}\x{830C}\x{830D}\x{830E}\x{830F}\x{8311}\x{8312}\x{8313}\x{8314}' . +'\x{8315}\x{8316}\x{8317}\x{8318}\x{8319}\x{831A}\x{831B}\x{831C}\x{831D}' . +'\x{831E}\x{831F}\x{8320}\x{8321}\x{8322}\x{8323}\x{8324}\x{8325}\x{8326}' . +'\x{8327}\x{8328}\x{8329}\x{832A}\x{832B}\x{832C}\x{832D}\x{832E}\x{832F}' . +'\x{8331}\x{8332}\x{8333}\x{8334}\x{8335}\x{8336}\x{8337}\x{8338}\x{8339}' . +'\x{833A}\x{833B}\x{833C}\x{833D}\x{833E}\x{833F}\x{8340}\x{8341}\x{8342}' . +'\x{8343}\x{8344}\x{8345}\x{8346}\x{8347}\x{8348}\x{8349}\x{834A}\x{834B}' . +'\x{834C}\x{834D}\x{834E}\x{834F}\x{8350}\x{8351}\x{8352}\x{8353}\x{8354}' . +'\x{8356}\x{8357}\x{8358}\x{8359}\x{835A}\x{835B}\x{835C}\x{835D}\x{835E}' . +'\x{835F}\x{8360}\x{8361}\x{8362}\x{8363}\x{8364}\x{8365}\x{8366}\x{8367}' . +'\x{8368}\x{8369}\x{836A}\x{836B}\x{836C}\x{836D}\x{836E}\x{836F}\x{8370}' . +'\x{8371}\x{8372}\x{8373}\x{8374}\x{8375}\x{8376}\x{8377}\x{8378}\x{8379}' . +'\x{837A}\x{837B}\x{837C}\x{837D}\x{837E}\x{837F}\x{8380}\x{8381}\x{8382}' . +'\x{8383}\x{8384}\x{8385}\x{8386}\x{8387}\x{8388}\x{8389}\x{838A}\x{838B}' . +'\x{838C}\x{838D}\x{838E}\x{838F}\x{8390}\x{8391}\x{8392}\x{8393}\x{8394}' . +'\x{8395}\x{8396}\x{8397}\x{8398}\x{8399}\x{839A}\x{839B}\x{839C}\x{839D}' . +'\x{839E}\x{83A0}\x{83A1}\x{83A2}\x{83A3}\x{83A4}\x{83A5}\x{83A6}\x{83A7}' . +'\x{83A8}\x{83A9}\x{83AA}\x{83AB}\x{83AC}\x{83AD}\x{83AE}\x{83AF}\x{83B0}' . +'\x{83B1}\x{83B2}\x{83B3}\x{83B4}\x{83B6}\x{83B7}\x{83B8}\x{83B9}\x{83BA}' . +'\x{83BB}\x{83BC}\x{83BD}\x{83BF}\x{83C0}\x{83C1}\x{83C2}\x{83C3}\x{83C4}' . +'\x{83C5}\x{83C6}\x{83C7}\x{83C8}\x{83C9}\x{83CA}\x{83CB}\x{83CC}\x{83CD}' . +'\x{83CE}\x{83CF}\x{83D0}\x{83D1}\x{83D2}\x{83D3}\x{83D4}\x{83D5}\x{83D6}' . +'\x{83D7}\x{83D8}\x{83D9}\x{83DA}\x{83DB}\x{83DC}\x{83DD}\x{83DE}\x{83DF}' . +'\x{83E0}\x{83E1}\x{83E2}\x{83E3}\x{83E4}\x{83E5}\x{83E7}\x{83E8}\x{83E9}' . +'\x{83EA}\x{83EB}\x{83EC}\x{83EE}\x{83EF}\x{83F0}\x{83F1}\x{83F2}\x{83F3}' . +'\x{83F4}\x{83F5}\x{83F6}\x{83F7}\x{83F8}\x{83F9}\x{83FA}\x{83FB}\x{83FC}' . +'\x{83FD}\x{83FE}\x{83FF}\x{8400}\x{8401}\x{8402}\x{8403}\x{8404}\x{8405}' . +'\x{8406}\x{8407}\x{8408}\x{8409}\x{840A}\x{840B}\x{840C}\x{840D}\x{840E}' . +'\x{840F}\x{8410}\x{8411}\x{8412}\x{8413}\x{8415}\x{8418}\x{8419}\x{841A}' . +'\x{841B}\x{841C}\x{841D}\x{841E}\x{8421}\x{8422}\x{8423}\x{8424}\x{8425}' . +'\x{8426}\x{8427}\x{8428}\x{8429}\x{842A}\x{842B}\x{842C}\x{842D}\x{842E}' . +'\x{842F}\x{8430}\x{8431}\x{8432}\x{8433}\x{8434}\x{8435}\x{8436}\x{8437}' . +'\x{8438}\x{8439}\x{843A}\x{843B}\x{843C}\x{843D}\x{843E}\x{843F}\x{8440}' . +'\x{8441}\x{8442}\x{8443}\x{8444}\x{8445}\x{8446}\x{8447}\x{8448}\x{8449}' . +'\x{844A}\x{844B}\x{844C}\x{844D}\x{844E}\x{844F}\x{8450}\x{8451}\x{8452}' . +'\x{8453}\x{8454}\x{8455}\x{8456}\x{8457}\x{8459}\x{845A}\x{845B}\x{845C}' . +'\x{845D}\x{845E}\x{845F}\x{8460}\x{8461}\x{8462}\x{8463}\x{8464}\x{8465}' . +'\x{8466}\x{8467}\x{8468}\x{8469}\x{846A}\x{846B}\x{846C}\x{846D}\x{846E}' . +'\x{846F}\x{8470}\x{8471}\x{8472}\x{8473}\x{8474}\x{8475}\x{8476}\x{8477}' . +'\x{8478}\x{8479}\x{847A}\x{847B}\x{847C}\x{847D}\x{847E}\x{847F}\x{8480}' . +'\x{8481}\x{8482}\x{8484}\x{8485}\x{8486}\x{8487}\x{8488}\x{8489}\x{848A}' . +'\x{848B}\x{848C}\x{848D}\x{848E}\x{848F}\x{8490}\x{8491}\x{8492}\x{8493}' . +'\x{8494}\x{8496}\x{8497}\x{8498}\x{8499}\x{849A}\x{849B}\x{849C}\x{849D}' . +'\x{849E}\x{849F}\x{84A0}\x{84A1}\x{84A2}\x{84A3}\x{84A4}\x{84A5}\x{84A6}' . +'\x{84A7}\x{84A8}\x{84A9}\x{84AA}\x{84AB}\x{84AC}\x{84AE}\x{84AF}\x{84B0}' . +'\x{84B1}\x{84B2}\x{84B3}\x{84B4}\x{84B5}\x{84B6}\x{84B8}\x{84B9}\x{84BA}' . +'\x{84BB}\x{84BC}\x{84BD}\x{84BE}\x{84BF}\x{84C0}\x{84C1}\x{84C2}\x{84C4}' . +'\x{84C5}\x{84C6}\x{84C7}\x{84C8}\x{84C9}\x{84CA}\x{84CB}\x{84CC}\x{84CD}' . +'\x{84CE}\x{84CF}\x{84D0}\x{84D1}\x{84D2}\x{84D3}\x{84D4}\x{84D5}\x{84D6}' . +'\x{84D7}\x{84D8}\x{84D9}\x{84DB}\x{84DC}\x{84DD}\x{84DE}\x{84DF}\x{84E0}' . +'\x{84E1}\x{84E2}\x{84E3}\x{84E4}\x{84E5}\x{84E6}\x{84E7}\x{84E8}\x{84E9}' . +'\x{84EA}\x{84EB}\x{84EC}\x{84EE}\x{84EF}\x{84F0}\x{84F1}\x{84F2}\x{84F3}' . +'\x{84F4}\x{84F5}\x{84F6}\x{84F7}\x{84F8}\x{84F9}\x{84FA}\x{84FB}\x{84FC}' . +'\x{84FD}\x{84FE}\x{84FF}\x{8500}\x{8501}\x{8502}\x{8503}\x{8504}\x{8506}' . +'\x{8507}\x{8508}\x{8509}\x{850A}\x{850B}\x{850C}\x{850D}\x{850E}\x{850F}' . +'\x{8511}\x{8512}\x{8513}\x{8514}\x{8515}\x{8516}\x{8517}\x{8518}\x{8519}' . +'\x{851A}\x{851B}\x{851C}\x{851D}\x{851E}\x{851F}\x{8520}\x{8521}\x{8522}' . +'\x{8523}\x{8524}\x{8525}\x{8526}\x{8527}\x{8528}\x{8529}\x{852A}\x{852B}' . +'\x{852C}\x{852D}\x{852E}\x{852F}\x{8530}\x{8531}\x{8534}\x{8535}\x{8536}' . +'\x{8537}\x{8538}\x{8539}\x{853A}\x{853B}\x{853C}\x{853D}\x{853E}\x{853F}' . +'\x{8540}\x{8541}\x{8542}\x{8543}\x{8544}\x{8545}\x{8546}\x{8547}\x{8548}' . +'\x{8549}\x{854A}\x{854B}\x{854D}\x{854E}\x{854F}\x{8551}\x{8552}\x{8553}' . +'\x{8554}\x{8555}\x{8556}\x{8557}\x{8558}\x{8559}\x{855A}\x{855B}\x{855C}' . +'\x{855D}\x{855E}\x{855F}\x{8560}\x{8561}\x{8562}\x{8563}\x{8564}\x{8565}' . +'\x{8566}\x{8567}\x{8568}\x{8569}\x{856A}\x{856B}\x{856C}\x{856D}\x{856E}' . +'\x{856F}\x{8570}\x{8571}\x{8572}\x{8573}\x{8574}\x{8575}\x{8576}\x{8577}' . +'\x{8578}\x{8579}\x{857A}\x{857B}\x{857C}\x{857D}\x{857E}\x{8580}\x{8581}' . +'\x{8582}\x{8583}\x{8584}\x{8585}\x{8586}\x{8587}\x{8588}\x{8589}\x{858A}' . +'\x{858B}\x{858C}\x{858D}\x{858E}\x{858F}\x{8590}\x{8591}\x{8592}\x{8594}' . +'\x{8595}\x{8596}\x{8598}\x{8599}\x{859A}\x{859B}\x{859C}\x{859D}\x{859E}' . +'\x{859F}\x{85A0}\x{85A1}\x{85A2}\x{85A3}\x{85A4}\x{85A5}\x{85A6}\x{85A7}' . +'\x{85A8}\x{85A9}\x{85AA}\x{85AB}\x{85AC}\x{85AD}\x{85AE}\x{85AF}\x{85B0}' . +'\x{85B1}\x{85B3}\x{85B4}\x{85B5}\x{85B6}\x{85B7}\x{85B8}\x{85B9}\x{85BA}' . +'\x{85BC}\x{85BD}\x{85BE}\x{85BF}\x{85C0}\x{85C1}\x{85C2}\x{85C3}\x{85C4}' . +'\x{85C5}\x{85C6}\x{85C7}\x{85C8}\x{85C9}\x{85CA}\x{85CB}\x{85CD}\x{85CE}' . +'\x{85CF}\x{85D0}\x{85D1}\x{85D2}\x{85D3}\x{85D4}\x{85D5}\x{85D6}\x{85D7}' . +'\x{85D8}\x{85D9}\x{85DA}\x{85DB}\x{85DC}\x{85DD}\x{85DE}\x{85DF}\x{85E0}' . +'\x{85E1}\x{85E2}\x{85E3}\x{85E4}\x{85E5}\x{85E6}\x{85E7}\x{85E8}\x{85E9}' . +'\x{85EA}\x{85EB}\x{85EC}\x{85ED}\x{85EF}\x{85F0}\x{85F1}\x{85F2}\x{85F4}' . +'\x{85F5}\x{85F6}\x{85F7}\x{85F8}\x{85F9}\x{85FA}\x{85FB}\x{85FD}\x{85FE}' . +'\x{85FF}\x{8600}\x{8601}\x{8602}\x{8604}\x{8605}\x{8606}\x{8607}\x{8608}' . +'\x{8609}\x{860A}\x{860B}\x{860C}\x{860F}\x{8611}\x{8612}\x{8613}\x{8614}' . +'\x{8616}\x{8617}\x{8618}\x{8619}\x{861A}\x{861B}\x{861C}\x{861E}\x{861F}' . +'\x{8620}\x{8621}\x{8622}\x{8623}\x{8624}\x{8625}\x{8626}\x{8627}\x{8628}' . +'\x{8629}\x{862A}\x{862B}\x{862C}\x{862D}\x{862E}\x{862F}\x{8630}\x{8631}' . +'\x{8632}\x{8633}\x{8634}\x{8635}\x{8636}\x{8638}\x{8639}\x{863A}\x{863B}' . +'\x{863C}\x{863D}\x{863E}\x{863F}\x{8640}\x{8641}\x{8642}\x{8643}\x{8644}' . +'\x{8645}\x{8646}\x{8647}\x{8648}\x{8649}\x{864A}\x{864B}\x{864C}\x{864D}' . +'\x{864E}\x{864F}\x{8650}\x{8651}\x{8652}\x{8653}\x{8654}\x{8655}\x{8656}' . +'\x{8658}\x{8659}\x{865A}\x{865B}\x{865C}\x{865D}\x{865E}\x{865F}\x{8660}' . +'\x{8661}\x{8662}\x{8663}\x{8664}\x{8665}\x{8666}\x{8667}\x{8668}\x{8669}' . +'\x{866A}\x{866B}\x{866C}\x{866D}\x{866E}\x{866F}\x{8670}\x{8671}\x{8672}' . +'\x{8673}\x{8674}\x{8676}\x{8677}\x{8678}\x{8679}\x{867A}\x{867B}\x{867C}' . +'\x{867D}\x{867E}\x{867F}\x{8680}\x{8681}\x{8682}\x{8683}\x{8684}\x{8685}' . +'\x{8686}\x{8687}\x{8688}\x{868A}\x{868B}\x{868C}\x{868D}\x{868E}\x{868F}' . +'\x{8690}\x{8691}\x{8693}\x{8694}\x{8695}\x{8696}\x{8697}\x{8698}\x{8699}' . +'\x{869A}\x{869B}\x{869C}\x{869D}\x{869E}\x{869F}\x{86A1}\x{86A2}\x{86A3}' . +'\x{86A4}\x{86A5}\x{86A7}\x{86A8}\x{86A9}\x{86AA}\x{86AB}\x{86AC}\x{86AD}' . +'\x{86AE}\x{86AF}\x{86B0}\x{86B1}\x{86B2}\x{86B3}\x{86B4}\x{86B5}\x{86B6}' . +'\x{86B7}\x{86B8}\x{86B9}\x{86BA}\x{86BB}\x{86BC}\x{86BD}\x{86BE}\x{86BF}' . +'\x{86C0}\x{86C1}\x{86C2}\x{86C3}\x{86C4}\x{86C5}\x{86C6}\x{86C7}\x{86C8}' . +'\x{86C9}\x{86CA}\x{86CB}\x{86CC}\x{86CE}\x{86CF}\x{86D0}\x{86D1}\x{86D2}' . +'\x{86D3}\x{86D4}\x{86D6}\x{86D7}\x{86D8}\x{86D9}\x{86DA}\x{86DB}\x{86DC}' . +'\x{86DD}\x{86DE}\x{86DF}\x{86E1}\x{86E2}\x{86E3}\x{86E4}\x{86E5}\x{86E6}' . +'\x{86E8}\x{86E9}\x{86EA}\x{86EB}\x{86EC}\x{86ED}\x{86EE}\x{86EF}\x{86F0}' . +'\x{86F1}\x{86F2}\x{86F3}\x{86F4}\x{86F5}\x{86F6}\x{86F7}\x{86F8}\x{86F9}' . +'\x{86FA}\x{86FB}\x{86FC}\x{86FE}\x{86FF}\x{8700}\x{8701}\x{8702}\x{8703}' . +'\x{8704}\x{8705}\x{8706}\x{8707}\x{8708}\x{8709}\x{870A}\x{870B}\x{870C}' . +'\x{870D}\x{870E}\x{870F}\x{8710}\x{8711}\x{8712}\x{8713}\x{8714}\x{8715}' . +'\x{8716}\x{8717}\x{8718}\x{8719}\x{871A}\x{871B}\x{871C}\x{871E}\x{871F}' . +'\x{8720}\x{8721}\x{8722}\x{8723}\x{8724}\x{8725}\x{8726}\x{8727}\x{8728}' . +'\x{8729}\x{872A}\x{872B}\x{872C}\x{872D}\x{872E}\x{8730}\x{8731}\x{8732}' . +'\x{8733}\x{8734}\x{8735}\x{8736}\x{8737}\x{8738}\x{8739}\x{873A}\x{873B}' . +'\x{873C}\x{873E}\x{873F}\x{8740}\x{8741}\x{8742}\x{8743}\x{8744}\x{8746}' . +'\x{8747}\x{8748}\x{8749}\x{874A}\x{874C}\x{874D}\x{874E}\x{874F}\x{8750}' . +'\x{8751}\x{8752}\x{8753}\x{8754}\x{8755}\x{8756}\x{8757}\x{8758}\x{8759}' . +'\x{875A}\x{875B}\x{875C}\x{875D}\x{875E}\x{875F}\x{8760}\x{8761}\x{8762}' . +'\x{8763}\x{8764}\x{8765}\x{8766}\x{8767}\x{8768}\x{8769}\x{876A}\x{876B}' . +'\x{876C}\x{876D}\x{876E}\x{876F}\x{8770}\x{8772}\x{8773}\x{8774}\x{8775}' . +'\x{8776}\x{8777}\x{8778}\x{8779}\x{877A}\x{877B}\x{877C}\x{877D}\x{877E}' . +'\x{8780}\x{8781}\x{8782}\x{8783}\x{8784}\x{8785}\x{8786}\x{8787}\x{8788}' . +'\x{8789}\x{878A}\x{878B}\x{878C}\x{878D}\x{878F}\x{8790}\x{8791}\x{8792}' . +'\x{8793}\x{8794}\x{8795}\x{8796}\x{8797}\x{8798}\x{879A}\x{879B}\x{879C}' . +'\x{879D}\x{879E}\x{879F}\x{87A0}\x{87A1}\x{87A2}\x{87A3}\x{87A4}\x{87A5}' . +'\x{87A6}\x{87A7}\x{87A8}\x{87A9}\x{87AA}\x{87AB}\x{87AC}\x{87AD}\x{87AE}' . +'\x{87AF}\x{87B0}\x{87B1}\x{87B2}\x{87B3}\x{87B4}\x{87B5}\x{87B6}\x{87B7}' . +'\x{87B8}\x{87B9}\x{87BA}\x{87BB}\x{87BC}\x{87BD}\x{87BE}\x{87BF}\x{87C0}' . +'\x{87C1}\x{87C2}\x{87C3}\x{87C4}\x{87C5}\x{87C6}\x{87C7}\x{87C8}\x{87C9}' . +'\x{87CA}\x{87CB}\x{87CC}\x{87CD}\x{87CE}\x{87CF}\x{87D0}\x{87D1}\x{87D2}' . +'\x{87D3}\x{87D4}\x{87D5}\x{87D6}\x{87D7}\x{87D8}\x{87D9}\x{87DB}\x{87DC}' . +'\x{87DD}\x{87DE}\x{87DF}\x{87E0}\x{87E1}\x{87E2}\x{87E3}\x{87E4}\x{87E5}' . +'\x{87E6}\x{87E7}\x{87E8}\x{87E9}\x{87EA}\x{87EB}\x{87EC}\x{87ED}\x{87EE}' . +'\x{87EF}\x{87F1}\x{87F2}\x{87F3}\x{87F4}\x{87F5}\x{87F6}\x{87F7}\x{87F8}' . +'\x{87F9}\x{87FA}\x{87FB}\x{87FC}\x{87FD}\x{87FE}\x{87FF}\x{8800}\x{8801}' . +'\x{8802}\x{8803}\x{8804}\x{8805}\x{8806}\x{8808}\x{8809}\x{880A}\x{880B}' . +'\x{880C}\x{880D}\x{880E}\x{880F}\x{8810}\x{8811}\x{8813}\x{8814}\x{8815}' . +'\x{8816}\x{8817}\x{8818}\x{8819}\x{881A}\x{881B}\x{881C}\x{881D}\x{881E}' . +'\x{881F}\x{8820}\x{8821}\x{8822}\x{8823}\x{8824}\x{8825}\x{8826}\x{8827}' . +'\x{8828}\x{8829}\x{882A}\x{882B}\x{882C}\x{882E}\x{882F}\x{8830}\x{8831}' . +'\x{8832}\x{8833}\x{8834}\x{8835}\x{8836}\x{8837}\x{8838}\x{8839}\x{883B}' . +'\x{883C}\x{883D}\x{883E}\x{883F}\x{8840}\x{8841}\x{8842}\x{8843}\x{8844}' . +'\x{8845}\x{8846}\x{8848}\x{8849}\x{884A}\x{884B}\x{884C}\x{884D}\x{884E}' . +'\x{884F}\x{8850}\x{8851}\x{8852}\x{8853}\x{8854}\x{8855}\x{8856}\x{8857}' . +'\x{8859}\x{885A}\x{885B}\x{885D}\x{885E}\x{8860}\x{8861}\x{8862}\x{8863}' . +'\x{8864}\x{8865}\x{8866}\x{8867}\x{8868}\x{8869}\x{886A}\x{886B}\x{886C}' . +'\x{886D}\x{886E}\x{886F}\x{8870}\x{8871}\x{8872}\x{8873}\x{8874}\x{8875}' . +'\x{8876}\x{8877}\x{8878}\x{8879}\x{887B}\x{887C}\x{887D}\x{887E}\x{887F}' . +'\x{8880}\x{8881}\x{8882}\x{8883}\x{8884}\x{8885}\x{8886}\x{8887}\x{8888}' . +'\x{8889}\x{888A}\x{888B}\x{888C}\x{888D}\x{888E}\x{888F}\x{8890}\x{8891}' . +'\x{8892}\x{8893}\x{8894}\x{8895}\x{8896}\x{8897}\x{8898}\x{8899}\x{889A}' . +'\x{889B}\x{889C}\x{889D}\x{889E}\x{889F}\x{88A0}\x{88A1}\x{88A2}\x{88A3}' . +'\x{88A4}\x{88A5}\x{88A6}\x{88A7}\x{88A8}\x{88A9}\x{88AA}\x{88AB}\x{88AC}' . +'\x{88AD}\x{88AE}\x{88AF}\x{88B0}\x{88B1}\x{88B2}\x{88B3}\x{88B4}\x{88B6}' . +'\x{88B7}\x{88B8}\x{88B9}\x{88BA}\x{88BB}\x{88BC}\x{88BD}\x{88BE}\x{88BF}' . +'\x{88C0}\x{88C1}\x{88C2}\x{88C3}\x{88C4}\x{88C5}\x{88C6}\x{88C7}\x{88C8}' . +'\x{88C9}\x{88CA}\x{88CB}\x{88CC}\x{88CD}\x{88CE}\x{88CF}\x{88D0}\x{88D1}' . +'\x{88D2}\x{88D3}\x{88D4}\x{88D5}\x{88D6}\x{88D7}\x{88D8}\x{88D9}\x{88DA}' . +'\x{88DB}\x{88DC}\x{88DD}\x{88DE}\x{88DF}\x{88E0}\x{88E1}\x{88E2}\x{88E3}' . +'\x{88E4}\x{88E5}\x{88E7}\x{88E8}\x{88EA}\x{88EB}\x{88EC}\x{88EE}\x{88EF}' . +'\x{88F0}\x{88F1}\x{88F2}\x{88F3}\x{88F4}\x{88F5}\x{88F6}\x{88F7}\x{88F8}' . +'\x{88F9}\x{88FA}\x{88FB}\x{88FC}\x{88FD}\x{88FE}\x{88FF}\x{8900}\x{8901}' . +'\x{8902}\x{8904}\x{8905}\x{8906}\x{8907}\x{8908}\x{8909}\x{890A}\x{890B}' . +'\x{890C}\x{890D}\x{890E}\x{8910}\x{8911}\x{8912}\x{8913}\x{8914}\x{8915}' . +'\x{8916}\x{8917}\x{8918}\x{8919}\x{891A}\x{891B}\x{891C}\x{891D}\x{891E}' . +'\x{891F}\x{8920}\x{8921}\x{8922}\x{8923}\x{8925}\x{8926}\x{8927}\x{8928}' . +'\x{8929}\x{892A}\x{892B}\x{892C}\x{892D}\x{892E}\x{892F}\x{8930}\x{8931}' . +'\x{8932}\x{8933}\x{8934}\x{8935}\x{8936}\x{8937}\x{8938}\x{8939}\x{893A}' . +'\x{893B}\x{893C}\x{893D}\x{893E}\x{893F}\x{8940}\x{8941}\x{8942}\x{8943}' . +'\x{8944}\x{8945}\x{8946}\x{8947}\x{8948}\x{8949}\x{894A}\x{894B}\x{894C}' . +'\x{894E}\x{894F}\x{8950}\x{8951}\x{8952}\x{8953}\x{8954}\x{8955}\x{8956}' . +'\x{8957}\x{8958}\x{8959}\x{895A}\x{895B}\x{895C}\x{895D}\x{895E}\x{895F}' . +'\x{8960}\x{8961}\x{8962}\x{8963}\x{8964}\x{8966}\x{8967}\x{8968}\x{8969}' . +'\x{896A}\x{896B}\x{896C}\x{896D}\x{896E}\x{896F}\x{8970}\x{8971}\x{8972}' . +'\x{8973}\x{8974}\x{8976}\x{8977}\x{8978}\x{8979}\x{897A}\x{897B}\x{897C}' . +'\x{897E}\x{897F}\x{8980}\x{8981}\x{8982}\x{8983}\x{8984}\x{8985}\x{8986}' . +'\x{8987}\x{8988}\x{8989}\x{898A}\x{898B}\x{898C}\x{898E}\x{898F}\x{8991}' . +'\x{8992}\x{8993}\x{8995}\x{8996}\x{8997}\x{8998}\x{899A}\x{899B}\x{899C}' . +'\x{899D}\x{899E}\x{899F}\x{89A0}\x{89A1}\x{89A2}\x{89A3}\x{89A4}\x{89A5}' . +'\x{89A6}\x{89A7}\x{89A8}\x{89AA}\x{89AB}\x{89AC}\x{89AD}\x{89AE}\x{89AF}' . +'\x{89B1}\x{89B2}\x{89B3}\x{89B5}\x{89B6}\x{89B7}\x{89B8}\x{89B9}\x{89BA}' . +'\x{89BD}\x{89BE}\x{89BF}\x{89C0}\x{89C1}\x{89C2}\x{89C3}\x{89C4}\x{89C5}' . +'\x{89C6}\x{89C7}\x{89C8}\x{89C9}\x{89CA}\x{89CB}\x{89CC}\x{89CD}\x{89CE}' . +'\x{89CF}\x{89D0}\x{89D1}\x{89D2}\x{89D3}\x{89D4}\x{89D5}\x{89D6}\x{89D7}' . +'\x{89D8}\x{89D9}\x{89DA}\x{89DB}\x{89DC}\x{89DD}\x{89DE}\x{89DF}\x{89E0}' . +'\x{89E1}\x{89E2}\x{89E3}\x{89E4}\x{89E5}\x{89E6}\x{89E7}\x{89E8}\x{89E9}' . +'\x{89EA}\x{89EB}\x{89EC}\x{89ED}\x{89EF}\x{89F0}\x{89F1}\x{89F2}\x{89F3}' . +'\x{89F4}\x{89F6}\x{89F7}\x{89F8}\x{89FA}\x{89FB}\x{89FC}\x{89FE}\x{89FF}' . +'\x{8A00}\x{8A01}\x{8A02}\x{8A03}\x{8A04}\x{8A07}\x{8A08}\x{8A09}\x{8A0A}' . +'\x{8A0B}\x{8A0C}\x{8A0D}\x{8A0E}\x{8A0F}\x{8A10}\x{8A11}\x{8A12}\x{8A13}' . +'\x{8A15}\x{8A16}\x{8A17}\x{8A18}\x{8A1A}\x{8A1B}\x{8A1C}\x{8A1D}\x{8A1E}' . +'\x{8A1F}\x{8A22}\x{8A23}\x{8A24}\x{8A25}\x{8A26}\x{8A27}\x{8A28}\x{8A29}' . +'\x{8A2A}\x{8A2C}\x{8A2D}\x{8A2E}\x{8A2F}\x{8A30}\x{8A31}\x{8A32}\x{8A34}' . +'\x{8A35}\x{8A36}\x{8A37}\x{8A38}\x{8A39}\x{8A3A}\x{8A3B}\x{8A3C}\x{8A3E}' . +'\x{8A3F}\x{8A40}\x{8A41}\x{8A42}\x{8A43}\x{8A44}\x{8A45}\x{8A46}\x{8A47}' . +'\x{8A48}\x{8A49}\x{8A4A}\x{8A4C}\x{8A4D}\x{8A4E}\x{8A4F}\x{8A50}\x{8A51}' . +'\x{8A52}\x{8A53}\x{8A54}\x{8A55}\x{8A56}\x{8A57}\x{8A58}\x{8A59}\x{8A5A}' . +'\x{8A5B}\x{8A5C}\x{8A5D}\x{8A5E}\x{8A5F}\x{8A60}\x{8A61}\x{8A62}\x{8A63}' . +'\x{8A65}\x{8A66}\x{8A67}\x{8A68}\x{8A69}\x{8A6A}\x{8A6B}\x{8A6C}\x{8A6D}' . +'\x{8A6E}\x{8A6F}\x{8A70}\x{8A71}\x{8A72}\x{8A73}\x{8A74}\x{8A75}\x{8A76}' . +'\x{8A77}\x{8A79}\x{8A7A}\x{8A7B}\x{8A7C}\x{8A7E}\x{8A7F}\x{8A80}\x{8A81}' . +'\x{8A82}\x{8A83}\x{8A84}\x{8A85}\x{8A86}\x{8A87}\x{8A89}\x{8A8A}\x{8A8B}' . +'\x{8A8C}\x{8A8D}\x{8A8E}\x{8A8F}\x{8A90}\x{8A91}\x{8A92}\x{8A93}\x{8A94}' . +'\x{8A95}\x{8A96}\x{8A97}\x{8A98}\x{8A99}\x{8A9A}\x{8A9B}\x{8A9C}\x{8A9D}' . +'\x{8A9E}\x{8AA0}\x{8AA1}\x{8AA2}\x{8AA3}\x{8AA4}\x{8AA5}\x{8AA6}\x{8AA7}' . +'\x{8AA8}\x{8AA9}\x{8AAA}\x{8AAB}\x{8AAC}\x{8AAE}\x{8AB0}\x{8AB1}\x{8AB2}' . +'\x{8AB3}\x{8AB4}\x{8AB5}\x{8AB6}\x{8AB8}\x{8AB9}\x{8ABA}\x{8ABB}\x{8ABC}' . +'\x{8ABD}\x{8ABE}\x{8ABF}\x{8AC0}\x{8AC1}\x{8AC2}\x{8AC3}\x{8AC4}\x{8AC5}' . +'\x{8AC6}\x{8AC7}\x{8AC8}\x{8AC9}\x{8ACA}\x{8ACB}\x{8ACC}\x{8ACD}\x{8ACE}' . +'\x{8ACF}\x{8AD1}\x{8AD2}\x{8AD3}\x{8AD4}\x{8AD5}\x{8AD6}\x{8AD7}\x{8AD8}' . +'\x{8AD9}\x{8ADA}\x{8ADB}\x{8ADC}\x{8ADD}\x{8ADE}\x{8ADF}\x{8AE0}\x{8AE1}' . +'\x{8AE2}\x{8AE3}\x{8AE4}\x{8AE5}\x{8AE6}\x{8AE7}\x{8AE8}\x{8AE9}\x{8AEA}' . +'\x{8AEB}\x{8AED}\x{8AEE}\x{8AEF}\x{8AF0}\x{8AF1}\x{8AF2}\x{8AF3}\x{8AF4}' . +'\x{8AF5}\x{8AF6}\x{8AF7}\x{8AF8}\x{8AF9}\x{8AFA}\x{8AFB}\x{8AFC}\x{8AFD}' . +'\x{8AFE}\x{8AFF}\x{8B00}\x{8B01}\x{8B02}\x{8B03}\x{8B04}\x{8B05}\x{8B06}' . +'\x{8B07}\x{8B08}\x{8B09}\x{8B0A}\x{8B0B}\x{8B0D}\x{8B0E}\x{8B0F}\x{8B10}' . +'\x{8B11}\x{8B12}\x{8B13}\x{8B14}\x{8B15}\x{8B16}\x{8B17}\x{8B18}\x{8B19}' . +'\x{8B1A}\x{8B1B}\x{8B1C}\x{8B1D}\x{8B1E}\x{8B1F}\x{8B20}\x{8B21}\x{8B22}' . +'\x{8B23}\x{8B24}\x{8B25}\x{8B26}\x{8B27}\x{8B28}\x{8B2A}\x{8B2B}\x{8B2C}' . +'\x{8B2D}\x{8B2E}\x{8B2F}\x{8B30}\x{8B31}\x{8B33}\x{8B34}\x{8B35}\x{8B36}' . +'\x{8B37}\x{8B39}\x{8B3A}\x{8B3B}\x{8B3C}\x{8B3D}\x{8B3E}\x{8B40}\x{8B41}' . +'\x{8B42}\x{8B43}\x{8B44}\x{8B45}\x{8B46}\x{8B47}\x{8B48}\x{8B49}\x{8B4A}' . +'\x{8B4B}\x{8B4C}\x{8B4D}\x{8B4E}\x{8B4F}\x{8B50}\x{8B51}\x{8B52}\x{8B53}' . +'\x{8B54}\x{8B55}\x{8B56}\x{8B57}\x{8B58}\x{8B59}\x{8B5A}\x{8B5B}\x{8B5C}' . +'\x{8B5D}\x{8B5E}\x{8B5F}\x{8B60}\x{8B63}\x{8B64}\x{8B65}\x{8B66}\x{8B67}' . +'\x{8B68}\x{8B6A}\x{8B6B}\x{8B6C}\x{8B6D}\x{8B6E}\x{8B6F}\x{8B70}\x{8B71}' . +'\x{8B73}\x{8B74}\x{8B76}\x{8B77}\x{8B78}\x{8B79}\x{8B7A}\x{8B7B}\x{8B7D}' . +'\x{8B7E}\x{8B7F}\x{8B80}\x{8B82}\x{8B83}\x{8B84}\x{8B85}\x{8B86}\x{8B88}' . +'\x{8B89}\x{8B8A}\x{8B8B}\x{8B8C}\x{8B8E}\x{8B90}\x{8B91}\x{8B92}\x{8B93}' . +'\x{8B94}\x{8B95}\x{8B96}\x{8B97}\x{8B98}\x{8B99}\x{8B9A}\x{8B9C}\x{8B9D}' . +'\x{8B9E}\x{8B9F}\x{8BA0}\x{8BA1}\x{8BA2}\x{8BA3}\x{8BA4}\x{8BA5}\x{8BA6}' . +'\x{8BA7}\x{8BA8}\x{8BA9}\x{8BAA}\x{8BAB}\x{8BAC}\x{8BAD}\x{8BAE}\x{8BAF}' . +'\x{8BB0}\x{8BB1}\x{8BB2}\x{8BB3}\x{8BB4}\x{8BB5}\x{8BB6}\x{8BB7}\x{8BB8}' . +'\x{8BB9}\x{8BBA}\x{8BBB}\x{8BBC}\x{8BBD}\x{8BBE}\x{8BBF}\x{8BC0}\x{8BC1}' . +'\x{8BC2}\x{8BC3}\x{8BC4}\x{8BC5}\x{8BC6}\x{8BC7}\x{8BC8}\x{8BC9}\x{8BCA}' . +'\x{8BCB}\x{8BCC}\x{8BCD}\x{8BCE}\x{8BCF}\x{8BD0}\x{8BD1}\x{8BD2}\x{8BD3}' . +'\x{8BD4}\x{8BD5}\x{8BD6}\x{8BD7}\x{8BD8}\x{8BD9}\x{8BDA}\x{8BDB}\x{8BDC}' . +'\x{8BDD}\x{8BDE}\x{8BDF}\x{8BE0}\x{8BE1}\x{8BE2}\x{8BE3}\x{8BE4}\x{8BE5}' . +'\x{8BE6}\x{8BE7}\x{8BE8}\x{8BE9}\x{8BEA}\x{8BEB}\x{8BEC}\x{8BED}\x{8BEE}' . +'\x{8BEF}\x{8BF0}\x{8BF1}\x{8BF2}\x{8BF3}\x{8BF4}\x{8BF5}\x{8BF6}\x{8BF7}' . +'\x{8BF8}\x{8BF9}\x{8BFA}\x{8BFB}\x{8BFC}\x{8BFD}\x{8BFE}\x{8BFF}\x{8C00}' . +'\x{8C01}\x{8C02}\x{8C03}\x{8C04}\x{8C05}\x{8C06}\x{8C07}\x{8C08}\x{8C09}' . +'\x{8C0A}\x{8C0B}\x{8C0C}\x{8C0D}\x{8C0E}\x{8C0F}\x{8C10}\x{8C11}\x{8C12}' . +'\x{8C13}\x{8C14}\x{8C15}\x{8C16}\x{8C17}\x{8C18}\x{8C19}\x{8C1A}\x{8C1B}' . +'\x{8C1C}\x{8C1D}\x{8C1E}\x{8C1F}\x{8C20}\x{8C21}\x{8C22}\x{8C23}\x{8C24}' . +'\x{8C25}\x{8C26}\x{8C27}\x{8C28}\x{8C29}\x{8C2A}\x{8C2B}\x{8C2C}\x{8C2D}' . +'\x{8C2E}\x{8C2F}\x{8C30}\x{8C31}\x{8C32}\x{8C33}\x{8C34}\x{8C35}\x{8C36}' . +'\x{8C37}\x{8C39}\x{8C3A}\x{8C3B}\x{8C3C}\x{8C3D}\x{8C3E}\x{8C3F}\x{8C41}' . +'\x{8C42}\x{8C43}\x{8C45}\x{8C46}\x{8C47}\x{8C48}\x{8C49}\x{8C4A}\x{8C4B}' . +'\x{8C4C}\x{8C4D}\x{8C4E}\x{8C4F}\x{8C50}\x{8C54}\x{8C55}\x{8C56}\x{8C57}' . +'\x{8C59}\x{8C5A}\x{8C5B}\x{8C5C}\x{8C5D}\x{8C5E}\x{8C5F}\x{8C60}\x{8C61}' . +'\x{8C62}\x{8C63}\x{8C64}\x{8C65}\x{8C66}\x{8C67}\x{8C68}\x{8C69}\x{8C6A}' . +'\x{8C6B}\x{8C6C}\x{8C6D}\x{8C6E}\x{8C6F}\x{8C70}\x{8C71}\x{8C72}\x{8C73}' . +'\x{8C75}\x{8C76}\x{8C77}\x{8C78}\x{8C79}\x{8C7A}\x{8C7B}\x{8C7D}\x{8C7E}' . +'\x{8C80}\x{8C81}\x{8C82}\x{8C84}\x{8C85}\x{8C86}\x{8C88}\x{8C89}\x{8C8A}' . +'\x{8C8C}\x{8C8D}\x{8C8F}\x{8C90}\x{8C91}\x{8C92}\x{8C93}\x{8C94}\x{8C95}' . +'\x{8C96}\x{8C97}\x{8C98}\x{8C99}\x{8C9A}\x{8C9C}\x{8C9D}\x{8C9E}\x{8C9F}' . +'\x{8CA0}\x{8CA1}\x{8CA2}\x{8CA3}\x{8CA4}\x{8CA5}\x{8CA7}\x{8CA8}\x{8CA9}' . +'\x{8CAA}\x{8CAB}\x{8CAC}\x{8CAD}\x{8CAE}\x{8CAF}\x{8CB0}\x{8CB1}\x{8CB2}' . +'\x{8CB3}\x{8CB4}\x{8CB5}\x{8CB6}\x{8CB7}\x{8CB8}\x{8CB9}\x{8CBA}\x{8CBB}' . +'\x{8CBC}\x{8CBD}\x{8CBE}\x{8CBF}\x{8CC0}\x{8CC1}\x{8CC2}\x{8CC3}\x{8CC4}' . +'\x{8CC5}\x{8CC6}\x{8CC7}\x{8CC8}\x{8CC9}\x{8CCA}\x{8CCC}\x{8CCE}\x{8CCF}' . +'\x{8CD0}\x{8CD1}\x{8CD2}\x{8CD3}\x{8CD4}\x{8CD5}\x{8CD7}\x{8CD9}\x{8CDA}' . +'\x{8CDB}\x{8CDC}\x{8CDD}\x{8CDE}\x{8CDF}\x{8CE0}\x{8CE1}\x{8CE2}\x{8CE3}' . +'\x{8CE4}\x{8CE5}\x{8CE6}\x{8CE7}\x{8CE8}\x{8CEA}\x{8CEB}\x{8CEC}\x{8CED}' . +'\x{8CEE}\x{8CEF}\x{8CF0}\x{8CF1}\x{8CF2}\x{8CF3}\x{8CF4}\x{8CF5}\x{8CF6}' . +'\x{8CF8}\x{8CF9}\x{8CFA}\x{8CFB}\x{8CFC}\x{8CFD}\x{8CFE}\x{8CFF}\x{8D00}' . +'\x{8D02}\x{8D03}\x{8D04}\x{8D05}\x{8D06}\x{8D07}\x{8D08}\x{8D09}\x{8D0A}' . +'\x{8D0B}\x{8D0C}\x{8D0D}\x{8D0E}\x{8D0F}\x{8D10}\x{8D13}\x{8D14}\x{8D15}' . +'\x{8D16}\x{8D17}\x{8D18}\x{8D19}\x{8D1A}\x{8D1B}\x{8D1C}\x{8D1D}\x{8D1E}' . +'\x{8D1F}\x{8D20}\x{8D21}\x{8D22}\x{8D23}\x{8D24}\x{8D25}\x{8D26}\x{8D27}' . +'\x{8D28}\x{8D29}\x{8D2A}\x{8D2B}\x{8D2C}\x{8D2D}\x{8D2E}\x{8D2F}\x{8D30}' . +'\x{8D31}\x{8D32}\x{8D33}\x{8D34}\x{8D35}\x{8D36}\x{8D37}\x{8D38}\x{8D39}' . +'\x{8D3A}\x{8D3B}\x{8D3C}\x{8D3D}\x{8D3E}\x{8D3F}\x{8D40}\x{8D41}\x{8D42}' . +'\x{8D43}\x{8D44}\x{8D45}\x{8D46}\x{8D47}\x{8D48}\x{8D49}\x{8D4A}\x{8D4B}' . +'\x{8D4C}\x{8D4D}\x{8D4E}\x{8D4F}\x{8D50}\x{8D51}\x{8D52}\x{8D53}\x{8D54}' . +'\x{8D55}\x{8D56}\x{8D57}\x{8D58}\x{8D59}\x{8D5A}\x{8D5B}\x{8D5C}\x{8D5D}' . +'\x{8D5E}\x{8D5F}\x{8D60}\x{8D61}\x{8D62}\x{8D63}\x{8D64}\x{8D65}\x{8D66}' . +'\x{8D67}\x{8D68}\x{8D69}\x{8D6A}\x{8D6B}\x{8D6C}\x{8D6D}\x{8D6E}\x{8D6F}' . +'\x{8D70}\x{8D71}\x{8D72}\x{8D73}\x{8D74}\x{8D75}\x{8D76}\x{8D77}\x{8D78}' . +'\x{8D79}\x{8D7A}\x{8D7B}\x{8D7D}\x{8D7E}\x{8D7F}\x{8D80}\x{8D81}\x{8D82}' . +'\x{8D83}\x{8D84}\x{8D85}\x{8D86}\x{8D87}\x{8D88}\x{8D89}\x{8D8A}\x{8D8B}' . +'\x{8D8C}\x{8D8D}\x{8D8E}\x{8D8F}\x{8D90}\x{8D91}\x{8D92}\x{8D93}\x{8D94}' . +'\x{8D95}\x{8D96}\x{8D97}\x{8D98}\x{8D99}\x{8D9A}\x{8D9B}\x{8D9C}\x{8D9D}' . +'\x{8D9E}\x{8D9F}\x{8DA0}\x{8DA1}\x{8DA2}\x{8DA3}\x{8DA4}\x{8DA5}\x{8DA7}' . +'\x{8DA8}\x{8DA9}\x{8DAA}\x{8DAB}\x{8DAC}\x{8DAD}\x{8DAE}\x{8DAF}\x{8DB0}' . +'\x{8DB1}\x{8DB2}\x{8DB3}\x{8DB4}\x{8DB5}\x{8DB6}\x{8DB7}\x{8DB8}\x{8DB9}' . +'\x{8DBA}\x{8DBB}\x{8DBC}\x{8DBD}\x{8DBE}\x{8DBF}\x{8DC1}\x{8DC2}\x{8DC3}' . +'\x{8DC4}\x{8DC5}\x{8DC6}\x{8DC7}\x{8DC8}\x{8DC9}\x{8DCA}\x{8DCB}\x{8DCC}' . +'\x{8DCD}\x{8DCE}\x{8DCF}\x{8DD0}\x{8DD1}\x{8DD2}\x{8DD3}\x{8DD4}\x{8DD5}' . +'\x{8DD6}\x{8DD7}\x{8DD8}\x{8DD9}\x{8DDA}\x{8DDB}\x{8DDC}\x{8DDD}\x{8DDE}' . +'\x{8DDF}\x{8DE0}\x{8DE1}\x{8DE2}\x{8DE3}\x{8DE4}\x{8DE6}\x{8DE7}\x{8DE8}' . +'\x{8DE9}\x{8DEA}\x{8DEB}\x{8DEC}\x{8DED}\x{8DEE}\x{8DEF}\x{8DF0}\x{8DF1}' . +'\x{8DF2}\x{8DF3}\x{8DF4}\x{8DF5}\x{8DF6}\x{8DF7}\x{8DF8}\x{8DF9}\x{8DFA}' . +'\x{8DFB}\x{8DFC}\x{8DFD}\x{8DFE}\x{8DFF}\x{8E00}\x{8E02}\x{8E03}\x{8E04}' . +'\x{8E05}\x{8E06}\x{8E07}\x{8E08}\x{8E09}\x{8E0A}\x{8E0C}\x{8E0D}\x{8E0E}' . +'\x{8E0F}\x{8E10}\x{8E11}\x{8E12}\x{8E13}\x{8E14}\x{8E15}\x{8E16}\x{8E17}' . +'\x{8E18}\x{8E19}\x{8E1A}\x{8E1B}\x{8E1C}\x{8E1D}\x{8E1E}\x{8E1F}\x{8E20}' . +'\x{8E21}\x{8E22}\x{8E23}\x{8E24}\x{8E25}\x{8E26}\x{8E27}\x{8E28}\x{8E29}' . +'\x{8E2A}\x{8E2B}\x{8E2C}\x{8E2D}\x{8E2E}\x{8E2F}\x{8E30}\x{8E31}\x{8E33}' . +'\x{8E34}\x{8E35}\x{8E36}\x{8E37}\x{8E38}\x{8E39}\x{8E3A}\x{8E3B}\x{8E3C}' . +'\x{8E3D}\x{8E3E}\x{8E3F}\x{8E40}\x{8E41}\x{8E42}\x{8E43}\x{8E44}\x{8E45}' . +'\x{8E47}\x{8E48}\x{8E49}\x{8E4A}\x{8E4B}\x{8E4C}\x{8E4D}\x{8E4E}\x{8E50}' . +'\x{8E51}\x{8E52}\x{8E53}\x{8E54}\x{8E55}\x{8E56}\x{8E57}\x{8E58}\x{8E59}' . +'\x{8E5A}\x{8E5B}\x{8E5C}\x{8E5D}\x{8E5E}\x{8E5F}\x{8E60}\x{8E61}\x{8E62}' . +'\x{8E63}\x{8E64}\x{8E65}\x{8E66}\x{8E67}\x{8E68}\x{8E69}\x{8E6A}\x{8E6B}' . +'\x{8E6C}\x{8E6D}\x{8E6F}\x{8E70}\x{8E71}\x{8E72}\x{8E73}\x{8E74}\x{8E76}' . +'\x{8E78}\x{8E7A}\x{8E7B}\x{8E7C}\x{8E7D}\x{8E7E}\x{8E7F}\x{8E80}\x{8E81}' . +'\x{8E82}\x{8E83}\x{8E84}\x{8E85}\x{8E86}\x{8E87}\x{8E88}\x{8E89}\x{8E8A}' . +'\x{8E8B}\x{8E8C}\x{8E8D}\x{8E8E}\x{8E8F}\x{8E90}\x{8E91}\x{8E92}\x{8E93}' . +'\x{8E94}\x{8E95}\x{8E96}\x{8E97}\x{8E98}\x{8E9A}\x{8E9C}\x{8E9D}\x{8E9E}' . +'\x{8E9F}\x{8EA0}\x{8EA1}\x{8EA3}\x{8EA4}\x{8EA5}\x{8EA6}\x{8EA7}\x{8EA8}' . +'\x{8EA9}\x{8EAA}\x{8EAB}\x{8EAC}\x{8EAD}\x{8EAE}\x{8EAF}\x{8EB0}\x{8EB1}' . +'\x{8EB2}\x{8EB4}\x{8EB5}\x{8EB8}\x{8EB9}\x{8EBA}\x{8EBB}\x{8EBC}\x{8EBD}' . +'\x{8EBE}\x{8EBF}\x{8EC0}\x{8EC2}\x{8EC3}\x{8EC5}\x{8EC6}\x{8EC7}\x{8EC8}' . +'\x{8EC9}\x{8ECA}\x{8ECB}\x{8ECC}\x{8ECD}\x{8ECE}\x{8ECF}\x{8ED0}\x{8ED1}' . +'\x{8ED2}\x{8ED3}\x{8ED4}\x{8ED5}\x{8ED6}\x{8ED7}\x{8ED8}\x{8EDA}\x{8EDB}' . +'\x{8EDC}\x{8EDD}\x{8EDE}\x{8EDF}\x{8EE0}\x{8EE1}\x{8EE4}\x{8EE5}\x{8EE6}' . +'\x{8EE7}\x{8EE8}\x{8EE9}\x{8EEA}\x{8EEB}\x{8EEC}\x{8EED}\x{8EEE}\x{8EEF}' . +'\x{8EF1}\x{8EF2}\x{8EF3}\x{8EF4}\x{8EF5}\x{8EF6}\x{8EF7}\x{8EF8}\x{8EF9}' . +'\x{8EFA}\x{8EFB}\x{8EFC}\x{8EFD}\x{8EFE}\x{8EFF}\x{8F00}\x{8F01}\x{8F02}' . +'\x{8F03}\x{8F04}\x{8F05}\x{8F06}\x{8F07}\x{8F08}\x{8F09}\x{8F0A}\x{8F0B}' . +'\x{8F0D}\x{8F0E}\x{8F10}\x{8F11}\x{8F12}\x{8F13}\x{8F14}\x{8F15}\x{8F16}' . +'\x{8F17}\x{8F18}\x{8F1A}\x{8F1B}\x{8F1C}\x{8F1D}\x{8F1E}\x{8F1F}\x{8F20}' . +'\x{8F21}\x{8F22}\x{8F23}\x{8F24}\x{8F25}\x{8F26}\x{8F27}\x{8F28}\x{8F29}' . +'\x{8F2A}\x{8F2B}\x{8F2C}\x{8F2E}\x{8F2F}\x{8F30}\x{8F31}\x{8F32}\x{8F33}' . +'\x{8F34}\x{8F35}\x{8F36}\x{8F37}\x{8F38}\x{8F39}\x{8F3B}\x{8F3C}\x{8F3D}' . +'\x{8F3E}\x{8F3F}\x{8F40}\x{8F42}\x{8F43}\x{8F44}\x{8F45}\x{8F46}\x{8F47}' . +'\x{8F48}\x{8F49}\x{8F4A}\x{8F4B}\x{8F4C}\x{8F4D}\x{8F4E}\x{8F4F}\x{8F50}' . +'\x{8F51}\x{8F52}\x{8F53}\x{8F54}\x{8F55}\x{8F56}\x{8F57}\x{8F58}\x{8F59}' . +'\x{8F5A}\x{8F5B}\x{8F5D}\x{8F5E}\x{8F5F}\x{8F60}\x{8F61}\x{8F62}\x{8F63}' . +'\x{8F64}\x{8F65}\x{8F66}\x{8F67}\x{8F68}\x{8F69}\x{8F6A}\x{8F6B}\x{8F6C}' . +'\x{8F6D}\x{8F6E}\x{8F6F}\x{8F70}\x{8F71}\x{8F72}\x{8F73}\x{8F74}\x{8F75}' . +'\x{8F76}\x{8F77}\x{8F78}\x{8F79}\x{8F7A}\x{8F7B}\x{8F7C}\x{8F7D}\x{8F7E}' . +'\x{8F7F}\x{8F80}\x{8F81}\x{8F82}\x{8F83}\x{8F84}\x{8F85}\x{8F86}\x{8F87}' . +'\x{8F88}\x{8F89}\x{8F8A}\x{8F8B}\x{8F8C}\x{8F8D}\x{8F8E}\x{8F8F}\x{8F90}' . +'\x{8F91}\x{8F92}\x{8F93}\x{8F94}\x{8F95}\x{8F96}\x{8F97}\x{8F98}\x{8F99}' . +'\x{8F9A}\x{8F9B}\x{8F9C}\x{8F9E}\x{8F9F}\x{8FA0}\x{8FA1}\x{8FA2}\x{8FA3}' . +'\x{8FA5}\x{8FA6}\x{8FA7}\x{8FA8}\x{8FA9}\x{8FAA}\x{8FAB}\x{8FAC}\x{8FAD}' . +'\x{8FAE}\x{8FAF}\x{8FB0}\x{8FB1}\x{8FB2}\x{8FB4}\x{8FB5}\x{8FB6}\x{8FB7}' . +'\x{8FB8}\x{8FB9}\x{8FBB}\x{8FBC}\x{8FBD}\x{8FBE}\x{8FBF}\x{8FC0}\x{8FC1}' . +'\x{8FC2}\x{8FC4}\x{8FC5}\x{8FC6}\x{8FC7}\x{8FC8}\x{8FC9}\x{8FCB}\x{8FCC}' . +'\x{8FCD}\x{8FCE}\x{8FCF}\x{8FD0}\x{8FD1}\x{8FD2}\x{8FD3}\x{8FD4}\x{8FD5}' . +'\x{8FD6}\x{8FD7}\x{8FD8}\x{8FD9}\x{8FDA}\x{8FDB}\x{8FDC}\x{8FDD}\x{8FDE}' . +'\x{8FDF}\x{8FE0}\x{8FE1}\x{8FE2}\x{8FE3}\x{8FE4}\x{8FE5}\x{8FE6}\x{8FE8}' . +'\x{8FE9}\x{8FEA}\x{8FEB}\x{8FEC}\x{8FED}\x{8FEE}\x{8FEF}\x{8FF0}\x{8FF1}' . +'\x{8FF2}\x{8FF3}\x{8FF4}\x{8FF5}\x{8FF6}\x{8FF7}\x{8FF8}\x{8FF9}\x{8FFA}' . +'\x{8FFB}\x{8FFC}\x{8FFD}\x{8FFE}\x{8FFF}\x{9000}\x{9001}\x{9002}\x{9003}' . +'\x{9004}\x{9005}\x{9006}\x{9007}\x{9008}\x{9009}\x{900A}\x{900B}\x{900C}' . +'\x{900D}\x{900F}\x{9010}\x{9011}\x{9012}\x{9013}\x{9014}\x{9015}\x{9016}' . +'\x{9017}\x{9018}\x{9019}\x{901A}\x{901B}\x{901C}\x{901D}\x{901E}\x{901F}' . +'\x{9020}\x{9021}\x{9022}\x{9023}\x{9024}\x{9025}\x{9026}\x{9027}\x{9028}' . +'\x{9029}\x{902B}\x{902D}\x{902E}\x{902F}\x{9030}\x{9031}\x{9032}\x{9033}' . +'\x{9034}\x{9035}\x{9036}\x{9038}\x{903A}\x{903B}\x{903C}\x{903D}\x{903E}' . +'\x{903F}\x{9041}\x{9042}\x{9043}\x{9044}\x{9045}\x{9047}\x{9048}\x{9049}' . +'\x{904A}\x{904B}\x{904C}\x{904D}\x{904E}\x{904F}\x{9050}\x{9051}\x{9052}' . +'\x{9053}\x{9054}\x{9055}\x{9056}\x{9057}\x{9058}\x{9059}\x{905A}\x{905B}' . +'\x{905C}\x{905D}\x{905E}\x{905F}\x{9060}\x{9061}\x{9062}\x{9063}\x{9064}' . +'\x{9065}\x{9066}\x{9067}\x{9068}\x{9069}\x{906A}\x{906B}\x{906C}\x{906D}' . +'\x{906E}\x{906F}\x{9070}\x{9071}\x{9072}\x{9073}\x{9074}\x{9075}\x{9076}' . +'\x{9077}\x{9078}\x{9079}\x{907A}\x{907B}\x{907C}\x{907D}\x{907E}\x{907F}' . +'\x{9080}\x{9081}\x{9082}\x{9083}\x{9084}\x{9085}\x{9086}\x{9087}\x{9088}' . +'\x{9089}\x{908A}\x{908B}\x{908C}\x{908D}\x{908E}\x{908F}\x{9090}\x{9091}' . +'\x{9092}\x{9093}\x{9094}\x{9095}\x{9096}\x{9097}\x{9098}\x{9099}\x{909A}' . +'\x{909B}\x{909C}\x{909D}\x{909E}\x{909F}\x{90A0}\x{90A1}\x{90A2}\x{90A3}' . +'\x{90A4}\x{90A5}\x{90A6}\x{90A7}\x{90A8}\x{90A9}\x{90AA}\x{90AC}\x{90AD}' . +'\x{90AE}\x{90AF}\x{90B0}\x{90B1}\x{90B2}\x{90B3}\x{90B4}\x{90B5}\x{90B6}' . +'\x{90B7}\x{90B8}\x{90B9}\x{90BA}\x{90BB}\x{90BC}\x{90BD}\x{90BE}\x{90BF}' . +'\x{90C0}\x{90C1}\x{90C2}\x{90C3}\x{90C4}\x{90C5}\x{90C6}\x{90C7}\x{90C8}' . +'\x{90C9}\x{90CA}\x{90CB}\x{90CE}\x{90CF}\x{90D0}\x{90D1}\x{90D3}\x{90D4}' . +'\x{90D5}\x{90D6}\x{90D7}\x{90D8}\x{90D9}\x{90DA}\x{90DB}\x{90DC}\x{90DD}' . +'\x{90DE}\x{90DF}\x{90E0}\x{90E1}\x{90E2}\x{90E3}\x{90E4}\x{90E5}\x{90E6}' . +'\x{90E7}\x{90E8}\x{90E9}\x{90EA}\x{90EB}\x{90EC}\x{90ED}\x{90EE}\x{90EF}' . +'\x{90F0}\x{90F1}\x{90F2}\x{90F3}\x{90F4}\x{90F5}\x{90F7}\x{90F8}\x{90F9}' . +'\x{90FA}\x{90FB}\x{90FC}\x{90FD}\x{90FE}\x{90FF}\x{9100}\x{9101}\x{9102}' . +'\x{9103}\x{9104}\x{9105}\x{9106}\x{9107}\x{9108}\x{9109}\x{910B}\x{910C}' . +'\x{910D}\x{910E}\x{910F}\x{9110}\x{9111}\x{9112}\x{9113}\x{9114}\x{9115}' . +'\x{9116}\x{9117}\x{9118}\x{9119}\x{911A}\x{911B}\x{911C}\x{911D}\x{911E}' . +'\x{911F}\x{9120}\x{9121}\x{9122}\x{9123}\x{9124}\x{9125}\x{9126}\x{9127}' . +'\x{9128}\x{9129}\x{912A}\x{912B}\x{912C}\x{912D}\x{912E}\x{912F}\x{9130}' . +'\x{9131}\x{9132}\x{9133}\x{9134}\x{9135}\x{9136}\x{9137}\x{9138}\x{9139}' . +'\x{913A}\x{913B}\x{913E}\x{913F}\x{9140}\x{9141}\x{9142}\x{9143}\x{9144}' . +'\x{9145}\x{9146}\x{9147}\x{9148}\x{9149}\x{914A}\x{914B}\x{914C}\x{914D}' . +'\x{914E}\x{914F}\x{9150}\x{9151}\x{9152}\x{9153}\x{9154}\x{9155}\x{9156}' . +'\x{9157}\x{9158}\x{915A}\x{915B}\x{915C}\x{915D}\x{915E}\x{915F}\x{9160}' . +'\x{9161}\x{9162}\x{9163}\x{9164}\x{9165}\x{9166}\x{9167}\x{9168}\x{9169}' . +'\x{916A}\x{916B}\x{916C}\x{916D}\x{916E}\x{916F}\x{9170}\x{9171}\x{9172}' . +'\x{9173}\x{9174}\x{9175}\x{9176}\x{9177}\x{9178}\x{9179}\x{917A}\x{917C}' . +'\x{917D}\x{917E}\x{917F}\x{9180}\x{9181}\x{9182}\x{9183}\x{9184}\x{9185}' . +'\x{9186}\x{9187}\x{9188}\x{9189}\x{918A}\x{918B}\x{918C}\x{918D}\x{918E}' . +'\x{918F}\x{9190}\x{9191}\x{9192}\x{9193}\x{9194}\x{9196}\x{9199}\x{919A}' . +'\x{919B}\x{919C}\x{919D}\x{919E}\x{919F}\x{91A0}\x{91A1}\x{91A2}\x{91A3}' . +'\x{91A5}\x{91A6}\x{91A7}\x{91A8}\x{91AA}\x{91AB}\x{91AC}\x{91AD}\x{91AE}' . +'\x{91AF}\x{91B0}\x{91B1}\x{91B2}\x{91B3}\x{91B4}\x{91B5}\x{91B6}\x{91B7}' . +'\x{91B9}\x{91BA}\x{91BB}\x{91BC}\x{91BD}\x{91BE}\x{91C0}\x{91C1}\x{91C2}' . +'\x{91C3}\x{91C5}\x{91C6}\x{91C7}\x{91C9}\x{91CA}\x{91CB}\x{91CC}\x{91CD}' . +'\x{91CE}\x{91CF}\x{91D0}\x{91D1}\x{91D2}\x{91D3}\x{91D4}\x{91D5}\x{91D7}' . +'\x{91D8}\x{91D9}\x{91DA}\x{91DB}\x{91DC}\x{91DD}\x{91DE}\x{91DF}\x{91E2}' . +'\x{91E3}\x{91E4}\x{91E5}\x{91E6}\x{91E7}\x{91E8}\x{91E9}\x{91EA}\x{91EB}' . +'\x{91EC}\x{91ED}\x{91EE}\x{91F0}\x{91F1}\x{91F2}\x{91F3}\x{91F4}\x{91F5}' . +'\x{91F7}\x{91F8}\x{91F9}\x{91FA}\x{91FB}\x{91FD}\x{91FE}\x{91FF}\x{9200}' . +'\x{9201}\x{9202}\x{9203}\x{9204}\x{9205}\x{9206}\x{9207}\x{9208}\x{9209}' . +'\x{920A}\x{920B}\x{920C}\x{920D}\x{920E}\x{920F}\x{9210}\x{9211}\x{9212}' . +'\x{9214}\x{9215}\x{9216}\x{9217}\x{9218}\x{9219}\x{921A}\x{921B}\x{921C}' . +'\x{921D}\x{921E}\x{9220}\x{9221}\x{9223}\x{9224}\x{9225}\x{9226}\x{9227}' . +'\x{9228}\x{9229}\x{922A}\x{922B}\x{922D}\x{922E}\x{922F}\x{9230}\x{9231}' . +'\x{9232}\x{9233}\x{9234}\x{9235}\x{9236}\x{9237}\x{9238}\x{9239}\x{923A}' . +'\x{923B}\x{923C}\x{923D}\x{923E}\x{923F}\x{9240}\x{9241}\x{9242}\x{9245}' . +'\x{9246}\x{9247}\x{9248}\x{9249}\x{924A}\x{924B}\x{924C}\x{924D}\x{924E}' . +'\x{924F}\x{9250}\x{9251}\x{9252}\x{9253}\x{9254}\x{9255}\x{9256}\x{9257}' . +'\x{9258}\x{9259}\x{925A}\x{925B}\x{925C}\x{925D}\x{925E}\x{925F}\x{9260}' . +'\x{9261}\x{9262}\x{9263}\x{9264}\x{9265}\x{9266}\x{9267}\x{9268}\x{926B}' . +'\x{926C}\x{926D}\x{926E}\x{926F}\x{9270}\x{9272}\x{9273}\x{9274}\x{9275}' . +'\x{9276}\x{9277}\x{9278}\x{9279}\x{927A}\x{927B}\x{927C}\x{927D}\x{927E}' . +'\x{927F}\x{9280}\x{9282}\x{9283}\x{9285}\x{9286}\x{9287}\x{9288}\x{9289}' . +'\x{928A}\x{928B}\x{928C}\x{928D}\x{928E}\x{928F}\x{9290}\x{9291}\x{9292}' . +'\x{9293}\x{9294}\x{9295}\x{9296}\x{9297}\x{9298}\x{9299}\x{929A}\x{929B}' . +'\x{929C}\x{929D}\x{929F}\x{92A0}\x{92A1}\x{92A2}\x{92A3}\x{92A4}\x{92A5}' . +'\x{92A6}\x{92A7}\x{92A8}\x{92A9}\x{92AA}\x{92AB}\x{92AC}\x{92AD}\x{92AE}' . +'\x{92AF}\x{92B0}\x{92B1}\x{92B2}\x{92B3}\x{92B4}\x{92B5}\x{92B6}\x{92B7}' . +'\x{92B8}\x{92B9}\x{92BA}\x{92BB}\x{92BC}\x{92BE}\x{92BF}\x{92C0}\x{92C1}' . +'\x{92C2}\x{92C3}\x{92C4}\x{92C5}\x{92C6}\x{92C7}\x{92C8}\x{92C9}\x{92CA}' . +'\x{92CB}\x{92CC}\x{92CD}\x{92CE}\x{92CF}\x{92D0}\x{92D1}\x{92D2}\x{92D3}' . +'\x{92D5}\x{92D6}\x{92D7}\x{92D8}\x{92D9}\x{92DA}\x{92DC}\x{92DD}\x{92DE}' . +'\x{92DF}\x{92E0}\x{92E1}\x{92E3}\x{92E4}\x{92E5}\x{92E6}\x{92E7}\x{92E8}' . +'\x{92E9}\x{92EA}\x{92EB}\x{92EC}\x{92ED}\x{92EE}\x{92EF}\x{92F0}\x{92F1}' . +'\x{92F2}\x{92F3}\x{92F4}\x{92F5}\x{92F6}\x{92F7}\x{92F8}\x{92F9}\x{92FA}' . +'\x{92FB}\x{92FC}\x{92FD}\x{92FE}\x{92FF}\x{9300}\x{9301}\x{9302}\x{9303}' . +'\x{9304}\x{9305}\x{9306}\x{9307}\x{9308}\x{9309}\x{930A}\x{930B}\x{930C}' . +'\x{930D}\x{930E}\x{930F}\x{9310}\x{9311}\x{9312}\x{9313}\x{9314}\x{9315}' . +'\x{9316}\x{9317}\x{9318}\x{9319}\x{931A}\x{931B}\x{931D}\x{931E}\x{931F}' . +'\x{9320}\x{9321}\x{9322}\x{9323}\x{9324}\x{9325}\x{9326}\x{9327}\x{9328}' . +'\x{9329}\x{932A}\x{932B}\x{932D}\x{932E}\x{932F}\x{9332}\x{9333}\x{9334}' . +'\x{9335}\x{9336}\x{9337}\x{9338}\x{9339}\x{933A}\x{933B}\x{933C}\x{933D}' . +'\x{933E}\x{933F}\x{9340}\x{9341}\x{9342}\x{9343}\x{9344}\x{9345}\x{9346}' . +'\x{9347}\x{9348}\x{9349}\x{934A}\x{934B}\x{934C}\x{934D}\x{934E}\x{934F}' . +'\x{9350}\x{9351}\x{9352}\x{9353}\x{9354}\x{9355}\x{9356}\x{9357}\x{9358}' . +'\x{9359}\x{935A}\x{935B}\x{935C}\x{935D}\x{935E}\x{935F}\x{9360}\x{9361}' . +'\x{9363}\x{9364}\x{9365}\x{9366}\x{9367}\x{9369}\x{936A}\x{936C}\x{936D}' . +'\x{936E}\x{9370}\x{9371}\x{9372}\x{9374}\x{9375}\x{9376}\x{9377}\x{9379}' . +'\x{937A}\x{937B}\x{937C}\x{937D}\x{937E}\x{9380}\x{9382}\x{9383}\x{9384}' . +'\x{9385}\x{9386}\x{9387}\x{9388}\x{9389}\x{938A}\x{938C}\x{938D}\x{938E}' . +'\x{938F}\x{9390}\x{9391}\x{9392}\x{9393}\x{9394}\x{9395}\x{9396}\x{9397}' . +'\x{9398}\x{9399}\x{939A}\x{939B}\x{939D}\x{939E}\x{939F}\x{93A1}\x{93A2}' . +'\x{93A3}\x{93A4}\x{93A5}\x{93A6}\x{93A7}\x{93A8}\x{93A9}\x{93AA}\x{93AC}' . +'\x{93AD}\x{93AE}\x{93AF}\x{93B0}\x{93B1}\x{93B2}\x{93B3}\x{93B4}\x{93B5}' . +'\x{93B6}\x{93B7}\x{93B8}\x{93B9}\x{93BA}\x{93BC}\x{93BD}\x{93BE}\x{93BF}' . +'\x{93C0}\x{93C1}\x{93C2}\x{93C3}\x{93C4}\x{93C5}\x{93C6}\x{93C7}\x{93C8}' . +'\x{93C9}\x{93CA}\x{93CB}\x{93CC}\x{93CD}\x{93CE}\x{93CF}\x{93D0}\x{93D1}' . +'\x{93D2}\x{93D3}\x{93D4}\x{93D5}\x{93D6}\x{93D7}\x{93D8}\x{93D9}\x{93DA}' . +'\x{93DB}\x{93DC}\x{93DD}\x{93DE}\x{93DF}\x{93E1}\x{93E2}\x{93E3}\x{93E4}' . +'\x{93E6}\x{93E7}\x{93E8}\x{93E9}\x{93EA}\x{93EB}\x{93EC}\x{93ED}\x{93EE}' . +'\x{93EF}\x{93F0}\x{93F1}\x{93F2}\x{93F4}\x{93F5}\x{93F6}\x{93F7}\x{93F8}' . +'\x{93F9}\x{93FA}\x{93FB}\x{93FC}\x{93FD}\x{93FE}\x{93FF}\x{9400}\x{9401}' . +'\x{9403}\x{9404}\x{9405}\x{9406}\x{9407}\x{9408}\x{9409}\x{940A}\x{940B}' . +'\x{940C}\x{940D}\x{940E}\x{940F}\x{9410}\x{9411}\x{9412}\x{9413}\x{9414}' . +'\x{9415}\x{9416}\x{9418}\x{9419}\x{941B}\x{941D}\x{9420}\x{9422}\x{9423}' . +'\x{9425}\x{9426}\x{9427}\x{9428}\x{9429}\x{942A}\x{942B}\x{942C}\x{942D}' . +'\x{942E}\x{942F}\x{9430}\x{9431}\x{9432}\x{9433}\x{9434}\x{9435}\x{9436}' . +'\x{9437}\x{9438}\x{9439}\x{943A}\x{943B}\x{943C}\x{943D}\x{943E}\x{943F}' . +'\x{9440}\x{9441}\x{9442}\x{9444}\x{9445}\x{9446}\x{9447}\x{9448}\x{9449}' . +'\x{944A}\x{944B}\x{944C}\x{944D}\x{944F}\x{9450}\x{9451}\x{9452}\x{9453}' . +'\x{9454}\x{9455}\x{9456}\x{9457}\x{9458}\x{9459}\x{945B}\x{945C}\x{945D}' . +'\x{945E}\x{945F}\x{9460}\x{9461}\x{9462}\x{9463}\x{9464}\x{9465}\x{9466}' . +'\x{9467}\x{9468}\x{9469}\x{946A}\x{946B}\x{946D}\x{946E}\x{946F}\x{9470}' . +'\x{9471}\x{9472}\x{9473}\x{9474}\x{9475}\x{9476}\x{9477}\x{9478}\x{9479}' . +'\x{947A}\x{947C}\x{947D}\x{947E}\x{947F}\x{9480}\x{9481}\x{9482}\x{9483}' . +'\x{9484}\x{9485}\x{9486}\x{9487}\x{9488}\x{9489}\x{948A}\x{948B}\x{948C}' . +'\x{948D}\x{948E}\x{948F}\x{9490}\x{9491}\x{9492}\x{9493}\x{9494}\x{9495}' . +'\x{9496}\x{9497}\x{9498}\x{9499}\x{949A}\x{949B}\x{949C}\x{949D}\x{949E}' . +'\x{949F}\x{94A0}\x{94A1}\x{94A2}\x{94A3}\x{94A4}\x{94A5}\x{94A6}\x{94A7}' . +'\x{94A8}\x{94A9}\x{94AA}\x{94AB}\x{94AC}\x{94AD}\x{94AE}\x{94AF}\x{94B0}' . +'\x{94B1}\x{94B2}\x{94B3}\x{94B4}\x{94B5}\x{94B6}\x{94B7}\x{94B8}\x{94B9}' . +'\x{94BA}\x{94BB}\x{94BC}\x{94BD}\x{94BE}\x{94BF}\x{94C0}\x{94C1}\x{94C2}' . +'\x{94C3}\x{94C4}\x{94C5}\x{94C6}\x{94C7}\x{94C8}\x{94C9}\x{94CA}\x{94CB}' . +'\x{94CC}\x{94CD}\x{94CE}\x{94CF}\x{94D0}\x{94D1}\x{94D2}\x{94D3}\x{94D4}' . +'\x{94D5}\x{94D6}\x{94D7}\x{94D8}\x{94D9}\x{94DA}\x{94DB}\x{94DC}\x{94DD}' . +'\x{94DE}\x{94DF}\x{94E0}\x{94E1}\x{94E2}\x{94E3}\x{94E4}\x{94E5}\x{94E6}' . +'\x{94E7}\x{94E8}\x{94E9}\x{94EA}\x{94EB}\x{94EC}\x{94ED}\x{94EE}\x{94EF}' . +'\x{94F0}\x{94F1}\x{94F2}\x{94F3}\x{94F4}\x{94F5}\x{94F6}\x{94F7}\x{94F8}' . +'\x{94F9}\x{94FA}\x{94FB}\x{94FC}\x{94FD}\x{94FE}\x{94FF}\x{9500}\x{9501}' . +'\x{9502}\x{9503}\x{9504}\x{9505}\x{9506}\x{9507}\x{9508}\x{9509}\x{950A}' . +'\x{950B}\x{950C}\x{950D}\x{950E}\x{950F}\x{9510}\x{9511}\x{9512}\x{9513}' . +'\x{9514}\x{9515}\x{9516}\x{9517}\x{9518}\x{9519}\x{951A}\x{951B}\x{951C}' . +'\x{951D}\x{951E}\x{951F}\x{9520}\x{9521}\x{9522}\x{9523}\x{9524}\x{9525}' . +'\x{9526}\x{9527}\x{9528}\x{9529}\x{952A}\x{952B}\x{952C}\x{952D}\x{952E}' . +'\x{952F}\x{9530}\x{9531}\x{9532}\x{9533}\x{9534}\x{9535}\x{9536}\x{9537}' . +'\x{9538}\x{9539}\x{953A}\x{953B}\x{953C}\x{953D}\x{953E}\x{953F}\x{9540}' . +'\x{9541}\x{9542}\x{9543}\x{9544}\x{9545}\x{9546}\x{9547}\x{9548}\x{9549}' . +'\x{954A}\x{954B}\x{954C}\x{954D}\x{954E}\x{954F}\x{9550}\x{9551}\x{9552}' . +'\x{9553}\x{9554}\x{9555}\x{9556}\x{9557}\x{9558}\x{9559}\x{955A}\x{955B}' . +'\x{955C}\x{955D}\x{955E}\x{955F}\x{9560}\x{9561}\x{9562}\x{9563}\x{9564}' . +'\x{9565}\x{9566}\x{9567}\x{9568}\x{9569}\x{956A}\x{956B}\x{956C}\x{956D}' . +'\x{956E}\x{956F}\x{9570}\x{9571}\x{9572}\x{9573}\x{9574}\x{9575}\x{9576}' . +'\x{9577}\x{957A}\x{957B}\x{957C}\x{957D}\x{957F}\x{9580}\x{9581}\x{9582}' . +'\x{9583}\x{9584}\x{9586}\x{9587}\x{9588}\x{9589}\x{958A}\x{958B}\x{958C}' . +'\x{958D}\x{958E}\x{958F}\x{9590}\x{9591}\x{9592}\x{9593}\x{9594}\x{9595}' . +'\x{9596}\x{9598}\x{9599}\x{959A}\x{959B}\x{959C}\x{959D}\x{959E}\x{959F}' . +'\x{95A1}\x{95A2}\x{95A3}\x{95A4}\x{95A5}\x{95A6}\x{95A7}\x{95A8}\x{95A9}' . +'\x{95AA}\x{95AB}\x{95AC}\x{95AD}\x{95AE}\x{95AF}\x{95B0}\x{95B1}\x{95B2}' . +'\x{95B5}\x{95B6}\x{95B7}\x{95B9}\x{95BA}\x{95BB}\x{95BC}\x{95BD}\x{95BE}' . +'\x{95BF}\x{95C0}\x{95C2}\x{95C3}\x{95C4}\x{95C5}\x{95C6}\x{95C7}\x{95C8}' . +'\x{95C9}\x{95CA}\x{95CB}\x{95CC}\x{95CD}\x{95CE}\x{95CF}\x{95D0}\x{95D1}' . +'\x{95D2}\x{95D3}\x{95D4}\x{95D5}\x{95D6}\x{95D7}\x{95D8}\x{95DA}\x{95DB}' . +'\x{95DC}\x{95DE}\x{95DF}\x{95E0}\x{95E1}\x{95E2}\x{95E3}\x{95E4}\x{95E5}' . +'\x{95E6}\x{95E7}\x{95E8}\x{95E9}\x{95EA}\x{95EB}\x{95EC}\x{95ED}\x{95EE}' . +'\x{95EF}\x{95F0}\x{95F1}\x{95F2}\x{95F3}\x{95F4}\x{95F5}\x{95F6}\x{95F7}' . +'\x{95F8}\x{95F9}\x{95FA}\x{95FB}\x{95FC}\x{95FD}\x{95FE}\x{95FF}\x{9600}' . +'\x{9601}\x{9602}\x{9603}\x{9604}\x{9605}\x{9606}\x{9607}\x{9608}\x{9609}' . +'\x{960A}\x{960B}\x{960C}\x{960D}\x{960E}\x{960F}\x{9610}\x{9611}\x{9612}' . +'\x{9613}\x{9614}\x{9615}\x{9616}\x{9617}\x{9618}\x{9619}\x{961A}\x{961B}' . +'\x{961C}\x{961D}\x{961E}\x{961F}\x{9620}\x{9621}\x{9622}\x{9623}\x{9624}' . +'\x{9627}\x{9628}\x{962A}\x{962B}\x{962C}\x{962D}\x{962E}\x{962F}\x{9630}' . +'\x{9631}\x{9632}\x{9633}\x{9634}\x{9635}\x{9636}\x{9637}\x{9638}\x{9639}' . +'\x{963A}\x{963B}\x{963C}\x{963D}\x{963F}\x{9640}\x{9641}\x{9642}\x{9643}' . +'\x{9644}\x{9645}\x{9646}\x{9647}\x{9648}\x{9649}\x{964A}\x{964B}\x{964C}' . +'\x{964D}\x{964E}\x{964F}\x{9650}\x{9651}\x{9652}\x{9653}\x{9654}\x{9655}' . +'\x{9658}\x{9659}\x{965A}\x{965B}\x{965C}\x{965D}\x{965E}\x{965F}\x{9660}' . +'\x{9661}\x{9662}\x{9663}\x{9664}\x{9666}\x{9667}\x{9668}\x{9669}\x{966A}' . +'\x{966B}\x{966C}\x{966D}\x{966E}\x{966F}\x{9670}\x{9671}\x{9672}\x{9673}' . +'\x{9674}\x{9675}\x{9676}\x{9677}\x{9678}\x{967C}\x{967D}\x{967E}\x{9680}' . +'\x{9683}\x{9684}\x{9685}\x{9686}\x{9687}\x{9688}\x{9689}\x{968A}\x{968B}' . +'\x{968D}\x{968E}\x{968F}\x{9690}\x{9691}\x{9692}\x{9693}\x{9694}\x{9695}' . +'\x{9697}\x{9698}\x{9699}\x{969B}\x{969C}\x{969E}\x{96A0}\x{96A1}\x{96A2}' . +'\x{96A3}\x{96A4}\x{96A5}\x{96A6}\x{96A7}\x{96A8}\x{96A9}\x{96AA}\x{96AC}' . +'\x{96AD}\x{96AE}\x{96B0}\x{96B1}\x{96B3}\x{96B4}\x{96B6}\x{96B7}\x{96B8}' . +'\x{96B9}\x{96BA}\x{96BB}\x{96BC}\x{96BD}\x{96BE}\x{96BF}\x{96C0}\x{96C1}' . +'\x{96C2}\x{96C3}\x{96C4}\x{96C5}\x{96C6}\x{96C7}\x{96C8}\x{96C9}\x{96CA}' . +'\x{96CB}\x{96CC}\x{96CD}\x{96CE}\x{96CF}\x{96D0}\x{96D1}\x{96D2}\x{96D3}' . +'\x{96D4}\x{96D5}\x{96D6}\x{96D7}\x{96D8}\x{96D9}\x{96DA}\x{96DB}\x{96DC}' . +'\x{96DD}\x{96DE}\x{96DF}\x{96E0}\x{96E1}\x{96E2}\x{96E3}\x{96E5}\x{96E8}' . +'\x{96E9}\x{96EA}\x{96EB}\x{96EC}\x{96ED}\x{96EE}\x{96EF}\x{96F0}\x{96F1}' . +'\x{96F2}\x{96F3}\x{96F4}\x{96F5}\x{96F6}\x{96F7}\x{96F8}\x{96F9}\x{96FA}' . +'\x{96FB}\x{96FD}\x{96FE}\x{96FF}\x{9700}\x{9701}\x{9702}\x{9703}\x{9704}' . +'\x{9705}\x{9706}\x{9707}\x{9708}\x{9709}\x{970A}\x{970B}\x{970C}\x{970D}' . +'\x{970E}\x{970F}\x{9710}\x{9711}\x{9712}\x{9713}\x{9715}\x{9716}\x{9718}' . +'\x{9719}\x{971C}\x{971D}\x{971E}\x{971F}\x{9720}\x{9721}\x{9722}\x{9723}' . +'\x{9724}\x{9725}\x{9726}\x{9727}\x{9728}\x{9729}\x{972A}\x{972B}\x{972C}' . +'\x{972D}\x{972E}\x{972F}\x{9730}\x{9731}\x{9732}\x{9735}\x{9736}\x{9738}' . +'\x{9739}\x{973A}\x{973B}\x{973C}\x{973D}\x{973E}\x{973F}\x{9742}\x{9743}' . +'\x{9744}\x{9745}\x{9746}\x{9747}\x{9748}\x{9749}\x{974A}\x{974B}\x{974C}' . +'\x{974E}\x{974F}\x{9750}\x{9751}\x{9752}\x{9753}\x{9754}\x{9755}\x{9756}' . +'\x{9758}\x{9759}\x{975A}\x{975B}\x{975C}\x{975D}\x{975E}\x{975F}\x{9760}' . +'\x{9761}\x{9762}\x{9765}\x{9766}\x{9767}\x{9768}\x{9769}\x{976A}\x{976B}' . +'\x{976C}\x{976D}\x{976E}\x{976F}\x{9770}\x{9772}\x{9773}\x{9774}\x{9776}' . +'\x{9777}\x{9778}\x{9779}\x{977A}\x{977B}\x{977C}\x{977D}\x{977E}\x{977F}' . +'\x{9780}\x{9781}\x{9782}\x{9783}\x{9784}\x{9785}\x{9786}\x{9788}\x{978A}' . +'\x{978B}\x{978C}\x{978D}\x{978E}\x{978F}\x{9790}\x{9791}\x{9792}\x{9793}' . +'\x{9794}\x{9795}\x{9796}\x{9797}\x{9798}\x{9799}\x{979A}\x{979C}\x{979D}' . +'\x{979E}\x{979F}\x{97A0}\x{97A1}\x{97A2}\x{97A3}\x{97A4}\x{97A5}\x{97A6}' . +'\x{97A7}\x{97A8}\x{97AA}\x{97AB}\x{97AC}\x{97AD}\x{97AE}\x{97AF}\x{97B2}' . +'\x{97B3}\x{97B4}\x{97B6}\x{97B7}\x{97B8}\x{97B9}\x{97BA}\x{97BB}\x{97BC}' . +'\x{97BD}\x{97BF}\x{97C1}\x{97C2}\x{97C3}\x{97C4}\x{97C5}\x{97C6}\x{97C7}' . +'\x{97C8}\x{97C9}\x{97CA}\x{97CB}\x{97CC}\x{97CD}\x{97CE}\x{97CF}\x{97D0}' . +'\x{97D1}\x{97D3}\x{97D4}\x{97D5}\x{97D6}\x{97D7}\x{97D8}\x{97D9}\x{97DA}' . +'\x{97DB}\x{97DC}\x{97DD}\x{97DE}\x{97DF}\x{97E0}\x{97E1}\x{97E2}\x{97E3}' . +'\x{97E4}\x{97E5}\x{97E6}\x{97E7}\x{97E8}\x{97E9}\x{97EA}\x{97EB}\x{97EC}' . +'\x{97ED}\x{97EE}\x{97EF}\x{97F0}\x{97F1}\x{97F2}\x{97F3}\x{97F4}\x{97F5}' . +'\x{97F6}\x{97F7}\x{97F8}\x{97F9}\x{97FA}\x{97FB}\x{97FD}\x{97FE}\x{97FF}' . +'\x{9800}\x{9801}\x{9802}\x{9803}\x{9804}\x{9805}\x{9806}\x{9807}\x{9808}' . +'\x{9809}\x{980A}\x{980B}\x{980C}\x{980D}\x{980E}\x{980F}\x{9810}\x{9811}' . +'\x{9812}\x{9813}\x{9814}\x{9815}\x{9816}\x{9817}\x{9818}\x{9819}\x{981A}' . +'\x{981B}\x{981C}\x{981D}\x{981E}\x{9820}\x{9821}\x{9822}\x{9823}\x{9824}' . +'\x{9826}\x{9827}\x{9828}\x{9829}\x{982B}\x{982D}\x{982E}\x{982F}\x{9830}' . +'\x{9831}\x{9832}\x{9834}\x{9835}\x{9836}\x{9837}\x{9838}\x{9839}\x{983B}' . +'\x{983C}\x{983D}\x{983F}\x{9840}\x{9841}\x{9843}\x{9844}\x{9845}\x{9846}' . +'\x{9848}\x{9849}\x{984A}\x{984C}\x{984D}\x{984E}\x{984F}\x{9850}\x{9851}' . +'\x{9852}\x{9853}\x{9854}\x{9855}\x{9857}\x{9858}\x{9859}\x{985A}\x{985B}' . +'\x{985C}\x{985D}\x{985E}\x{985F}\x{9860}\x{9861}\x{9862}\x{9863}\x{9864}' . +'\x{9865}\x{9867}\x{9869}\x{986A}\x{986B}\x{986C}\x{986D}\x{986E}\x{986F}' . +'\x{9870}\x{9871}\x{9872}\x{9873}\x{9874}\x{9875}\x{9876}\x{9877}\x{9878}' . +'\x{9879}\x{987A}\x{987B}\x{987C}\x{987D}\x{987E}\x{987F}\x{9880}\x{9881}' . +'\x{9882}\x{9883}\x{9884}\x{9885}\x{9886}\x{9887}\x{9888}\x{9889}\x{988A}' . +'\x{988B}\x{988C}\x{988D}\x{988E}\x{988F}\x{9890}\x{9891}\x{9892}\x{9893}' . +'\x{9894}\x{9895}\x{9896}\x{9897}\x{9898}\x{9899}\x{989A}\x{989B}\x{989C}' . +'\x{989D}\x{989E}\x{989F}\x{98A0}\x{98A1}\x{98A2}\x{98A3}\x{98A4}\x{98A5}' . +'\x{98A6}\x{98A7}\x{98A8}\x{98A9}\x{98AA}\x{98AB}\x{98AC}\x{98AD}\x{98AE}' . +'\x{98AF}\x{98B0}\x{98B1}\x{98B2}\x{98B3}\x{98B4}\x{98B5}\x{98B6}\x{98B8}' . +'\x{98B9}\x{98BA}\x{98BB}\x{98BC}\x{98BD}\x{98BE}\x{98BF}\x{98C0}\x{98C1}' . +'\x{98C2}\x{98C3}\x{98C4}\x{98C5}\x{98C6}\x{98C8}\x{98C9}\x{98CB}\x{98CC}' . +'\x{98CD}\x{98CE}\x{98CF}\x{98D0}\x{98D1}\x{98D2}\x{98D3}\x{98D4}\x{98D5}' . +'\x{98D6}\x{98D7}\x{98D8}\x{98D9}\x{98DA}\x{98DB}\x{98DC}\x{98DD}\x{98DE}' . +'\x{98DF}\x{98E0}\x{98E2}\x{98E3}\x{98E5}\x{98E6}\x{98E7}\x{98E8}\x{98E9}' . +'\x{98EA}\x{98EB}\x{98ED}\x{98EF}\x{98F0}\x{98F2}\x{98F3}\x{98F4}\x{98F5}' . +'\x{98F6}\x{98F7}\x{98F9}\x{98FA}\x{98FC}\x{98FD}\x{98FE}\x{98FF}\x{9900}' . +'\x{9901}\x{9902}\x{9903}\x{9904}\x{9905}\x{9906}\x{9907}\x{9908}\x{9909}' . +'\x{990A}\x{990B}\x{990C}\x{990D}\x{990E}\x{990F}\x{9910}\x{9911}\x{9912}' . +'\x{9913}\x{9914}\x{9915}\x{9916}\x{9917}\x{9918}\x{991A}\x{991B}\x{991C}' . +'\x{991D}\x{991E}\x{991F}\x{9920}\x{9921}\x{9922}\x{9923}\x{9924}\x{9925}' . +'\x{9926}\x{9927}\x{9928}\x{9929}\x{992A}\x{992B}\x{992C}\x{992D}\x{992E}' . +'\x{992F}\x{9930}\x{9931}\x{9932}\x{9933}\x{9934}\x{9935}\x{9936}\x{9937}' . +'\x{9938}\x{9939}\x{993A}\x{993C}\x{993D}\x{993E}\x{993F}\x{9940}\x{9941}' . +'\x{9942}\x{9943}\x{9945}\x{9946}\x{9947}\x{9948}\x{9949}\x{994A}\x{994B}' . +'\x{994C}\x{994E}\x{994F}\x{9950}\x{9951}\x{9952}\x{9953}\x{9954}\x{9955}' . +'\x{9956}\x{9957}\x{9958}\x{9959}\x{995B}\x{995C}\x{995E}\x{995F}\x{9960}' . +'\x{9961}\x{9962}\x{9963}\x{9964}\x{9965}\x{9966}\x{9967}\x{9968}\x{9969}' . +'\x{996A}\x{996B}\x{996C}\x{996D}\x{996E}\x{996F}\x{9970}\x{9971}\x{9972}' . +'\x{9973}\x{9974}\x{9975}\x{9976}\x{9977}\x{9978}\x{9979}\x{997A}\x{997B}' . +'\x{997C}\x{997D}\x{997E}\x{997F}\x{9980}\x{9981}\x{9982}\x{9983}\x{9984}' . +'\x{9985}\x{9986}\x{9987}\x{9988}\x{9989}\x{998A}\x{998B}\x{998C}\x{998D}' . +'\x{998E}\x{998F}\x{9990}\x{9991}\x{9992}\x{9993}\x{9994}\x{9995}\x{9996}' . +'\x{9997}\x{9998}\x{9999}\x{999A}\x{999B}\x{999C}\x{999D}\x{999E}\x{999F}' . +'\x{99A0}\x{99A1}\x{99A2}\x{99A3}\x{99A4}\x{99A5}\x{99A6}\x{99A7}\x{99A8}' . +'\x{99A9}\x{99AA}\x{99AB}\x{99AC}\x{99AD}\x{99AE}\x{99AF}\x{99B0}\x{99B1}' . +'\x{99B2}\x{99B3}\x{99B4}\x{99B5}\x{99B6}\x{99B7}\x{99B8}\x{99B9}\x{99BA}' . +'\x{99BB}\x{99BC}\x{99BD}\x{99BE}\x{99C0}\x{99C1}\x{99C2}\x{99C3}\x{99C4}' . +'\x{99C6}\x{99C7}\x{99C8}\x{99C9}\x{99CA}\x{99CB}\x{99CC}\x{99CD}\x{99CE}' . +'\x{99CF}\x{99D0}\x{99D1}\x{99D2}\x{99D3}\x{99D4}\x{99D5}\x{99D6}\x{99D7}' . +'\x{99D8}\x{99D9}\x{99DA}\x{99DB}\x{99DC}\x{99DD}\x{99DE}\x{99DF}\x{99E1}' . +'\x{99E2}\x{99E3}\x{99E4}\x{99E5}\x{99E7}\x{99E8}\x{99E9}\x{99EA}\x{99EC}' . +'\x{99ED}\x{99EE}\x{99EF}\x{99F0}\x{99F1}\x{99F2}\x{99F3}\x{99F4}\x{99F6}' . +'\x{99F7}\x{99F8}\x{99F9}\x{99FA}\x{99FB}\x{99FC}\x{99FD}\x{99FE}\x{99FF}' . +'\x{9A00}\x{9A01}\x{9A02}\x{9A03}\x{9A04}\x{9A05}\x{9A06}\x{9A07}\x{9A08}' . +'\x{9A09}\x{9A0A}\x{9A0B}\x{9A0C}\x{9A0D}\x{9A0E}\x{9A0F}\x{9A11}\x{9A14}' . +'\x{9A15}\x{9A16}\x{9A19}\x{9A1A}\x{9A1B}\x{9A1C}\x{9A1D}\x{9A1E}\x{9A1F}' . +'\x{9A20}\x{9A21}\x{9A22}\x{9A23}\x{9A24}\x{9A25}\x{9A26}\x{9A27}\x{9A29}' . +'\x{9A2A}\x{9A2B}\x{9A2C}\x{9A2D}\x{9A2E}\x{9A2F}\x{9A30}\x{9A31}\x{9A32}' . +'\x{9A33}\x{9A34}\x{9A35}\x{9A36}\x{9A37}\x{9A38}\x{9A39}\x{9A3A}\x{9A3C}' . +'\x{9A3D}\x{9A3E}\x{9A3F}\x{9A40}\x{9A41}\x{9A42}\x{9A43}\x{9A44}\x{9A45}' . +'\x{9A46}\x{9A47}\x{9A48}\x{9A49}\x{9A4A}\x{9A4B}\x{9A4C}\x{9A4D}\x{9A4E}' . +'\x{9A4F}\x{9A50}\x{9A52}\x{9A53}\x{9A54}\x{9A55}\x{9A56}\x{9A57}\x{9A59}' . +'\x{9A5A}\x{9A5B}\x{9A5C}\x{9A5E}\x{9A5F}\x{9A60}\x{9A61}\x{9A62}\x{9A64}' . +'\x{9A65}\x{9A66}\x{9A67}\x{9A68}\x{9A69}\x{9A6A}\x{9A6B}\x{9A6C}\x{9A6D}' . +'\x{9A6E}\x{9A6F}\x{9A70}\x{9A71}\x{9A72}\x{9A73}\x{9A74}\x{9A75}\x{9A76}' . +'\x{9A77}\x{9A78}\x{9A79}\x{9A7A}\x{9A7B}\x{9A7C}\x{9A7D}\x{9A7E}\x{9A7F}' . +'\x{9A80}\x{9A81}\x{9A82}\x{9A83}\x{9A84}\x{9A85}\x{9A86}\x{9A87}\x{9A88}' . +'\x{9A89}\x{9A8A}\x{9A8B}\x{9A8C}\x{9A8D}\x{9A8E}\x{9A8F}\x{9A90}\x{9A91}' . +'\x{9A92}\x{9A93}\x{9A94}\x{9A95}\x{9A96}\x{9A97}\x{9A98}\x{9A99}\x{9A9A}' . +'\x{9A9B}\x{9A9C}\x{9A9D}\x{9A9E}\x{9A9F}\x{9AA0}\x{9AA1}\x{9AA2}\x{9AA3}' . +'\x{9AA4}\x{9AA5}\x{9AA6}\x{9AA7}\x{9AA8}\x{9AAA}\x{9AAB}\x{9AAC}\x{9AAD}' . +'\x{9AAE}\x{9AAF}\x{9AB0}\x{9AB1}\x{9AB2}\x{9AB3}\x{9AB4}\x{9AB5}\x{9AB6}' . +'\x{9AB7}\x{9AB8}\x{9AB9}\x{9ABA}\x{9ABB}\x{9ABC}\x{9ABE}\x{9ABF}\x{9AC0}' . +'\x{9AC1}\x{9AC2}\x{9AC3}\x{9AC4}\x{9AC5}\x{9AC6}\x{9AC7}\x{9AC9}\x{9ACA}' . +'\x{9ACB}\x{9ACC}\x{9ACD}\x{9ACE}\x{9ACF}\x{9AD0}\x{9AD1}\x{9AD2}\x{9AD3}' . +'\x{9AD4}\x{9AD5}\x{9AD6}\x{9AD8}\x{9AD9}\x{9ADA}\x{9ADB}\x{9ADC}\x{9ADD}' . +'\x{9ADE}\x{9ADF}\x{9AE1}\x{9AE2}\x{9AE3}\x{9AE5}\x{9AE6}\x{9AE7}\x{9AEA}' . +'\x{9AEB}\x{9AEC}\x{9AED}\x{9AEE}\x{9AEF}\x{9AF1}\x{9AF2}\x{9AF3}\x{9AF4}' . +'\x{9AF5}\x{9AF6}\x{9AF7}\x{9AF8}\x{9AF9}\x{9AFA}\x{9AFB}\x{9AFC}\x{9AFD}' . +'\x{9AFE}\x{9AFF}\x{9B01}\x{9B03}\x{9B04}\x{9B05}\x{9B06}\x{9B07}\x{9B08}' . +'\x{9B0A}\x{9B0B}\x{9B0C}\x{9B0D}\x{9B0E}\x{9B0F}\x{9B10}\x{9B11}\x{9B12}' . +'\x{9B13}\x{9B15}\x{9B16}\x{9B17}\x{9B18}\x{9B19}\x{9B1A}\x{9B1C}\x{9B1D}' . +'\x{9B1E}\x{9B1F}\x{9B20}\x{9B21}\x{9B22}\x{9B23}\x{9B24}\x{9B25}\x{9B26}' . +'\x{9B27}\x{9B28}\x{9B29}\x{9B2A}\x{9B2B}\x{9B2C}\x{9B2D}\x{9B2E}\x{9B2F}' . +'\x{9B30}\x{9B31}\x{9B32}\x{9B33}\x{9B35}\x{9B36}\x{9B37}\x{9B38}\x{9B39}' . +'\x{9B3A}\x{9B3B}\x{9B3C}\x{9B3E}\x{9B3F}\x{9B41}\x{9B42}\x{9B43}\x{9B44}' . +'\x{9B45}\x{9B46}\x{9B47}\x{9B48}\x{9B49}\x{9B4A}\x{9B4B}\x{9B4C}\x{9B4D}' . +'\x{9B4E}\x{9B4F}\x{9B51}\x{9B52}\x{9B53}\x{9B54}\x{9B55}\x{9B56}\x{9B58}' . +'\x{9B59}\x{9B5A}\x{9B5B}\x{9B5C}\x{9B5D}\x{9B5E}\x{9B5F}\x{9B60}\x{9B61}' . +'\x{9B63}\x{9B64}\x{9B65}\x{9B66}\x{9B67}\x{9B68}\x{9B69}\x{9B6A}\x{9B6B}' . +'\x{9B6C}\x{9B6D}\x{9B6E}\x{9B6F}\x{9B70}\x{9B71}\x{9B73}\x{9B74}\x{9B75}' . +'\x{9B76}\x{9B77}\x{9B78}\x{9B79}\x{9B7A}\x{9B7B}\x{9B7C}\x{9B7D}\x{9B7E}' . +'\x{9B7F}\x{9B80}\x{9B81}\x{9B82}\x{9B83}\x{9B84}\x{9B85}\x{9B86}\x{9B87}' . +'\x{9B88}\x{9B8A}\x{9B8B}\x{9B8D}\x{9B8E}\x{9B8F}\x{9B90}\x{9B91}\x{9B92}' . +'\x{9B93}\x{9B94}\x{9B95}\x{9B96}\x{9B97}\x{9B98}\x{9B9A}\x{9B9B}\x{9B9C}' . +'\x{9B9D}\x{9B9E}\x{9B9F}\x{9BA0}\x{9BA1}\x{9BA2}\x{9BA3}\x{9BA4}\x{9BA5}' . +'\x{9BA6}\x{9BA7}\x{9BA8}\x{9BA9}\x{9BAA}\x{9BAB}\x{9BAC}\x{9BAD}\x{9BAE}' . +'\x{9BAF}\x{9BB0}\x{9BB1}\x{9BB2}\x{9BB3}\x{9BB4}\x{9BB5}\x{9BB6}\x{9BB7}' . +'\x{9BB8}\x{9BB9}\x{9BBA}\x{9BBB}\x{9BBC}\x{9BBD}\x{9BBE}\x{9BBF}\x{9BC0}' . +'\x{9BC1}\x{9BC3}\x{9BC4}\x{9BC5}\x{9BC6}\x{9BC7}\x{9BC8}\x{9BC9}\x{9BCA}' . +'\x{9BCB}\x{9BCC}\x{9BCD}\x{9BCE}\x{9BCF}\x{9BD0}\x{9BD1}\x{9BD2}\x{9BD3}' . +'\x{9BD4}\x{9BD5}\x{9BD6}\x{9BD7}\x{9BD8}\x{9BD9}\x{9BDA}\x{9BDB}\x{9BDC}' . +'\x{9BDD}\x{9BDE}\x{9BDF}\x{9BE0}\x{9BE1}\x{9BE2}\x{9BE3}\x{9BE4}\x{9BE5}' . +'\x{9BE6}\x{9BE7}\x{9BE8}\x{9BE9}\x{9BEA}\x{9BEB}\x{9BEC}\x{9BED}\x{9BEE}' . +'\x{9BEF}\x{9BF0}\x{9BF1}\x{9BF2}\x{9BF3}\x{9BF4}\x{9BF5}\x{9BF7}\x{9BF8}' . +'\x{9BF9}\x{9BFA}\x{9BFB}\x{9BFC}\x{9BFD}\x{9BFE}\x{9BFF}\x{9C02}\x{9C05}' . +'\x{9C06}\x{9C07}\x{9C08}\x{9C09}\x{9C0A}\x{9C0B}\x{9C0C}\x{9C0D}\x{9C0E}' . +'\x{9C0F}\x{9C10}\x{9C11}\x{9C12}\x{9C13}\x{9C14}\x{9C15}\x{9C16}\x{9C17}' . +'\x{9C18}\x{9C19}\x{9C1A}\x{9C1B}\x{9C1C}\x{9C1D}\x{9C1E}\x{9C1F}\x{9C20}' . +'\x{9C21}\x{9C22}\x{9C23}\x{9C24}\x{9C25}\x{9C26}\x{9C27}\x{9C28}\x{9C29}' . +'\x{9C2A}\x{9C2B}\x{9C2C}\x{9C2D}\x{9C2F}\x{9C30}\x{9C31}\x{9C32}\x{9C33}' . +'\x{9C34}\x{9C35}\x{9C36}\x{9C37}\x{9C38}\x{9C39}\x{9C3A}\x{9C3B}\x{9C3C}' . +'\x{9C3D}\x{9C3E}\x{9C3F}\x{9C40}\x{9C41}\x{9C43}\x{9C44}\x{9C45}\x{9C46}' . +'\x{9C47}\x{9C48}\x{9C49}\x{9C4A}\x{9C4B}\x{9C4C}\x{9C4D}\x{9C4E}\x{9C50}' . +'\x{9C52}\x{9C53}\x{9C54}\x{9C55}\x{9C56}\x{9C57}\x{9C58}\x{9C59}\x{9C5A}' . +'\x{9C5B}\x{9C5C}\x{9C5D}\x{9C5E}\x{9C5F}\x{9C60}\x{9C62}\x{9C63}\x{9C65}' . +'\x{9C66}\x{9C67}\x{9C68}\x{9C69}\x{9C6A}\x{9C6B}\x{9C6C}\x{9C6D}\x{9C6E}' . +'\x{9C6F}\x{9C70}\x{9C71}\x{9C72}\x{9C73}\x{9C74}\x{9C75}\x{9C77}\x{9C78}' . +'\x{9C79}\x{9C7A}\x{9C7C}\x{9C7D}\x{9C7E}\x{9C7F}\x{9C80}\x{9C81}\x{9C82}' . +'\x{9C83}\x{9C84}\x{9C85}\x{9C86}\x{9C87}\x{9C88}\x{9C89}\x{9C8A}\x{9C8B}' . +'\x{9C8C}\x{9C8D}\x{9C8E}\x{9C8F}\x{9C90}\x{9C91}\x{9C92}\x{9C93}\x{9C94}' . +'\x{9C95}\x{9C96}\x{9C97}\x{9C98}\x{9C99}\x{9C9A}\x{9C9B}\x{9C9C}\x{9C9D}' . +'\x{9C9E}\x{9C9F}\x{9CA0}\x{9CA1}\x{9CA2}\x{9CA3}\x{9CA4}\x{9CA5}\x{9CA6}' . +'\x{9CA7}\x{9CA8}\x{9CA9}\x{9CAA}\x{9CAB}\x{9CAC}\x{9CAD}\x{9CAE}\x{9CAF}' . +'\x{9CB0}\x{9CB1}\x{9CB2}\x{9CB3}\x{9CB4}\x{9CB5}\x{9CB6}\x{9CB7}\x{9CB8}' . +'\x{9CB9}\x{9CBA}\x{9CBB}\x{9CBC}\x{9CBD}\x{9CBE}\x{9CBF}\x{9CC0}\x{9CC1}' . +'\x{9CC2}\x{9CC3}\x{9CC4}\x{9CC5}\x{9CC6}\x{9CC7}\x{9CC8}\x{9CC9}\x{9CCA}' . +'\x{9CCB}\x{9CCC}\x{9CCD}\x{9CCE}\x{9CCF}\x{9CD0}\x{9CD1}\x{9CD2}\x{9CD3}' . +'\x{9CD4}\x{9CD5}\x{9CD6}\x{9CD7}\x{9CD8}\x{9CD9}\x{9CDA}\x{9CDB}\x{9CDC}' . +'\x{9CDD}\x{9CDE}\x{9CDF}\x{9CE0}\x{9CE1}\x{9CE2}\x{9CE3}\x{9CE4}\x{9CE5}' . +'\x{9CE6}\x{9CE7}\x{9CE8}\x{9CE9}\x{9CEA}\x{9CEB}\x{9CEC}\x{9CED}\x{9CEE}' . +'\x{9CEF}\x{9CF0}\x{9CF1}\x{9CF2}\x{9CF3}\x{9CF4}\x{9CF5}\x{9CF6}\x{9CF7}' . +'\x{9CF8}\x{9CF9}\x{9CFA}\x{9CFB}\x{9CFC}\x{9CFD}\x{9CFE}\x{9CFF}\x{9D00}' . +'\x{9D01}\x{9D02}\x{9D03}\x{9D04}\x{9D05}\x{9D06}\x{9D07}\x{9D08}\x{9D09}' . +'\x{9D0A}\x{9D0B}\x{9D0F}\x{9D10}\x{9D12}\x{9D13}\x{9D14}\x{9D15}\x{9D16}' . +'\x{9D17}\x{9D18}\x{9D19}\x{9D1A}\x{9D1B}\x{9D1C}\x{9D1D}\x{9D1E}\x{9D1F}' . +'\x{9D20}\x{9D21}\x{9D22}\x{9D23}\x{9D24}\x{9D25}\x{9D26}\x{9D28}\x{9D29}' . +'\x{9D2B}\x{9D2D}\x{9D2E}\x{9D2F}\x{9D30}\x{9D31}\x{9D32}\x{9D33}\x{9D34}' . +'\x{9D36}\x{9D37}\x{9D38}\x{9D39}\x{9D3A}\x{9D3B}\x{9D3D}\x{9D3E}\x{9D3F}' . +'\x{9D40}\x{9D41}\x{9D42}\x{9D43}\x{9D45}\x{9D46}\x{9D47}\x{9D48}\x{9D49}' . +'\x{9D4A}\x{9D4B}\x{9D4C}\x{9D4D}\x{9D4E}\x{9D4F}\x{9D50}\x{9D51}\x{9D52}' . +'\x{9D53}\x{9D54}\x{9D55}\x{9D56}\x{9D57}\x{9D58}\x{9D59}\x{9D5A}\x{9D5B}' . +'\x{9D5C}\x{9D5D}\x{9D5E}\x{9D5F}\x{9D60}\x{9D61}\x{9D62}\x{9D63}\x{9D64}' . +'\x{9D65}\x{9D66}\x{9D67}\x{9D68}\x{9D69}\x{9D6A}\x{9D6B}\x{9D6C}\x{9D6E}' . +'\x{9D6F}\x{9D70}\x{9D71}\x{9D72}\x{9D73}\x{9D74}\x{9D75}\x{9D76}\x{9D77}' . +'\x{9D78}\x{9D79}\x{9D7A}\x{9D7B}\x{9D7C}\x{9D7D}\x{9D7E}\x{9D7F}\x{9D80}' . +'\x{9D81}\x{9D82}\x{9D83}\x{9D84}\x{9D85}\x{9D86}\x{9D87}\x{9D88}\x{9D89}' . +'\x{9D8A}\x{9D8B}\x{9D8C}\x{9D8D}\x{9D8E}\x{9D90}\x{9D91}\x{9D92}\x{9D93}' . +'\x{9D94}\x{9D96}\x{9D97}\x{9D98}\x{9D99}\x{9D9A}\x{9D9B}\x{9D9C}\x{9D9D}' . +'\x{9D9E}\x{9D9F}\x{9DA0}\x{9DA1}\x{9DA2}\x{9DA3}\x{9DA4}\x{9DA5}\x{9DA6}' . +'\x{9DA7}\x{9DA8}\x{9DA9}\x{9DAA}\x{9DAB}\x{9DAC}\x{9DAD}\x{9DAF}\x{9DB0}' . +'\x{9DB1}\x{9DB2}\x{9DB3}\x{9DB4}\x{9DB5}\x{9DB6}\x{9DB7}\x{9DB8}\x{9DB9}' . +'\x{9DBA}\x{9DBB}\x{9DBC}\x{9DBE}\x{9DBF}\x{9DC1}\x{9DC2}\x{9DC3}\x{9DC4}' . +'\x{9DC5}\x{9DC7}\x{9DC8}\x{9DC9}\x{9DCA}\x{9DCB}\x{9DCC}\x{9DCD}\x{9DCE}' . +'\x{9DCF}\x{9DD0}\x{9DD1}\x{9DD2}\x{9DD3}\x{9DD4}\x{9DD5}\x{9DD6}\x{9DD7}' . +'\x{9DD8}\x{9DD9}\x{9DDA}\x{9DDB}\x{9DDC}\x{9DDD}\x{9DDE}\x{9DDF}\x{9DE0}' . +'\x{9DE1}\x{9DE2}\x{9DE3}\x{9DE4}\x{9DE5}\x{9DE6}\x{9DE7}\x{9DE8}\x{9DE9}' . +'\x{9DEB}\x{9DEC}\x{9DED}\x{9DEE}\x{9DEF}\x{9DF0}\x{9DF1}\x{9DF2}\x{9DF3}' . +'\x{9DF4}\x{9DF5}\x{9DF6}\x{9DF7}\x{9DF8}\x{9DF9}\x{9DFA}\x{9DFB}\x{9DFD}' . +'\x{9DFE}\x{9DFF}\x{9E00}\x{9E01}\x{9E02}\x{9E03}\x{9E04}\x{9E05}\x{9E06}' . +'\x{9E07}\x{9E08}\x{9E09}\x{9E0A}\x{9E0B}\x{9E0C}\x{9E0D}\x{9E0F}\x{9E10}' . +'\x{9E11}\x{9E12}\x{9E13}\x{9E14}\x{9E15}\x{9E17}\x{9E18}\x{9E19}\x{9E1A}' . +'\x{9E1B}\x{9E1D}\x{9E1E}\x{9E1F}\x{9E20}\x{9E21}\x{9E22}\x{9E23}\x{9E24}' . +'\x{9E25}\x{9E26}\x{9E27}\x{9E28}\x{9E29}\x{9E2A}\x{9E2B}\x{9E2C}\x{9E2D}' . +'\x{9E2E}\x{9E2F}\x{9E30}\x{9E31}\x{9E32}\x{9E33}\x{9E34}\x{9E35}\x{9E36}' . +'\x{9E37}\x{9E38}\x{9E39}\x{9E3A}\x{9E3B}\x{9E3C}\x{9E3D}\x{9E3E}\x{9E3F}' . +'\x{9E40}\x{9E41}\x{9E42}\x{9E43}\x{9E44}\x{9E45}\x{9E46}\x{9E47}\x{9E48}' . +'\x{9E49}\x{9E4A}\x{9E4B}\x{9E4C}\x{9E4D}\x{9E4E}\x{9E4F}\x{9E50}\x{9E51}' . +'\x{9E52}\x{9E53}\x{9E54}\x{9E55}\x{9E56}\x{9E57}\x{9E58}\x{9E59}\x{9E5A}' . +'\x{9E5B}\x{9E5C}\x{9E5D}\x{9E5E}\x{9E5F}\x{9E60}\x{9E61}\x{9E62}\x{9E63}' . +'\x{9E64}\x{9E65}\x{9E66}\x{9E67}\x{9E68}\x{9E69}\x{9E6A}\x{9E6B}\x{9E6C}' . +'\x{9E6D}\x{9E6E}\x{9E6F}\x{9E70}\x{9E71}\x{9E72}\x{9E73}\x{9E74}\x{9E75}' . +'\x{9E76}\x{9E77}\x{9E79}\x{9E7A}\x{9E7C}\x{9E7D}\x{9E7E}\x{9E7F}\x{9E80}' . +'\x{9E81}\x{9E82}\x{9E83}\x{9E84}\x{9E85}\x{9E86}\x{9E87}\x{9E88}\x{9E89}' . +'\x{9E8A}\x{9E8B}\x{9E8C}\x{9E8D}\x{9E8E}\x{9E91}\x{9E92}\x{9E93}\x{9E94}' . +'\x{9E96}\x{9E97}\x{9E99}\x{9E9A}\x{9E9B}\x{9E9C}\x{9E9D}\x{9E9F}\x{9EA0}' . +'\x{9EA1}\x{9EA3}\x{9EA4}\x{9EA5}\x{9EA6}\x{9EA7}\x{9EA8}\x{9EA9}\x{9EAA}' . +'\x{9EAD}\x{9EAE}\x{9EAF}\x{9EB0}\x{9EB2}\x{9EB3}\x{9EB4}\x{9EB5}\x{9EB6}' . +'\x{9EB7}\x{9EB8}\x{9EBB}\x{9EBC}\x{9EBD}\x{9EBE}\x{9EBF}\x{9EC0}\x{9EC1}' . +'\x{9EC2}\x{9EC3}\x{9EC4}\x{9EC5}\x{9EC6}\x{9EC7}\x{9EC8}\x{9EC9}\x{9ECA}' . +'\x{9ECB}\x{9ECC}\x{9ECD}\x{9ECE}\x{9ECF}\x{9ED0}\x{9ED1}\x{9ED2}\x{9ED3}' . +'\x{9ED4}\x{9ED5}\x{9ED6}\x{9ED7}\x{9ED8}\x{9ED9}\x{9EDA}\x{9EDB}\x{9EDC}' . +'\x{9EDD}\x{9EDE}\x{9EDF}\x{9EE0}\x{9EE1}\x{9EE2}\x{9EE3}\x{9EE4}\x{9EE5}' . +'\x{9EE6}\x{9EE7}\x{9EE8}\x{9EE9}\x{9EEA}\x{9EEB}\x{9EED}\x{9EEE}\x{9EEF}' . +'\x{9EF0}\x{9EF2}\x{9EF3}\x{9EF4}\x{9EF5}\x{9EF6}\x{9EF7}\x{9EF8}\x{9EF9}' . +'\x{9EFA}\x{9EFB}\x{9EFC}\x{9EFD}\x{9EFE}\x{9EFF}\x{9F00}\x{9F01}\x{9F02}' . +'\x{9F04}\x{9F05}\x{9F06}\x{9F07}\x{9F08}\x{9F09}\x{9F0A}\x{9F0B}\x{9F0C}' . +'\x{9F0D}\x{9F0E}\x{9F0F}\x{9F10}\x{9F12}\x{9F13}\x{9F15}\x{9F16}\x{9F17}' . +'\x{9F18}\x{9F19}\x{9F1A}\x{9F1B}\x{9F1C}\x{9F1D}\x{9F1E}\x{9F1F}\x{9F20}' . +'\x{9F22}\x{9F23}\x{9F24}\x{9F25}\x{9F27}\x{9F28}\x{9F29}\x{9F2A}\x{9F2B}' . +'\x{9F2C}\x{9F2D}\x{9F2E}\x{9F2F}\x{9F30}\x{9F31}\x{9F32}\x{9F33}\x{9F34}' . +'\x{9F35}\x{9F36}\x{9F37}\x{9F38}\x{9F39}\x{9F3A}\x{9F3B}\x{9F3C}\x{9F3D}' . +'\x{9F3E}\x{9F3F}\x{9F40}\x{9F41}\x{9F42}\x{9F43}\x{9F44}\x{9F46}\x{9F47}' . +'\x{9F48}\x{9F49}\x{9F4A}\x{9F4B}\x{9F4C}\x{9F4D}\x{9F4E}\x{9F4F}\x{9F50}' . +'\x{9F51}\x{9F52}\x{9F54}\x{9F55}\x{9F56}\x{9F57}\x{9F58}\x{9F59}\x{9F5A}' . +'\x{9F5B}\x{9F5C}\x{9F5D}\x{9F5E}\x{9F5F}\x{9F60}\x{9F61}\x{9F63}\x{9F64}' . +'\x{9F65}\x{9F66}\x{9F67}\x{9F68}\x{9F69}\x{9F6A}\x{9F6B}\x{9F6C}\x{9F6E}' . +'\x{9F6F}\x{9F70}\x{9F71}\x{9F72}\x{9F73}\x{9F74}\x{9F75}\x{9F76}\x{9F77}' . +'\x{9F78}\x{9F79}\x{9F7A}\x{9F7B}\x{9F7C}\x{9F7D}\x{9F7E}\x{9F7F}\x{9F80}' . +'\x{9F81}\x{9F82}\x{9F83}\x{9F84}\x{9F85}\x{9F86}\x{9F87}\x{9F88}\x{9F89}' . +'\x{9F8A}\x{9F8B}\x{9F8C}\x{9F8D}\x{9F8E}\x{9F8F}\x{9F90}\x{9F91}\x{9F92}' . +'\x{9F93}\x{9F94}\x{9F95}\x{9F96}\x{9F97}\x{9F98}\x{9F99}\x{9F9A}\x{9F9B}' . +'\x{9F9C}\x{9F9D}\x{9F9E}\x{9F9F}\x{9FA0}\x{9FA2}\x{9FA4}\x{9FA5}]{1,20}$/iu'); diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Cn.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Cn.php new file mode 100644 index 0000000..84c0bf2 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Cn.php @@ -0,0 +1,2199 @@ + '/^[\x{002d}0-9a-z\x{3447}\x{3473}\x{359E}\x{360E}\x{361A}\x{3918}\x{396E}\x{39CF}\x{39D0}' . +'\x{39DF}\x{3A73}\x{3B4E}\x{3C6E}\x{3CE0}\x{4056}\x{415F}\x{4337}\x{43AC}' . +'\x{43B1}\x{43DD}\x{44D6}\x{464C}\x{4661}\x{4723}\x{4729}\x{477C}\x{478D}' . +'\x{4947}\x{497A}\x{497D}\x{4982}\x{4983}\x{4985}\x{4986}\x{499B}\x{499F}' . +'\x{49B6}\x{49B7}\x{4C77}\x{4C9F}\x{4CA0}\x{4CA1}\x{4CA2}\x{4CA3}\x{4D13}' . +'\x{4D14}\x{4D15}\x{4D16}\x{4D17}\x{4D18}\x{4D19}\x{4DAE}\x{4E00}\x{4E01}' . +'\x{4E02}\x{4E03}\x{4E04}\x{4E05}\x{4E06}\x{4E07}\x{4E08}\x{4E09}\x{4E0A}' . +'\x{4E0B}\x{4E0C}\x{4E0D}\x{4E0E}\x{4E0F}\x{4E10}\x{4E11}\x{4E13}\x{4E14}' . +'\x{4E15}\x{4E16}\x{4E17}\x{4E18}\x{4E19}\x{4E1A}\x{4E1B}\x{4E1C}\x{4E1D}' . +'\x{4E1E}\x{4E1F}\x{4E20}\x{4E21}\x{4E22}\x{4E23}\x{4E24}\x{4E25}\x{4E26}' . +'\x{4E27}\x{4E28}\x{4E2A}\x{4E2B}\x{4E2C}\x{4E2D}\x{4E2E}\x{4E2F}\x{4E30}' . +'\x{4E31}\x{4E32}\x{4E33}\x{4E34}\x{4E35}\x{4E36}\x{4E37}\x{4E38}\x{4E39}' . +'\x{4E3A}\x{4E3B}\x{4E3C}\x{4E3D}\x{4E3E}\x{4E3F}\x{4E40}\x{4E41}\x{4E42}' . +'\x{4E43}\x{4E44}\x{4E45}\x{4E46}\x{4E47}\x{4E48}\x{4E49}\x{4E4A}\x{4E4B}' . +'\x{4E4C}\x{4E4D}\x{4E4E}\x{4E4F}\x{4E50}\x{4E51}\x{4E52}\x{4E53}\x{4E54}' . +'\x{4E56}\x{4E57}\x{4E58}\x{4E59}\x{4E5A}\x{4E5B}\x{4E5C}\x{4E5D}\x{4E5E}' . +'\x{4E5F}\x{4E60}\x{4E61}\x{4E62}\x{4E63}\x{4E64}\x{4E65}\x{4E66}\x{4E67}' . +'\x{4E69}\x{4E6A}\x{4E6B}\x{4E6C}\x{4E6D}\x{4E6E}\x{4E6F}\x{4E70}\x{4E71}' . +'\x{4E72}\x{4E73}\x{4E74}\x{4E75}\x{4E76}\x{4E77}\x{4E78}\x{4E7A}\x{4E7B}' . +'\x{4E7C}\x{4E7D}\x{4E7E}\x{4E7F}\x{4E80}\x{4E81}\x{4E82}\x{4E83}\x{4E84}' . +'\x{4E85}\x{4E86}\x{4E87}\x{4E88}\x{4E89}\x{4E8B}\x{4E8C}\x{4E8D}\x{4E8E}' . +'\x{4E8F}\x{4E90}\x{4E91}\x{4E92}\x{4E93}\x{4E94}\x{4E95}\x{4E97}\x{4E98}' . +'\x{4E99}\x{4E9A}\x{4E9B}\x{4E9C}\x{4E9D}\x{4E9E}\x{4E9F}\x{4EA0}\x{4EA1}' . +'\x{4EA2}\x{4EA4}\x{4EA5}\x{4EA6}\x{4EA7}\x{4EA8}\x{4EA9}\x{4EAA}\x{4EAB}' . +'\x{4EAC}\x{4EAD}\x{4EAE}\x{4EAF}\x{4EB0}\x{4EB1}\x{4EB2}\x{4EB3}\x{4EB4}' . +'\x{4EB5}\x{4EB6}\x{4EB7}\x{4EB8}\x{4EB9}\x{4EBA}\x{4EBB}\x{4EBD}\x{4EBE}' . +'\x{4EBF}\x{4EC0}\x{4EC1}\x{4EC2}\x{4EC3}\x{4EC4}\x{4EC5}\x{4EC6}\x{4EC7}' . +'\x{4EC8}\x{4EC9}\x{4ECA}\x{4ECB}\x{4ECD}\x{4ECE}\x{4ECF}\x{4ED0}\x{4ED1}' . +'\x{4ED2}\x{4ED3}\x{4ED4}\x{4ED5}\x{4ED6}\x{4ED7}\x{4ED8}\x{4ED9}\x{4EDA}' . +'\x{4EDB}\x{4EDC}\x{4EDD}\x{4EDE}\x{4EDF}\x{4EE0}\x{4EE1}\x{4EE2}\x{4EE3}' . +'\x{4EE4}\x{4EE5}\x{4EE6}\x{4EE8}\x{4EE9}\x{4EEA}\x{4EEB}\x{4EEC}\x{4EEF}' . +'\x{4EF0}\x{4EF1}\x{4EF2}\x{4EF3}\x{4EF4}\x{4EF5}\x{4EF6}\x{4EF7}\x{4EFB}' . +'\x{4EFD}\x{4EFF}\x{4F00}\x{4F01}\x{4F02}\x{4F03}\x{4F04}\x{4F05}\x{4F06}' . +'\x{4F08}\x{4F09}\x{4F0A}\x{4F0B}\x{4F0C}\x{4F0D}\x{4F0E}\x{4F0F}\x{4F10}' . +'\x{4F11}\x{4F12}\x{4F13}\x{4F14}\x{4F15}\x{4F17}\x{4F18}\x{4F19}\x{4F1A}' . +'\x{4F1B}\x{4F1C}\x{4F1D}\x{4F1E}\x{4F1F}\x{4F20}\x{4F21}\x{4F22}\x{4F23}' . +'\x{4F24}\x{4F25}\x{4F26}\x{4F27}\x{4F29}\x{4F2A}\x{4F2B}\x{4F2C}\x{4F2D}' . +'\x{4F2E}\x{4F2F}\x{4F30}\x{4F32}\x{4F33}\x{4F34}\x{4F36}\x{4F38}\x{4F39}' . +'\x{4F3A}\x{4F3B}\x{4F3C}\x{4F3D}\x{4F3E}\x{4F3F}\x{4F41}\x{4F42}\x{4F43}' . +'\x{4F45}\x{4F46}\x{4F47}\x{4F48}\x{4F49}\x{4F4A}\x{4F4B}\x{4F4C}\x{4F4D}' . +'\x{4F4E}\x{4F4F}\x{4F50}\x{4F51}\x{4F52}\x{4F53}\x{4F54}\x{4F55}\x{4F56}' . +'\x{4F57}\x{4F58}\x{4F59}\x{4F5A}\x{4F5B}\x{4F5C}\x{4F5D}\x{4F5E}\x{4F5F}' . +'\x{4F60}\x{4F61}\x{4F62}\x{4F63}\x{4F64}\x{4F65}\x{4F66}\x{4F67}\x{4F68}' . +'\x{4F69}\x{4F6A}\x{4F6B}\x{4F6C}\x{4F6D}\x{4F6E}\x{4F6F}\x{4F70}\x{4F72}' . +'\x{4F73}\x{4F74}\x{4F75}\x{4F76}\x{4F77}\x{4F78}\x{4F79}\x{4F7A}\x{4F7B}' . +'\x{4F7C}\x{4F7D}\x{4F7E}\x{4F7F}\x{4F80}\x{4F81}\x{4F82}\x{4F83}\x{4F84}' . +'\x{4F85}\x{4F86}\x{4F87}\x{4F88}\x{4F89}\x{4F8A}\x{4F8B}\x{4F8D}\x{4F8F}' . +'\x{4F90}\x{4F91}\x{4F92}\x{4F93}\x{4F94}\x{4F95}\x{4F96}\x{4F97}\x{4F98}' . +'\x{4F99}\x{4F9A}\x{4F9B}\x{4F9C}\x{4F9D}\x{4F9E}\x{4F9F}\x{4FA0}\x{4FA1}' . +'\x{4FA3}\x{4FA4}\x{4FA5}\x{4FA6}\x{4FA7}\x{4FA8}\x{4FA9}\x{4FAA}\x{4FAB}' . +'\x{4FAC}\x{4FAE}\x{4FAF}\x{4FB0}\x{4FB1}\x{4FB2}\x{4FB3}\x{4FB4}\x{4FB5}' . +'\x{4FB6}\x{4FB7}\x{4FB8}\x{4FB9}\x{4FBA}\x{4FBB}\x{4FBC}\x{4FBE}\x{4FBF}' . +'\x{4FC0}\x{4FC1}\x{4FC2}\x{4FC3}\x{4FC4}\x{4FC5}\x{4FC7}\x{4FC9}\x{4FCA}' . +'\x{4FCB}\x{4FCD}\x{4FCE}\x{4FCF}\x{4FD0}\x{4FD1}\x{4FD2}\x{4FD3}\x{4FD4}' . +'\x{4FD5}\x{4FD6}\x{4FD7}\x{4FD8}\x{4FD9}\x{4FDA}\x{4FDB}\x{4FDC}\x{4FDD}' . +'\x{4FDE}\x{4FDF}\x{4FE0}\x{4FE1}\x{4FE3}\x{4FE4}\x{4FE5}\x{4FE6}\x{4FE7}' . +'\x{4FE8}\x{4FE9}\x{4FEA}\x{4FEB}\x{4FEC}\x{4FED}\x{4FEE}\x{4FEF}\x{4FF0}' . +'\x{4FF1}\x{4FF2}\x{4FF3}\x{4FF4}\x{4FF5}\x{4FF6}\x{4FF7}\x{4FF8}\x{4FF9}' . +'\x{4FFA}\x{4FFB}\x{4FFE}\x{4FFF}\x{5000}\x{5001}\x{5002}\x{5003}\x{5004}' . +'\x{5005}\x{5006}\x{5007}\x{5008}\x{5009}\x{500A}\x{500B}\x{500C}\x{500D}' . +'\x{500E}\x{500F}\x{5011}\x{5012}\x{5013}\x{5014}\x{5015}\x{5016}\x{5017}' . +'\x{5018}\x{5019}\x{501A}\x{501B}\x{501C}\x{501D}\x{501E}\x{501F}\x{5020}' . +'\x{5021}\x{5022}\x{5023}\x{5024}\x{5025}\x{5026}\x{5027}\x{5028}\x{5029}' . +'\x{502A}\x{502B}\x{502C}\x{502D}\x{502E}\x{502F}\x{5030}\x{5031}\x{5032}' . +'\x{5033}\x{5035}\x{5036}\x{5037}\x{5039}\x{503A}\x{503B}\x{503C}\x{503E}' . +'\x{503F}\x{5040}\x{5041}\x{5043}\x{5044}\x{5045}\x{5046}\x{5047}\x{5048}' . +'\x{5049}\x{504A}\x{504B}\x{504C}\x{504D}\x{504E}\x{504F}\x{5051}\x{5053}' . +'\x{5054}\x{5055}\x{5056}\x{5057}\x{5059}\x{505A}\x{505B}\x{505C}\x{505D}' . +'\x{505E}\x{505F}\x{5060}\x{5061}\x{5062}\x{5063}\x{5064}\x{5065}\x{5066}' . +'\x{5067}\x{5068}\x{5069}\x{506A}\x{506B}\x{506C}\x{506D}\x{506E}\x{506F}' . +'\x{5070}\x{5071}\x{5072}\x{5073}\x{5074}\x{5075}\x{5076}\x{5077}\x{5078}' . +'\x{5079}\x{507A}\x{507B}\x{507D}\x{507E}\x{507F}\x{5080}\x{5082}\x{5083}' . +'\x{5084}\x{5085}\x{5086}\x{5087}\x{5088}\x{5089}\x{508A}\x{508B}\x{508C}' . +'\x{508D}\x{508E}\x{508F}\x{5090}\x{5091}\x{5092}\x{5094}\x{5095}\x{5096}' . +'\x{5098}\x{5099}\x{509A}\x{509B}\x{509C}\x{509D}\x{509E}\x{50A2}\x{50A3}' . +'\x{50A4}\x{50A5}\x{50A6}\x{50A7}\x{50A8}\x{50A9}\x{50AA}\x{50AB}\x{50AC}' . +'\x{50AD}\x{50AE}\x{50AF}\x{50B0}\x{50B1}\x{50B2}\x{50B3}\x{50B4}\x{50B5}' . +'\x{50B6}\x{50B7}\x{50B8}\x{50BA}\x{50BB}\x{50BC}\x{50BD}\x{50BE}\x{50BF}' . +'\x{50C0}\x{50C1}\x{50C2}\x{50C4}\x{50C5}\x{50C6}\x{50C7}\x{50C8}\x{50C9}' . +'\x{50CA}\x{50CB}\x{50CC}\x{50CD}\x{50CE}\x{50CF}\x{50D0}\x{50D1}\x{50D2}' . +'\x{50D3}\x{50D4}\x{50D5}\x{50D6}\x{50D7}\x{50D9}\x{50DA}\x{50DB}\x{50DC}' . +'\x{50DD}\x{50DE}\x{50E0}\x{50E3}\x{50E4}\x{50E5}\x{50E6}\x{50E7}\x{50E8}' . +'\x{50E9}\x{50EA}\x{50EC}\x{50ED}\x{50EE}\x{50EF}\x{50F0}\x{50F1}\x{50F2}' . +'\x{50F3}\x{50F5}\x{50F6}\x{50F8}\x{50F9}\x{50FA}\x{50FB}\x{50FC}\x{50FD}' . +'\x{50FE}\x{50FF}\x{5100}\x{5101}\x{5102}\x{5103}\x{5104}\x{5105}\x{5106}' . +'\x{5107}\x{5108}\x{5109}\x{510A}\x{510B}\x{510C}\x{510D}\x{510E}\x{510F}' . +'\x{5110}\x{5111}\x{5112}\x{5113}\x{5114}\x{5115}\x{5116}\x{5117}\x{5118}' . +'\x{5119}\x{511A}\x{511C}\x{511D}\x{511E}\x{511F}\x{5120}\x{5121}\x{5122}' . +'\x{5123}\x{5124}\x{5125}\x{5126}\x{5127}\x{5129}\x{512A}\x{512C}\x{512D}' . +'\x{512E}\x{512F}\x{5130}\x{5131}\x{5132}\x{5133}\x{5134}\x{5135}\x{5136}' . +'\x{5137}\x{5138}\x{5139}\x{513A}\x{513B}\x{513C}\x{513D}\x{513E}\x{513F}' . +'\x{5140}\x{5141}\x{5143}\x{5144}\x{5145}\x{5146}\x{5147}\x{5148}\x{5149}' . +'\x{514B}\x{514C}\x{514D}\x{514E}\x{5150}\x{5151}\x{5152}\x{5154}\x{5155}' . +'\x{5156}\x{5157}\x{5159}\x{515A}\x{515B}\x{515C}\x{515D}\x{515E}\x{515F}' . +'\x{5161}\x{5162}\x{5163}\x{5165}\x{5166}\x{5167}\x{5168}\x{5169}\x{516A}' . +'\x{516B}\x{516C}\x{516D}\x{516E}\x{516F}\x{5170}\x{5171}\x{5173}\x{5174}' . +'\x{5175}\x{5176}\x{5177}\x{5178}\x{5179}\x{517A}\x{517B}\x{517C}\x{517D}' . +'\x{517F}\x{5180}\x{5181}\x{5182}\x{5185}\x{5186}\x{5187}\x{5188}\x{5189}' . +'\x{518A}\x{518B}\x{518C}\x{518D}\x{518F}\x{5190}\x{5191}\x{5192}\x{5193}' . +'\x{5194}\x{5195}\x{5196}\x{5197}\x{5198}\x{5199}\x{519A}\x{519B}\x{519C}' . +'\x{519D}\x{519E}\x{519F}\x{51A0}\x{51A2}\x{51A4}\x{51A5}\x{51A6}\x{51A7}' . +'\x{51A8}\x{51AA}\x{51AB}\x{51AC}\x{51AE}\x{51AF}\x{51B0}\x{51B1}\x{51B2}' . +'\x{51B3}\x{51B5}\x{51B6}\x{51B7}\x{51B9}\x{51BB}\x{51BC}\x{51BD}\x{51BE}' . +'\x{51BF}\x{51C0}\x{51C1}\x{51C3}\x{51C4}\x{51C5}\x{51C6}\x{51C7}\x{51C8}' . +'\x{51C9}\x{51CA}\x{51CB}\x{51CC}\x{51CD}\x{51CE}\x{51CF}\x{51D0}\x{51D1}' . +'\x{51D4}\x{51D5}\x{51D6}\x{51D7}\x{51D8}\x{51D9}\x{51DA}\x{51DB}\x{51DC}' . +'\x{51DD}\x{51DE}\x{51E0}\x{51E1}\x{51E2}\x{51E3}\x{51E4}\x{51E5}\x{51E7}' . +'\x{51E8}\x{51E9}\x{51EA}\x{51EB}\x{51ED}\x{51EF}\x{51F0}\x{51F1}\x{51F3}' . +'\x{51F4}\x{51F5}\x{51F6}\x{51F7}\x{51F8}\x{51F9}\x{51FA}\x{51FB}\x{51FC}' . +'\x{51FD}\x{51FE}\x{51FF}\x{5200}\x{5201}\x{5202}\x{5203}\x{5204}\x{5205}' . +'\x{5206}\x{5207}\x{5208}\x{5209}\x{520A}\x{520B}\x{520C}\x{520D}\x{520E}' . +'\x{520F}\x{5210}\x{5211}\x{5212}\x{5213}\x{5214}\x{5215}\x{5216}\x{5217}' . +'\x{5218}\x{5219}\x{521A}\x{521B}\x{521C}\x{521D}\x{521E}\x{521F}\x{5220}' . +'\x{5221}\x{5222}\x{5223}\x{5224}\x{5225}\x{5226}\x{5228}\x{5229}\x{522A}' . +'\x{522B}\x{522C}\x{522D}\x{522E}\x{522F}\x{5230}\x{5231}\x{5232}\x{5233}' . +'\x{5234}\x{5235}\x{5236}\x{5237}\x{5238}\x{5239}\x{523A}\x{523B}\x{523C}' . +'\x{523D}\x{523E}\x{523F}\x{5240}\x{5241}\x{5242}\x{5243}\x{5244}\x{5245}' . +'\x{5246}\x{5247}\x{5248}\x{5249}\x{524A}\x{524B}\x{524C}\x{524D}\x{524E}' . +'\x{5250}\x{5251}\x{5252}\x{5254}\x{5255}\x{5256}\x{5257}\x{5258}\x{5259}' . +'\x{525A}\x{525B}\x{525C}\x{525D}\x{525E}\x{525F}\x{5260}\x{5261}\x{5262}' . +'\x{5263}\x{5264}\x{5265}\x{5267}\x{5268}\x{5269}\x{526A}\x{526B}\x{526C}' . +'\x{526D}\x{526E}\x{526F}\x{5270}\x{5272}\x{5273}\x{5274}\x{5275}\x{5276}' . +'\x{5277}\x{5278}\x{527A}\x{527B}\x{527C}\x{527D}\x{527E}\x{527F}\x{5280}' . +'\x{5281}\x{5282}\x{5283}\x{5284}\x{5286}\x{5287}\x{5288}\x{5289}\x{528A}' . +'\x{528B}\x{528C}\x{528D}\x{528F}\x{5290}\x{5291}\x{5292}\x{5293}\x{5294}' . +'\x{5295}\x{5296}\x{5297}\x{5298}\x{5299}\x{529A}\x{529B}\x{529C}\x{529D}' . +'\x{529E}\x{529F}\x{52A0}\x{52A1}\x{52A2}\x{52A3}\x{52A5}\x{52A6}\x{52A7}' . +'\x{52A8}\x{52A9}\x{52AA}\x{52AB}\x{52AC}\x{52AD}\x{52AE}\x{52AF}\x{52B0}' . +'\x{52B1}\x{52B2}\x{52B3}\x{52B4}\x{52B5}\x{52B6}\x{52B7}\x{52B8}\x{52B9}' . +'\x{52BA}\x{52BB}\x{52BC}\x{52BD}\x{52BE}\x{52BF}\x{52C0}\x{52C1}\x{52C2}' . +'\x{52C3}\x{52C6}\x{52C7}\x{52C9}\x{52CA}\x{52CB}\x{52CD}\x{52CF}\x{52D0}' . +'\x{52D2}\x{52D3}\x{52D5}\x{52D6}\x{52D7}\x{52D8}\x{52D9}\x{52DA}\x{52DB}' . +'\x{52DC}\x{52DD}\x{52DE}\x{52DF}\x{52E0}\x{52E2}\x{52E3}\x{52E4}\x{52E6}' . +'\x{52E7}\x{52E8}\x{52E9}\x{52EA}\x{52EB}\x{52EC}\x{52ED}\x{52EF}\x{52F0}' . +'\x{52F1}\x{52F2}\x{52F3}\x{52F4}\x{52F5}\x{52F6}\x{52F7}\x{52F8}\x{52F9}' . +'\x{52FA}\x{52FB}\x{52FC}\x{52FD}\x{52FE}\x{52FF}\x{5300}\x{5301}\x{5302}' . +'\x{5305}\x{5306}\x{5307}\x{5308}\x{5309}\x{530A}\x{530B}\x{530C}\x{530D}' . +'\x{530E}\x{530F}\x{5310}\x{5311}\x{5312}\x{5313}\x{5314}\x{5315}\x{5316}' . +'\x{5317}\x{5319}\x{531A}\x{531C}\x{531D}\x{531F}\x{5320}\x{5321}\x{5322}' . +'\x{5323}\x{5324}\x{5325}\x{5326}\x{5328}\x{532A}\x{532B}\x{532C}\x{532D}' . +'\x{532E}\x{532F}\x{5330}\x{5331}\x{5333}\x{5334}\x{5337}\x{5339}\x{533A}' . +'\x{533B}\x{533C}\x{533D}\x{533E}\x{533F}\x{5340}\x{5341}\x{5343}\x{5344}' . +'\x{5345}\x{5346}\x{5347}\x{5348}\x{5349}\x{534A}\x{534B}\x{534C}\x{534D}' . +'\x{534E}\x{534F}\x{5350}\x{5351}\x{5352}\x{5353}\x{5354}\x{5355}\x{5356}' . +'\x{5357}\x{5358}\x{5359}\x{535A}\x{535C}\x{535E}\x{535F}\x{5360}\x{5361}' . +'\x{5362}\x{5363}\x{5364}\x{5365}\x{5366}\x{5367}\x{5369}\x{536B}\x{536C}' . +'\x{536E}\x{536F}\x{5370}\x{5371}\x{5372}\x{5373}\x{5374}\x{5375}\x{5376}' . +'\x{5377}\x{5378}\x{5379}\x{537A}\x{537B}\x{537C}\x{537D}\x{537E}\x{537F}' . +'\x{5381}\x{5382}\x{5383}\x{5384}\x{5385}\x{5386}\x{5387}\x{5388}\x{5389}' . +'\x{538A}\x{538B}\x{538C}\x{538D}\x{538E}\x{538F}\x{5390}\x{5391}\x{5392}' . +'\x{5393}\x{5394}\x{5395}\x{5396}\x{5397}\x{5398}\x{5399}\x{539A}\x{539B}' . +'\x{539C}\x{539D}\x{539E}\x{539F}\x{53A0}\x{53A2}\x{53A3}\x{53A4}\x{53A5}' . +'\x{53A6}\x{53A7}\x{53A8}\x{53A9}\x{53AC}\x{53AD}\x{53AE}\x{53B0}\x{53B1}' . +'\x{53B2}\x{53B3}\x{53B4}\x{53B5}\x{53B6}\x{53B7}\x{53B8}\x{53B9}\x{53BB}' . +'\x{53BC}\x{53BD}\x{53BE}\x{53BF}\x{53C0}\x{53C1}\x{53C2}\x{53C3}\x{53C4}' . +'\x{53C6}\x{53C7}\x{53C8}\x{53C9}\x{53CA}\x{53CB}\x{53CC}\x{53CD}\x{53CE}' . +'\x{53D0}\x{53D1}\x{53D2}\x{53D3}\x{53D4}\x{53D5}\x{53D6}\x{53D7}\x{53D8}' . +'\x{53D9}\x{53DB}\x{53DC}\x{53DF}\x{53E0}\x{53E1}\x{53E2}\x{53E3}\x{53E4}' . +'\x{53E5}\x{53E6}\x{53E8}\x{53E9}\x{53EA}\x{53EB}\x{53EC}\x{53ED}\x{53EE}' . +'\x{53EF}\x{53F0}\x{53F1}\x{53F2}\x{53F3}\x{53F4}\x{53F5}\x{53F6}\x{53F7}' . +'\x{53F8}\x{53F9}\x{53FA}\x{53FB}\x{53FC}\x{53FD}\x{53FE}\x{5401}\x{5402}' . +'\x{5403}\x{5404}\x{5405}\x{5406}\x{5407}\x{5408}\x{5409}\x{540A}\x{540B}' . +'\x{540C}\x{540D}\x{540E}\x{540F}\x{5410}\x{5411}\x{5412}\x{5413}\x{5414}' . +'\x{5415}\x{5416}\x{5417}\x{5418}\x{5419}\x{541B}\x{541C}\x{541D}\x{541E}' . +'\x{541F}\x{5420}\x{5421}\x{5423}\x{5424}\x{5425}\x{5426}\x{5427}\x{5428}' . +'\x{5429}\x{542A}\x{542B}\x{542C}\x{542D}\x{542E}\x{542F}\x{5430}\x{5431}' . +'\x{5432}\x{5433}\x{5434}\x{5435}\x{5436}\x{5437}\x{5438}\x{5439}\x{543A}' . +'\x{543B}\x{543C}\x{543D}\x{543E}\x{543F}\x{5440}\x{5441}\x{5442}\x{5443}' . +'\x{5444}\x{5445}\x{5446}\x{5447}\x{5448}\x{5449}\x{544A}\x{544B}\x{544D}' . +'\x{544E}\x{544F}\x{5450}\x{5451}\x{5452}\x{5453}\x{5454}\x{5455}\x{5456}' . +'\x{5457}\x{5458}\x{5459}\x{545A}\x{545B}\x{545C}\x{545E}\x{545F}\x{5460}' . +'\x{5461}\x{5462}\x{5463}\x{5464}\x{5465}\x{5466}\x{5467}\x{5468}\x{546A}' . +'\x{546B}\x{546C}\x{546D}\x{546E}\x{546F}\x{5470}\x{5471}\x{5472}\x{5473}' . +'\x{5474}\x{5475}\x{5476}\x{5477}\x{5478}\x{5479}\x{547A}\x{547B}\x{547C}' . +'\x{547D}\x{547E}\x{547F}\x{5480}\x{5481}\x{5482}\x{5483}\x{5484}\x{5485}' . +'\x{5486}\x{5487}\x{5488}\x{5489}\x{548B}\x{548C}\x{548D}\x{548E}\x{548F}' . +'\x{5490}\x{5491}\x{5492}\x{5493}\x{5494}\x{5495}\x{5496}\x{5497}\x{5498}' . +'\x{5499}\x{549A}\x{549B}\x{549C}\x{549D}\x{549E}\x{549F}\x{54A0}\x{54A1}' . +'\x{54A2}\x{54A3}\x{54A4}\x{54A5}\x{54A6}\x{54A7}\x{54A8}\x{54A9}\x{54AA}' . +'\x{54AB}\x{54AC}\x{54AD}\x{54AE}\x{54AF}\x{54B0}\x{54B1}\x{54B2}\x{54B3}' . +'\x{54B4}\x{54B6}\x{54B7}\x{54B8}\x{54B9}\x{54BA}\x{54BB}\x{54BC}\x{54BD}' . +'\x{54BE}\x{54BF}\x{54C0}\x{54C1}\x{54C2}\x{54C3}\x{54C4}\x{54C5}\x{54C6}' . +'\x{54C7}\x{54C8}\x{54C9}\x{54CA}\x{54CB}\x{54CC}\x{54CD}\x{54CE}\x{54CF}' . +'\x{54D0}\x{54D1}\x{54D2}\x{54D3}\x{54D4}\x{54D5}\x{54D6}\x{54D7}\x{54D8}' . +'\x{54D9}\x{54DA}\x{54DB}\x{54DC}\x{54DD}\x{54DE}\x{54DF}\x{54E0}\x{54E1}' . +'\x{54E2}\x{54E3}\x{54E4}\x{54E5}\x{54E6}\x{54E7}\x{54E8}\x{54E9}\x{54EA}' . +'\x{54EB}\x{54EC}\x{54ED}\x{54EE}\x{54EF}\x{54F0}\x{54F1}\x{54F2}\x{54F3}' . +'\x{54F4}\x{54F5}\x{54F7}\x{54F8}\x{54F9}\x{54FA}\x{54FB}\x{54FC}\x{54FD}' . +'\x{54FE}\x{54FF}\x{5500}\x{5501}\x{5502}\x{5503}\x{5504}\x{5505}\x{5506}' . +'\x{5507}\x{5508}\x{5509}\x{550A}\x{550B}\x{550C}\x{550D}\x{550E}\x{550F}' . +'\x{5510}\x{5511}\x{5512}\x{5513}\x{5514}\x{5516}\x{5517}\x{551A}\x{551B}' . +'\x{551C}\x{551D}\x{551E}\x{551F}\x{5520}\x{5521}\x{5522}\x{5523}\x{5524}' . +'\x{5525}\x{5526}\x{5527}\x{5528}\x{5529}\x{552A}\x{552B}\x{552C}\x{552D}' . +'\x{552E}\x{552F}\x{5530}\x{5531}\x{5532}\x{5533}\x{5534}\x{5535}\x{5536}' . +'\x{5537}\x{5538}\x{5539}\x{553A}\x{553B}\x{553C}\x{553D}\x{553E}\x{553F}' . +'\x{5540}\x{5541}\x{5542}\x{5543}\x{5544}\x{5545}\x{5546}\x{5548}\x{5549}' . +'\x{554A}\x{554B}\x{554C}\x{554D}\x{554E}\x{554F}\x{5550}\x{5551}\x{5552}' . +'\x{5553}\x{5554}\x{5555}\x{5556}\x{5557}\x{5558}\x{5559}\x{555A}\x{555B}' . +'\x{555C}\x{555D}\x{555E}\x{555F}\x{5561}\x{5562}\x{5563}\x{5564}\x{5565}' . +'\x{5566}\x{5567}\x{5568}\x{5569}\x{556A}\x{556B}\x{556C}\x{556D}\x{556E}' . +'\x{556F}\x{5570}\x{5571}\x{5572}\x{5573}\x{5574}\x{5575}\x{5576}\x{5577}' . +'\x{5578}\x{5579}\x{557B}\x{557C}\x{557D}\x{557E}\x{557F}\x{5580}\x{5581}' . +'\x{5582}\x{5583}\x{5584}\x{5585}\x{5586}\x{5587}\x{5588}\x{5589}\x{558A}' . +'\x{558B}\x{558C}\x{558D}\x{558E}\x{558F}\x{5590}\x{5591}\x{5592}\x{5593}' . +'\x{5594}\x{5595}\x{5596}\x{5597}\x{5598}\x{5599}\x{559A}\x{559B}\x{559C}' . +'\x{559D}\x{559E}\x{559F}\x{55A0}\x{55A1}\x{55A2}\x{55A3}\x{55A4}\x{55A5}' . +'\x{55A6}\x{55A7}\x{55A8}\x{55A9}\x{55AA}\x{55AB}\x{55AC}\x{55AD}\x{55AE}' . +'\x{55AF}\x{55B0}\x{55B1}\x{55B2}\x{55B3}\x{55B4}\x{55B5}\x{55B6}\x{55B7}' . +'\x{55B8}\x{55B9}\x{55BA}\x{55BB}\x{55BC}\x{55BD}\x{55BE}\x{55BF}\x{55C0}' . +'\x{55C1}\x{55C2}\x{55C3}\x{55C4}\x{55C5}\x{55C6}\x{55C7}\x{55C8}\x{55C9}' . +'\x{55CA}\x{55CB}\x{55CC}\x{55CD}\x{55CE}\x{55CF}\x{55D0}\x{55D1}\x{55D2}' . +'\x{55D3}\x{55D4}\x{55D5}\x{55D6}\x{55D7}\x{55D8}\x{55D9}\x{55DA}\x{55DB}' . +'\x{55DC}\x{55DD}\x{55DE}\x{55DF}\x{55E1}\x{55E2}\x{55E3}\x{55E4}\x{55E5}' . +'\x{55E6}\x{55E7}\x{55E8}\x{55E9}\x{55EA}\x{55EB}\x{55EC}\x{55ED}\x{55EE}' . +'\x{55EF}\x{55F0}\x{55F1}\x{55F2}\x{55F3}\x{55F4}\x{55F5}\x{55F6}\x{55F7}' . +'\x{55F9}\x{55FA}\x{55FB}\x{55FC}\x{55FD}\x{55FE}\x{55FF}\x{5600}\x{5601}' . +'\x{5602}\x{5603}\x{5604}\x{5606}\x{5607}\x{5608}\x{5609}\x{560C}\x{560D}' . +'\x{560E}\x{560F}\x{5610}\x{5611}\x{5612}\x{5613}\x{5614}\x{5615}\x{5616}' . +'\x{5617}\x{5618}\x{5619}\x{561A}\x{561B}\x{561C}\x{561D}\x{561E}\x{561F}' . +'\x{5621}\x{5622}\x{5623}\x{5624}\x{5625}\x{5626}\x{5627}\x{5628}\x{5629}' . +'\x{562A}\x{562C}\x{562D}\x{562E}\x{562F}\x{5630}\x{5631}\x{5632}\x{5633}' . +'\x{5634}\x{5635}\x{5636}\x{5638}\x{5639}\x{563A}\x{563B}\x{563D}\x{563E}' . +'\x{563F}\x{5640}\x{5641}\x{5642}\x{5643}\x{5645}\x{5646}\x{5647}\x{5648}' . +'\x{5649}\x{564A}\x{564C}\x{564D}\x{564E}\x{564F}\x{5650}\x{5652}\x{5653}' . +'\x{5654}\x{5655}\x{5657}\x{5658}\x{5659}\x{565A}\x{565B}\x{565C}\x{565D}' . +'\x{565E}\x{5660}\x{5662}\x{5663}\x{5664}\x{5665}\x{5666}\x{5667}\x{5668}' . +'\x{5669}\x{566A}\x{566B}\x{566C}\x{566D}\x{566E}\x{566F}\x{5670}\x{5671}' . +'\x{5672}\x{5673}\x{5674}\x{5676}\x{5677}\x{5678}\x{5679}\x{567A}\x{567B}' . +'\x{567C}\x{567E}\x{567F}\x{5680}\x{5681}\x{5682}\x{5683}\x{5684}\x{5685}' . +'\x{5686}\x{5687}\x{568A}\x{568C}\x{568D}\x{568E}\x{568F}\x{5690}\x{5691}' . +'\x{5692}\x{5693}\x{5694}\x{5695}\x{5697}\x{5698}\x{5699}\x{569A}\x{569B}' . +'\x{569C}\x{569D}\x{569F}\x{56A0}\x{56A1}\x{56A3}\x{56A4}\x{56A5}\x{56A6}' . +'\x{56A7}\x{56A8}\x{56A9}\x{56AA}\x{56AB}\x{56AC}\x{56AD}\x{56AE}\x{56AF}' . +'\x{56B0}\x{56B1}\x{56B2}\x{56B3}\x{56B4}\x{56B5}\x{56B6}\x{56B7}\x{56B8}' . +'\x{56B9}\x{56BB}\x{56BC}\x{56BD}\x{56BE}\x{56BF}\x{56C0}\x{56C1}\x{56C2}' . +'\x{56C3}\x{56C4}\x{56C5}\x{56C6}\x{56C7}\x{56C8}\x{56C9}\x{56CA}\x{56CB}' . +'\x{56CC}\x{56CD}\x{56CE}\x{56D0}\x{56D1}\x{56D2}\x{56D3}\x{56D4}\x{56D5}' . +'\x{56D6}\x{56D7}\x{56D8}\x{56DA}\x{56DB}\x{56DC}\x{56DD}\x{56DE}\x{56DF}' . +'\x{56E0}\x{56E1}\x{56E2}\x{56E3}\x{56E4}\x{56E5}\x{56E7}\x{56E8}\x{56E9}' . +'\x{56EA}\x{56EB}\x{56EC}\x{56ED}\x{56EE}\x{56EF}\x{56F0}\x{56F1}\x{56F2}' . +'\x{56F3}\x{56F4}\x{56F5}\x{56F7}\x{56F9}\x{56FA}\x{56FD}\x{56FE}\x{56FF}' . +'\x{5700}\x{5701}\x{5702}\x{5703}\x{5704}\x{5706}\x{5707}\x{5708}\x{5709}' . +'\x{570A}\x{570B}\x{570C}\x{570D}\x{570E}\x{570F}\x{5710}\x{5712}\x{5713}' . +'\x{5714}\x{5715}\x{5716}\x{5718}\x{5719}\x{571A}\x{571B}\x{571C}\x{571D}' . +'\x{571E}\x{571F}\x{5720}\x{5722}\x{5723}\x{5725}\x{5726}\x{5727}\x{5728}' . +'\x{5729}\x{572A}\x{572B}\x{572C}\x{572D}\x{572E}\x{572F}\x{5730}\x{5731}' . +'\x{5732}\x{5733}\x{5734}\x{5735}\x{5736}\x{5737}\x{5738}\x{5739}\x{573A}' . +'\x{573B}\x{573C}\x{573E}\x{573F}\x{5740}\x{5741}\x{5742}\x{5744}\x{5745}' . +'\x{5746}\x{5747}\x{5749}\x{574A}\x{574B}\x{574C}\x{574D}\x{574E}\x{574F}' . +'\x{5750}\x{5751}\x{5752}\x{5753}\x{5754}\x{5757}\x{5759}\x{575A}\x{575B}' . +'\x{575C}\x{575D}\x{575E}\x{575F}\x{5760}\x{5761}\x{5762}\x{5764}\x{5765}' . +'\x{5766}\x{5767}\x{5768}\x{5769}\x{576A}\x{576B}\x{576C}\x{576D}\x{576F}' . +'\x{5770}\x{5771}\x{5772}\x{5773}\x{5774}\x{5775}\x{5776}\x{5777}\x{5779}' . +'\x{577A}\x{577B}\x{577C}\x{577D}\x{577E}\x{577F}\x{5780}\x{5782}\x{5783}' . +'\x{5784}\x{5785}\x{5786}\x{5788}\x{5789}\x{578A}\x{578B}\x{578C}\x{578D}' . +'\x{578E}\x{578F}\x{5790}\x{5791}\x{5792}\x{5793}\x{5794}\x{5795}\x{5797}' . +'\x{5798}\x{5799}\x{579A}\x{579B}\x{579C}\x{579D}\x{579E}\x{579F}\x{57A0}' . +'\x{57A1}\x{57A2}\x{57A3}\x{57A4}\x{57A5}\x{57A6}\x{57A7}\x{57A9}\x{57AA}' . +'\x{57AB}\x{57AC}\x{57AD}\x{57AE}\x{57AF}\x{57B0}\x{57B1}\x{57B2}\x{57B3}' . +'\x{57B4}\x{57B5}\x{57B6}\x{57B7}\x{57B8}\x{57B9}\x{57BA}\x{57BB}\x{57BC}' . +'\x{57BD}\x{57BE}\x{57BF}\x{57C0}\x{57C1}\x{57C2}\x{57C3}\x{57C4}\x{57C5}' . +'\x{57C6}\x{57C7}\x{57C8}\x{57C9}\x{57CB}\x{57CC}\x{57CD}\x{57CE}\x{57CF}' . +'\x{57D0}\x{57D2}\x{57D3}\x{57D4}\x{57D5}\x{57D6}\x{57D8}\x{57D9}\x{57DA}' . +'\x{57DC}\x{57DD}\x{57DF}\x{57E0}\x{57E1}\x{57E2}\x{57E3}\x{57E4}\x{57E5}' . +'\x{57E6}\x{57E7}\x{57E8}\x{57E9}\x{57EA}\x{57EB}\x{57EC}\x{57ED}\x{57EE}' . +'\x{57EF}\x{57F0}\x{57F1}\x{57F2}\x{57F3}\x{57F4}\x{57F5}\x{57F6}\x{57F7}' . +'\x{57F8}\x{57F9}\x{57FA}\x{57FB}\x{57FC}\x{57FD}\x{57FE}\x{57FF}\x{5800}' . +'\x{5801}\x{5802}\x{5803}\x{5804}\x{5805}\x{5806}\x{5807}\x{5808}\x{5809}' . +'\x{580A}\x{580B}\x{580C}\x{580D}\x{580E}\x{580F}\x{5810}\x{5811}\x{5812}' . +'\x{5813}\x{5814}\x{5815}\x{5816}\x{5819}\x{581A}\x{581B}\x{581C}\x{581D}' . +'\x{581E}\x{581F}\x{5820}\x{5821}\x{5822}\x{5823}\x{5824}\x{5825}\x{5826}' . +'\x{5827}\x{5828}\x{5829}\x{582A}\x{582B}\x{582C}\x{582D}\x{582E}\x{582F}' . +'\x{5830}\x{5831}\x{5832}\x{5833}\x{5834}\x{5835}\x{5836}\x{5837}\x{5838}' . +'\x{5839}\x{583A}\x{583B}\x{583C}\x{583D}\x{583E}\x{583F}\x{5840}\x{5842}' . +'\x{5843}\x{5844}\x{5845}\x{5846}\x{5847}\x{5848}\x{5849}\x{584A}\x{584B}' . +'\x{584C}\x{584D}\x{584E}\x{584F}\x{5851}\x{5852}\x{5853}\x{5854}\x{5855}' . +'\x{5857}\x{5858}\x{5859}\x{585A}\x{585B}\x{585C}\x{585D}\x{585E}\x{585F}' . +'\x{5861}\x{5862}\x{5863}\x{5864}\x{5865}\x{5868}\x{5869}\x{586A}\x{586B}' . +'\x{586C}\x{586D}\x{586E}\x{586F}\x{5870}\x{5871}\x{5872}\x{5873}\x{5874}' . +'\x{5875}\x{5876}\x{5878}\x{5879}\x{587A}\x{587B}\x{587C}\x{587D}\x{587E}' . +'\x{587F}\x{5880}\x{5881}\x{5882}\x{5883}\x{5884}\x{5885}\x{5886}\x{5887}' . +'\x{5888}\x{5889}\x{588A}\x{588B}\x{588C}\x{588D}\x{588E}\x{588F}\x{5890}' . +'\x{5891}\x{5892}\x{5893}\x{5894}\x{5896}\x{5897}\x{5898}\x{5899}\x{589A}' . +'\x{589B}\x{589C}\x{589D}\x{589E}\x{589F}\x{58A0}\x{58A1}\x{58A2}\x{58A3}' . +'\x{58A4}\x{58A5}\x{58A6}\x{58A7}\x{58A8}\x{58A9}\x{58AB}\x{58AC}\x{58AD}' . +'\x{58AE}\x{58AF}\x{58B0}\x{58B1}\x{58B2}\x{58B3}\x{58B4}\x{58B7}\x{58B8}' . +'\x{58B9}\x{58BA}\x{58BB}\x{58BC}\x{58BD}\x{58BE}\x{58BF}\x{58C1}\x{58C2}' . +'\x{58C5}\x{58C6}\x{58C7}\x{58C8}\x{58C9}\x{58CA}\x{58CB}\x{58CE}\x{58CF}' . +'\x{58D1}\x{58D2}\x{58D3}\x{58D4}\x{58D5}\x{58D6}\x{58D7}\x{58D8}\x{58D9}' . +'\x{58DA}\x{58DB}\x{58DD}\x{58DE}\x{58DF}\x{58E0}\x{58E2}\x{58E3}\x{58E4}' . +'\x{58E5}\x{58E7}\x{58E8}\x{58E9}\x{58EA}\x{58EB}\x{58EC}\x{58ED}\x{58EE}' . +'\x{58EF}\x{58F0}\x{58F1}\x{58F2}\x{58F3}\x{58F4}\x{58F6}\x{58F7}\x{58F8}' . +'\x{58F9}\x{58FA}\x{58FB}\x{58FC}\x{58FD}\x{58FE}\x{58FF}\x{5900}\x{5902}' . +'\x{5903}\x{5904}\x{5906}\x{5907}\x{5909}\x{590A}\x{590B}\x{590C}\x{590D}' . +'\x{590E}\x{590F}\x{5910}\x{5912}\x{5914}\x{5915}\x{5916}\x{5917}\x{5918}' . +'\x{5919}\x{591A}\x{591B}\x{591C}\x{591D}\x{591E}\x{591F}\x{5920}\x{5921}' . +'\x{5922}\x{5924}\x{5925}\x{5926}\x{5927}\x{5928}\x{5929}\x{592A}\x{592B}' . +'\x{592C}\x{592D}\x{592E}\x{592F}\x{5930}\x{5931}\x{5932}\x{5934}\x{5935}' . +'\x{5937}\x{5938}\x{5939}\x{593A}\x{593B}\x{593C}\x{593D}\x{593E}\x{593F}' . +'\x{5940}\x{5941}\x{5942}\x{5943}\x{5944}\x{5945}\x{5946}\x{5947}\x{5948}' . +'\x{5949}\x{594A}\x{594B}\x{594C}\x{594D}\x{594E}\x{594F}\x{5950}\x{5951}' . +'\x{5952}\x{5953}\x{5954}\x{5955}\x{5956}\x{5957}\x{5958}\x{595A}\x{595C}' . +'\x{595D}\x{595E}\x{595F}\x{5960}\x{5961}\x{5962}\x{5963}\x{5964}\x{5965}' . +'\x{5966}\x{5967}\x{5968}\x{5969}\x{596A}\x{596B}\x{596C}\x{596D}\x{596E}' . +'\x{596F}\x{5970}\x{5971}\x{5972}\x{5973}\x{5974}\x{5975}\x{5976}\x{5977}' . +'\x{5978}\x{5979}\x{597A}\x{597B}\x{597C}\x{597D}\x{597E}\x{597F}\x{5980}' . +'\x{5981}\x{5982}\x{5983}\x{5984}\x{5985}\x{5986}\x{5987}\x{5988}\x{5989}' . +'\x{598A}\x{598B}\x{598C}\x{598D}\x{598E}\x{598F}\x{5990}\x{5991}\x{5992}' . +'\x{5993}\x{5994}\x{5995}\x{5996}\x{5997}\x{5998}\x{5999}\x{599A}\x{599C}' . +'\x{599D}\x{599E}\x{599F}\x{59A0}\x{59A1}\x{59A2}\x{59A3}\x{59A4}\x{59A5}' . +'\x{59A6}\x{59A7}\x{59A8}\x{59A9}\x{59AA}\x{59AB}\x{59AC}\x{59AD}\x{59AE}' . +'\x{59AF}\x{59B0}\x{59B1}\x{59B2}\x{59B3}\x{59B4}\x{59B5}\x{59B6}\x{59B8}' . +'\x{59B9}\x{59BA}\x{59BB}\x{59BC}\x{59BD}\x{59BE}\x{59BF}\x{59C0}\x{59C1}' . +'\x{59C2}\x{59C3}\x{59C4}\x{59C5}\x{59C6}\x{59C7}\x{59C8}\x{59C9}\x{59CA}' . +'\x{59CB}\x{59CC}\x{59CD}\x{59CE}\x{59CF}\x{59D0}\x{59D1}\x{59D2}\x{59D3}' . +'\x{59D4}\x{59D5}\x{59D6}\x{59D7}\x{59D8}\x{59D9}\x{59DA}\x{59DB}\x{59DC}' . +'\x{59DD}\x{59DE}\x{59DF}\x{59E0}\x{59E1}\x{59E2}\x{59E3}\x{59E4}\x{59E5}' . +'\x{59E6}\x{59E8}\x{59E9}\x{59EA}\x{59EB}\x{59EC}\x{59ED}\x{59EE}\x{59EF}' . +'\x{59F0}\x{59F1}\x{59F2}\x{59F3}\x{59F4}\x{59F5}\x{59F6}\x{59F7}\x{59F8}' . +'\x{59F9}\x{59FA}\x{59FB}\x{59FC}\x{59FD}\x{59FE}\x{59FF}\x{5A00}\x{5A01}' . +'\x{5A02}\x{5A03}\x{5A04}\x{5A05}\x{5A06}\x{5A07}\x{5A08}\x{5A09}\x{5A0A}' . +'\x{5A0B}\x{5A0C}\x{5A0D}\x{5A0E}\x{5A0F}\x{5A10}\x{5A11}\x{5A12}\x{5A13}' . +'\x{5A14}\x{5A15}\x{5A16}\x{5A17}\x{5A18}\x{5A19}\x{5A1A}\x{5A1B}\x{5A1C}' . +'\x{5A1D}\x{5A1E}\x{5A1F}\x{5A20}\x{5A21}\x{5A22}\x{5A23}\x{5A25}\x{5A27}' . +'\x{5A28}\x{5A29}\x{5A2A}\x{5A2B}\x{5A2D}\x{5A2E}\x{5A2F}\x{5A31}\x{5A32}' . +'\x{5A33}\x{5A34}\x{5A35}\x{5A36}\x{5A37}\x{5A38}\x{5A39}\x{5A3A}\x{5A3B}' . +'\x{5A3C}\x{5A3D}\x{5A3E}\x{5A3F}\x{5A40}\x{5A41}\x{5A42}\x{5A43}\x{5A44}' . +'\x{5A45}\x{5A46}\x{5A47}\x{5A48}\x{5A49}\x{5A4A}\x{5A4B}\x{5A4C}\x{5A4D}' . +'\x{5A4E}\x{5A4F}\x{5A50}\x{5A51}\x{5A52}\x{5A53}\x{5A55}\x{5A56}\x{5A57}' . +'\x{5A58}\x{5A5A}\x{5A5B}\x{5A5C}\x{5A5D}\x{5A5E}\x{5A5F}\x{5A60}\x{5A61}' . +'\x{5A62}\x{5A63}\x{5A64}\x{5A65}\x{5A66}\x{5A67}\x{5A68}\x{5A69}\x{5A6A}' . +'\x{5A6B}\x{5A6C}\x{5A6D}\x{5A6E}\x{5A70}\x{5A72}\x{5A73}\x{5A74}\x{5A75}' . +'\x{5A76}\x{5A77}\x{5A78}\x{5A79}\x{5A7A}\x{5A7B}\x{5A7C}\x{5A7D}\x{5A7E}' . +'\x{5A7F}\x{5A80}\x{5A81}\x{5A82}\x{5A83}\x{5A84}\x{5A85}\x{5A86}\x{5A88}' . +'\x{5A89}\x{5A8A}\x{5A8B}\x{5A8C}\x{5A8E}\x{5A8F}\x{5A90}\x{5A91}\x{5A92}' . +'\x{5A93}\x{5A94}\x{5A95}\x{5A96}\x{5A97}\x{5A98}\x{5A99}\x{5A9A}\x{5A9B}' . +'\x{5A9C}\x{5A9D}\x{5A9E}\x{5A9F}\x{5AA0}\x{5AA1}\x{5AA2}\x{5AA3}\x{5AA4}' . +'\x{5AA5}\x{5AA6}\x{5AA7}\x{5AA8}\x{5AA9}\x{5AAA}\x{5AAC}\x{5AAD}\x{5AAE}' . +'\x{5AAF}\x{5AB0}\x{5AB1}\x{5AB2}\x{5AB3}\x{5AB4}\x{5AB5}\x{5AB6}\x{5AB7}' . +'\x{5AB8}\x{5AB9}\x{5ABA}\x{5ABB}\x{5ABC}\x{5ABD}\x{5ABE}\x{5ABF}\x{5AC0}' . +'\x{5AC1}\x{5AC2}\x{5AC3}\x{5AC4}\x{5AC5}\x{5AC6}\x{5AC7}\x{5AC8}\x{5AC9}' . +'\x{5ACA}\x{5ACB}\x{5ACC}\x{5ACD}\x{5ACE}\x{5ACF}\x{5AD1}\x{5AD2}\x{5AD4}' . +'\x{5AD5}\x{5AD6}\x{5AD7}\x{5AD8}\x{5AD9}\x{5ADA}\x{5ADB}\x{5ADC}\x{5ADD}' . +'\x{5ADE}\x{5ADF}\x{5AE0}\x{5AE1}\x{5AE2}\x{5AE3}\x{5AE4}\x{5AE5}\x{5AE6}' . +'\x{5AE7}\x{5AE8}\x{5AE9}\x{5AEA}\x{5AEB}\x{5AEC}\x{5AED}\x{5AEE}\x{5AF1}' . +'\x{5AF2}\x{5AF3}\x{5AF4}\x{5AF5}\x{5AF6}\x{5AF7}\x{5AF8}\x{5AF9}\x{5AFA}' . +'\x{5AFB}\x{5AFC}\x{5AFD}\x{5AFE}\x{5AFF}\x{5B00}\x{5B01}\x{5B02}\x{5B03}' . +'\x{5B04}\x{5B05}\x{5B06}\x{5B07}\x{5B08}\x{5B09}\x{5B0B}\x{5B0C}\x{5B0E}' . +'\x{5B0F}\x{5B10}\x{5B11}\x{5B12}\x{5B13}\x{5B14}\x{5B15}\x{5B16}\x{5B17}' . +'\x{5B18}\x{5B19}\x{5B1A}\x{5B1B}\x{5B1C}\x{5B1D}\x{5B1E}\x{5B1F}\x{5B20}' . +'\x{5B21}\x{5B22}\x{5B23}\x{5B24}\x{5B25}\x{5B26}\x{5B27}\x{5B28}\x{5B29}' . +'\x{5B2A}\x{5B2B}\x{5B2C}\x{5B2D}\x{5B2E}\x{5B2F}\x{5B30}\x{5B31}\x{5B32}' . +'\x{5B33}\x{5B34}\x{5B35}\x{5B36}\x{5B37}\x{5B38}\x{5B3A}\x{5B3B}\x{5B3C}' . +'\x{5B3D}\x{5B3E}\x{5B3F}\x{5B40}\x{5B41}\x{5B42}\x{5B43}\x{5B44}\x{5B45}' . +'\x{5B47}\x{5B48}\x{5B49}\x{5B4A}\x{5B4B}\x{5B4C}\x{5B4D}\x{5B4E}\x{5B50}' . +'\x{5B51}\x{5B53}\x{5B54}\x{5B55}\x{5B56}\x{5B57}\x{5B58}\x{5B59}\x{5B5A}' . +'\x{5B5B}\x{5B5C}\x{5B5D}\x{5B5E}\x{5B5F}\x{5B62}\x{5B63}\x{5B64}\x{5B65}' . +'\x{5B66}\x{5B67}\x{5B68}\x{5B69}\x{5B6A}\x{5B6B}\x{5B6C}\x{5B6D}\x{5B6E}' . +'\x{5B70}\x{5B71}\x{5B72}\x{5B73}\x{5B74}\x{5B75}\x{5B76}\x{5B77}\x{5B78}' . +'\x{5B7A}\x{5B7B}\x{5B7C}\x{5B7D}\x{5B7F}\x{5B80}\x{5B81}\x{5B82}\x{5B83}' . +'\x{5B84}\x{5B85}\x{5B87}\x{5B88}\x{5B89}\x{5B8A}\x{5B8B}\x{5B8C}\x{5B8D}' . +'\x{5B8E}\x{5B8F}\x{5B91}\x{5B92}\x{5B93}\x{5B94}\x{5B95}\x{5B96}\x{5B97}' . +'\x{5B98}\x{5B99}\x{5B9A}\x{5B9B}\x{5B9C}\x{5B9D}\x{5B9E}\x{5B9F}\x{5BA0}' . +'\x{5BA1}\x{5BA2}\x{5BA3}\x{5BA4}\x{5BA5}\x{5BA6}\x{5BA7}\x{5BA8}\x{5BAA}' . +'\x{5BAB}\x{5BAC}\x{5BAD}\x{5BAE}\x{5BAF}\x{5BB0}\x{5BB1}\x{5BB3}\x{5BB4}' . +'\x{5BB5}\x{5BB6}\x{5BB8}\x{5BB9}\x{5BBA}\x{5BBB}\x{5BBD}\x{5BBE}\x{5BBF}' . +'\x{5BC0}\x{5BC1}\x{5BC2}\x{5BC3}\x{5BC4}\x{5BC5}\x{5BC6}\x{5BC7}\x{5BCA}' . +'\x{5BCB}\x{5BCC}\x{5BCD}\x{5BCE}\x{5BCF}\x{5BD0}\x{5BD1}\x{5BD2}\x{5BD3}' . +'\x{5BD4}\x{5BD5}\x{5BD6}\x{5BD8}\x{5BD9}\x{5BDB}\x{5BDC}\x{5BDD}\x{5BDE}' . +'\x{5BDF}\x{5BE0}\x{5BE1}\x{5BE2}\x{5BE3}\x{5BE4}\x{5BE5}\x{5BE6}\x{5BE7}' . +'\x{5BE8}\x{5BE9}\x{5BEA}\x{5BEB}\x{5BEC}\x{5BED}\x{5BEE}\x{5BEF}\x{5BF0}' . +'\x{5BF1}\x{5BF2}\x{5BF3}\x{5BF4}\x{5BF5}\x{5BF6}\x{5BF7}\x{5BF8}\x{5BF9}' . +'\x{5BFA}\x{5BFB}\x{5BFC}\x{5BFD}\x{5BFF}\x{5C01}\x{5C03}\x{5C04}\x{5C05}' . +'\x{5C06}\x{5C07}\x{5C08}\x{5C09}\x{5C0A}\x{5C0B}\x{5C0C}\x{5C0D}\x{5C0E}' . +'\x{5C0F}\x{5C10}\x{5C11}\x{5C12}\x{5C13}\x{5C14}\x{5C15}\x{5C16}\x{5C17}' . +'\x{5C18}\x{5C19}\x{5C1A}\x{5C1C}\x{5C1D}\x{5C1E}\x{5C1F}\x{5C20}\x{5C21}' . +'\x{5C22}\x{5C24}\x{5C25}\x{5C27}\x{5C28}\x{5C2A}\x{5C2B}\x{5C2C}\x{5C2D}' . +'\x{5C2E}\x{5C2F}\x{5C30}\x{5C31}\x{5C32}\x{5C33}\x{5C34}\x{5C35}\x{5C37}' . +'\x{5C38}\x{5C39}\x{5C3A}\x{5C3B}\x{5C3C}\x{5C3D}\x{5C3E}\x{5C3F}\x{5C40}' . +'\x{5C41}\x{5C42}\x{5C43}\x{5C44}\x{5C45}\x{5C46}\x{5C47}\x{5C48}\x{5C49}' . +'\x{5C4A}\x{5C4B}\x{5C4C}\x{5C4D}\x{5C4E}\x{5C4F}\x{5C50}\x{5C51}\x{5C52}' . +'\x{5C53}\x{5C54}\x{5C55}\x{5C56}\x{5C57}\x{5C58}\x{5C59}\x{5C5B}\x{5C5C}' . +'\x{5C5D}\x{5C5E}\x{5C5F}\x{5C60}\x{5C61}\x{5C62}\x{5C63}\x{5C64}\x{5C65}' . +'\x{5C66}\x{5C67}\x{5C68}\x{5C69}\x{5C6A}\x{5C6B}\x{5C6C}\x{5C6D}\x{5C6E}' . +'\x{5C6F}\x{5C70}\x{5C71}\x{5C72}\x{5C73}\x{5C74}\x{5C75}\x{5C76}\x{5C77}' . +'\x{5C78}\x{5C79}\x{5C7A}\x{5C7B}\x{5C7C}\x{5C7D}\x{5C7E}\x{5C7F}\x{5C80}' . +'\x{5C81}\x{5C82}\x{5C83}\x{5C84}\x{5C86}\x{5C87}\x{5C88}\x{5C89}\x{5C8A}' . +'\x{5C8B}\x{5C8C}\x{5C8D}\x{5C8E}\x{5C8F}\x{5C90}\x{5C91}\x{5C92}\x{5C93}' . +'\x{5C94}\x{5C95}\x{5C96}\x{5C97}\x{5C98}\x{5C99}\x{5C9A}\x{5C9B}\x{5C9C}' . +'\x{5C9D}\x{5C9E}\x{5C9F}\x{5CA0}\x{5CA1}\x{5CA2}\x{5CA3}\x{5CA4}\x{5CA5}' . +'\x{5CA6}\x{5CA7}\x{5CA8}\x{5CA9}\x{5CAA}\x{5CAB}\x{5CAC}\x{5CAD}\x{5CAE}' . +'\x{5CAF}\x{5CB0}\x{5CB1}\x{5CB2}\x{5CB3}\x{5CB5}\x{5CB6}\x{5CB7}\x{5CB8}' . +'\x{5CBA}\x{5CBB}\x{5CBC}\x{5CBD}\x{5CBE}\x{5CBF}\x{5CC1}\x{5CC2}\x{5CC3}' . +'\x{5CC4}\x{5CC5}\x{5CC6}\x{5CC7}\x{5CC8}\x{5CC9}\x{5CCA}\x{5CCB}\x{5CCC}' . +'\x{5CCD}\x{5CCE}\x{5CCF}\x{5CD0}\x{5CD1}\x{5CD2}\x{5CD3}\x{5CD4}\x{5CD6}' . +'\x{5CD7}\x{5CD8}\x{5CD9}\x{5CDA}\x{5CDB}\x{5CDC}\x{5CDE}\x{5CDF}\x{5CE0}' . +'\x{5CE1}\x{5CE2}\x{5CE3}\x{5CE4}\x{5CE5}\x{5CE6}\x{5CE7}\x{5CE8}\x{5CE9}' . +'\x{5CEA}\x{5CEB}\x{5CEC}\x{5CED}\x{5CEE}\x{5CEF}\x{5CF0}\x{5CF1}\x{5CF2}' . +'\x{5CF3}\x{5CF4}\x{5CF6}\x{5CF7}\x{5CF8}\x{5CF9}\x{5CFA}\x{5CFB}\x{5CFC}' . +'\x{5CFD}\x{5CFE}\x{5CFF}\x{5D00}\x{5D01}\x{5D02}\x{5D03}\x{5D04}\x{5D05}' . +'\x{5D06}\x{5D07}\x{5D08}\x{5D09}\x{5D0A}\x{5D0B}\x{5D0C}\x{5D0D}\x{5D0E}' . +'\x{5D0F}\x{5D10}\x{5D11}\x{5D12}\x{5D13}\x{5D14}\x{5D15}\x{5D16}\x{5D17}' . +'\x{5D18}\x{5D19}\x{5D1A}\x{5D1B}\x{5D1C}\x{5D1D}\x{5D1E}\x{5D1F}\x{5D20}' . +'\x{5D21}\x{5D22}\x{5D23}\x{5D24}\x{5D25}\x{5D26}\x{5D27}\x{5D28}\x{5D29}' . +'\x{5D2A}\x{5D2C}\x{5D2D}\x{5D2E}\x{5D30}\x{5D31}\x{5D32}\x{5D33}\x{5D34}' . +'\x{5D35}\x{5D36}\x{5D37}\x{5D38}\x{5D39}\x{5D3A}\x{5D3C}\x{5D3D}\x{5D3E}' . +'\x{5D3F}\x{5D40}\x{5D41}\x{5D42}\x{5D43}\x{5D44}\x{5D45}\x{5D46}\x{5D47}' . +'\x{5D48}\x{5D49}\x{5D4A}\x{5D4B}\x{5D4C}\x{5D4D}\x{5D4E}\x{5D4F}\x{5D50}' . +'\x{5D51}\x{5D52}\x{5D54}\x{5D55}\x{5D56}\x{5D58}\x{5D59}\x{5D5A}\x{5D5B}' . +'\x{5D5D}\x{5D5E}\x{5D5F}\x{5D61}\x{5D62}\x{5D63}\x{5D64}\x{5D65}\x{5D66}' . +'\x{5D67}\x{5D68}\x{5D69}\x{5D6A}\x{5D6B}\x{5D6C}\x{5D6D}\x{5D6E}\x{5D6F}' . +'\x{5D70}\x{5D71}\x{5D72}\x{5D73}\x{5D74}\x{5D75}\x{5D76}\x{5D77}\x{5D78}' . +'\x{5D79}\x{5D7A}\x{5D7B}\x{5D7C}\x{5D7D}\x{5D7E}\x{5D7F}\x{5D80}\x{5D81}' . +'\x{5D82}\x{5D84}\x{5D85}\x{5D86}\x{5D87}\x{5D88}\x{5D89}\x{5D8A}\x{5D8B}' . +'\x{5D8C}\x{5D8D}\x{5D8E}\x{5D8F}\x{5D90}\x{5D91}\x{5D92}\x{5D93}\x{5D94}' . +'\x{5D95}\x{5D97}\x{5D98}\x{5D99}\x{5D9A}\x{5D9B}\x{5D9C}\x{5D9D}\x{5D9E}' . +'\x{5D9F}\x{5DA0}\x{5DA1}\x{5DA2}\x{5DA5}\x{5DA6}\x{5DA7}\x{5DA8}\x{5DA9}' . +'\x{5DAA}\x{5DAC}\x{5DAD}\x{5DAE}\x{5DAF}\x{5DB0}\x{5DB1}\x{5DB2}\x{5DB4}' . +'\x{5DB5}\x{5DB6}\x{5DB7}\x{5DB8}\x{5DBA}\x{5DBB}\x{5DBC}\x{5DBD}\x{5DBE}' . +'\x{5DBF}\x{5DC0}\x{5DC1}\x{5DC2}\x{5DC3}\x{5DC5}\x{5DC6}\x{5DC7}\x{5DC8}' . +'\x{5DC9}\x{5DCA}\x{5DCB}\x{5DCC}\x{5DCD}\x{5DCE}\x{5DCF}\x{5DD0}\x{5DD1}' . +'\x{5DD2}\x{5DD3}\x{5DD4}\x{5DD5}\x{5DD6}\x{5DD8}\x{5DD9}\x{5DDB}\x{5DDD}' . +'\x{5DDE}\x{5DDF}\x{5DE0}\x{5DE1}\x{5DE2}\x{5DE3}\x{5DE4}\x{5DE5}\x{5DE6}' . +'\x{5DE7}\x{5DE8}\x{5DE9}\x{5DEA}\x{5DEB}\x{5DEC}\x{5DED}\x{5DEE}\x{5DEF}' . +'\x{5DF0}\x{5DF1}\x{5DF2}\x{5DF3}\x{5DF4}\x{5DF5}\x{5DF7}\x{5DF8}\x{5DF9}' . +'\x{5DFA}\x{5DFB}\x{5DFC}\x{5DFD}\x{5DFE}\x{5DFF}\x{5E00}\x{5E01}\x{5E02}' . +'\x{5E03}\x{5E04}\x{5E05}\x{5E06}\x{5E07}\x{5E08}\x{5E09}\x{5E0A}\x{5E0B}' . +'\x{5E0C}\x{5E0D}\x{5E0E}\x{5E0F}\x{5E10}\x{5E11}\x{5E13}\x{5E14}\x{5E15}' . +'\x{5E16}\x{5E17}\x{5E18}\x{5E19}\x{5E1A}\x{5E1B}\x{5E1C}\x{5E1D}\x{5E1E}' . +'\x{5E1F}\x{5E20}\x{5E21}\x{5E22}\x{5E23}\x{5E24}\x{5E25}\x{5E26}\x{5E27}' . +'\x{5E28}\x{5E29}\x{5E2A}\x{5E2B}\x{5E2C}\x{5E2D}\x{5E2E}\x{5E2F}\x{5E30}' . +'\x{5E31}\x{5E32}\x{5E33}\x{5E34}\x{5E35}\x{5E36}\x{5E37}\x{5E38}\x{5E39}' . +'\x{5E3A}\x{5E3B}\x{5E3C}\x{5E3D}\x{5E3E}\x{5E40}\x{5E41}\x{5E42}\x{5E43}' . +'\x{5E44}\x{5E45}\x{5E46}\x{5E47}\x{5E49}\x{5E4A}\x{5E4B}\x{5E4C}\x{5E4D}' . +'\x{5E4E}\x{5E4F}\x{5E50}\x{5E52}\x{5E53}\x{5E54}\x{5E55}\x{5E56}\x{5E57}' . +'\x{5E58}\x{5E59}\x{5E5A}\x{5E5B}\x{5E5C}\x{5E5D}\x{5E5E}\x{5E5F}\x{5E60}' . +'\x{5E61}\x{5E62}\x{5E63}\x{5E64}\x{5E65}\x{5E66}\x{5E67}\x{5E68}\x{5E69}' . +'\x{5E6A}\x{5E6B}\x{5E6C}\x{5E6D}\x{5E6E}\x{5E6F}\x{5E70}\x{5E71}\x{5E72}' . +'\x{5E73}\x{5E74}\x{5E75}\x{5E76}\x{5E77}\x{5E78}\x{5E79}\x{5E7A}\x{5E7B}' . +'\x{5E7C}\x{5E7D}\x{5E7E}\x{5E7F}\x{5E80}\x{5E81}\x{5E82}\x{5E83}\x{5E84}' . +'\x{5E85}\x{5E86}\x{5E87}\x{5E88}\x{5E89}\x{5E8A}\x{5E8B}\x{5E8C}\x{5E8D}' . +'\x{5E8E}\x{5E8F}\x{5E90}\x{5E91}\x{5E93}\x{5E94}\x{5E95}\x{5E96}\x{5E97}' . +'\x{5E98}\x{5E99}\x{5E9A}\x{5E9B}\x{5E9C}\x{5E9D}\x{5E9E}\x{5E9F}\x{5EA0}' . +'\x{5EA1}\x{5EA2}\x{5EA3}\x{5EA4}\x{5EA5}\x{5EA6}\x{5EA7}\x{5EA8}\x{5EA9}' . +'\x{5EAA}\x{5EAB}\x{5EAC}\x{5EAD}\x{5EAE}\x{5EAF}\x{5EB0}\x{5EB1}\x{5EB2}' . +'\x{5EB3}\x{5EB4}\x{5EB5}\x{5EB6}\x{5EB7}\x{5EB8}\x{5EB9}\x{5EBB}\x{5EBC}' . +'\x{5EBD}\x{5EBE}\x{5EBF}\x{5EC1}\x{5EC2}\x{5EC3}\x{5EC4}\x{5EC5}\x{5EC6}' . +'\x{5EC7}\x{5EC8}\x{5EC9}\x{5ECA}\x{5ECB}\x{5ECC}\x{5ECD}\x{5ECE}\x{5ECF}' . +'\x{5ED0}\x{5ED1}\x{5ED2}\x{5ED3}\x{5ED4}\x{5ED5}\x{5ED6}\x{5ED7}\x{5ED8}' . +'\x{5ED9}\x{5EDA}\x{5EDB}\x{5EDC}\x{5EDD}\x{5EDE}\x{5EDF}\x{5EE0}\x{5EE1}' . +'\x{5EE2}\x{5EE3}\x{5EE4}\x{5EE5}\x{5EE6}\x{5EE7}\x{5EE8}\x{5EE9}\x{5EEA}' . +'\x{5EEC}\x{5EED}\x{5EEE}\x{5EEF}\x{5EF0}\x{5EF1}\x{5EF2}\x{5EF3}\x{5EF4}' . +'\x{5EF5}\x{5EF6}\x{5EF7}\x{5EF8}\x{5EFA}\x{5EFB}\x{5EFC}\x{5EFD}\x{5EFE}' . +'\x{5EFF}\x{5F00}\x{5F01}\x{5F02}\x{5F03}\x{5F04}\x{5F05}\x{5F06}\x{5F07}' . +'\x{5F08}\x{5F0A}\x{5F0B}\x{5F0C}\x{5F0D}\x{5F0F}\x{5F11}\x{5F12}\x{5F13}' . +'\x{5F14}\x{5F15}\x{5F16}\x{5F17}\x{5F18}\x{5F19}\x{5F1A}\x{5F1B}\x{5F1C}' . +'\x{5F1D}\x{5F1E}\x{5F1F}\x{5F20}\x{5F21}\x{5F22}\x{5F23}\x{5F24}\x{5F25}' . +'\x{5F26}\x{5F27}\x{5F28}\x{5F29}\x{5F2A}\x{5F2B}\x{5F2C}\x{5F2D}\x{5F2E}' . +'\x{5F2F}\x{5F30}\x{5F31}\x{5F32}\x{5F33}\x{5F34}\x{5F35}\x{5F36}\x{5F37}' . +'\x{5F38}\x{5F39}\x{5F3A}\x{5F3C}\x{5F3E}\x{5F3F}\x{5F40}\x{5F41}\x{5F42}' . +'\x{5F43}\x{5F44}\x{5F45}\x{5F46}\x{5F47}\x{5F48}\x{5F49}\x{5F4A}\x{5F4B}' . +'\x{5F4C}\x{5F4D}\x{5F4E}\x{5F4F}\x{5F50}\x{5F51}\x{5F52}\x{5F53}\x{5F54}' . +'\x{5F55}\x{5F56}\x{5F57}\x{5F58}\x{5F59}\x{5F5A}\x{5F5B}\x{5F5C}\x{5F5D}' . +'\x{5F5E}\x{5F5F}\x{5F60}\x{5F61}\x{5F62}\x{5F63}\x{5F64}\x{5F65}\x{5F66}' . +'\x{5F67}\x{5F68}\x{5F69}\x{5F6A}\x{5F6B}\x{5F6C}\x{5F6D}\x{5F6E}\x{5F6F}' . +'\x{5F70}\x{5F71}\x{5F72}\x{5F73}\x{5F74}\x{5F75}\x{5F76}\x{5F77}\x{5F78}' . +'\x{5F79}\x{5F7A}\x{5F7B}\x{5F7C}\x{5F7D}\x{5F7E}\x{5F7F}\x{5F80}\x{5F81}' . +'\x{5F82}\x{5F83}\x{5F84}\x{5F85}\x{5F86}\x{5F87}\x{5F88}\x{5F89}\x{5F8A}' . +'\x{5F8B}\x{5F8C}\x{5F8D}\x{5F8E}\x{5F90}\x{5F91}\x{5F92}\x{5F93}\x{5F94}' . +'\x{5F95}\x{5F96}\x{5F97}\x{5F98}\x{5F99}\x{5F9B}\x{5F9C}\x{5F9D}\x{5F9E}' . +'\x{5F9F}\x{5FA0}\x{5FA1}\x{5FA2}\x{5FA5}\x{5FA6}\x{5FA7}\x{5FA8}\x{5FA9}' . +'\x{5FAA}\x{5FAB}\x{5FAC}\x{5FAD}\x{5FAE}\x{5FAF}\x{5FB1}\x{5FB2}\x{5FB3}' . +'\x{5FB4}\x{5FB5}\x{5FB6}\x{5FB7}\x{5FB8}\x{5FB9}\x{5FBA}\x{5FBB}\x{5FBC}' . +'\x{5FBD}\x{5FBE}\x{5FBF}\x{5FC0}\x{5FC1}\x{5FC3}\x{5FC4}\x{5FC5}\x{5FC6}' . +'\x{5FC7}\x{5FC8}\x{5FC9}\x{5FCA}\x{5FCB}\x{5FCC}\x{5FCD}\x{5FCF}\x{5FD0}' . +'\x{5FD1}\x{5FD2}\x{5FD3}\x{5FD4}\x{5FD5}\x{5FD6}\x{5FD7}\x{5FD8}\x{5FD9}' . +'\x{5FDA}\x{5FDC}\x{5FDD}\x{5FDE}\x{5FE0}\x{5FE1}\x{5FE3}\x{5FE4}\x{5FE5}' . +'\x{5FE6}\x{5FE7}\x{5FE8}\x{5FE9}\x{5FEA}\x{5FEB}\x{5FED}\x{5FEE}\x{5FEF}' . +'\x{5FF0}\x{5FF1}\x{5FF2}\x{5FF3}\x{5FF4}\x{5FF5}\x{5FF6}\x{5FF7}\x{5FF8}' . +'\x{5FF9}\x{5FFA}\x{5FFB}\x{5FFD}\x{5FFE}\x{5FFF}\x{6000}\x{6001}\x{6002}' . +'\x{6003}\x{6004}\x{6005}\x{6006}\x{6007}\x{6008}\x{6009}\x{600A}\x{600B}' . +'\x{600C}\x{600D}\x{600E}\x{600F}\x{6010}\x{6011}\x{6012}\x{6013}\x{6014}' . +'\x{6015}\x{6016}\x{6017}\x{6018}\x{6019}\x{601A}\x{601B}\x{601C}\x{601D}' . +'\x{601E}\x{601F}\x{6020}\x{6021}\x{6022}\x{6024}\x{6025}\x{6026}\x{6027}' . +'\x{6028}\x{6029}\x{602A}\x{602B}\x{602C}\x{602D}\x{602E}\x{602F}\x{6030}' . +'\x{6031}\x{6032}\x{6033}\x{6034}\x{6035}\x{6036}\x{6037}\x{6038}\x{6039}' . +'\x{603A}\x{603B}\x{603C}\x{603D}\x{603E}\x{603F}\x{6040}\x{6041}\x{6042}' . +'\x{6043}\x{6044}\x{6045}\x{6046}\x{6047}\x{6048}\x{6049}\x{604A}\x{604B}' . +'\x{604C}\x{604D}\x{604E}\x{604F}\x{6050}\x{6051}\x{6052}\x{6053}\x{6054}' . +'\x{6055}\x{6057}\x{6058}\x{6059}\x{605A}\x{605B}\x{605C}\x{605D}\x{605E}' . +'\x{605F}\x{6062}\x{6063}\x{6064}\x{6065}\x{6066}\x{6067}\x{6068}\x{6069}' . +'\x{606A}\x{606B}\x{606C}\x{606D}\x{606E}\x{606F}\x{6070}\x{6072}\x{6073}' . +'\x{6075}\x{6076}\x{6077}\x{6078}\x{6079}\x{607A}\x{607B}\x{607C}\x{607D}' . +'\x{607E}\x{607F}\x{6080}\x{6081}\x{6082}\x{6083}\x{6084}\x{6085}\x{6086}' . +'\x{6087}\x{6088}\x{6089}\x{608A}\x{608B}\x{608C}\x{608D}\x{608E}\x{608F}' . +'\x{6090}\x{6092}\x{6094}\x{6095}\x{6096}\x{6097}\x{6098}\x{6099}\x{609A}' . +'\x{609B}\x{609C}\x{609D}\x{609E}\x{609F}\x{60A0}\x{60A1}\x{60A2}\x{60A3}' . +'\x{60A4}\x{60A6}\x{60A7}\x{60A8}\x{60AA}\x{60AB}\x{60AC}\x{60AD}\x{60AE}' . +'\x{60AF}\x{60B0}\x{60B1}\x{60B2}\x{60B3}\x{60B4}\x{60B5}\x{60B6}\x{60B7}' . +'\x{60B8}\x{60B9}\x{60BA}\x{60BB}\x{60BC}\x{60BD}\x{60BE}\x{60BF}\x{60C0}' . +'\x{60C1}\x{60C2}\x{60C3}\x{60C4}\x{60C5}\x{60C6}\x{60C7}\x{60C8}\x{60C9}' . +'\x{60CA}\x{60CB}\x{60CC}\x{60CD}\x{60CE}\x{60CF}\x{60D0}\x{60D1}\x{60D3}' . +'\x{60D4}\x{60D5}\x{60D7}\x{60D8}\x{60D9}\x{60DA}\x{60DB}\x{60DC}\x{60DD}' . +'\x{60DF}\x{60E0}\x{60E1}\x{60E2}\x{60E4}\x{60E6}\x{60E7}\x{60E8}\x{60E9}' . +'\x{60EA}\x{60EB}\x{60EC}\x{60ED}\x{60EE}\x{60EF}\x{60F0}\x{60F1}\x{60F2}' . +'\x{60F3}\x{60F4}\x{60F5}\x{60F6}\x{60F7}\x{60F8}\x{60F9}\x{60FA}\x{60FB}' . +'\x{60FC}\x{60FE}\x{60FF}\x{6100}\x{6101}\x{6103}\x{6104}\x{6105}\x{6106}' . +'\x{6108}\x{6109}\x{610A}\x{610B}\x{610C}\x{610D}\x{610E}\x{610F}\x{6110}' . +'\x{6112}\x{6113}\x{6114}\x{6115}\x{6116}\x{6117}\x{6118}\x{6119}\x{611A}' . +'\x{611B}\x{611C}\x{611D}\x{611F}\x{6120}\x{6122}\x{6123}\x{6124}\x{6125}' . +'\x{6126}\x{6127}\x{6128}\x{6129}\x{612A}\x{612B}\x{612C}\x{612D}\x{612E}' . +'\x{612F}\x{6130}\x{6132}\x{6134}\x{6136}\x{6137}\x{613A}\x{613B}\x{613C}' . +'\x{613D}\x{613E}\x{613F}\x{6140}\x{6141}\x{6142}\x{6143}\x{6144}\x{6145}' . +'\x{6146}\x{6147}\x{6148}\x{6149}\x{614A}\x{614B}\x{614C}\x{614D}\x{614E}' . +'\x{614F}\x{6150}\x{6151}\x{6152}\x{6153}\x{6154}\x{6155}\x{6156}\x{6157}' . +'\x{6158}\x{6159}\x{615A}\x{615B}\x{615C}\x{615D}\x{615E}\x{615F}\x{6161}' . +'\x{6162}\x{6163}\x{6164}\x{6165}\x{6166}\x{6167}\x{6168}\x{6169}\x{616A}' . +'\x{616B}\x{616C}\x{616D}\x{616E}\x{6170}\x{6171}\x{6172}\x{6173}\x{6174}' . +'\x{6175}\x{6176}\x{6177}\x{6178}\x{6179}\x{617A}\x{617C}\x{617E}\x{6180}' . +'\x{6181}\x{6182}\x{6183}\x{6184}\x{6185}\x{6187}\x{6188}\x{6189}\x{618A}' . +'\x{618B}\x{618C}\x{618D}\x{618E}\x{618F}\x{6190}\x{6191}\x{6192}\x{6193}' . +'\x{6194}\x{6195}\x{6196}\x{6198}\x{6199}\x{619A}\x{619B}\x{619D}\x{619E}' . +'\x{619F}\x{61A0}\x{61A1}\x{61A2}\x{61A3}\x{61A4}\x{61A5}\x{61A6}\x{61A7}' . +'\x{61A8}\x{61A9}\x{61AA}\x{61AB}\x{61AC}\x{61AD}\x{61AE}\x{61AF}\x{61B0}' . +'\x{61B1}\x{61B2}\x{61B3}\x{61B4}\x{61B5}\x{61B6}\x{61B7}\x{61B8}\x{61BA}' . +'\x{61BC}\x{61BD}\x{61BE}\x{61BF}\x{61C0}\x{61C1}\x{61C2}\x{61C3}\x{61C4}' . +'\x{61C5}\x{61C6}\x{61C7}\x{61C8}\x{61C9}\x{61CA}\x{61CB}\x{61CC}\x{61CD}' . +'\x{61CE}\x{61CF}\x{61D0}\x{61D1}\x{61D2}\x{61D4}\x{61D6}\x{61D7}\x{61D8}' . +'\x{61D9}\x{61DA}\x{61DB}\x{61DC}\x{61DD}\x{61DE}\x{61DF}\x{61E0}\x{61E1}' . +'\x{61E2}\x{61E3}\x{61E4}\x{61E5}\x{61E6}\x{61E7}\x{61E8}\x{61E9}\x{61EA}' . +'\x{61EB}\x{61ED}\x{61EE}\x{61F0}\x{61F1}\x{61F2}\x{61F3}\x{61F5}\x{61F6}' . +'\x{61F7}\x{61F8}\x{61F9}\x{61FA}\x{61FB}\x{61FC}\x{61FD}\x{61FE}\x{61FF}' . +'\x{6200}\x{6201}\x{6202}\x{6203}\x{6204}\x{6206}\x{6207}\x{6208}\x{6209}' . +'\x{620A}\x{620B}\x{620C}\x{620D}\x{620E}\x{620F}\x{6210}\x{6211}\x{6212}' . +'\x{6213}\x{6214}\x{6215}\x{6216}\x{6217}\x{6218}\x{6219}\x{621A}\x{621B}' . +'\x{621C}\x{621D}\x{621E}\x{621F}\x{6220}\x{6221}\x{6222}\x{6223}\x{6224}' . +'\x{6225}\x{6226}\x{6227}\x{6228}\x{6229}\x{622A}\x{622B}\x{622C}\x{622D}' . +'\x{622E}\x{622F}\x{6230}\x{6231}\x{6232}\x{6233}\x{6234}\x{6236}\x{6237}' . +'\x{6238}\x{623A}\x{623B}\x{623C}\x{623D}\x{623E}\x{623F}\x{6240}\x{6241}' . +'\x{6242}\x{6243}\x{6244}\x{6245}\x{6246}\x{6247}\x{6248}\x{6249}\x{624A}' . +'\x{624B}\x{624C}\x{624D}\x{624E}\x{624F}\x{6250}\x{6251}\x{6252}\x{6253}' . +'\x{6254}\x{6255}\x{6256}\x{6258}\x{6259}\x{625A}\x{625B}\x{625C}\x{625D}' . +'\x{625E}\x{625F}\x{6260}\x{6261}\x{6262}\x{6263}\x{6264}\x{6265}\x{6266}' . +'\x{6267}\x{6268}\x{6269}\x{626A}\x{626B}\x{626C}\x{626D}\x{626E}\x{626F}' . +'\x{6270}\x{6271}\x{6272}\x{6273}\x{6274}\x{6275}\x{6276}\x{6277}\x{6278}' . +'\x{6279}\x{627A}\x{627B}\x{627C}\x{627D}\x{627E}\x{627F}\x{6280}\x{6281}' . +'\x{6283}\x{6284}\x{6285}\x{6286}\x{6287}\x{6288}\x{6289}\x{628A}\x{628B}' . +'\x{628C}\x{628E}\x{628F}\x{6290}\x{6291}\x{6292}\x{6293}\x{6294}\x{6295}' . +'\x{6296}\x{6297}\x{6298}\x{6299}\x{629A}\x{629B}\x{629C}\x{629E}\x{629F}' . +'\x{62A0}\x{62A1}\x{62A2}\x{62A3}\x{62A4}\x{62A5}\x{62A7}\x{62A8}\x{62A9}' . +'\x{62AA}\x{62AB}\x{62AC}\x{62AD}\x{62AE}\x{62AF}\x{62B0}\x{62B1}\x{62B2}' . +'\x{62B3}\x{62B4}\x{62B5}\x{62B6}\x{62B7}\x{62B8}\x{62B9}\x{62BA}\x{62BB}' . +'\x{62BC}\x{62BD}\x{62BE}\x{62BF}\x{62C0}\x{62C1}\x{62C2}\x{62C3}\x{62C4}' . +'\x{62C5}\x{62C6}\x{62C7}\x{62C8}\x{62C9}\x{62CA}\x{62CB}\x{62CC}\x{62CD}' . +'\x{62CE}\x{62CF}\x{62D0}\x{62D1}\x{62D2}\x{62D3}\x{62D4}\x{62D5}\x{62D6}' . +'\x{62D7}\x{62D8}\x{62D9}\x{62DA}\x{62DB}\x{62DC}\x{62DD}\x{62DF}\x{62E0}' . +'\x{62E1}\x{62E2}\x{62E3}\x{62E4}\x{62E5}\x{62E6}\x{62E7}\x{62E8}\x{62E9}' . +'\x{62EB}\x{62EC}\x{62ED}\x{62EE}\x{62EF}\x{62F0}\x{62F1}\x{62F2}\x{62F3}' . +'\x{62F4}\x{62F5}\x{62F6}\x{62F7}\x{62F8}\x{62F9}\x{62FA}\x{62FB}\x{62FC}' . +'\x{62FD}\x{62FE}\x{62FF}\x{6300}\x{6301}\x{6302}\x{6303}\x{6304}\x{6305}' . +'\x{6306}\x{6307}\x{6308}\x{6309}\x{630B}\x{630C}\x{630D}\x{630E}\x{630F}' . +'\x{6310}\x{6311}\x{6312}\x{6313}\x{6314}\x{6315}\x{6316}\x{6318}\x{6319}' . +'\x{631A}\x{631B}\x{631C}\x{631D}\x{631E}\x{631F}\x{6320}\x{6321}\x{6322}' . +'\x{6323}\x{6324}\x{6325}\x{6326}\x{6327}\x{6328}\x{6329}\x{632A}\x{632B}' . +'\x{632C}\x{632D}\x{632E}\x{632F}\x{6330}\x{6332}\x{6333}\x{6334}\x{6336}' . +'\x{6338}\x{6339}\x{633A}\x{633B}\x{633C}\x{633D}\x{633E}\x{6340}\x{6341}' . +'\x{6342}\x{6343}\x{6344}\x{6345}\x{6346}\x{6347}\x{6348}\x{6349}\x{634A}' . +'\x{634B}\x{634C}\x{634D}\x{634E}\x{634F}\x{6350}\x{6351}\x{6352}\x{6353}' . +'\x{6354}\x{6355}\x{6356}\x{6357}\x{6358}\x{6359}\x{635A}\x{635C}\x{635D}' . +'\x{635E}\x{635F}\x{6360}\x{6361}\x{6362}\x{6363}\x{6364}\x{6365}\x{6366}' . +'\x{6367}\x{6368}\x{6369}\x{636A}\x{636B}\x{636C}\x{636D}\x{636E}\x{636F}' . +'\x{6370}\x{6371}\x{6372}\x{6373}\x{6374}\x{6375}\x{6376}\x{6377}\x{6378}' . +'\x{6379}\x{637A}\x{637B}\x{637C}\x{637D}\x{637E}\x{6380}\x{6381}\x{6382}' . +'\x{6383}\x{6384}\x{6385}\x{6386}\x{6387}\x{6388}\x{6389}\x{638A}\x{638C}' . +'\x{638D}\x{638E}\x{638F}\x{6390}\x{6391}\x{6392}\x{6394}\x{6395}\x{6396}' . +'\x{6397}\x{6398}\x{6399}\x{639A}\x{639B}\x{639C}\x{639D}\x{639E}\x{639F}' . +'\x{63A0}\x{63A1}\x{63A2}\x{63A3}\x{63A4}\x{63A5}\x{63A6}\x{63A7}\x{63A8}' . +'\x{63A9}\x{63AA}\x{63AB}\x{63AC}\x{63AD}\x{63AE}\x{63AF}\x{63B0}\x{63B1}' . +'\x{63B2}\x{63B3}\x{63B4}\x{63B5}\x{63B6}\x{63B7}\x{63B8}\x{63B9}\x{63BA}' . +'\x{63BC}\x{63BD}\x{63BE}\x{63BF}\x{63C0}\x{63C1}\x{63C2}\x{63C3}\x{63C4}' . +'\x{63C5}\x{63C6}\x{63C7}\x{63C8}\x{63C9}\x{63CA}\x{63CB}\x{63CC}\x{63CD}' . +'\x{63CE}\x{63CF}\x{63D0}\x{63D2}\x{63D3}\x{63D4}\x{63D5}\x{63D6}\x{63D7}' . +'\x{63D8}\x{63D9}\x{63DA}\x{63DB}\x{63DC}\x{63DD}\x{63DE}\x{63DF}\x{63E0}' . +'\x{63E1}\x{63E2}\x{63E3}\x{63E4}\x{63E5}\x{63E6}\x{63E7}\x{63E8}\x{63E9}' . +'\x{63EA}\x{63EB}\x{63EC}\x{63ED}\x{63EE}\x{63EF}\x{63F0}\x{63F1}\x{63F2}' . +'\x{63F3}\x{63F4}\x{63F5}\x{63F6}\x{63F7}\x{63F8}\x{63F9}\x{63FA}\x{63FB}' . +'\x{63FC}\x{63FD}\x{63FE}\x{63FF}\x{6400}\x{6401}\x{6402}\x{6403}\x{6404}' . +'\x{6405}\x{6406}\x{6408}\x{6409}\x{640A}\x{640B}\x{640C}\x{640D}\x{640E}' . +'\x{640F}\x{6410}\x{6411}\x{6412}\x{6413}\x{6414}\x{6415}\x{6416}\x{6417}' . +'\x{6418}\x{6419}\x{641A}\x{641B}\x{641C}\x{641D}\x{641E}\x{641F}\x{6420}' . +'\x{6421}\x{6422}\x{6423}\x{6424}\x{6425}\x{6426}\x{6427}\x{6428}\x{6429}' . +'\x{642A}\x{642B}\x{642C}\x{642D}\x{642E}\x{642F}\x{6430}\x{6431}\x{6432}' . +'\x{6433}\x{6434}\x{6435}\x{6436}\x{6437}\x{6438}\x{6439}\x{643A}\x{643D}' . +'\x{643E}\x{643F}\x{6440}\x{6441}\x{6443}\x{6444}\x{6445}\x{6446}\x{6447}' . +'\x{6448}\x{644A}\x{644B}\x{644C}\x{644D}\x{644E}\x{644F}\x{6450}\x{6451}' . +'\x{6452}\x{6453}\x{6454}\x{6455}\x{6456}\x{6457}\x{6458}\x{6459}\x{645B}' . +'\x{645C}\x{645D}\x{645E}\x{645F}\x{6460}\x{6461}\x{6462}\x{6463}\x{6464}' . +'\x{6465}\x{6466}\x{6467}\x{6468}\x{6469}\x{646A}\x{646B}\x{646C}\x{646D}' . +'\x{646E}\x{646F}\x{6470}\x{6471}\x{6472}\x{6473}\x{6474}\x{6475}\x{6476}' . +'\x{6477}\x{6478}\x{6479}\x{647A}\x{647B}\x{647C}\x{647D}\x{647F}\x{6480}' . +'\x{6481}\x{6482}\x{6483}\x{6484}\x{6485}\x{6487}\x{6488}\x{6489}\x{648A}' . +'\x{648B}\x{648C}\x{648D}\x{648E}\x{648F}\x{6490}\x{6491}\x{6492}\x{6493}' . +'\x{6494}\x{6495}\x{6496}\x{6497}\x{6498}\x{6499}\x{649A}\x{649B}\x{649C}' . +'\x{649D}\x{649E}\x{649F}\x{64A0}\x{64A2}\x{64A3}\x{64A4}\x{64A5}\x{64A6}' . +'\x{64A7}\x{64A8}\x{64A9}\x{64AA}\x{64AB}\x{64AC}\x{64AD}\x{64AE}\x{64B0}' . +'\x{64B1}\x{64B2}\x{64B3}\x{64B4}\x{64B5}\x{64B7}\x{64B8}\x{64B9}\x{64BA}' . +'\x{64BB}\x{64BC}\x{64BD}\x{64BE}\x{64BF}\x{64C0}\x{64C1}\x{64C2}\x{64C3}' . +'\x{64C4}\x{64C5}\x{64C6}\x{64C7}\x{64C9}\x{64CA}\x{64CB}\x{64CC}\x{64CD}' . +'\x{64CE}\x{64CF}\x{64D0}\x{64D1}\x{64D2}\x{64D3}\x{64D4}\x{64D6}\x{64D7}' . +'\x{64D8}\x{64D9}\x{64DA}\x{64DB}\x{64DC}\x{64DD}\x{64DE}\x{64DF}\x{64E0}' . +'\x{64E2}\x{64E3}\x{64E4}\x{64E6}\x{64E7}\x{64E8}\x{64E9}\x{64EA}\x{64EB}' . +'\x{64EC}\x{64ED}\x{64EF}\x{64F0}\x{64F1}\x{64F2}\x{64F3}\x{64F4}\x{64F6}' . +'\x{64F7}\x{64F8}\x{64FA}\x{64FB}\x{64FC}\x{64FD}\x{64FE}\x{64FF}\x{6500}' . +'\x{6501}\x{6503}\x{6504}\x{6505}\x{6506}\x{6507}\x{6508}\x{6509}\x{650B}' . +'\x{650C}\x{650D}\x{650E}\x{650F}\x{6510}\x{6511}\x{6512}\x{6513}\x{6514}' . +'\x{6515}\x{6516}\x{6517}\x{6518}\x{6519}\x{651A}\x{651B}\x{651C}\x{651D}' . +'\x{651E}\x{6520}\x{6521}\x{6522}\x{6523}\x{6524}\x{6525}\x{6526}\x{6527}' . +'\x{6529}\x{652A}\x{652B}\x{652C}\x{652D}\x{652E}\x{652F}\x{6530}\x{6531}' . +'\x{6532}\x{6533}\x{6534}\x{6535}\x{6536}\x{6537}\x{6538}\x{6539}\x{653A}' . +'\x{653B}\x{653C}\x{653D}\x{653E}\x{653F}\x{6541}\x{6543}\x{6544}\x{6545}' . +'\x{6546}\x{6547}\x{6548}\x{6549}\x{654A}\x{654B}\x{654C}\x{654D}\x{654E}' . +'\x{654F}\x{6550}\x{6551}\x{6552}\x{6553}\x{6554}\x{6555}\x{6556}\x{6557}' . +'\x{6558}\x{6559}\x{655B}\x{655C}\x{655D}\x{655E}\x{6560}\x{6561}\x{6562}' . +'\x{6563}\x{6564}\x{6565}\x{6566}\x{6567}\x{6568}\x{6569}\x{656A}\x{656B}' . +'\x{656C}\x{656E}\x{656F}\x{6570}\x{6571}\x{6572}\x{6573}\x{6574}\x{6575}' . +'\x{6576}\x{6577}\x{6578}\x{6579}\x{657A}\x{657B}\x{657C}\x{657E}\x{657F}' . +'\x{6580}\x{6581}\x{6582}\x{6583}\x{6584}\x{6585}\x{6586}\x{6587}\x{6588}' . +'\x{6589}\x{658B}\x{658C}\x{658D}\x{658E}\x{658F}\x{6590}\x{6591}\x{6592}' . +'\x{6593}\x{6594}\x{6595}\x{6596}\x{6597}\x{6598}\x{6599}\x{659B}\x{659C}' . +'\x{659D}\x{659E}\x{659F}\x{65A0}\x{65A1}\x{65A2}\x{65A3}\x{65A4}\x{65A5}' . +'\x{65A6}\x{65A7}\x{65A8}\x{65A9}\x{65AA}\x{65AB}\x{65AC}\x{65AD}\x{65AE}' . +'\x{65AF}\x{65B0}\x{65B1}\x{65B2}\x{65B3}\x{65B4}\x{65B6}\x{65B7}\x{65B8}' . +'\x{65B9}\x{65BA}\x{65BB}\x{65BC}\x{65BD}\x{65BF}\x{65C0}\x{65C1}\x{65C2}' . +'\x{65C3}\x{65C4}\x{65C5}\x{65C6}\x{65C7}\x{65CA}\x{65CB}\x{65CC}\x{65CD}' . +'\x{65CE}\x{65CF}\x{65D0}\x{65D2}\x{65D3}\x{65D4}\x{65D5}\x{65D6}\x{65D7}' . +'\x{65DA}\x{65DB}\x{65DD}\x{65DE}\x{65DF}\x{65E0}\x{65E1}\x{65E2}\x{65E3}' . +'\x{65E5}\x{65E6}\x{65E7}\x{65E8}\x{65E9}\x{65EB}\x{65EC}\x{65ED}\x{65EE}' . +'\x{65EF}\x{65F0}\x{65F1}\x{65F2}\x{65F3}\x{65F4}\x{65F5}\x{65F6}\x{65F7}' . +'\x{65F8}\x{65FA}\x{65FB}\x{65FC}\x{65FD}\x{6600}\x{6601}\x{6602}\x{6603}' . +'\x{6604}\x{6605}\x{6606}\x{6607}\x{6608}\x{6609}\x{660A}\x{660B}\x{660C}' . +'\x{660D}\x{660E}\x{660F}\x{6610}\x{6611}\x{6612}\x{6613}\x{6614}\x{6615}' . +'\x{6616}\x{6618}\x{6619}\x{661A}\x{661B}\x{661C}\x{661D}\x{661F}\x{6620}' . +'\x{6621}\x{6622}\x{6623}\x{6624}\x{6625}\x{6626}\x{6627}\x{6628}\x{6629}' . +'\x{662A}\x{662B}\x{662D}\x{662E}\x{662F}\x{6630}\x{6631}\x{6632}\x{6633}' . +'\x{6634}\x{6635}\x{6636}\x{6639}\x{663A}\x{663C}\x{663D}\x{663E}\x{6640}' . +'\x{6641}\x{6642}\x{6643}\x{6644}\x{6645}\x{6646}\x{6647}\x{6649}\x{664A}' . +'\x{664B}\x{664C}\x{664E}\x{664F}\x{6650}\x{6651}\x{6652}\x{6653}\x{6654}' . +'\x{6655}\x{6656}\x{6657}\x{6658}\x{6659}\x{665A}\x{665B}\x{665C}\x{665D}' . +'\x{665E}\x{665F}\x{6661}\x{6662}\x{6664}\x{6665}\x{6666}\x{6668}\x{6669}' . +'\x{666A}\x{666B}\x{666C}\x{666D}\x{666E}\x{666F}\x{6670}\x{6671}\x{6672}' . +'\x{6673}\x{6674}\x{6675}\x{6676}\x{6677}\x{6678}\x{6679}\x{667A}\x{667B}' . +'\x{667C}\x{667D}\x{667E}\x{667F}\x{6680}\x{6681}\x{6682}\x{6683}\x{6684}' . +'\x{6685}\x{6686}\x{6687}\x{6688}\x{6689}\x{668A}\x{668B}\x{668C}\x{668D}' . +'\x{668E}\x{668F}\x{6690}\x{6691}\x{6693}\x{6694}\x{6695}\x{6696}\x{6697}' . +'\x{6698}\x{6699}\x{669A}\x{669B}\x{669D}\x{669F}\x{66A0}\x{66A1}\x{66A2}' . +'\x{66A3}\x{66A4}\x{66A5}\x{66A6}\x{66A7}\x{66A8}\x{66A9}\x{66AA}\x{66AB}' . +'\x{66AE}\x{66AF}\x{66B0}\x{66B1}\x{66B2}\x{66B3}\x{66B4}\x{66B5}\x{66B6}' . +'\x{66B7}\x{66B8}\x{66B9}\x{66BA}\x{66BB}\x{66BC}\x{66BD}\x{66BE}\x{66BF}' . +'\x{66C0}\x{66C1}\x{66C2}\x{66C3}\x{66C4}\x{66C5}\x{66C6}\x{66C7}\x{66C8}' . +'\x{66C9}\x{66CA}\x{66CB}\x{66CC}\x{66CD}\x{66CE}\x{66CF}\x{66D1}\x{66D2}' . +'\x{66D4}\x{66D5}\x{66D6}\x{66D8}\x{66D9}\x{66DA}\x{66DB}\x{66DC}\x{66DD}' . +'\x{66DE}\x{66E0}\x{66E1}\x{66E2}\x{66E3}\x{66E4}\x{66E5}\x{66E6}\x{66E7}' . +'\x{66E8}\x{66E9}\x{66EA}\x{66EB}\x{66EC}\x{66ED}\x{66EE}\x{66F0}\x{66F1}' . +'\x{66F2}\x{66F3}\x{66F4}\x{66F5}\x{66F6}\x{66F7}\x{66F8}\x{66F9}\x{66FA}' . +'\x{66FB}\x{66FC}\x{66FE}\x{66FF}\x{6700}\x{6701}\x{6703}\x{6704}\x{6705}' . +'\x{6706}\x{6708}\x{6709}\x{670A}\x{670B}\x{670C}\x{670D}\x{670E}\x{670F}' . +'\x{6710}\x{6711}\x{6712}\x{6713}\x{6714}\x{6715}\x{6716}\x{6717}\x{6718}' . +'\x{671A}\x{671B}\x{671C}\x{671D}\x{671E}\x{671F}\x{6720}\x{6721}\x{6722}' . +'\x{6723}\x{6725}\x{6726}\x{6727}\x{6728}\x{672A}\x{672B}\x{672C}\x{672D}' . +'\x{672E}\x{672F}\x{6730}\x{6731}\x{6732}\x{6733}\x{6734}\x{6735}\x{6736}' . +'\x{6737}\x{6738}\x{6739}\x{673A}\x{673B}\x{673C}\x{673D}\x{673E}\x{673F}' . +'\x{6740}\x{6741}\x{6742}\x{6743}\x{6744}\x{6745}\x{6746}\x{6747}\x{6748}' . +'\x{6749}\x{674A}\x{674B}\x{674C}\x{674D}\x{674E}\x{674F}\x{6750}\x{6751}' . +'\x{6752}\x{6753}\x{6754}\x{6755}\x{6756}\x{6757}\x{6758}\x{6759}\x{675A}' . +'\x{675B}\x{675C}\x{675D}\x{675E}\x{675F}\x{6760}\x{6761}\x{6762}\x{6763}' . +'\x{6764}\x{6765}\x{6766}\x{6768}\x{6769}\x{676A}\x{676B}\x{676C}\x{676D}' . +'\x{676E}\x{676F}\x{6770}\x{6771}\x{6772}\x{6773}\x{6774}\x{6775}\x{6776}' . +'\x{6777}\x{6778}\x{6779}\x{677A}\x{677B}\x{677C}\x{677D}\x{677E}\x{677F}' . +'\x{6780}\x{6781}\x{6782}\x{6783}\x{6784}\x{6785}\x{6786}\x{6787}\x{6789}' . +'\x{678A}\x{678B}\x{678C}\x{678D}\x{678E}\x{678F}\x{6790}\x{6791}\x{6792}' . +'\x{6793}\x{6794}\x{6795}\x{6797}\x{6798}\x{6799}\x{679A}\x{679B}\x{679C}' . +'\x{679D}\x{679E}\x{679F}\x{67A0}\x{67A1}\x{67A2}\x{67A3}\x{67A4}\x{67A5}' . +'\x{67A6}\x{67A7}\x{67A8}\x{67AA}\x{67AB}\x{67AC}\x{67AD}\x{67AE}\x{67AF}' . +'\x{67B0}\x{67B1}\x{67B2}\x{67B3}\x{67B4}\x{67B5}\x{67B6}\x{67B7}\x{67B8}' . +'\x{67B9}\x{67BA}\x{67BB}\x{67BC}\x{67BE}\x{67C0}\x{67C1}\x{67C2}\x{67C3}' . +'\x{67C4}\x{67C5}\x{67C6}\x{67C7}\x{67C8}\x{67C9}\x{67CA}\x{67CB}\x{67CC}' . +'\x{67CD}\x{67CE}\x{67CF}\x{67D0}\x{67D1}\x{67D2}\x{67D3}\x{67D4}\x{67D6}' . +'\x{67D8}\x{67D9}\x{67DA}\x{67DB}\x{67DC}\x{67DD}\x{67DE}\x{67DF}\x{67E0}' . +'\x{67E1}\x{67E2}\x{67E3}\x{67E4}\x{67E5}\x{67E6}\x{67E7}\x{67E8}\x{67E9}' . +'\x{67EA}\x{67EB}\x{67EC}\x{67ED}\x{67EE}\x{67EF}\x{67F0}\x{67F1}\x{67F2}' . +'\x{67F3}\x{67F4}\x{67F5}\x{67F6}\x{67F7}\x{67F8}\x{67FA}\x{67FB}\x{67FC}' . +'\x{67FD}\x{67FE}\x{67FF}\x{6800}\x{6802}\x{6803}\x{6804}\x{6805}\x{6806}' . +'\x{6807}\x{6808}\x{6809}\x{680A}\x{680B}\x{680C}\x{680D}\x{680E}\x{680F}' . +'\x{6810}\x{6811}\x{6812}\x{6813}\x{6814}\x{6816}\x{6817}\x{6818}\x{6819}' . +'\x{681A}\x{681B}\x{681C}\x{681D}\x{681F}\x{6820}\x{6821}\x{6822}\x{6823}' . +'\x{6824}\x{6825}\x{6826}\x{6828}\x{6829}\x{682A}\x{682B}\x{682C}\x{682D}' . +'\x{682E}\x{682F}\x{6831}\x{6832}\x{6833}\x{6834}\x{6835}\x{6836}\x{6837}' . +'\x{6838}\x{6839}\x{683A}\x{683B}\x{683C}\x{683D}\x{683E}\x{683F}\x{6840}' . +'\x{6841}\x{6842}\x{6843}\x{6844}\x{6845}\x{6846}\x{6847}\x{6848}\x{6849}' . +'\x{684A}\x{684B}\x{684C}\x{684D}\x{684E}\x{684F}\x{6850}\x{6851}\x{6852}' . +'\x{6853}\x{6854}\x{6855}\x{6856}\x{6857}\x{685B}\x{685D}\x{6860}\x{6861}' . +'\x{6862}\x{6863}\x{6864}\x{6865}\x{6866}\x{6867}\x{6868}\x{6869}\x{686A}' . +'\x{686B}\x{686C}\x{686D}\x{686E}\x{686F}\x{6870}\x{6871}\x{6872}\x{6873}' . +'\x{6874}\x{6875}\x{6876}\x{6877}\x{6878}\x{6879}\x{687B}\x{687C}\x{687D}' . +'\x{687E}\x{687F}\x{6880}\x{6881}\x{6882}\x{6883}\x{6884}\x{6885}\x{6886}' . +'\x{6887}\x{6888}\x{6889}\x{688A}\x{688B}\x{688C}\x{688D}\x{688E}\x{688F}' . +'\x{6890}\x{6891}\x{6892}\x{6893}\x{6894}\x{6896}\x{6897}\x{6898}\x{689A}' . +'\x{689B}\x{689C}\x{689D}\x{689E}\x{689F}\x{68A0}\x{68A1}\x{68A2}\x{68A3}' . +'\x{68A4}\x{68A6}\x{68A7}\x{68A8}\x{68A9}\x{68AA}\x{68AB}\x{68AC}\x{68AD}' . +'\x{68AE}\x{68AF}\x{68B0}\x{68B1}\x{68B2}\x{68B3}\x{68B4}\x{68B5}\x{68B6}' . +'\x{68B7}\x{68B9}\x{68BB}\x{68BC}\x{68BD}\x{68BE}\x{68BF}\x{68C0}\x{68C1}' . +'\x{68C2}\x{68C4}\x{68C6}\x{68C7}\x{68C8}\x{68C9}\x{68CA}\x{68CB}\x{68CC}' . +'\x{68CD}\x{68CE}\x{68CF}\x{68D0}\x{68D1}\x{68D2}\x{68D3}\x{68D4}\x{68D5}' . +'\x{68D6}\x{68D7}\x{68D8}\x{68DA}\x{68DB}\x{68DC}\x{68DD}\x{68DE}\x{68DF}' . +'\x{68E0}\x{68E1}\x{68E3}\x{68E4}\x{68E6}\x{68E7}\x{68E8}\x{68E9}\x{68EA}' . +'\x{68EB}\x{68EC}\x{68ED}\x{68EE}\x{68EF}\x{68F0}\x{68F1}\x{68F2}\x{68F3}' . +'\x{68F4}\x{68F5}\x{68F6}\x{68F7}\x{68F8}\x{68F9}\x{68FA}\x{68FB}\x{68FC}' . +'\x{68FD}\x{68FE}\x{68FF}\x{6901}\x{6902}\x{6903}\x{6904}\x{6905}\x{6906}' . +'\x{6907}\x{6908}\x{690A}\x{690B}\x{690C}\x{690D}\x{690E}\x{690F}\x{6910}' . +'\x{6911}\x{6912}\x{6913}\x{6914}\x{6915}\x{6916}\x{6917}\x{6918}\x{6919}' . +'\x{691A}\x{691B}\x{691C}\x{691D}\x{691E}\x{691F}\x{6920}\x{6921}\x{6922}' . +'\x{6923}\x{6924}\x{6925}\x{6926}\x{6927}\x{6928}\x{6929}\x{692A}\x{692B}' . +'\x{692C}\x{692D}\x{692E}\x{692F}\x{6930}\x{6931}\x{6932}\x{6933}\x{6934}' . +'\x{6935}\x{6936}\x{6937}\x{6938}\x{6939}\x{693A}\x{693B}\x{693C}\x{693D}' . +'\x{693F}\x{6940}\x{6941}\x{6942}\x{6943}\x{6944}\x{6945}\x{6946}\x{6947}' . +'\x{6948}\x{6949}\x{694A}\x{694B}\x{694C}\x{694E}\x{694F}\x{6950}\x{6951}' . +'\x{6952}\x{6953}\x{6954}\x{6955}\x{6956}\x{6957}\x{6958}\x{6959}\x{695A}' . +'\x{695B}\x{695C}\x{695D}\x{695E}\x{695F}\x{6960}\x{6961}\x{6962}\x{6963}' . +'\x{6964}\x{6965}\x{6966}\x{6967}\x{6968}\x{6969}\x{696A}\x{696B}\x{696C}' . +'\x{696D}\x{696E}\x{696F}\x{6970}\x{6971}\x{6972}\x{6973}\x{6974}\x{6975}' . +'\x{6976}\x{6977}\x{6978}\x{6979}\x{697A}\x{697B}\x{697C}\x{697D}\x{697E}' . +'\x{697F}\x{6980}\x{6981}\x{6982}\x{6983}\x{6984}\x{6985}\x{6986}\x{6987}' . +'\x{6988}\x{6989}\x{698A}\x{698B}\x{698C}\x{698D}\x{698E}\x{698F}\x{6990}' . +'\x{6991}\x{6992}\x{6993}\x{6994}\x{6995}\x{6996}\x{6997}\x{6998}\x{6999}' . +'\x{699A}\x{699B}\x{699C}\x{699D}\x{699E}\x{69A0}\x{69A1}\x{69A3}\x{69A4}' . +'\x{69A5}\x{69A6}\x{69A7}\x{69A8}\x{69A9}\x{69AA}\x{69AB}\x{69AC}\x{69AD}' . +'\x{69AE}\x{69AF}\x{69B0}\x{69B1}\x{69B2}\x{69B3}\x{69B4}\x{69B5}\x{69B6}' . +'\x{69B7}\x{69B8}\x{69B9}\x{69BA}\x{69BB}\x{69BC}\x{69BD}\x{69BE}\x{69BF}' . +'\x{69C1}\x{69C2}\x{69C3}\x{69C4}\x{69C5}\x{69C6}\x{69C7}\x{69C8}\x{69C9}' . +'\x{69CA}\x{69CB}\x{69CC}\x{69CD}\x{69CE}\x{69CF}\x{69D0}\x{69D3}\x{69D4}' . +'\x{69D8}\x{69D9}\x{69DA}\x{69DB}\x{69DC}\x{69DD}\x{69DE}\x{69DF}\x{69E0}' . +'\x{69E1}\x{69E2}\x{69E3}\x{69E4}\x{69E5}\x{69E6}\x{69E7}\x{69E8}\x{69E9}' . +'\x{69EA}\x{69EB}\x{69EC}\x{69ED}\x{69EE}\x{69EF}\x{69F0}\x{69F1}\x{69F2}' . +'\x{69F3}\x{69F4}\x{69F5}\x{69F6}\x{69F7}\x{69F8}\x{69FA}\x{69FB}\x{69FC}' . +'\x{69FD}\x{69FE}\x{69FF}\x{6A00}\x{6A01}\x{6A02}\x{6A04}\x{6A05}\x{6A06}' . +'\x{6A07}\x{6A08}\x{6A09}\x{6A0A}\x{6A0B}\x{6A0D}\x{6A0E}\x{6A0F}\x{6A10}' . +'\x{6A11}\x{6A12}\x{6A13}\x{6A14}\x{6A15}\x{6A16}\x{6A17}\x{6A18}\x{6A19}' . +'\x{6A1A}\x{6A1B}\x{6A1D}\x{6A1E}\x{6A1F}\x{6A20}\x{6A21}\x{6A22}\x{6A23}' . +'\x{6A25}\x{6A26}\x{6A27}\x{6A28}\x{6A29}\x{6A2A}\x{6A2B}\x{6A2C}\x{6A2D}' . +'\x{6A2E}\x{6A2F}\x{6A30}\x{6A31}\x{6A32}\x{6A33}\x{6A34}\x{6A35}\x{6A36}' . +'\x{6A38}\x{6A39}\x{6A3A}\x{6A3B}\x{6A3C}\x{6A3D}\x{6A3E}\x{6A3F}\x{6A40}' . +'\x{6A41}\x{6A42}\x{6A43}\x{6A44}\x{6A45}\x{6A46}\x{6A47}\x{6A48}\x{6A49}' . +'\x{6A4B}\x{6A4C}\x{6A4D}\x{6A4E}\x{6A4F}\x{6A50}\x{6A51}\x{6A52}\x{6A54}' . +'\x{6A55}\x{6A56}\x{6A57}\x{6A58}\x{6A59}\x{6A5A}\x{6A5B}\x{6A5D}\x{6A5E}' . +'\x{6A5F}\x{6A60}\x{6A61}\x{6A62}\x{6A63}\x{6A64}\x{6A65}\x{6A66}\x{6A67}' . +'\x{6A68}\x{6A69}\x{6A6A}\x{6A6B}\x{6A6C}\x{6A6D}\x{6A6F}\x{6A71}\x{6A72}' . +'\x{6A73}\x{6A74}\x{6A75}\x{6A76}\x{6A77}\x{6A78}\x{6A79}\x{6A7A}\x{6A7B}' . +'\x{6A7C}\x{6A7D}\x{6A7E}\x{6A7F}\x{6A80}\x{6A81}\x{6A82}\x{6A83}\x{6A84}' . +'\x{6A85}\x{6A87}\x{6A88}\x{6A89}\x{6A8B}\x{6A8C}\x{6A8D}\x{6A8E}\x{6A90}' . +'\x{6A91}\x{6A92}\x{6A93}\x{6A94}\x{6A95}\x{6A96}\x{6A97}\x{6A98}\x{6A9A}' . +'\x{6A9B}\x{6A9C}\x{6A9E}\x{6A9F}\x{6AA0}\x{6AA1}\x{6AA2}\x{6AA3}\x{6AA4}' . +'\x{6AA5}\x{6AA6}\x{6AA7}\x{6AA8}\x{6AA9}\x{6AAB}\x{6AAC}\x{6AAD}\x{6AAE}' . +'\x{6AAF}\x{6AB0}\x{6AB2}\x{6AB3}\x{6AB4}\x{6AB5}\x{6AB6}\x{6AB7}\x{6AB8}' . +'\x{6AB9}\x{6ABA}\x{6ABB}\x{6ABC}\x{6ABD}\x{6ABF}\x{6AC1}\x{6AC2}\x{6AC3}' . +'\x{6AC5}\x{6AC6}\x{6AC7}\x{6ACA}\x{6ACB}\x{6ACC}\x{6ACD}\x{6ACE}\x{6ACF}' . +'\x{6AD0}\x{6AD1}\x{6AD2}\x{6AD3}\x{6AD4}\x{6AD5}\x{6AD6}\x{6AD7}\x{6AD9}' . +'\x{6ADA}\x{6ADB}\x{6ADC}\x{6ADD}\x{6ADE}\x{6ADF}\x{6AE0}\x{6AE1}\x{6AE2}' . +'\x{6AE3}\x{6AE4}\x{6AE5}\x{6AE6}\x{6AE7}\x{6AE8}\x{6AEA}\x{6AEB}\x{6AEC}' . +'\x{6AED}\x{6AEE}\x{6AEF}\x{6AF0}\x{6AF1}\x{6AF2}\x{6AF3}\x{6AF4}\x{6AF5}' . +'\x{6AF6}\x{6AF7}\x{6AF8}\x{6AF9}\x{6AFA}\x{6AFB}\x{6AFC}\x{6AFD}\x{6AFE}' . +'\x{6AFF}\x{6B00}\x{6B01}\x{6B02}\x{6B03}\x{6B04}\x{6B05}\x{6B06}\x{6B07}' . +'\x{6B08}\x{6B09}\x{6B0A}\x{6B0B}\x{6B0C}\x{6B0D}\x{6B0F}\x{6B10}\x{6B11}' . +'\x{6B12}\x{6B13}\x{6B14}\x{6B15}\x{6B16}\x{6B17}\x{6B18}\x{6B19}\x{6B1A}' . +'\x{6B1C}\x{6B1D}\x{6B1E}\x{6B1F}\x{6B20}\x{6B21}\x{6B22}\x{6B23}\x{6B24}' . +'\x{6B25}\x{6B26}\x{6B27}\x{6B28}\x{6B29}\x{6B2A}\x{6B2B}\x{6B2C}\x{6B2D}' . +'\x{6B2F}\x{6B30}\x{6B31}\x{6B32}\x{6B33}\x{6B34}\x{6B36}\x{6B37}\x{6B38}' . +'\x{6B39}\x{6B3A}\x{6B3B}\x{6B3C}\x{6B3D}\x{6B3E}\x{6B3F}\x{6B41}\x{6B42}' . +'\x{6B43}\x{6B44}\x{6B45}\x{6B46}\x{6B47}\x{6B48}\x{6B49}\x{6B4A}\x{6B4B}' . +'\x{6B4C}\x{6B4D}\x{6B4E}\x{6B4F}\x{6B50}\x{6B51}\x{6B52}\x{6B53}\x{6B54}' . +'\x{6B55}\x{6B56}\x{6B59}\x{6B5A}\x{6B5B}\x{6B5C}\x{6B5E}\x{6B5F}\x{6B60}' . +'\x{6B61}\x{6B62}\x{6B63}\x{6B64}\x{6B65}\x{6B66}\x{6B67}\x{6B69}\x{6B6A}' . +'\x{6B6B}\x{6B6D}\x{6B6F}\x{6B70}\x{6B72}\x{6B73}\x{6B74}\x{6B76}\x{6B77}' . +'\x{6B78}\x{6B79}\x{6B7A}\x{6B7B}\x{6B7C}\x{6B7E}\x{6B7F}\x{6B80}\x{6B81}' . +'\x{6B82}\x{6B83}\x{6B84}\x{6B85}\x{6B86}\x{6B87}\x{6B88}\x{6B89}\x{6B8A}' . +'\x{6B8B}\x{6B8C}\x{6B8D}\x{6B8E}\x{6B8F}\x{6B90}\x{6B91}\x{6B92}\x{6B93}' . +'\x{6B94}\x{6B95}\x{6B96}\x{6B97}\x{6B98}\x{6B99}\x{6B9A}\x{6B9B}\x{6B9C}' . +'\x{6B9D}\x{6B9E}\x{6B9F}\x{6BA0}\x{6BA1}\x{6BA2}\x{6BA3}\x{6BA4}\x{6BA5}' . +'\x{6BA6}\x{6BA7}\x{6BA8}\x{6BA9}\x{6BAA}\x{6BAB}\x{6BAC}\x{6BAD}\x{6BAE}' . +'\x{6BAF}\x{6BB0}\x{6BB2}\x{6BB3}\x{6BB4}\x{6BB5}\x{6BB6}\x{6BB7}\x{6BB9}' . +'\x{6BBA}\x{6BBB}\x{6BBC}\x{6BBD}\x{6BBE}\x{6BBF}\x{6BC0}\x{6BC1}\x{6BC2}' . +'\x{6BC3}\x{6BC4}\x{6BC5}\x{6BC6}\x{6BC7}\x{6BC8}\x{6BC9}\x{6BCA}\x{6BCB}' . +'\x{6BCC}\x{6BCD}\x{6BCE}\x{6BCF}\x{6BD0}\x{6BD1}\x{6BD2}\x{6BD3}\x{6BD4}' . +'\x{6BD5}\x{6BD6}\x{6BD7}\x{6BD8}\x{6BD9}\x{6BDA}\x{6BDB}\x{6BDC}\x{6BDD}' . +'\x{6BDE}\x{6BDF}\x{6BE0}\x{6BE1}\x{6BE2}\x{6BE3}\x{6BE4}\x{6BE5}\x{6BE6}' . +'\x{6BE7}\x{6BE8}\x{6BEA}\x{6BEB}\x{6BEC}\x{6BED}\x{6BEE}\x{6BEF}\x{6BF0}' . +'\x{6BF2}\x{6BF3}\x{6BF5}\x{6BF6}\x{6BF7}\x{6BF8}\x{6BF9}\x{6BFB}\x{6BFC}' . +'\x{6BFD}\x{6BFE}\x{6BFF}\x{6C00}\x{6C01}\x{6C02}\x{6C03}\x{6C04}\x{6C05}' . +'\x{6C06}\x{6C07}\x{6C08}\x{6C09}\x{6C0B}\x{6C0C}\x{6C0D}\x{6C0E}\x{6C0F}' . +'\x{6C10}\x{6C11}\x{6C12}\x{6C13}\x{6C14}\x{6C15}\x{6C16}\x{6C18}\x{6C19}' . +'\x{6C1A}\x{6C1B}\x{6C1D}\x{6C1E}\x{6C1F}\x{6C20}\x{6C21}\x{6C22}\x{6C23}' . +'\x{6C24}\x{6C25}\x{6C26}\x{6C27}\x{6C28}\x{6C29}\x{6C2A}\x{6C2B}\x{6C2C}' . +'\x{6C2E}\x{6C2F}\x{6C30}\x{6C31}\x{6C32}\x{6C33}\x{6C34}\x{6C35}\x{6C36}' . +'\x{6C37}\x{6C38}\x{6C3A}\x{6C3B}\x{6C3D}\x{6C3E}\x{6C3F}\x{6C40}\x{6C41}' . +'\x{6C42}\x{6C43}\x{6C44}\x{6C46}\x{6C47}\x{6C48}\x{6C49}\x{6C4A}\x{6C4B}' . +'\x{6C4C}\x{6C4D}\x{6C4E}\x{6C4F}\x{6C50}\x{6C51}\x{6C52}\x{6C53}\x{6C54}' . +'\x{6C55}\x{6C56}\x{6C57}\x{6C58}\x{6C59}\x{6C5A}\x{6C5B}\x{6C5C}\x{6C5D}' . +'\x{6C5E}\x{6C5F}\x{6C60}\x{6C61}\x{6C62}\x{6C63}\x{6C64}\x{6C65}\x{6C66}' . +'\x{6C67}\x{6C68}\x{6C69}\x{6C6A}\x{6C6B}\x{6C6D}\x{6C6F}\x{6C70}\x{6C71}' . +'\x{6C72}\x{6C73}\x{6C74}\x{6C75}\x{6C76}\x{6C77}\x{6C78}\x{6C79}\x{6C7A}' . +'\x{6C7B}\x{6C7C}\x{6C7D}\x{6C7E}\x{6C7F}\x{6C80}\x{6C81}\x{6C82}\x{6C83}' . +'\x{6C84}\x{6C85}\x{6C86}\x{6C87}\x{6C88}\x{6C89}\x{6C8A}\x{6C8B}\x{6C8C}' . +'\x{6C8D}\x{6C8E}\x{6C8F}\x{6C90}\x{6C91}\x{6C92}\x{6C93}\x{6C94}\x{6C95}' . +'\x{6C96}\x{6C97}\x{6C98}\x{6C99}\x{6C9A}\x{6C9B}\x{6C9C}\x{6C9D}\x{6C9E}' . +'\x{6C9F}\x{6CA1}\x{6CA2}\x{6CA3}\x{6CA4}\x{6CA5}\x{6CA6}\x{6CA7}\x{6CA8}' . +'\x{6CA9}\x{6CAA}\x{6CAB}\x{6CAC}\x{6CAD}\x{6CAE}\x{6CAF}\x{6CB0}\x{6CB1}' . +'\x{6CB2}\x{6CB3}\x{6CB4}\x{6CB5}\x{6CB6}\x{6CB7}\x{6CB8}\x{6CB9}\x{6CBA}' . +'\x{6CBB}\x{6CBC}\x{6CBD}\x{6CBE}\x{6CBF}\x{6CC0}\x{6CC1}\x{6CC2}\x{6CC3}' . +'\x{6CC4}\x{6CC5}\x{6CC6}\x{6CC7}\x{6CC8}\x{6CC9}\x{6CCA}\x{6CCB}\x{6CCC}' . +'\x{6CCD}\x{6CCE}\x{6CCF}\x{6CD0}\x{6CD1}\x{6CD2}\x{6CD3}\x{6CD4}\x{6CD5}' . +'\x{6CD6}\x{6CD7}\x{6CD9}\x{6CDA}\x{6CDB}\x{6CDC}\x{6CDD}\x{6CDE}\x{6CDF}' . +'\x{6CE0}\x{6CE1}\x{6CE2}\x{6CE3}\x{6CE4}\x{6CE5}\x{6CE6}\x{6CE7}\x{6CE8}' . +'\x{6CE9}\x{6CEA}\x{6CEB}\x{6CEC}\x{6CED}\x{6CEE}\x{6CEF}\x{6CF0}\x{6CF1}' . +'\x{6CF2}\x{6CF3}\x{6CF5}\x{6CF6}\x{6CF7}\x{6CF8}\x{6CF9}\x{6CFA}\x{6CFB}' . +'\x{6CFC}\x{6CFD}\x{6CFE}\x{6CFF}\x{6D00}\x{6D01}\x{6D03}\x{6D04}\x{6D05}' . +'\x{6D06}\x{6D07}\x{6D08}\x{6D09}\x{6D0A}\x{6D0B}\x{6D0C}\x{6D0D}\x{6D0E}' . +'\x{6D0F}\x{6D10}\x{6D11}\x{6D12}\x{6D13}\x{6D14}\x{6D15}\x{6D16}\x{6D17}' . +'\x{6D18}\x{6D19}\x{6D1A}\x{6D1B}\x{6D1D}\x{6D1E}\x{6D1F}\x{6D20}\x{6D21}' . +'\x{6D22}\x{6D23}\x{6D25}\x{6D26}\x{6D27}\x{6D28}\x{6D29}\x{6D2A}\x{6D2B}' . +'\x{6D2C}\x{6D2D}\x{6D2E}\x{6D2F}\x{6D30}\x{6D31}\x{6D32}\x{6D33}\x{6D34}' . +'\x{6D35}\x{6D36}\x{6D37}\x{6D38}\x{6D39}\x{6D3A}\x{6D3B}\x{6D3C}\x{6D3D}' . +'\x{6D3E}\x{6D3F}\x{6D40}\x{6D41}\x{6D42}\x{6D43}\x{6D44}\x{6D45}\x{6D46}' . +'\x{6D47}\x{6D48}\x{6D49}\x{6D4A}\x{6D4B}\x{6D4C}\x{6D4D}\x{6D4E}\x{6D4F}' . +'\x{6D50}\x{6D51}\x{6D52}\x{6D53}\x{6D54}\x{6D55}\x{6D56}\x{6D57}\x{6D58}' . +'\x{6D59}\x{6D5A}\x{6D5B}\x{6D5C}\x{6D5D}\x{6D5E}\x{6D5F}\x{6D60}\x{6D61}' . +'\x{6D62}\x{6D63}\x{6D64}\x{6D65}\x{6D66}\x{6D67}\x{6D68}\x{6D69}\x{6D6A}' . +'\x{6D6B}\x{6D6C}\x{6D6D}\x{6D6E}\x{6D6F}\x{6D70}\x{6D72}\x{6D73}\x{6D74}' . +'\x{6D75}\x{6D76}\x{6D77}\x{6D78}\x{6D79}\x{6D7A}\x{6D7B}\x{6D7C}\x{6D7D}' . +'\x{6D7E}\x{6D7F}\x{6D80}\x{6D82}\x{6D83}\x{6D84}\x{6D85}\x{6D86}\x{6D87}' . +'\x{6D88}\x{6D89}\x{6D8A}\x{6D8B}\x{6D8C}\x{6D8D}\x{6D8E}\x{6D8F}\x{6D90}' . +'\x{6D91}\x{6D92}\x{6D93}\x{6D94}\x{6D95}\x{6D97}\x{6D98}\x{6D99}\x{6D9A}' . +'\x{6D9B}\x{6D9D}\x{6D9E}\x{6D9F}\x{6DA0}\x{6DA1}\x{6DA2}\x{6DA3}\x{6DA4}' . +'\x{6DA5}\x{6DA6}\x{6DA7}\x{6DA8}\x{6DA9}\x{6DAA}\x{6DAB}\x{6DAC}\x{6DAD}' . +'\x{6DAE}\x{6DAF}\x{6DB2}\x{6DB3}\x{6DB4}\x{6DB5}\x{6DB7}\x{6DB8}\x{6DB9}' . +'\x{6DBA}\x{6DBB}\x{6DBC}\x{6DBD}\x{6DBE}\x{6DBF}\x{6DC0}\x{6DC1}\x{6DC2}' . +'\x{6DC3}\x{6DC4}\x{6DC5}\x{6DC6}\x{6DC7}\x{6DC8}\x{6DC9}\x{6DCA}\x{6DCB}' . +'\x{6DCC}\x{6DCD}\x{6DCE}\x{6DCF}\x{6DD0}\x{6DD1}\x{6DD2}\x{6DD3}\x{6DD4}' . +'\x{6DD5}\x{6DD6}\x{6DD7}\x{6DD8}\x{6DD9}\x{6DDA}\x{6DDB}\x{6DDC}\x{6DDD}' . +'\x{6DDE}\x{6DDF}\x{6DE0}\x{6DE1}\x{6DE2}\x{6DE3}\x{6DE4}\x{6DE5}\x{6DE6}' . +'\x{6DE7}\x{6DE8}\x{6DE9}\x{6DEA}\x{6DEB}\x{6DEC}\x{6DED}\x{6DEE}\x{6DEF}' . +'\x{6DF0}\x{6DF1}\x{6DF2}\x{6DF3}\x{6DF4}\x{6DF5}\x{6DF6}\x{6DF7}\x{6DF8}' . +'\x{6DF9}\x{6DFA}\x{6DFB}\x{6DFC}\x{6DFD}\x{6E00}\x{6E03}\x{6E04}\x{6E05}' . +'\x{6E07}\x{6E08}\x{6E09}\x{6E0A}\x{6E0B}\x{6E0C}\x{6E0D}\x{6E0E}\x{6E0F}' . +'\x{6E10}\x{6E11}\x{6E14}\x{6E15}\x{6E16}\x{6E17}\x{6E19}\x{6E1A}\x{6E1B}' . +'\x{6E1C}\x{6E1D}\x{6E1E}\x{6E1F}\x{6E20}\x{6E21}\x{6E22}\x{6E23}\x{6E24}' . +'\x{6E25}\x{6E26}\x{6E27}\x{6E28}\x{6E29}\x{6E2B}\x{6E2C}\x{6E2D}\x{6E2E}' . +'\x{6E2F}\x{6E30}\x{6E31}\x{6E32}\x{6E33}\x{6E34}\x{6E35}\x{6E36}\x{6E37}' . +'\x{6E38}\x{6E39}\x{6E3A}\x{6E3B}\x{6E3C}\x{6E3D}\x{6E3E}\x{6E3F}\x{6E40}' . +'\x{6E41}\x{6E42}\x{6E43}\x{6E44}\x{6E45}\x{6E46}\x{6E47}\x{6E48}\x{6E49}' . +'\x{6E4A}\x{6E4B}\x{6E4D}\x{6E4E}\x{6E4F}\x{6E50}\x{6E51}\x{6E52}\x{6E53}' . +'\x{6E54}\x{6E55}\x{6E56}\x{6E57}\x{6E58}\x{6E59}\x{6E5A}\x{6E5B}\x{6E5C}' . +'\x{6E5D}\x{6E5E}\x{6E5F}\x{6E60}\x{6E61}\x{6E62}\x{6E63}\x{6E64}\x{6E65}' . +'\x{6E66}\x{6E67}\x{6E68}\x{6E69}\x{6E6A}\x{6E6B}\x{6E6D}\x{6E6E}\x{6E6F}' . +'\x{6E70}\x{6E71}\x{6E72}\x{6E73}\x{6E74}\x{6E75}\x{6E77}\x{6E78}\x{6E79}' . +'\x{6E7E}\x{6E7F}\x{6E80}\x{6E81}\x{6E82}\x{6E83}\x{6E84}\x{6E85}\x{6E86}' . +'\x{6E87}\x{6E88}\x{6E89}\x{6E8A}\x{6E8D}\x{6E8E}\x{6E8F}\x{6E90}\x{6E91}' . +'\x{6E92}\x{6E93}\x{6E94}\x{6E96}\x{6E97}\x{6E98}\x{6E99}\x{6E9A}\x{6E9B}' . +'\x{6E9C}\x{6E9D}\x{6E9E}\x{6E9F}\x{6EA0}\x{6EA1}\x{6EA2}\x{6EA3}\x{6EA4}' . +'\x{6EA5}\x{6EA6}\x{6EA7}\x{6EA8}\x{6EA9}\x{6EAA}\x{6EAB}\x{6EAC}\x{6EAD}' . +'\x{6EAE}\x{6EAF}\x{6EB0}\x{6EB1}\x{6EB2}\x{6EB3}\x{6EB4}\x{6EB5}\x{6EB6}' . +'\x{6EB7}\x{6EB8}\x{6EB9}\x{6EBA}\x{6EBB}\x{6EBC}\x{6EBD}\x{6EBE}\x{6EBF}' . +'\x{6EC0}\x{6EC1}\x{6EC2}\x{6EC3}\x{6EC4}\x{6EC5}\x{6EC6}\x{6EC7}\x{6EC8}' . +'\x{6EC9}\x{6ECA}\x{6ECB}\x{6ECC}\x{6ECD}\x{6ECE}\x{6ECF}\x{6ED0}\x{6ED1}' . +'\x{6ED2}\x{6ED3}\x{6ED4}\x{6ED5}\x{6ED6}\x{6ED7}\x{6ED8}\x{6ED9}\x{6EDA}' . +'\x{6EDC}\x{6EDE}\x{6EDF}\x{6EE0}\x{6EE1}\x{6EE2}\x{6EE4}\x{6EE5}\x{6EE6}' . +'\x{6EE7}\x{6EE8}\x{6EE9}\x{6EEA}\x{6EEB}\x{6EEC}\x{6EED}\x{6EEE}\x{6EEF}' . +'\x{6EF0}\x{6EF1}\x{6EF2}\x{6EF3}\x{6EF4}\x{6EF5}\x{6EF6}\x{6EF7}\x{6EF8}' . +'\x{6EF9}\x{6EFA}\x{6EFB}\x{6EFC}\x{6EFD}\x{6EFE}\x{6EFF}\x{6F00}\x{6F01}' . +'\x{6F02}\x{6F03}\x{6F05}\x{6F06}\x{6F07}\x{6F08}\x{6F09}\x{6F0A}\x{6F0C}' . +'\x{6F0D}\x{6F0E}\x{6F0F}\x{6F10}\x{6F11}\x{6F12}\x{6F13}\x{6F14}\x{6F15}' . +'\x{6F16}\x{6F17}\x{6F18}\x{6F19}\x{6F1A}\x{6F1B}\x{6F1C}\x{6F1D}\x{6F1E}' . +'\x{6F1F}\x{6F20}\x{6F21}\x{6F22}\x{6F23}\x{6F24}\x{6F25}\x{6F26}\x{6F27}' . +'\x{6F28}\x{6F29}\x{6F2A}\x{6F2B}\x{6F2C}\x{6F2D}\x{6F2E}\x{6F2F}\x{6F30}' . +'\x{6F31}\x{6F32}\x{6F33}\x{6F34}\x{6F35}\x{6F36}\x{6F37}\x{6F38}\x{6F39}' . +'\x{6F3A}\x{6F3B}\x{6F3C}\x{6F3D}\x{6F3E}\x{6F3F}\x{6F40}\x{6F41}\x{6F43}' . +'\x{6F44}\x{6F45}\x{6F46}\x{6F47}\x{6F49}\x{6F4B}\x{6F4C}\x{6F4D}\x{6F4E}' . +'\x{6F4F}\x{6F50}\x{6F51}\x{6F52}\x{6F53}\x{6F54}\x{6F55}\x{6F56}\x{6F57}' . +'\x{6F58}\x{6F59}\x{6F5A}\x{6F5B}\x{6F5C}\x{6F5D}\x{6F5E}\x{6F5F}\x{6F60}' . +'\x{6F61}\x{6F62}\x{6F63}\x{6F64}\x{6F65}\x{6F66}\x{6F67}\x{6F68}\x{6F69}' . +'\x{6F6A}\x{6F6B}\x{6F6C}\x{6F6D}\x{6F6E}\x{6F6F}\x{6F70}\x{6F71}\x{6F72}' . +'\x{6F73}\x{6F74}\x{6F75}\x{6F76}\x{6F77}\x{6F78}\x{6F7A}\x{6F7B}\x{6F7C}' . +'\x{6F7D}\x{6F7E}\x{6F7F}\x{6F80}\x{6F81}\x{6F82}\x{6F83}\x{6F84}\x{6F85}' . +'\x{6F86}\x{6F87}\x{6F88}\x{6F89}\x{6F8A}\x{6F8B}\x{6F8C}\x{6F8D}\x{6F8E}' . +'\x{6F8F}\x{6F90}\x{6F91}\x{6F92}\x{6F93}\x{6F94}\x{6F95}\x{6F96}\x{6F97}' . +'\x{6F99}\x{6F9B}\x{6F9C}\x{6F9D}\x{6F9E}\x{6FA0}\x{6FA1}\x{6FA2}\x{6FA3}' . +'\x{6FA4}\x{6FA5}\x{6FA6}\x{6FA7}\x{6FA8}\x{6FA9}\x{6FAA}\x{6FAB}\x{6FAC}' . +'\x{6FAD}\x{6FAE}\x{6FAF}\x{6FB0}\x{6FB1}\x{6FB2}\x{6FB3}\x{6FB4}\x{6FB5}' . +'\x{6FB6}\x{6FB8}\x{6FB9}\x{6FBA}\x{6FBB}\x{6FBC}\x{6FBD}\x{6FBE}\x{6FBF}' . +'\x{6FC0}\x{6FC1}\x{6FC2}\x{6FC3}\x{6FC4}\x{6FC6}\x{6FC7}\x{6FC8}\x{6FC9}' . +'\x{6FCA}\x{6FCB}\x{6FCC}\x{6FCD}\x{6FCE}\x{6FCF}\x{6FD1}\x{6FD2}\x{6FD4}' . +'\x{6FD5}\x{6FD6}\x{6FD7}\x{6FD8}\x{6FD9}\x{6FDA}\x{6FDB}\x{6FDC}\x{6FDD}' . +'\x{6FDE}\x{6FDF}\x{6FE0}\x{6FE1}\x{6FE2}\x{6FE3}\x{6FE4}\x{6FE5}\x{6FE6}' . +'\x{6FE7}\x{6FE8}\x{6FE9}\x{6FEA}\x{6FEB}\x{6FEC}\x{6FED}\x{6FEE}\x{6FEF}' . +'\x{6FF0}\x{6FF1}\x{6FF2}\x{6FF3}\x{6FF4}\x{6FF6}\x{6FF7}\x{6FF8}\x{6FF9}' . +'\x{6FFA}\x{6FFB}\x{6FFC}\x{6FFE}\x{6FFF}\x{7000}\x{7001}\x{7002}\x{7003}' . +'\x{7004}\x{7005}\x{7006}\x{7007}\x{7008}\x{7009}\x{700A}\x{700B}\x{700C}' . +'\x{700D}\x{700E}\x{700F}\x{7011}\x{7012}\x{7014}\x{7015}\x{7016}\x{7017}' . +'\x{7018}\x{7019}\x{701A}\x{701B}\x{701C}\x{701D}\x{701F}\x{7020}\x{7021}' . +'\x{7022}\x{7023}\x{7024}\x{7025}\x{7026}\x{7027}\x{7028}\x{7029}\x{702A}' . +'\x{702B}\x{702C}\x{702D}\x{702E}\x{702F}\x{7030}\x{7031}\x{7032}\x{7033}' . +'\x{7034}\x{7035}\x{7036}\x{7037}\x{7038}\x{7039}\x{703A}\x{703B}\x{703C}' . +'\x{703D}\x{703E}\x{703F}\x{7040}\x{7041}\x{7042}\x{7043}\x{7044}\x{7045}' . +'\x{7046}\x{7048}\x{7049}\x{704A}\x{704C}\x{704D}\x{704F}\x{7050}\x{7051}' . +'\x{7052}\x{7053}\x{7054}\x{7055}\x{7056}\x{7057}\x{7058}\x{7059}\x{705A}' . +'\x{705B}\x{705C}\x{705D}\x{705E}\x{705F}\x{7060}\x{7061}\x{7062}\x{7063}' . +'\x{7064}\x{7065}\x{7066}\x{7067}\x{7068}\x{7069}\x{706A}\x{706B}\x{706C}' . +'\x{706D}\x{706E}\x{706F}\x{7070}\x{7071}\x{7074}\x{7075}\x{7076}\x{7077}' . +'\x{7078}\x{7079}\x{707A}\x{707C}\x{707D}\x{707E}\x{707F}\x{7080}\x{7082}' . +'\x{7083}\x{7084}\x{7085}\x{7086}\x{7087}\x{7088}\x{7089}\x{708A}\x{708B}' . +'\x{708C}\x{708E}\x{708F}\x{7090}\x{7091}\x{7092}\x{7093}\x{7094}\x{7095}' . +'\x{7096}\x{7098}\x{7099}\x{709A}\x{709C}\x{709D}\x{709E}\x{709F}\x{70A0}' . +'\x{70A1}\x{70A2}\x{70A3}\x{70A4}\x{70A5}\x{70A6}\x{70A7}\x{70A8}\x{70A9}' . +'\x{70AB}\x{70AC}\x{70AD}\x{70AE}\x{70AF}\x{70B0}\x{70B1}\x{70B3}\x{70B4}' . +'\x{70B5}\x{70B7}\x{70B8}\x{70B9}\x{70BA}\x{70BB}\x{70BC}\x{70BD}\x{70BE}' . +'\x{70BF}\x{70C0}\x{70C1}\x{70C2}\x{70C3}\x{70C4}\x{70C5}\x{70C6}\x{70C7}' . +'\x{70C8}\x{70C9}\x{70CA}\x{70CB}\x{70CC}\x{70CD}\x{70CE}\x{70CF}\x{70D0}' . +'\x{70D1}\x{70D2}\x{70D3}\x{70D4}\x{70D6}\x{70D7}\x{70D8}\x{70D9}\x{70DA}' . +'\x{70DB}\x{70DC}\x{70DD}\x{70DE}\x{70DF}\x{70E0}\x{70E1}\x{70E2}\x{70E3}' . +'\x{70E4}\x{70E5}\x{70E6}\x{70E7}\x{70E8}\x{70E9}\x{70EA}\x{70EB}\x{70EC}' . +'\x{70ED}\x{70EE}\x{70EF}\x{70F0}\x{70F1}\x{70F2}\x{70F3}\x{70F4}\x{70F5}' . +'\x{70F6}\x{70F7}\x{70F8}\x{70F9}\x{70FA}\x{70FB}\x{70FC}\x{70FD}\x{70FF}' . +'\x{7100}\x{7101}\x{7102}\x{7103}\x{7104}\x{7105}\x{7106}\x{7107}\x{7109}' . +'\x{710A}\x{710B}\x{710C}\x{710D}\x{710E}\x{710F}\x{7110}\x{7111}\x{7112}' . +'\x{7113}\x{7115}\x{7116}\x{7117}\x{7118}\x{7119}\x{711A}\x{711B}\x{711C}' . +'\x{711D}\x{711E}\x{711F}\x{7120}\x{7121}\x{7122}\x{7123}\x{7125}\x{7126}' . +'\x{7127}\x{7128}\x{7129}\x{712A}\x{712B}\x{712C}\x{712D}\x{712E}\x{712F}' . +'\x{7130}\x{7131}\x{7132}\x{7135}\x{7136}\x{7137}\x{7138}\x{7139}\x{713A}' . +'\x{713B}\x{713D}\x{713E}\x{713F}\x{7140}\x{7141}\x{7142}\x{7143}\x{7144}' . +'\x{7145}\x{7146}\x{7147}\x{7148}\x{7149}\x{714A}\x{714B}\x{714C}\x{714D}' . +'\x{714E}\x{714F}\x{7150}\x{7151}\x{7152}\x{7153}\x{7154}\x{7156}\x{7158}' . +'\x{7159}\x{715A}\x{715B}\x{715C}\x{715D}\x{715E}\x{715F}\x{7160}\x{7161}' . +'\x{7162}\x{7163}\x{7164}\x{7165}\x{7166}\x{7167}\x{7168}\x{7169}\x{716A}' . +'\x{716C}\x{716E}\x{716F}\x{7170}\x{7171}\x{7172}\x{7173}\x{7174}\x{7175}' . +'\x{7176}\x{7177}\x{7178}\x{7179}\x{717A}\x{717B}\x{717C}\x{717D}\x{717E}' . +'\x{717F}\x{7180}\x{7181}\x{7182}\x{7183}\x{7184}\x{7185}\x{7186}\x{7187}' . +'\x{7188}\x{7189}\x{718A}\x{718B}\x{718C}\x{718E}\x{718F}\x{7190}\x{7191}' . +'\x{7192}\x{7193}\x{7194}\x{7195}\x{7197}\x{7198}\x{7199}\x{719A}\x{719B}' . +'\x{719C}\x{719D}\x{719E}\x{719F}\x{71A0}\x{71A1}\x{71A2}\x{71A3}\x{71A4}' . +'\x{71A5}\x{71A7}\x{71A8}\x{71A9}\x{71AA}\x{71AC}\x{71AD}\x{71AE}\x{71AF}' . +'\x{71B0}\x{71B1}\x{71B2}\x{71B3}\x{71B4}\x{71B5}\x{71B7}\x{71B8}\x{71B9}' . +'\x{71BA}\x{71BB}\x{71BC}\x{71BD}\x{71BE}\x{71BF}\x{71C0}\x{71C1}\x{71C2}' . +'\x{71C3}\x{71C4}\x{71C5}\x{71C6}\x{71C7}\x{71C8}\x{71C9}\x{71CA}\x{71CB}' . +'\x{71CD}\x{71CE}\x{71CF}\x{71D0}\x{71D1}\x{71D2}\x{71D4}\x{71D5}\x{71D6}' . +'\x{71D7}\x{71D8}\x{71D9}\x{71DA}\x{71DB}\x{71DC}\x{71DD}\x{71DE}\x{71DF}' . +'\x{71E0}\x{71E1}\x{71E2}\x{71E3}\x{71E4}\x{71E5}\x{71E6}\x{71E7}\x{71E8}' . +'\x{71E9}\x{71EA}\x{71EB}\x{71EC}\x{71ED}\x{71EE}\x{71EF}\x{71F0}\x{71F1}' . +'\x{71F2}\x{71F4}\x{71F5}\x{71F6}\x{71F7}\x{71F8}\x{71F9}\x{71FB}\x{71FC}' . +'\x{71FD}\x{71FE}\x{71FF}\x{7201}\x{7202}\x{7203}\x{7204}\x{7205}\x{7206}' . +'\x{7207}\x{7208}\x{7209}\x{720A}\x{720C}\x{720D}\x{720E}\x{720F}\x{7210}' . +'\x{7212}\x{7213}\x{7214}\x{7216}\x{7218}\x{7219}\x{721A}\x{721B}\x{721C}' . +'\x{721D}\x{721E}\x{721F}\x{7221}\x{7222}\x{7223}\x{7226}\x{7227}\x{7228}' . +'\x{7229}\x{722A}\x{722B}\x{722C}\x{722D}\x{722E}\x{7230}\x{7231}\x{7232}' . +'\x{7233}\x{7235}\x{7236}\x{7237}\x{7238}\x{7239}\x{723A}\x{723B}\x{723C}' . +'\x{723D}\x{723E}\x{723F}\x{7240}\x{7241}\x{7242}\x{7243}\x{7244}\x{7246}' . +'\x{7247}\x{7248}\x{7249}\x{724A}\x{724B}\x{724C}\x{724D}\x{724F}\x{7251}' . +'\x{7252}\x{7253}\x{7254}\x{7256}\x{7257}\x{7258}\x{7259}\x{725A}\x{725B}' . +'\x{725C}\x{725D}\x{725E}\x{725F}\x{7260}\x{7261}\x{7262}\x{7263}\x{7264}' . +'\x{7265}\x{7266}\x{7267}\x{7268}\x{7269}\x{726A}\x{726B}\x{726C}\x{726D}' . +'\x{726E}\x{726F}\x{7270}\x{7271}\x{7272}\x{7273}\x{7274}\x{7275}\x{7276}' . +'\x{7277}\x{7278}\x{7279}\x{727A}\x{727B}\x{727C}\x{727D}\x{727E}\x{727F}' . +'\x{7280}\x{7281}\x{7282}\x{7283}\x{7284}\x{7285}\x{7286}\x{7287}\x{7288}' . +'\x{7289}\x{728A}\x{728B}\x{728C}\x{728D}\x{728E}\x{728F}\x{7290}\x{7291}' . +'\x{7292}\x{7293}\x{7294}\x{7295}\x{7296}\x{7297}\x{7298}\x{7299}\x{729A}' . +'\x{729B}\x{729C}\x{729D}\x{729E}\x{729F}\x{72A1}\x{72A2}\x{72A3}\x{72A4}' . +'\x{72A5}\x{72A6}\x{72A7}\x{72A8}\x{72A9}\x{72AA}\x{72AC}\x{72AD}\x{72AE}' . +'\x{72AF}\x{72B0}\x{72B1}\x{72B2}\x{72B3}\x{72B4}\x{72B5}\x{72B6}\x{72B7}' . +'\x{72B8}\x{72B9}\x{72BA}\x{72BB}\x{72BC}\x{72BD}\x{72BF}\x{72C0}\x{72C1}' . +'\x{72C2}\x{72C3}\x{72C4}\x{72C5}\x{72C6}\x{72C7}\x{72C8}\x{72C9}\x{72CA}' . +'\x{72CB}\x{72CC}\x{72CD}\x{72CE}\x{72CF}\x{72D0}\x{72D1}\x{72D2}\x{72D3}' . +'\x{72D4}\x{72D5}\x{72D6}\x{72D7}\x{72D8}\x{72D9}\x{72DA}\x{72DB}\x{72DC}' . +'\x{72DD}\x{72DE}\x{72DF}\x{72E0}\x{72E1}\x{72E2}\x{72E3}\x{72E4}\x{72E5}' . +'\x{72E6}\x{72E7}\x{72E8}\x{72E9}\x{72EA}\x{72EB}\x{72EC}\x{72ED}\x{72EE}' . +'\x{72EF}\x{72F0}\x{72F1}\x{72F2}\x{72F3}\x{72F4}\x{72F5}\x{72F6}\x{72F7}' . +'\x{72F8}\x{72F9}\x{72FA}\x{72FB}\x{72FC}\x{72FD}\x{72FE}\x{72FF}\x{7300}' . +'\x{7301}\x{7303}\x{7304}\x{7305}\x{7306}\x{7307}\x{7308}\x{7309}\x{730A}' . +'\x{730B}\x{730C}\x{730D}\x{730E}\x{730F}\x{7311}\x{7312}\x{7313}\x{7314}' . +'\x{7315}\x{7316}\x{7317}\x{7318}\x{7319}\x{731A}\x{731B}\x{731C}\x{731D}' . +'\x{731E}\x{7320}\x{7321}\x{7322}\x{7323}\x{7324}\x{7325}\x{7326}\x{7327}' . +'\x{7329}\x{732A}\x{732B}\x{732C}\x{732D}\x{732E}\x{7330}\x{7331}\x{7332}' . +'\x{7333}\x{7334}\x{7335}\x{7336}\x{7337}\x{7338}\x{7339}\x{733A}\x{733B}' . +'\x{733C}\x{733D}\x{733E}\x{733F}\x{7340}\x{7341}\x{7342}\x{7343}\x{7344}' . +'\x{7345}\x{7346}\x{7347}\x{7348}\x{7349}\x{734A}\x{734B}\x{734C}\x{734D}' . +'\x{734E}\x{7350}\x{7351}\x{7352}\x{7354}\x{7355}\x{7356}\x{7357}\x{7358}' . +'\x{7359}\x{735A}\x{735B}\x{735C}\x{735D}\x{735E}\x{735F}\x{7360}\x{7361}' . +'\x{7362}\x{7364}\x{7365}\x{7366}\x{7367}\x{7368}\x{7369}\x{736A}\x{736B}' . +'\x{736C}\x{736D}\x{736E}\x{736F}\x{7370}\x{7371}\x{7372}\x{7373}\x{7374}' . +'\x{7375}\x{7376}\x{7377}\x{7378}\x{7379}\x{737A}\x{737B}\x{737C}\x{737D}' . +'\x{737E}\x{737F}\x{7380}\x{7381}\x{7382}\x{7383}\x{7384}\x{7385}\x{7386}' . +'\x{7387}\x{7388}\x{7389}\x{738A}\x{738B}\x{738C}\x{738D}\x{738E}\x{738F}' . +'\x{7390}\x{7391}\x{7392}\x{7393}\x{7394}\x{7395}\x{7396}\x{7397}\x{7398}' . +'\x{7399}\x{739A}\x{739B}\x{739D}\x{739E}\x{739F}\x{73A0}\x{73A1}\x{73A2}' . +'\x{73A3}\x{73A4}\x{73A5}\x{73A6}\x{73A7}\x{73A8}\x{73A9}\x{73AA}\x{73AB}' . +'\x{73AC}\x{73AD}\x{73AE}\x{73AF}\x{73B0}\x{73B1}\x{73B2}\x{73B3}\x{73B4}' . +'\x{73B5}\x{73B6}\x{73B7}\x{73B8}\x{73B9}\x{73BA}\x{73BB}\x{73BC}\x{73BD}' . +'\x{73BE}\x{73BF}\x{73C0}\x{73C2}\x{73C3}\x{73C4}\x{73C5}\x{73C6}\x{73C7}' . +'\x{73C8}\x{73C9}\x{73CA}\x{73CB}\x{73CC}\x{73CD}\x{73CE}\x{73CF}\x{73D0}' . +'\x{73D1}\x{73D2}\x{73D3}\x{73D4}\x{73D5}\x{73D6}\x{73D7}\x{73D8}\x{73D9}' . +'\x{73DA}\x{73DB}\x{73DC}\x{73DD}\x{73DE}\x{73DF}\x{73E0}\x{73E2}\x{73E3}' . +'\x{73E5}\x{73E6}\x{73E7}\x{73E8}\x{73E9}\x{73EA}\x{73EB}\x{73EC}\x{73ED}' . +'\x{73EE}\x{73EF}\x{73F0}\x{73F1}\x{73F2}\x{73F4}\x{73F5}\x{73F6}\x{73F7}' . +'\x{73F8}\x{73F9}\x{73FA}\x{73FC}\x{73FD}\x{73FE}\x{73FF}\x{7400}\x{7401}' . +'\x{7402}\x{7403}\x{7404}\x{7405}\x{7406}\x{7407}\x{7408}\x{7409}\x{740A}' . +'\x{740B}\x{740C}\x{740D}\x{740E}\x{740F}\x{7410}\x{7411}\x{7412}\x{7413}' . +'\x{7414}\x{7415}\x{7416}\x{7417}\x{7419}\x{741A}\x{741B}\x{741C}\x{741D}' . +'\x{741E}\x{741F}\x{7420}\x{7421}\x{7422}\x{7423}\x{7424}\x{7425}\x{7426}' . +'\x{7427}\x{7428}\x{7429}\x{742A}\x{742B}\x{742C}\x{742D}\x{742E}\x{742F}' . +'\x{7430}\x{7431}\x{7432}\x{7433}\x{7434}\x{7435}\x{7436}\x{7437}\x{7438}' . +'\x{743A}\x{743B}\x{743C}\x{743D}\x{743F}\x{7440}\x{7441}\x{7442}\x{7443}' . +'\x{7444}\x{7445}\x{7446}\x{7448}\x{744A}\x{744B}\x{744C}\x{744D}\x{744E}' . +'\x{744F}\x{7450}\x{7451}\x{7452}\x{7453}\x{7454}\x{7455}\x{7456}\x{7457}' . +'\x{7459}\x{745A}\x{745B}\x{745C}\x{745D}\x{745E}\x{745F}\x{7461}\x{7462}' . +'\x{7463}\x{7464}\x{7465}\x{7466}\x{7467}\x{7468}\x{7469}\x{746A}\x{746B}' . +'\x{746C}\x{746D}\x{746E}\x{746F}\x{7470}\x{7471}\x{7472}\x{7473}\x{7474}' . +'\x{7475}\x{7476}\x{7477}\x{7478}\x{7479}\x{747A}\x{747C}\x{747D}\x{747E}' . +'\x{747F}\x{7480}\x{7481}\x{7482}\x{7483}\x{7485}\x{7486}\x{7487}\x{7488}' . +'\x{7489}\x{748A}\x{748B}\x{748C}\x{748D}\x{748E}\x{748F}\x{7490}\x{7491}' . +'\x{7492}\x{7493}\x{7494}\x{7495}\x{7497}\x{7498}\x{7499}\x{749A}\x{749B}' . +'\x{749C}\x{749E}\x{749F}\x{74A0}\x{74A1}\x{74A3}\x{74A4}\x{74A5}\x{74A6}' . +'\x{74A7}\x{74A8}\x{74A9}\x{74AA}\x{74AB}\x{74AC}\x{74AD}\x{74AE}\x{74AF}' . +'\x{74B0}\x{74B1}\x{74B2}\x{74B3}\x{74B4}\x{74B5}\x{74B6}\x{74B7}\x{74B8}' . +'\x{74B9}\x{74BA}\x{74BB}\x{74BC}\x{74BD}\x{74BE}\x{74BF}\x{74C0}\x{74C1}' . +'\x{74C2}\x{74C3}\x{74C4}\x{74C5}\x{74C6}\x{74CA}\x{74CB}\x{74CD}\x{74CE}' . +'\x{74CF}\x{74D0}\x{74D1}\x{74D2}\x{74D3}\x{74D4}\x{74D5}\x{74D6}\x{74D7}' . +'\x{74D8}\x{74D9}\x{74DA}\x{74DB}\x{74DC}\x{74DD}\x{74DE}\x{74DF}\x{74E0}' . +'\x{74E1}\x{74E2}\x{74E3}\x{74E4}\x{74E5}\x{74E6}\x{74E7}\x{74E8}\x{74E9}' . +'\x{74EA}\x{74EC}\x{74ED}\x{74EE}\x{74EF}\x{74F0}\x{74F1}\x{74F2}\x{74F3}' . +'\x{74F4}\x{74F5}\x{74F6}\x{74F7}\x{74F8}\x{74F9}\x{74FA}\x{74FB}\x{74FC}' . +'\x{74FD}\x{74FE}\x{74FF}\x{7500}\x{7501}\x{7502}\x{7503}\x{7504}\x{7505}' . +'\x{7506}\x{7507}\x{7508}\x{7509}\x{750A}\x{750B}\x{750C}\x{750D}\x{750F}' . +'\x{7510}\x{7511}\x{7512}\x{7513}\x{7514}\x{7515}\x{7516}\x{7517}\x{7518}' . +'\x{7519}\x{751A}\x{751B}\x{751C}\x{751D}\x{751E}\x{751F}\x{7521}\x{7522}' . +'\x{7523}\x{7524}\x{7525}\x{7526}\x{7527}\x{7528}\x{7529}\x{752A}\x{752B}' . +'\x{752C}\x{752D}\x{752E}\x{752F}\x{7530}\x{7531}\x{7532}\x{7533}\x{7535}' . +'\x{7536}\x{7537}\x{7538}\x{7539}\x{753A}\x{753B}\x{753C}\x{753D}\x{753E}' . +'\x{753F}\x{7540}\x{7542}\x{7543}\x{7544}\x{7545}\x{7546}\x{7547}\x{7548}' . +'\x{7549}\x{754B}\x{754C}\x{754D}\x{754E}\x{754F}\x{7550}\x{7551}\x{7553}' . +'\x{7554}\x{7556}\x{7557}\x{7558}\x{7559}\x{755A}\x{755B}\x{755C}\x{755D}' . +'\x{755F}\x{7560}\x{7562}\x{7563}\x{7564}\x{7565}\x{7566}\x{7567}\x{7568}' . +'\x{7569}\x{756A}\x{756B}\x{756C}\x{756D}\x{756E}\x{756F}\x{7570}\x{7572}' . +'\x{7574}\x{7575}\x{7576}\x{7577}\x{7578}\x{7579}\x{757C}\x{757D}\x{757E}' . +'\x{757F}\x{7580}\x{7581}\x{7582}\x{7583}\x{7584}\x{7586}\x{7587}\x{7588}' . +'\x{7589}\x{758A}\x{758B}\x{758C}\x{758D}\x{758F}\x{7590}\x{7591}\x{7592}' . +'\x{7593}\x{7594}\x{7595}\x{7596}\x{7597}\x{7598}\x{7599}\x{759A}\x{759B}' . +'\x{759C}\x{759D}\x{759E}\x{759F}\x{75A0}\x{75A1}\x{75A2}\x{75A3}\x{75A4}' . +'\x{75A5}\x{75A6}\x{75A7}\x{75A8}\x{75AA}\x{75AB}\x{75AC}\x{75AD}\x{75AE}' . +'\x{75AF}\x{75B0}\x{75B1}\x{75B2}\x{75B3}\x{75B4}\x{75B5}\x{75B6}\x{75B8}' . +'\x{75B9}\x{75BA}\x{75BB}\x{75BC}\x{75BD}\x{75BE}\x{75BF}\x{75C0}\x{75C1}' . +'\x{75C2}\x{75C3}\x{75C4}\x{75C5}\x{75C6}\x{75C7}\x{75C8}\x{75C9}\x{75CA}' . +'\x{75CB}\x{75CC}\x{75CD}\x{75CE}\x{75CF}\x{75D0}\x{75D1}\x{75D2}\x{75D3}' . +'\x{75D4}\x{75D5}\x{75D6}\x{75D7}\x{75D8}\x{75D9}\x{75DA}\x{75DB}\x{75DD}' . +'\x{75DE}\x{75DF}\x{75E0}\x{75E1}\x{75E2}\x{75E3}\x{75E4}\x{75E5}\x{75E6}' . +'\x{75E7}\x{75E8}\x{75EA}\x{75EB}\x{75EC}\x{75ED}\x{75EF}\x{75F0}\x{75F1}' . +'\x{75F2}\x{75F3}\x{75F4}\x{75F5}\x{75F6}\x{75F7}\x{75F8}\x{75F9}\x{75FA}' . +'\x{75FB}\x{75FC}\x{75FD}\x{75FE}\x{75FF}\x{7600}\x{7601}\x{7602}\x{7603}' . +'\x{7604}\x{7605}\x{7606}\x{7607}\x{7608}\x{7609}\x{760A}\x{760B}\x{760C}' . +'\x{760D}\x{760E}\x{760F}\x{7610}\x{7611}\x{7612}\x{7613}\x{7614}\x{7615}' . +'\x{7616}\x{7617}\x{7618}\x{7619}\x{761A}\x{761B}\x{761C}\x{761D}\x{761E}' . +'\x{761F}\x{7620}\x{7621}\x{7622}\x{7623}\x{7624}\x{7625}\x{7626}\x{7627}' . +'\x{7628}\x{7629}\x{762A}\x{762B}\x{762D}\x{762E}\x{762F}\x{7630}\x{7631}' . +'\x{7632}\x{7633}\x{7634}\x{7635}\x{7636}\x{7637}\x{7638}\x{7639}\x{763A}' . +'\x{763B}\x{763C}\x{763D}\x{763E}\x{763F}\x{7640}\x{7641}\x{7642}\x{7643}' . +'\x{7646}\x{7647}\x{7648}\x{7649}\x{764A}\x{764B}\x{764C}\x{764D}\x{764F}' . +'\x{7650}\x{7652}\x{7653}\x{7654}\x{7656}\x{7657}\x{7658}\x{7659}\x{765A}' . +'\x{765B}\x{765C}\x{765D}\x{765E}\x{765F}\x{7660}\x{7661}\x{7662}\x{7663}' . +'\x{7664}\x{7665}\x{7666}\x{7667}\x{7668}\x{7669}\x{766A}\x{766B}\x{766C}' . +'\x{766D}\x{766E}\x{766F}\x{7670}\x{7671}\x{7672}\x{7674}\x{7675}\x{7676}' . +'\x{7677}\x{7678}\x{7679}\x{767B}\x{767C}\x{767D}\x{767E}\x{767F}\x{7680}' . +'\x{7681}\x{7682}\x{7683}\x{7684}\x{7685}\x{7686}\x{7687}\x{7688}\x{7689}' . +'\x{768A}\x{768B}\x{768C}\x{768E}\x{768F}\x{7690}\x{7691}\x{7692}\x{7693}' . +'\x{7694}\x{7695}\x{7696}\x{7697}\x{7698}\x{7699}\x{769A}\x{769B}\x{769C}' . +'\x{769D}\x{769E}\x{769F}\x{76A0}\x{76A3}\x{76A4}\x{76A6}\x{76A7}\x{76A9}' . +'\x{76AA}\x{76AB}\x{76AC}\x{76AD}\x{76AE}\x{76AF}\x{76B0}\x{76B1}\x{76B2}' . +'\x{76B4}\x{76B5}\x{76B7}\x{76B8}\x{76BA}\x{76BB}\x{76BC}\x{76BD}\x{76BE}' . +'\x{76BF}\x{76C0}\x{76C2}\x{76C3}\x{76C4}\x{76C5}\x{76C6}\x{76C7}\x{76C8}' . +'\x{76C9}\x{76CA}\x{76CD}\x{76CE}\x{76CF}\x{76D0}\x{76D1}\x{76D2}\x{76D3}' . +'\x{76D4}\x{76D5}\x{76D6}\x{76D7}\x{76D8}\x{76DA}\x{76DB}\x{76DC}\x{76DD}' . +'\x{76DE}\x{76DF}\x{76E0}\x{76E1}\x{76E2}\x{76E3}\x{76E4}\x{76E5}\x{76E6}' . +'\x{76E7}\x{76E8}\x{76E9}\x{76EA}\x{76EC}\x{76ED}\x{76EE}\x{76EF}\x{76F0}' . +'\x{76F1}\x{76F2}\x{76F3}\x{76F4}\x{76F5}\x{76F6}\x{76F7}\x{76F8}\x{76F9}' . +'\x{76FA}\x{76FB}\x{76FC}\x{76FD}\x{76FE}\x{76FF}\x{7701}\x{7703}\x{7704}' . +'\x{7705}\x{7706}\x{7707}\x{7708}\x{7709}\x{770A}\x{770B}\x{770C}\x{770D}' . +'\x{770F}\x{7710}\x{7711}\x{7712}\x{7713}\x{7714}\x{7715}\x{7716}\x{7717}' . +'\x{7718}\x{7719}\x{771A}\x{771B}\x{771C}\x{771D}\x{771E}\x{771F}\x{7720}' . +'\x{7722}\x{7723}\x{7725}\x{7726}\x{7727}\x{7728}\x{7729}\x{772A}\x{772C}' . +'\x{772D}\x{772E}\x{772F}\x{7730}\x{7731}\x{7732}\x{7733}\x{7734}\x{7735}' . +'\x{7736}\x{7737}\x{7738}\x{7739}\x{773A}\x{773B}\x{773C}\x{773D}\x{773E}' . +'\x{7740}\x{7741}\x{7743}\x{7744}\x{7745}\x{7746}\x{7747}\x{7748}\x{7749}' . +'\x{774A}\x{774B}\x{774C}\x{774D}\x{774E}\x{774F}\x{7750}\x{7751}\x{7752}' . +'\x{7753}\x{7754}\x{7755}\x{7756}\x{7757}\x{7758}\x{7759}\x{775A}\x{775B}' . +'\x{775C}\x{775D}\x{775E}\x{775F}\x{7760}\x{7761}\x{7762}\x{7763}\x{7765}' . +'\x{7766}\x{7767}\x{7768}\x{7769}\x{776A}\x{776B}\x{776C}\x{776D}\x{776E}' . +'\x{776F}\x{7770}\x{7771}\x{7772}\x{7773}\x{7774}\x{7775}\x{7776}\x{7777}' . +'\x{7778}\x{7779}\x{777A}\x{777B}\x{777C}\x{777D}\x{777E}\x{777F}\x{7780}' . +'\x{7781}\x{7782}\x{7783}\x{7784}\x{7785}\x{7786}\x{7787}\x{7788}\x{7789}' . +'\x{778A}\x{778B}\x{778C}\x{778D}\x{778E}\x{778F}\x{7790}\x{7791}\x{7792}' . +'\x{7793}\x{7794}\x{7795}\x{7797}\x{7798}\x{7799}\x{779A}\x{779B}\x{779C}' . +'\x{779D}\x{779E}\x{779F}\x{77A0}\x{77A1}\x{77A2}\x{77A3}\x{77A5}\x{77A6}' . +'\x{77A7}\x{77A8}\x{77A9}\x{77AA}\x{77AB}\x{77AC}\x{77AD}\x{77AE}\x{77AF}' . +'\x{77B0}\x{77B1}\x{77B2}\x{77B3}\x{77B4}\x{77B5}\x{77B6}\x{77B7}\x{77B8}' . +'\x{77B9}\x{77BA}\x{77BB}\x{77BC}\x{77BD}\x{77BF}\x{77C0}\x{77C2}\x{77C3}' . +'\x{77C4}\x{77C5}\x{77C6}\x{77C7}\x{77C8}\x{77C9}\x{77CA}\x{77CB}\x{77CC}' . +'\x{77CD}\x{77CE}\x{77CF}\x{77D0}\x{77D1}\x{77D3}\x{77D4}\x{77D5}\x{77D6}' . +'\x{77D7}\x{77D8}\x{77D9}\x{77DA}\x{77DB}\x{77DC}\x{77DE}\x{77DF}\x{77E0}' . +'\x{77E1}\x{77E2}\x{77E3}\x{77E5}\x{77E7}\x{77E8}\x{77E9}\x{77EA}\x{77EB}' . +'\x{77EC}\x{77ED}\x{77EE}\x{77EF}\x{77F0}\x{77F1}\x{77F2}\x{77F3}\x{77F6}' . +'\x{77F7}\x{77F8}\x{77F9}\x{77FA}\x{77FB}\x{77FC}\x{77FD}\x{77FE}\x{77FF}' . +'\x{7800}\x{7801}\x{7802}\x{7803}\x{7804}\x{7805}\x{7806}\x{7808}\x{7809}' . +'\x{780A}\x{780B}\x{780C}\x{780D}\x{780E}\x{780F}\x{7810}\x{7811}\x{7812}' . +'\x{7813}\x{7814}\x{7815}\x{7816}\x{7817}\x{7818}\x{7819}\x{781A}\x{781B}' . +'\x{781C}\x{781D}\x{781E}\x{781F}\x{7820}\x{7821}\x{7822}\x{7823}\x{7825}' . +'\x{7826}\x{7827}\x{7828}\x{7829}\x{782A}\x{782B}\x{782C}\x{782D}\x{782E}' . +'\x{782F}\x{7830}\x{7831}\x{7832}\x{7833}\x{7834}\x{7835}\x{7837}\x{7838}' . +'\x{7839}\x{783A}\x{783B}\x{783C}\x{783D}\x{783E}\x{7840}\x{7841}\x{7843}' . +'\x{7844}\x{7845}\x{7847}\x{7848}\x{7849}\x{784A}\x{784C}\x{784D}\x{784E}' . +'\x{7850}\x{7851}\x{7852}\x{7853}\x{7854}\x{7855}\x{7856}\x{7857}\x{7858}' . +'\x{7859}\x{785A}\x{785B}\x{785C}\x{785D}\x{785E}\x{785F}\x{7860}\x{7861}' . +'\x{7862}\x{7863}\x{7864}\x{7865}\x{7866}\x{7867}\x{7868}\x{7869}\x{786A}' . +'\x{786B}\x{786C}\x{786D}\x{786E}\x{786F}\x{7870}\x{7871}\x{7872}\x{7873}' . +'\x{7874}\x{7875}\x{7877}\x{7878}\x{7879}\x{787A}\x{787B}\x{787C}\x{787D}' . +'\x{787E}\x{787F}\x{7880}\x{7881}\x{7882}\x{7883}\x{7884}\x{7885}\x{7886}' . +'\x{7887}\x{7889}\x{788A}\x{788B}\x{788C}\x{788D}\x{788E}\x{788F}\x{7890}' . +'\x{7891}\x{7892}\x{7893}\x{7894}\x{7895}\x{7896}\x{7897}\x{7898}\x{7899}' . +'\x{789A}\x{789B}\x{789C}\x{789D}\x{789E}\x{789F}\x{78A0}\x{78A1}\x{78A2}' . +'\x{78A3}\x{78A4}\x{78A5}\x{78A6}\x{78A7}\x{78A8}\x{78A9}\x{78AA}\x{78AB}' . +'\x{78AC}\x{78AD}\x{78AE}\x{78AF}\x{78B0}\x{78B1}\x{78B2}\x{78B3}\x{78B4}' . +'\x{78B5}\x{78B6}\x{78B7}\x{78B8}\x{78B9}\x{78BA}\x{78BB}\x{78BC}\x{78BD}' . +'\x{78BE}\x{78BF}\x{78C0}\x{78C1}\x{78C3}\x{78C4}\x{78C5}\x{78C6}\x{78C8}' . +'\x{78C9}\x{78CA}\x{78CB}\x{78CC}\x{78CD}\x{78CE}\x{78CF}\x{78D0}\x{78D1}' . +'\x{78D3}\x{78D4}\x{78D5}\x{78D6}\x{78D7}\x{78D8}\x{78D9}\x{78DA}\x{78DB}' . +'\x{78DC}\x{78DD}\x{78DE}\x{78DF}\x{78E0}\x{78E1}\x{78E2}\x{78E3}\x{78E4}' . +'\x{78E5}\x{78E6}\x{78E7}\x{78E8}\x{78E9}\x{78EA}\x{78EB}\x{78EC}\x{78ED}' . +'\x{78EE}\x{78EF}\x{78F1}\x{78F2}\x{78F3}\x{78F4}\x{78F5}\x{78F6}\x{78F7}' . +'\x{78F9}\x{78FA}\x{78FB}\x{78FC}\x{78FD}\x{78FE}\x{78FF}\x{7901}\x{7902}' . +'\x{7903}\x{7904}\x{7905}\x{7906}\x{7907}\x{7909}\x{790A}\x{790B}\x{790C}' . +'\x{790E}\x{790F}\x{7910}\x{7911}\x{7912}\x{7913}\x{7914}\x{7916}\x{7917}' . +'\x{7918}\x{7919}\x{791A}\x{791B}\x{791C}\x{791D}\x{791E}\x{7921}\x{7922}' . +'\x{7923}\x{7924}\x{7925}\x{7926}\x{7927}\x{7928}\x{7929}\x{792A}\x{792B}' . +'\x{792C}\x{792D}\x{792E}\x{792F}\x{7930}\x{7931}\x{7933}\x{7934}\x{7935}' . +'\x{7937}\x{7938}\x{7939}\x{793A}\x{793B}\x{793C}\x{793D}\x{793E}\x{793F}' . +'\x{7940}\x{7941}\x{7942}\x{7943}\x{7944}\x{7945}\x{7946}\x{7947}\x{7948}' . +'\x{7949}\x{794A}\x{794B}\x{794C}\x{794D}\x{794E}\x{794F}\x{7950}\x{7951}' . +'\x{7952}\x{7953}\x{7954}\x{7955}\x{7956}\x{7957}\x{7958}\x{795A}\x{795B}' . +'\x{795C}\x{795D}\x{795E}\x{795F}\x{7960}\x{7961}\x{7962}\x{7963}\x{7964}' . +'\x{7965}\x{7966}\x{7967}\x{7968}\x{7969}\x{796A}\x{796B}\x{796D}\x{796F}' . +'\x{7970}\x{7971}\x{7972}\x{7973}\x{7974}\x{7977}\x{7978}\x{7979}\x{797A}' . +'\x{797B}\x{797C}\x{797D}\x{797E}\x{797F}\x{7980}\x{7981}\x{7982}\x{7983}' . +'\x{7984}\x{7985}\x{7988}\x{7989}\x{798A}\x{798B}\x{798C}\x{798D}\x{798E}' . +'\x{798F}\x{7990}\x{7991}\x{7992}\x{7993}\x{7994}\x{7995}\x{7996}\x{7997}' . +'\x{7998}\x{7999}\x{799A}\x{799B}\x{799C}\x{799F}\x{79A0}\x{79A1}\x{79A2}' . +'\x{79A3}\x{79A4}\x{79A5}\x{79A6}\x{79A7}\x{79A8}\x{79AA}\x{79AB}\x{79AC}' . +'\x{79AD}\x{79AE}\x{79AF}\x{79B0}\x{79B1}\x{79B2}\x{79B3}\x{79B4}\x{79B5}' . +'\x{79B6}\x{79B7}\x{79B8}\x{79B9}\x{79BA}\x{79BB}\x{79BD}\x{79BE}\x{79BF}' . +'\x{79C0}\x{79C1}\x{79C2}\x{79C3}\x{79C5}\x{79C6}\x{79C8}\x{79C9}\x{79CA}' . +'\x{79CB}\x{79CD}\x{79CE}\x{79CF}\x{79D0}\x{79D1}\x{79D2}\x{79D3}\x{79D5}' . +'\x{79D6}\x{79D8}\x{79D9}\x{79DA}\x{79DB}\x{79DC}\x{79DD}\x{79DE}\x{79DF}' . +'\x{79E0}\x{79E1}\x{79E2}\x{79E3}\x{79E4}\x{79E5}\x{79E6}\x{79E7}\x{79E8}' . +'\x{79E9}\x{79EA}\x{79EB}\x{79EC}\x{79ED}\x{79EE}\x{79EF}\x{79F0}\x{79F1}' . +'\x{79F2}\x{79F3}\x{79F4}\x{79F5}\x{79F6}\x{79F7}\x{79F8}\x{79F9}\x{79FA}' . +'\x{79FB}\x{79FC}\x{79FD}\x{79FE}\x{79FF}\x{7A00}\x{7A02}\x{7A03}\x{7A04}' . +'\x{7A05}\x{7A06}\x{7A08}\x{7A0A}\x{7A0B}\x{7A0C}\x{7A0D}\x{7A0E}\x{7A0F}' . +'\x{7A10}\x{7A11}\x{7A12}\x{7A13}\x{7A14}\x{7A15}\x{7A16}\x{7A17}\x{7A18}' . +'\x{7A19}\x{7A1A}\x{7A1B}\x{7A1C}\x{7A1D}\x{7A1E}\x{7A1F}\x{7A20}\x{7A21}' . +'\x{7A22}\x{7A23}\x{7A24}\x{7A25}\x{7A26}\x{7A27}\x{7A28}\x{7A29}\x{7A2A}' . +'\x{7A2B}\x{7A2D}\x{7A2E}\x{7A2F}\x{7A30}\x{7A31}\x{7A32}\x{7A33}\x{7A34}' . +'\x{7A35}\x{7A37}\x{7A39}\x{7A3B}\x{7A3C}\x{7A3D}\x{7A3E}\x{7A3F}\x{7A40}' . +'\x{7A41}\x{7A42}\x{7A43}\x{7A44}\x{7A45}\x{7A46}\x{7A47}\x{7A48}\x{7A49}' . +'\x{7A4A}\x{7A4B}\x{7A4C}\x{7A4D}\x{7A4E}\x{7A50}\x{7A51}\x{7A52}\x{7A53}' . +'\x{7A54}\x{7A55}\x{7A56}\x{7A57}\x{7A58}\x{7A59}\x{7A5A}\x{7A5B}\x{7A5C}' . +'\x{7A5D}\x{7A5E}\x{7A5F}\x{7A60}\x{7A61}\x{7A62}\x{7A65}\x{7A66}\x{7A67}' . +'\x{7A68}\x{7A69}\x{7A6B}\x{7A6C}\x{7A6D}\x{7A6E}\x{7A70}\x{7A71}\x{7A72}' . +'\x{7A73}\x{7A74}\x{7A75}\x{7A76}\x{7A77}\x{7A78}\x{7A79}\x{7A7A}\x{7A7B}' . +'\x{7A7C}\x{7A7D}\x{7A7E}\x{7A7F}\x{7A80}\x{7A81}\x{7A83}\x{7A84}\x{7A85}' . +'\x{7A86}\x{7A87}\x{7A88}\x{7A89}\x{7A8A}\x{7A8B}\x{7A8C}\x{7A8D}\x{7A8E}' . +'\x{7A8F}\x{7A90}\x{7A91}\x{7A92}\x{7A93}\x{7A94}\x{7A95}\x{7A96}\x{7A97}' . +'\x{7A98}\x{7A99}\x{7A9C}\x{7A9D}\x{7A9E}\x{7A9F}\x{7AA0}\x{7AA1}\x{7AA2}' . +'\x{7AA3}\x{7AA4}\x{7AA5}\x{7AA6}\x{7AA7}\x{7AA8}\x{7AA9}\x{7AAA}\x{7AAB}' . +'\x{7AAC}\x{7AAD}\x{7AAE}\x{7AAF}\x{7AB0}\x{7AB1}\x{7AB2}\x{7AB3}\x{7AB4}' . +'\x{7AB5}\x{7AB6}\x{7AB7}\x{7AB8}\x{7ABA}\x{7ABE}\x{7ABF}\x{7AC0}\x{7AC1}' . +'\x{7AC4}\x{7AC5}\x{7AC7}\x{7AC8}\x{7AC9}\x{7ACA}\x{7ACB}\x{7ACC}\x{7ACD}' . +'\x{7ACE}\x{7ACF}\x{7AD0}\x{7AD1}\x{7AD2}\x{7AD3}\x{7AD4}\x{7AD5}\x{7AD6}' . +'\x{7AD8}\x{7AD9}\x{7ADB}\x{7ADC}\x{7ADD}\x{7ADE}\x{7ADF}\x{7AE0}\x{7AE1}' . +'\x{7AE2}\x{7AE3}\x{7AE4}\x{7AE5}\x{7AE6}\x{7AE7}\x{7AE8}\x{7AEA}\x{7AEB}' . +'\x{7AEC}\x{7AED}\x{7AEE}\x{7AEF}\x{7AF0}\x{7AF1}\x{7AF2}\x{7AF3}\x{7AF4}' . +'\x{7AF6}\x{7AF7}\x{7AF8}\x{7AF9}\x{7AFA}\x{7AFB}\x{7AFD}\x{7AFE}\x{7AFF}' . +'\x{7B00}\x{7B01}\x{7B02}\x{7B03}\x{7B04}\x{7B05}\x{7B06}\x{7B08}\x{7B09}' . +'\x{7B0A}\x{7B0B}\x{7B0C}\x{7B0D}\x{7B0E}\x{7B0F}\x{7B10}\x{7B11}\x{7B12}' . +'\x{7B13}\x{7B14}\x{7B15}\x{7B16}\x{7B17}\x{7B18}\x{7B19}\x{7B1A}\x{7B1B}' . +'\x{7B1C}\x{7B1D}\x{7B1E}\x{7B20}\x{7B21}\x{7B22}\x{7B23}\x{7B24}\x{7B25}' . +'\x{7B26}\x{7B28}\x{7B2A}\x{7B2B}\x{7B2C}\x{7B2D}\x{7B2E}\x{7B2F}\x{7B30}' . +'\x{7B31}\x{7B32}\x{7B33}\x{7B34}\x{7B35}\x{7B36}\x{7B37}\x{7B38}\x{7B39}' . +'\x{7B3A}\x{7B3B}\x{7B3C}\x{7B3D}\x{7B3E}\x{7B3F}\x{7B40}\x{7B41}\x{7B43}' . +'\x{7B44}\x{7B45}\x{7B46}\x{7B47}\x{7B48}\x{7B49}\x{7B4A}\x{7B4B}\x{7B4C}' . +'\x{7B4D}\x{7B4E}\x{7B4F}\x{7B50}\x{7B51}\x{7B52}\x{7B54}\x{7B55}\x{7B56}' . +'\x{7B57}\x{7B58}\x{7B59}\x{7B5A}\x{7B5B}\x{7B5C}\x{7B5D}\x{7B5E}\x{7B5F}' . +'\x{7B60}\x{7B61}\x{7B62}\x{7B63}\x{7B64}\x{7B65}\x{7B66}\x{7B67}\x{7B68}' . +'\x{7B69}\x{7B6A}\x{7B6B}\x{7B6C}\x{7B6D}\x{7B6E}\x{7B70}\x{7B71}\x{7B72}' . +'\x{7B73}\x{7B74}\x{7B75}\x{7B76}\x{7B77}\x{7B78}\x{7B79}\x{7B7B}\x{7B7C}' . +'\x{7B7D}\x{7B7E}\x{7B7F}\x{7B80}\x{7B81}\x{7B82}\x{7B83}\x{7B84}\x{7B85}' . +'\x{7B87}\x{7B88}\x{7B89}\x{7B8A}\x{7B8B}\x{7B8C}\x{7B8D}\x{7B8E}\x{7B8F}' . +'\x{7B90}\x{7B91}\x{7B93}\x{7B94}\x{7B95}\x{7B96}\x{7B97}\x{7B98}\x{7B99}' . +'\x{7B9A}\x{7B9B}\x{7B9C}\x{7B9D}\x{7B9E}\x{7B9F}\x{7BA0}\x{7BA1}\x{7BA2}' . +'\x{7BA4}\x{7BA6}\x{7BA7}\x{7BA8}\x{7BA9}\x{7BAA}\x{7BAB}\x{7BAC}\x{7BAD}' . +'\x{7BAE}\x{7BAF}\x{7BB1}\x{7BB3}\x{7BB4}\x{7BB5}\x{7BB6}\x{7BB7}\x{7BB8}' . +'\x{7BB9}\x{7BBA}\x{7BBB}\x{7BBC}\x{7BBD}\x{7BBE}\x{7BBF}\x{7BC0}\x{7BC1}' . +'\x{7BC2}\x{7BC3}\x{7BC4}\x{7BC5}\x{7BC6}\x{7BC7}\x{7BC8}\x{7BC9}\x{7BCA}' . +'\x{7BCB}\x{7BCC}\x{7BCD}\x{7BCE}\x{7BD0}\x{7BD1}\x{7BD2}\x{7BD3}\x{7BD4}' . +'\x{7BD5}\x{7BD6}\x{7BD7}\x{7BD8}\x{7BD9}\x{7BDA}\x{7BDB}\x{7BDC}\x{7BDD}' . +'\x{7BDE}\x{7BDF}\x{7BE0}\x{7BE1}\x{7BE2}\x{7BE3}\x{7BE4}\x{7BE5}\x{7BE6}' . +'\x{7BE7}\x{7BE8}\x{7BE9}\x{7BEA}\x{7BEB}\x{7BEC}\x{7BED}\x{7BEE}\x{7BEF}' . +'\x{7BF0}\x{7BF1}\x{7BF2}\x{7BF3}\x{7BF4}\x{7BF5}\x{7BF6}\x{7BF7}\x{7BF8}' . +'\x{7BF9}\x{7BFB}\x{7BFC}\x{7BFD}\x{7BFE}\x{7BFF}\x{7C00}\x{7C01}\x{7C02}' . +'\x{7C03}\x{7C04}\x{7C05}\x{7C06}\x{7C07}\x{7C08}\x{7C09}\x{7C0A}\x{7C0B}' . +'\x{7C0C}\x{7C0D}\x{7C0E}\x{7C0F}\x{7C10}\x{7C11}\x{7C12}\x{7C13}\x{7C15}' . +'\x{7C16}\x{7C17}\x{7C18}\x{7C19}\x{7C1A}\x{7C1C}\x{7C1D}\x{7C1E}\x{7C1F}' . +'\x{7C20}\x{7C21}\x{7C22}\x{7C23}\x{7C24}\x{7C25}\x{7C26}\x{7C27}\x{7C28}' . +'\x{7C29}\x{7C2A}\x{7C2B}\x{7C2C}\x{7C2D}\x{7C30}\x{7C31}\x{7C32}\x{7C33}' . +'\x{7C34}\x{7C35}\x{7C36}\x{7C37}\x{7C38}\x{7C39}\x{7C3A}\x{7C3B}\x{7C3C}' . +'\x{7C3D}\x{7C3E}\x{7C3F}\x{7C40}\x{7C41}\x{7C42}\x{7C43}\x{7C44}\x{7C45}' . +'\x{7C46}\x{7C47}\x{7C48}\x{7C49}\x{7C4A}\x{7C4B}\x{7C4C}\x{7C4D}\x{7C4E}' . +'\x{7C50}\x{7C51}\x{7C53}\x{7C54}\x{7C56}\x{7C57}\x{7C58}\x{7C59}\x{7C5A}' . +'\x{7C5B}\x{7C5C}\x{7C5E}\x{7C5F}\x{7C60}\x{7C61}\x{7C62}\x{7C63}\x{7C64}' . +'\x{7C65}\x{7C66}\x{7C67}\x{7C68}\x{7C69}\x{7C6A}\x{7C6B}\x{7C6C}\x{7C6D}' . +'\x{7C6E}\x{7C6F}\x{7C70}\x{7C71}\x{7C72}\x{7C73}\x{7C74}\x{7C75}\x{7C77}' . +'\x{7C78}\x{7C79}\x{7C7A}\x{7C7B}\x{7C7C}\x{7C7D}\x{7C7E}\x{7C7F}\x{7C80}' . +'\x{7C81}\x{7C82}\x{7C84}\x{7C85}\x{7C86}\x{7C88}\x{7C89}\x{7C8A}\x{7C8B}' . +'\x{7C8C}\x{7C8D}\x{7C8E}\x{7C8F}\x{7C90}\x{7C91}\x{7C92}\x{7C94}\x{7C95}' . +'\x{7C96}\x{7C97}\x{7C98}\x{7C99}\x{7C9B}\x{7C9C}\x{7C9D}\x{7C9E}\x{7C9F}' . +'\x{7CA0}\x{7CA1}\x{7CA2}\x{7CA3}\x{7CA4}\x{7CA5}\x{7CA6}\x{7CA7}\x{7CA8}' . +'\x{7CA9}\x{7CAA}\x{7CAD}\x{7CAE}\x{7CAF}\x{7CB0}\x{7CB1}\x{7CB2}\x{7CB3}' . +'\x{7CB4}\x{7CB5}\x{7CB6}\x{7CB7}\x{7CB8}\x{7CB9}\x{7CBA}\x{7CBB}\x{7CBC}' . +'\x{7CBD}\x{7CBE}\x{7CBF}\x{7CC0}\x{7CC1}\x{7CC2}\x{7CC3}\x{7CC4}\x{7CC5}' . +'\x{7CC6}\x{7CC7}\x{7CC8}\x{7CC9}\x{7CCA}\x{7CCB}\x{7CCC}\x{7CCD}\x{7CCE}' . +'\x{7CCF}\x{7CD0}\x{7CD1}\x{7CD2}\x{7CD4}\x{7CD5}\x{7CD6}\x{7CD7}\x{7CD8}' . +'\x{7CD9}\x{7CDC}\x{7CDD}\x{7CDE}\x{7CDF}\x{7CE0}\x{7CE2}\x{7CE4}\x{7CE7}' . +'\x{7CE8}\x{7CE9}\x{7CEA}\x{7CEB}\x{7CEC}\x{7CED}\x{7CEE}\x{7CEF}\x{7CF0}' . +'\x{7CF1}\x{7CF2}\x{7CF3}\x{7CF4}\x{7CF5}\x{7CF6}\x{7CF7}\x{7CF8}\x{7CF9}' . +'\x{7CFA}\x{7CFB}\x{7CFD}\x{7CFE}\x{7D00}\x{7D01}\x{7D02}\x{7D03}\x{7D04}' . +'\x{7D05}\x{7D06}\x{7D07}\x{7D08}\x{7D09}\x{7D0A}\x{7D0B}\x{7D0C}\x{7D0D}' . +'\x{7D0E}\x{7D0F}\x{7D10}\x{7D11}\x{7D12}\x{7D13}\x{7D14}\x{7D15}\x{7D16}' . +'\x{7D17}\x{7D18}\x{7D19}\x{7D1A}\x{7D1B}\x{7D1C}\x{7D1D}\x{7D1E}\x{7D1F}' . +'\x{7D20}\x{7D21}\x{7D22}\x{7D24}\x{7D25}\x{7D26}\x{7D27}\x{7D28}\x{7D29}' . +'\x{7D2B}\x{7D2C}\x{7D2E}\x{7D2F}\x{7D30}\x{7D31}\x{7D32}\x{7D33}\x{7D34}' . +'\x{7D35}\x{7D36}\x{7D37}\x{7D38}\x{7D39}\x{7D3A}\x{7D3B}\x{7D3C}\x{7D3D}' . +'\x{7D3E}\x{7D3F}\x{7D40}\x{7D41}\x{7D42}\x{7D43}\x{7D44}\x{7D45}\x{7D46}' . +'\x{7D47}\x{7D49}\x{7D4A}\x{7D4B}\x{7D4C}\x{7D4E}\x{7D4F}\x{7D50}\x{7D51}' . +'\x{7D52}\x{7D53}\x{7D54}\x{7D55}\x{7D56}\x{7D57}\x{7D58}\x{7D59}\x{7D5B}' . +'\x{7D5C}\x{7D5D}\x{7D5E}\x{7D5F}\x{7D60}\x{7D61}\x{7D62}\x{7D63}\x{7D65}' . +'\x{7D66}\x{7D67}\x{7D68}\x{7D69}\x{7D6A}\x{7D6B}\x{7D6C}\x{7D6D}\x{7D6E}' . +'\x{7D6F}\x{7D70}\x{7D71}\x{7D72}\x{7D73}\x{7D74}\x{7D75}\x{7D76}\x{7D77}' . +'\x{7D79}\x{7D7A}\x{7D7B}\x{7D7C}\x{7D7D}\x{7D7E}\x{7D7F}\x{7D80}\x{7D81}' . +'\x{7D83}\x{7D84}\x{7D85}\x{7D86}\x{7D87}\x{7D88}\x{7D89}\x{7D8A}\x{7D8B}' . +'\x{7D8C}\x{7D8D}\x{7D8E}\x{7D8F}\x{7D90}\x{7D91}\x{7D92}\x{7D93}\x{7D94}' . +'\x{7D96}\x{7D97}\x{7D99}\x{7D9B}\x{7D9C}\x{7D9D}\x{7D9E}\x{7D9F}\x{7DA0}' . +'\x{7DA1}\x{7DA2}\x{7DA3}\x{7DA5}\x{7DA6}\x{7DA7}\x{7DA9}\x{7DAA}\x{7DAB}' . +'\x{7DAC}\x{7DAD}\x{7DAE}\x{7DAF}\x{7DB0}\x{7DB1}\x{7DB2}\x{7DB3}\x{7DB4}' . +'\x{7DB5}\x{7DB6}\x{7DB7}\x{7DB8}\x{7DB9}\x{7DBA}\x{7DBB}\x{7DBC}\x{7DBD}' . +'\x{7DBE}\x{7DBF}\x{7DC0}\x{7DC1}\x{7DC2}\x{7DC3}\x{7DC4}\x{7DC5}\x{7DC6}' . +'\x{7DC7}\x{7DC8}\x{7DC9}\x{7DCA}\x{7DCB}\x{7DCC}\x{7DCE}\x{7DCF}\x{7DD0}' . +'\x{7DD1}\x{7DD2}\x{7DD4}\x{7DD5}\x{7DD6}\x{7DD7}\x{7DD8}\x{7DD9}\x{7DDA}' . +'\x{7DDB}\x{7DDD}\x{7DDE}\x{7DDF}\x{7DE0}\x{7DE1}\x{7DE2}\x{7DE3}\x{7DE6}' . +'\x{7DE7}\x{7DE8}\x{7DE9}\x{7DEA}\x{7DEC}\x{7DED}\x{7DEE}\x{7DEF}\x{7DF0}' . +'\x{7DF1}\x{7DF2}\x{7DF3}\x{7DF4}\x{7DF5}\x{7DF6}\x{7DF7}\x{7DF8}\x{7DF9}' . +'\x{7DFA}\x{7DFB}\x{7DFC}\x{7E00}\x{7E01}\x{7E02}\x{7E03}\x{7E04}\x{7E05}' . +'\x{7E06}\x{7E07}\x{7E08}\x{7E09}\x{7E0A}\x{7E0B}\x{7E0C}\x{7E0D}\x{7E0E}' . +'\x{7E0F}\x{7E10}\x{7E11}\x{7E12}\x{7E13}\x{7E14}\x{7E15}\x{7E16}\x{7E17}' . +'\x{7E19}\x{7E1A}\x{7E1B}\x{7E1C}\x{7E1D}\x{7E1E}\x{7E1F}\x{7E20}\x{7E21}' . +'\x{7E22}\x{7E23}\x{7E24}\x{7E25}\x{7E26}\x{7E27}\x{7E28}\x{7E29}\x{7E2A}' . +'\x{7E2B}\x{7E2C}\x{7E2D}\x{7E2E}\x{7E2F}\x{7E30}\x{7E31}\x{7E32}\x{7E33}' . +'\x{7E34}\x{7E35}\x{7E36}\x{7E37}\x{7E38}\x{7E39}\x{7E3A}\x{7E3B}\x{7E3C}' . +'\x{7E3D}\x{7E3E}\x{7E3F}\x{7E40}\x{7E41}\x{7E42}\x{7E43}\x{7E44}\x{7E45}' . +'\x{7E46}\x{7E47}\x{7E48}\x{7E49}\x{7E4C}\x{7E4D}\x{7E4E}\x{7E4F}\x{7E50}' . +'\x{7E51}\x{7E52}\x{7E53}\x{7E54}\x{7E55}\x{7E56}\x{7E57}\x{7E58}\x{7E59}' . +'\x{7E5A}\x{7E5C}\x{7E5D}\x{7E5E}\x{7E5F}\x{7E60}\x{7E61}\x{7E62}\x{7E63}' . +'\x{7E65}\x{7E66}\x{7E67}\x{7E68}\x{7E69}\x{7E6A}\x{7E6B}\x{7E6C}\x{7E6D}' . +'\x{7E6E}\x{7E6F}\x{7E70}\x{7E71}\x{7E72}\x{7E73}\x{7E74}\x{7E75}\x{7E76}' . +'\x{7E77}\x{7E78}\x{7E79}\x{7E7A}\x{7E7B}\x{7E7C}\x{7E7D}\x{7E7E}\x{7E7F}' . +'\x{7E80}\x{7E81}\x{7E82}\x{7E83}\x{7E84}\x{7E85}\x{7E86}\x{7E87}\x{7E88}' . +'\x{7E89}\x{7E8A}\x{7E8B}\x{7E8C}\x{7E8D}\x{7E8E}\x{7E8F}\x{7E90}\x{7E91}' . +'\x{7E92}\x{7E93}\x{7E94}\x{7E95}\x{7E96}\x{7E97}\x{7E98}\x{7E99}\x{7E9A}' . +'\x{7E9B}\x{7E9C}\x{7E9E}\x{7E9F}\x{7EA0}\x{7EA1}\x{7EA2}\x{7EA3}\x{7EA4}' . +'\x{7EA5}\x{7EA6}\x{7EA7}\x{7EA8}\x{7EA9}\x{7EAA}\x{7EAB}\x{7EAC}\x{7EAD}' . +'\x{7EAE}\x{7EAF}\x{7EB0}\x{7EB1}\x{7EB2}\x{7EB3}\x{7EB4}\x{7EB5}\x{7EB6}' . +'\x{7EB7}\x{7EB8}\x{7EB9}\x{7EBA}\x{7EBB}\x{7EBC}\x{7EBD}\x{7EBE}\x{7EBF}' . +'\x{7EC0}\x{7EC1}\x{7EC2}\x{7EC3}\x{7EC4}\x{7EC5}\x{7EC6}\x{7EC7}\x{7EC8}' . +'\x{7EC9}\x{7ECA}\x{7ECB}\x{7ECC}\x{7ECD}\x{7ECE}\x{7ECF}\x{7ED0}\x{7ED1}' . +'\x{7ED2}\x{7ED3}\x{7ED4}\x{7ED5}\x{7ED6}\x{7ED7}\x{7ED8}\x{7ED9}\x{7EDA}' . +'\x{7EDB}\x{7EDC}\x{7EDD}\x{7EDE}\x{7EDF}\x{7EE0}\x{7EE1}\x{7EE2}\x{7EE3}' . +'\x{7EE4}\x{7EE5}\x{7EE6}\x{7EE7}\x{7EE8}\x{7EE9}\x{7EEA}\x{7EEB}\x{7EEC}' . +'\x{7EED}\x{7EEE}\x{7EEF}\x{7EF0}\x{7EF1}\x{7EF2}\x{7EF3}\x{7EF4}\x{7EF5}' . +'\x{7EF6}\x{7EF7}\x{7EF8}\x{7EF9}\x{7EFA}\x{7EFB}\x{7EFC}\x{7EFD}\x{7EFE}' . +'\x{7EFF}\x{7F00}\x{7F01}\x{7F02}\x{7F03}\x{7F04}\x{7F05}\x{7F06}\x{7F07}' . +'\x{7F08}\x{7F09}\x{7F0A}\x{7F0B}\x{7F0C}\x{7F0D}\x{7F0E}\x{7F0F}\x{7F10}' . +'\x{7F11}\x{7F12}\x{7F13}\x{7F14}\x{7F15}\x{7F16}\x{7F17}\x{7F18}\x{7F19}' . +'\x{7F1A}\x{7F1B}\x{7F1C}\x{7F1D}\x{7F1E}\x{7F1F}\x{7F20}\x{7F21}\x{7F22}' . +'\x{7F23}\x{7F24}\x{7F25}\x{7F26}\x{7F27}\x{7F28}\x{7F29}\x{7F2A}\x{7F2B}' . +'\x{7F2C}\x{7F2D}\x{7F2E}\x{7F2F}\x{7F30}\x{7F31}\x{7F32}\x{7F33}\x{7F34}' . +'\x{7F35}\x{7F36}\x{7F37}\x{7F38}\x{7F39}\x{7F3A}\x{7F3D}\x{7F3E}\x{7F3F}' . +'\x{7F40}\x{7F42}\x{7F43}\x{7F44}\x{7F45}\x{7F47}\x{7F48}\x{7F49}\x{7F4A}' . +'\x{7F4B}\x{7F4C}\x{7F4D}\x{7F4E}\x{7F4F}\x{7F50}\x{7F51}\x{7F52}\x{7F53}' . +'\x{7F54}\x{7F55}\x{7F56}\x{7F57}\x{7F58}\x{7F5A}\x{7F5B}\x{7F5C}\x{7F5D}' . +'\x{7F5E}\x{7F5F}\x{7F60}\x{7F61}\x{7F62}\x{7F63}\x{7F64}\x{7F65}\x{7F66}' . +'\x{7F67}\x{7F68}\x{7F69}\x{7F6A}\x{7F6B}\x{7F6C}\x{7F6D}\x{7F6E}\x{7F6F}' . +'\x{7F70}\x{7F71}\x{7F72}\x{7F73}\x{7F74}\x{7F75}\x{7F76}\x{7F77}\x{7F78}' . +'\x{7F79}\x{7F7A}\x{7F7B}\x{7F7C}\x{7F7D}\x{7F7E}\x{7F7F}\x{7F80}\x{7F81}' . +'\x{7F82}\x{7F83}\x{7F85}\x{7F86}\x{7F87}\x{7F88}\x{7F89}\x{7F8A}\x{7F8B}' . +'\x{7F8C}\x{7F8D}\x{7F8E}\x{7F8F}\x{7F91}\x{7F92}\x{7F93}\x{7F94}\x{7F95}' . +'\x{7F96}\x{7F98}\x{7F9A}\x{7F9B}\x{7F9C}\x{7F9D}\x{7F9E}\x{7F9F}\x{7FA0}' . +'\x{7FA1}\x{7FA2}\x{7FA3}\x{7FA4}\x{7FA5}\x{7FA6}\x{7FA7}\x{7FA8}\x{7FA9}' . +'\x{7FAA}\x{7FAB}\x{7FAC}\x{7FAD}\x{7FAE}\x{7FAF}\x{7FB0}\x{7FB1}\x{7FB2}' . +'\x{7FB3}\x{7FB5}\x{7FB6}\x{7FB7}\x{7FB8}\x{7FB9}\x{7FBA}\x{7FBB}\x{7FBC}' . +'\x{7FBD}\x{7FBE}\x{7FBF}\x{7FC0}\x{7FC1}\x{7FC2}\x{7FC3}\x{7FC4}\x{7FC5}' . +'\x{7FC6}\x{7FC7}\x{7FC8}\x{7FC9}\x{7FCA}\x{7FCB}\x{7FCC}\x{7FCD}\x{7FCE}' . +'\x{7FCF}\x{7FD0}\x{7FD1}\x{7FD2}\x{7FD3}\x{7FD4}\x{7FD5}\x{7FD7}\x{7FD8}' . +'\x{7FD9}\x{7FDA}\x{7FDB}\x{7FDC}\x{7FDE}\x{7FDF}\x{7FE0}\x{7FE1}\x{7FE2}' . +'\x{7FE3}\x{7FE5}\x{7FE6}\x{7FE7}\x{7FE8}\x{7FE9}\x{7FEA}\x{7FEB}\x{7FEC}' . +'\x{7FED}\x{7FEE}\x{7FEF}\x{7FF0}\x{7FF1}\x{7FF2}\x{7FF3}\x{7FF4}\x{7FF5}' . +'\x{7FF6}\x{7FF7}\x{7FF8}\x{7FF9}\x{7FFA}\x{7FFB}\x{7FFC}\x{7FFD}\x{7FFE}' . +'\x{7FFF}\x{8000}\x{8001}\x{8002}\x{8003}\x{8004}\x{8005}\x{8006}\x{8007}' . +'\x{8008}\x{8009}\x{800B}\x{800C}\x{800D}\x{800E}\x{800F}\x{8010}\x{8011}' . +'\x{8012}\x{8013}\x{8014}\x{8015}\x{8016}\x{8017}\x{8018}\x{8019}\x{801A}' . +'\x{801B}\x{801C}\x{801D}\x{801E}\x{801F}\x{8020}\x{8021}\x{8022}\x{8023}' . +'\x{8024}\x{8025}\x{8026}\x{8027}\x{8028}\x{8029}\x{802A}\x{802B}\x{802C}' . +'\x{802D}\x{802E}\x{8030}\x{8031}\x{8032}\x{8033}\x{8034}\x{8035}\x{8036}' . +'\x{8037}\x{8038}\x{8039}\x{803A}\x{803B}\x{803D}\x{803E}\x{803F}\x{8041}' . +'\x{8042}\x{8043}\x{8044}\x{8045}\x{8046}\x{8047}\x{8048}\x{8049}\x{804A}' . +'\x{804B}\x{804C}\x{804D}\x{804E}\x{804F}\x{8050}\x{8051}\x{8052}\x{8053}' . +'\x{8054}\x{8055}\x{8056}\x{8057}\x{8058}\x{8059}\x{805A}\x{805B}\x{805C}' . +'\x{805D}\x{805E}\x{805F}\x{8060}\x{8061}\x{8062}\x{8063}\x{8064}\x{8065}' . +'\x{8067}\x{8068}\x{8069}\x{806A}\x{806B}\x{806C}\x{806D}\x{806E}\x{806F}' . +'\x{8070}\x{8071}\x{8072}\x{8073}\x{8074}\x{8075}\x{8076}\x{8077}\x{8078}' . +'\x{8079}\x{807A}\x{807B}\x{807C}\x{807D}\x{807E}\x{807F}\x{8080}\x{8081}' . +'\x{8082}\x{8083}\x{8084}\x{8085}\x{8086}\x{8087}\x{8089}\x{808A}\x{808B}' . +'\x{808C}\x{808D}\x{808F}\x{8090}\x{8091}\x{8092}\x{8093}\x{8095}\x{8096}' . +'\x{8097}\x{8098}\x{8099}\x{809A}\x{809B}\x{809C}\x{809D}\x{809E}\x{809F}' . +'\x{80A0}\x{80A1}\x{80A2}\x{80A3}\x{80A4}\x{80A5}\x{80A9}\x{80AA}\x{80AB}' . +'\x{80AD}\x{80AE}\x{80AF}\x{80B0}\x{80B1}\x{80B2}\x{80B4}\x{80B5}\x{80B6}' . +'\x{80B7}\x{80B8}\x{80BA}\x{80BB}\x{80BC}\x{80BD}\x{80BE}\x{80BF}\x{80C0}' . +'\x{80C1}\x{80C2}\x{80C3}\x{80C4}\x{80C5}\x{80C6}\x{80C7}\x{80C8}\x{80C9}' . +'\x{80CA}\x{80CB}\x{80CC}\x{80CD}\x{80CE}\x{80CF}\x{80D0}\x{80D1}\x{80D2}' . +'\x{80D3}\x{80D4}\x{80D5}\x{80D6}\x{80D7}\x{80D8}\x{80D9}\x{80DA}\x{80DB}' . +'\x{80DC}\x{80DD}\x{80DE}\x{80E0}\x{80E1}\x{80E2}\x{80E3}\x{80E4}\x{80E5}' . +'\x{80E6}\x{80E7}\x{80E8}\x{80E9}\x{80EA}\x{80EB}\x{80EC}\x{80ED}\x{80EE}' . +'\x{80EF}\x{80F0}\x{80F1}\x{80F2}\x{80F3}\x{80F4}\x{80F5}\x{80F6}\x{80F7}' . +'\x{80F8}\x{80F9}\x{80FA}\x{80FB}\x{80FC}\x{80FD}\x{80FE}\x{80FF}\x{8100}' . +'\x{8101}\x{8102}\x{8105}\x{8106}\x{8107}\x{8108}\x{8109}\x{810A}\x{810B}' . +'\x{810C}\x{810D}\x{810E}\x{810F}\x{8110}\x{8111}\x{8112}\x{8113}\x{8114}' . +'\x{8115}\x{8116}\x{8118}\x{8119}\x{811A}\x{811B}\x{811C}\x{811D}\x{811E}' . +'\x{811F}\x{8120}\x{8121}\x{8122}\x{8123}\x{8124}\x{8125}\x{8126}\x{8127}' . +'\x{8128}\x{8129}\x{812A}\x{812B}\x{812C}\x{812D}\x{812E}\x{812F}\x{8130}' . +'\x{8131}\x{8132}\x{8136}\x{8137}\x{8138}\x{8139}\x{813A}\x{813B}\x{813C}' . +'\x{813D}\x{813E}\x{813F}\x{8140}\x{8141}\x{8142}\x{8143}\x{8144}\x{8145}' . +'\x{8146}\x{8147}\x{8148}\x{8149}\x{814A}\x{814B}\x{814C}\x{814D}\x{814E}' . +'\x{814F}\x{8150}\x{8151}\x{8152}\x{8153}\x{8154}\x{8155}\x{8156}\x{8157}' . +'\x{8158}\x{8159}\x{815A}\x{815B}\x{815C}\x{815D}\x{815E}\x{8160}\x{8161}' . +'\x{8162}\x{8163}\x{8164}\x{8165}\x{8166}\x{8167}\x{8168}\x{8169}\x{816A}' . +'\x{816B}\x{816C}\x{816D}\x{816E}\x{816F}\x{8170}\x{8171}\x{8172}\x{8173}' . +'\x{8174}\x{8175}\x{8176}\x{8177}\x{8178}\x{8179}\x{817A}\x{817B}\x{817C}' . +'\x{817D}\x{817E}\x{817F}\x{8180}\x{8181}\x{8182}\x{8183}\x{8185}\x{8186}' . +'\x{8187}\x{8188}\x{8189}\x{818A}\x{818B}\x{818C}\x{818D}\x{818E}\x{818F}' . +'\x{8191}\x{8192}\x{8193}\x{8194}\x{8195}\x{8197}\x{8198}\x{8199}\x{819A}' . +'\x{819B}\x{819C}\x{819D}\x{819E}\x{819F}\x{81A0}\x{81A1}\x{81A2}\x{81A3}' . +'\x{81A4}\x{81A5}\x{81A6}\x{81A7}\x{81A8}\x{81A9}\x{81AA}\x{81AB}\x{81AC}' . +'\x{81AD}\x{81AE}\x{81AF}\x{81B0}\x{81B1}\x{81B2}\x{81B3}\x{81B4}\x{81B5}' . +'\x{81B6}\x{81B7}\x{81B8}\x{81B9}\x{81BA}\x{81BB}\x{81BC}\x{81BD}\x{81BE}' . +'\x{81BF}\x{81C0}\x{81C1}\x{81C2}\x{81C3}\x{81C4}\x{81C5}\x{81C6}\x{81C7}' . +'\x{81C8}\x{81C9}\x{81CA}\x{81CC}\x{81CD}\x{81CE}\x{81CF}\x{81D0}\x{81D1}' . +'\x{81D2}\x{81D4}\x{81D5}\x{81D6}\x{81D7}\x{81D8}\x{81D9}\x{81DA}\x{81DB}' . +'\x{81DC}\x{81DD}\x{81DE}\x{81DF}\x{81E0}\x{81E1}\x{81E2}\x{81E3}\x{81E5}' . +'\x{81E6}\x{81E7}\x{81E8}\x{81E9}\x{81EA}\x{81EB}\x{81EC}\x{81ED}\x{81EE}' . +'\x{81F1}\x{81F2}\x{81F3}\x{81F4}\x{81F5}\x{81F6}\x{81F7}\x{81F8}\x{81F9}' . +'\x{81FA}\x{81FB}\x{81FC}\x{81FD}\x{81FE}\x{81FF}\x{8200}\x{8201}\x{8202}' . +'\x{8203}\x{8204}\x{8205}\x{8206}\x{8207}\x{8208}\x{8209}\x{820A}\x{820B}' . +'\x{820C}\x{820D}\x{820E}\x{820F}\x{8210}\x{8211}\x{8212}\x{8214}\x{8215}' . +'\x{8216}\x{8218}\x{8219}\x{821A}\x{821B}\x{821C}\x{821D}\x{821E}\x{821F}' . +'\x{8220}\x{8221}\x{8222}\x{8223}\x{8225}\x{8226}\x{8227}\x{8228}\x{8229}' . +'\x{822A}\x{822B}\x{822C}\x{822D}\x{822F}\x{8230}\x{8231}\x{8232}\x{8233}' . +'\x{8234}\x{8235}\x{8236}\x{8237}\x{8238}\x{8239}\x{823A}\x{823B}\x{823C}' . +'\x{823D}\x{823E}\x{823F}\x{8240}\x{8242}\x{8243}\x{8244}\x{8245}\x{8246}' . +'\x{8247}\x{8248}\x{8249}\x{824A}\x{824B}\x{824C}\x{824D}\x{824E}\x{824F}' . +'\x{8250}\x{8251}\x{8252}\x{8253}\x{8254}\x{8255}\x{8256}\x{8257}\x{8258}' . +'\x{8259}\x{825A}\x{825B}\x{825C}\x{825D}\x{825E}\x{825F}\x{8260}\x{8261}' . +'\x{8263}\x{8264}\x{8266}\x{8267}\x{8268}\x{8269}\x{826A}\x{826B}\x{826C}' . +'\x{826D}\x{826E}\x{826F}\x{8270}\x{8271}\x{8272}\x{8273}\x{8274}\x{8275}' . +'\x{8276}\x{8277}\x{8278}\x{8279}\x{827A}\x{827B}\x{827C}\x{827D}\x{827E}' . +'\x{827F}\x{8280}\x{8281}\x{8282}\x{8283}\x{8284}\x{8285}\x{8286}\x{8287}' . +'\x{8288}\x{8289}\x{828A}\x{828B}\x{828D}\x{828E}\x{828F}\x{8290}\x{8291}' . +'\x{8292}\x{8293}\x{8294}\x{8295}\x{8296}\x{8297}\x{8298}\x{8299}\x{829A}' . +'\x{829B}\x{829C}\x{829D}\x{829E}\x{829F}\x{82A0}\x{82A1}\x{82A2}\x{82A3}' . +'\x{82A4}\x{82A5}\x{82A6}\x{82A7}\x{82A8}\x{82A9}\x{82AA}\x{82AB}\x{82AC}' . +'\x{82AD}\x{82AE}\x{82AF}\x{82B0}\x{82B1}\x{82B3}\x{82B4}\x{82B5}\x{82B6}' . +'\x{82B7}\x{82B8}\x{82B9}\x{82BA}\x{82BB}\x{82BC}\x{82BD}\x{82BE}\x{82BF}' . +'\x{82C0}\x{82C1}\x{82C2}\x{82C3}\x{82C4}\x{82C5}\x{82C6}\x{82C7}\x{82C8}' . +'\x{82C9}\x{82CA}\x{82CB}\x{82CC}\x{82CD}\x{82CE}\x{82CF}\x{82D0}\x{82D1}' . +'\x{82D2}\x{82D3}\x{82D4}\x{82D5}\x{82D6}\x{82D7}\x{82D8}\x{82D9}\x{82DA}' . +'\x{82DB}\x{82DC}\x{82DD}\x{82DE}\x{82DF}\x{82E0}\x{82E1}\x{82E3}\x{82E4}' . +'\x{82E5}\x{82E6}\x{82E7}\x{82E8}\x{82E9}\x{82EA}\x{82EB}\x{82EC}\x{82ED}' . +'\x{82EE}\x{82EF}\x{82F0}\x{82F1}\x{82F2}\x{82F3}\x{82F4}\x{82F5}\x{82F6}' . +'\x{82F7}\x{82F8}\x{82F9}\x{82FA}\x{82FB}\x{82FD}\x{82FE}\x{82FF}\x{8300}' . +'\x{8301}\x{8302}\x{8303}\x{8304}\x{8305}\x{8306}\x{8307}\x{8308}\x{8309}' . +'\x{830B}\x{830C}\x{830D}\x{830E}\x{830F}\x{8311}\x{8312}\x{8313}\x{8314}' . +'\x{8315}\x{8316}\x{8317}\x{8318}\x{8319}\x{831A}\x{831B}\x{831C}\x{831D}' . +'\x{831E}\x{831F}\x{8320}\x{8321}\x{8322}\x{8323}\x{8324}\x{8325}\x{8326}' . +'\x{8327}\x{8328}\x{8329}\x{832A}\x{832B}\x{832C}\x{832D}\x{832E}\x{832F}' . +'\x{8331}\x{8332}\x{8333}\x{8334}\x{8335}\x{8336}\x{8337}\x{8338}\x{8339}' . +'\x{833A}\x{833B}\x{833C}\x{833D}\x{833E}\x{833F}\x{8340}\x{8341}\x{8342}' . +'\x{8343}\x{8344}\x{8345}\x{8346}\x{8347}\x{8348}\x{8349}\x{834A}\x{834B}' . +'\x{834C}\x{834D}\x{834E}\x{834F}\x{8350}\x{8351}\x{8352}\x{8353}\x{8354}' . +'\x{8356}\x{8357}\x{8358}\x{8359}\x{835A}\x{835B}\x{835C}\x{835D}\x{835E}' . +'\x{835F}\x{8360}\x{8361}\x{8362}\x{8363}\x{8364}\x{8365}\x{8366}\x{8367}' . +'\x{8368}\x{8369}\x{836A}\x{836B}\x{836C}\x{836D}\x{836E}\x{836F}\x{8370}' . +'\x{8371}\x{8372}\x{8373}\x{8374}\x{8375}\x{8376}\x{8377}\x{8378}\x{8379}' . +'\x{837A}\x{837B}\x{837C}\x{837D}\x{837E}\x{837F}\x{8380}\x{8381}\x{8382}' . +'\x{8383}\x{8384}\x{8385}\x{8386}\x{8387}\x{8388}\x{8389}\x{838A}\x{838B}' . +'\x{838C}\x{838D}\x{838E}\x{838F}\x{8390}\x{8391}\x{8392}\x{8393}\x{8394}' . +'\x{8395}\x{8396}\x{8397}\x{8398}\x{8399}\x{839A}\x{839B}\x{839C}\x{839D}' . +'\x{839E}\x{83A0}\x{83A1}\x{83A2}\x{83A3}\x{83A4}\x{83A5}\x{83A6}\x{83A7}' . +'\x{83A8}\x{83A9}\x{83AA}\x{83AB}\x{83AC}\x{83AD}\x{83AE}\x{83AF}\x{83B0}' . +'\x{83B1}\x{83B2}\x{83B3}\x{83B4}\x{83B6}\x{83B7}\x{83B8}\x{83B9}\x{83BA}' . +'\x{83BB}\x{83BC}\x{83BD}\x{83BF}\x{83C0}\x{83C1}\x{83C2}\x{83C3}\x{83C4}' . +'\x{83C5}\x{83C6}\x{83C7}\x{83C8}\x{83C9}\x{83CA}\x{83CB}\x{83CC}\x{83CD}' . +'\x{83CE}\x{83CF}\x{83D0}\x{83D1}\x{83D2}\x{83D3}\x{83D4}\x{83D5}\x{83D6}' . +'\x{83D7}\x{83D8}\x{83D9}\x{83DA}\x{83DB}\x{83DC}\x{83DD}\x{83DE}\x{83DF}' . +'\x{83E0}\x{83E1}\x{83E2}\x{83E3}\x{83E4}\x{83E5}\x{83E7}\x{83E8}\x{83E9}' . +'\x{83EA}\x{83EB}\x{83EC}\x{83EE}\x{83EF}\x{83F0}\x{83F1}\x{83F2}\x{83F3}' . +'\x{83F4}\x{83F5}\x{83F6}\x{83F7}\x{83F8}\x{83F9}\x{83FA}\x{83FB}\x{83FC}' . +'\x{83FD}\x{83FE}\x{83FF}\x{8400}\x{8401}\x{8402}\x{8403}\x{8404}\x{8405}' . +'\x{8406}\x{8407}\x{8408}\x{8409}\x{840A}\x{840B}\x{840C}\x{840D}\x{840E}' . +'\x{840F}\x{8410}\x{8411}\x{8412}\x{8413}\x{8415}\x{8418}\x{8419}\x{841A}' . +'\x{841B}\x{841C}\x{841D}\x{841E}\x{8421}\x{8422}\x{8423}\x{8424}\x{8425}' . +'\x{8426}\x{8427}\x{8428}\x{8429}\x{842A}\x{842B}\x{842C}\x{842D}\x{842E}' . +'\x{842F}\x{8430}\x{8431}\x{8432}\x{8433}\x{8434}\x{8435}\x{8436}\x{8437}' . +'\x{8438}\x{8439}\x{843A}\x{843B}\x{843C}\x{843D}\x{843E}\x{843F}\x{8440}' . +'\x{8441}\x{8442}\x{8443}\x{8444}\x{8445}\x{8446}\x{8447}\x{8448}\x{8449}' . +'\x{844A}\x{844B}\x{844C}\x{844D}\x{844E}\x{844F}\x{8450}\x{8451}\x{8452}' . +'\x{8453}\x{8454}\x{8455}\x{8456}\x{8457}\x{8459}\x{845A}\x{845B}\x{845C}' . +'\x{845D}\x{845E}\x{845F}\x{8460}\x{8461}\x{8462}\x{8463}\x{8464}\x{8465}' . +'\x{8466}\x{8467}\x{8468}\x{8469}\x{846A}\x{846B}\x{846C}\x{846D}\x{846E}' . +'\x{846F}\x{8470}\x{8471}\x{8472}\x{8473}\x{8474}\x{8475}\x{8476}\x{8477}' . +'\x{8478}\x{8479}\x{847A}\x{847B}\x{847C}\x{847D}\x{847E}\x{847F}\x{8480}' . +'\x{8481}\x{8482}\x{8484}\x{8485}\x{8486}\x{8487}\x{8488}\x{8489}\x{848A}' . +'\x{848B}\x{848C}\x{848D}\x{848E}\x{848F}\x{8490}\x{8491}\x{8492}\x{8493}' . +'\x{8494}\x{8496}\x{8497}\x{8498}\x{8499}\x{849A}\x{849B}\x{849C}\x{849D}' . +'\x{849E}\x{849F}\x{84A0}\x{84A1}\x{84A2}\x{84A3}\x{84A4}\x{84A5}\x{84A6}' . +'\x{84A7}\x{84A8}\x{84A9}\x{84AA}\x{84AB}\x{84AC}\x{84AE}\x{84AF}\x{84B0}' . +'\x{84B1}\x{84B2}\x{84B3}\x{84B4}\x{84B5}\x{84B6}\x{84B8}\x{84B9}\x{84BA}' . +'\x{84BB}\x{84BC}\x{84BD}\x{84BE}\x{84BF}\x{84C0}\x{84C1}\x{84C2}\x{84C4}' . +'\x{84C5}\x{84C6}\x{84C7}\x{84C8}\x{84C9}\x{84CA}\x{84CB}\x{84CC}\x{84CD}' . +'\x{84CE}\x{84CF}\x{84D0}\x{84D1}\x{84D2}\x{84D3}\x{84D4}\x{84D5}\x{84D6}' . +'\x{84D7}\x{84D8}\x{84D9}\x{84DB}\x{84DC}\x{84DD}\x{84DE}\x{84DF}\x{84E0}' . +'\x{84E1}\x{84E2}\x{84E3}\x{84E4}\x{84E5}\x{84E6}\x{84E7}\x{84E8}\x{84E9}' . +'\x{84EA}\x{84EB}\x{84EC}\x{84EE}\x{84EF}\x{84F0}\x{84F1}\x{84F2}\x{84F3}' . +'\x{84F4}\x{84F5}\x{84F6}\x{84F7}\x{84F8}\x{84F9}\x{84FA}\x{84FB}\x{84FC}' . +'\x{84FD}\x{84FE}\x{84FF}\x{8500}\x{8501}\x{8502}\x{8503}\x{8504}\x{8506}' . +'\x{8507}\x{8508}\x{8509}\x{850A}\x{850B}\x{850C}\x{850D}\x{850E}\x{850F}' . +'\x{8511}\x{8512}\x{8513}\x{8514}\x{8515}\x{8516}\x{8517}\x{8518}\x{8519}' . +'\x{851A}\x{851B}\x{851C}\x{851D}\x{851E}\x{851F}\x{8520}\x{8521}\x{8522}' . +'\x{8523}\x{8524}\x{8525}\x{8526}\x{8527}\x{8528}\x{8529}\x{852A}\x{852B}' . +'\x{852C}\x{852D}\x{852E}\x{852F}\x{8530}\x{8531}\x{8534}\x{8535}\x{8536}' . +'\x{8537}\x{8538}\x{8539}\x{853A}\x{853B}\x{853C}\x{853D}\x{853E}\x{853F}' . +'\x{8540}\x{8541}\x{8542}\x{8543}\x{8544}\x{8545}\x{8546}\x{8547}\x{8548}' . +'\x{8549}\x{854A}\x{854B}\x{854D}\x{854E}\x{854F}\x{8551}\x{8552}\x{8553}' . +'\x{8554}\x{8555}\x{8556}\x{8557}\x{8558}\x{8559}\x{855A}\x{855B}\x{855C}' . +'\x{855D}\x{855E}\x{855F}\x{8560}\x{8561}\x{8562}\x{8563}\x{8564}\x{8565}' . +'\x{8566}\x{8567}\x{8568}\x{8569}\x{856A}\x{856B}\x{856C}\x{856D}\x{856E}' . +'\x{856F}\x{8570}\x{8571}\x{8572}\x{8573}\x{8574}\x{8575}\x{8576}\x{8577}' . +'\x{8578}\x{8579}\x{857A}\x{857B}\x{857C}\x{857D}\x{857E}\x{8580}\x{8581}' . +'\x{8582}\x{8583}\x{8584}\x{8585}\x{8586}\x{8587}\x{8588}\x{8589}\x{858A}' . +'\x{858B}\x{858C}\x{858D}\x{858E}\x{858F}\x{8590}\x{8591}\x{8592}\x{8594}' . +'\x{8595}\x{8596}\x{8598}\x{8599}\x{859A}\x{859B}\x{859C}\x{859D}\x{859E}' . +'\x{859F}\x{85A0}\x{85A1}\x{85A2}\x{85A3}\x{85A4}\x{85A5}\x{85A6}\x{85A7}' . +'\x{85A8}\x{85A9}\x{85AA}\x{85AB}\x{85AC}\x{85AD}\x{85AE}\x{85AF}\x{85B0}' . +'\x{85B1}\x{85B3}\x{85B4}\x{85B5}\x{85B6}\x{85B7}\x{85B8}\x{85B9}\x{85BA}' . +'\x{85BC}\x{85BD}\x{85BE}\x{85BF}\x{85C0}\x{85C1}\x{85C2}\x{85C3}\x{85C4}' . +'\x{85C5}\x{85C6}\x{85C7}\x{85C8}\x{85C9}\x{85CA}\x{85CB}\x{85CD}\x{85CE}' . +'\x{85CF}\x{85D0}\x{85D1}\x{85D2}\x{85D3}\x{85D4}\x{85D5}\x{85D6}\x{85D7}' . +'\x{85D8}\x{85D9}\x{85DA}\x{85DB}\x{85DC}\x{85DD}\x{85DE}\x{85DF}\x{85E0}' . +'\x{85E1}\x{85E2}\x{85E3}\x{85E4}\x{85E5}\x{85E6}\x{85E7}\x{85E8}\x{85E9}' . +'\x{85EA}\x{85EB}\x{85EC}\x{85ED}\x{85EF}\x{85F0}\x{85F1}\x{85F2}\x{85F4}' . +'\x{85F5}\x{85F6}\x{85F7}\x{85F8}\x{85F9}\x{85FA}\x{85FB}\x{85FD}\x{85FE}' . +'\x{85FF}\x{8600}\x{8601}\x{8602}\x{8604}\x{8605}\x{8606}\x{8607}\x{8608}' . +'\x{8609}\x{860A}\x{860B}\x{860C}\x{860F}\x{8611}\x{8612}\x{8613}\x{8614}' . +'\x{8616}\x{8617}\x{8618}\x{8619}\x{861A}\x{861B}\x{861C}\x{861E}\x{861F}' . +'\x{8620}\x{8621}\x{8622}\x{8623}\x{8624}\x{8625}\x{8626}\x{8627}\x{8628}' . +'\x{8629}\x{862A}\x{862B}\x{862C}\x{862D}\x{862E}\x{862F}\x{8630}\x{8631}' . +'\x{8632}\x{8633}\x{8634}\x{8635}\x{8636}\x{8638}\x{8639}\x{863A}\x{863B}' . +'\x{863C}\x{863D}\x{863E}\x{863F}\x{8640}\x{8641}\x{8642}\x{8643}\x{8644}' . +'\x{8645}\x{8646}\x{8647}\x{8648}\x{8649}\x{864A}\x{864B}\x{864C}\x{864D}' . +'\x{864E}\x{864F}\x{8650}\x{8651}\x{8652}\x{8653}\x{8654}\x{8655}\x{8656}' . +'\x{8658}\x{8659}\x{865A}\x{865B}\x{865C}\x{865D}\x{865E}\x{865F}\x{8660}' . +'\x{8661}\x{8662}\x{8663}\x{8664}\x{8665}\x{8666}\x{8667}\x{8668}\x{8669}' . +'\x{866A}\x{866B}\x{866C}\x{866D}\x{866E}\x{866F}\x{8670}\x{8671}\x{8672}' . +'\x{8673}\x{8674}\x{8676}\x{8677}\x{8678}\x{8679}\x{867A}\x{867B}\x{867C}' . +'\x{867D}\x{867E}\x{867F}\x{8680}\x{8681}\x{8682}\x{8683}\x{8684}\x{8685}' . +'\x{8686}\x{8687}\x{8688}\x{868A}\x{868B}\x{868C}\x{868D}\x{868E}\x{868F}' . +'\x{8690}\x{8691}\x{8693}\x{8694}\x{8695}\x{8696}\x{8697}\x{8698}\x{8699}' . +'\x{869A}\x{869B}\x{869C}\x{869D}\x{869E}\x{869F}\x{86A1}\x{86A2}\x{86A3}' . +'\x{86A4}\x{86A5}\x{86A7}\x{86A8}\x{86A9}\x{86AA}\x{86AB}\x{86AC}\x{86AD}' . +'\x{86AE}\x{86AF}\x{86B0}\x{86B1}\x{86B2}\x{86B3}\x{86B4}\x{86B5}\x{86B6}' . +'\x{86B7}\x{86B8}\x{86B9}\x{86BA}\x{86BB}\x{86BC}\x{86BD}\x{86BE}\x{86BF}' . +'\x{86C0}\x{86C1}\x{86C2}\x{86C3}\x{86C4}\x{86C5}\x{86C6}\x{86C7}\x{86C8}' . +'\x{86C9}\x{86CA}\x{86CB}\x{86CC}\x{86CE}\x{86CF}\x{86D0}\x{86D1}\x{86D2}' . +'\x{86D3}\x{86D4}\x{86D6}\x{86D7}\x{86D8}\x{86D9}\x{86DA}\x{86DB}\x{86DC}' . +'\x{86DD}\x{86DE}\x{86DF}\x{86E1}\x{86E2}\x{86E3}\x{86E4}\x{86E5}\x{86E6}' . +'\x{86E8}\x{86E9}\x{86EA}\x{86EB}\x{86EC}\x{86ED}\x{86EE}\x{86EF}\x{86F0}' . +'\x{86F1}\x{86F2}\x{86F3}\x{86F4}\x{86F5}\x{86F6}\x{86F7}\x{86F8}\x{86F9}' . +'\x{86FA}\x{86FB}\x{86FC}\x{86FE}\x{86FF}\x{8700}\x{8701}\x{8702}\x{8703}' . +'\x{8704}\x{8705}\x{8706}\x{8707}\x{8708}\x{8709}\x{870A}\x{870B}\x{870C}' . +'\x{870D}\x{870E}\x{870F}\x{8710}\x{8711}\x{8712}\x{8713}\x{8714}\x{8715}' . +'\x{8716}\x{8717}\x{8718}\x{8719}\x{871A}\x{871B}\x{871C}\x{871E}\x{871F}' . +'\x{8720}\x{8721}\x{8722}\x{8723}\x{8724}\x{8725}\x{8726}\x{8727}\x{8728}' . +'\x{8729}\x{872A}\x{872B}\x{872C}\x{872D}\x{872E}\x{8730}\x{8731}\x{8732}' . +'\x{8733}\x{8734}\x{8735}\x{8736}\x{8737}\x{8738}\x{8739}\x{873A}\x{873B}' . +'\x{873C}\x{873E}\x{873F}\x{8740}\x{8741}\x{8742}\x{8743}\x{8744}\x{8746}' . +'\x{8747}\x{8748}\x{8749}\x{874A}\x{874C}\x{874D}\x{874E}\x{874F}\x{8750}' . +'\x{8751}\x{8752}\x{8753}\x{8754}\x{8755}\x{8756}\x{8757}\x{8758}\x{8759}' . +'\x{875A}\x{875B}\x{875C}\x{875D}\x{875E}\x{875F}\x{8760}\x{8761}\x{8762}' . +'\x{8763}\x{8764}\x{8765}\x{8766}\x{8767}\x{8768}\x{8769}\x{876A}\x{876B}' . +'\x{876C}\x{876D}\x{876E}\x{876F}\x{8770}\x{8772}\x{8773}\x{8774}\x{8775}' . +'\x{8776}\x{8777}\x{8778}\x{8779}\x{877A}\x{877B}\x{877C}\x{877D}\x{877E}' . +'\x{8780}\x{8781}\x{8782}\x{8783}\x{8784}\x{8785}\x{8786}\x{8787}\x{8788}' . +'\x{8789}\x{878A}\x{878B}\x{878C}\x{878D}\x{878F}\x{8790}\x{8791}\x{8792}' . +'\x{8793}\x{8794}\x{8795}\x{8796}\x{8797}\x{8798}\x{879A}\x{879B}\x{879C}' . +'\x{879D}\x{879E}\x{879F}\x{87A0}\x{87A1}\x{87A2}\x{87A3}\x{87A4}\x{87A5}' . +'\x{87A6}\x{87A7}\x{87A8}\x{87A9}\x{87AA}\x{87AB}\x{87AC}\x{87AD}\x{87AE}' . +'\x{87AF}\x{87B0}\x{87B1}\x{87B2}\x{87B3}\x{87B4}\x{87B5}\x{87B6}\x{87B7}' . +'\x{87B8}\x{87B9}\x{87BA}\x{87BB}\x{87BC}\x{87BD}\x{87BE}\x{87BF}\x{87C0}' . +'\x{87C1}\x{87C2}\x{87C3}\x{87C4}\x{87C5}\x{87C6}\x{87C7}\x{87C8}\x{87C9}' . +'\x{87CA}\x{87CB}\x{87CC}\x{87CD}\x{87CE}\x{87CF}\x{87D0}\x{87D1}\x{87D2}' . +'\x{87D3}\x{87D4}\x{87D5}\x{87D6}\x{87D7}\x{87D8}\x{87D9}\x{87DB}\x{87DC}' . +'\x{87DD}\x{87DE}\x{87DF}\x{87E0}\x{87E1}\x{87E2}\x{87E3}\x{87E4}\x{87E5}' . +'\x{87E6}\x{87E7}\x{87E8}\x{87E9}\x{87EA}\x{87EB}\x{87EC}\x{87ED}\x{87EE}' . +'\x{87EF}\x{87F1}\x{87F2}\x{87F3}\x{87F4}\x{87F5}\x{87F6}\x{87F7}\x{87F8}' . +'\x{87F9}\x{87FA}\x{87FB}\x{87FC}\x{87FD}\x{87FE}\x{87FF}\x{8800}\x{8801}' . +'\x{8802}\x{8803}\x{8804}\x{8805}\x{8806}\x{8808}\x{8809}\x{880A}\x{880B}' . +'\x{880C}\x{880D}\x{880E}\x{880F}\x{8810}\x{8811}\x{8813}\x{8814}\x{8815}' . +'\x{8816}\x{8817}\x{8818}\x{8819}\x{881A}\x{881B}\x{881C}\x{881D}\x{881E}' . +'\x{881F}\x{8820}\x{8821}\x{8822}\x{8823}\x{8824}\x{8825}\x{8826}\x{8827}' . +'\x{8828}\x{8829}\x{882A}\x{882B}\x{882C}\x{882E}\x{882F}\x{8830}\x{8831}' . +'\x{8832}\x{8833}\x{8834}\x{8835}\x{8836}\x{8837}\x{8838}\x{8839}\x{883B}' . +'\x{883C}\x{883D}\x{883E}\x{883F}\x{8840}\x{8841}\x{8842}\x{8843}\x{8844}' . +'\x{8845}\x{8846}\x{8848}\x{8849}\x{884A}\x{884B}\x{884C}\x{884D}\x{884E}' . +'\x{884F}\x{8850}\x{8851}\x{8852}\x{8853}\x{8854}\x{8855}\x{8856}\x{8857}' . +'\x{8859}\x{885A}\x{885B}\x{885D}\x{885E}\x{8860}\x{8861}\x{8862}\x{8863}' . +'\x{8864}\x{8865}\x{8866}\x{8867}\x{8868}\x{8869}\x{886A}\x{886B}\x{886C}' . +'\x{886D}\x{886E}\x{886F}\x{8870}\x{8871}\x{8872}\x{8873}\x{8874}\x{8875}' . +'\x{8876}\x{8877}\x{8878}\x{8879}\x{887B}\x{887C}\x{887D}\x{887E}\x{887F}' . +'\x{8880}\x{8881}\x{8882}\x{8883}\x{8884}\x{8885}\x{8886}\x{8887}\x{8888}' . +'\x{8889}\x{888A}\x{888B}\x{888C}\x{888D}\x{888E}\x{888F}\x{8890}\x{8891}' . +'\x{8892}\x{8893}\x{8894}\x{8895}\x{8896}\x{8897}\x{8898}\x{8899}\x{889A}' . +'\x{889B}\x{889C}\x{889D}\x{889E}\x{889F}\x{88A0}\x{88A1}\x{88A2}\x{88A3}' . +'\x{88A4}\x{88A5}\x{88A6}\x{88A7}\x{88A8}\x{88A9}\x{88AA}\x{88AB}\x{88AC}' . +'\x{88AD}\x{88AE}\x{88AF}\x{88B0}\x{88B1}\x{88B2}\x{88B3}\x{88B4}\x{88B6}' . +'\x{88B7}\x{88B8}\x{88B9}\x{88BA}\x{88BB}\x{88BC}\x{88BD}\x{88BE}\x{88BF}' . +'\x{88C0}\x{88C1}\x{88C2}\x{88C3}\x{88C4}\x{88C5}\x{88C6}\x{88C7}\x{88C8}' . +'\x{88C9}\x{88CA}\x{88CB}\x{88CC}\x{88CD}\x{88CE}\x{88CF}\x{88D0}\x{88D1}' . +'\x{88D2}\x{88D3}\x{88D4}\x{88D5}\x{88D6}\x{88D7}\x{88D8}\x{88D9}\x{88DA}' . +'\x{88DB}\x{88DC}\x{88DD}\x{88DE}\x{88DF}\x{88E0}\x{88E1}\x{88E2}\x{88E3}' . +'\x{88E4}\x{88E5}\x{88E7}\x{88E8}\x{88EA}\x{88EB}\x{88EC}\x{88EE}\x{88EF}' . +'\x{88F0}\x{88F1}\x{88F2}\x{88F3}\x{88F4}\x{88F5}\x{88F6}\x{88F7}\x{88F8}' . +'\x{88F9}\x{88FA}\x{88FB}\x{88FC}\x{88FD}\x{88FE}\x{88FF}\x{8900}\x{8901}' . +'\x{8902}\x{8904}\x{8905}\x{8906}\x{8907}\x{8908}\x{8909}\x{890A}\x{890B}' . +'\x{890C}\x{890D}\x{890E}\x{8910}\x{8911}\x{8912}\x{8913}\x{8914}\x{8915}' . +'\x{8916}\x{8917}\x{8918}\x{8919}\x{891A}\x{891B}\x{891C}\x{891D}\x{891E}' . +'\x{891F}\x{8920}\x{8921}\x{8922}\x{8923}\x{8925}\x{8926}\x{8927}\x{8928}' . +'\x{8929}\x{892A}\x{892B}\x{892C}\x{892D}\x{892E}\x{892F}\x{8930}\x{8931}' . +'\x{8932}\x{8933}\x{8934}\x{8935}\x{8936}\x{8937}\x{8938}\x{8939}\x{893A}' . +'\x{893B}\x{893C}\x{893D}\x{893E}\x{893F}\x{8940}\x{8941}\x{8942}\x{8943}' . +'\x{8944}\x{8945}\x{8946}\x{8947}\x{8948}\x{8949}\x{894A}\x{894B}\x{894C}' . +'\x{894E}\x{894F}\x{8950}\x{8951}\x{8952}\x{8953}\x{8954}\x{8955}\x{8956}' . +'\x{8957}\x{8958}\x{8959}\x{895A}\x{895B}\x{895C}\x{895D}\x{895E}\x{895F}' . +'\x{8960}\x{8961}\x{8962}\x{8963}\x{8964}\x{8966}\x{8967}\x{8968}\x{8969}' . +'\x{896A}\x{896B}\x{896C}\x{896D}\x{896E}\x{896F}\x{8970}\x{8971}\x{8972}' . +'\x{8973}\x{8974}\x{8976}\x{8977}\x{8978}\x{8979}\x{897A}\x{897B}\x{897C}' . +'\x{897E}\x{897F}\x{8980}\x{8981}\x{8982}\x{8983}\x{8984}\x{8985}\x{8986}' . +'\x{8987}\x{8988}\x{8989}\x{898A}\x{898B}\x{898C}\x{898E}\x{898F}\x{8991}' . +'\x{8992}\x{8993}\x{8995}\x{8996}\x{8997}\x{8998}\x{899A}\x{899B}\x{899C}' . +'\x{899D}\x{899E}\x{899F}\x{89A0}\x{89A1}\x{89A2}\x{89A3}\x{89A4}\x{89A5}' . +'\x{89A6}\x{89A7}\x{89A8}\x{89AA}\x{89AB}\x{89AC}\x{89AD}\x{89AE}\x{89AF}' . +'\x{89B1}\x{89B2}\x{89B3}\x{89B5}\x{89B6}\x{89B7}\x{89B8}\x{89B9}\x{89BA}' . +'\x{89BD}\x{89BE}\x{89BF}\x{89C0}\x{89C1}\x{89C2}\x{89C3}\x{89C4}\x{89C5}' . +'\x{89C6}\x{89C7}\x{89C8}\x{89C9}\x{89CA}\x{89CB}\x{89CC}\x{89CD}\x{89CE}' . +'\x{89CF}\x{89D0}\x{89D1}\x{89D2}\x{89D3}\x{89D4}\x{89D5}\x{89D6}\x{89D7}' . +'\x{89D8}\x{89D9}\x{89DA}\x{89DB}\x{89DC}\x{89DD}\x{89DE}\x{89DF}\x{89E0}' . +'\x{89E1}\x{89E2}\x{89E3}\x{89E4}\x{89E5}\x{89E6}\x{89E7}\x{89E8}\x{89E9}' . +'\x{89EA}\x{89EB}\x{89EC}\x{89ED}\x{89EF}\x{89F0}\x{89F1}\x{89F2}\x{89F3}' . +'\x{89F4}\x{89F6}\x{89F7}\x{89F8}\x{89FA}\x{89FB}\x{89FC}\x{89FE}\x{89FF}' . +'\x{8A00}\x{8A01}\x{8A02}\x{8A03}\x{8A04}\x{8A07}\x{8A08}\x{8A09}\x{8A0A}' . +'\x{8A0B}\x{8A0C}\x{8A0D}\x{8A0E}\x{8A0F}\x{8A10}\x{8A11}\x{8A12}\x{8A13}' . +'\x{8A15}\x{8A16}\x{8A17}\x{8A18}\x{8A1A}\x{8A1B}\x{8A1C}\x{8A1D}\x{8A1E}' . +'\x{8A1F}\x{8A22}\x{8A23}\x{8A24}\x{8A25}\x{8A26}\x{8A27}\x{8A28}\x{8A29}' . +'\x{8A2A}\x{8A2C}\x{8A2D}\x{8A2E}\x{8A2F}\x{8A30}\x{8A31}\x{8A32}\x{8A34}' . +'\x{8A35}\x{8A36}\x{8A37}\x{8A38}\x{8A39}\x{8A3A}\x{8A3B}\x{8A3C}\x{8A3E}' . +'\x{8A3F}\x{8A40}\x{8A41}\x{8A42}\x{8A43}\x{8A44}\x{8A45}\x{8A46}\x{8A47}' . +'\x{8A48}\x{8A49}\x{8A4A}\x{8A4C}\x{8A4D}\x{8A4E}\x{8A4F}\x{8A50}\x{8A51}' . +'\x{8A52}\x{8A53}\x{8A54}\x{8A55}\x{8A56}\x{8A57}\x{8A58}\x{8A59}\x{8A5A}' . +'\x{8A5B}\x{8A5C}\x{8A5D}\x{8A5E}\x{8A5F}\x{8A60}\x{8A61}\x{8A62}\x{8A63}' . +'\x{8A65}\x{8A66}\x{8A67}\x{8A68}\x{8A69}\x{8A6A}\x{8A6B}\x{8A6C}\x{8A6D}' . +'\x{8A6E}\x{8A6F}\x{8A70}\x{8A71}\x{8A72}\x{8A73}\x{8A74}\x{8A75}\x{8A76}' . +'\x{8A77}\x{8A79}\x{8A7A}\x{8A7B}\x{8A7C}\x{8A7E}\x{8A7F}\x{8A80}\x{8A81}' . +'\x{8A82}\x{8A83}\x{8A84}\x{8A85}\x{8A86}\x{8A87}\x{8A89}\x{8A8A}\x{8A8B}' . +'\x{8A8C}\x{8A8D}\x{8A8E}\x{8A8F}\x{8A90}\x{8A91}\x{8A92}\x{8A93}\x{8A94}' . +'\x{8A95}\x{8A96}\x{8A97}\x{8A98}\x{8A99}\x{8A9A}\x{8A9B}\x{8A9C}\x{8A9D}' . +'\x{8A9E}\x{8AA0}\x{8AA1}\x{8AA2}\x{8AA3}\x{8AA4}\x{8AA5}\x{8AA6}\x{8AA7}' . +'\x{8AA8}\x{8AA9}\x{8AAA}\x{8AAB}\x{8AAC}\x{8AAE}\x{8AB0}\x{8AB1}\x{8AB2}' . +'\x{8AB3}\x{8AB4}\x{8AB5}\x{8AB6}\x{8AB8}\x{8AB9}\x{8ABA}\x{8ABB}\x{8ABC}' . +'\x{8ABD}\x{8ABE}\x{8ABF}\x{8AC0}\x{8AC1}\x{8AC2}\x{8AC3}\x{8AC4}\x{8AC5}' . +'\x{8AC6}\x{8AC7}\x{8AC8}\x{8AC9}\x{8ACA}\x{8ACB}\x{8ACC}\x{8ACD}\x{8ACE}' . +'\x{8ACF}\x{8AD1}\x{8AD2}\x{8AD3}\x{8AD4}\x{8AD5}\x{8AD6}\x{8AD7}\x{8AD8}' . +'\x{8AD9}\x{8ADA}\x{8ADB}\x{8ADC}\x{8ADD}\x{8ADE}\x{8ADF}\x{8AE0}\x{8AE1}' . +'\x{8AE2}\x{8AE3}\x{8AE4}\x{8AE5}\x{8AE6}\x{8AE7}\x{8AE8}\x{8AE9}\x{8AEA}' . +'\x{8AEB}\x{8AED}\x{8AEE}\x{8AEF}\x{8AF0}\x{8AF1}\x{8AF2}\x{8AF3}\x{8AF4}' . +'\x{8AF5}\x{8AF6}\x{8AF7}\x{8AF8}\x{8AF9}\x{8AFA}\x{8AFB}\x{8AFC}\x{8AFD}' . +'\x{8AFE}\x{8AFF}\x{8B00}\x{8B01}\x{8B02}\x{8B03}\x{8B04}\x{8B05}\x{8B06}' . +'\x{8B07}\x{8B08}\x{8B09}\x{8B0A}\x{8B0B}\x{8B0D}\x{8B0E}\x{8B0F}\x{8B10}' . +'\x{8B11}\x{8B12}\x{8B13}\x{8B14}\x{8B15}\x{8B16}\x{8B17}\x{8B18}\x{8B19}' . +'\x{8B1A}\x{8B1B}\x{8B1C}\x{8B1D}\x{8B1E}\x{8B1F}\x{8B20}\x{8B21}\x{8B22}' . +'\x{8B23}\x{8B24}\x{8B25}\x{8B26}\x{8B27}\x{8B28}\x{8B2A}\x{8B2B}\x{8B2C}' . +'\x{8B2D}\x{8B2E}\x{8B2F}\x{8B30}\x{8B31}\x{8B33}\x{8B34}\x{8B35}\x{8B36}' . +'\x{8B37}\x{8B39}\x{8B3A}\x{8B3B}\x{8B3C}\x{8B3D}\x{8B3E}\x{8B40}\x{8B41}' . +'\x{8B42}\x{8B43}\x{8B44}\x{8B45}\x{8B46}\x{8B47}\x{8B48}\x{8B49}\x{8B4A}' . +'\x{8B4B}\x{8B4C}\x{8B4D}\x{8B4E}\x{8B4F}\x{8B50}\x{8B51}\x{8B52}\x{8B53}' . +'\x{8B54}\x{8B55}\x{8B56}\x{8B57}\x{8B58}\x{8B59}\x{8B5A}\x{8B5B}\x{8B5C}' . +'\x{8B5D}\x{8B5E}\x{8B5F}\x{8B60}\x{8B63}\x{8B64}\x{8B65}\x{8B66}\x{8B67}' . +'\x{8B68}\x{8B6A}\x{8B6B}\x{8B6C}\x{8B6D}\x{8B6E}\x{8B6F}\x{8B70}\x{8B71}' . +'\x{8B73}\x{8B74}\x{8B76}\x{8B77}\x{8B78}\x{8B79}\x{8B7A}\x{8B7B}\x{8B7D}' . +'\x{8B7E}\x{8B7F}\x{8B80}\x{8B82}\x{8B83}\x{8B84}\x{8B85}\x{8B86}\x{8B88}' . +'\x{8B89}\x{8B8A}\x{8B8B}\x{8B8C}\x{8B8E}\x{8B90}\x{8B91}\x{8B92}\x{8B93}' . +'\x{8B94}\x{8B95}\x{8B96}\x{8B97}\x{8B98}\x{8B99}\x{8B9A}\x{8B9C}\x{8B9D}' . +'\x{8B9E}\x{8B9F}\x{8BA0}\x{8BA1}\x{8BA2}\x{8BA3}\x{8BA4}\x{8BA5}\x{8BA6}' . +'\x{8BA7}\x{8BA8}\x{8BA9}\x{8BAA}\x{8BAB}\x{8BAC}\x{8BAD}\x{8BAE}\x{8BAF}' . +'\x{8BB0}\x{8BB1}\x{8BB2}\x{8BB3}\x{8BB4}\x{8BB5}\x{8BB6}\x{8BB7}\x{8BB8}' . +'\x{8BB9}\x{8BBA}\x{8BBB}\x{8BBC}\x{8BBD}\x{8BBE}\x{8BBF}\x{8BC0}\x{8BC1}' . +'\x{8BC2}\x{8BC3}\x{8BC4}\x{8BC5}\x{8BC6}\x{8BC7}\x{8BC8}\x{8BC9}\x{8BCA}' . +'\x{8BCB}\x{8BCC}\x{8BCD}\x{8BCE}\x{8BCF}\x{8BD0}\x{8BD1}\x{8BD2}\x{8BD3}' . +'\x{8BD4}\x{8BD5}\x{8BD6}\x{8BD7}\x{8BD8}\x{8BD9}\x{8BDA}\x{8BDB}\x{8BDC}' . +'\x{8BDD}\x{8BDE}\x{8BDF}\x{8BE0}\x{8BE1}\x{8BE2}\x{8BE3}\x{8BE4}\x{8BE5}' . +'\x{8BE6}\x{8BE7}\x{8BE8}\x{8BE9}\x{8BEA}\x{8BEB}\x{8BEC}\x{8BED}\x{8BEE}' . +'\x{8BEF}\x{8BF0}\x{8BF1}\x{8BF2}\x{8BF3}\x{8BF4}\x{8BF5}\x{8BF6}\x{8BF7}' . +'\x{8BF8}\x{8BF9}\x{8BFA}\x{8BFB}\x{8BFC}\x{8BFD}\x{8BFE}\x{8BFF}\x{8C00}' . +'\x{8C01}\x{8C02}\x{8C03}\x{8C04}\x{8C05}\x{8C06}\x{8C07}\x{8C08}\x{8C09}' . +'\x{8C0A}\x{8C0B}\x{8C0C}\x{8C0D}\x{8C0E}\x{8C0F}\x{8C10}\x{8C11}\x{8C12}' . +'\x{8C13}\x{8C14}\x{8C15}\x{8C16}\x{8C17}\x{8C18}\x{8C19}\x{8C1A}\x{8C1B}' . +'\x{8C1C}\x{8C1D}\x{8C1E}\x{8C1F}\x{8C20}\x{8C21}\x{8C22}\x{8C23}\x{8C24}' . +'\x{8C25}\x{8C26}\x{8C27}\x{8C28}\x{8C29}\x{8C2A}\x{8C2B}\x{8C2C}\x{8C2D}' . +'\x{8C2E}\x{8C2F}\x{8C30}\x{8C31}\x{8C32}\x{8C33}\x{8C34}\x{8C35}\x{8C36}' . +'\x{8C37}\x{8C39}\x{8C3A}\x{8C3B}\x{8C3C}\x{8C3D}\x{8C3E}\x{8C3F}\x{8C41}' . +'\x{8C42}\x{8C43}\x{8C45}\x{8C46}\x{8C47}\x{8C48}\x{8C49}\x{8C4A}\x{8C4B}' . +'\x{8C4C}\x{8C4D}\x{8C4E}\x{8C4F}\x{8C50}\x{8C54}\x{8C55}\x{8C56}\x{8C57}' . +'\x{8C59}\x{8C5A}\x{8C5B}\x{8C5C}\x{8C5D}\x{8C5E}\x{8C5F}\x{8C60}\x{8C61}' . +'\x{8C62}\x{8C63}\x{8C64}\x{8C65}\x{8C66}\x{8C67}\x{8C68}\x{8C69}\x{8C6A}' . +'\x{8C6B}\x{8C6C}\x{8C6D}\x{8C6E}\x{8C6F}\x{8C70}\x{8C71}\x{8C72}\x{8C73}' . +'\x{8C75}\x{8C76}\x{8C77}\x{8C78}\x{8C79}\x{8C7A}\x{8C7B}\x{8C7D}\x{8C7E}' . +'\x{8C80}\x{8C81}\x{8C82}\x{8C84}\x{8C85}\x{8C86}\x{8C88}\x{8C89}\x{8C8A}' . +'\x{8C8C}\x{8C8D}\x{8C8F}\x{8C90}\x{8C91}\x{8C92}\x{8C93}\x{8C94}\x{8C95}' . +'\x{8C96}\x{8C97}\x{8C98}\x{8C99}\x{8C9A}\x{8C9C}\x{8C9D}\x{8C9E}\x{8C9F}' . +'\x{8CA0}\x{8CA1}\x{8CA2}\x{8CA3}\x{8CA4}\x{8CA5}\x{8CA7}\x{8CA8}\x{8CA9}' . +'\x{8CAA}\x{8CAB}\x{8CAC}\x{8CAD}\x{8CAE}\x{8CAF}\x{8CB0}\x{8CB1}\x{8CB2}' . +'\x{8CB3}\x{8CB4}\x{8CB5}\x{8CB6}\x{8CB7}\x{8CB8}\x{8CB9}\x{8CBA}\x{8CBB}' . +'\x{8CBC}\x{8CBD}\x{8CBE}\x{8CBF}\x{8CC0}\x{8CC1}\x{8CC2}\x{8CC3}\x{8CC4}' . +'\x{8CC5}\x{8CC6}\x{8CC7}\x{8CC8}\x{8CC9}\x{8CCA}\x{8CCC}\x{8CCE}\x{8CCF}' . +'\x{8CD0}\x{8CD1}\x{8CD2}\x{8CD3}\x{8CD4}\x{8CD5}\x{8CD7}\x{8CD9}\x{8CDA}' . +'\x{8CDB}\x{8CDC}\x{8CDD}\x{8CDE}\x{8CDF}\x{8CE0}\x{8CE1}\x{8CE2}\x{8CE3}' . +'\x{8CE4}\x{8CE5}\x{8CE6}\x{8CE7}\x{8CE8}\x{8CEA}\x{8CEB}\x{8CEC}\x{8CED}' . +'\x{8CEE}\x{8CEF}\x{8CF0}\x{8CF1}\x{8CF2}\x{8CF3}\x{8CF4}\x{8CF5}\x{8CF6}' . +'\x{8CF8}\x{8CF9}\x{8CFA}\x{8CFB}\x{8CFC}\x{8CFD}\x{8CFE}\x{8CFF}\x{8D00}' . +'\x{8D02}\x{8D03}\x{8D04}\x{8D05}\x{8D06}\x{8D07}\x{8D08}\x{8D09}\x{8D0A}' . +'\x{8D0B}\x{8D0C}\x{8D0D}\x{8D0E}\x{8D0F}\x{8D10}\x{8D13}\x{8D14}\x{8D15}' . +'\x{8D16}\x{8D17}\x{8D18}\x{8D19}\x{8D1A}\x{8D1B}\x{8D1C}\x{8D1D}\x{8D1E}' . +'\x{8D1F}\x{8D20}\x{8D21}\x{8D22}\x{8D23}\x{8D24}\x{8D25}\x{8D26}\x{8D27}' . +'\x{8D28}\x{8D29}\x{8D2A}\x{8D2B}\x{8D2C}\x{8D2D}\x{8D2E}\x{8D2F}\x{8D30}' . +'\x{8D31}\x{8D32}\x{8D33}\x{8D34}\x{8D35}\x{8D36}\x{8D37}\x{8D38}\x{8D39}' . +'\x{8D3A}\x{8D3B}\x{8D3C}\x{8D3D}\x{8D3E}\x{8D3F}\x{8D40}\x{8D41}\x{8D42}' . +'\x{8D43}\x{8D44}\x{8D45}\x{8D46}\x{8D47}\x{8D48}\x{8D49}\x{8D4A}\x{8D4B}' . +'\x{8D4C}\x{8D4D}\x{8D4E}\x{8D4F}\x{8D50}\x{8D51}\x{8D52}\x{8D53}\x{8D54}' . +'\x{8D55}\x{8D56}\x{8D57}\x{8D58}\x{8D59}\x{8D5A}\x{8D5B}\x{8D5C}\x{8D5D}' . +'\x{8D5E}\x{8D5F}\x{8D60}\x{8D61}\x{8D62}\x{8D63}\x{8D64}\x{8D65}\x{8D66}' . +'\x{8D67}\x{8D68}\x{8D69}\x{8D6A}\x{8D6B}\x{8D6C}\x{8D6D}\x{8D6E}\x{8D6F}' . +'\x{8D70}\x{8D71}\x{8D72}\x{8D73}\x{8D74}\x{8D75}\x{8D76}\x{8D77}\x{8D78}' . +'\x{8D79}\x{8D7A}\x{8D7B}\x{8D7D}\x{8D7E}\x{8D7F}\x{8D80}\x{8D81}\x{8D82}' . +'\x{8D83}\x{8D84}\x{8D85}\x{8D86}\x{8D87}\x{8D88}\x{8D89}\x{8D8A}\x{8D8B}' . +'\x{8D8C}\x{8D8D}\x{8D8E}\x{8D8F}\x{8D90}\x{8D91}\x{8D92}\x{8D93}\x{8D94}' . +'\x{8D95}\x{8D96}\x{8D97}\x{8D98}\x{8D99}\x{8D9A}\x{8D9B}\x{8D9C}\x{8D9D}' . +'\x{8D9E}\x{8D9F}\x{8DA0}\x{8DA1}\x{8DA2}\x{8DA3}\x{8DA4}\x{8DA5}\x{8DA7}' . +'\x{8DA8}\x{8DA9}\x{8DAA}\x{8DAB}\x{8DAC}\x{8DAD}\x{8DAE}\x{8DAF}\x{8DB0}' . +'\x{8DB1}\x{8DB2}\x{8DB3}\x{8DB4}\x{8DB5}\x{8DB6}\x{8DB7}\x{8DB8}\x{8DB9}' . +'\x{8DBA}\x{8DBB}\x{8DBC}\x{8DBD}\x{8DBE}\x{8DBF}\x{8DC1}\x{8DC2}\x{8DC3}' . +'\x{8DC4}\x{8DC5}\x{8DC6}\x{8DC7}\x{8DC8}\x{8DC9}\x{8DCA}\x{8DCB}\x{8DCC}' . +'\x{8DCD}\x{8DCE}\x{8DCF}\x{8DD0}\x{8DD1}\x{8DD2}\x{8DD3}\x{8DD4}\x{8DD5}' . +'\x{8DD6}\x{8DD7}\x{8DD8}\x{8DD9}\x{8DDA}\x{8DDB}\x{8DDC}\x{8DDD}\x{8DDE}' . +'\x{8DDF}\x{8DE0}\x{8DE1}\x{8DE2}\x{8DE3}\x{8DE4}\x{8DE6}\x{8DE7}\x{8DE8}' . +'\x{8DE9}\x{8DEA}\x{8DEB}\x{8DEC}\x{8DED}\x{8DEE}\x{8DEF}\x{8DF0}\x{8DF1}' . +'\x{8DF2}\x{8DF3}\x{8DF4}\x{8DF5}\x{8DF6}\x{8DF7}\x{8DF8}\x{8DF9}\x{8DFA}' . +'\x{8DFB}\x{8DFC}\x{8DFD}\x{8DFE}\x{8DFF}\x{8E00}\x{8E02}\x{8E03}\x{8E04}' . +'\x{8E05}\x{8E06}\x{8E07}\x{8E08}\x{8E09}\x{8E0A}\x{8E0C}\x{8E0D}\x{8E0E}' . +'\x{8E0F}\x{8E10}\x{8E11}\x{8E12}\x{8E13}\x{8E14}\x{8E15}\x{8E16}\x{8E17}' . +'\x{8E18}\x{8E19}\x{8E1A}\x{8E1B}\x{8E1C}\x{8E1D}\x{8E1E}\x{8E1F}\x{8E20}' . +'\x{8E21}\x{8E22}\x{8E23}\x{8E24}\x{8E25}\x{8E26}\x{8E27}\x{8E28}\x{8E29}' . +'\x{8E2A}\x{8E2B}\x{8E2C}\x{8E2D}\x{8E2E}\x{8E2F}\x{8E30}\x{8E31}\x{8E33}' . +'\x{8E34}\x{8E35}\x{8E36}\x{8E37}\x{8E38}\x{8E39}\x{8E3A}\x{8E3B}\x{8E3C}' . +'\x{8E3D}\x{8E3E}\x{8E3F}\x{8E40}\x{8E41}\x{8E42}\x{8E43}\x{8E44}\x{8E45}' . +'\x{8E47}\x{8E48}\x{8E49}\x{8E4A}\x{8E4B}\x{8E4C}\x{8E4D}\x{8E4E}\x{8E50}' . +'\x{8E51}\x{8E52}\x{8E53}\x{8E54}\x{8E55}\x{8E56}\x{8E57}\x{8E58}\x{8E59}' . +'\x{8E5A}\x{8E5B}\x{8E5C}\x{8E5D}\x{8E5E}\x{8E5F}\x{8E60}\x{8E61}\x{8E62}' . +'\x{8E63}\x{8E64}\x{8E65}\x{8E66}\x{8E67}\x{8E68}\x{8E69}\x{8E6A}\x{8E6B}' . +'\x{8E6C}\x{8E6D}\x{8E6F}\x{8E70}\x{8E71}\x{8E72}\x{8E73}\x{8E74}\x{8E76}' . +'\x{8E78}\x{8E7A}\x{8E7B}\x{8E7C}\x{8E7D}\x{8E7E}\x{8E7F}\x{8E80}\x{8E81}' . +'\x{8E82}\x{8E83}\x{8E84}\x{8E85}\x{8E86}\x{8E87}\x{8E88}\x{8E89}\x{8E8A}' . +'\x{8E8B}\x{8E8C}\x{8E8D}\x{8E8E}\x{8E8F}\x{8E90}\x{8E91}\x{8E92}\x{8E93}' . +'\x{8E94}\x{8E95}\x{8E96}\x{8E97}\x{8E98}\x{8E9A}\x{8E9C}\x{8E9D}\x{8E9E}' . +'\x{8E9F}\x{8EA0}\x{8EA1}\x{8EA3}\x{8EA4}\x{8EA5}\x{8EA6}\x{8EA7}\x{8EA8}' . +'\x{8EA9}\x{8EAA}\x{8EAB}\x{8EAC}\x{8EAD}\x{8EAE}\x{8EAF}\x{8EB0}\x{8EB1}' . +'\x{8EB2}\x{8EB4}\x{8EB5}\x{8EB8}\x{8EB9}\x{8EBA}\x{8EBB}\x{8EBC}\x{8EBD}' . +'\x{8EBE}\x{8EBF}\x{8EC0}\x{8EC2}\x{8EC3}\x{8EC5}\x{8EC6}\x{8EC7}\x{8EC8}' . +'\x{8EC9}\x{8ECA}\x{8ECB}\x{8ECC}\x{8ECD}\x{8ECE}\x{8ECF}\x{8ED0}\x{8ED1}' . +'\x{8ED2}\x{8ED3}\x{8ED4}\x{8ED5}\x{8ED6}\x{8ED7}\x{8ED8}\x{8EDA}\x{8EDB}' . +'\x{8EDC}\x{8EDD}\x{8EDE}\x{8EDF}\x{8EE0}\x{8EE1}\x{8EE4}\x{8EE5}\x{8EE6}' . +'\x{8EE7}\x{8EE8}\x{8EE9}\x{8EEA}\x{8EEB}\x{8EEC}\x{8EED}\x{8EEE}\x{8EEF}' . +'\x{8EF1}\x{8EF2}\x{8EF3}\x{8EF4}\x{8EF5}\x{8EF6}\x{8EF7}\x{8EF8}\x{8EF9}' . +'\x{8EFA}\x{8EFB}\x{8EFC}\x{8EFD}\x{8EFE}\x{8EFF}\x{8F00}\x{8F01}\x{8F02}' . +'\x{8F03}\x{8F04}\x{8F05}\x{8F06}\x{8F07}\x{8F08}\x{8F09}\x{8F0A}\x{8F0B}' . +'\x{8F0D}\x{8F0E}\x{8F10}\x{8F11}\x{8F12}\x{8F13}\x{8F14}\x{8F15}\x{8F16}' . +'\x{8F17}\x{8F18}\x{8F1A}\x{8F1B}\x{8F1C}\x{8F1D}\x{8F1E}\x{8F1F}\x{8F20}' . +'\x{8F21}\x{8F22}\x{8F23}\x{8F24}\x{8F25}\x{8F26}\x{8F27}\x{8F28}\x{8F29}' . +'\x{8F2A}\x{8F2B}\x{8F2C}\x{8F2E}\x{8F2F}\x{8F30}\x{8F31}\x{8F32}\x{8F33}' . +'\x{8F34}\x{8F35}\x{8F36}\x{8F37}\x{8F38}\x{8F39}\x{8F3B}\x{8F3C}\x{8F3D}' . +'\x{8F3E}\x{8F3F}\x{8F40}\x{8F42}\x{8F43}\x{8F44}\x{8F45}\x{8F46}\x{8F47}' . +'\x{8F48}\x{8F49}\x{8F4A}\x{8F4B}\x{8F4C}\x{8F4D}\x{8F4E}\x{8F4F}\x{8F50}' . +'\x{8F51}\x{8F52}\x{8F53}\x{8F54}\x{8F55}\x{8F56}\x{8F57}\x{8F58}\x{8F59}' . +'\x{8F5A}\x{8F5B}\x{8F5D}\x{8F5E}\x{8F5F}\x{8F60}\x{8F61}\x{8F62}\x{8F63}' . +'\x{8F64}\x{8F65}\x{8F66}\x{8F67}\x{8F68}\x{8F69}\x{8F6A}\x{8F6B}\x{8F6C}' . +'\x{8F6D}\x{8F6E}\x{8F6F}\x{8F70}\x{8F71}\x{8F72}\x{8F73}\x{8F74}\x{8F75}' . +'\x{8F76}\x{8F77}\x{8F78}\x{8F79}\x{8F7A}\x{8F7B}\x{8F7C}\x{8F7D}\x{8F7E}' . +'\x{8F7F}\x{8F80}\x{8F81}\x{8F82}\x{8F83}\x{8F84}\x{8F85}\x{8F86}\x{8F87}' . +'\x{8F88}\x{8F89}\x{8F8A}\x{8F8B}\x{8F8C}\x{8F8D}\x{8F8E}\x{8F8F}\x{8F90}' . +'\x{8F91}\x{8F92}\x{8F93}\x{8F94}\x{8F95}\x{8F96}\x{8F97}\x{8F98}\x{8F99}' . +'\x{8F9A}\x{8F9B}\x{8F9C}\x{8F9E}\x{8F9F}\x{8FA0}\x{8FA1}\x{8FA2}\x{8FA3}' . +'\x{8FA5}\x{8FA6}\x{8FA7}\x{8FA8}\x{8FA9}\x{8FAA}\x{8FAB}\x{8FAC}\x{8FAD}' . +'\x{8FAE}\x{8FAF}\x{8FB0}\x{8FB1}\x{8FB2}\x{8FB4}\x{8FB5}\x{8FB6}\x{8FB7}' . +'\x{8FB8}\x{8FB9}\x{8FBB}\x{8FBC}\x{8FBD}\x{8FBE}\x{8FBF}\x{8FC0}\x{8FC1}' . +'\x{8FC2}\x{8FC4}\x{8FC5}\x{8FC6}\x{8FC7}\x{8FC8}\x{8FC9}\x{8FCB}\x{8FCC}' . +'\x{8FCD}\x{8FCE}\x{8FCF}\x{8FD0}\x{8FD1}\x{8FD2}\x{8FD3}\x{8FD4}\x{8FD5}' . +'\x{8FD6}\x{8FD7}\x{8FD8}\x{8FD9}\x{8FDA}\x{8FDB}\x{8FDC}\x{8FDD}\x{8FDE}' . +'\x{8FDF}\x{8FE0}\x{8FE1}\x{8FE2}\x{8FE3}\x{8FE4}\x{8FE5}\x{8FE6}\x{8FE8}' . +'\x{8FE9}\x{8FEA}\x{8FEB}\x{8FEC}\x{8FED}\x{8FEE}\x{8FEF}\x{8FF0}\x{8FF1}' . +'\x{8FF2}\x{8FF3}\x{8FF4}\x{8FF5}\x{8FF6}\x{8FF7}\x{8FF8}\x{8FF9}\x{8FFA}' . +'\x{8FFB}\x{8FFC}\x{8FFD}\x{8FFE}\x{8FFF}\x{9000}\x{9001}\x{9002}\x{9003}' . +'\x{9004}\x{9005}\x{9006}\x{9007}\x{9008}\x{9009}\x{900A}\x{900B}\x{900C}' . +'\x{900D}\x{900F}\x{9010}\x{9011}\x{9012}\x{9013}\x{9014}\x{9015}\x{9016}' . +'\x{9017}\x{9018}\x{9019}\x{901A}\x{901B}\x{901C}\x{901D}\x{901E}\x{901F}' . +'\x{9020}\x{9021}\x{9022}\x{9023}\x{9024}\x{9025}\x{9026}\x{9027}\x{9028}' . +'\x{9029}\x{902B}\x{902D}\x{902E}\x{902F}\x{9030}\x{9031}\x{9032}\x{9033}' . +'\x{9034}\x{9035}\x{9036}\x{9038}\x{903A}\x{903B}\x{903C}\x{903D}\x{903E}' . +'\x{903F}\x{9041}\x{9042}\x{9043}\x{9044}\x{9045}\x{9047}\x{9048}\x{9049}' . +'\x{904A}\x{904B}\x{904C}\x{904D}\x{904E}\x{904F}\x{9050}\x{9051}\x{9052}' . +'\x{9053}\x{9054}\x{9055}\x{9056}\x{9057}\x{9058}\x{9059}\x{905A}\x{905B}' . +'\x{905C}\x{905D}\x{905E}\x{905F}\x{9060}\x{9061}\x{9062}\x{9063}\x{9064}' . +'\x{9065}\x{9066}\x{9067}\x{9068}\x{9069}\x{906A}\x{906B}\x{906C}\x{906D}' . +'\x{906E}\x{906F}\x{9070}\x{9071}\x{9072}\x{9073}\x{9074}\x{9075}\x{9076}' . +'\x{9077}\x{9078}\x{9079}\x{907A}\x{907B}\x{907C}\x{907D}\x{907E}\x{907F}' . +'\x{9080}\x{9081}\x{9082}\x{9083}\x{9084}\x{9085}\x{9086}\x{9087}\x{9088}' . +'\x{9089}\x{908A}\x{908B}\x{908C}\x{908D}\x{908E}\x{908F}\x{9090}\x{9091}' . +'\x{9092}\x{9093}\x{9094}\x{9095}\x{9096}\x{9097}\x{9098}\x{9099}\x{909A}' . +'\x{909B}\x{909C}\x{909D}\x{909E}\x{909F}\x{90A0}\x{90A1}\x{90A2}\x{90A3}' . +'\x{90A4}\x{90A5}\x{90A6}\x{90A7}\x{90A8}\x{90A9}\x{90AA}\x{90AC}\x{90AD}' . +'\x{90AE}\x{90AF}\x{90B0}\x{90B1}\x{90B2}\x{90B3}\x{90B4}\x{90B5}\x{90B6}' . +'\x{90B7}\x{90B8}\x{90B9}\x{90BA}\x{90BB}\x{90BC}\x{90BD}\x{90BE}\x{90BF}' . +'\x{90C0}\x{90C1}\x{90C2}\x{90C3}\x{90C4}\x{90C5}\x{90C6}\x{90C7}\x{90C8}' . +'\x{90C9}\x{90CA}\x{90CB}\x{90CE}\x{90CF}\x{90D0}\x{90D1}\x{90D3}\x{90D4}' . +'\x{90D5}\x{90D6}\x{90D7}\x{90D8}\x{90D9}\x{90DA}\x{90DB}\x{90DC}\x{90DD}' . +'\x{90DE}\x{90DF}\x{90E0}\x{90E1}\x{90E2}\x{90E3}\x{90E4}\x{90E5}\x{90E6}' . +'\x{90E7}\x{90E8}\x{90E9}\x{90EA}\x{90EB}\x{90EC}\x{90ED}\x{90EE}\x{90EF}' . +'\x{90F0}\x{90F1}\x{90F2}\x{90F3}\x{90F4}\x{90F5}\x{90F7}\x{90F8}\x{90F9}' . +'\x{90FA}\x{90FB}\x{90FC}\x{90FD}\x{90FE}\x{90FF}\x{9100}\x{9101}\x{9102}' . +'\x{9103}\x{9104}\x{9105}\x{9106}\x{9107}\x{9108}\x{9109}\x{910B}\x{910C}' . +'\x{910D}\x{910E}\x{910F}\x{9110}\x{9111}\x{9112}\x{9113}\x{9114}\x{9115}' . +'\x{9116}\x{9117}\x{9118}\x{9119}\x{911A}\x{911B}\x{911C}\x{911D}\x{911E}' . +'\x{911F}\x{9120}\x{9121}\x{9122}\x{9123}\x{9124}\x{9125}\x{9126}\x{9127}' . +'\x{9128}\x{9129}\x{912A}\x{912B}\x{912C}\x{912D}\x{912E}\x{912F}\x{9130}' . +'\x{9131}\x{9132}\x{9133}\x{9134}\x{9135}\x{9136}\x{9137}\x{9138}\x{9139}' . +'\x{913A}\x{913B}\x{913E}\x{913F}\x{9140}\x{9141}\x{9142}\x{9143}\x{9144}' . +'\x{9145}\x{9146}\x{9147}\x{9148}\x{9149}\x{914A}\x{914B}\x{914C}\x{914D}' . +'\x{914E}\x{914F}\x{9150}\x{9151}\x{9152}\x{9153}\x{9154}\x{9155}\x{9156}' . +'\x{9157}\x{9158}\x{915A}\x{915B}\x{915C}\x{915D}\x{915E}\x{915F}\x{9160}' . +'\x{9161}\x{9162}\x{9163}\x{9164}\x{9165}\x{9166}\x{9167}\x{9168}\x{9169}' . +'\x{916A}\x{916B}\x{916C}\x{916D}\x{916E}\x{916F}\x{9170}\x{9171}\x{9172}' . +'\x{9173}\x{9174}\x{9175}\x{9176}\x{9177}\x{9178}\x{9179}\x{917A}\x{917C}' . +'\x{917D}\x{917E}\x{917F}\x{9180}\x{9181}\x{9182}\x{9183}\x{9184}\x{9185}' . +'\x{9186}\x{9187}\x{9188}\x{9189}\x{918A}\x{918B}\x{918C}\x{918D}\x{918E}' . +'\x{918F}\x{9190}\x{9191}\x{9192}\x{9193}\x{9194}\x{9196}\x{9199}\x{919A}' . +'\x{919B}\x{919C}\x{919D}\x{919E}\x{919F}\x{91A0}\x{91A1}\x{91A2}\x{91A3}' . +'\x{91A5}\x{91A6}\x{91A7}\x{91A8}\x{91AA}\x{91AB}\x{91AC}\x{91AD}\x{91AE}' . +'\x{91AF}\x{91B0}\x{91B1}\x{91B2}\x{91B3}\x{91B4}\x{91B5}\x{91B6}\x{91B7}' . +'\x{91B9}\x{91BA}\x{91BB}\x{91BC}\x{91BD}\x{91BE}\x{91C0}\x{91C1}\x{91C2}' . +'\x{91C3}\x{91C5}\x{91C6}\x{91C7}\x{91C9}\x{91CA}\x{91CB}\x{91CC}\x{91CD}' . +'\x{91CE}\x{91CF}\x{91D0}\x{91D1}\x{91D2}\x{91D3}\x{91D4}\x{91D5}\x{91D7}' . +'\x{91D8}\x{91D9}\x{91DA}\x{91DB}\x{91DC}\x{91DD}\x{91DE}\x{91DF}\x{91E2}' . +'\x{91E3}\x{91E4}\x{91E5}\x{91E6}\x{91E7}\x{91E8}\x{91E9}\x{91EA}\x{91EB}' . +'\x{91EC}\x{91ED}\x{91EE}\x{91F0}\x{91F1}\x{91F2}\x{91F3}\x{91F4}\x{91F5}' . +'\x{91F7}\x{91F8}\x{91F9}\x{91FA}\x{91FB}\x{91FD}\x{91FE}\x{91FF}\x{9200}' . +'\x{9201}\x{9202}\x{9203}\x{9204}\x{9205}\x{9206}\x{9207}\x{9208}\x{9209}' . +'\x{920A}\x{920B}\x{920C}\x{920D}\x{920E}\x{920F}\x{9210}\x{9211}\x{9212}' . +'\x{9214}\x{9215}\x{9216}\x{9217}\x{9218}\x{9219}\x{921A}\x{921B}\x{921C}' . +'\x{921D}\x{921E}\x{9220}\x{9221}\x{9223}\x{9224}\x{9225}\x{9226}\x{9227}' . +'\x{9228}\x{9229}\x{922A}\x{922B}\x{922D}\x{922E}\x{922F}\x{9230}\x{9231}' . +'\x{9232}\x{9233}\x{9234}\x{9235}\x{9236}\x{9237}\x{9238}\x{9239}\x{923A}' . +'\x{923B}\x{923C}\x{923D}\x{923E}\x{923F}\x{9240}\x{9241}\x{9242}\x{9245}' . +'\x{9246}\x{9247}\x{9248}\x{9249}\x{924A}\x{924B}\x{924C}\x{924D}\x{924E}' . +'\x{924F}\x{9250}\x{9251}\x{9252}\x{9253}\x{9254}\x{9255}\x{9256}\x{9257}' . +'\x{9258}\x{9259}\x{925A}\x{925B}\x{925C}\x{925D}\x{925E}\x{925F}\x{9260}' . +'\x{9261}\x{9262}\x{9263}\x{9264}\x{9265}\x{9266}\x{9267}\x{9268}\x{926B}' . +'\x{926C}\x{926D}\x{926E}\x{926F}\x{9270}\x{9272}\x{9273}\x{9274}\x{9275}' . +'\x{9276}\x{9277}\x{9278}\x{9279}\x{927A}\x{927B}\x{927C}\x{927D}\x{927E}' . +'\x{927F}\x{9280}\x{9282}\x{9283}\x{9285}\x{9286}\x{9287}\x{9288}\x{9289}' . +'\x{928A}\x{928B}\x{928C}\x{928D}\x{928E}\x{928F}\x{9290}\x{9291}\x{9292}' . +'\x{9293}\x{9294}\x{9295}\x{9296}\x{9297}\x{9298}\x{9299}\x{929A}\x{929B}' . +'\x{929C}\x{929D}\x{929F}\x{92A0}\x{92A1}\x{92A2}\x{92A3}\x{92A4}\x{92A5}' . +'\x{92A6}\x{92A7}\x{92A8}\x{92A9}\x{92AA}\x{92AB}\x{92AC}\x{92AD}\x{92AE}' . +'\x{92AF}\x{92B0}\x{92B1}\x{92B2}\x{92B3}\x{92B4}\x{92B5}\x{92B6}\x{92B7}' . +'\x{92B8}\x{92B9}\x{92BA}\x{92BB}\x{92BC}\x{92BE}\x{92BF}\x{92C0}\x{92C1}' . +'\x{92C2}\x{92C3}\x{92C4}\x{92C5}\x{92C6}\x{92C7}\x{92C8}\x{92C9}\x{92CA}' . +'\x{92CB}\x{92CC}\x{92CD}\x{92CE}\x{92CF}\x{92D0}\x{92D1}\x{92D2}\x{92D3}' . +'\x{92D5}\x{92D6}\x{92D7}\x{92D8}\x{92D9}\x{92DA}\x{92DC}\x{92DD}\x{92DE}' . +'\x{92DF}\x{92E0}\x{92E1}\x{92E3}\x{92E4}\x{92E5}\x{92E6}\x{92E7}\x{92E8}' . +'\x{92E9}\x{92EA}\x{92EB}\x{92EC}\x{92ED}\x{92EE}\x{92EF}\x{92F0}\x{92F1}' . +'\x{92F2}\x{92F3}\x{92F4}\x{92F5}\x{92F6}\x{92F7}\x{92F8}\x{92F9}\x{92FA}' . +'\x{92FB}\x{92FC}\x{92FD}\x{92FE}\x{92FF}\x{9300}\x{9301}\x{9302}\x{9303}' . +'\x{9304}\x{9305}\x{9306}\x{9307}\x{9308}\x{9309}\x{930A}\x{930B}\x{930C}' . +'\x{930D}\x{930E}\x{930F}\x{9310}\x{9311}\x{9312}\x{9313}\x{9314}\x{9315}' . +'\x{9316}\x{9317}\x{9318}\x{9319}\x{931A}\x{931B}\x{931D}\x{931E}\x{931F}' . +'\x{9320}\x{9321}\x{9322}\x{9323}\x{9324}\x{9325}\x{9326}\x{9327}\x{9328}' . +'\x{9329}\x{932A}\x{932B}\x{932D}\x{932E}\x{932F}\x{9332}\x{9333}\x{9334}' . +'\x{9335}\x{9336}\x{9337}\x{9338}\x{9339}\x{933A}\x{933B}\x{933C}\x{933D}' . +'\x{933E}\x{933F}\x{9340}\x{9341}\x{9342}\x{9343}\x{9344}\x{9345}\x{9346}' . +'\x{9347}\x{9348}\x{9349}\x{934A}\x{934B}\x{934C}\x{934D}\x{934E}\x{934F}' . +'\x{9350}\x{9351}\x{9352}\x{9353}\x{9354}\x{9355}\x{9356}\x{9357}\x{9358}' . +'\x{9359}\x{935A}\x{935B}\x{935C}\x{935D}\x{935E}\x{935F}\x{9360}\x{9361}' . +'\x{9363}\x{9364}\x{9365}\x{9366}\x{9367}\x{9369}\x{936A}\x{936C}\x{936D}' . +'\x{936E}\x{9370}\x{9371}\x{9372}\x{9374}\x{9375}\x{9376}\x{9377}\x{9379}' . +'\x{937A}\x{937B}\x{937C}\x{937D}\x{937E}\x{9380}\x{9382}\x{9383}\x{9384}' . +'\x{9385}\x{9386}\x{9387}\x{9388}\x{9389}\x{938A}\x{938C}\x{938D}\x{938E}' . +'\x{938F}\x{9390}\x{9391}\x{9392}\x{9393}\x{9394}\x{9395}\x{9396}\x{9397}' . +'\x{9398}\x{9399}\x{939A}\x{939B}\x{939D}\x{939E}\x{939F}\x{93A1}\x{93A2}' . +'\x{93A3}\x{93A4}\x{93A5}\x{93A6}\x{93A7}\x{93A8}\x{93A9}\x{93AA}\x{93AC}' . +'\x{93AD}\x{93AE}\x{93AF}\x{93B0}\x{93B1}\x{93B2}\x{93B3}\x{93B4}\x{93B5}' . +'\x{93B6}\x{93B7}\x{93B8}\x{93B9}\x{93BA}\x{93BC}\x{93BD}\x{93BE}\x{93BF}' . +'\x{93C0}\x{93C1}\x{93C2}\x{93C3}\x{93C4}\x{93C5}\x{93C6}\x{93C7}\x{93C8}' . +'\x{93C9}\x{93CA}\x{93CB}\x{93CC}\x{93CD}\x{93CE}\x{93CF}\x{93D0}\x{93D1}' . +'\x{93D2}\x{93D3}\x{93D4}\x{93D5}\x{93D6}\x{93D7}\x{93D8}\x{93D9}\x{93DA}' . +'\x{93DB}\x{93DC}\x{93DD}\x{93DE}\x{93DF}\x{93E1}\x{93E2}\x{93E3}\x{93E4}' . +'\x{93E6}\x{93E7}\x{93E8}\x{93E9}\x{93EA}\x{93EB}\x{93EC}\x{93ED}\x{93EE}' . +'\x{93EF}\x{93F0}\x{93F1}\x{93F2}\x{93F4}\x{93F5}\x{93F6}\x{93F7}\x{93F8}' . +'\x{93F9}\x{93FA}\x{93FB}\x{93FC}\x{93FD}\x{93FE}\x{93FF}\x{9400}\x{9401}' . +'\x{9403}\x{9404}\x{9405}\x{9406}\x{9407}\x{9408}\x{9409}\x{940A}\x{940B}' . +'\x{940C}\x{940D}\x{940E}\x{940F}\x{9410}\x{9411}\x{9412}\x{9413}\x{9414}' . +'\x{9415}\x{9416}\x{9418}\x{9419}\x{941B}\x{941D}\x{9420}\x{9422}\x{9423}' . +'\x{9425}\x{9426}\x{9427}\x{9428}\x{9429}\x{942A}\x{942B}\x{942C}\x{942D}' . +'\x{942E}\x{942F}\x{9430}\x{9431}\x{9432}\x{9433}\x{9434}\x{9435}\x{9436}' . +'\x{9437}\x{9438}\x{9439}\x{943A}\x{943B}\x{943C}\x{943D}\x{943E}\x{943F}' . +'\x{9440}\x{9441}\x{9442}\x{9444}\x{9445}\x{9446}\x{9447}\x{9448}\x{9449}' . +'\x{944A}\x{944B}\x{944C}\x{944D}\x{944F}\x{9450}\x{9451}\x{9452}\x{9453}' . +'\x{9454}\x{9455}\x{9456}\x{9457}\x{9458}\x{9459}\x{945B}\x{945C}\x{945D}' . +'\x{945E}\x{945F}\x{9460}\x{9461}\x{9462}\x{9463}\x{9464}\x{9465}\x{9466}' . +'\x{9467}\x{9468}\x{9469}\x{946A}\x{946B}\x{946D}\x{946E}\x{946F}\x{9470}' . +'\x{9471}\x{9472}\x{9473}\x{9474}\x{9475}\x{9476}\x{9477}\x{9478}\x{9479}' . +'\x{947A}\x{947C}\x{947D}\x{947E}\x{947F}\x{9480}\x{9481}\x{9482}\x{9483}' . +'\x{9484}\x{9485}\x{9486}\x{9487}\x{9488}\x{9489}\x{948A}\x{948B}\x{948C}' . +'\x{948D}\x{948E}\x{948F}\x{9490}\x{9491}\x{9492}\x{9493}\x{9494}\x{9495}' . +'\x{9496}\x{9497}\x{9498}\x{9499}\x{949A}\x{949B}\x{949C}\x{949D}\x{949E}' . +'\x{949F}\x{94A0}\x{94A1}\x{94A2}\x{94A3}\x{94A4}\x{94A5}\x{94A6}\x{94A7}' . +'\x{94A8}\x{94A9}\x{94AA}\x{94AB}\x{94AC}\x{94AD}\x{94AE}\x{94AF}\x{94B0}' . +'\x{94B1}\x{94B2}\x{94B3}\x{94B4}\x{94B5}\x{94B6}\x{94B7}\x{94B8}\x{94B9}' . +'\x{94BA}\x{94BB}\x{94BC}\x{94BD}\x{94BE}\x{94BF}\x{94C0}\x{94C1}\x{94C2}' . +'\x{94C3}\x{94C4}\x{94C5}\x{94C6}\x{94C7}\x{94C8}\x{94C9}\x{94CA}\x{94CB}' . +'\x{94CC}\x{94CD}\x{94CE}\x{94CF}\x{94D0}\x{94D1}\x{94D2}\x{94D3}\x{94D4}' . +'\x{94D5}\x{94D6}\x{94D7}\x{94D8}\x{94D9}\x{94DA}\x{94DB}\x{94DC}\x{94DD}' . +'\x{94DE}\x{94DF}\x{94E0}\x{94E1}\x{94E2}\x{94E3}\x{94E4}\x{94E5}\x{94E6}' . +'\x{94E7}\x{94E8}\x{94E9}\x{94EA}\x{94EB}\x{94EC}\x{94ED}\x{94EE}\x{94EF}' . +'\x{94F0}\x{94F1}\x{94F2}\x{94F3}\x{94F4}\x{94F5}\x{94F6}\x{94F7}\x{94F8}' . +'\x{94F9}\x{94FA}\x{94FB}\x{94FC}\x{94FD}\x{94FE}\x{94FF}\x{9500}\x{9501}' . +'\x{9502}\x{9503}\x{9504}\x{9505}\x{9506}\x{9507}\x{9508}\x{9509}\x{950A}' . +'\x{950B}\x{950C}\x{950D}\x{950E}\x{950F}\x{9510}\x{9511}\x{9512}\x{9513}' . +'\x{9514}\x{9515}\x{9516}\x{9517}\x{9518}\x{9519}\x{951A}\x{951B}\x{951C}' . +'\x{951D}\x{951E}\x{951F}\x{9520}\x{9521}\x{9522}\x{9523}\x{9524}\x{9525}' . +'\x{9526}\x{9527}\x{9528}\x{9529}\x{952A}\x{952B}\x{952C}\x{952D}\x{952E}' . +'\x{952F}\x{9530}\x{9531}\x{9532}\x{9533}\x{9534}\x{9535}\x{9536}\x{9537}' . +'\x{9538}\x{9539}\x{953A}\x{953B}\x{953C}\x{953D}\x{953E}\x{953F}\x{9540}' . +'\x{9541}\x{9542}\x{9543}\x{9544}\x{9545}\x{9546}\x{9547}\x{9548}\x{9549}' . +'\x{954A}\x{954B}\x{954C}\x{954D}\x{954E}\x{954F}\x{9550}\x{9551}\x{9552}' . +'\x{9553}\x{9554}\x{9555}\x{9556}\x{9557}\x{9558}\x{9559}\x{955A}\x{955B}' . +'\x{955C}\x{955D}\x{955E}\x{955F}\x{9560}\x{9561}\x{9562}\x{9563}\x{9564}' . +'\x{9565}\x{9566}\x{9567}\x{9568}\x{9569}\x{956A}\x{956B}\x{956C}\x{956D}' . +'\x{956E}\x{956F}\x{9570}\x{9571}\x{9572}\x{9573}\x{9574}\x{9575}\x{9576}' . +'\x{9577}\x{957A}\x{957B}\x{957C}\x{957D}\x{957F}\x{9580}\x{9581}\x{9582}' . +'\x{9583}\x{9584}\x{9586}\x{9587}\x{9588}\x{9589}\x{958A}\x{958B}\x{958C}' . +'\x{958D}\x{958E}\x{958F}\x{9590}\x{9591}\x{9592}\x{9593}\x{9594}\x{9595}' . +'\x{9596}\x{9598}\x{9599}\x{959A}\x{959B}\x{959C}\x{959D}\x{959E}\x{959F}' . +'\x{95A1}\x{95A2}\x{95A3}\x{95A4}\x{95A5}\x{95A6}\x{95A7}\x{95A8}\x{95A9}' . +'\x{95AA}\x{95AB}\x{95AC}\x{95AD}\x{95AE}\x{95AF}\x{95B0}\x{95B1}\x{95B2}' . +'\x{95B5}\x{95B6}\x{95B7}\x{95B9}\x{95BA}\x{95BB}\x{95BC}\x{95BD}\x{95BE}' . +'\x{95BF}\x{95C0}\x{95C2}\x{95C3}\x{95C4}\x{95C5}\x{95C6}\x{95C7}\x{95C8}' . +'\x{95C9}\x{95CA}\x{95CB}\x{95CC}\x{95CD}\x{95CE}\x{95CF}\x{95D0}\x{95D1}' . +'\x{95D2}\x{95D3}\x{95D4}\x{95D5}\x{95D6}\x{95D7}\x{95D8}\x{95DA}\x{95DB}' . +'\x{95DC}\x{95DE}\x{95DF}\x{95E0}\x{95E1}\x{95E2}\x{95E3}\x{95E4}\x{95E5}' . +'\x{95E6}\x{95E7}\x{95E8}\x{95E9}\x{95EA}\x{95EB}\x{95EC}\x{95ED}\x{95EE}' . +'\x{95EF}\x{95F0}\x{95F1}\x{95F2}\x{95F3}\x{95F4}\x{95F5}\x{95F6}\x{95F7}' . +'\x{95F8}\x{95F9}\x{95FA}\x{95FB}\x{95FC}\x{95FD}\x{95FE}\x{95FF}\x{9600}' . +'\x{9601}\x{9602}\x{9603}\x{9604}\x{9605}\x{9606}\x{9607}\x{9608}\x{9609}' . +'\x{960A}\x{960B}\x{960C}\x{960D}\x{960E}\x{960F}\x{9610}\x{9611}\x{9612}' . +'\x{9613}\x{9614}\x{9615}\x{9616}\x{9617}\x{9618}\x{9619}\x{961A}\x{961B}' . +'\x{961C}\x{961D}\x{961E}\x{961F}\x{9620}\x{9621}\x{9622}\x{9623}\x{9624}' . +'\x{9627}\x{9628}\x{962A}\x{962B}\x{962C}\x{962D}\x{962E}\x{962F}\x{9630}' . +'\x{9631}\x{9632}\x{9633}\x{9634}\x{9635}\x{9636}\x{9637}\x{9638}\x{9639}' . +'\x{963A}\x{963B}\x{963C}\x{963D}\x{963F}\x{9640}\x{9641}\x{9642}\x{9643}' . +'\x{9644}\x{9645}\x{9646}\x{9647}\x{9648}\x{9649}\x{964A}\x{964B}\x{964C}' . +'\x{964D}\x{964E}\x{964F}\x{9650}\x{9651}\x{9652}\x{9653}\x{9654}\x{9655}' . +'\x{9658}\x{9659}\x{965A}\x{965B}\x{965C}\x{965D}\x{965E}\x{965F}\x{9660}' . +'\x{9661}\x{9662}\x{9663}\x{9664}\x{9666}\x{9667}\x{9668}\x{9669}\x{966A}' . +'\x{966B}\x{966C}\x{966D}\x{966E}\x{966F}\x{9670}\x{9671}\x{9672}\x{9673}' . +'\x{9674}\x{9675}\x{9676}\x{9677}\x{9678}\x{967C}\x{967D}\x{967E}\x{9680}' . +'\x{9683}\x{9684}\x{9685}\x{9686}\x{9687}\x{9688}\x{9689}\x{968A}\x{968B}' . +'\x{968D}\x{968E}\x{968F}\x{9690}\x{9691}\x{9692}\x{9693}\x{9694}\x{9695}' . +'\x{9697}\x{9698}\x{9699}\x{969B}\x{969C}\x{969E}\x{96A0}\x{96A1}\x{96A2}' . +'\x{96A3}\x{96A4}\x{96A5}\x{96A6}\x{96A7}\x{96A8}\x{96A9}\x{96AA}\x{96AC}' . +'\x{96AD}\x{96AE}\x{96B0}\x{96B1}\x{96B3}\x{96B4}\x{96B6}\x{96B7}\x{96B8}' . +'\x{96B9}\x{96BA}\x{96BB}\x{96BC}\x{96BD}\x{96BE}\x{96BF}\x{96C0}\x{96C1}' . +'\x{96C2}\x{96C3}\x{96C4}\x{96C5}\x{96C6}\x{96C7}\x{96C8}\x{96C9}\x{96CA}' . +'\x{96CB}\x{96CC}\x{96CD}\x{96CE}\x{96CF}\x{96D0}\x{96D1}\x{96D2}\x{96D3}' . +'\x{96D4}\x{96D5}\x{96D6}\x{96D7}\x{96D8}\x{96D9}\x{96DA}\x{96DB}\x{96DC}' . +'\x{96DD}\x{96DE}\x{96DF}\x{96E0}\x{96E1}\x{96E2}\x{96E3}\x{96E5}\x{96E8}' . +'\x{96E9}\x{96EA}\x{96EB}\x{96EC}\x{96ED}\x{96EE}\x{96EF}\x{96F0}\x{96F1}' . +'\x{96F2}\x{96F3}\x{96F4}\x{96F5}\x{96F6}\x{96F7}\x{96F8}\x{96F9}\x{96FA}' . +'\x{96FB}\x{96FD}\x{96FE}\x{96FF}\x{9700}\x{9701}\x{9702}\x{9703}\x{9704}' . +'\x{9705}\x{9706}\x{9707}\x{9708}\x{9709}\x{970A}\x{970B}\x{970C}\x{970D}' . +'\x{970E}\x{970F}\x{9710}\x{9711}\x{9712}\x{9713}\x{9715}\x{9716}\x{9718}' . +'\x{9719}\x{971C}\x{971D}\x{971E}\x{971F}\x{9720}\x{9721}\x{9722}\x{9723}' . +'\x{9724}\x{9725}\x{9726}\x{9727}\x{9728}\x{9729}\x{972A}\x{972B}\x{972C}' . +'\x{972D}\x{972E}\x{972F}\x{9730}\x{9731}\x{9732}\x{9735}\x{9736}\x{9738}' . +'\x{9739}\x{973A}\x{973B}\x{973C}\x{973D}\x{973E}\x{973F}\x{9742}\x{9743}' . +'\x{9744}\x{9745}\x{9746}\x{9747}\x{9748}\x{9749}\x{974A}\x{974B}\x{974C}' . +'\x{974E}\x{974F}\x{9750}\x{9751}\x{9752}\x{9753}\x{9754}\x{9755}\x{9756}' . +'\x{9758}\x{9759}\x{975A}\x{975B}\x{975C}\x{975D}\x{975E}\x{975F}\x{9760}' . +'\x{9761}\x{9762}\x{9765}\x{9766}\x{9767}\x{9768}\x{9769}\x{976A}\x{976B}' . +'\x{976C}\x{976D}\x{976E}\x{976F}\x{9770}\x{9772}\x{9773}\x{9774}\x{9776}' . +'\x{9777}\x{9778}\x{9779}\x{977A}\x{977B}\x{977C}\x{977D}\x{977E}\x{977F}' . +'\x{9780}\x{9781}\x{9782}\x{9783}\x{9784}\x{9785}\x{9786}\x{9788}\x{978A}' . +'\x{978B}\x{978C}\x{978D}\x{978E}\x{978F}\x{9790}\x{9791}\x{9792}\x{9793}' . +'\x{9794}\x{9795}\x{9796}\x{9797}\x{9798}\x{9799}\x{979A}\x{979C}\x{979D}' . +'\x{979E}\x{979F}\x{97A0}\x{97A1}\x{97A2}\x{97A3}\x{97A4}\x{97A5}\x{97A6}' . +'\x{97A7}\x{97A8}\x{97AA}\x{97AB}\x{97AC}\x{97AD}\x{97AE}\x{97AF}\x{97B2}' . +'\x{97B3}\x{97B4}\x{97B6}\x{97B7}\x{97B8}\x{97B9}\x{97BA}\x{97BB}\x{97BC}' . +'\x{97BD}\x{97BF}\x{97C1}\x{97C2}\x{97C3}\x{97C4}\x{97C5}\x{97C6}\x{97C7}' . +'\x{97C8}\x{97C9}\x{97CA}\x{97CB}\x{97CC}\x{97CD}\x{97CE}\x{97CF}\x{97D0}' . +'\x{97D1}\x{97D3}\x{97D4}\x{97D5}\x{97D6}\x{97D7}\x{97D8}\x{97D9}\x{97DA}' . +'\x{97DB}\x{97DC}\x{97DD}\x{97DE}\x{97DF}\x{97E0}\x{97E1}\x{97E2}\x{97E3}' . +'\x{97E4}\x{97E5}\x{97E6}\x{97E7}\x{97E8}\x{97E9}\x{97EA}\x{97EB}\x{97EC}' . +'\x{97ED}\x{97EE}\x{97EF}\x{97F0}\x{97F1}\x{97F2}\x{97F3}\x{97F4}\x{97F5}' . +'\x{97F6}\x{97F7}\x{97F8}\x{97F9}\x{97FA}\x{97FB}\x{97FD}\x{97FE}\x{97FF}' . +'\x{9800}\x{9801}\x{9802}\x{9803}\x{9804}\x{9805}\x{9806}\x{9807}\x{9808}' . +'\x{9809}\x{980A}\x{980B}\x{980C}\x{980D}\x{980E}\x{980F}\x{9810}\x{9811}' . +'\x{9812}\x{9813}\x{9814}\x{9815}\x{9816}\x{9817}\x{9818}\x{9819}\x{981A}' . +'\x{981B}\x{981C}\x{981D}\x{981E}\x{9820}\x{9821}\x{9822}\x{9823}\x{9824}' . +'\x{9826}\x{9827}\x{9828}\x{9829}\x{982B}\x{982D}\x{982E}\x{982F}\x{9830}' . +'\x{9831}\x{9832}\x{9834}\x{9835}\x{9836}\x{9837}\x{9838}\x{9839}\x{983B}' . +'\x{983C}\x{983D}\x{983F}\x{9840}\x{9841}\x{9843}\x{9844}\x{9845}\x{9846}' . +'\x{9848}\x{9849}\x{984A}\x{984C}\x{984D}\x{984E}\x{984F}\x{9850}\x{9851}' . +'\x{9852}\x{9853}\x{9854}\x{9855}\x{9857}\x{9858}\x{9859}\x{985A}\x{985B}' . +'\x{985C}\x{985D}\x{985E}\x{985F}\x{9860}\x{9861}\x{9862}\x{9863}\x{9864}' . +'\x{9865}\x{9867}\x{9869}\x{986A}\x{986B}\x{986C}\x{986D}\x{986E}\x{986F}' . +'\x{9870}\x{9871}\x{9872}\x{9873}\x{9874}\x{9875}\x{9876}\x{9877}\x{9878}' . +'\x{9879}\x{987A}\x{987B}\x{987C}\x{987D}\x{987E}\x{987F}\x{9880}\x{9881}' . +'\x{9882}\x{9883}\x{9884}\x{9885}\x{9886}\x{9887}\x{9888}\x{9889}\x{988A}' . +'\x{988B}\x{988C}\x{988D}\x{988E}\x{988F}\x{9890}\x{9891}\x{9892}\x{9893}' . +'\x{9894}\x{9895}\x{9896}\x{9897}\x{9898}\x{9899}\x{989A}\x{989B}\x{989C}' . +'\x{989D}\x{989E}\x{989F}\x{98A0}\x{98A1}\x{98A2}\x{98A3}\x{98A4}\x{98A5}' . +'\x{98A6}\x{98A7}\x{98A8}\x{98A9}\x{98AA}\x{98AB}\x{98AC}\x{98AD}\x{98AE}' . +'\x{98AF}\x{98B0}\x{98B1}\x{98B2}\x{98B3}\x{98B4}\x{98B5}\x{98B6}\x{98B8}' . +'\x{98B9}\x{98BA}\x{98BB}\x{98BC}\x{98BD}\x{98BE}\x{98BF}\x{98C0}\x{98C1}' . +'\x{98C2}\x{98C3}\x{98C4}\x{98C5}\x{98C6}\x{98C8}\x{98C9}\x{98CB}\x{98CC}' . +'\x{98CD}\x{98CE}\x{98CF}\x{98D0}\x{98D1}\x{98D2}\x{98D3}\x{98D4}\x{98D5}' . +'\x{98D6}\x{98D7}\x{98D8}\x{98D9}\x{98DA}\x{98DB}\x{98DC}\x{98DD}\x{98DE}' . +'\x{98DF}\x{98E0}\x{98E2}\x{98E3}\x{98E5}\x{98E6}\x{98E7}\x{98E8}\x{98E9}' . +'\x{98EA}\x{98EB}\x{98ED}\x{98EF}\x{98F0}\x{98F2}\x{98F3}\x{98F4}\x{98F5}' . +'\x{98F6}\x{98F7}\x{98F9}\x{98FA}\x{98FC}\x{98FD}\x{98FE}\x{98FF}\x{9900}' . +'\x{9901}\x{9902}\x{9903}\x{9904}\x{9905}\x{9906}\x{9907}\x{9908}\x{9909}' . +'\x{990A}\x{990B}\x{990C}\x{990D}\x{990E}\x{990F}\x{9910}\x{9911}\x{9912}' . +'\x{9913}\x{9914}\x{9915}\x{9916}\x{9917}\x{9918}\x{991A}\x{991B}\x{991C}' . +'\x{991D}\x{991E}\x{991F}\x{9920}\x{9921}\x{9922}\x{9923}\x{9924}\x{9925}' . +'\x{9926}\x{9927}\x{9928}\x{9929}\x{992A}\x{992B}\x{992C}\x{992D}\x{992E}' . +'\x{992F}\x{9930}\x{9931}\x{9932}\x{9933}\x{9934}\x{9935}\x{9936}\x{9937}' . +'\x{9938}\x{9939}\x{993A}\x{993C}\x{993D}\x{993E}\x{993F}\x{9940}\x{9941}' . +'\x{9942}\x{9943}\x{9945}\x{9946}\x{9947}\x{9948}\x{9949}\x{994A}\x{994B}' . +'\x{994C}\x{994E}\x{994F}\x{9950}\x{9951}\x{9952}\x{9953}\x{9954}\x{9955}' . +'\x{9956}\x{9957}\x{9958}\x{9959}\x{995B}\x{995C}\x{995E}\x{995F}\x{9960}' . +'\x{9961}\x{9962}\x{9963}\x{9964}\x{9965}\x{9966}\x{9967}\x{9968}\x{9969}' . +'\x{996A}\x{996B}\x{996C}\x{996D}\x{996E}\x{996F}\x{9970}\x{9971}\x{9972}' . +'\x{9973}\x{9974}\x{9975}\x{9976}\x{9977}\x{9978}\x{9979}\x{997A}\x{997B}' . +'\x{997C}\x{997D}\x{997E}\x{997F}\x{9980}\x{9981}\x{9982}\x{9983}\x{9984}' . +'\x{9985}\x{9986}\x{9987}\x{9988}\x{9989}\x{998A}\x{998B}\x{998C}\x{998D}' . +'\x{998E}\x{998F}\x{9990}\x{9991}\x{9992}\x{9993}\x{9994}\x{9995}\x{9996}' . +'\x{9997}\x{9998}\x{9999}\x{999A}\x{999B}\x{999C}\x{999D}\x{999E}\x{999F}' . +'\x{99A0}\x{99A1}\x{99A2}\x{99A3}\x{99A4}\x{99A5}\x{99A6}\x{99A7}\x{99A8}' . +'\x{99A9}\x{99AA}\x{99AB}\x{99AC}\x{99AD}\x{99AE}\x{99AF}\x{99B0}\x{99B1}' . +'\x{99B2}\x{99B3}\x{99B4}\x{99B5}\x{99B6}\x{99B7}\x{99B8}\x{99B9}\x{99BA}' . +'\x{99BB}\x{99BC}\x{99BD}\x{99BE}\x{99C0}\x{99C1}\x{99C2}\x{99C3}\x{99C4}' . +'\x{99C6}\x{99C7}\x{99C8}\x{99C9}\x{99CA}\x{99CB}\x{99CC}\x{99CD}\x{99CE}' . +'\x{99CF}\x{99D0}\x{99D1}\x{99D2}\x{99D3}\x{99D4}\x{99D5}\x{99D6}\x{99D7}' . +'\x{99D8}\x{99D9}\x{99DA}\x{99DB}\x{99DC}\x{99DD}\x{99DE}\x{99DF}\x{99E1}' . +'\x{99E2}\x{99E3}\x{99E4}\x{99E5}\x{99E7}\x{99E8}\x{99E9}\x{99EA}\x{99EC}' . +'\x{99ED}\x{99EE}\x{99EF}\x{99F0}\x{99F1}\x{99F2}\x{99F3}\x{99F4}\x{99F6}' . +'\x{99F7}\x{99F8}\x{99F9}\x{99FA}\x{99FB}\x{99FC}\x{99FD}\x{99FE}\x{99FF}' . +'\x{9A00}\x{9A01}\x{9A02}\x{9A03}\x{9A04}\x{9A05}\x{9A06}\x{9A07}\x{9A08}' . +'\x{9A09}\x{9A0A}\x{9A0B}\x{9A0C}\x{9A0D}\x{9A0E}\x{9A0F}\x{9A11}\x{9A14}' . +'\x{9A15}\x{9A16}\x{9A19}\x{9A1A}\x{9A1B}\x{9A1C}\x{9A1D}\x{9A1E}\x{9A1F}' . +'\x{9A20}\x{9A21}\x{9A22}\x{9A23}\x{9A24}\x{9A25}\x{9A26}\x{9A27}\x{9A29}' . +'\x{9A2A}\x{9A2B}\x{9A2C}\x{9A2D}\x{9A2E}\x{9A2F}\x{9A30}\x{9A31}\x{9A32}' . +'\x{9A33}\x{9A34}\x{9A35}\x{9A36}\x{9A37}\x{9A38}\x{9A39}\x{9A3A}\x{9A3C}' . +'\x{9A3D}\x{9A3E}\x{9A3F}\x{9A40}\x{9A41}\x{9A42}\x{9A43}\x{9A44}\x{9A45}' . +'\x{9A46}\x{9A47}\x{9A48}\x{9A49}\x{9A4A}\x{9A4B}\x{9A4C}\x{9A4D}\x{9A4E}' . +'\x{9A4F}\x{9A50}\x{9A52}\x{9A53}\x{9A54}\x{9A55}\x{9A56}\x{9A57}\x{9A59}' . +'\x{9A5A}\x{9A5B}\x{9A5C}\x{9A5E}\x{9A5F}\x{9A60}\x{9A61}\x{9A62}\x{9A64}' . +'\x{9A65}\x{9A66}\x{9A67}\x{9A68}\x{9A69}\x{9A6A}\x{9A6B}\x{9A6C}\x{9A6D}' . +'\x{9A6E}\x{9A6F}\x{9A70}\x{9A71}\x{9A72}\x{9A73}\x{9A74}\x{9A75}\x{9A76}' . +'\x{9A77}\x{9A78}\x{9A79}\x{9A7A}\x{9A7B}\x{9A7C}\x{9A7D}\x{9A7E}\x{9A7F}' . +'\x{9A80}\x{9A81}\x{9A82}\x{9A83}\x{9A84}\x{9A85}\x{9A86}\x{9A87}\x{9A88}' . +'\x{9A89}\x{9A8A}\x{9A8B}\x{9A8C}\x{9A8D}\x{9A8E}\x{9A8F}\x{9A90}\x{9A91}' . +'\x{9A92}\x{9A93}\x{9A94}\x{9A95}\x{9A96}\x{9A97}\x{9A98}\x{9A99}\x{9A9A}' . +'\x{9A9B}\x{9A9C}\x{9A9D}\x{9A9E}\x{9A9F}\x{9AA0}\x{9AA1}\x{9AA2}\x{9AA3}' . +'\x{9AA4}\x{9AA5}\x{9AA6}\x{9AA7}\x{9AA8}\x{9AAA}\x{9AAB}\x{9AAC}\x{9AAD}' . +'\x{9AAE}\x{9AAF}\x{9AB0}\x{9AB1}\x{9AB2}\x{9AB3}\x{9AB4}\x{9AB5}\x{9AB6}' . +'\x{9AB7}\x{9AB8}\x{9AB9}\x{9ABA}\x{9ABB}\x{9ABC}\x{9ABE}\x{9ABF}\x{9AC0}' . +'\x{9AC1}\x{9AC2}\x{9AC3}\x{9AC4}\x{9AC5}\x{9AC6}\x{9AC7}\x{9AC9}\x{9ACA}' . +'\x{9ACB}\x{9ACC}\x{9ACD}\x{9ACE}\x{9ACF}\x{9AD0}\x{9AD1}\x{9AD2}\x{9AD3}' . +'\x{9AD4}\x{9AD5}\x{9AD6}\x{9AD8}\x{9AD9}\x{9ADA}\x{9ADB}\x{9ADC}\x{9ADD}' . +'\x{9ADE}\x{9ADF}\x{9AE1}\x{9AE2}\x{9AE3}\x{9AE5}\x{9AE6}\x{9AE7}\x{9AEA}' . +'\x{9AEB}\x{9AEC}\x{9AED}\x{9AEE}\x{9AEF}\x{9AF1}\x{9AF2}\x{9AF3}\x{9AF4}' . +'\x{9AF5}\x{9AF6}\x{9AF7}\x{9AF8}\x{9AF9}\x{9AFA}\x{9AFB}\x{9AFC}\x{9AFD}' . +'\x{9AFE}\x{9AFF}\x{9B01}\x{9B03}\x{9B04}\x{9B05}\x{9B06}\x{9B07}\x{9B08}' . +'\x{9B0A}\x{9B0B}\x{9B0C}\x{9B0D}\x{9B0E}\x{9B0F}\x{9B10}\x{9B11}\x{9B12}' . +'\x{9B13}\x{9B15}\x{9B16}\x{9B17}\x{9B18}\x{9B19}\x{9B1A}\x{9B1C}\x{9B1D}' . +'\x{9B1E}\x{9B1F}\x{9B20}\x{9B21}\x{9B22}\x{9B23}\x{9B24}\x{9B25}\x{9B26}' . +'\x{9B27}\x{9B28}\x{9B29}\x{9B2A}\x{9B2B}\x{9B2C}\x{9B2D}\x{9B2E}\x{9B2F}' . +'\x{9B30}\x{9B31}\x{9B32}\x{9B33}\x{9B35}\x{9B36}\x{9B37}\x{9B38}\x{9B39}' . +'\x{9B3A}\x{9B3B}\x{9B3C}\x{9B3E}\x{9B3F}\x{9B41}\x{9B42}\x{9B43}\x{9B44}' . +'\x{9B45}\x{9B46}\x{9B47}\x{9B48}\x{9B49}\x{9B4A}\x{9B4B}\x{9B4C}\x{9B4D}' . +'\x{9B4E}\x{9B4F}\x{9B51}\x{9B52}\x{9B53}\x{9B54}\x{9B55}\x{9B56}\x{9B58}' . +'\x{9B59}\x{9B5A}\x{9B5B}\x{9B5C}\x{9B5D}\x{9B5E}\x{9B5F}\x{9B60}\x{9B61}' . +'\x{9B63}\x{9B64}\x{9B65}\x{9B66}\x{9B67}\x{9B68}\x{9B69}\x{9B6A}\x{9B6B}' . +'\x{9B6C}\x{9B6D}\x{9B6E}\x{9B6F}\x{9B70}\x{9B71}\x{9B73}\x{9B74}\x{9B75}' . +'\x{9B76}\x{9B77}\x{9B78}\x{9B79}\x{9B7A}\x{9B7B}\x{9B7C}\x{9B7D}\x{9B7E}' . +'\x{9B7F}\x{9B80}\x{9B81}\x{9B82}\x{9B83}\x{9B84}\x{9B85}\x{9B86}\x{9B87}' . +'\x{9B88}\x{9B8A}\x{9B8B}\x{9B8D}\x{9B8E}\x{9B8F}\x{9B90}\x{9B91}\x{9B92}' . +'\x{9B93}\x{9B94}\x{9B95}\x{9B96}\x{9B97}\x{9B98}\x{9B9A}\x{9B9B}\x{9B9C}' . +'\x{9B9D}\x{9B9E}\x{9B9F}\x{9BA0}\x{9BA1}\x{9BA2}\x{9BA3}\x{9BA4}\x{9BA5}' . +'\x{9BA6}\x{9BA7}\x{9BA8}\x{9BA9}\x{9BAA}\x{9BAB}\x{9BAC}\x{9BAD}\x{9BAE}' . +'\x{9BAF}\x{9BB0}\x{9BB1}\x{9BB2}\x{9BB3}\x{9BB4}\x{9BB5}\x{9BB6}\x{9BB7}' . +'\x{9BB8}\x{9BB9}\x{9BBA}\x{9BBB}\x{9BBC}\x{9BBD}\x{9BBE}\x{9BBF}\x{9BC0}' . +'\x{9BC1}\x{9BC3}\x{9BC4}\x{9BC5}\x{9BC6}\x{9BC7}\x{9BC8}\x{9BC9}\x{9BCA}' . +'\x{9BCB}\x{9BCC}\x{9BCD}\x{9BCE}\x{9BCF}\x{9BD0}\x{9BD1}\x{9BD2}\x{9BD3}' . +'\x{9BD4}\x{9BD5}\x{9BD6}\x{9BD7}\x{9BD8}\x{9BD9}\x{9BDA}\x{9BDB}\x{9BDC}' . +'\x{9BDD}\x{9BDE}\x{9BDF}\x{9BE0}\x{9BE1}\x{9BE2}\x{9BE3}\x{9BE4}\x{9BE5}' . +'\x{9BE6}\x{9BE7}\x{9BE8}\x{9BE9}\x{9BEA}\x{9BEB}\x{9BEC}\x{9BED}\x{9BEE}' . +'\x{9BEF}\x{9BF0}\x{9BF1}\x{9BF2}\x{9BF3}\x{9BF4}\x{9BF5}\x{9BF7}\x{9BF8}' . +'\x{9BF9}\x{9BFA}\x{9BFB}\x{9BFC}\x{9BFD}\x{9BFE}\x{9BFF}\x{9C02}\x{9C05}' . +'\x{9C06}\x{9C07}\x{9C08}\x{9C09}\x{9C0A}\x{9C0B}\x{9C0C}\x{9C0D}\x{9C0E}' . +'\x{9C0F}\x{9C10}\x{9C11}\x{9C12}\x{9C13}\x{9C14}\x{9C15}\x{9C16}\x{9C17}' . +'\x{9C18}\x{9C19}\x{9C1A}\x{9C1B}\x{9C1C}\x{9C1D}\x{9C1E}\x{9C1F}\x{9C20}' . +'\x{9C21}\x{9C22}\x{9C23}\x{9C24}\x{9C25}\x{9C26}\x{9C27}\x{9C28}\x{9C29}' . +'\x{9C2A}\x{9C2B}\x{9C2C}\x{9C2D}\x{9C2F}\x{9C30}\x{9C31}\x{9C32}\x{9C33}' . +'\x{9C34}\x{9C35}\x{9C36}\x{9C37}\x{9C38}\x{9C39}\x{9C3A}\x{9C3B}\x{9C3C}' . +'\x{9C3D}\x{9C3E}\x{9C3F}\x{9C40}\x{9C41}\x{9C43}\x{9C44}\x{9C45}\x{9C46}' . +'\x{9C47}\x{9C48}\x{9C49}\x{9C4A}\x{9C4B}\x{9C4C}\x{9C4D}\x{9C4E}\x{9C50}' . +'\x{9C52}\x{9C53}\x{9C54}\x{9C55}\x{9C56}\x{9C57}\x{9C58}\x{9C59}\x{9C5A}' . +'\x{9C5B}\x{9C5C}\x{9C5D}\x{9C5E}\x{9C5F}\x{9C60}\x{9C62}\x{9C63}\x{9C65}' . +'\x{9C66}\x{9C67}\x{9C68}\x{9C69}\x{9C6A}\x{9C6B}\x{9C6C}\x{9C6D}\x{9C6E}' . +'\x{9C6F}\x{9C70}\x{9C71}\x{9C72}\x{9C73}\x{9C74}\x{9C75}\x{9C77}\x{9C78}' . +'\x{9C79}\x{9C7A}\x{9C7C}\x{9C7D}\x{9C7E}\x{9C7F}\x{9C80}\x{9C81}\x{9C82}' . +'\x{9C83}\x{9C84}\x{9C85}\x{9C86}\x{9C87}\x{9C88}\x{9C89}\x{9C8A}\x{9C8B}' . +'\x{9C8C}\x{9C8D}\x{9C8E}\x{9C8F}\x{9C90}\x{9C91}\x{9C92}\x{9C93}\x{9C94}' . +'\x{9C95}\x{9C96}\x{9C97}\x{9C98}\x{9C99}\x{9C9A}\x{9C9B}\x{9C9C}\x{9C9D}' . +'\x{9C9E}\x{9C9F}\x{9CA0}\x{9CA1}\x{9CA2}\x{9CA3}\x{9CA4}\x{9CA5}\x{9CA6}' . +'\x{9CA7}\x{9CA8}\x{9CA9}\x{9CAA}\x{9CAB}\x{9CAC}\x{9CAD}\x{9CAE}\x{9CAF}' . +'\x{9CB0}\x{9CB1}\x{9CB2}\x{9CB3}\x{9CB4}\x{9CB5}\x{9CB6}\x{9CB7}\x{9CB8}' . +'\x{9CB9}\x{9CBA}\x{9CBB}\x{9CBC}\x{9CBD}\x{9CBE}\x{9CBF}\x{9CC0}\x{9CC1}' . +'\x{9CC2}\x{9CC3}\x{9CC4}\x{9CC5}\x{9CC6}\x{9CC7}\x{9CC8}\x{9CC9}\x{9CCA}' . +'\x{9CCB}\x{9CCC}\x{9CCD}\x{9CCE}\x{9CCF}\x{9CD0}\x{9CD1}\x{9CD2}\x{9CD3}' . +'\x{9CD4}\x{9CD5}\x{9CD6}\x{9CD7}\x{9CD8}\x{9CD9}\x{9CDA}\x{9CDB}\x{9CDC}' . +'\x{9CDD}\x{9CDE}\x{9CDF}\x{9CE0}\x{9CE1}\x{9CE2}\x{9CE3}\x{9CE4}\x{9CE5}' . +'\x{9CE6}\x{9CE7}\x{9CE8}\x{9CE9}\x{9CEA}\x{9CEB}\x{9CEC}\x{9CED}\x{9CEE}' . +'\x{9CEF}\x{9CF0}\x{9CF1}\x{9CF2}\x{9CF3}\x{9CF4}\x{9CF5}\x{9CF6}\x{9CF7}' . +'\x{9CF8}\x{9CF9}\x{9CFA}\x{9CFB}\x{9CFC}\x{9CFD}\x{9CFE}\x{9CFF}\x{9D00}' . +'\x{9D01}\x{9D02}\x{9D03}\x{9D04}\x{9D05}\x{9D06}\x{9D07}\x{9D08}\x{9D09}' . +'\x{9D0A}\x{9D0B}\x{9D0F}\x{9D10}\x{9D12}\x{9D13}\x{9D14}\x{9D15}\x{9D16}' . +'\x{9D17}\x{9D18}\x{9D19}\x{9D1A}\x{9D1B}\x{9D1C}\x{9D1D}\x{9D1E}\x{9D1F}' . +'\x{9D20}\x{9D21}\x{9D22}\x{9D23}\x{9D24}\x{9D25}\x{9D26}\x{9D28}\x{9D29}' . +'\x{9D2B}\x{9D2D}\x{9D2E}\x{9D2F}\x{9D30}\x{9D31}\x{9D32}\x{9D33}\x{9D34}' . +'\x{9D36}\x{9D37}\x{9D38}\x{9D39}\x{9D3A}\x{9D3B}\x{9D3D}\x{9D3E}\x{9D3F}' . +'\x{9D40}\x{9D41}\x{9D42}\x{9D43}\x{9D45}\x{9D46}\x{9D47}\x{9D48}\x{9D49}' . +'\x{9D4A}\x{9D4B}\x{9D4C}\x{9D4D}\x{9D4E}\x{9D4F}\x{9D50}\x{9D51}\x{9D52}' . +'\x{9D53}\x{9D54}\x{9D55}\x{9D56}\x{9D57}\x{9D58}\x{9D59}\x{9D5A}\x{9D5B}' . +'\x{9D5C}\x{9D5D}\x{9D5E}\x{9D5F}\x{9D60}\x{9D61}\x{9D62}\x{9D63}\x{9D64}' . +'\x{9D65}\x{9D66}\x{9D67}\x{9D68}\x{9D69}\x{9D6A}\x{9D6B}\x{9D6C}\x{9D6E}' . +'\x{9D6F}\x{9D70}\x{9D71}\x{9D72}\x{9D73}\x{9D74}\x{9D75}\x{9D76}\x{9D77}' . +'\x{9D78}\x{9D79}\x{9D7A}\x{9D7B}\x{9D7C}\x{9D7D}\x{9D7E}\x{9D7F}\x{9D80}' . +'\x{9D81}\x{9D82}\x{9D83}\x{9D84}\x{9D85}\x{9D86}\x{9D87}\x{9D88}\x{9D89}' . +'\x{9D8A}\x{9D8B}\x{9D8C}\x{9D8D}\x{9D8E}\x{9D90}\x{9D91}\x{9D92}\x{9D93}' . +'\x{9D94}\x{9D96}\x{9D97}\x{9D98}\x{9D99}\x{9D9A}\x{9D9B}\x{9D9C}\x{9D9D}' . +'\x{9D9E}\x{9D9F}\x{9DA0}\x{9DA1}\x{9DA2}\x{9DA3}\x{9DA4}\x{9DA5}\x{9DA6}' . +'\x{9DA7}\x{9DA8}\x{9DA9}\x{9DAA}\x{9DAB}\x{9DAC}\x{9DAD}\x{9DAF}\x{9DB0}' . +'\x{9DB1}\x{9DB2}\x{9DB3}\x{9DB4}\x{9DB5}\x{9DB6}\x{9DB7}\x{9DB8}\x{9DB9}' . +'\x{9DBA}\x{9DBB}\x{9DBC}\x{9DBE}\x{9DBF}\x{9DC1}\x{9DC2}\x{9DC3}\x{9DC4}' . +'\x{9DC5}\x{9DC7}\x{9DC8}\x{9DC9}\x{9DCA}\x{9DCB}\x{9DCC}\x{9DCD}\x{9DCE}' . +'\x{9DCF}\x{9DD0}\x{9DD1}\x{9DD2}\x{9DD3}\x{9DD4}\x{9DD5}\x{9DD6}\x{9DD7}' . +'\x{9DD8}\x{9DD9}\x{9DDA}\x{9DDB}\x{9DDC}\x{9DDD}\x{9DDE}\x{9DDF}\x{9DE0}' . +'\x{9DE1}\x{9DE2}\x{9DE3}\x{9DE4}\x{9DE5}\x{9DE6}\x{9DE7}\x{9DE8}\x{9DE9}' . +'\x{9DEB}\x{9DEC}\x{9DED}\x{9DEE}\x{9DEF}\x{9DF0}\x{9DF1}\x{9DF2}\x{9DF3}' . +'\x{9DF4}\x{9DF5}\x{9DF6}\x{9DF7}\x{9DF8}\x{9DF9}\x{9DFA}\x{9DFB}\x{9DFD}' . +'\x{9DFE}\x{9DFF}\x{9E00}\x{9E01}\x{9E02}\x{9E03}\x{9E04}\x{9E05}\x{9E06}' . +'\x{9E07}\x{9E08}\x{9E09}\x{9E0A}\x{9E0B}\x{9E0C}\x{9E0D}\x{9E0F}\x{9E10}' . +'\x{9E11}\x{9E12}\x{9E13}\x{9E14}\x{9E15}\x{9E17}\x{9E18}\x{9E19}\x{9E1A}' . +'\x{9E1B}\x{9E1D}\x{9E1E}\x{9E1F}\x{9E20}\x{9E21}\x{9E22}\x{9E23}\x{9E24}' . +'\x{9E25}\x{9E26}\x{9E27}\x{9E28}\x{9E29}\x{9E2A}\x{9E2B}\x{9E2C}\x{9E2D}' . +'\x{9E2E}\x{9E2F}\x{9E30}\x{9E31}\x{9E32}\x{9E33}\x{9E34}\x{9E35}\x{9E36}' . +'\x{9E37}\x{9E38}\x{9E39}\x{9E3A}\x{9E3B}\x{9E3C}\x{9E3D}\x{9E3E}\x{9E3F}' . +'\x{9E40}\x{9E41}\x{9E42}\x{9E43}\x{9E44}\x{9E45}\x{9E46}\x{9E47}\x{9E48}' . +'\x{9E49}\x{9E4A}\x{9E4B}\x{9E4C}\x{9E4D}\x{9E4E}\x{9E4F}\x{9E50}\x{9E51}' . +'\x{9E52}\x{9E53}\x{9E54}\x{9E55}\x{9E56}\x{9E57}\x{9E58}\x{9E59}\x{9E5A}' . +'\x{9E5B}\x{9E5C}\x{9E5D}\x{9E5E}\x{9E5F}\x{9E60}\x{9E61}\x{9E62}\x{9E63}' . +'\x{9E64}\x{9E65}\x{9E66}\x{9E67}\x{9E68}\x{9E69}\x{9E6A}\x{9E6B}\x{9E6C}' . +'\x{9E6D}\x{9E6E}\x{9E6F}\x{9E70}\x{9E71}\x{9E72}\x{9E73}\x{9E74}\x{9E75}' . +'\x{9E76}\x{9E77}\x{9E79}\x{9E7A}\x{9E7C}\x{9E7D}\x{9E7E}\x{9E7F}\x{9E80}' . +'\x{9E81}\x{9E82}\x{9E83}\x{9E84}\x{9E85}\x{9E86}\x{9E87}\x{9E88}\x{9E89}' . +'\x{9E8A}\x{9E8B}\x{9E8C}\x{9E8D}\x{9E8E}\x{9E91}\x{9E92}\x{9E93}\x{9E94}' . +'\x{9E96}\x{9E97}\x{9E99}\x{9E9A}\x{9E9B}\x{9E9C}\x{9E9D}\x{9E9F}\x{9EA0}' . +'\x{9EA1}\x{9EA3}\x{9EA4}\x{9EA5}\x{9EA6}\x{9EA7}\x{9EA8}\x{9EA9}\x{9EAA}' . +'\x{9EAD}\x{9EAE}\x{9EAF}\x{9EB0}\x{9EB2}\x{9EB3}\x{9EB4}\x{9EB5}\x{9EB6}' . +'\x{9EB7}\x{9EB8}\x{9EBB}\x{9EBC}\x{9EBD}\x{9EBE}\x{9EBF}\x{9EC0}\x{9EC1}' . +'\x{9EC2}\x{9EC3}\x{9EC4}\x{9EC5}\x{9EC6}\x{9EC7}\x{9EC8}\x{9EC9}\x{9ECA}' . +'\x{9ECB}\x{9ECC}\x{9ECD}\x{9ECE}\x{9ECF}\x{9ED0}\x{9ED1}\x{9ED2}\x{9ED3}' . +'\x{9ED4}\x{9ED5}\x{9ED6}\x{9ED7}\x{9ED8}\x{9ED9}\x{9EDA}\x{9EDB}\x{9EDC}' . +'\x{9EDD}\x{9EDE}\x{9EDF}\x{9EE0}\x{9EE1}\x{9EE2}\x{9EE3}\x{9EE4}\x{9EE5}' . +'\x{9EE6}\x{9EE7}\x{9EE8}\x{9EE9}\x{9EEA}\x{9EEB}\x{9EED}\x{9EEE}\x{9EEF}' . +'\x{9EF0}\x{9EF2}\x{9EF3}\x{9EF4}\x{9EF5}\x{9EF6}\x{9EF7}\x{9EF8}\x{9EF9}' . +'\x{9EFA}\x{9EFB}\x{9EFC}\x{9EFD}\x{9EFE}\x{9EFF}\x{9F00}\x{9F01}\x{9F02}' . +'\x{9F04}\x{9F05}\x{9F06}\x{9F07}\x{9F08}\x{9F09}\x{9F0A}\x{9F0B}\x{9F0C}' . +'\x{9F0D}\x{9F0E}\x{9F0F}\x{9F10}\x{9F12}\x{9F13}\x{9F15}\x{9F16}\x{9F17}' . +'\x{9F18}\x{9F19}\x{9F1A}\x{9F1B}\x{9F1C}\x{9F1D}\x{9F1E}\x{9F1F}\x{9F20}' . +'\x{9F22}\x{9F23}\x{9F24}\x{9F25}\x{9F27}\x{9F28}\x{9F29}\x{9F2A}\x{9F2B}' . +'\x{9F2C}\x{9F2D}\x{9F2E}\x{9F2F}\x{9F30}\x{9F31}\x{9F32}\x{9F33}\x{9F34}' . +'\x{9F35}\x{9F36}\x{9F37}\x{9F38}\x{9F39}\x{9F3A}\x{9F3B}\x{9F3C}\x{9F3D}' . +'\x{9F3E}\x{9F3F}\x{9F40}\x{9F41}\x{9F42}\x{9F43}\x{9F44}\x{9F46}\x{9F47}' . +'\x{9F48}\x{9F49}\x{9F4A}\x{9F4B}\x{9F4C}\x{9F4D}\x{9F4E}\x{9F4F}\x{9F50}' . +'\x{9F51}\x{9F52}\x{9F54}\x{9F55}\x{9F56}\x{9F57}\x{9F58}\x{9F59}\x{9F5A}' . +'\x{9F5B}\x{9F5C}\x{9F5D}\x{9F5E}\x{9F5F}\x{9F60}\x{9F61}\x{9F63}\x{9F64}' . +'\x{9F65}\x{9F66}\x{9F67}\x{9F68}\x{9F69}\x{9F6A}\x{9F6B}\x{9F6C}\x{9F6E}' . +'\x{9F6F}\x{9F70}\x{9F71}\x{9F72}\x{9F73}\x{9F74}\x{9F75}\x{9F76}\x{9F77}' . +'\x{9F78}\x{9F79}\x{9F7A}\x{9F7B}\x{9F7C}\x{9F7D}\x{9F7E}\x{9F7F}\x{9F80}' . +'\x{9F81}\x{9F82}\x{9F83}\x{9F84}\x{9F85}\x{9F86}\x{9F87}\x{9F88}\x{9F89}' . +'\x{9F8A}\x{9F8B}\x{9F8C}\x{9F8D}\x{9F8E}\x{9F8F}\x{9F90}\x{9F91}\x{9F92}' . +'\x{9F93}\x{9F94}\x{9F95}\x{9F96}\x{9F97}\x{9F98}\x{9F99}\x{9F9A}\x{9F9B}' . +'\x{9F9C}\x{9F9D}\x{9F9E}\x{9F9F}\x{9FA0}\x{9FA2}\x{9FA4}\x{9FA5}]{1,20}$/iu'); diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Com.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Com.php new file mode 100644 index 0000000..4b678d5 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Com.php @@ -0,0 +1,196 @@ + '/^[\x{002d}0-9\x{0400}-\x{052f}]{1,63}$/iu', + 2 => '/^[\x{002d}0-9\x{0370}-\x{03ff}]{1,63}$/iu', + 3 => '/^[\x{002d}0-9a-z\x{ac00}-\x{d7a3}]{1,17}$/iu', + 4 => '/^[\x{002d}0-9a-z·à-öø-ÿāăąćĉċčďđēĕėęěĝğġģĥħĩīĭįıĵķĸĺļľłńņňŋōŏőœŕŗřśŝşšţťŧũūŭůűųŵŷźżž]{1,63}$/iu', + 5 => '/^[\x{002d}0-9A-Za-z\x{3400}-\x{3401}\x{3404}-\x{3406}\x{340C}\x{3416}\x{341C}' . +'\x{3421}\x{3424}\x{3428}-\x{3429}\x{342B}-\x{342E}\x{3430}-\x{3434}\x{3436}' . +'\x{3438}-\x{343C}\x{343E}\x{3441}-\x{3445}\x{3447}\x{3449}-\x{3451}\x{3453}' . +'\x{3457}-\x{345F}\x{3463}-\x{3467}\x{346E}-\x{3471}\x{3473}-\x{3477}\x{3479}-\x{348E}\x{3491}-\x{3497}' . +'\x{3499}-\x{34A1}\x{34A4}-\x{34AD}\x{34AF}-\x{34B0}\x{34B2}-\x{34BF}\x{34C2}-\x{34C5}\x{34C7}-\x{34CC}' . +'\x{34CE}-\x{34D1}\x{34D3}-\x{34D8}\x{34DA}-\x{34E4}\x{34E7}-\x{34E9}\x{34EC}-\x{34EF}\x{34F1}-\x{34FE}' . +'\x{3500}-\x{3507}\x{350A}-\x{3513}\x{3515}\x{3517}-\x{351A}\x{351C}-\x{351E}\x{3520}-\x{352A}' . +'\x{352C}-\x{3552}\x{3554}-\x{355C}\x{355E}-\x{3567}\x{3569}-\x{3573}\x{3575}-\x{357C}\x{3580}-\x{3588}' . +'\x{358F}-\x{3598}\x{359E}-\x{35AB}\x{35B4}-\x{35CD}\x{35D0}\x{35D3}-\x{35DC}\x{35E2}-\x{35ED}' . +'\x{35F0}-\x{35F6}\x{35FB}-\x{3602}\x{3605}-\x{360E}\x{3610}-\x{3611}\x{3613}-\x{3616}\x{3619}-\x{362D}' . +'\x{362F}-\x{3634}\x{3636}-\x{363B}\x{363F}-\x{3645}\x{3647}-\x{364B}\x{364D}-\x{3653}\x{3655}' . +'\x{3659}-\x{365E}\x{3660}-\x{3665}\x{3667}-\x{367C}\x{367E}\x{3680}-\x{3685}\x{3687}' . +'\x{3689}-\x{3690}\x{3692}-\x{3698}\x{369A}\x{369C}-\x{36AE}\x{36B0}-\x{36BF}\x{36C1}-\x{36C5}' . +'\x{36C9}-\x{36CA}\x{36CD}-\x{36DE}\x{36E1}-\x{36E2}\x{36E5}-\x{36FE}\x{3701}-\x{3713}\x{3715}-\x{371E}' . +'\x{3720}-\x{372C}\x{372E}-\x{3745}\x{3747}-\x{3748}\x{374A}\x{374C}-\x{3759}\x{375B}-\x{3760}' . +'\x{3762}-\x{3767}\x{3769}-\x{3772}\x{3774}-\x{378C}\x{378F}-\x{379C}\x{379F}\x{37A1}-\x{37AD}' . +'\x{37AF}-\x{37B7}\x{37B9}-\x{37C1}\x{37C3}-\x{37C5}\x{37C7}-\x{37D4}\x{37D6}-\x{37E0}\x{37E2}' . +'\x{37E5}-\x{37ED}\x{37EF}-\x{37F6}\x{37F8}-\x{3802}\x{3804}-\x{381D}\x{3820}-\x{3822}\x{3825}-\x{382A}' . +'\x{382D}-\x{382F}\x{3831}-\x{3832}\x{3834}-\x{384C}\x{384E}-\x{3860}\x{3862}-\x{3863}\x{3865}-\x{386B}' . +'\x{386D}-\x{3886}\x{3888}-\x{38A1}\x{38A3}\x{38A5}-\x{38AA}\x{38AC}\x{38AE}-\x{38B0}' . +'\x{38B2}-\x{38B6}\x{38B8}\x{38BA}-\x{38BE}\x{38C0}-\x{38C9}\x{38CB}-\x{38D4}\x{38D8}-\x{38E0}' . +'\x{38E2}-\x{38E6}\x{38EB}-\x{38ED}\x{38EF}-\x{38F2}\x{38F5}-\x{38F7}\x{38FA}-\x{38FF}\x{3901}-\x{392A}' . +'\x{392C}\x{392E}-\x{393B}\x{393E}-\x{3956}\x{395A}-\x{3969}\x{396B}-\x{397A}\x{397C}-\x{3987}' . +'\x{3989}-\x{3998}\x{399A}-\x{39B0}\x{39B2}\x{39B4}-\x{39D0}\x{39D2}-\x{39DA}\x{39DE}-\x{39DF}' . +'\x{39E1}-\x{39EF}\x{39F1}-\x{3A17}\x{3A19}-\x{3A2A}\x{3A2D}-\x{3A40}\x{3A43}-\x{3A4E}\x{3A50}' . +'\x{3A52}-\x{3A5E}\x{3A60}-\x{3A6D}\x{3A6F}-\x{3A77}\x{3A79}-\x{3A82}\x{3A84}-\x{3A85}\x{3A87}-\x{3A89}' . +'\x{3A8B}-\x{3A8F}\x{3A91}-\x{3A93}\x{3A95}-\x{3A96}\x{3A9A}\x{3A9C}-\x{3AA6}\x{3AA8}-\x{3AA9}' . +'\x{3AAB}-\x{3AB1}\x{3AB4}-\x{3ABC}\x{3ABE}-\x{3AC5}\x{3ACA}-\x{3ACB}\x{3ACD}-\x{3AD5}\x{3AD7}-\x{3AE1}' . +'\x{3AE4}-\x{3AE7}\x{3AE9}-\x{3AEC}\x{3AEE}-\x{3AFD}\x{3B01}-\x{3B10}\x{3B12}-\x{3B15}\x{3B17}-\x{3B1E}' . +'\x{3B20}-\x{3B23}\x{3B25}-\x{3B27}\x{3B29}-\x{3B36}\x{3B38}-\x{3B39}\x{3B3B}-\x{3B3C}\x{3B3F}' . +'\x{3B41}-\x{3B44}\x{3B47}-\x{3B4C}\x{3B4E}\x{3B51}-\x{3B55}\x{3B58}-\x{3B62}\x{3B68}-\x{3B72}' . +'\x{3B78}-\x{3B88}\x{3B8B}-\x{3B9F}\x{3BA1}\x{3BA3}-\x{3BBA}\x{3BBC}\x{3BBF}-\x{3BD0}' . +'\x{3BD3}-\x{3BE6}\x{3BEA}-\x{3BFB}\x{3BFE}-\x{3C12}\x{3C14}-\x{3C1B}\x{3C1D}-\x{3C37}\x{3C39}-\x{3C4F}' . +'\x{3C52}\x{3C54}-\x{3C5C}\x{3C5E}-\x{3C68}\x{3C6A}-\x{3C76}\x{3C78}-\x{3C8F}\x{3C91}-\x{3CA8}' . +'\x{3CAA}-\x{3CAD}\x{3CAF}-\x{3CBE}\x{3CC0}-\x{3CC8}\x{3CCA}-\x{3CD3}\x{3CD6}-\x{3CE0}\x{3CE4}-\x{3CEE}' . +'\x{3CF3}-\x{3D0A}\x{3D0E}-\x{3D1E}\x{3D20}-\x{3D21}\x{3D25}-\x{3D38}\x{3D3B}-\x{3D46}\x{3D4A}-\x{3D59}' . +'\x{3D5D}-\x{3D7B}\x{3D7D}-\x{3D81}\x{3D84}-\x{3D88}\x{3D8C}-\x{3D8F}\x{3D91}-\x{3D98}\x{3D9A}-\x{3D9C}' . +'\x{3D9E}-\x{3DA1}\x{3DA3}-\x{3DB0}\x{3DB2}-\x{3DB5}\x{3DB9}-\x{3DBC}\x{3DBE}-\x{3DCB}\x{3DCD}-\x{3DDB}' . +'\x{3DDF}-\x{3DE8}\x{3DEB}-\x{3DF0}\x{3DF3}-\x{3DF9}\x{3DFB}-\x{3DFC}\x{3DFE}-\x{3E05}\x{3E08}-\x{3E33}' . +'\x{3E35}-\x{3E3E}\x{3E40}-\x{3E47}\x{3E49}-\x{3E67}\x{3E6B}-\x{3E6F}\x{3E71}-\x{3E85}\x{3E87}-\x{3E8C}' . +'\x{3E8E}-\x{3E98}\x{3E9A}-\x{3EA1}\x{3EA3}-\x{3EAE}\x{3EB0}-\x{3EB5}\x{3EB7}-\x{3EBA}\x{3EBD}' . +'\x{3EBF}-\x{3EC4}\x{3EC7}-\x{3ECE}\x{3ED1}-\x{3ED7}\x{3ED9}-\x{3EDA}\x{3EDD}-\x{3EE3}\x{3EE7}-\x{3EE8}' . +'\x{3EEB}-\x{3EF2}\x{3EF5}-\x{3EFF}\x{3F01}-\x{3F02}\x{3F04}-\x{3F07}\x{3F09}-\x{3F44}\x{3F46}-\x{3F4E}' . +'\x{3F50}-\x{3F53}\x{3F55}-\x{3F72}\x{3F74}-\x{3F75}\x{3F77}-\x{3F7B}\x{3F7D}-\x{3FB0}\x{3FB6}-\x{3FBF}' . +'\x{3FC1}-\x{3FCF}\x{3FD1}-\x{3FD3}\x{3FD5}-\x{3FDF}\x{3FE1}-\x{400B}\x{400D}-\x{401C}\x{401E}-\x{4024}' . +'\x{4027}-\x{403F}\x{4041}-\x{4060}\x{4062}-\x{4069}\x{406B}-\x{408A}\x{408C}-\x{40A7}\x{40A9}-\x{40B4}' . +'\x{40B6}-\x{40C2}\x{40C7}-\x{40CF}\x{40D1}-\x{40DE}\x{40E0}-\x{40E7}\x{40E9}-\x{40EE}\x{40F0}-\x{40FB}' . +'\x{40FD}-\x{4109}\x{410B}-\x{4115}\x{4118}-\x{411D}\x{411F}-\x{4122}\x{4124}-\x{4133}\x{4136}-\x{4138}' . +'\x{413A}-\x{4148}\x{414A}-\x{4169}\x{416C}-\x{4185}\x{4188}-\x{418B}\x{418D}-\x{41AD}\x{41AF}-\x{41B3}' . +'\x{41B5}-\x{41C3}\x{41C5}-\x{41C9}\x{41CB}-\x{41F2}\x{41F5}-\x{41FE}\x{4200}-\x{4227}\x{422A}-\x{4246}' . +'\x{4248}-\x{4263}\x{4265}-\x{428B}\x{428D}-\x{42A1}\x{42A3}-\x{42C4}\x{42C8}-\x{42DC}\x{42DE}-\x{430A}' . +'\x{430C}-\x{4335}\x{4337}\x{4342}-\x{435F}\x{4361}-\x{439A}\x{439C}-\x{439D}\x{439F}-\x{43A4}' . +'\x{43A6}-\x{43EC}\x{43EF}-\x{4405}\x{4407}-\x{4429}\x{442B}-\x{4455}\x{4457}-\x{4468}\x{446A}-\x{446D}' . +'\x{446F}-\x{4476}\x{4479}-\x{447D}\x{447F}-\x{4486}\x{4488}-\x{4490}\x{4492}-\x{4498}\x{449A}-\x{44AD}' . +'\x{44B0}-\x{44BD}\x{44C1}-\x{44D3}\x{44D6}-\x{44E7}\x{44EA}\x{44EC}-\x{44FA}\x{44FC}-\x{4541}' . +'\x{4543}-\x{454F}\x{4551}-\x{4562}\x{4564}-\x{4575}\x{4577}-\x{45AB}\x{45AD}-\x{45BD}\x{45BF}-\x{45D5}' . +'\x{45D7}-\x{45EC}\x{45EE}-\x{45F2}\x{45F4}-\x{45FA}\x{45FC}-\x{461A}\x{461C}-\x{461D}\x{461F}-\x{4631}' . +'\x{4633}-\x{4649}\x{464C}\x{464E}-\x{4652}\x{4654}-\x{466A}\x{466C}-\x{4675}\x{4677}-\x{467A}' . +'\x{467C}-\x{4694}\x{4696}-\x{46A3}\x{46A5}-\x{46AB}\x{46AD}-\x{46D2}\x{46D4}-\x{4723}\x{4729}-\x{4732}' . +'\x{4734}-\x{4758}\x{475A}\x{475C}-\x{478B}\x{478D}\x{4791}-\x{47B1}\x{47B3}-\x{47F1}' . +'\x{47F3}-\x{480B}\x{480D}-\x{4815}\x{4817}-\x{4839}\x{483B}-\x{4870}\x{4872}-\x{487A}\x{487C}-\x{487F}' . +'\x{4883}-\x{488E}\x{4890}-\x{4896}\x{4899}-\x{48A2}\x{48A4}-\x{48B9}\x{48BB}-\x{48C8}\x{48CA}-\x{48D1}' . +'\x{48D3}-\x{48E5}\x{48E7}-\x{48F2}\x{48F4}-\x{48FF}\x{4901}-\x{4922}\x{4924}-\x{4928}\x{492A}-\x{4931}' . +'\x{4933}-\x{495B}\x{495D}-\x{4978}\x{497A}\x{497D}\x{4982}-\x{4983}\x{4985}-\x{49A8}' . +'\x{49AA}-\x{49AF}\x{49B1}-\x{49B7}\x{49B9}-\x{49BD}\x{49C1}-\x{49C7}\x{49C9}-\x{49CE}\x{49D0}-\x{49E8}' . +'\x{49EA}\x{49EC}\x{49EE}-\x{4A19}\x{4A1B}-\x{4A43}\x{4A45}-\x{4A4D}\x{4A4F}-\x{4A9E}' . +'\x{4AA0}-\x{4AA9}\x{4AAB}-\x{4B4E}\x{4B50}-\x{4B5B}\x{4B5D}-\x{4B69}\x{4B6B}-\x{4BC2}\x{4BC6}-\x{4BE8}' . +'\x{4BEA}-\x{4BFA}\x{4BFC}-\x{4C06}\x{4C08}-\x{4C2D}\x{4C2F}-\x{4C32}\x{4C34}-\x{4C35}\x{4C37}-\x{4C69}' . +'\x{4C6B}-\x{4C73}\x{4C75}-\x{4C86}\x{4C88}-\x{4C97}\x{4C99}-\x{4C9C}\x{4C9F}-\x{4CA3}\x{4CA5}-\x{4CB5}' . +'\x{4CB7}-\x{4CF8}\x{4CFA}-\x{4D27}\x{4D29}-\x{4DAC}\x{4DAE}-\x{4DB1}\x{4DB3}-\x{4DB5}\x{4E00}-\x{4E54}' . +'\x{4E56}-\x{4E89}\x{4E8B}-\x{4EEC}\x{4EEE}-\x{4FAC}\x{4FAE}-\x{503C}\x{503E}-\x{51E5}\x{51E7}-\x{5270}' . +'\x{5272}-\x{56A1}\x{56A3}-\x{5840}\x{5842}-\x{58B5}\x{58B7}-\x{58CB}\x{58CD}-\x{5BC8}\x{5BCA}-\x{5C01}' . +'\x{5C03}-\x{5C25}\x{5C27}-\x{5D5B}\x{5D5D}-\x{5F08}\x{5F0A}-\x{61F3}\x{61F5}-\x{63BA}\x{63BC}-\x{6441}' . +'\x{6443}-\x{657C}\x{657E}-\x{663E}\x{6640}-\x{66FC}\x{66FE}-\x{6728}\x{672A}-\x{6766}\x{6768}-\x{67A8}' . +'\x{67AA}-\x{685B}\x{685D}-\x{685E}\x{6860}-\x{68B9}\x{68BB}-\x{6AC8}\x{6ACA}-\x{6BB0}\x{6BB2}-\x{6C16}' . +'\x{6C18}-\x{6D9B}\x{6D9D}-\x{6E12}\x{6E14}-\x{6E8B}\x{6E8D}-\x{704D}\x{704F}-\x{7113}\x{7115}-\x{713B}' . +'\x{713D}-\x{7154}\x{7156}-\x{729F}\x{72A1}-\x{731E}\x{7320}-\x{7362}\x{7364}-\x{7533}\x{7535}-\x{7551}' . +'\x{7553}-\x{7572}\x{7574}-\x{75E8}\x{75EA}-\x{7679}\x{767B}-\x{783E}\x{7840}-\x{7A62}\x{7A64}-\x{7AC2}' . +'\x{7AC4}-\x{7B06}\x{7B08}-\x{7B79}\x{7B7B}-\x{7BCE}\x{7BD0}-\x{7D99}\x{7D9B}-\x{7E49}\x{7E4C}-\x{8132}' . +'\x{8134}\x{8136}-\x{81D2}\x{81D4}-\x{8216}\x{8218}-\x{822D}\x{822F}-\x{83B4}\x{83B6}-\x{841F}' . +'\x{8421}-\x{86CC}\x{86CE}-\x{874A}\x{874C}-\x{877E}\x{8780}-\x{8A32}\x{8A34}-\x{8B71}\x{8B73}-\x{8B8E}' . +'\x{8B90}-\x{8DE4}\x{8DE6}-\x{8E9A}\x{8E9C}-\x{8EE1}\x{8EE4}-\x{8F0B}\x{8F0D}-\x{8FB9}\x{8FBB}-\x{9038}' . +'\x{903A}-\x{9196}\x{9198}-\x{91A3}\x{91A5}-\x{91B7}\x{91B9}-\x{91C7}\x{91C9}-\x{91E0}\x{91E2}-\x{91FB}' . +'\x{91FD}-\x{922B}\x{922D}-\x{9270}\x{9272}-\x{9420}\x{9422}-\x{9664}\x{9666}-\x{9679}\x{967B}-\x{9770}' . +'\x{9772}-\x{982B}\x{982D}-\x{98ED}\x{98EF}-\x{99C4}\x{99C6}-\x{9A11}\x{9A14}-\x{9A27}\x{9A29}-\x{9D0D}' . +'\x{9D0F}-\x{9D2B}\x{9D2D}-\x{9D8E}\x{9D90}-\x{9DC5}\x{9DC7}-\x{9E77}\x{9E79}-\x{9EB8}\x{9EBB}-\x{9F20}' . +'\x{9F22}-\x{9F61}\x{9F63}-\x{9FA5}\x{FA28}]{1,20}$/iu', + 6 => '/^[\x{002d}0-9A-Za-z]{1,63}$/iu', + 7 => '/^[\x{00A1}-\x{00FF}]{1,63}$/iu', + 8 => '/^[\x{0100}-\x{017f}]{1,63}$/iu', + 9 => '/^[\x{0180}-\x{024f}]{1,63}$/iu', + 10 => '/^[\x{0250}-\x{02af}]{1,63}$/iu', + 11 => '/^[\x{02b0}-\x{02ff}]{1,63}$/iu', + 12 => '/^[\x{0300}-\x{036f}]{1,63}$/iu', + 13 => '/^[\x{0370}-\x{03ff}]{1,63}$/iu', + 14 => '/^[\x{0400}-\x{04ff}]{1,63}$/iu', + 15 => '/^[\x{0500}-\x{052f}]{1,63}$/iu', + 16 => '/^[\x{0530}-\x{058F}]{1,63}$/iu', + 17 => '/^[\x{0590}-\x{05FF}]{1,63}$/iu', + 18 => '/^[\x{0600}-\x{06FF}]{1,63}$/iu', + 19 => '/^[\x{0700}-\x{074F}]{1,63}$/iu', + 20 => '/^[\x{0780}-\x{07BF}]{1,63}$/iu', + 21 => '/^[\x{0900}-\x{097F}]{1,63}$/iu', + 22 => '/^[\x{0980}-\x{09FF}]{1,63}$/iu', + 23 => '/^[\x{0A00}-\x{0A7F}]{1,63}$/iu', + 24 => '/^[\x{0A80}-\x{0AFF}]{1,63}$/iu', + 25 => '/^[\x{0B00}-\x{0B7F}]{1,63}$/iu', + 26 => '/^[\x{0B80}-\x{0BFF}]{1,63}$/iu', + 27 => '/^[\x{0C00}-\x{0C7F}]{1,63}$/iu', + 28 => '/^[\x{0C80}-\x{0CFF}]{1,63}$/iu', + 29 => '/^[\x{0D00}-\x{0D7F}]{1,63}$/iu', + 30 => '/^[\x{0D80}-\x{0DFF}]{1,63}$/iu', + 31 => '/^[\x{0E00}-\x{0E7F}]{1,63}$/iu', + 32 => '/^[\x{0E80}-\x{0EFF}]{1,63}$/iu', + 33 => '/^[\x{0F00}-\x{0FFF}]{1,63}$/iu', + 34 => '/^[\x{1000}-\x{109F}]{1,63}$/iu', + 35 => '/^[\x{10A0}-\x{10FF}]{1,63}$/iu', + 36 => '/^[\x{1100}-\x{11FF}]{1,63}$/iu', + 37 => '/^[\x{1200}-\x{137F}]{1,63}$/iu', + 38 => '/^[\x{13A0}-\x{13FF}]{1,63}$/iu', + 39 => '/^[\x{1400}-\x{167F}]{1,63}$/iu', + 40 => '/^[\x{1680}-\x{169F}]{1,63}$/iu', + 41 => '/^[\x{16A0}-\x{16FF}]{1,63}$/iu', + 42 => '/^[\x{1700}-\x{171F}]{1,63}$/iu', + 43 => '/^[\x{1720}-\x{173F}]{1,63}$/iu', + 44 => '/^[\x{1740}-\x{175F}]{1,63}$/iu', + 45 => '/^[\x{1760}-\x{177F}]{1,63}$/iu', + 46 => '/^[\x{1780}-\x{17FF}]{1,63}$/iu', + 47 => '/^[\x{1800}-\x{18AF}]{1,63}$/iu', + 48 => '/^[\x{1E00}-\x{1EFF}]{1,63}$/iu', + 49 => '/^[\x{1F00}-\x{1FFF}]{1,63}$/iu', + 50 => '/^[\x{2070}-\x{209F}]{1,63}$/iu', + 51 => '/^[\x{2100}-\x{214F}]{1,63}$/iu', + 52 => '/^[\x{2150}-\x{218F}]{1,63}$/iu', + 53 => '/^[\x{2460}-\x{24FF}]{1,63}$/iu', + 54 => '/^[\x{2E80}-\x{2EFF}]{1,63}$/iu', + 55 => '/^[\x{2F00}-\x{2FDF}]{1,63}$/iu', + 56 => '/^[\x{2FF0}-\x{2FFF}]{1,63}$/iu', + 57 => '/^[\x{3040}-\x{309F}]{1,63}$/iu', + 58 => '/^[\x{30A0}-\x{30FF}]{1,63}$/iu', + 59 => '/^[\x{3100}-\x{312F}]{1,63}$/iu', + 60 => '/^[\x{3130}-\x{318F}]{1,63}$/iu', + 61 => '/^[\x{3190}-\x{319F}]{1,63}$/iu', + 62 => '/^[\x{31A0}-\x{31BF}]{1,63}$/iu', + 63 => '/^[\x{31F0}-\x{31FF}]{1,63}$/iu', + 64 => '/^[\x{3200}-\x{32FF}]{1,63}$/iu', + 65 => '/^[\x{3300}-\x{33FF}]{1,63}$/iu', + 66 => '/^[\x{3400}-\x{4DBF}]{1,63}$/iu', + 67 => '/^[\x{4E00}-\x{9FFF}]{1,63}$/iu', + 68 => '/^[\x{A000}-\x{A48F}]{1,63}$/iu', + 69 => '/^[\x{A490}-\x{A4CF}]{1,63}$/iu', + 70 => '/^[\x{AC00}-\x{D7AF}]{1,63}$/iu', + 73 => '/^[\x{F900}-\x{FAFF}]{1,63}$/iu', + 74 => '/^[\x{FB00}-\x{FB4F}]{1,63}$/iu', + 75 => '/^[\x{FB50}-\x{FDFF}]{1,63}$/iu', + 76 => '/^[\x{FE20}-\x{FE2F}]{1,63}$/iu', + 77 => '/^[\x{FE70}-\x{FEFF}]{1,63}$/iu', + 78 => '/^[\x{FF00}-\x{FFEF}]{1,63}$/iu', + 79 => '/^[\x{20000}-\x{2A6DF}]{1,63}$/iu', + 80 => '/^[\x{2F800}-\x{2FA1F}]{1,63}$/iu' + +); diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Jp.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Jp.php new file mode 100644 index 0000000..567dc01 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Hostname/Jp.php @@ -0,0 +1,739 @@ + '/^[\x{002d}0-9a-z\x{3005}-\x{3007}\x{3041}-\x{3093}\x{309D}\x{309E}' . +'\x{30A1}-\x{30F6}\x{30FC}' . +'\x{30FD}\x{30FE}\x{4E00}\x{4E01}\x{4E03}\x{4E07}\x{4E08}\x{4E09}\x{4E0A}' . +'\x{4E0B}\x{4E0D}\x{4E0E}\x{4E10}\x{4E11}\x{4E14}\x{4E15}\x{4E16}\x{4E17}' . +'\x{4E18}\x{4E19}\x{4E1E}\x{4E21}\x{4E26}\x{4E2A}\x{4E2D}\x{4E31}\x{4E32}' . +'\x{4E36}\x{4E38}\x{4E39}\x{4E3B}\x{4E3C}\x{4E3F}\x{4E42}\x{4E43}\x{4E45}' . +'\x{4E4B}\x{4E4D}\x{4E4E}\x{4E4F}\x{4E55}\x{4E56}\x{4E57}\x{4E58}\x{4E59}' . +'\x{4E5D}\x{4E5E}\x{4E5F}\x{4E62}\x{4E71}\x{4E73}\x{4E7E}\x{4E80}\x{4E82}' . +'\x{4E85}\x{4E86}\x{4E88}\x{4E89}\x{4E8A}\x{4E8B}\x{4E8C}\x{4E8E}\x{4E91}' . +'\x{4E92}\x{4E94}\x{4E95}\x{4E98}\x{4E99}\x{4E9B}\x{4E9C}\x{4E9E}\x{4E9F}' . +'\x{4EA0}\x{4EA1}\x{4EA2}\x{4EA4}\x{4EA5}\x{4EA6}\x{4EA8}\x{4EAB}\x{4EAC}' . +'\x{4EAD}\x{4EAE}\x{4EB0}\x{4EB3}\x{4EB6}\x{4EBA}\x{4EC0}\x{4EC1}\x{4EC2}' . +'\x{4EC4}\x{4EC6}\x{4EC7}\x{4ECA}\x{4ECB}\x{4ECD}\x{4ECE}\x{4ECF}\x{4ED4}' . +'\x{4ED5}\x{4ED6}\x{4ED7}\x{4ED8}\x{4ED9}\x{4EDD}\x{4EDE}\x{4EDF}\x{4EE3}' . +'\x{4EE4}\x{4EE5}\x{4EED}\x{4EEE}\x{4EF0}\x{4EF2}\x{4EF6}\x{4EF7}\x{4EFB}' . +'\x{4F01}\x{4F09}\x{4F0A}\x{4F0D}\x{4F0E}\x{4F0F}\x{4F10}\x{4F11}\x{4F1A}' . +'\x{4F1C}\x{4F1D}\x{4F2F}\x{4F30}\x{4F34}\x{4F36}\x{4F38}\x{4F3A}\x{4F3C}' . +'\x{4F3D}\x{4F43}\x{4F46}\x{4F47}\x{4F4D}\x{4F4E}\x{4F4F}\x{4F50}\x{4F51}' . +'\x{4F53}\x{4F55}\x{4F57}\x{4F59}\x{4F5A}\x{4F5B}\x{4F5C}\x{4F5D}\x{4F5E}' . +'\x{4F69}\x{4F6F}\x{4F70}\x{4F73}\x{4F75}\x{4F76}\x{4F7B}\x{4F7C}\x{4F7F}' . +'\x{4F83}\x{4F86}\x{4F88}\x{4F8B}\x{4F8D}\x{4F8F}\x{4F91}\x{4F96}\x{4F98}' . +'\x{4F9B}\x{4F9D}\x{4FA0}\x{4FA1}\x{4FAB}\x{4FAD}\x{4FAE}\x{4FAF}\x{4FB5}' . +'\x{4FB6}\x{4FBF}\x{4FC2}\x{4FC3}\x{4FC4}\x{4FCA}\x{4FCE}\x{4FD0}\x{4FD1}' . +'\x{4FD4}\x{4FD7}\x{4FD8}\x{4FDA}\x{4FDB}\x{4FDD}\x{4FDF}\x{4FE1}\x{4FE3}' . +'\x{4FE4}\x{4FE5}\x{4FEE}\x{4FEF}\x{4FF3}\x{4FF5}\x{4FF6}\x{4FF8}\x{4FFA}' . +'\x{4FFE}\x{5005}\x{5006}\x{5009}\x{500B}\x{500D}\x{500F}\x{5011}\x{5012}' . +'\x{5014}\x{5016}\x{5019}\x{501A}\x{501F}\x{5021}\x{5023}\x{5024}\x{5025}' . +'\x{5026}\x{5028}\x{5029}\x{502A}\x{502B}\x{502C}\x{502D}\x{5036}\x{5039}' . +'\x{5043}\x{5047}\x{5048}\x{5049}\x{504F}\x{5050}\x{5055}\x{5056}\x{505A}' . +'\x{505C}\x{5065}\x{506C}\x{5072}\x{5074}\x{5075}\x{5076}\x{5078}\x{507D}' . +'\x{5080}\x{5085}\x{508D}\x{5091}\x{5098}\x{5099}\x{509A}\x{50AC}\x{50AD}' . +'\x{50B2}\x{50B3}\x{50B4}\x{50B5}\x{50B7}\x{50BE}\x{50C2}\x{50C5}\x{50C9}' . +'\x{50CA}\x{50CD}\x{50CF}\x{50D1}\x{50D5}\x{50D6}\x{50DA}\x{50DE}\x{50E3}' . +'\x{50E5}\x{50E7}\x{50ED}\x{50EE}\x{50F5}\x{50F9}\x{50FB}\x{5100}\x{5101}' . +'\x{5102}\x{5104}\x{5109}\x{5112}\x{5114}\x{5115}\x{5116}\x{5118}\x{511A}' . +'\x{511F}\x{5121}\x{512A}\x{5132}\x{5137}\x{513A}\x{513B}\x{513C}\x{513F}' . +'\x{5140}\x{5141}\x{5143}\x{5144}\x{5145}\x{5146}\x{5147}\x{5148}\x{5149}' . +'\x{514B}\x{514C}\x{514D}\x{514E}\x{5150}\x{5152}\x{5154}\x{515A}\x{515C}' . +'\x{5162}\x{5165}\x{5168}\x{5169}\x{516A}\x{516B}\x{516C}\x{516D}\x{516E}' . +'\x{5171}\x{5175}\x{5176}\x{5177}\x{5178}\x{517C}\x{5180}\x{5182}\x{5185}' . +'\x{5186}\x{5189}\x{518A}\x{518C}\x{518D}\x{518F}\x{5190}\x{5191}\x{5192}' . +'\x{5193}\x{5195}\x{5196}\x{5197}\x{5199}\x{51A0}\x{51A2}\x{51A4}\x{51A5}' . +'\x{51A6}\x{51A8}\x{51A9}\x{51AA}\x{51AB}\x{51AC}\x{51B0}\x{51B1}\x{51B2}' . +'\x{51B3}\x{51B4}\x{51B5}\x{51B6}\x{51B7}\x{51BD}\x{51C4}\x{51C5}\x{51C6}' . +'\x{51C9}\x{51CB}\x{51CC}\x{51CD}\x{51D6}\x{51DB}\x{51DC}\x{51DD}\x{51E0}' . +'\x{51E1}\x{51E6}\x{51E7}\x{51E9}\x{51EA}\x{51ED}\x{51F0}\x{51F1}\x{51F5}' . +'\x{51F6}\x{51F8}\x{51F9}\x{51FA}\x{51FD}\x{51FE}\x{5200}\x{5203}\x{5204}' . +'\x{5206}\x{5207}\x{5208}\x{520A}\x{520B}\x{520E}\x{5211}\x{5214}\x{5217}' . +'\x{521D}\x{5224}\x{5225}\x{5227}\x{5229}\x{522A}\x{522E}\x{5230}\x{5233}' . +'\x{5236}\x{5237}\x{5238}\x{5239}\x{523A}\x{523B}\x{5243}\x{5244}\x{5247}' . +'\x{524A}\x{524B}\x{524C}\x{524D}\x{524F}\x{5254}\x{5256}\x{525B}\x{525E}' . +'\x{5263}\x{5264}\x{5265}\x{5269}\x{526A}\x{526F}\x{5270}\x{5271}\x{5272}' . +'\x{5273}\x{5274}\x{5275}\x{527D}\x{527F}\x{5283}\x{5287}\x{5288}\x{5289}' . +'\x{528D}\x{5291}\x{5292}\x{5294}\x{529B}\x{529F}\x{52A0}\x{52A3}\x{52A9}' . +'\x{52AA}\x{52AB}\x{52AC}\x{52AD}\x{52B1}\x{52B4}\x{52B5}\x{52B9}\x{52BC}' . +'\x{52BE}\x{52C1}\x{52C3}\x{52C5}\x{52C7}\x{52C9}\x{52CD}\x{52D2}\x{52D5}' . +'\x{52D7}\x{52D8}\x{52D9}\x{52DD}\x{52DE}\x{52DF}\x{52E0}\x{52E2}\x{52E3}' . +'\x{52E4}\x{52E6}\x{52E7}\x{52F2}\x{52F3}\x{52F5}\x{52F8}\x{52F9}\x{52FA}' . +'\x{52FE}\x{52FF}\x{5301}\x{5302}\x{5305}\x{5306}\x{5308}\x{530D}\x{530F}' . +'\x{5310}\x{5315}\x{5316}\x{5317}\x{5319}\x{531A}\x{531D}\x{5320}\x{5321}' . +'\x{5323}\x{532A}\x{532F}\x{5331}\x{5333}\x{5338}\x{5339}\x{533A}\x{533B}' . +'\x{533F}\x{5340}\x{5341}\x{5343}\x{5345}\x{5346}\x{5347}\x{5348}\x{5349}' . +'\x{534A}\x{534D}\x{5351}\x{5352}\x{5353}\x{5354}\x{5357}\x{5358}\x{535A}' . +'\x{535C}\x{535E}\x{5360}\x{5366}\x{5369}\x{536E}\x{536F}\x{5370}\x{5371}' . +'\x{5373}\x{5374}\x{5375}\x{5377}\x{5378}\x{537B}\x{537F}\x{5382}\x{5384}' . +'\x{5396}\x{5398}\x{539A}\x{539F}\x{53A0}\x{53A5}\x{53A6}\x{53A8}\x{53A9}' . +'\x{53AD}\x{53AE}\x{53B0}\x{53B3}\x{53B6}\x{53BB}\x{53C2}\x{53C3}\x{53C8}' . +'\x{53C9}\x{53CA}\x{53CB}\x{53CC}\x{53CD}\x{53CE}\x{53D4}\x{53D6}\x{53D7}' . +'\x{53D9}\x{53DB}\x{53DF}\x{53E1}\x{53E2}\x{53E3}\x{53E4}\x{53E5}\x{53E8}' . +'\x{53E9}\x{53EA}\x{53EB}\x{53EC}\x{53ED}\x{53EE}\x{53EF}\x{53F0}\x{53F1}' . +'\x{53F2}\x{53F3}\x{53F6}\x{53F7}\x{53F8}\x{53FA}\x{5401}\x{5403}\x{5404}' . +'\x{5408}\x{5409}\x{540A}\x{540B}\x{540C}\x{540D}\x{540E}\x{540F}\x{5410}' . +'\x{5411}\x{541B}\x{541D}\x{541F}\x{5420}\x{5426}\x{5429}\x{542B}\x{542C}' . +'\x{542D}\x{542E}\x{5436}\x{5438}\x{5439}\x{543B}\x{543C}\x{543D}\x{543E}' . +'\x{5440}\x{5442}\x{5446}\x{5448}\x{5449}\x{544A}\x{544E}\x{5451}\x{545F}' . +'\x{5468}\x{546A}\x{5470}\x{5471}\x{5473}\x{5475}\x{5476}\x{5477}\x{547B}' . +'\x{547C}\x{547D}\x{5480}\x{5484}\x{5486}\x{548B}\x{548C}\x{548E}\x{548F}' . +'\x{5490}\x{5492}\x{54A2}\x{54A4}\x{54A5}\x{54A8}\x{54AB}\x{54AC}\x{54AF}' . +'\x{54B2}\x{54B3}\x{54B8}\x{54BC}\x{54BD}\x{54BE}\x{54C0}\x{54C1}\x{54C2}' . +'\x{54C4}\x{54C7}\x{54C8}\x{54C9}\x{54D8}\x{54E1}\x{54E2}\x{54E5}\x{54E6}' . +'\x{54E8}\x{54E9}\x{54ED}\x{54EE}\x{54F2}\x{54FA}\x{54FD}\x{5504}\x{5506}' . +'\x{5507}\x{550F}\x{5510}\x{5514}\x{5516}\x{552E}\x{552F}\x{5531}\x{5533}' . +'\x{5538}\x{5539}\x{553E}\x{5540}\x{5544}\x{5545}\x{5546}\x{554C}\x{554F}' . +'\x{5553}\x{5556}\x{5557}\x{555C}\x{555D}\x{5563}\x{557B}\x{557C}\x{557E}' . +'\x{5580}\x{5583}\x{5584}\x{5587}\x{5589}\x{558A}\x{558B}\x{5598}\x{5599}' . +'\x{559A}\x{559C}\x{559D}\x{559E}\x{559F}\x{55A7}\x{55A8}\x{55A9}\x{55AA}' . +'\x{55AB}\x{55AC}\x{55AE}\x{55B0}\x{55B6}\x{55C4}\x{55C5}\x{55C7}\x{55D4}' . +'\x{55DA}\x{55DC}\x{55DF}\x{55E3}\x{55E4}\x{55F7}\x{55F9}\x{55FD}\x{55FE}' . +'\x{5606}\x{5609}\x{5614}\x{5616}\x{5617}\x{5618}\x{561B}\x{5629}\x{562F}' . +'\x{5631}\x{5632}\x{5634}\x{5636}\x{5638}\x{5642}\x{564C}\x{564E}\x{5650}' . +'\x{565B}\x{5664}\x{5668}\x{566A}\x{566B}\x{566C}\x{5674}\x{5678}\x{567A}' . +'\x{5680}\x{5686}\x{5687}\x{568A}\x{568F}\x{5694}\x{56A0}\x{56A2}\x{56A5}' . +'\x{56AE}\x{56B4}\x{56B6}\x{56BC}\x{56C0}\x{56C1}\x{56C2}\x{56C3}\x{56C8}' . +'\x{56CE}\x{56D1}\x{56D3}\x{56D7}\x{56D8}\x{56DA}\x{56DB}\x{56DE}\x{56E0}' . +'\x{56E3}\x{56EE}\x{56F0}\x{56F2}\x{56F3}\x{56F9}\x{56FA}\x{56FD}\x{56FF}' . +'\x{5700}\x{5703}\x{5704}\x{5708}\x{5709}\x{570B}\x{570D}\x{570F}\x{5712}' . +'\x{5713}\x{5716}\x{5718}\x{571C}\x{571F}\x{5726}\x{5727}\x{5728}\x{572D}' . +'\x{5730}\x{5737}\x{5738}\x{573B}\x{5740}\x{5742}\x{5747}\x{574A}\x{574E}' . +'\x{574F}\x{5750}\x{5751}\x{5761}\x{5764}\x{5766}\x{5769}\x{576A}\x{577F}' . +'\x{5782}\x{5788}\x{5789}\x{578B}\x{5793}\x{57A0}\x{57A2}\x{57A3}\x{57A4}' . +'\x{57AA}\x{57B0}\x{57B3}\x{57C0}\x{57C3}\x{57C6}\x{57CB}\x{57CE}\x{57D2}' . +'\x{57D3}\x{57D4}\x{57D6}\x{57DC}\x{57DF}\x{57E0}\x{57E3}\x{57F4}\x{57F7}' . +'\x{57F9}\x{57FA}\x{57FC}\x{5800}\x{5802}\x{5805}\x{5806}\x{580A}\x{580B}' . +'\x{5815}\x{5819}\x{581D}\x{5821}\x{5824}\x{582A}\x{582F}\x{5830}\x{5831}' . +'\x{5834}\x{5835}\x{583A}\x{583D}\x{5840}\x{5841}\x{584A}\x{584B}\x{5851}' . +'\x{5852}\x{5854}\x{5857}\x{5858}\x{5859}\x{585A}\x{585E}\x{5862}\x{5869}' . +'\x{586B}\x{5870}\x{5872}\x{5875}\x{5879}\x{587E}\x{5883}\x{5885}\x{5893}' . +'\x{5897}\x{589C}\x{589F}\x{58A8}\x{58AB}\x{58AE}\x{58B3}\x{58B8}\x{58B9}' . +'\x{58BA}\x{58BB}\x{58BE}\x{58C1}\x{58C5}\x{58C7}\x{58CA}\x{58CC}\x{58D1}' . +'\x{58D3}\x{58D5}\x{58D7}\x{58D8}\x{58D9}\x{58DC}\x{58DE}\x{58DF}\x{58E4}' . +'\x{58E5}\x{58EB}\x{58EC}\x{58EE}\x{58EF}\x{58F0}\x{58F1}\x{58F2}\x{58F7}' . +'\x{58F9}\x{58FA}\x{58FB}\x{58FC}\x{58FD}\x{5902}\x{5909}\x{590A}\x{590F}' . +'\x{5910}\x{5915}\x{5916}\x{5918}\x{5919}\x{591A}\x{591B}\x{591C}\x{5922}' . +'\x{5925}\x{5927}\x{5929}\x{592A}\x{592B}\x{592C}\x{592D}\x{592E}\x{5931}' . +'\x{5932}\x{5937}\x{5938}\x{593E}\x{5944}\x{5947}\x{5948}\x{5949}\x{594E}' . +'\x{594F}\x{5950}\x{5951}\x{5954}\x{5955}\x{5957}\x{5958}\x{595A}\x{5960}' . +'\x{5962}\x{5965}\x{5967}\x{5968}\x{5969}\x{596A}\x{596C}\x{596E}\x{5973}' . +'\x{5974}\x{5978}\x{597D}\x{5981}\x{5982}\x{5983}\x{5984}\x{598A}\x{598D}' . +'\x{5993}\x{5996}\x{5999}\x{599B}\x{599D}\x{59A3}\x{59A5}\x{59A8}\x{59AC}' . +'\x{59B2}\x{59B9}\x{59BB}\x{59BE}\x{59C6}\x{59C9}\x{59CB}\x{59D0}\x{59D1}' . +'\x{59D3}\x{59D4}\x{59D9}\x{59DA}\x{59DC}\x{59E5}\x{59E6}\x{59E8}\x{59EA}' . +'\x{59EB}\x{59F6}\x{59FB}\x{59FF}\x{5A01}\x{5A03}\x{5A09}\x{5A11}\x{5A18}' . +'\x{5A1A}\x{5A1C}\x{5A1F}\x{5A20}\x{5A25}\x{5A29}\x{5A2F}\x{5A35}\x{5A36}' . +'\x{5A3C}\x{5A40}\x{5A41}\x{5A46}\x{5A49}\x{5A5A}\x{5A62}\x{5A66}\x{5A6A}' . +'\x{5A6C}\x{5A7F}\x{5A92}\x{5A9A}\x{5A9B}\x{5ABC}\x{5ABD}\x{5ABE}\x{5AC1}' . +'\x{5AC2}\x{5AC9}\x{5ACB}\x{5ACC}\x{5AD0}\x{5AD6}\x{5AD7}\x{5AE1}\x{5AE3}' . +'\x{5AE6}\x{5AE9}\x{5AFA}\x{5AFB}\x{5B09}\x{5B0B}\x{5B0C}\x{5B16}\x{5B22}' . +'\x{5B2A}\x{5B2C}\x{5B30}\x{5B32}\x{5B36}\x{5B3E}\x{5B40}\x{5B43}\x{5B45}' . +'\x{5B50}\x{5B51}\x{5B54}\x{5B55}\x{5B57}\x{5B58}\x{5B5A}\x{5B5B}\x{5B5C}' . +'\x{5B5D}\x{5B5F}\x{5B63}\x{5B64}\x{5B65}\x{5B66}\x{5B69}\x{5B6B}\x{5B70}' . +'\x{5B71}\x{5B73}\x{5B75}\x{5B78}\x{5B7A}\x{5B80}\x{5B83}\x{5B85}\x{5B87}' . +'\x{5B88}\x{5B89}\x{5B8B}\x{5B8C}\x{5B8D}\x{5B8F}\x{5B95}\x{5B97}\x{5B98}' . +'\x{5B99}\x{5B9A}\x{5B9B}\x{5B9C}\x{5B9D}\x{5B9F}\x{5BA2}\x{5BA3}\x{5BA4}' . +'\x{5BA5}\x{5BA6}\x{5BAE}\x{5BB0}\x{5BB3}\x{5BB4}\x{5BB5}\x{5BB6}\x{5BB8}' . +'\x{5BB9}\x{5BBF}\x{5BC2}\x{5BC3}\x{5BC4}\x{5BC5}\x{5BC6}\x{5BC7}\x{5BC9}' . +'\x{5BCC}\x{5BD0}\x{5BD2}\x{5BD3}\x{5BD4}\x{5BDB}\x{5BDD}\x{5BDE}\x{5BDF}' . +'\x{5BE1}\x{5BE2}\x{5BE4}\x{5BE5}\x{5BE6}\x{5BE7}\x{5BE8}\x{5BE9}\x{5BEB}' . +'\x{5BEE}\x{5BF0}\x{5BF3}\x{5BF5}\x{5BF6}\x{5BF8}\x{5BFA}\x{5BFE}\x{5BFF}' . +'\x{5C01}\x{5C02}\x{5C04}\x{5C05}\x{5C06}\x{5C07}\x{5C08}\x{5C09}\x{5C0A}' . +'\x{5C0B}\x{5C0D}\x{5C0E}\x{5C0F}\x{5C11}\x{5C13}\x{5C16}\x{5C1A}\x{5C20}' . +'\x{5C22}\x{5C24}\x{5C28}\x{5C2D}\x{5C31}\x{5C38}\x{5C39}\x{5C3A}\x{5C3B}' . +'\x{5C3C}\x{5C3D}\x{5C3E}\x{5C3F}\x{5C40}\x{5C41}\x{5C45}\x{5C46}\x{5C48}' . +'\x{5C4A}\x{5C4B}\x{5C4D}\x{5C4E}\x{5C4F}\x{5C50}\x{5C51}\x{5C53}\x{5C55}' . +'\x{5C5E}\x{5C60}\x{5C61}\x{5C64}\x{5C65}\x{5C6C}\x{5C6E}\x{5C6F}\x{5C71}' . +'\x{5C76}\x{5C79}\x{5C8C}\x{5C90}\x{5C91}\x{5C94}\x{5CA1}\x{5CA8}\x{5CA9}' . +'\x{5CAB}\x{5CAC}\x{5CB1}\x{5CB3}\x{5CB6}\x{5CB7}\x{5CB8}\x{5CBB}\x{5CBC}' . +'\x{5CBE}\x{5CC5}\x{5CC7}\x{5CD9}\x{5CE0}\x{5CE1}\x{5CE8}\x{5CE9}\x{5CEA}' . +'\x{5CED}\x{5CEF}\x{5CF0}\x{5CF6}\x{5CFA}\x{5CFB}\x{5CFD}\x{5D07}\x{5D0B}' . +'\x{5D0E}\x{5D11}\x{5D14}\x{5D15}\x{5D16}\x{5D17}\x{5D18}\x{5D19}\x{5D1A}' . +'\x{5D1B}\x{5D1F}\x{5D22}\x{5D29}\x{5D4B}\x{5D4C}\x{5D4E}\x{5D50}\x{5D52}' . +'\x{5D5C}\x{5D69}\x{5D6C}\x{5D6F}\x{5D73}\x{5D76}\x{5D82}\x{5D84}\x{5D87}' . +'\x{5D8B}\x{5D8C}\x{5D90}\x{5D9D}\x{5DA2}\x{5DAC}\x{5DAE}\x{5DB7}\x{5DBA}' . +'\x{5DBC}\x{5DBD}\x{5DC9}\x{5DCC}\x{5DCD}\x{5DD2}\x{5DD3}\x{5DD6}\x{5DDB}' . +'\x{5DDD}\x{5DDE}\x{5DE1}\x{5DE3}\x{5DE5}\x{5DE6}\x{5DE7}\x{5DE8}\x{5DEB}' . +'\x{5DEE}\x{5DF1}\x{5DF2}\x{5DF3}\x{5DF4}\x{5DF5}\x{5DF7}\x{5DFB}\x{5DFD}' . +'\x{5DFE}\x{5E02}\x{5E03}\x{5E06}\x{5E0B}\x{5E0C}\x{5E11}\x{5E16}\x{5E19}' . +'\x{5E1A}\x{5E1B}\x{5E1D}\x{5E25}\x{5E2B}\x{5E2D}\x{5E2F}\x{5E30}\x{5E33}' . +'\x{5E36}\x{5E37}\x{5E38}\x{5E3D}\x{5E40}\x{5E43}\x{5E44}\x{5E45}\x{5E47}' . +'\x{5E4C}\x{5E4E}\x{5E54}\x{5E55}\x{5E57}\x{5E5F}\x{5E61}\x{5E62}\x{5E63}' . +'\x{5E64}\x{5E72}\x{5E73}\x{5E74}\x{5E75}\x{5E76}\x{5E78}\x{5E79}\x{5E7A}' . +'\x{5E7B}\x{5E7C}\x{5E7D}\x{5E7E}\x{5E7F}\x{5E81}\x{5E83}\x{5E84}\x{5E87}' . +'\x{5E8A}\x{5E8F}\x{5E95}\x{5E96}\x{5E97}\x{5E9A}\x{5E9C}\x{5EA0}\x{5EA6}' . +'\x{5EA7}\x{5EAB}\x{5EAD}\x{5EB5}\x{5EB6}\x{5EB7}\x{5EB8}\x{5EC1}\x{5EC2}' . +'\x{5EC3}\x{5EC8}\x{5EC9}\x{5ECA}\x{5ECF}\x{5ED0}\x{5ED3}\x{5ED6}\x{5EDA}' . +'\x{5EDB}\x{5EDD}\x{5EDF}\x{5EE0}\x{5EE1}\x{5EE2}\x{5EE3}\x{5EE8}\x{5EE9}' . +'\x{5EEC}\x{5EF0}\x{5EF1}\x{5EF3}\x{5EF4}\x{5EF6}\x{5EF7}\x{5EF8}\x{5EFA}' . +'\x{5EFB}\x{5EFC}\x{5EFE}\x{5EFF}\x{5F01}\x{5F03}\x{5F04}\x{5F09}\x{5F0A}' . +'\x{5F0B}\x{5F0C}\x{5F0D}\x{5F0F}\x{5F10}\x{5F11}\x{5F13}\x{5F14}\x{5F15}' . +'\x{5F16}\x{5F17}\x{5F18}\x{5F1B}\x{5F1F}\x{5F25}\x{5F26}\x{5F27}\x{5F29}' . +'\x{5F2D}\x{5F2F}\x{5F31}\x{5F35}\x{5F37}\x{5F38}\x{5F3C}\x{5F3E}\x{5F41}' . +'\x{5F48}\x{5F4A}\x{5F4C}\x{5F4E}\x{5F51}\x{5F53}\x{5F56}\x{5F57}\x{5F59}' . +'\x{5F5C}\x{5F5D}\x{5F61}\x{5F62}\x{5F66}\x{5F69}\x{5F6A}\x{5F6B}\x{5F6C}' . +'\x{5F6D}\x{5F70}\x{5F71}\x{5F73}\x{5F77}\x{5F79}\x{5F7C}\x{5F7F}\x{5F80}' . +'\x{5F81}\x{5F82}\x{5F83}\x{5F84}\x{5F85}\x{5F87}\x{5F88}\x{5F8A}\x{5F8B}' . +'\x{5F8C}\x{5F90}\x{5F91}\x{5F92}\x{5F93}\x{5F97}\x{5F98}\x{5F99}\x{5F9E}' . +'\x{5FA0}\x{5FA1}\x{5FA8}\x{5FA9}\x{5FAA}\x{5FAD}\x{5FAE}\x{5FB3}\x{5FB4}' . +'\x{5FB9}\x{5FBC}\x{5FBD}\x{5FC3}\x{5FC5}\x{5FCC}\x{5FCD}\x{5FD6}\x{5FD7}' . +'\x{5FD8}\x{5FD9}\x{5FDC}\x{5FDD}\x{5FE0}\x{5FE4}\x{5FEB}\x{5FF0}\x{5FF1}' . +'\x{5FF5}\x{5FF8}\x{5FFB}\x{5FFD}\x{5FFF}\x{600E}\x{600F}\x{6010}\x{6012}' . +'\x{6015}\x{6016}\x{6019}\x{601B}\x{601C}\x{601D}\x{6020}\x{6021}\x{6025}' . +'\x{6026}\x{6027}\x{6028}\x{6029}\x{602A}\x{602B}\x{602F}\x{6031}\x{603A}' . +'\x{6041}\x{6042}\x{6043}\x{6046}\x{604A}\x{604B}\x{604D}\x{6050}\x{6052}' . +'\x{6055}\x{6059}\x{605A}\x{605F}\x{6060}\x{6062}\x{6063}\x{6064}\x{6065}' . +'\x{6068}\x{6069}\x{606A}\x{606B}\x{606C}\x{606D}\x{606F}\x{6070}\x{6075}' . +'\x{6077}\x{6081}\x{6083}\x{6084}\x{6089}\x{608B}\x{608C}\x{608D}\x{6092}' . +'\x{6094}\x{6096}\x{6097}\x{609A}\x{609B}\x{609F}\x{60A0}\x{60A3}\x{60A6}' . +'\x{60A7}\x{60A9}\x{60AA}\x{60B2}\x{60B3}\x{60B4}\x{60B5}\x{60B6}\x{60B8}' . +'\x{60BC}\x{60BD}\x{60C5}\x{60C6}\x{60C7}\x{60D1}\x{60D3}\x{60D8}\x{60DA}' . +'\x{60DC}\x{60DF}\x{60E0}\x{60E1}\x{60E3}\x{60E7}\x{60E8}\x{60F0}\x{60F1}' . +'\x{60F3}\x{60F4}\x{60F6}\x{60F7}\x{60F9}\x{60FA}\x{60FB}\x{6100}\x{6101}' . +'\x{6103}\x{6106}\x{6108}\x{6109}\x{610D}\x{610E}\x{610F}\x{6115}\x{611A}' . +'\x{611B}\x{611F}\x{6121}\x{6127}\x{6128}\x{612C}\x{6134}\x{613C}\x{613D}' . +'\x{613E}\x{613F}\x{6142}\x{6144}\x{6147}\x{6148}\x{614A}\x{614B}\x{614C}' . +'\x{614D}\x{614E}\x{6153}\x{6155}\x{6158}\x{6159}\x{615A}\x{615D}\x{615F}' . +'\x{6162}\x{6163}\x{6165}\x{6167}\x{6168}\x{616B}\x{616E}\x{616F}\x{6170}' . +'\x{6171}\x{6173}\x{6174}\x{6175}\x{6176}\x{6177}\x{617E}\x{6182}\x{6187}' . +'\x{618A}\x{618E}\x{6190}\x{6191}\x{6194}\x{6196}\x{6199}\x{619A}\x{61A4}' . +'\x{61A7}\x{61A9}\x{61AB}\x{61AC}\x{61AE}\x{61B2}\x{61B6}\x{61BA}\x{61BE}' . +'\x{61C3}\x{61C6}\x{61C7}\x{61C8}\x{61C9}\x{61CA}\x{61CB}\x{61CC}\x{61CD}' . +'\x{61D0}\x{61E3}\x{61E6}\x{61F2}\x{61F4}\x{61F6}\x{61F7}\x{61F8}\x{61FA}' . +'\x{61FC}\x{61FD}\x{61FE}\x{61FF}\x{6200}\x{6208}\x{6209}\x{620A}\x{620C}' . +'\x{620D}\x{620E}\x{6210}\x{6211}\x{6212}\x{6214}\x{6216}\x{621A}\x{621B}' . +'\x{621D}\x{621E}\x{621F}\x{6221}\x{6226}\x{622A}\x{622E}\x{622F}\x{6230}' . +'\x{6232}\x{6233}\x{6234}\x{6238}\x{623B}\x{623F}\x{6240}\x{6241}\x{6247}' . +'\x{6248}\x{6249}\x{624B}\x{624D}\x{624E}\x{6253}\x{6255}\x{6258}\x{625B}' . +'\x{625E}\x{6260}\x{6263}\x{6268}\x{626E}\x{6271}\x{6276}\x{6279}\x{627C}' . +'\x{627E}\x{627F}\x{6280}\x{6282}\x{6283}\x{6284}\x{6289}\x{628A}\x{6291}' . +'\x{6292}\x{6293}\x{6294}\x{6295}\x{6296}\x{6297}\x{6298}\x{629B}\x{629C}' . +'\x{629E}\x{62AB}\x{62AC}\x{62B1}\x{62B5}\x{62B9}\x{62BB}\x{62BC}\x{62BD}' . +'\x{62C2}\x{62C5}\x{62C6}\x{62C7}\x{62C8}\x{62C9}\x{62CA}\x{62CC}\x{62CD}' . +'\x{62CF}\x{62D0}\x{62D1}\x{62D2}\x{62D3}\x{62D4}\x{62D7}\x{62D8}\x{62D9}' . +'\x{62DB}\x{62DC}\x{62DD}\x{62E0}\x{62E1}\x{62EC}\x{62ED}\x{62EE}\x{62EF}' . +'\x{62F1}\x{62F3}\x{62F5}\x{62F6}\x{62F7}\x{62FE}\x{62FF}\x{6301}\x{6302}' . +'\x{6307}\x{6308}\x{6309}\x{630C}\x{6311}\x{6319}\x{631F}\x{6327}\x{6328}' . +'\x{632B}\x{632F}\x{633A}\x{633D}\x{633E}\x{633F}\x{6349}\x{634C}\x{634D}' . +'\x{634F}\x{6350}\x{6355}\x{6357}\x{635C}\x{6367}\x{6368}\x{6369}\x{636B}' . +'\x{636E}\x{6372}\x{6376}\x{6377}\x{637A}\x{637B}\x{6380}\x{6383}\x{6388}' . +'\x{6389}\x{638C}\x{638E}\x{638F}\x{6392}\x{6396}\x{6398}\x{639B}\x{639F}' . +'\x{63A0}\x{63A1}\x{63A2}\x{63A3}\x{63A5}\x{63A7}\x{63A8}\x{63A9}\x{63AA}' . +'\x{63AB}\x{63AC}\x{63B2}\x{63B4}\x{63B5}\x{63BB}\x{63BE}\x{63C0}\x{63C3}' . +'\x{63C4}\x{63C6}\x{63C9}\x{63CF}\x{63D0}\x{63D2}\x{63D6}\x{63DA}\x{63DB}' . +'\x{63E1}\x{63E3}\x{63E9}\x{63EE}\x{63F4}\x{63F6}\x{63FA}\x{6406}\x{640D}' . +'\x{640F}\x{6413}\x{6416}\x{6417}\x{641C}\x{6426}\x{6428}\x{642C}\x{642D}' . +'\x{6434}\x{6436}\x{643A}\x{643E}\x{6442}\x{644E}\x{6458}\x{6467}\x{6469}' . +'\x{646F}\x{6476}\x{6478}\x{647A}\x{6483}\x{6488}\x{6492}\x{6493}\x{6495}' . +'\x{649A}\x{649E}\x{64A4}\x{64A5}\x{64A9}\x{64AB}\x{64AD}\x{64AE}\x{64B0}' . +'\x{64B2}\x{64B9}\x{64BB}\x{64BC}\x{64C1}\x{64C2}\x{64C5}\x{64C7}\x{64CD}' . +'\x{64D2}\x{64D4}\x{64D8}\x{64DA}\x{64E0}\x{64E1}\x{64E2}\x{64E3}\x{64E6}' . +'\x{64E7}\x{64EC}\x{64EF}\x{64F1}\x{64F2}\x{64F4}\x{64F6}\x{64FA}\x{64FD}' . +'\x{64FE}\x{6500}\x{6505}\x{6518}\x{651C}\x{651D}\x{6523}\x{6524}\x{652A}' . +'\x{652B}\x{652C}\x{652F}\x{6534}\x{6535}\x{6536}\x{6537}\x{6538}\x{6539}' . +'\x{653B}\x{653E}\x{653F}\x{6545}\x{6548}\x{654D}\x{654F}\x{6551}\x{6555}' . +'\x{6556}\x{6557}\x{6558}\x{6559}\x{655D}\x{655E}\x{6562}\x{6563}\x{6566}' . +'\x{656C}\x{6570}\x{6572}\x{6574}\x{6575}\x{6577}\x{6578}\x{6582}\x{6583}' . +'\x{6587}\x{6588}\x{6589}\x{658C}\x{658E}\x{6590}\x{6591}\x{6597}\x{6599}' . +'\x{659B}\x{659C}\x{659F}\x{65A1}\x{65A4}\x{65A5}\x{65A7}\x{65AB}\x{65AC}' . +'\x{65AD}\x{65AF}\x{65B0}\x{65B7}\x{65B9}\x{65BC}\x{65BD}\x{65C1}\x{65C3}' . +'\x{65C4}\x{65C5}\x{65C6}\x{65CB}\x{65CC}\x{65CF}\x{65D2}\x{65D7}\x{65D9}' . +'\x{65DB}\x{65E0}\x{65E1}\x{65E2}\x{65E5}\x{65E6}\x{65E7}\x{65E8}\x{65E9}' . +'\x{65EC}\x{65ED}\x{65F1}\x{65FA}\x{65FB}\x{6602}\x{6603}\x{6606}\x{6607}' . +'\x{660A}\x{660C}\x{660E}\x{660F}\x{6613}\x{6614}\x{661C}\x{661F}\x{6620}' . +'\x{6625}\x{6627}\x{6628}\x{662D}\x{662F}\x{6634}\x{6635}\x{6636}\x{663C}' . +'\x{663F}\x{6641}\x{6642}\x{6643}\x{6644}\x{6649}\x{664B}\x{664F}\x{6652}' . +'\x{665D}\x{665E}\x{665F}\x{6662}\x{6664}\x{6666}\x{6667}\x{6668}\x{6669}' . +'\x{666E}\x{666F}\x{6670}\x{6674}\x{6676}\x{667A}\x{6681}\x{6683}\x{6684}' . +'\x{6687}\x{6688}\x{6689}\x{668E}\x{6691}\x{6696}\x{6697}\x{6698}\x{669D}' . +'\x{66A2}\x{66A6}\x{66AB}\x{66AE}\x{66B4}\x{66B8}\x{66B9}\x{66BC}\x{66BE}' . +'\x{66C1}\x{66C4}\x{66C7}\x{66C9}\x{66D6}\x{66D9}\x{66DA}\x{66DC}\x{66DD}' . +'\x{66E0}\x{66E6}\x{66E9}\x{66F0}\x{66F2}\x{66F3}\x{66F4}\x{66F5}\x{66F7}' . +'\x{66F8}\x{66F9}\x{66FC}\x{66FD}\x{66FE}\x{66FF}\x{6700}\x{6703}\x{6708}' . +'\x{6709}\x{670B}\x{670D}\x{670F}\x{6714}\x{6715}\x{6716}\x{6717}\x{671B}' . +'\x{671D}\x{671E}\x{671F}\x{6726}\x{6727}\x{6728}\x{672A}\x{672B}\x{672C}' . +'\x{672D}\x{672E}\x{6731}\x{6734}\x{6736}\x{6737}\x{6738}\x{673A}\x{673D}' . +'\x{673F}\x{6741}\x{6746}\x{6749}\x{674E}\x{674F}\x{6750}\x{6751}\x{6753}' . +'\x{6756}\x{6759}\x{675C}\x{675E}\x{675F}\x{6760}\x{6761}\x{6762}\x{6763}' . +'\x{6764}\x{6765}\x{676A}\x{676D}\x{676F}\x{6770}\x{6771}\x{6772}\x{6773}' . +'\x{6775}\x{6777}\x{677C}\x{677E}\x{677F}\x{6785}\x{6787}\x{6789}\x{678B}' . +'\x{678C}\x{6790}\x{6795}\x{6797}\x{679A}\x{679C}\x{679D}\x{67A0}\x{67A1}' . +'\x{67A2}\x{67A6}\x{67A9}\x{67AF}\x{67B3}\x{67B4}\x{67B6}\x{67B7}\x{67B8}' . +'\x{67B9}\x{67C1}\x{67C4}\x{67C6}\x{67CA}\x{67CE}\x{67CF}\x{67D0}\x{67D1}' . +'\x{67D3}\x{67D4}\x{67D8}\x{67DA}\x{67DD}\x{67DE}\x{67E2}\x{67E4}\x{67E7}' . +'\x{67E9}\x{67EC}\x{67EE}\x{67EF}\x{67F1}\x{67F3}\x{67F4}\x{67F5}\x{67FB}' . +'\x{67FE}\x{67FF}\x{6802}\x{6803}\x{6804}\x{6813}\x{6816}\x{6817}\x{681E}' . +'\x{6821}\x{6822}\x{6829}\x{682A}\x{682B}\x{6832}\x{6834}\x{6838}\x{6839}' . +'\x{683C}\x{683D}\x{6840}\x{6841}\x{6842}\x{6843}\x{6846}\x{6848}\x{684D}' . +'\x{684E}\x{6850}\x{6851}\x{6853}\x{6854}\x{6859}\x{685C}\x{685D}\x{685F}' . +'\x{6863}\x{6867}\x{6874}\x{6876}\x{6877}\x{687E}\x{687F}\x{6881}\x{6883}' . +'\x{6885}\x{688D}\x{688F}\x{6893}\x{6894}\x{6897}\x{689B}\x{689D}\x{689F}' . +'\x{68A0}\x{68A2}\x{68A6}\x{68A7}\x{68A8}\x{68AD}\x{68AF}\x{68B0}\x{68B1}' . +'\x{68B3}\x{68B5}\x{68B6}\x{68B9}\x{68BA}\x{68BC}\x{68C4}\x{68C6}\x{68C9}' . +'\x{68CA}\x{68CB}\x{68CD}\x{68D2}\x{68D4}\x{68D5}\x{68D7}\x{68D8}\x{68DA}' . +'\x{68DF}\x{68E0}\x{68E1}\x{68E3}\x{68E7}\x{68EE}\x{68EF}\x{68F2}\x{68F9}' . +'\x{68FA}\x{6900}\x{6901}\x{6904}\x{6905}\x{6908}\x{690B}\x{690C}\x{690D}' . +'\x{690E}\x{690F}\x{6912}\x{6919}\x{691A}\x{691B}\x{691C}\x{6921}\x{6922}' . +'\x{6923}\x{6925}\x{6926}\x{6928}\x{692A}\x{6930}\x{6934}\x{6936}\x{6939}' . +'\x{693D}\x{693F}\x{694A}\x{6953}\x{6954}\x{6955}\x{6959}\x{695A}\x{695C}' . +'\x{695D}\x{695E}\x{6960}\x{6961}\x{6962}\x{696A}\x{696B}\x{696D}\x{696E}' . +'\x{696F}\x{6973}\x{6974}\x{6975}\x{6977}\x{6978}\x{6979}\x{697C}\x{697D}' . +'\x{697E}\x{6981}\x{6982}\x{698A}\x{698E}\x{6991}\x{6994}\x{6995}\x{699B}' . +'\x{699C}\x{69A0}\x{69A7}\x{69AE}\x{69B1}\x{69B2}\x{69B4}\x{69BB}\x{69BE}' . +'\x{69BF}\x{69C1}\x{69C3}\x{69C7}\x{69CA}\x{69CB}\x{69CC}\x{69CD}\x{69CE}' . +'\x{69D0}\x{69D3}\x{69D8}\x{69D9}\x{69DD}\x{69DE}\x{69E7}\x{69E8}\x{69EB}' . +'\x{69ED}\x{69F2}\x{69F9}\x{69FB}\x{69FD}\x{69FF}\x{6A02}\x{6A05}\x{6A0A}' . +'\x{6A0B}\x{6A0C}\x{6A12}\x{6A13}\x{6A14}\x{6A17}\x{6A19}\x{6A1B}\x{6A1E}' . +'\x{6A1F}\x{6A21}\x{6A22}\x{6A23}\x{6A29}\x{6A2A}\x{6A2B}\x{6A2E}\x{6A35}' . +'\x{6A36}\x{6A38}\x{6A39}\x{6A3A}\x{6A3D}\x{6A44}\x{6A47}\x{6A48}\x{6A4B}' . +'\x{6A58}\x{6A59}\x{6A5F}\x{6A61}\x{6A62}\x{6A66}\x{6A72}\x{6A78}\x{6A7F}' . +'\x{6A80}\x{6A84}\x{6A8D}\x{6A8E}\x{6A90}\x{6A97}\x{6A9C}\x{6AA0}\x{6AA2}' . +'\x{6AA3}\x{6AAA}\x{6AAC}\x{6AAE}\x{6AB3}\x{6AB8}\x{6ABB}\x{6AC1}\x{6AC2}' . +'\x{6AC3}\x{6AD1}\x{6AD3}\x{6ADA}\x{6ADB}\x{6ADE}\x{6ADF}\x{6AE8}\x{6AEA}' . +'\x{6AFA}\x{6AFB}\x{6B04}\x{6B05}\x{6B0A}\x{6B12}\x{6B16}\x{6B1D}\x{6B1F}' . +'\x{6B20}\x{6B21}\x{6B23}\x{6B27}\x{6B32}\x{6B37}\x{6B38}\x{6B39}\x{6B3A}' . +'\x{6B3D}\x{6B3E}\x{6B43}\x{6B47}\x{6B49}\x{6B4C}\x{6B4E}\x{6B50}\x{6B53}' . +'\x{6B54}\x{6B59}\x{6B5B}\x{6B5F}\x{6B61}\x{6B62}\x{6B63}\x{6B64}\x{6B66}' . +'\x{6B69}\x{6B6A}\x{6B6F}\x{6B73}\x{6B74}\x{6B78}\x{6B79}\x{6B7B}\x{6B7F}' . +'\x{6B80}\x{6B83}\x{6B84}\x{6B86}\x{6B89}\x{6B8A}\x{6B8B}\x{6B8D}\x{6B95}' . +'\x{6B96}\x{6B98}\x{6B9E}\x{6BA4}\x{6BAA}\x{6BAB}\x{6BAF}\x{6BB1}\x{6BB2}' . +'\x{6BB3}\x{6BB4}\x{6BB5}\x{6BB7}\x{6BBA}\x{6BBB}\x{6BBC}\x{6BBF}\x{6BC0}' . +'\x{6BC5}\x{6BC6}\x{6BCB}\x{6BCD}\x{6BCE}\x{6BD2}\x{6BD3}\x{6BD4}\x{6BD8}' . +'\x{6BDB}\x{6BDF}\x{6BEB}\x{6BEC}\x{6BEF}\x{6BF3}\x{6C08}\x{6C0F}\x{6C11}' . +'\x{6C13}\x{6C14}\x{6C17}\x{6C1B}\x{6C23}\x{6C24}\x{6C34}\x{6C37}\x{6C38}' . +'\x{6C3E}\x{6C40}\x{6C41}\x{6C42}\x{6C4E}\x{6C50}\x{6C55}\x{6C57}\x{6C5A}' . +'\x{6C5D}\x{6C5E}\x{6C5F}\x{6C60}\x{6C62}\x{6C68}\x{6C6A}\x{6C70}\x{6C72}' . +'\x{6C73}\x{6C7A}\x{6C7D}\x{6C7E}\x{6C81}\x{6C82}\x{6C83}\x{6C88}\x{6C8C}' . +'\x{6C8D}\x{6C90}\x{6C92}\x{6C93}\x{6C96}\x{6C99}\x{6C9A}\x{6C9B}\x{6CA1}' . +'\x{6CA2}\x{6CAB}\x{6CAE}\x{6CB1}\x{6CB3}\x{6CB8}\x{6CB9}\x{6CBA}\x{6CBB}' . +'\x{6CBC}\x{6CBD}\x{6CBE}\x{6CBF}\x{6CC1}\x{6CC4}\x{6CC5}\x{6CC9}\x{6CCA}' . +'\x{6CCC}\x{6CD3}\x{6CD5}\x{6CD7}\x{6CD9}\x{6CDB}\x{6CDD}\x{6CE1}\x{6CE2}' . +'\x{6CE3}\x{6CE5}\x{6CE8}\x{6CEA}\x{6CEF}\x{6CF0}\x{6CF1}\x{6CF3}\x{6D0B}' . +'\x{6D0C}\x{6D12}\x{6D17}\x{6D19}\x{6D1B}\x{6D1E}\x{6D1F}\x{6D25}\x{6D29}' . +'\x{6D2A}\x{6D2B}\x{6D32}\x{6D33}\x{6D35}\x{6D36}\x{6D38}\x{6D3B}\x{6D3D}' . +'\x{6D3E}\x{6D41}\x{6D44}\x{6D45}\x{6D59}\x{6D5A}\x{6D5C}\x{6D63}\x{6D64}' . +'\x{6D66}\x{6D69}\x{6D6A}\x{6D6C}\x{6D6E}\x{6D74}\x{6D77}\x{6D78}\x{6D79}' . +'\x{6D85}\x{6D88}\x{6D8C}\x{6D8E}\x{6D93}\x{6D95}\x{6D99}\x{6D9B}\x{6D9C}' . +'\x{6DAF}\x{6DB2}\x{6DB5}\x{6DB8}\x{6DBC}\x{6DC0}\x{6DC5}\x{6DC6}\x{6DC7}' . +'\x{6DCB}\x{6DCC}\x{6DD1}\x{6DD2}\x{6DD5}\x{6DD8}\x{6DD9}\x{6DDE}\x{6DE1}' . +'\x{6DE4}\x{6DE6}\x{6DE8}\x{6DEA}\x{6DEB}\x{6DEC}\x{6DEE}\x{6DF1}\x{6DF3}' . +'\x{6DF5}\x{6DF7}\x{6DF9}\x{6DFA}\x{6DFB}\x{6E05}\x{6E07}\x{6E08}\x{6E09}' . +'\x{6E0A}\x{6E0B}\x{6E13}\x{6E15}\x{6E19}\x{6E1A}\x{6E1B}\x{6E1D}\x{6E1F}' . +'\x{6E20}\x{6E21}\x{6E23}\x{6E24}\x{6E25}\x{6E26}\x{6E29}\x{6E2B}\x{6E2C}' . +'\x{6E2D}\x{6E2E}\x{6E2F}\x{6E38}\x{6E3A}\x{6E3E}\x{6E43}\x{6E4A}\x{6E4D}' . +'\x{6E4E}\x{6E56}\x{6E58}\x{6E5B}\x{6E5F}\x{6E67}\x{6E6B}\x{6E6E}\x{6E6F}' . +'\x{6E72}\x{6E76}\x{6E7E}\x{6E7F}\x{6E80}\x{6E82}\x{6E8C}\x{6E8F}\x{6E90}' . +'\x{6E96}\x{6E98}\x{6E9C}\x{6E9D}\x{6E9F}\x{6EA2}\x{6EA5}\x{6EAA}\x{6EAF}' . +'\x{6EB2}\x{6EB6}\x{6EB7}\x{6EBA}\x{6EBD}\x{6EC2}\x{6EC4}\x{6EC5}\x{6EC9}' . +'\x{6ECB}\x{6ECC}\x{6ED1}\x{6ED3}\x{6ED4}\x{6ED5}\x{6EDD}\x{6EDE}\x{6EEC}' . +'\x{6EEF}\x{6EF2}\x{6EF4}\x{6EF7}\x{6EF8}\x{6EFE}\x{6EFF}\x{6F01}\x{6F02}' . +'\x{6F06}\x{6F09}\x{6F0F}\x{6F11}\x{6F13}\x{6F14}\x{6F15}\x{6F20}\x{6F22}' . +'\x{6F23}\x{6F2B}\x{6F2C}\x{6F31}\x{6F32}\x{6F38}\x{6F3E}\x{6F3F}\x{6F41}' . +'\x{6F45}\x{6F54}\x{6F58}\x{6F5B}\x{6F5C}\x{6F5F}\x{6F64}\x{6F66}\x{6F6D}' . +'\x{6F6E}\x{6F6F}\x{6F70}\x{6F74}\x{6F78}\x{6F7A}\x{6F7C}\x{6F80}\x{6F81}' . +'\x{6F82}\x{6F84}\x{6F86}\x{6F8E}\x{6F91}\x{6F97}\x{6FA1}\x{6FA3}\x{6FA4}' . +'\x{6FAA}\x{6FB1}\x{6FB3}\x{6FB9}\x{6FC0}\x{6FC1}\x{6FC2}\x{6FC3}\x{6FC6}' . +'\x{6FD4}\x{6FD5}\x{6FD8}\x{6FDB}\x{6FDF}\x{6FE0}\x{6FE1}\x{6FE4}\x{6FEB}' . +'\x{6FEC}\x{6FEE}\x{6FEF}\x{6FF1}\x{6FF3}\x{6FF6}\x{6FFA}\x{6FFE}\x{7001}' . +'\x{7009}\x{700B}\x{700F}\x{7011}\x{7015}\x{7018}\x{701A}\x{701B}\x{701D}' . +'\x{701E}\x{701F}\x{7026}\x{7027}\x{702C}\x{7030}\x{7032}\x{703E}\x{704C}' . +'\x{7051}\x{7058}\x{7063}\x{706B}\x{706F}\x{7070}\x{7078}\x{707C}\x{707D}' . +'\x{7089}\x{708A}\x{708E}\x{7092}\x{7099}\x{70AC}\x{70AD}\x{70AE}\x{70AF}' . +'\x{70B3}\x{70B8}\x{70B9}\x{70BA}\x{70C8}\x{70CB}\x{70CF}\x{70D9}\x{70DD}' . +'\x{70DF}\x{70F1}\x{70F9}\x{70FD}\x{7109}\x{7114}\x{7119}\x{711A}\x{711C}' . +'\x{7121}\x{7126}\x{7136}\x{713C}\x{7149}\x{714C}\x{714E}\x{7155}\x{7156}' . +'\x{7159}\x{7162}\x{7164}\x{7165}\x{7166}\x{7167}\x{7169}\x{716C}\x{716E}' . +'\x{717D}\x{7184}\x{7188}\x{718A}\x{718F}\x{7194}\x{7195}\x{7199}\x{719F}' . +'\x{71A8}\x{71AC}\x{71B1}\x{71B9}\x{71BE}\x{71C3}\x{71C8}\x{71C9}\x{71CE}' . +'\x{71D0}\x{71D2}\x{71D4}\x{71D5}\x{71D7}\x{71DF}\x{71E0}\x{71E5}\x{71E6}' . +'\x{71E7}\x{71EC}\x{71ED}\x{71EE}\x{71F5}\x{71F9}\x{71FB}\x{71FC}\x{71FF}' . +'\x{7206}\x{720D}\x{7210}\x{721B}\x{7228}\x{722A}\x{722C}\x{722D}\x{7230}' . +'\x{7232}\x{7235}\x{7236}\x{723A}\x{723B}\x{723C}\x{723D}\x{723E}\x{723F}' . +'\x{7240}\x{7246}\x{7247}\x{7248}\x{724B}\x{724C}\x{7252}\x{7258}\x{7259}' . +'\x{725B}\x{725D}\x{725F}\x{7261}\x{7262}\x{7267}\x{7269}\x{7272}\x{7274}' . +'\x{7279}\x{727D}\x{727E}\x{7280}\x{7281}\x{7282}\x{7287}\x{7292}\x{7296}' . +'\x{72A0}\x{72A2}\x{72A7}\x{72AC}\x{72AF}\x{72B2}\x{72B6}\x{72B9}\x{72C2}' . +'\x{72C3}\x{72C4}\x{72C6}\x{72CE}\x{72D0}\x{72D2}\x{72D7}\x{72D9}\x{72DB}' . +'\x{72E0}\x{72E1}\x{72E2}\x{72E9}\x{72EC}\x{72ED}\x{72F7}\x{72F8}\x{72F9}' . +'\x{72FC}\x{72FD}\x{730A}\x{7316}\x{7317}\x{731B}\x{731C}\x{731D}\x{731F}' . +'\x{7325}\x{7329}\x{732A}\x{732B}\x{732E}\x{732F}\x{7334}\x{7336}\x{7337}' . +'\x{733E}\x{733F}\x{7344}\x{7345}\x{734E}\x{734F}\x{7357}\x{7363}\x{7368}' . +'\x{736A}\x{7370}\x{7372}\x{7375}\x{7378}\x{737A}\x{737B}\x{7384}\x{7387}' . +'\x{7389}\x{738B}\x{7396}\x{73A9}\x{73B2}\x{73B3}\x{73BB}\x{73C0}\x{73C2}' . +'\x{73C8}\x{73CA}\x{73CD}\x{73CE}\x{73DE}\x{73E0}\x{73E5}\x{73EA}\x{73ED}' . +'\x{73EE}\x{73F1}\x{73F8}\x{73FE}\x{7403}\x{7405}\x{7406}\x{7409}\x{7422}' . +'\x{7425}\x{7432}\x{7433}\x{7434}\x{7435}\x{7436}\x{743A}\x{743F}\x{7441}' . +'\x{7455}\x{7459}\x{745A}\x{745B}\x{745C}\x{745E}\x{745F}\x{7460}\x{7463}' . +'\x{7464}\x{7469}\x{746A}\x{746F}\x{7470}\x{7473}\x{7476}\x{747E}\x{7483}' . +'\x{748B}\x{749E}\x{74A2}\x{74A7}\x{74B0}\x{74BD}\x{74CA}\x{74CF}\x{74D4}' . +'\x{74DC}\x{74E0}\x{74E2}\x{74E3}\x{74E6}\x{74E7}\x{74E9}\x{74EE}\x{74F0}' . +'\x{74F1}\x{74F2}\x{74F6}\x{74F7}\x{74F8}\x{7503}\x{7504}\x{7505}\x{750C}' . +'\x{750D}\x{750E}\x{7511}\x{7513}\x{7515}\x{7518}\x{751A}\x{751C}\x{751E}' . +'\x{751F}\x{7523}\x{7525}\x{7526}\x{7528}\x{752B}\x{752C}\x{7530}\x{7531}' . +'\x{7532}\x{7533}\x{7537}\x{7538}\x{753A}\x{753B}\x{753C}\x{7544}\x{7546}' . +'\x{7549}\x{754A}\x{754B}\x{754C}\x{754D}\x{754F}\x{7551}\x{7554}\x{7559}' . +'\x{755A}\x{755B}\x{755C}\x{755D}\x{7560}\x{7562}\x{7564}\x{7565}\x{7566}' . +'\x{7567}\x{7569}\x{756A}\x{756B}\x{756D}\x{7570}\x{7573}\x{7574}\x{7576}' . +'\x{7577}\x{7578}\x{757F}\x{7582}\x{7586}\x{7587}\x{7589}\x{758A}\x{758B}' . +'\x{758E}\x{758F}\x{7591}\x{7594}\x{759A}\x{759D}\x{75A3}\x{75A5}\x{75AB}' . +'\x{75B1}\x{75B2}\x{75B3}\x{75B5}\x{75B8}\x{75B9}\x{75BC}\x{75BD}\x{75BE}' . +'\x{75C2}\x{75C3}\x{75C5}\x{75C7}\x{75CA}\x{75CD}\x{75D2}\x{75D4}\x{75D5}' . +'\x{75D8}\x{75D9}\x{75DB}\x{75DE}\x{75E2}\x{75E3}\x{75E9}\x{75F0}\x{75F2}' . +'\x{75F3}\x{75F4}\x{75FA}\x{75FC}\x{75FE}\x{75FF}\x{7601}\x{7609}\x{760B}' . +'\x{760D}\x{761F}\x{7620}\x{7621}\x{7622}\x{7624}\x{7627}\x{7630}\x{7634}' . +'\x{763B}\x{7642}\x{7646}\x{7647}\x{7648}\x{764C}\x{7652}\x{7656}\x{7658}' . +'\x{765C}\x{7661}\x{7662}\x{7667}\x{7668}\x{7669}\x{766A}\x{766C}\x{7670}' . +'\x{7672}\x{7676}\x{7678}\x{767A}\x{767B}\x{767C}\x{767D}\x{767E}\x{7680}' . +'\x{7683}\x{7684}\x{7686}\x{7687}\x{7688}\x{768B}\x{768E}\x{7690}\x{7693}' . +'\x{7696}\x{7699}\x{769A}\x{76AE}\x{76B0}\x{76B4}\x{76B7}\x{76B8}\x{76B9}' . +'\x{76BA}\x{76BF}\x{76C2}\x{76C3}\x{76C6}\x{76C8}\x{76CA}\x{76CD}\x{76D2}' . +'\x{76D6}\x{76D7}\x{76DB}\x{76DC}\x{76DE}\x{76DF}\x{76E1}\x{76E3}\x{76E4}' . +'\x{76E5}\x{76E7}\x{76EA}\x{76EE}\x{76F2}\x{76F4}\x{76F8}\x{76FB}\x{76FE}' . +'\x{7701}\x{7704}\x{7707}\x{7708}\x{7709}\x{770B}\x{770C}\x{771B}\x{771E}' . +'\x{771F}\x{7720}\x{7724}\x{7725}\x{7726}\x{7729}\x{7737}\x{7738}\x{773A}' . +'\x{773C}\x{7740}\x{7747}\x{775A}\x{775B}\x{7761}\x{7763}\x{7765}\x{7766}' . +'\x{7768}\x{776B}\x{7779}\x{777E}\x{777F}\x{778B}\x{778E}\x{7791}\x{779E}' . +'\x{77A0}\x{77A5}\x{77AC}\x{77AD}\x{77B0}\x{77B3}\x{77B6}\x{77B9}\x{77BB}' . +'\x{77BC}\x{77BD}\x{77BF}\x{77C7}\x{77CD}\x{77D7}\x{77DA}\x{77DB}\x{77DC}' . +'\x{77E2}\x{77E3}\x{77E5}\x{77E7}\x{77E9}\x{77ED}\x{77EE}\x{77EF}\x{77F3}' . +'\x{77FC}\x{7802}\x{780C}\x{7812}\x{7814}\x{7815}\x{7820}\x{7825}\x{7826}' . +'\x{7827}\x{7832}\x{7834}\x{783A}\x{783F}\x{7845}\x{785D}\x{786B}\x{786C}' . +'\x{786F}\x{7872}\x{7874}\x{787C}\x{7881}\x{7886}\x{7887}\x{788C}\x{788D}' . +'\x{788E}\x{7891}\x{7893}\x{7895}\x{7897}\x{789A}\x{78A3}\x{78A7}\x{78A9}' . +'\x{78AA}\x{78AF}\x{78B5}\x{78BA}\x{78BC}\x{78BE}\x{78C1}\x{78C5}\x{78C6}' . +'\x{78CA}\x{78CB}\x{78D0}\x{78D1}\x{78D4}\x{78DA}\x{78E7}\x{78E8}\x{78EC}' . +'\x{78EF}\x{78F4}\x{78FD}\x{7901}\x{7907}\x{790E}\x{7911}\x{7912}\x{7919}' . +'\x{7926}\x{792A}\x{792B}\x{792C}\x{793A}\x{793C}\x{793E}\x{7940}\x{7941}' . +'\x{7947}\x{7948}\x{7949}\x{7950}\x{7953}\x{7955}\x{7956}\x{7957}\x{795A}' . +'\x{795D}\x{795E}\x{795F}\x{7960}\x{7962}\x{7965}\x{7968}\x{796D}\x{7977}' . +'\x{797A}\x{797F}\x{7980}\x{7981}\x{7984}\x{7985}\x{798A}\x{798D}\x{798E}' . +'\x{798F}\x{799D}\x{79A6}\x{79A7}\x{79AA}\x{79AE}\x{79B0}\x{79B3}\x{79B9}' . +'\x{79BA}\x{79BD}\x{79BE}\x{79BF}\x{79C0}\x{79C1}\x{79C9}\x{79CB}\x{79D1}' . +'\x{79D2}\x{79D5}\x{79D8}\x{79DF}\x{79E1}\x{79E3}\x{79E4}\x{79E6}\x{79E7}' . +'\x{79E9}\x{79EC}\x{79F0}\x{79FB}\x{7A00}\x{7A08}\x{7A0B}\x{7A0D}\x{7A0E}' . +'\x{7A14}\x{7A17}\x{7A18}\x{7A19}\x{7A1A}\x{7A1C}\x{7A1F}\x{7A20}\x{7A2E}' . +'\x{7A31}\x{7A32}\x{7A37}\x{7A3B}\x{7A3C}\x{7A3D}\x{7A3E}\x{7A3F}\x{7A40}' . +'\x{7A42}\x{7A43}\x{7A46}\x{7A49}\x{7A4D}\x{7A4E}\x{7A4F}\x{7A50}\x{7A57}' . +'\x{7A61}\x{7A62}\x{7A63}\x{7A69}\x{7A6B}\x{7A70}\x{7A74}\x{7A76}\x{7A79}' . +'\x{7A7A}\x{7A7D}\x{7A7F}\x{7A81}\x{7A83}\x{7A84}\x{7A88}\x{7A92}\x{7A93}' . +'\x{7A95}\x{7A96}\x{7A97}\x{7A98}\x{7A9F}\x{7AA9}\x{7AAA}\x{7AAE}\x{7AAF}' . +'\x{7AB0}\x{7AB6}\x{7ABA}\x{7ABF}\x{7AC3}\x{7AC4}\x{7AC5}\x{7AC7}\x{7AC8}' . +'\x{7ACA}\x{7ACB}\x{7ACD}\x{7ACF}\x{7AD2}\x{7AD3}\x{7AD5}\x{7AD9}\x{7ADA}' . +'\x{7ADC}\x{7ADD}\x{7ADF}\x{7AE0}\x{7AE1}\x{7AE2}\x{7AE3}\x{7AE5}\x{7AE6}' . +'\x{7AEA}\x{7AED}\x{7AEF}\x{7AF0}\x{7AF6}\x{7AF8}\x{7AF9}\x{7AFA}\x{7AFF}' . +'\x{7B02}\x{7B04}\x{7B06}\x{7B08}\x{7B0A}\x{7B0B}\x{7B0F}\x{7B11}\x{7B18}' . +'\x{7B19}\x{7B1B}\x{7B1E}\x{7B20}\x{7B25}\x{7B26}\x{7B28}\x{7B2C}\x{7B33}' . +'\x{7B35}\x{7B36}\x{7B39}\x{7B45}\x{7B46}\x{7B48}\x{7B49}\x{7B4B}\x{7B4C}' . +'\x{7B4D}\x{7B4F}\x{7B50}\x{7B51}\x{7B52}\x{7B54}\x{7B56}\x{7B5D}\x{7B65}' . +'\x{7B67}\x{7B6C}\x{7B6E}\x{7B70}\x{7B71}\x{7B74}\x{7B75}\x{7B7A}\x{7B86}' . +'\x{7B87}\x{7B8B}\x{7B8D}\x{7B8F}\x{7B92}\x{7B94}\x{7B95}\x{7B97}\x{7B98}' . +'\x{7B99}\x{7B9A}\x{7B9C}\x{7B9D}\x{7B9F}\x{7BA1}\x{7BAA}\x{7BAD}\x{7BB1}' . +'\x{7BB4}\x{7BB8}\x{7BC0}\x{7BC1}\x{7BC4}\x{7BC6}\x{7BC7}\x{7BC9}\x{7BCB}' . +'\x{7BCC}\x{7BCF}\x{7BDD}\x{7BE0}\x{7BE4}\x{7BE5}\x{7BE6}\x{7BE9}\x{7BED}' . +'\x{7BF3}\x{7BF6}\x{7BF7}\x{7C00}\x{7C07}\x{7C0D}\x{7C11}\x{7C12}\x{7C13}' . +'\x{7C14}\x{7C17}\x{7C1F}\x{7C21}\x{7C23}\x{7C27}\x{7C2A}\x{7C2B}\x{7C37}' . +'\x{7C38}\x{7C3D}\x{7C3E}\x{7C3F}\x{7C40}\x{7C43}\x{7C4C}\x{7C4D}\x{7C4F}' . +'\x{7C50}\x{7C54}\x{7C56}\x{7C58}\x{7C5F}\x{7C60}\x{7C64}\x{7C65}\x{7C6C}' . +'\x{7C73}\x{7C75}\x{7C7E}\x{7C81}\x{7C82}\x{7C83}\x{7C89}\x{7C8B}\x{7C8D}' . +'\x{7C90}\x{7C92}\x{7C95}\x{7C97}\x{7C98}\x{7C9B}\x{7C9F}\x{7CA1}\x{7CA2}' . +'\x{7CA4}\x{7CA5}\x{7CA7}\x{7CA8}\x{7CAB}\x{7CAD}\x{7CAE}\x{7CB1}\x{7CB2}' . +'\x{7CB3}\x{7CB9}\x{7CBD}\x{7CBE}\x{7CC0}\x{7CC2}\x{7CC5}\x{7CCA}\x{7CCE}' . +'\x{7CD2}\x{7CD6}\x{7CD8}\x{7CDC}\x{7CDE}\x{7CDF}\x{7CE0}\x{7CE2}\x{7CE7}' . +'\x{7CEF}\x{7CF2}\x{7CF4}\x{7CF6}\x{7CF8}\x{7CFA}\x{7CFB}\x{7CFE}\x{7D00}' . +'\x{7D02}\x{7D04}\x{7D05}\x{7D06}\x{7D0A}\x{7D0B}\x{7D0D}\x{7D10}\x{7D14}' . +'\x{7D15}\x{7D17}\x{7D18}\x{7D19}\x{7D1A}\x{7D1B}\x{7D1C}\x{7D20}\x{7D21}' . +'\x{7D22}\x{7D2B}\x{7D2C}\x{7D2E}\x{7D2F}\x{7D30}\x{7D32}\x{7D33}\x{7D35}' . +'\x{7D39}\x{7D3A}\x{7D3F}\x{7D42}\x{7D43}\x{7D44}\x{7D45}\x{7D46}\x{7D4B}' . +'\x{7D4C}\x{7D4E}\x{7D4F}\x{7D50}\x{7D56}\x{7D5B}\x{7D5E}\x{7D61}\x{7D62}' . +'\x{7D63}\x{7D66}\x{7D68}\x{7D6E}\x{7D71}\x{7D72}\x{7D73}\x{7D75}\x{7D76}' . +'\x{7D79}\x{7D7D}\x{7D89}\x{7D8F}\x{7D93}\x{7D99}\x{7D9A}\x{7D9B}\x{7D9C}' . +'\x{7D9F}\x{7DA2}\x{7DA3}\x{7DAB}\x{7DAC}\x{7DAD}\x{7DAE}\x{7DAF}\x{7DB0}' . +'\x{7DB1}\x{7DB2}\x{7DB4}\x{7DB5}\x{7DB8}\x{7DBA}\x{7DBB}\x{7DBD}\x{7DBE}' . +'\x{7DBF}\x{7DC7}\x{7DCA}\x{7DCB}\x{7DCF}\x{7DD1}\x{7DD2}\x{7DD5}\x{7DD8}' . +'\x{7DDA}\x{7DDC}\x{7DDD}\x{7DDE}\x{7DE0}\x{7DE1}\x{7DE4}\x{7DE8}\x{7DE9}' . +'\x{7DEC}\x{7DEF}\x{7DF2}\x{7DF4}\x{7DFB}\x{7E01}\x{7E04}\x{7E05}\x{7E09}' . +'\x{7E0A}\x{7E0B}\x{7E12}\x{7E1B}\x{7E1E}\x{7E1F}\x{7E21}\x{7E22}\x{7E23}' . +'\x{7E26}\x{7E2B}\x{7E2E}\x{7E31}\x{7E32}\x{7E35}\x{7E37}\x{7E39}\x{7E3A}' . +'\x{7E3B}\x{7E3D}\x{7E3E}\x{7E41}\x{7E43}\x{7E46}\x{7E4A}\x{7E4B}\x{7E4D}' . +'\x{7E54}\x{7E55}\x{7E56}\x{7E59}\x{7E5A}\x{7E5D}\x{7E5E}\x{7E66}\x{7E67}' . +'\x{7E69}\x{7E6A}\x{7E6D}\x{7E70}\x{7E79}\x{7E7B}\x{7E7C}\x{7E7D}\x{7E7F}' . +'\x{7E82}\x{7E83}\x{7E88}\x{7E89}\x{7E8C}\x{7E8E}\x{7E8F}\x{7E90}\x{7E92}' . +'\x{7E93}\x{7E94}\x{7E96}\x{7E9B}\x{7E9C}\x{7F36}\x{7F38}\x{7F3A}\x{7F45}' . +'\x{7F4C}\x{7F4D}\x{7F4E}\x{7F50}\x{7F51}\x{7F54}\x{7F55}\x{7F58}\x{7F5F}' . +'\x{7F60}\x{7F67}\x{7F68}\x{7F69}\x{7F6A}\x{7F6B}\x{7F6E}\x{7F70}\x{7F72}' . +'\x{7F75}\x{7F77}\x{7F78}\x{7F79}\x{7F82}\x{7F83}\x{7F85}\x{7F86}\x{7F87}' . +'\x{7F88}\x{7F8A}\x{7F8C}\x{7F8E}\x{7F94}\x{7F9A}\x{7F9D}\x{7F9E}\x{7FA3}' . +'\x{7FA4}\x{7FA8}\x{7FA9}\x{7FAE}\x{7FAF}\x{7FB2}\x{7FB6}\x{7FB8}\x{7FB9}' . +'\x{7FBD}\x{7FC1}\x{7FC5}\x{7FC6}\x{7FCA}\x{7FCC}\x{7FD2}\x{7FD4}\x{7FD5}' . +'\x{7FE0}\x{7FE1}\x{7FE6}\x{7FE9}\x{7FEB}\x{7FF0}\x{7FF3}\x{7FF9}\x{7FFB}' . +'\x{7FFC}\x{8000}\x{8001}\x{8003}\x{8004}\x{8005}\x{8006}\x{800B}\x{800C}' . +'\x{8010}\x{8012}\x{8015}\x{8017}\x{8018}\x{8019}\x{801C}\x{8021}\x{8028}' . +'\x{8033}\x{8036}\x{803B}\x{803D}\x{803F}\x{8046}\x{804A}\x{8052}\x{8056}' . +'\x{8058}\x{805A}\x{805E}\x{805F}\x{8061}\x{8062}\x{8068}\x{806F}\x{8070}' . +'\x{8072}\x{8073}\x{8074}\x{8076}\x{8077}\x{8079}\x{807D}\x{807E}\x{807F}' . +'\x{8084}\x{8085}\x{8086}\x{8087}\x{8089}\x{808B}\x{808C}\x{8093}\x{8096}' . +'\x{8098}\x{809A}\x{809B}\x{809D}\x{80A1}\x{80A2}\x{80A5}\x{80A9}\x{80AA}' . +'\x{80AC}\x{80AD}\x{80AF}\x{80B1}\x{80B2}\x{80B4}\x{80BA}\x{80C3}\x{80C4}' . +'\x{80C6}\x{80CC}\x{80CE}\x{80D6}\x{80D9}\x{80DA}\x{80DB}\x{80DD}\x{80DE}' . +'\x{80E1}\x{80E4}\x{80E5}\x{80EF}\x{80F1}\x{80F4}\x{80F8}\x{80FC}\x{80FD}' . +'\x{8102}\x{8105}\x{8106}\x{8107}\x{8108}\x{8109}\x{810A}\x{811A}\x{811B}' . +'\x{8123}\x{8129}\x{812F}\x{8131}\x{8133}\x{8139}\x{813E}\x{8146}\x{814B}' . +'\x{814E}\x{8150}\x{8151}\x{8153}\x{8154}\x{8155}\x{815F}\x{8165}\x{8166}' . +'\x{816B}\x{816E}\x{8170}\x{8171}\x{8174}\x{8178}\x{8179}\x{817A}\x{817F}' . +'\x{8180}\x{8182}\x{8183}\x{8188}\x{818A}\x{818F}\x{8193}\x{8195}\x{819A}' . +'\x{819C}\x{819D}\x{81A0}\x{81A3}\x{81A4}\x{81A8}\x{81A9}\x{81B0}\x{81B3}' . +'\x{81B5}\x{81B8}\x{81BA}\x{81BD}\x{81BE}\x{81BF}\x{81C0}\x{81C2}\x{81C6}' . +'\x{81C8}\x{81C9}\x{81CD}\x{81D1}\x{81D3}\x{81D8}\x{81D9}\x{81DA}\x{81DF}' . +'\x{81E0}\x{81E3}\x{81E5}\x{81E7}\x{81E8}\x{81EA}\x{81ED}\x{81F3}\x{81F4}' . +'\x{81FA}\x{81FB}\x{81FC}\x{81FE}\x{8201}\x{8202}\x{8205}\x{8207}\x{8208}' . +'\x{8209}\x{820A}\x{820C}\x{820D}\x{820E}\x{8210}\x{8212}\x{8216}\x{8217}' . +'\x{8218}\x{821B}\x{821C}\x{821E}\x{821F}\x{8229}\x{822A}\x{822B}\x{822C}' . +'\x{822E}\x{8233}\x{8235}\x{8236}\x{8237}\x{8238}\x{8239}\x{8240}\x{8247}' . +'\x{8258}\x{8259}\x{825A}\x{825D}\x{825F}\x{8262}\x{8264}\x{8266}\x{8268}' . +'\x{826A}\x{826B}\x{826E}\x{826F}\x{8271}\x{8272}\x{8276}\x{8277}\x{8278}' . +'\x{827E}\x{828B}\x{828D}\x{8292}\x{8299}\x{829D}\x{829F}\x{82A5}\x{82A6}' . +'\x{82AB}\x{82AC}\x{82AD}\x{82AF}\x{82B1}\x{82B3}\x{82B8}\x{82B9}\x{82BB}' . +'\x{82BD}\x{82C5}\x{82D1}\x{82D2}\x{82D3}\x{82D4}\x{82D7}\x{82D9}\x{82DB}' . +'\x{82DC}\x{82DE}\x{82DF}\x{82E1}\x{82E3}\x{82E5}\x{82E6}\x{82E7}\x{82EB}' . +'\x{82F1}\x{82F3}\x{82F4}\x{82F9}\x{82FA}\x{82FB}\x{8302}\x{8303}\x{8304}' . +'\x{8305}\x{8306}\x{8309}\x{830E}\x{8316}\x{8317}\x{8318}\x{831C}\x{8323}' . +'\x{8328}\x{832B}\x{832F}\x{8331}\x{8332}\x{8334}\x{8335}\x{8336}\x{8338}' . +'\x{8339}\x{8340}\x{8345}\x{8349}\x{834A}\x{834F}\x{8350}\x{8352}\x{8358}' . +'\x{8373}\x{8375}\x{8377}\x{837B}\x{837C}\x{8385}\x{8387}\x{8389}\x{838A}' . +'\x{838E}\x{8393}\x{8396}\x{839A}\x{839E}\x{839F}\x{83A0}\x{83A2}\x{83A8}' . +'\x{83AA}\x{83AB}\x{83B1}\x{83B5}\x{83BD}\x{83C1}\x{83C5}\x{83CA}\x{83CC}' . +'\x{83CE}\x{83D3}\x{83D6}\x{83D8}\x{83DC}\x{83DF}\x{83E0}\x{83E9}\x{83EB}' . +'\x{83EF}\x{83F0}\x{83F1}\x{83F2}\x{83F4}\x{83F7}\x{83FB}\x{83FD}\x{8403}' . +'\x{8404}\x{8407}\x{840B}\x{840C}\x{840D}\x{840E}\x{8413}\x{8420}\x{8422}' . +'\x{8429}\x{842A}\x{842C}\x{8431}\x{8435}\x{8438}\x{843C}\x{843D}\x{8446}' . +'\x{8449}\x{844E}\x{8457}\x{845B}\x{8461}\x{8462}\x{8463}\x{8466}\x{8469}' . +'\x{846B}\x{846C}\x{846D}\x{846E}\x{846F}\x{8471}\x{8475}\x{8477}\x{8479}' . +'\x{847A}\x{8482}\x{8484}\x{848B}\x{8490}\x{8494}\x{8499}\x{849C}\x{849F}' . +'\x{84A1}\x{84AD}\x{84B2}\x{84B8}\x{84B9}\x{84BB}\x{84BC}\x{84BF}\x{84C1}' . +'\x{84C4}\x{84C6}\x{84C9}\x{84CA}\x{84CB}\x{84CD}\x{84D0}\x{84D1}\x{84D6}' . +'\x{84D9}\x{84DA}\x{84EC}\x{84EE}\x{84F4}\x{84FC}\x{84FF}\x{8500}\x{8506}' . +'\x{8511}\x{8513}\x{8514}\x{8515}\x{8517}\x{8518}\x{851A}\x{851F}\x{8521}' . +'\x{8526}\x{852C}\x{852D}\x{8535}\x{853D}\x{8540}\x{8541}\x{8543}\x{8548}' . +'\x{8549}\x{854A}\x{854B}\x{854E}\x{8555}\x{8557}\x{8558}\x{855A}\x{8563}' . +'\x{8568}\x{8569}\x{856A}\x{856D}\x{8577}\x{857E}\x{8580}\x{8584}\x{8587}' . +'\x{8588}\x{858A}\x{8590}\x{8591}\x{8594}\x{8597}\x{8599}\x{859B}\x{859C}' . +'\x{85A4}\x{85A6}\x{85A8}\x{85A9}\x{85AA}\x{85AB}\x{85AC}\x{85AE}\x{85AF}' . +'\x{85B9}\x{85BA}\x{85C1}\x{85C9}\x{85CD}\x{85CF}\x{85D0}\x{85D5}\x{85DC}' . +'\x{85DD}\x{85E4}\x{85E5}\x{85E9}\x{85EA}\x{85F7}\x{85F9}\x{85FA}\x{85FB}' . +'\x{85FE}\x{8602}\x{8606}\x{8607}\x{860A}\x{860B}\x{8613}\x{8616}\x{8617}' . +'\x{861A}\x{8622}\x{862D}\x{862F}\x{8630}\x{863F}\x{864D}\x{864E}\x{8650}' . +'\x{8654}\x{8655}\x{865A}\x{865C}\x{865E}\x{865F}\x{8667}\x{866B}\x{8671}' . +'\x{8679}\x{867B}\x{868A}\x{868B}\x{868C}\x{8693}\x{8695}\x{86A3}\x{86A4}' . +'\x{86A9}\x{86AA}\x{86AB}\x{86AF}\x{86B0}\x{86B6}\x{86C4}\x{86C6}\x{86C7}' . +'\x{86C9}\x{86CB}\x{86CD}\x{86CE}\x{86D4}\x{86D9}\x{86DB}\x{86DE}\x{86DF}' . +'\x{86E4}\x{86E9}\x{86EC}\x{86ED}\x{86EE}\x{86EF}\x{86F8}\x{86F9}\x{86FB}' . +'\x{86FE}\x{8700}\x{8702}\x{8703}\x{8706}\x{8708}\x{8709}\x{870A}\x{870D}' . +'\x{8711}\x{8712}\x{8718}\x{871A}\x{871C}\x{8725}\x{8729}\x{8734}\x{8737}' . +'\x{873B}\x{873F}\x{8749}\x{874B}\x{874C}\x{874E}\x{8753}\x{8755}\x{8757}' . +'\x{8759}\x{875F}\x{8760}\x{8763}\x{8766}\x{8768}\x{876A}\x{876E}\x{8774}' . +'\x{8776}\x{8778}\x{877F}\x{8782}\x{878D}\x{879F}\x{87A2}\x{87AB}\x{87AF}' . +'\x{87B3}\x{87BA}\x{87BB}\x{87BD}\x{87C0}\x{87C4}\x{87C6}\x{87C7}\x{87CB}' . +'\x{87D0}\x{87D2}\x{87E0}\x{87EF}\x{87F2}\x{87F6}\x{87F7}\x{87F9}\x{87FB}' . +'\x{87FE}\x{8805}\x{880D}\x{880E}\x{880F}\x{8811}\x{8815}\x{8816}\x{8821}' . +'\x{8822}\x{8823}\x{8827}\x{8831}\x{8836}\x{8839}\x{883B}\x{8840}\x{8842}' . +'\x{8844}\x{8846}\x{884C}\x{884D}\x{8852}\x{8853}\x{8857}\x{8859}\x{885B}' . +'\x{885D}\x{885E}\x{8861}\x{8862}\x{8863}\x{8868}\x{886B}\x{8870}\x{8872}' . +'\x{8875}\x{8877}\x{887D}\x{887E}\x{887F}\x{8881}\x{8882}\x{8888}\x{888B}' . +'\x{888D}\x{8892}\x{8896}\x{8897}\x{8899}\x{889E}\x{88A2}\x{88A4}\x{88AB}' . +'\x{88AE}\x{88B0}\x{88B1}\x{88B4}\x{88B5}\x{88B7}\x{88BF}\x{88C1}\x{88C2}' . +'\x{88C3}\x{88C4}\x{88C5}\x{88CF}\x{88D4}\x{88D5}\x{88D8}\x{88D9}\x{88DC}' . +'\x{88DD}\x{88DF}\x{88E1}\x{88E8}\x{88F2}\x{88F3}\x{88F4}\x{88F8}\x{88F9}' . +'\x{88FC}\x{88FD}\x{88FE}\x{8902}\x{8904}\x{8907}\x{890A}\x{890C}\x{8910}' . +'\x{8912}\x{8913}\x{891D}\x{891E}\x{8925}\x{892A}\x{892B}\x{8936}\x{8938}' . +'\x{893B}\x{8941}\x{8943}\x{8944}\x{894C}\x{894D}\x{8956}\x{895E}\x{895F}' . +'\x{8960}\x{8964}\x{8966}\x{896A}\x{896D}\x{896F}\x{8972}\x{8974}\x{8977}' . +'\x{897E}\x{897F}\x{8981}\x{8983}\x{8986}\x{8987}\x{8988}\x{898A}\x{898B}' . +'\x{898F}\x{8993}\x{8996}\x{8997}\x{8998}\x{899A}\x{89A1}\x{89A6}\x{89A7}' . +'\x{89A9}\x{89AA}\x{89AC}\x{89AF}\x{89B2}\x{89B3}\x{89BA}\x{89BD}\x{89BF}' . +'\x{89C0}\x{89D2}\x{89DA}\x{89DC}\x{89DD}\x{89E3}\x{89E6}\x{89E7}\x{89F4}' . +'\x{89F8}\x{8A00}\x{8A02}\x{8A03}\x{8A08}\x{8A0A}\x{8A0C}\x{8A0E}\x{8A10}' . +'\x{8A13}\x{8A16}\x{8A17}\x{8A18}\x{8A1B}\x{8A1D}\x{8A1F}\x{8A23}\x{8A25}' . +'\x{8A2A}\x{8A2D}\x{8A31}\x{8A33}\x{8A34}\x{8A36}\x{8A3A}\x{8A3B}\x{8A3C}' . +'\x{8A41}\x{8A46}\x{8A48}\x{8A50}\x{8A51}\x{8A52}\x{8A54}\x{8A55}\x{8A5B}' . +'\x{8A5E}\x{8A60}\x{8A62}\x{8A63}\x{8A66}\x{8A69}\x{8A6B}\x{8A6C}\x{8A6D}' . +'\x{8A6E}\x{8A70}\x{8A71}\x{8A72}\x{8A73}\x{8A7C}\x{8A82}\x{8A84}\x{8A85}' . +'\x{8A87}\x{8A89}\x{8A8C}\x{8A8D}\x{8A91}\x{8A93}\x{8A95}\x{8A98}\x{8A9A}' . +'\x{8A9E}\x{8AA0}\x{8AA1}\x{8AA3}\x{8AA4}\x{8AA5}\x{8AA6}\x{8AA8}\x{8AAC}' . +'\x{8AAD}\x{8AB0}\x{8AB2}\x{8AB9}\x{8ABC}\x{8ABF}\x{8AC2}\x{8AC4}\x{8AC7}' . +'\x{8ACB}\x{8ACC}\x{8ACD}\x{8ACF}\x{8AD2}\x{8AD6}\x{8ADA}\x{8ADB}\x{8ADC}' . +'\x{8ADE}\x{8AE0}\x{8AE1}\x{8AE2}\x{8AE4}\x{8AE6}\x{8AE7}\x{8AEB}\x{8AED}' . +'\x{8AEE}\x{8AF1}\x{8AF3}\x{8AF7}\x{8AF8}\x{8AFA}\x{8AFE}\x{8B00}\x{8B01}' . +'\x{8B02}\x{8B04}\x{8B07}\x{8B0C}\x{8B0E}\x{8B10}\x{8B14}\x{8B16}\x{8B17}' . +'\x{8B19}\x{8B1A}\x{8B1B}\x{8B1D}\x{8B20}\x{8B21}\x{8B26}\x{8B28}\x{8B2B}' . +'\x{8B2C}\x{8B33}\x{8B39}\x{8B3E}\x{8B41}\x{8B49}\x{8B4C}\x{8B4E}\x{8B4F}' . +'\x{8B56}\x{8B58}\x{8B5A}\x{8B5B}\x{8B5C}\x{8B5F}\x{8B66}\x{8B6B}\x{8B6C}' . +'\x{8B6F}\x{8B70}\x{8B71}\x{8B72}\x{8B74}\x{8B77}\x{8B7D}\x{8B80}\x{8B83}' . +'\x{8B8A}\x{8B8C}\x{8B8E}\x{8B90}\x{8B92}\x{8B93}\x{8B96}\x{8B99}\x{8B9A}' . +'\x{8C37}\x{8C3A}\x{8C3F}\x{8C41}\x{8C46}\x{8C48}\x{8C4A}\x{8C4C}\x{8C4E}' . +'\x{8C50}\x{8C55}\x{8C5A}\x{8C61}\x{8C62}\x{8C6A}\x{8C6B}\x{8C6C}\x{8C78}' . +'\x{8C79}\x{8C7A}\x{8C7C}\x{8C82}\x{8C85}\x{8C89}\x{8C8A}\x{8C8C}\x{8C8D}' . +'\x{8C8E}\x{8C94}\x{8C98}\x{8C9D}\x{8C9E}\x{8CA0}\x{8CA1}\x{8CA2}\x{8CA7}' . +'\x{8CA8}\x{8CA9}\x{8CAA}\x{8CAB}\x{8CAC}\x{8CAD}\x{8CAE}\x{8CAF}\x{8CB0}' . +'\x{8CB2}\x{8CB3}\x{8CB4}\x{8CB6}\x{8CB7}\x{8CB8}\x{8CBB}\x{8CBC}\x{8CBD}' . +'\x{8CBF}\x{8CC0}\x{8CC1}\x{8CC2}\x{8CC3}\x{8CC4}\x{8CC7}\x{8CC8}\x{8CCA}' . +'\x{8CCD}\x{8CCE}\x{8CD1}\x{8CD3}\x{8CDA}\x{8CDB}\x{8CDC}\x{8CDE}\x{8CE0}' . +'\x{8CE2}\x{8CE3}\x{8CE4}\x{8CE6}\x{8CEA}\x{8CED}\x{8CFA}\x{8CFB}\x{8CFC}' . +'\x{8CFD}\x{8D04}\x{8D05}\x{8D07}\x{8D08}\x{8D0A}\x{8D0B}\x{8D0D}\x{8D0F}' . +'\x{8D10}\x{8D13}\x{8D14}\x{8D16}\x{8D64}\x{8D66}\x{8D67}\x{8D6B}\x{8D6D}' . +'\x{8D70}\x{8D71}\x{8D73}\x{8D74}\x{8D77}\x{8D81}\x{8D85}\x{8D8A}\x{8D99}' . +'\x{8DA3}\x{8DA8}\x{8DB3}\x{8DBA}\x{8DBE}\x{8DC2}\x{8DCB}\x{8DCC}\x{8DCF}' . +'\x{8DD6}\x{8DDA}\x{8DDB}\x{8DDD}\x{8DDF}\x{8DE1}\x{8DE3}\x{8DE8}\x{8DEA}' . +'\x{8DEB}\x{8DEF}\x{8DF3}\x{8DF5}\x{8DFC}\x{8DFF}\x{8E08}\x{8E09}\x{8E0A}' . +'\x{8E0F}\x{8E10}\x{8E1D}\x{8E1E}\x{8E1F}\x{8E2A}\x{8E30}\x{8E34}\x{8E35}' . +'\x{8E42}\x{8E44}\x{8E47}\x{8E48}\x{8E49}\x{8E4A}\x{8E4C}\x{8E50}\x{8E55}' . +'\x{8E59}\x{8E5F}\x{8E60}\x{8E63}\x{8E64}\x{8E72}\x{8E74}\x{8E76}\x{8E7C}' . +'\x{8E81}\x{8E84}\x{8E85}\x{8E87}\x{8E8A}\x{8E8B}\x{8E8D}\x{8E91}\x{8E93}' . +'\x{8E94}\x{8E99}\x{8EA1}\x{8EAA}\x{8EAB}\x{8EAC}\x{8EAF}\x{8EB0}\x{8EB1}' . +'\x{8EBE}\x{8EC5}\x{8EC6}\x{8EC8}\x{8ECA}\x{8ECB}\x{8ECC}\x{8ECD}\x{8ED2}' . +'\x{8EDB}\x{8EDF}\x{8EE2}\x{8EE3}\x{8EEB}\x{8EF8}\x{8EFB}\x{8EFC}\x{8EFD}' . +'\x{8EFE}\x{8F03}\x{8F05}\x{8F09}\x{8F0A}\x{8F0C}\x{8F12}\x{8F13}\x{8F14}' . +'\x{8F15}\x{8F19}\x{8F1B}\x{8F1C}\x{8F1D}\x{8F1F}\x{8F26}\x{8F29}\x{8F2A}' . +'\x{8F2F}\x{8F33}\x{8F38}\x{8F39}\x{8F3B}\x{8F3E}\x{8F3F}\x{8F42}\x{8F44}' . +'\x{8F45}\x{8F46}\x{8F49}\x{8F4C}\x{8F4D}\x{8F4E}\x{8F57}\x{8F5C}\x{8F5F}' . +'\x{8F61}\x{8F62}\x{8F63}\x{8F64}\x{8F9B}\x{8F9C}\x{8F9E}\x{8F9F}\x{8FA3}' . +'\x{8FA7}\x{8FA8}\x{8FAD}\x{8FAE}\x{8FAF}\x{8FB0}\x{8FB1}\x{8FB2}\x{8FB7}' . +'\x{8FBA}\x{8FBB}\x{8FBC}\x{8FBF}\x{8FC2}\x{8FC4}\x{8FC5}\x{8FCE}\x{8FD1}' . +'\x{8FD4}\x{8FDA}\x{8FE2}\x{8FE5}\x{8FE6}\x{8FE9}\x{8FEA}\x{8FEB}\x{8FED}' . +'\x{8FEF}\x{8FF0}\x{8FF4}\x{8FF7}\x{8FF8}\x{8FF9}\x{8FFA}\x{8FFD}\x{9000}' . +'\x{9001}\x{9003}\x{9005}\x{9006}\x{900B}\x{900D}\x{900E}\x{900F}\x{9010}' . +'\x{9011}\x{9013}\x{9014}\x{9015}\x{9016}\x{9017}\x{9019}\x{901A}\x{901D}' . +'\x{901E}\x{901F}\x{9020}\x{9021}\x{9022}\x{9023}\x{9027}\x{902E}\x{9031}' . +'\x{9032}\x{9035}\x{9036}\x{9038}\x{9039}\x{903C}\x{903E}\x{9041}\x{9042}' . +'\x{9045}\x{9047}\x{9049}\x{904A}\x{904B}\x{904D}\x{904E}\x{904F}\x{9050}' . +'\x{9051}\x{9052}\x{9053}\x{9054}\x{9055}\x{9056}\x{9058}\x{9059}\x{905C}' . +'\x{905E}\x{9060}\x{9061}\x{9063}\x{9065}\x{9068}\x{9069}\x{906D}\x{906E}' . +'\x{906F}\x{9072}\x{9075}\x{9076}\x{9077}\x{9078}\x{907A}\x{907C}\x{907D}' . +'\x{907F}\x{9080}\x{9081}\x{9082}\x{9083}\x{9084}\x{9087}\x{9089}\x{908A}' . +'\x{908F}\x{9091}\x{90A3}\x{90A6}\x{90A8}\x{90AA}\x{90AF}\x{90B1}\x{90B5}' . +'\x{90B8}\x{90C1}\x{90CA}\x{90CE}\x{90DB}\x{90E1}\x{90E2}\x{90E4}\x{90E8}' . +'\x{90ED}\x{90F5}\x{90F7}\x{90FD}\x{9102}\x{9112}\x{9119}\x{912D}\x{9130}' . +'\x{9132}\x{9149}\x{914A}\x{914B}\x{914C}\x{914D}\x{914E}\x{9152}\x{9154}' . +'\x{9156}\x{9158}\x{9162}\x{9163}\x{9165}\x{9169}\x{916A}\x{916C}\x{9172}' . +'\x{9173}\x{9175}\x{9177}\x{9178}\x{9182}\x{9187}\x{9189}\x{918B}\x{918D}' . +'\x{9190}\x{9192}\x{9197}\x{919C}\x{91A2}\x{91A4}\x{91AA}\x{91AB}\x{91AF}' . +'\x{91B4}\x{91B5}\x{91B8}\x{91BA}\x{91C0}\x{91C1}\x{91C6}\x{91C7}\x{91C8}' . +'\x{91C9}\x{91CB}\x{91CC}\x{91CD}\x{91CE}\x{91CF}\x{91D0}\x{91D1}\x{91D6}' . +'\x{91D8}\x{91DB}\x{91DC}\x{91DD}\x{91DF}\x{91E1}\x{91E3}\x{91E6}\x{91E7}' . +'\x{91F5}\x{91F6}\x{91FC}\x{91FF}\x{920D}\x{920E}\x{9211}\x{9214}\x{9215}' . +'\x{921E}\x{9229}\x{922C}\x{9234}\x{9237}\x{923F}\x{9244}\x{9245}\x{9248}' . +'\x{9249}\x{924B}\x{9250}\x{9257}\x{925A}\x{925B}\x{925E}\x{9262}\x{9264}' . +'\x{9266}\x{9271}\x{927E}\x{9280}\x{9283}\x{9285}\x{9291}\x{9293}\x{9295}' . +'\x{9296}\x{9298}\x{929A}\x{929B}\x{929C}\x{92AD}\x{92B7}\x{92B9}\x{92CF}' . +'\x{92D2}\x{92E4}\x{92E9}\x{92EA}\x{92ED}\x{92F2}\x{92F3}\x{92F8}\x{92FA}' . +'\x{92FC}\x{9306}\x{930F}\x{9310}\x{9318}\x{9319}\x{931A}\x{9320}\x{9322}' . +'\x{9323}\x{9326}\x{9328}\x{932B}\x{932C}\x{932E}\x{932F}\x{9332}\x{9335}' . +'\x{933A}\x{933B}\x{9344}\x{934B}\x{934D}\x{9354}\x{9356}\x{935B}\x{935C}' . +'\x{9360}\x{936C}\x{936E}\x{9375}\x{937C}\x{937E}\x{938C}\x{9394}\x{9396}' . +'\x{9397}\x{939A}\x{93A7}\x{93AC}\x{93AD}\x{93AE}\x{93B0}\x{93B9}\x{93C3}' . +'\x{93C8}\x{93D0}\x{93D1}\x{93D6}\x{93D7}\x{93D8}\x{93DD}\x{93E1}\x{93E4}' . +'\x{93E5}\x{93E8}\x{9403}\x{9407}\x{9410}\x{9413}\x{9414}\x{9418}\x{9419}' . +'\x{941A}\x{9421}\x{942B}\x{9435}\x{9436}\x{9438}\x{943A}\x{9441}\x{9444}' . +'\x{9451}\x{9452}\x{9453}\x{945A}\x{945B}\x{945E}\x{9460}\x{9462}\x{946A}' . +'\x{9470}\x{9475}\x{9477}\x{947C}\x{947D}\x{947E}\x{947F}\x{9481}\x{9577}' . +'\x{9580}\x{9582}\x{9583}\x{9587}\x{9589}\x{958A}\x{958B}\x{958F}\x{9591}' . +'\x{9593}\x{9594}\x{9596}\x{9598}\x{9599}\x{95A0}\x{95A2}\x{95A3}\x{95A4}' . +'\x{95A5}\x{95A7}\x{95A8}\x{95AD}\x{95B2}\x{95B9}\x{95BB}\x{95BC}\x{95BE}' . +'\x{95C3}\x{95C7}\x{95CA}\x{95CC}\x{95CD}\x{95D4}\x{95D5}\x{95D6}\x{95D8}' . +'\x{95DC}\x{95E1}\x{95E2}\x{95E5}\x{961C}\x{9621}\x{9628}\x{962A}\x{962E}' . +'\x{962F}\x{9632}\x{963B}\x{963F}\x{9640}\x{9642}\x{9644}\x{964B}\x{964C}' . +'\x{964D}\x{964F}\x{9650}\x{965B}\x{965C}\x{965D}\x{965E}\x{965F}\x{9662}' . +'\x{9663}\x{9664}\x{9665}\x{9666}\x{966A}\x{966C}\x{9670}\x{9672}\x{9673}' . +'\x{9675}\x{9676}\x{9677}\x{9678}\x{967A}\x{967D}\x{9685}\x{9686}\x{9688}' . +'\x{968A}\x{968B}\x{968D}\x{968E}\x{968F}\x{9694}\x{9695}\x{9697}\x{9698}' . +'\x{9699}\x{969B}\x{969C}\x{96A0}\x{96A3}\x{96A7}\x{96A8}\x{96AA}\x{96B0}' . +'\x{96B1}\x{96B2}\x{96B4}\x{96B6}\x{96B7}\x{96B8}\x{96B9}\x{96BB}\x{96BC}' . +'\x{96C0}\x{96C1}\x{96C4}\x{96C5}\x{96C6}\x{96C7}\x{96C9}\x{96CB}\x{96CC}' . +'\x{96CD}\x{96CE}\x{96D1}\x{96D5}\x{96D6}\x{96D9}\x{96DB}\x{96DC}\x{96E2}' . +'\x{96E3}\x{96E8}\x{96EA}\x{96EB}\x{96F0}\x{96F2}\x{96F6}\x{96F7}\x{96F9}' . +'\x{96FB}\x{9700}\x{9704}\x{9706}\x{9707}\x{9708}\x{970A}\x{970D}\x{970E}' . +'\x{970F}\x{9711}\x{9713}\x{9716}\x{9719}\x{971C}\x{971E}\x{9724}\x{9727}' . +'\x{972A}\x{9730}\x{9732}\x{9738}\x{9739}\x{973D}\x{973E}\x{9742}\x{9744}' . +'\x{9746}\x{9748}\x{9749}\x{9752}\x{9756}\x{9759}\x{975C}\x{975E}\x{9760}' . +'\x{9761}\x{9762}\x{9764}\x{9766}\x{9768}\x{9769}\x{976B}\x{976D}\x{9771}' . +'\x{9774}\x{9779}\x{977A}\x{977C}\x{9781}\x{9784}\x{9785}\x{9786}\x{978B}' . +'\x{978D}\x{978F}\x{9790}\x{9798}\x{979C}\x{97A0}\x{97A3}\x{97A6}\x{97A8}' . +'\x{97AB}\x{97AD}\x{97B3}\x{97B4}\x{97C3}\x{97C6}\x{97C8}\x{97CB}\x{97D3}' . +'\x{97DC}\x{97ED}\x{97EE}\x{97F2}\x{97F3}\x{97F5}\x{97F6}\x{97FB}\x{97FF}' . +'\x{9801}\x{9802}\x{9803}\x{9805}\x{9806}\x{9808}\x{980C}\x{980F}\x{9810}' . +'\x{9811}\x{9812}\x{9813}\x{9817}\x{9818}\x{981A}\x{9821}\x{9824}\x{982C}' . +'\x{982D}\x{9834}\x{9837}\x{9838}\x{983B}\x{983C}\x{983D}\x{9846}\x{984B}' . +'\x{984C}\x{984D}\x{984E}\x{984F}\x{9854}\x{9855}\x{9858}\x{985B}\x{985E}' . +'\x{9867}\x{986B}\x{986F}\x{9870}\x{9871}\x{9873}\x{9874}\x{98A8}\x{98AA}' . +'\x{98AF}\x{98B1}\x{98B6}\x{98C3}\x{98C4}\x{98C6}\x{98DB}\x{98DC}\x{98DF}' . +'\x{98E2}\x{98E9}\x{98EB}\x{98ED}\x{98EE}\x{98EF}\x{98F2}\x{98F4}\x{98FC}' . +'\x{98FD}\x{98FE}\x{9903}\x{9905}\x{9909}\x{990A}\x{990C}\x{9910}\x{9912}' . +'\x{9913}\x{9914}\x{9918}\x{991D}\x{991E}\x{9920}\x{9921}\x{9924}\x{9928}' . +'\x{992C}\x{992E}\x{993D}\x{993E}\x{9942}\x{9945}\x{9949}\x{994B}\x{994C}' . +'\x{9950}\x{9951}\x{9952}\x{9955}\x{9957}\x{9996}\x{9997}\x{9998}\x{9999}' . +'\x{99A5}\x{99A8}\x{99AC}\x{99AD}\x{99AE}\x{99B3}\x{99B4}\x{99BC}\x{99C1}' . +'\x{99C4}\x{99C5}\x{99C6}\x{99C8}\x{99D0}\x{99D1}\x{99D2}\x{99D5}\x{99D8}' . +'\x{99DB}\x{99DD}\x{99DF}\x{99E2}\x{99ED}\x{99EE}\x{99F1}\x{99F2}\x{99F8}' . +'\x{99FB}\x{99FF}\x{9A01}\x{9A05}\x{9A0E}\x{9A0F}\x{9A12}\x{9A13}\x{9A19}' . +'\x{9A28}\x{9A2B}\x{9A30}\x{9A37}\x{9A3E}\x{9A40}\x{9A42}\x{9A43}\x{9A45}' . +'\x{9A4D}\x{9A55}\x{9A57}\x{9A5A}\x{9A5B}\x{9A5F}\x{9A62}\x{9A64}\x{9A65}' . +'\x{9A69}\x{9A6A}\x{9A6B}\x{9AA8}\x{9AAD}\x{9AB0}\x{9AB8}\x{9ABC}\x{9AC0}' . +'\x{9AC4}\x{9ACF}\x{9AD1}\x{9AD3}\x{9AD4}\x{9AD8}\x{9ADE}\x{9ADF}\x{9AE2}' . +'\x{9AE3}\x{9AE6}\x{9AEA}\x{9AEB}\x{9AED}\x{9AEE}\x{9AEF}\x{9AF1}\x{9AF4}' . +'\x{9AF7}\x{9AFB}\x{9B06}\x{9B18}\x{9B1A}\x{9B1F}\x{9B22}\x{9B23}\x{9B25}' . +'\x{9B27}\x{9B28}\x{9B29}\x{9B2A}\x{9B2E}\x{9B2F}\x{9B31}\x{9B32}\x{9B3B}' . +'\x{9B3C}\x{9B41}\x{9B42}\x{9B43}\x{9B44}\x{9B45}\x{9B4D}\x{9B4E}\x{9B4F}' . +'\x{9B51}\x{9B54}\x{9B58}\x{9B5A}\x{9B6F}\x{9B74}\x{9B83}\x{9B8E}\x{9B91}' . +'\x{9B92}\x{9B93}\x{9B96}\x{9B97}\x{9B9F}\x{9BA0}\x{9BA8}\x{9BAA}\x{9BAB}' . +'\x{9BAD}\x{9BAE}\x{9BB4}\x{9BB9}\x{9BC0}\x{9BC6}\x{9BC9}\x{9BCA}\x{9BCF}' . +'\x{9BD1}\x{9BD2}\x{9BD4}\x{9BD6}\x{9BDB}\x{9BE1}\x{9BE2}\x{9BE3}\x{9BE4}' . +'\x{9BE8}\x{9BF0}\x{9BF1}\x{9BF2}\x{9BF5}\x{9C04}\x{9C06}\x{9C08}\x{9C09}' . +'\x{9C0A}\x{9C0C}\x{9C0D}\x{9C10}\x{9C12}\x{9C13}\x{9C14}\x{9C15}\x{9C1B}' . +'\x{9C21}\x{9C24}\x{9C25}\x{9C2D}\x{9C2E}\x{9C2F}\x{9C30}\x{9C32}\x{9C39}' . +'\x{9C3A}\x{9C3B}\x{9C3E}\x{9C46}\x{9C47}\x{9C48}\x{9C52}\x{9C57}\x{9C5A}' . +'\x{9C60}\x{9C67}\x{9C76}\x{9C78}\x{9CE5}\x{9CE7}\x{9CE9}\x{9CEB}\x{9CEC}' . +'\x{9CF0}\x{9CF3}\x{9CF4}\x{9CF6}\x{9D03}\x{9D06}\x{9D07}\x{9D08}\x{9D09}' . +'\x{9D0E}\x{9D12}\x{9D15}\x{9D1B}\x{9D1F}\x{9D23}\x{9D26}\x{9D28}\x{9D2A}' . +'\x{9D2B}\x{9D2C}\x{9D3B}\x{9D3E}\x{9D3F}\x{9D41}\x{9D44}\x{9D46}\x{9D48}' . +'\x{9D50}\x{9D51}\x{9D59}\x{9D5C}\x{9D5D}\x{9D5E}\x{9D60}\x{9D61}\x{9D64}' . +'\x{9D6C}\x{9D6F}\x{9D72}\x{9D7A}\x{9D87}\x{9D89}\x{9D8F}\x{9D9A}\x{9DA4}' . +'\x{9DA9}\x{9DAB}\x{9DAF}\x{9DB2}\x{9DB4}\x{9DB8}\x{9DBA}\x{9DBB}\x{9DC1}' . +'\x{9DC2}\x{9DC4}\x{9DC6}\x{9DCF}\x{9DD3}\x{9DD9}\x{9DE6}\x{9DED}\x{9DEF}' . +'\x{9DF2}\x{9DF8}\x{9DF9}\x{9DFA}\x{9DFD}\x{9E1A}\x{9E1B}\x{9E1E}\x{9E75}' . +'\x{9E78}\x{9E79}\x{9E7D}\x{9E7F}\x{9E81}\x{9E88}\x{9E8B}\x{9E8C}\x{9E91}' . +'\x{9E92}\x{9E93}\x{9E95}\x{9E97}\x{9E9D}\x{9E9F}\x{9EA5}\x{9EA6}\x{9EA9}' . +'\x{9EAA}\x{9EAD}\x{9EB8}\x{9EB9}\x{9EBA}\x{9EBB}\x{9EBC}\x{9EBE}\x{9EBF}' . +'\x{9EC4}\x{9ECC}\x{9ECD}\x{9ECE}\x{9ECF}\x{9ED0}\x{9ED2}\x{9ED4}\x{9ED8}' . +'\x{9ED9}\x{9EDB}\x{9EDC}\x{9EDD}\x{9EDE}\x{9EE0}\x{9EE5}\x{9EE8}\x{9EEF}' . +'\x{9EF4}\x{9EF6}\x{9EF7}\x{9EF9}\x{9EFB}\x{9EFC}\x{9EFD}\x{9F07}\x{9F08}' . +'\x{9F0E}\x{9F13}\x{9F15}\x{9F20}\x{9F21}\x{9F2C}\x{9F3B}\x{9F3E}\x{9F4A}' . +'\x{9F4B}\x{9F4E}\x{9F4F}\x{9F52}\x{9F54}\x{9F5F}\x{9F60}\x{9F61}\x{9F62}' . +'\x{9F63}\x{9F66}\x{9F67}\x{9F6A}\x{9F6C}\x{9F72}\x{9F76}\x{9F77}\x{9F8D}' . +'\x{9F95}\x{9F9C}\x{9F9D}\x{9FA0}]{1,15}$/iu'); diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Iban.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Iban.php new file mode 100644 index 0000000..80b0d23 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Iban.php @@ -0,0 +1,250 @@ + "Unknown country within the IBAN '%value%'", + self::FALSEFORMAT => "'%value%' has a false IBAN format", + self::CHECKFAILED => "'%value%' has failed the IBAN check", + ); + + /** + * Optional locale + * + * @var string|Postman_Zend_Locale|null + */ + protected $_locale; + + /** + * IBAN regexes by region + * + * @var array + */ + protected $_ibanregex = array( + 'AD' => '/^AD[0-9]{2}[0-9]{8}[A-Z0-9]{12}$/', + 'AE' => '/^AE[0-9]{2}[0-9]{3}[0-9]{16}$/', + 'AL' => '/^AL[0-9]{2}[0-9]{8}[A-Z0-9]{16}$/', + 'AT' => '/^AT[0-9]{2}[0-9]{5}[0-9]{11}$/', + 'AZ' => '/^AZ[0-9]{2}[0-9]{4}[A-Z0-9]{20}$/', + 'BA' => '/^BA[0-9]{2}[0-9]{6}[0-9]{10}$/', + 'BE' => '/^BE[0-9]{2}[0-9]{3}[0-9]{9}$/', + 'BG' => '/^BG[0-9]{2}[A-Z]{4}[0-9]{4}[0-9]{2}[A-Z0-9]{8}$/', + 'BH' => '/^BH[0-9]{2}[A-Z]{4}[A-Z0-9]{14}$/', + 'BR' => '/^BR[0-9]{2}[0-9]{8}[0-9]{5}[0-9]{10}[A-Z]{1}[A-Z0-9]{1}$/', + 'CH' => '/^CH[0-9]{2}[0-9]{5}[A-Z0-9]{12}$/', + 'CR' => '/^CR[0-9]{2}[0-9]{3}[0-9]{14}$/', + 'CS' => '/^CS[0-9]{2}[0-9]{3}[0-9]{15}$/', + 'CY' => '/^CY[0-9]{2}[0-9]{8}[A-Z0-9]{16}$/', + 'CZ' => '/^CZ[0-9]{2}[0-9]{4}[0-9]{16}$/', + 'DE' => '/^DE[0-9]{2}[0-9]{8}[0-9]{10}$/', + 'DK' => '/^DK[0-9]{2}[0-9]{4}[0-9]{10}$/', + 'DO' => '/^DO[0-9]{2}[A-Z0-9]{4}[0-9]{20}$/', + 'EE' => '/^EE[0-9]{2}[0-9]{4}[0-9]{12}$/', + 'ES' => '/^ES[0-9]{2}[0-9]{8}[0-9]{12}$/', + 'FR' => '/^FR[0-9]{2}[0-9]{10}[A-Z0-9]{11}[0-9]{2}$/', + 'FI' => '/^FI[0-9]{2}[0-9]{6}[0-9]{8}$/', + 'FO' => '/^FO[0-9]{2}[0-9]{4}[0-9]{9}[0-9]{1}$/', + 'GB' => '/^GB[0-9]{2}[A-Z]{4}[0-9]{14}$/', + 'GE' => '/^GE[0-9]{2}[A-Z]{2}[0-9]{16}$/', + 'GI' => '/^GI[0-9]{2}[A-Z]{4}[A-Z0-9]{15}$/', + 'GL' => '/^GL[0-9]{2}[0-9]{4}[0-9]{9}[0-9]{1}$/', + 'GR' => '/^GR[0-9]{2}[0-9]{7}[A-Z0-9]{16}$/', + 'GT' => '/^GT[0-9]{2}[A-Z0-9]{4}[A-Z0-9]{20}$/', + 'HR' => '/^HR[0-9]{2}[0-9]{7}[0-9]{10}$/', + 'HU' => '/^HU[0-9]{2}[0-9]{7}[0-9]{1}[0-9]{15}[0-9]{1}$/', + 'IE' => '/^IE[0-9]{2}[A-Z0-9]{4}[0-9]{6}[0-9]{8}$/', + 'IL' => '/^IL[0-9]{2}[0-9]{3}[0-9]{3}[0-9]{13}$/', + 'IS' => '/^IS[0-9]{2}[0-9]{4}[0-9]{18}$/', + 'IT' => '/^IT[0-9]{2}[A-Z]{1}[0-9]{10}[A-Z0-9]{12}$/', + 'KW' => '/^KW[0-9]{2}[A-Z]{4}[0-9]{3}[0-9]{22}$/', + 'KZ' => '/^KZ[A-Z]{2}[0-9]{2}[0-9]{3}[A-Z0-9]{13}$/', + 'LB' => '/^LB[0-9]{2}[0-9]{4}[A-Z0-9]{20}$/', + 'LI' => '/^LI[0-9]{2}[0-9]{5}[A-Z0-9]{12}$/', + 'LU' => '/^LU[0-9]{2}[0-9]{3}[A-Z0-9]{13}$/', + 'LT' => '/^LT[0-9]{2}[0-9]{5}[0-9]{11}$/', + 'LV' => '/^LV[0-9]{2}[A-Z]{4}[A-Z0-9]{13}$/', + 'MC' => '/^MC[0-9]{2}[0-9]{5}[0-9]{5}[A-Z0-9]{11}[0-9]{2}$/', + 'MD' => '/^MD[0-9]{2}[A-Z0-9]{20}$/', + 'ME' => '/^ME[0-9]{2}[0-9]{3}[0-9]{13}[0-9]{2}$/', + 'MK' => '/^MK[0-9]{2}[A-Z]{3}[A-Z0-9]{10}[0-9]{2}$/', + 'MR' => '/^MR13[0-9]{5}[0-9]{5}[0-9]{11}[0-9]{2}$/', + 'MU' => '/^MU[0-9]{2}[A-Z]{4}[0-9]{2}[0-9]{2}[0-9]{12}[0-9]{3}[A-Z]{2}$/', + 'MT' => '/^MT[0-9]{2}[A-Z]{4}[0-9]{5}[A-Z0-9]{18}$/', + 'NL' => '/^NL[0-9]{2}[A-Z]{4}[0-9]{10}$/', + 'NO' => '/^NO[0-9]{2}[0-9]{4}[0-9]{7}$/', + 'PK' => '/^PK[0-9]{2}[A-Z]{4}[0-9]{16}$/', + 'PL' => '/^PL[0-9]{2}[0-9]{8}[0-9]{16}$/', + 'PS' => '/^PS[0-9]{2}[A-Z]{4}[0-9]{21}$/', + 'PT' => '/^PT[0-9]{2}[0-9]{8}[0-9]{13}$/', + 'RO' => '/^RO[0-9]{2}[A-Z]{4}[A-Z0-9]{16}$/', + 'RS' => '/^RS[0-9]{2}[0-9]{3}[0-9]{13}[0-9]{2}$/', + 'SA' => '/^SA[0-9]{2}[0-9]{2}[A-Z0-9]{18}$/', + 'SE' => '/^SE[0-9]{2}[0-9]{3}[0-9]{17}$/', + 'SI' => '/^SI[0-9]{2}[0-9]{5}[0-9]{8}[0-9]{2}$/', + 'SK' => '/^SK[0-9]{2}[0-9]{4}[0-9]{16}$/', + 'SM' => '/^SM[0-9]{2}[A-Z]{1}[0-9]{5}[0-9]{5}[A-Z0-9]{12}$/', + 'TN' => '/^TN[0-9]{2}[0-9]{5}[0-9]{15}$/', + 'TR' => '/^TR[0-9]{2}[0-9]{5}[A-Z0-9]{17}$/', + 'VG' => '/^VG[0-9]{2}[A-Z]{4}[0-9]{16}$/' + ); + + /** + * Sets validator options + * + * @param string|Postman_Zend_Config|Postman_Zend_Locale $locale OPTIONAL + */ + public function __construct($locale = null) + { + if ($locale instanceof Postman_Zend_Config) { + $locale = $locale->toArray(); + } + + if (is_array($locale)) { + if (array_key_exists('locale', $locale)) { + $locale = $locale['locale']; + } else { + $locale = null; + } + } + + if (empty($locale)) { + require_once 'Zend/Registry.php'; + if (Postman_Zend_Registry::isRegistered('Postman_Zend_Locale')) { + $locale = Postman_Zend_Registry::get('Postman_Zend_Locale'); + } + } + + if ($locale !== null) { + $this->setLocale($locale); + } + } + + /** + * Returns the locale option + * + * @return string|Postman_Zend_Locale|null + */ + public function getLocale() + { + return $this->_locale; + } + + /** + * Sets the locale option + * + * @param string|Postman_Zend_Locale $locale + * @throws Postman_Zend_Locale_Exception + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_Date provides a fluent interface + */ + public function setLocale($locale = null) + { + if ($locale !== false) { + require_once 'Zend/Locale.php'; + $locale = Postman_Zend_Locale::findLocale($locale); + if (strlen($locale) < 4) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Region must be given for IBAN validation'); + } + } + + $this->_locale = $locale; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if $value is a valid IBAN + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + $value = strtoupper($value); + $this->_setValue($value); + + if (empty($this->_locale)) { + $region = substr($value, 0, 2); + } else { + $region = new Postman_Zend_Locale($this->_locale); + $region = $region->getRegion(); + } + + if (!array_key_exists($region, $this->_ibanregex)) { + $this->_setValue($region); + $this->_error(self::NOTSUPPORTED); + return false; + } + + if (!preg_match($this->_ibanregex[$region], $value)) { + $this->_error(self::FALSEFORMAT); + return false; + } + + $format = substr($value, 4) . substr($value, 0, 4); + $format = str_replace( + array('A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', + 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'), + array('10', '11', '12', '13', '14', '15', '16', '17', '18', '19', '20', '21', '22', + '23', '24', '25', '26', '27', '28', '29', '30', '31', '32', '33', '34', '35'), + $format); + + $temp = intval(substr($format, 0, 1)); + $len = strlen($format); + for ($x = 1; $x < $len; ++$x) { + $temp *= 10; + $temp += intval(substr($format, $x, 1)); + $temp %= 97; + } + + if ($temp != 1) { + $this->_error(self::CHECKFAILED); + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Identical.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Identical.php new file mode 100644 index 0000000..61c3de2 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Identical.php @@ -0,0 +1,164 @@ + "The two given tokens do not match", + self::MISSING_TOKEN => 'No token was provided to match against', + ); + + /** + * @var array + */ + protected $_messageVariables = array( + 'token' => '_tokenString' + ); + + /** + * Original token against which to validate + * @var string + */ + protected $_tokenString; + protected $_token; + protected $_strict = true; + + /** + * Sets validator options + * + * @param mixed $token + */ + public function __construct($token = null) + { + if ($token instanceof Postman_Zend_Config) { + $token = $token->toArray(); + } + + if (is_array($token) && array_key_exists('token', $token)) { + if (array_key_exists('strict', $token)) { + $this->setStrict($token['strict']); + } + + $this->setToken($token['token']); + } else if (null !== $token) { + $this->setToken($token); + } + } + + /** + * Retrieve token + * + * @return string + */ + public function getToken() + { + return $this->_token; + } + + /** + * Set token against which to compare + * + * @param mixed $token + * @return Postman_Zend_Validate_Identical + */ + public function setToken($token) + { + $this->_tokenString = $token; + $this->_token = $token; + return $this; + } + + /** + * Returns the strict parameter + * + * @return boolean + */ + public function getStrict() + { + return $this->_strict; + } + + /** + * Sets the strict parameter + * + * @param Postman_Zend_Validate_Identical + * @return $this + */ + public function setStrict($strict) + { + $this->_strict = (boolean) $strict; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if a token has been set and the provided value + * matches that token. + * + * @param mixed $value + * @param array $context + * @return boolean + */ + public function isValid($value, $context = null) + { + $this->_setValue($value); + + if (($context !== null) && isset($context) && array_key_exists($this->getToken(), $context)) { + $token = $context[$this->getToken()]; + } else { + $token = $this->getToken(); + } + + if ($token === null) { + $this->_error(self::MISSING_TOKEN); + return false; + } + + $strict = $this->getStrict(); + if (($strict && ($value !== $token)) || (!$strict && ($value != $token))) { + $this->_error(self::NOT_SAME); + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/InArray.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/InArray.php new file mode 100644 index 0000000..4283666 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/InArray.php @@ -0,0 +1,204 @@ + "'%value%' was not found in the haystack", + ); + + /** + * Haystack of possible values + * + * @var array + */ + protected $_haystack; + + /** + * Whether a strict in_array() invocation is used + * + * @var boolean + */ + protected $_strict = false; + + /** + * Whether a recursive search should be done + * + * @var boolean + */ + protected $_recursive = false; + + /** + * Sets validator options + * + * @param array|Postman_Zend_Config $options Validator options + * @throws Postman_Zend_Validate_Exception + */ + public function __construct($options) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } else if (!is_array($options)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Array expected as parameter'); + } else { + $count = func_num_args(); + $temp = array(); + if ($count > 1) { + $temp['haystack'] = func_get_arg(0); + $temp['strict'] = func_get_arg(1); + $options = $temp; + } else { + $temp = func_get_arg(0); + if (!array_key_exists('haystack', $options)) { + $options = array(); + $options['haystack'] = $temp; + } else { + $options = $temp; + } + } + } + + $this->setHaystack($options['haystack']); + if (array_key_exists('strict', $options)) { + $this->setStrict($options['strict']); + } + + if (array_key_exists('recursive', $options)) { + $this->setRecursive($options['recursive']); + } + } + + /** + * Returns the haystack option + * + * @return mixed + */ + public function getHaystack() + { + return $this->_haystack; + } + + /** + * Sets the haystack option + * + * @param mixed $haystack + * @return Postman_Zend_Validate_InArray Provides a fluent interface + */ + public function setHaystack(array $haystack) + { + $this->_haystack = $haystack; + return $this; + } + + /** + * Returns the strict option + * + * @return boolean + */ + public function getStrict() + { + return $this->_strict; + } + + /** + * Sets the strict option + * + * @param boolean $strict + * @return Postman_Zend_Validate_InArray Provides a fluent interface + */ + public function setStrict($strict) + { + $this->_strict = (boolean) $strict; + return $this; + } + + /** + * Returns the recursive option + * + * @return boolean + */ + public function getRecursive() + { + return $this->_recursive; + } + + /** + * Sets the recursive option + * + * @param boolean $recursive + * @return Postman_Zend_Validate_InArray Provides a fluent interface + */ + public function setRecursive($recursive) + { + $this->_recursive = (boolean) $recursive; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is contained in the haystack option. If the strict + * option is true, then the type of $value is also checked. + * + * @param mixed $value + * @return boolean + */ + public function isValid($value) + { + $this->_setValue($value); + if ($this->getRecursive()) { + $iterator = new RecursiveIteratorIterator(new RecursiveArrayIterator($this->_haystack)); + foreach($iterator as $element) { + if ($this->_strict) { + if ($element === $value) { + return true; + } + } else if ($element == $value) { + return true; + } + } + } else { + if (in_array($value, $this->_haystack, $this->_strict)) { + return true; + } + } + + $this->_error(self::NOT_IN_ARRAY); + return false; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Int.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Int.php new file mode 100644 index 0000000..9dd128c --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Int.php @@ -0,0 +1,149 @@ + "Invalid type given. String or integer expected", + self::NOT_INT => "'%value%' does not appear to be an integer", + ); + + protected $_locale; + + /** + * Constructor for the integer validator + * + * @param string|Postman_Zend_Config|Postman_Zend_Locale $locale + */ + public function __construct($locale = null) + { + if ($locale instanceof Postman_Zend_Config) { + $locale = $locale->toArray(); + } + + if (is_array($locale)) { + if (array_key_exists('locale', $locale)) { + $locale = $locale['locale']; + } else { + $locale = null; + } + } + + if (empty($locale)) { + require_once 'Zend/Registry.php'; + if (Postman_Zend_Registry::isRegistered('Postman_Zend_Locale')) { + $locale = Postman_Zend_Registry::get('Postman_Zend_Locale'); + } + } + + if ($locale !== null) { + $this->setLocale($locale); + } + } + + /** + * Returns the set locale + */ + public function getLocale() + { + return $this->_locale; + } + + /** + * Sets the locale to use + * + * @param string|Postman_Zend_Locale $locale + * @return $this + */ + public function setLocale($locale = null) + { + require_once 'Zend/Locale.php'; + $this->_locale = Postman_Zend_Locale::findLocale($locale); + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is a valid integer + * + * @param string|integer $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value) && !is_int($value) && !is_float($value)) { + $this->_error(self::INVALID); + return false; + } + + if (is_int($value)) { + return true; + } + + $this->_setValue($value); + if ($this->_locale === null) { + $locale = localeconv(); + $valueFiltered = str_replace($locale['decimal_point'], '.', $value); + $valueFiltered = str_replace($locale['thousands_sep'], '', $valueFiltered); + + if (strval(intval($valueFiltered)) != $valueFiltered) { + $this->_error(self::NOT_INT); + return false; + } + + } else { + try { + if (!Postman_Zend_Locale_Format::isInteger($value, array('locale' => $this->_locale))) { + $this->_error(self::NOT_INT); + return false; + } + } catch (Postman_Zend_Locale_Exception $e) { + $this->_error(self::NOT_INT); + return false; + } + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Interface.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Interface.php new file mode 100644 index 0000000..532f868 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Interface.php @@ -0,0 +1,54 @@ + "Invalid type given. String expected", + self::NOT_IP_ADDRESS => "'%value%' does not appear to be a valid IP address", + ); + + /** + * internal options + * + * @var array + */ + protected $_options = array( + 'allowipv6' => true, + 'allowipv4' => true + ); + + /** + * Sets validator options + * + * @param array $options OPTIONAL Options to set, see the manual for all available options + */ + public function __construct($options = array()) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } else if (!is_array($options)) { + $options = func_get_args(); + $temp['allowipv6'] = array_shift($options); + if (!empty($options)) { + $temp['allowipv4'] = array_shift($options); + } + + $options = $temp; + } + + $options += $this->_options; + $this->setOptions($options); + } + + /** + * Returns all set options + * + * @return array + */ + public function getOptions() + { + return $this->_options; + } + + /** + * Sets the options for this validator + * + * @param array $options + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_Ip + */ + public function setOptions($options) + { + if (array_key_exists('allowipv6', $options)) { + $this->_options['allowipv6'] = (boolean) $options['allowipv6']; + } + + if (array_key_exists('allowipv4', $options)) { + $this->_options['allowipv4'] = (boolean) $options['allowipv4']; + } + + if (!$this->_options['allowipv4'] && !$this->_options['allowipv6']) { + // require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Nothing to validate. Check your options'); + } + + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is a valid IP address + * + * @param mixed $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue($value); + if (($this->_options['allowipv4'] && !$this->_options['allowipv6'] && !$this->_validateIPv4($value)) || + (!$this->_options['allowipv4'] && $this->_options['allowipv6'] && !$this->_validateIPv6($value)) || + ($this->_options['allowipv4'] && $this->_options['allowipv6'] && !$this->_validateIPv4($value) && !$this->_validateIPv6($value))) { + $this->_error(self::NOT_IP_ADDRESS); + return false; + } + + return true; + } + + /** + * Validates an IPv4 address + * + * @param string $value + * @return bool + */ + protected function _validateIPv4($value) { + $ip2long = ip2long($value); + if($ip2long === false) { + return false; + } + + return $value == long2ip($ip2long); + } + + /** + * Validates an IPv6 address + * + * @param string $value Value to check against + * @return boolean True when $value is a valid ipv6 address + * False otherwise + */ + protected function _validateIPv6($value) { + if (strlen($value) < 3) { + return $value == '::'; + } + + if (strpos($value, '.')) { + $lastcolon = strrpos($value, ':'); + if (!($lastcolon && $this->_validateIPv4(substr($value, $lastcolon + 1)))) { + return false; + } + + $value = substr($value, 0, $lastcolon) . ':0:0'; + } + + if (strpos($value, '::') === false) { + return preg_match('/\A(?:[a-f0-9]{1,4}:){7}[a-f0-9]{1,4}\z/i', $value); + } + + $colonCount = substr_count($value, ':'); + if ($colonCount < 8) { + return preg_match('/\A(?::|(?:[a-f0-9]{1,4}:)+):(?:(?:[a-f0-9]{1,4}:)*[a-f0-9]{1,4})?\z/i', $value); + } + + // special case with ending or starting double colon + if ($colonCount == 8) { + return preg_match('/\A(?:::)?(?:[a-f0-9]{1,4}:){6}[a-f0-9]{1,4}(?:::)?\z/i', $value); + } + + return false; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Isbn.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Isbn.php new file mode 100644 index 0000000..342abca --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Isbn.php @@ -0,0 +1,278 @@ + "Invalid type given. String or integer expected", + self::NO_ISBN => "'%value%' is not a valid ISBN number", + ); + + /** + * Allowed type. + * + * @var string + */ + protected $_type = self::AUTO; + + /** + * Separator character. + * + * @var string + */ + protected $_separator = ''; + + /** + * Set up options. + * + * @param Postman_Zend_Config|array $options + * @throws Postman_Zend_Validate_Exception When $options is not valid + */ + public function __construct($options = array()) + { + // prepare options + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } + if (!is_array($options)) { + /** + * @see Postman_Zend_Validate_Exception + */ + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Invalid options provided.'); + } + + // set type + if (array_key_exists('type', $options)) { + $this->setType($options['type']); + } + + // set separator + if (array_key_exists('separator', $options)) { + $this->setSeparator($options['separator']); + } + } + + /** + * Detect input format. + * + * @return string + */ + protected function _detectFormat() + { + // prepare separator and pattern list + $sep = quotemeta($this->_separator); + $patterns = array(); + $lengths = array(); + + // check for ISBN-10 + if ($this->_type == self::ISBN10 || $this->_type == self::AUTO) { + if (empty($sep)) { + $pattern = '/^[0-9]{9}[0-9X]{1}$/'; + $length = 10; + } else { + $pattern = "/^[0-9]{1,7}[{$sep}]{1}[0-9]{1,7}[{$sep}]{1}[0-9]{1,7}[{$sep}]{1}[0-9X]{1}$/"; + $length = 13; + } + + $patterns[$pattern] = self::ISBN10; + $lengths[$pattern] = $length; + } + + // check for ISBN-13 + if ($this->_type == self::ISBN13 || $this->_type == self::AUTO) { + if (empty($sep)) { + $pattern = '/^[0-9]{13}$/'; + $length = 13; + } else { + $pattern = "/^[0-9]{1,9}[{$sep}]{1}[0-9]{1,5}[{$sep}]{1}[0-9]{1,9}[{$sep}]{1}[0-9]{1,9}[{$sep}]{1}[0-9]{1}$/"; + $length = 17; + } + + $patterns[$pattern] = self::ISBN13; + $lengths[$pattern] = $length; + } + + // check pattern list + foreach ($patterns as $pattern => $type) { + if ((strlen($this->_value) == $lengths[$pattern]) && preg_match($pattern, $this->_value)) { + return $type; + } + } + + return null; + } + + /** + * Defined by Postman_Zend_Validate_Interface. + * + * Returns true if and only if $value is a valid ISBN. + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value) && !is_int($value)) { + $this->_error(self::INVALID); + return false; + } + + $value = (string) $value; + $this->_setValue($value); + + switch ($this->_detectFormat()) { + case self::ISBN10: + // sum + $isbn10 = str_replace($this->_separator, '', $value); + $sum = 0; + for ($i = 0; $i < 9; $i++) { + $sum += (10 - $i) * $isbn10{$i}; + } + + // checksum + $checksum = 11 - ($sum % 11); + if ($checksum == 11) { + $checksum = '0'; + } elseif ($checksum == 10) { + $checksum = 'X'; + } + break; + + case self::ISBN13: + // sum + $isbn13 = str_replace($this->_separator, '', $value); + $sum = 0; + for ($i = 0; $i < 12; $i++) { + if ($i % 2 == 0) { + $sum += $isbn13{$i}; + } else { + $sum += 3 * $isbn13{$i}; + } + } + // checksum + $checksum = 10 - ($sum % 10); + if ($checksum == 10) { + $checksum = '0'; + } + break; + + default: + $this->_error(self::NO_ISBN); + return false; + } + + // validate + if (substr($this->_value, -1) != $checksum) { + $this->_error(self::NO_ISBN); + return false; + } + return true; + } + + /** + * Set separator characters. + * + * It is allowed only empty string, hyphen and space. + * + * @param string $separator + * @throws Postman_Zend_Validate_Exception When $separator is not valid + * @return Postman_Zend_Validate_Isbn Provides a fluent interface + */ + public function setSeparator($separator) + { + // check separator + if (!in_array($separator, array('-', ' ', ''))) { + /** + * @see Postman_Zend_Validate_Exception + */ + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Invalid ISBN separator.'); + } + + $this->_separator = $separator; + return $this; + } + + /** + * Get separator characters. + * + * @return string + */ + public function getSeparator() + { + return $this->_separator; + } + + /** + * Set allowed ISBN type. + * + * @param string $type + * @throws Postman_Zend_Validate_Exception When $type is not valid + * @return Postman_Zend_Validate_Isbn Provides a fluent interface + */ + public function setType($type) + { + // check type + if (!in_array($type, array(self::AUTO, self::ISBN10, self::ISBN13))) { + /** + * @see Postman_Zend_Validate_Exception + */ + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Invalid ISBN type'); + } + + $this->_type = $type; + return $this; + } + + /** + * Get allowed ISBN type. + * + * @return string + */ + public function getType() + { + return $this->_type; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/LessThan.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/LessThan.php new file mode 100644 index 0000000..e6f1524 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/LessThan.php @@ -0,0 +1,122 @@ + "'%value%' is not less than '%max%'" + ); + + /** + * @var array + */ + protected $_messageVariables = array( + 'max' => '_max' + ); + + /** + * Maximum value + * + * @var mixed + */ + protected $_max; + + /** + * Sets validator options + * + * @param mixed|Postman_Zend_Config $max + * @throws Postman_Zend_Validate_Exception + */ + public function __construct($max) + { + if ($max instanceof Postman_Zend_Config) { + $max = $max->toArray(); + } + + if (is_array($max)) { + if (array_key_exists('max', $max)) { + $max = $max['max']; + } else { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Missing option 'max'"); + } + } + + $this->setMax($max); + } + + /** + * Returns the max option + * + * @return mixed + */ + public function getMax() + { + return $this->_max; + } + + /** + * Sets the max option + * + * @param mixed $max + * @return Postman_Zend_Validate_LessThan Provides a fluent interface + */ + public function setMax($max) + { + $this->_max = $max; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is less than max option + * + * @param mixed $value + * @return boolean + */ + public function isValid($value) + { + $this->_setValue($value); + if ($this->_max <= $value) { + $this->_error(self::NOT_LESS); + return false; + } + return true; + } + +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/NotEmpty.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/NotEmpty.php new file mode 100644 index 0000000..5b25890 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/NotEmpty.php @@ -0,0 +1,279 @@ + 'boolean', + self::INTEGER => 'integer', + self::FLOAT => 'float', + self::STRING => 'string', + self::ZERO => 'zero', + self::EMPTY_ARRAY => 'array', + self::NULL => 'null', + self::PHP => 'php', + self::SPACE => 'space', + self::OBJECT => 'object', + self::OBJECT_STRING => 'objectstring', + self::OBJECT_COUNT => 'objectcount', + self::ALL => 'all', + ); + + /** + * @var array + */ + protected $_messageTemplates = array( + self::IS_EMPTY => "Value is required and can't be empty", + self::INVALID => "Invalid type given. String, integer, float, boolean or array expected", + ); + + /** + * Internal type to detect + * + * @var integer + */ + protected $_type = 493; + + /** + * Constructor + * + * @param string|array|Postman_Zend_Config $options OPTIONAL + */ + public function __construct($options = null) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } else if (!is_array($options)) { + $options = func_get_args(); + $temp = array(); + if (!empty($options)) { + $temp['type'] = array_shift($options); + } + + $options = $temp; + } + + if (is_array($options) && array_key_exists('type', $options)) { + $this->setType($options['type']); + } + } + + /** + * Returns the set types + * + * @return array + */ + public function getType() + { + return $this->_type; + } + + /** + * Set the types + * + * @param integer|array $type + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_NotEmpty + */ + public function setType($type = null) + { + if (is_array($type)) { + $detected = 0; + foreach($type as $value) { + if (is_int($value)) { + $detected += $value; + } else if (in_array($value, $this->_constants)) { + $detected += array_search($value, $this->_constants); + } + } + + $type = $detected; + } else if (is_string($type) && in_array($type, $this->_constants)) { + $type = array_search($type, $this->_constants); + } + + if (!is_int($type) || ($type < 0) || ($type > self::ALL)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Unknown type'); + } + + $this->_type = $type; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is not an empty value. + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if ($value !== null && !is_string($value) && !is_int($value) && !is_float($value) && + !is_bool($value) && !is_array($value) && !is_object($value)) { + $this->_error(self::INVALID); + return false; + } + + $type = $this->getType(); + $this->_setValue($value); + $object = false; + + // OBJECT_COUNT (countable object) + if ($type >= self::OBJECT_COUNT) { + $type -= self::OBJECT_COUNT; + $object = true; + + if (is_object($value) && ($value instanceof Countable) && (count($value) == 0)) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // OBJECT_STRING (object's toString) + if ($type >= self::OBJECT_STRING) { + $type -= self::OBJECT_STRING; + $object = true; + + if ((is_object($value) && (!method_exists($value, '__toString'))) || + (is_object($value) && (method_exists($value, '__toString')) && (((string) $value) == ""))) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // OBJECT (object) + if ($type >= self::OBJECT) { + $type -= self::OBJECT; + // fall trough, objects are always not empty + } else if ($object === false) { + // object not allowed but object given -> return false + if (is_object($value)) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // SPACE (' ') + if ($type >= self::SPACE) { + $type -= self::SPACE; + if (is_string($value) && (preg_match('/^\s+$/s', $value))) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // NULL (null) + if ($type >= self::NULL) { + $type -= self::NULL; + if ($value === null) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // EMPTY_ARRAY (array()) + if ($type >= self::EMPTY_ARRAY) { + $type -= self::EMPTY_ARRAY; + if (is_array($value) && ($value == array())) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // ZERO ('0') + if ($type >= self::ZERO) { + $type -= self::ZERO; + if (is_string($value) && ($value == '0')) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // STRING ('') + if ($type >= self::STRING) { + $type -= self::STRING; + if (is_string($value) && ($value == '')) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // FLOAT (0.0) + if ($type >= self::FLOAT) { + $type -= self::FLOAT; + if (is_float($value) && ($value == 0.0)) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // INTEGER (0) + if ($type >= self::INTEGER) { + $type -= self::INTEGER; + if (is_int($value) && ($value == 0)) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + // BOOLEAN (false) + if ($type >= self::BOOLEAN) { + $type -= self::BOOLEAN; + if (is_bool($value) && ($value == false)) { + $this->_error(self::IS_EMPTY); + return false; + } + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/PostCode.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/PostCode.php new file mode 100644 index 0000000..a84f02e --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/PostCode.php @@ -0,0 +1,210 @@ + "Invalid type given. String or integer expected", + self::NO_MATCH => "'%value%' does not appear to be a postal code", + ); + + /** + * Locale to use + * + * @var string + */ + protected $_locale; + + /** + * Manual postal code format + * + * @var unknown_type + */ + protected $_format; + + /** + * Constructor for the integer validator + * + * Accepts either a string locale, a Postman_Zend_Locale object, or an array or + * Postman_Zend_Config object containing the keys "locale" and/or "format". + * + * @param string|Postman_Zend_Locale|array|Postman_Zend_Config $options + * @throws Postman_Zend_Validate_Exception On empty format + */ + public function __construct($options = null) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } + + if (empty($options)) { + require_once 'Zend/Registry.php'; + if (Postman_Zend_Registry::isRegistered('Postman_Zend_Locale')) { + $this->setLocale(Postman_Zend_Registry::get('Postman_Zend_Locale')); + } + } elseif (is_array($options)) { + // Received + if (array_key_exists('locale', $options)) { + $this->setLocale($options['locale']); + } + + if (array_key_exists('format', $options)) { + $this->setFormat($options['format']); + } + } elseif ($options instanceof Postman_Zend_Locale || is_string($options)) { + // Received Locale object or string locale + $this->setLocale($options); + } + + $format = $this->getFormat(); + if (empty($format)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("A postcode-format string has to be given for validation"); + } + } + + /** + * Returns the set locale + * + * @return string|Postman_Zend_Locale The set locale + */ + public function getLocale() + { + return $this->_locale; + } + + /** + * Sets the locale to use + * + * @param string|Postman_Zend_Locale $locale + * @throws Postman_Zend_Validate_Exception On unrecognised region + * @throws Postman_Zend_Validate_Exception On not detected format + * @return Postman_Zend_Validate_PostCode Provides a fluent interface + */ + public function setLocale($locale = null) + { + require_once 'Zend/Locale.php'; + $this->_locale = Postman_Zend_Locale::findLocale($locale); + $locale = new Postman_Zend_Locale($this->_locale); + $region = $locale->getRegion(); + if (empty($region)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Unable to detect a region for the locale '$locale'"); + } + + $format = Postman_Zend_Locale::getTranslation( + $locale->getRegion(), + 'postaltoterritory', + $this->_locale + ); + + if (empty($format)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Unable to detect a postcode format for the region '{$locale->getRegion()}'"); + } + + $this->setFormat($format); + return $this; + } + + /** + * Returns the set postal code format + * + * @return string + */ + public function getFormat() + { + return $this->_format; + } + + /** + * Sets a self defined postal format as regex + * + * @param string $format + * @throws Postman_Zend_Validate_Exception On empty format + * @return Postman_Zend_Validate_PostCode Provides a fluent interface + */ + public function setFormat($format) + { + if (empty($format) || !is_string($format)) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("A postcode-format string has to be given for validation"); + } + + if ($format[0] !== '/') { + $format = '/^' . $format; + } + + if ($format[strlen($format) - 1] !== '/') { + $format .= '$/'; + } + + $this->_format = $format; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value is a valid postalcode + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + $this->_setValue($value); + if (!is_string($value) && !is_int($value)) { + $this->_error(self::INVALID); + return false; + } + + $format = $this->getFormat(); + if (!preg_match($format, $value)) { + $this->_error(self::NO_MATCH); + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/Regex.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/Regex.php new file mode 100644 index 0000000..50be855 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/Regex.php @@ -0,0 +1,146 @@ + "Invalid type given. String, integer or float expected", + self::NOT_MATCH => "'%value%' does not match against pattern '%pattern%'", + self::ERROROUS => "There was an internal error while using the pattern '%pattern%'", + ); + + /** + * @var array + */ + protected $_messageVariables = array( + 'pattern' => '_pattern' + ); + + /** + * Regular expression pattern + * + * @var string + */ + protected $_pattern; + + /** + * Sets validator options + * + * @param string|Postman_Zend_Config $pattern + * @throws Postman_Zend_Validate_Exception On missing 'pattern' parameter + */ + public function __construct($pattern) + { + if ($pattern instanceof Postman_Zend_Config) { + $pattern = $pattern->toArray(); + } + + if (is_array($pattern)) { + if (array_key_exists('pattern', $pattern)) { + $pattern = $pattern['pattern']; + } else { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Missing option 'pattern'"); + } + } + + $this->setPattern($pattern); + } + + /** + * Returns the pattern option + * + * @return string + */ + public function getPattern() + { + return $this->_pattern; + } + + /** + * Sets the pattern option + * + * @param string $pattern + * @throws Postman_Zend_Validate_Exception if there is a fatal error in pattern matching + * @return Postman_Zend_Validate_Regex Provides a fluent interface + */ + public function setPattern($pattern) + { + $this->_pattern = (string) $pattern; + $status = @preg_match($this->_pattern, "Test"); + + if (false === $status) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("Internal error while using the pattern '$this->_pattern'"); + } + + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if $value matches against the pattern option + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value) && !is_int($value) && !is_float($value)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue($value); + + $status = @preg_match($this->_pattern, $value); + if (false === $status) { + $this->_error(self::ERROROUS); + return false; + } + + if (!$status) { + $this->_error(self::NOT_MATCH); + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/Zend-1.12.10/Validate/StringLength.php b/Postman/Postman-Mail/Zend-1.12.10/Validate/StringLength.php new file mode 100644 index 0000000..62b5a00 --- /dev/null +++ b/Postman/Postman-Mail/Zend-1.12.10/Validate/StringLength.php @@ -0,0 +1,263 @@ + "Invalid type given. String expected", + self::TOO_SHORT => "'%value%' is less than %min% characters long", + self::TOO_LONG => "'%value%' is more than %max% characters long", + ); + + /** + * @var array + */ + protected $_messageVariables = array( + 'min' => '_min', + 'max' => '_max' + ); + + /** + * Minimum length + * + * @var integer + */ + protected $_min; + + /** + * Maximum length + * + * If null, there is no maximum length + * + * @var integer|null + */ + protected $_max; + + /** + * Encoding to use + * + * @var string|null + */ + protected $_encoding; + + /** + * Sets validator options + * + * @param integer|array|Postman_Zend_Config $options + */ + public function __construct($options = array()) + { + if ($options instanceof Postman_Zend_Config) { + $options = $options->toArray(); + } else if (!is_array($options)) { + $options = func_get_args(); + $temp['min'] = array_shift($options); + if (!empty($options)) { + $temp['max'] = array_shift($options); + } + + if (!empty($options)) { + $temp['encoding'] = array_shift($options); + } + + $options = $temp; + } + + if (!array_key_exists('min', $options)) { + $options['min'] = 0; + } + + $this->setMin($options['min']); + if (array_key_exists('max', $options)) { + $this->setMax($options['max']); + } + + if (array_key_exists('encoding', $options)) { + $this->setEncoding($options['encoding']); + } + } + + /** + * Returns the min option + * + * @return integer + */ + public function getMin() + { + return $this->_min; + } + + /** + * Sets the min option + * + * @param integer $min + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_StringLength Provides a fluent interface + */ + public function setMin($min) + { + if (null !== $this->_max && $min > $this->_max) { + /** + * @see Postman_Zend_Validate_Exception + */ + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("The minimum must be less than or equal to the maximum length, but $min >" + . " $this->_max"); + } + $this->_min = max(0, (integer) $min); + return $this; + } + + /** + * Returns the max option + * + * @return integer|null + */ + public function getMax() + { + return $this->_max; + } + + /** + * Sets the max option + * + * @param integer|null $max + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_StringLength Provides a fluent interface + */ + public function setMax($max) + { + if (null === $max) { + $this->_max = null; + } else if ($max < $this->_min) { + /** + * @see Postman_Zend_Validate_Exception + */ + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception("The maximum must be greater than or equal to the minimum length, but " + . "$max < $this->_min"); + } else { + $this->_max = (integer) $max; + } + + return $this; + } + + /** + * Returns the actual encoding + * + * @return string + */ + public function getEncoding() + { + return $this->_encoding; + } + + /** + * Sets a new encoding to use + * + * @param string $encoding + * @throws Postman_Zend_Validate_Exception + * @return Postman_Zend_Validate_StringLength + */ + public function setEncoding($encoding = null) + { + if ($encoding !== null) { + $orig = PHP_VERSION_ID < 50600 + ? iconv_get_encoding('internal_encoding') + : ini_get('default_charset'); + if (PHP_VERSION_ID < 50600) { + $result = iconv_set_encoding('internal_encoding', $encoding); + } else { + $result = ini_set('default_charset', $encoding); + } + if (!$result) { + require_once 'Zend/Validate/Exception.php'; + throw new Postman_Zend_Validate_Exception('Given encoding not supported on this OS!'); + } + + if (PHP_VERSION_ID < 50600) { + iconv_set_encoding('internal_encoding', $orig); + } else { + ini_set('default_charset', $orig); + } + } + + $this->_encoding = $encoding; + return $this; + } + + /** + * Defined by Postman_Zend_Validate_Interface + * + * Returns true if and only if the string length of $value is at least the min option and + * no greater than the max option (when the max option is not null). + * + * @param string $value + * @return boolean + */ + public function isValid($value) + { + if (!is_string($value)) { + $this->_error(self::INVALID); + return false; + } + + $this->_setValue($value); + if ($this->_encoding !== null) { + $length = iconv_strlen($value, $this->_encoding); + } else { + $length = iconv_strlen($value); + } + + if ($length < $this->_min) { + $this->_error(self::TOO_SHORT); + } + + if (null !== $this->_max && $this->_max < $length) { + $this->_error(self::TOO_LONG); + } + + if (count($this->_messages)) { + return false; + } else { + return true; + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/composer.json b/Postman/Postman-Mail/google-api-client/composer.json new file mode 100644 index 0000000..ea9cbdd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/composer.json @@ -0,0 +1,5 @@ +{ + "require": { + "google/apiclient": "^2.0" + } +} diff --git a/Postman/Postman-Mail/google-api-client/composer.lock b/Postman/Postman-Mail/google-api-client/composer.lock new file mode 100644 index 0000000..d148fd2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/composer.lock @@ -0,0 +1,702 @@ +{ + "_readme": [ + "This file locks the dependencies of your project to a known state", + "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file", + "This file is @generated automatically" + ], + "hash": "a7c903877c49c9f3aa3784f99c4a9097", + "content-hash": "3e6e79e410cd98a8d86f36f772fe3690", + "packages": [ + { + "name": "firebase/php-jwt", + "version": "v5.0.0", + "source": { + "type": "git", + "url": "https://github.com/firebase/php-jwt.git", + "reference": "9984a4d3a32ae7673d6971ea00bae9d0a1abba0e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/firebase/php-jwt/zipball/9984a4d3a32ae7673d6971ea00bae9d0a1abba0e", + "reference": "9984a4d3a32ae7673d6971ea00bae9d0a1abba0e", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "require-dev": { + "phpunit/phpunit": " 4.8.35" + }, + "type": "library", + "autoload": { + "psr-4": { + "Firebase\\JWT\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Neuman Vong", + "email": "neuman+pear@twilio.com", + "role": "Developer" + }, + { + "name": "Anant Narayanan", + "email": "anant@php.net", + "role": "Developer" + } + ], + "description": "A simple library to encode and decode JSON Web Tokens (JWT) in PHP. Should conform to the current spec.", + "homepage": "https://github.com/firebase/php-jwt", + "time": "2017-06-27 22:17:23" + }, + { + "name": "google/apiclient", + "version": "v2.2.1", + "source": { + "type": "git", + "url": "https://github.com/google/google-api-php-client.git", + "reference": "b69b8ac4bf6501793c389d4e013a79d09c85c5f2" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/google/google-api-php-client/zipball/b69b8ac4bf6501793c389d4e013a79d09c85c5f2", + "reference": "b69b8ac4bf6501793c389d4e013a79d09c85c5f2", + "shasum": "" + }, + "require": { + "firebase/php-jwt": "~2.0|~3.0|~4.0|~5.0", + "google/apiclient-services": "~0.13", + "google/auth": "^1.0", + "guzzlehttp/guzzle": "~5.3.1|~6.0", + "guzzlehttp/psr7": "^1.2", + "monolog/monolog": "^1.17", + "php": ">=5.4", + "phpseclib/phpseclib": "~0.3.10|~2.0" + }, + "require-dev": { + "cache/filesystem-adapter": "^0.3.2", + "phpunit/phpunit": "~4", + "squizlabs/php_codesniffer": "~2.3", + "symfony/css-selector": "~2.1", + "symfony/dom-crawler": "~2.1" + }, + "suggest": { + "cache/filesystem-adapter": "For caching certs and tokens (using Google_Client::setCache)" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.x-dev" + } + }, + "autoload": { + "psr-0": { + "Google_": "src/" + }, + "classmap": [ + "src/Google/Service/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "Apache-2.0" + ], + "description": "Client library for Google APIs", + "homepage": "http://developers.google.com/api-client-library/php", + "keywords": [ + "google" + ], + "time": "2017-11-03 01:19:53" + }, + { + "name": "google/apiclient-services", + "version": "v0.49", + "source": { + "type": "git", + "url": "https://github.com/google/google-api-php-client-services.git", + "reference": "7552d7d1bb92e933fc93088014c8c2555c0feab6" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/google/google-api-php-client-services/zipball/7552d7d1bb92e933fc93088014c8c2555c0feab6", + "reference": "7552d7d1bb92e933fc93088014c8c2555c0feab6", + "shasum": "" + }, + "require": { + "php": ">=5.4" + }, + "require-dev": { + "phpunit/phpunit": "~4.8" + }, + "type": "library", + "autoload": { + "psr-0": { + "Google_Service_": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "Apache-2.0" + ], + "description": "Client library for Google APIs", + "homepage": "http://developers.google.com/api-client-library/php", + "keywords": [ + "google" + ], + "time": "2018-03-04 00:24:05" + }, + { + "name": "google/auth", + "version": "v1.2.1", + "source": { + "type": "git", + "url": "https://github.com/google/google-auth-library-php.git", + "reference": "da0062d279c9459350808a4fb63dbc08b90d6b90" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/google/google-auth-library-php/zipball/da0062d279c9459350808a4fb63dbc08b90d6b90", + "reference": "da0062d279c9459350808a4fb63dbc08b90d6b90", + "shasum": "" + }, + "require": { + "firebase/php-jwt": "~2.0|~3.0|~4.0|~5.0", + "guzzlehttp/guzzle": "~5.3.1|~6.0", + "guzzlehttp/psr7": "~1.2", + "php": ">=5.4", + "psr/cache": "^1.0", + "psr/http-message": "^1.0" + }, + "require-dev": { + "friendsofphp/php-cs-fixer": "^1.11", + "guzzlehttp/promises": "0.1.1|^1.3", + "phpunit/phpunit": "^4.8.36|^5.7", + "sebastian/comparator": ">=1.2.3" + }, + "type": "library", + "autoload": { + "psr-4": { + "Google\\Auth\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "Apache-2.0" + ], + "description": "Google Auth Library for PHP", + "homepage": "http://github.com/google/google-auth-library-php", + "keywords": [ + "Authentication", + "google", + "oauth2" + ], + "time": "2018-01-24 18:28:42" + }, + { + "name": "guzzlehttp/guzzle", + "version": "6.3.0", + "source": { + "type": "git", + "url": "https://github.com/guzzle/guzzle.git", + "reference": "f4db5a78a5ea468d4831de7f0bf9d9415e348699" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/guzzle/zipball/f4db5a78a5ea468d4831de7f0bf9d9415e348699", + "reference": "f4db5a78a5ea468d4831de7f0bf9d9415e348699", + "shasum": "" + }, + "require": { + "guzzlehttp/promises": "^1.0", + "guzzlehttp/psr7": "^1.4", + "php": ">=5.5" + }, + "require-dev": { + "ext-curl": "*", + "phpunit/phpunit": "^4.0 || ^5.0", + "psr/log": "^1.0" + }, + "suggest": { + "psr/log": "Required for using the Log middleware" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "6.2-dev" + } + }, + "autoload": { + "files": [ + "src/functions_include.php" + ], + "psr-4": { + "GuzzleHttp\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + } + ], + "description": "Guzzle is a PHP HTTP client library", + "homepage": "http://guzzlephp.org/", + "keywords": [ + "client", + "curl", + "framework", + "http", + "http client", + "rest", + "web service" + ], + "time": "2017-06-22 18:50:49" + }, + { + "name": "guzzlehttp/promises", + "version": "v1.3.1", + "source": { + "type": "git", + "url": "https://github.com/guzzle/promises.git", + "reference": "a59da6cf61d80060647ff4d3eb2c03a2bc694646" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/promises/zipball/a59da6cf61d80060647ff4d3eb2c03a2bc694646", + "reference": "a59da6cf61d80060647ff4d3eb2c03a2bc694646", + "shasum": "" + }, + "require": { + "php": ">=5.5.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\Promise\\": "src/" + }, + "files": [ + "src/functions_include.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + } + ], + "description": "Guzzle promises library", + "keywords": [ + "promise" + ], + "time": "2016-12-20 10:07:11" + }, + { + "name": "guzzlehttp/psr7", + "version": "1.4.2", + "source": { + "type": "git", + "url": "https://github.com/guzzle/psr7.git", + "reference": "f5b8a8512e2b58b0071a7280e39f14f72e05d87c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/psr7/zipball/f5b8a8512e2b58b0071a7280e39f14f72e05d87c", + "reference": "f5b8a8512e2b58b0071a7280e39f14f72e05d87c", + "shasum": "" + }, + "require": { + "php": ">=5.4.0", + "psr/http-message": "~1.0" + }, + "provide": { + "psr/http-message-implementation": "1.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\Psr7\\": "src/" + }, + "files": [ + "src/functions_include.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "Tobias Schultze", + "homepage": "https://github.com/Tobion" + } + ], + "description": "PSR-7 message implementation that also provides common utility methods", + "keywords": [ + "http", + "message", + "request", + "response", + "stream", + "uri", + "url" + ], + "time": "2017-03-20 17:10:46" + }, + { + "name": "monolog/monolog", + "version": "1.23.0", + "source": { + "type": "git", + "url": "https://github.com/Seldaek/monolog.git", + "reference": "fd8c787753b3a2ad11bc60c063cff1358a32a3b4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/Seldaek/monolog/zipball/fd8c787753b3a2ad11bc60c063cff1358a32a3b4", + "reference": "fd8c787753b3a2ad11bc60c063cff1358a32a3b4", + "shasum": "" + }, + "require": { + "php": ">=5.3.0", + "psr/log": "~1.0" + }, + "provide": { + "psr/log-implementation": "1.0.0" + }, + "require-dev": { + "aws/aws-sdk-php": "^2.4.9 || ^3.0", + "doctrine/couchdb": "~1.0@dev", + "graylog2/gelf-php": "~1.0", + "jakub-onderka/php-parallel-lint": "0.9", + "php-amqplib/php-amqplib": "~2.4", + "php-console/php-console": "^3.1.3", + "phpunit/phpunit": "~4.5", + "phpunit/phpunit-mock-objects": "2.3.0", + "ruflin/elastica": ">=0.90 <3.0", + "sentry/sentry": "^0.13", + "swiftmailer/swiftmailer": "^5.3|^6.0" + }, + "suggest": { + "aws/aws-sdk-php": "Allow sending log messages to AWS services like DynamoDB", + "doctrine/couchdb": "Allow sending log messages to a CouchDB server", + "ext-amqp": "Allow sending log messages to an AMQP server (1.0+ required)", + "ext-mongo": "Allow sending log messages to a MongoDB server", + "graylog2/gelf-php": "Allow sending log messages to a GrayLog2 server", + "mongodb/mongodb": "Allow sending log messages to a MongoDB server via PHP Driver", + "php-amqplib/php-amqplib": "Allow sending log messages to an AMQP server using php-amqplib", + "php-console/php-console": "Allow sending log messages to Google Chrome", + "rollbar/rollbar": "Allow sending log messages to Rollbar", + "ruflin/elastica": "Allow sending log messages to an Elastic Search server", + "sentry/sentry": "Allow sending log messages to a Sentry server" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Monolog\\": "src/Monolog" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "http://seld.be" + } + ], + "description": "Sends your logs to files, sockets, inboxes, databases and various web services", + "homepage": "http://github.com/Seldaek/monolog", + "keywords": [ + "log", + "logging", + "psr-3" + ], + "time": "2017-06-19 01:22:40" + }, + { + "name": "phpseclib/phpseclib", + "version": "2.0.10", + "source": { + "type": "git", + "url": "https://github.com/phpseclib/phpseclib.git", + "reference": "d305b780829ea4252ed9400b3f5937c2c99b51d4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpseclib/phpseclib/zipball/d305b780829ea4252ed9400b3f5937c2c99b51d4", + "reference": "d305b780829ea4252ed9400b3f5937c2c99b51d4", + "shasum": "" + }, + "require": { + "php": ">=5.3.3" + }, + "require-dev": { + "phing/phing": "~2.7", + "phpunit/phpunit": "^4.8.35|^5.7|^6.0", + "sami/sami": "~2.0", + "squizlabs/php_codesniffer": "~2.0" + }, + "suggest": { + "ext-gmp": "Install the GMP (GNU Multiple Precision) extension in order to speed up arbitrary precision integer arithmetic operations.", + "ext-libsodium": "SSH2/SFTP can make use of some algorithms provided by the libsodium-php extension.", + "ext-mcrypt": "Install the Mcrypt extension in order to speed up a few other cryptographic operations.", + "ext-openssl": "Install the OpenSSL extension in order to speed up a wide variety of cryptographic operations." + }, + "type": "library", + "autoload": { + "files": [ + "phpseclib/bootstrap.php" + ], + "psr-4": { + "phpseclib\\": "phpseclib/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jim Wigginton", + "email": "terrafrost@php.net", + "role": "Lead Developer" + }, + { + "name": "Patrick Monnerat", + "email": "pm@datasphere.ch", + "role": "Developer" + }, + { + "name": "Andreas Fischer", + "email": "bantu@phpbb.com", + "role": "Developer" + }, + { + "name": "Hans-Jürgen Petrich", + "email": "petrich@tronic-media.com", + "role": "Developer" + }, + { + "name": "Graham Campbell", + "email": "graham@alt-three.com", + "role": "Developer" + } + ], + "description": "PHP Secure Communications Library - Pure-PHP implementations of RSA, AES, SSH2, SFTP, X.509 etc.", + "homepage": "http://phpseclib.sourceforge.net", + "keywords": [ + "BigInteger", + "aes", + "asn.1", + "asn1", + "blowfish", + "crypto", + "cryptography", + "encryption", + "rsa", + "security", + "sftp", + "signature", + "signing", + "ssh", + "twofish", + "x.509", + "x509" + ], + "time": "2018-02-19 04:29:13" + }, + { + "name": "psr/cache", + "version": "1.0.1", + "source": { + "type": "git", + "url": "https://github.com/php-fig/cache.git", + "reference": "d11b50ad223250cf17b86e38383413f5a6764bf8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/cache/zipball/d11b50ad223250cf17b86e38383413f5a6764bf8", + "reference": "d11b50ad223250cf17b86e38383413f5a6764bf8", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Cache\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Common interface for caching libraries", + "keywords": [ + "cache", + "psr", + "psr-6" + ], + "time": "2016-08-06 20:24:11" + }, + { + "name": "psr/http-message", + "version": "1.0.1", + "source": { + "type": "git", + "url": "https://github.com/php-fig/http-message.git", + "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/http-message/zipball/f6561bf28d520154e4b0ec72be95418abe6d9363", + "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Http\\Message\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Common interface for HTTP messages", + "homepage": "https://github.com/php-fig/http-message", + "keywords": [ + "http", + "http-message", + "psr", + "psr-7", + "request", + "response" + ], + "time": "2016-08-06 14:39:51" + }, + { + "name": "psr/log", + "version": "1.0.2", + "source": { + "type": "git", + "url": "https://github.com/php-fig/log.git", + "reference": "4ebe3a8bf773a19edfe0a84b6585ba3d401b724d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/log/zipball/4ebe3a8bf773a19edfe0a84b6585ba3d401b724d", + "reference": "4ebe3a8bf773a19edfe0a84b6585ba3d401b724d", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Log\\": "Psr/Log/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Common interface for logging libraries", + "homepage": "https://github.com/php-fig/log", + "keywords": [ + "log", + "psr", + "psr-3" + ], + "time": "2016-10-10 12:19:37" + } + ], + "packages-dev": [], + "aliases": [], + "minimum-stability": "stable", + "stability-flags": [], + "prefer-stable": false, + "prefer-lowest": false, + "platform": [], + "platform-dev": [] +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/autoload.php b/Postman/Postman-Mail/google-api-client/vendor/autoload.php new file mode 100644 index 0000000..192ed6a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/autoload.php @@ -0,0 +1,7 @@ + + * Jordi Boggiano + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Composer\Autoload; + +/** + * ClassLoader implements a PSR-0, PSR-4 and classmap class loader. + * + * $loader = new \Composer\Autoload\ClassLoader(); + * + * // register classes with namespaces + * $loader->add('Symfony\Component', __DIR__.'/component'); + * $loader->add('Symfony', __DIR__.'/framework'); + * + * // activate the autoloader + * $loader->register(); + * + * // to enable searching the include path (eg. for PEAR packages) + * $loader->setUseIncludePath(true); + * + * In this example, if you try to use a class in the Symfony\Component + * namespace or one of its children (Symfony\Component\Console for instance), + * the autoloader will first look for the class under the component/ + * directory, and it will then fallback to the framework/ directory if not + * found before giving up. + * + * This class is loosely based on the Symfony UniversalClassLoader. + * + * @author Fabien Potencier + * @author Jordi Boggiano + * @see http://www.php-fig.org/psr/psr-0/ + * @see http://www.php-fig.org/psr/psr-4/ + */ +class ClassLoader +{ + // PSR-4 + private $prefixLengthsPsr4 = array(); + private $prefixDirsPsr4 = array(); + private $fallbackDirsPsr4 = array(); + + // PSR-0 + private $prefixesPsr0 = array(); + private $fallbackDirsPsr0 = array(); + + private $useIncludePath = false; + private $classMap = array(); + + private $classMapAuthoritative = false; + + public function getPrefixes() + { + if (!empty($this->prefixesPsr0)) { + return call_user_func_array('array_merge', $this->prefixesPsr0); + } + + return array(); + } + + public function getPrefixesPsr4() + { + return $this->prefixDirsPsr4; + } + + public function getFallbackDirs() + { + return $this->fallbackDirsPsr0; + } + + public function getFallbackDirsPsr4() + { + return $this->fallbackDirsPsr4; + } + + public function getClassMap() + { + return $this->classMap; + } + + /** + * @param array $classMap Class to filename map + */ + public function addClassMap(array $classMap) + { + if ($this->classMap) { + $this->classMap = array_merge($this->classMap, $classMap); + } else { + $this->classMap = $classMap; + } + } + + /** + * Registers a set of PSR-0 directories for a given prefix, either + * appending or prepending to the ones previously set for this prefix. + * + * @param string $prefix The prefix + * @param array|string $paths The PSR-0 root directories + * @param bool $prepend Whether to prepend the directories + */ + public function add($prefix, $paths, $prepend = false) + { + if (!$prefix) { + if ($prepend) { + $this->fallbackDirsPsr0 = array_merge( + (array) $paths, + $this->fallbackDirsPsr0 + ); + } else { + $this->fallbackDirsPsr0 = array_merge( + $this->fallbackDirsPsr0, + (array) $paths + ); + } + + return; + } + + $first = $prefix[0]; + if (!isset($this->prefixesPsr0[$first][$prefix])) { + $this->prefixesPsr0[$first][$prefix] = (array) $paths; + + return; + } + if ($prepend) { + $this->prefixesPsr0[$first][$prefix] = array_merge( + (array) $paths, + $this->prefixesPsr0[$first][$prefix] + ); + } else { + $this->prefixesPsr0[$first][$prefix] = array_merge( + $this->prefixesPsr0[$first][$prefix], + (array) $paths + ); + } + } + + /** + * Registers a set of PSR-4 directories for a given namespace, either + * appending or prepending to the ones previously set for this namespace. + * + * @param string $prefix The prefix/namespace, with trailing '\\' + * @param array|string $paths The PSR-4 base directories + * @param bool $prepend Whether to prepend the directories + * + * @throws \InvalidArgumentException + */ + public function addPsr4($prefix, $paths, $prepend = false) + { + if (!$prefix) { + // Register directories for the root namespace. + if ($prepend) { + $this->fallbackDirsPsr4 = array_merge( + (array) $paths, + $this->fallbackDirsPsr4 + ); + } else { + $this->fallbackDirsPsr4 = array_merge( + $this->fallbackDirsPsr4, + (array) $paths + ); + } + } elseif (!isset($this->prefixDirsPsr4[$prefix])) { + // Register directories for a new namespace. + $length = strlen($prefix); + if ('\\' !== $prefix[$length - 1]) { + throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); + } + $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; + $this->prefixDirsPsr4[$prefix] = (array) $paths; + } elseif ($prepend) { + // Prepend directories for an already registered namespace. + $this->prefixDirsPsr4[$prefix] = array_merge( + (array) $paths, + $this->prefixDirsPsr4[$prefix] + ); + } else { + // Append directories for an already registered namespace. + $this->prefixDirsPsr4[$prefix] = array_merge( + $this->prefixDirsPsr4[$prefix], + (array) $paths + ); + } + } + + /** + * Registers a set of PSR-0 directories for a given prefix, + * replacing any others previously set for this prefix. + * + * @param string $prefix The prefix + * @param array|string $paths The PSR-0 base directories + */ + public function set($prefix, $paths) + { + if (!$prefix) { + $this->fallbackDirsPsr0 = (array) $paths; + } else { + $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths; + } + } + + /** + * Registers a set of PSR-4 directories for a given namespace, + * replacing any others previously set for this namespace. + * + * @param string $prefix The prefix/namespace, with trailing '\\' + * @param array|string $paths The PSR-4 base directories + * + * @throws \InvalidArgumentException + */ + public function setPsr4($prefix, $paths) + { + if (!$prefix) { + $this->fallbackDirsPsr4 = (array) $paths; + } else { + $length = strlen($prefix); + if ('\\' !== $prefix[$length - 1]) { + throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); + } + $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; + $this->prefixDirsPsr4[$prefix] = (array) $paths; + } + } + + /** + * Turns on searching the include path for class files. + * + * @param bool $useIncludePath + */ + public function setUseIncludePath($useIncludePath) + { + $this->useIncludePath = $useIncludePath; + } + + /** + * Can be used to check if the autoloader uses the include path to check + * for classes. + * + * @return bool + */ + public function getUseIncludePath() + { + return $this->useIncludePath; + } + + /** + * Turns off searching the prefix and fallback directories for classes + * that have not been registered with the class map. + * + * @param bool $classMapAuthoritative + */ + public function setClassMapAuthoritative($classMapAuthoritative) + { + $this->classMapAuthoritative = $classMapAuthoritative; + } + + /** + * Should class lookup fail if not found in the current class map? + * + * @return bool + */ + public function isClassMapAuthoritative() + { + return $this->classMapAuthoritative; + } + + /** + * Registers this instance as an autoloader. + * + * @param bool $prepend Whether to prepend the autoloader or not + */ + public function register($prepend = false) + { + spl_autoload_register(array($this, 'loadClass'), true, $prepend); + } + + /** + * Unregisters this instance as an autoloader. + */ + public function unregister() + { + spl_autoload_unregister(array($this, 'loadClass')); + } + + /** + * Loads the given class or interface. + * + * @param string $class The name of the class + * @return bool|null True if loaded, null otherwise + */ + public function loadClass($class) + { + if ($file = $this->findFile($class)) { + includeFile($file); + + return true; + } + } + + /** + * Finds the path to the file where the class is defined. + * + * @param string $class The name of the class + * + * @return string|false The path if found, false otherwise + */ + public function findFile($class) + { + // work around for PHP 5.3.0 - 5.3.2 https://bugs.php.net/50731 + if ('\\' == $class[0]) { + $class = substr($class, 1); + } + + // class map lookup + if (isset($this->classMap[$class])) { + return $this->classMap[$class]; + } + if ($this->classMapAuthoritative) { + return false; + } + + $file = $this->findFileWithExtension($class, '.php'); + + // Search for Hack files if we are running on HHVM + if ($file === null && defined('HHVM_VERSION')) { + $file = $this->findFileWithExtension($class, '.hh'); + } + + if ($file === null) { + // Remember that this class does not exist. + return $this->classMap[$class] = false; + } + + return $file; + } + + private function findFileWithExtension($class, $ext) + { + // PSR-4 lookup + $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; + + $first = $class[0]; + if (isset($this->prefixLengthsPsr4[$first])) { + foreach ($this->prefixLengthsPsr4[$first] as $prefix => $length) { + if (0 === strpos($class, $prefix)) { + foreach ($this->prefixDirsPsr4[$prefix] as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $length))) { + return $file; + } + } + } + } + } + + // PSR-4 fallback dirs + foreach ($this->fallbackDirsPsr4 as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) { + return $file; + } + } + + // PSR-0 lookup + if (false !== $pos = strrpos($class, '\\')) { + // namespaced class name + $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1) + . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR); + } else { + // PEAR-like class name + $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext; + } + + if (isset($this->prefixesPsr0[$first])) { + foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) { + if (0 === strpos($class, $prefix)) { + foreach ($dirs as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { + return $file; + } + } + } + } + } + + // PSR-0 fallback dirs + foreach ($this->fallbackDirsPsr0 as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { + return $file; + } + } + + // PSR-0 include paths. + if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { + return $file; + } + } +} + +/** + * Scope isolated include. + * + * Prevents access to $this/self from included files. + */ +function includeFile($file) +{ + include $file; +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/composer/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/composer/LICENSE new file mode 100644 index 0000000..ee274f1 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/composer/LICENSE @@ -0,0 +1,433 @@ +Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: Composer +Upstream-Contact: Jordi Boggiano +Source: https://github.com/composer/composer + +Files: * +Copyright: 2016, Nils Adermann + 2016, Jordi Boggiano +License: Expat + +Files: res/cacert.pem +Copyright: 2015, Mozilla Foundation +License: MPL-2.0 + +Files: src/Composer/Util/RemoteFilesystem.php + src/Composer/Util/TlsHelper.php +Copyright: 2016, Nils Adermann + 2016, Jordi Boggiano + 2013, Evan Coury +License: Expat and BSD-2-Clause + +License: BSD-2-Clause + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + . + * Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + . + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + . + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +License: Expat + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to deal + in the Software without restriction, including without limitation the rights + to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + copies of the Software, and to permit persons to whom the Software is furnished + to do so, subject to the following conditions: + . + The above copyright notice and this permission notice shall be included in all + copies or substantial portions of the Software. + . + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + THE SOFTWARE. + +License: MPL-2.0 + 1. Definitions + -------------- + . + 1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + . + 1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + . + 1.3. "Contribution" + means Covered Software of a particular Contributor. + . + 1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + . + 1.5. "Incompatible With Secondary Licenses" + means + . + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + . + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + . + 1.6. "Executable Form" + means any form of the work other than Source Code Form. + . + 1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + . + 1.8. "License" + means this document. + . + 1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + . + 1.10. "Modifications" + means any of the following: + . + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + . + (b) any new file in Source Code Form that contains any Covered + Software. + . + 1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + . + 1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + . + 1.13. "Source Code Form" + means the form of the work preferred for making modifications. + . + 1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + . + 2. License Grants and Conditions + -------------------------------- + . + 2.1. Grants + . + Each Contributor hereby grants You a world-wide, royalty-free, + non-exclusive license: + . + (a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + . + (b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + . + 2.2. Effective Date + . + The licenses granted in Section 2.1 with respect to any Contribution + become effective for each Contribution on the date the Contributor first + distributes such Contribution. + . + 2.3. Limitations on Grant Scope + . + The licenses granted in this Section 2 are the only rights granted under + this License. No additional rights or licenses will be implied from the + distribution or licensing of Covered Software under this License. + Notwithstanding Section 2.1(b) above, no patent license is granted by a + Contributor: + . + (a) for any code that a Contributor has removed from Covered Software; + or + . + (b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + . + (c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + . + This License does not grant any rights in the trademarks, service marks, + or logos of any Contributor (except as may be necessary to comply with + the notice requirements in Section 3.4). + . + 2.4. Subsequent Licenses + . + No Contributor makes additional grants as a result of Your choice to + distribute the Covered Software under a subsequent version of this + License (see Section 10.2) or under the terms of a Secondary License (if + permitted under the terms of Section 3.3). + . + 2.5. Representation + . + Each Contributor represents that the Contributor believes its + Contributions are its original creation(s) or it has sufficient rights + to grant the rights to its Contributions conveyed by this License. + . + 2.6. Fair Use + . + This License is not intended to limit any rights You have under + applicable copyright doctrines of fair use, fair dealing, or other + equivalents. + . + 2.7. Conditions + . + Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted + in Section 2.1. + . + 3. Responsibilities + ------------------- + . + 3.1. Distribution of Source Form + . + All distribution of Covered Software in Source Code Form, including any + Modifications that You create or to which You contribute, must be under + the terms of this License. You must inform recipients that the Source + Code Form of the Covered Software is governed by the terms of this + License, and how they can obtain a copy of this License. You may not + attempt to alter or restrict the recipients' rights in the Source Code + Form. + . + 3.2. Distribution of Executable Form + . + If You distribute Covered Software in Executable Form then: + . + (a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + . + (b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + . + 3.3. Distribution of a Larger Work + . + You may create and distribute a Larger Work under terms of Your choice, + provided that You also comply with the requirements of this License for + the Covered Software. If the Larger Work is a combination of Covered + Software with a work governed by one or more Secondary Licenses, and the + Covered Software is not Incompatible With Secondary Licenses, this + License permits You to additionally distribute such Covered Software + under the terms of such Secondary License(s), so that the recipient of + the Larger Work may, at their option, further distribute the Covered + Software under the terms of either this License or such Secondary + License(s). + . + 3.4. Notices + . + You may not remove or alter the substance of any license notices + (including copyright notices, patent notices, disclaimers of warranty, + or limitations of liability) contained within the Source Code Form of + the Covered Software, except that You may alter any license notices to + the extent required to remedy known factual inaccuracies. + . + 3.5. Application of Additional Terms + . + You may choose to offer, and to charge a fee for, warranty, support, + indemnity or liability obligations to one or more recipients of Covered + Software. However, You may do so only on Your own behalf, and not on + behalf of any Contributor. You must make it absolutely clear that any + such warranty, support, indemnity, or liability obligation is offered by + You alone, and You hereby agree to indemnify every Contributor for any + liability incurred by such Contributor as a result of warranty, support, + indemnity or liability terms You offer. You may include additional + disclaimers of warranty and limitations of liability specific to any + jurisdiction. + . + 4. Inability to Comply Due to Statute or Regulation + --------------------------------------------------- + . + If it is impossible for You to comply with any of the terms of this + License with respect to some or all of the Covered Software due to + statute, judicial order, or regulation then You must: (a) comply with + the terms of this License to the maximum extent possible; and (b) + describe the limitations and the code they affect. Such description must + be placed in a text file included with all distributions of the Covered + Software under this License. Except to the extent prohibited by statute + or regulation, such description must be sufficiently detailed for a + recipient of ordinary skill to be able to understand it. + . + 5. Termination + -------------- + . + 5.1. The rights granted under this License will terminate automatically + if You fail to comply with any of its terms. However, if You become + compliant, then the rights granted under this License from a particular + Contributor are reinstated (a) provisionally, unless and until such + Contributor explicitly and finally terminates Your grants, and (b) on an + ongoing basis, if such Contributor fails to notify You of the + non-compliance by some reasonable means prior to 60 days after You have + come back into compliance. Moreover, Your grants from a particular + Contributor are reinstated on an ongoing basis if such Contributor + notifies You of the non-compliance by some reasonable means, this is the + first time You have received notice of non-compliance with this License + from such Contributor, and You become compliant prior to 30 days after + Your receipt of the notice. + . + 5.2. If You initiate litigation against any entity by asserting a patent + infringement claim (excluding declaratory judgment actions, + counter-claims, and cross-claims) alleging that a Contributor Version + directly or indirectly infringes any patent, then the rights granted to + You by any and all Contributors for the Covered Software under Section + 2.1 of this License shall terminate. + . + 5.3. In the event of termination under Sections 5.1 or 5.2 above, all + end user license agreements (excluding distributors and resellers) which + have been validly granted by You or Your distributors under this License + prior to termination shall survive termination. + . + ************************************************************************ + * * + * 6. Disclaimer of Warranty * + * ------------------------- * + * * + * Covered Software is provided under this License on an "as is" * + * basis, without warranty of any kind, either expressed, implied, or * + * statutory, including, without limitation, warranties that the * + * Covered Software is free of defects, merchantable, fit for a * + * particular purpose or non-infringing. The entire risk as to the * + * quality and performance of the Covered Software is with You. * + * Should any Covered Software prove defective in any respect, You * + * (not any Contributor) assume the cost of any necessary servicing, * + * repair, or correction. This disclaimer of warranty constitutes an * + * essential part of this License. No use of any Covered Software is * + * authorized under this License except under this disclaimer. * + * * + ************************************************************************ + . + ************************************************************************ + * * + * 7. Limitation of Liability * + * -------------------------- * + * * + * Under no circumstances and under no legal theory, whether tort * + * (including negligence), contract, or otherwise, shall any * + * Contributor, or anyone who distributes Covered Software as * + * permitted above, be liable to You for any direct, indirect, * + * special, incidental, or consequential damages of any character * + * including, without limitation, damages for lost profits, loss of * + * goodwill, work stoppage, computer failure or malfunction, or any * + * and all other commercial damages or losses, even if such party * + * shall have been informed of the possibility of such damages. This * + * limitation of liability shall not apply to liability for death or * + * personal injury resulting from such party's negligence to the * + * extent applicable law prohibits such limitation. Some * + * jurisdictions do not allow the exclusion or limitation of * + * incidental or consequential damages, so this exclusion and * + * limitation may not apply to You. * + * * + ************************************************************************ + . + 8. Litigation + ------------- + . + Any litigation relating to this License may be brought only in the + courts of a jurisdiction where the defendant maintains its principal + place of business and such litigation shall be governed by laws of that + jurisdiction, without reference to its conflict-of-law provisions. + Nothing in this Section shall prevent a party's ability to bring + cross-claims or counter-claims. + . + 9. Miscellaneous + ---------------- + . + This License represents the complete agreement concerning the subject + matter hereof. If any provision of this License is held to be + unenforceable, such provision shall be reformed only to the extent + necessary to make it enforceable. Any law or regulation which provides + that the language of a contract shall be construed against the drafter + shall not be used to construe this License against a Contributor. + . + 10. Versions of the License + --------------------------- + . + 10.1. New Versions + . + Mozilla Foundation is the license steward. Except as provided in Section + 10.3, no one other than the license steward has the right to modify or + publish new versions of this License. Each version will be given a + distinguishing version number. + . + 10.2. Effect of New Versions + . + You may distribute the Covered Software under the terms of the version + of the License under which You originally received the Covered Software, + or under the terms of any subsequent version published by the license + steward. + . + 10.3. Modified Versions + . + If you create software not governed by this License, and you want to + create a new license for such software, you may create and use a + modified version of this License if you rename the license and remove + any references to the name of the license steward (except to note that + such modified license differs from this License). + . + 10.4. Distributing Source Code Form that is Incompatible With Secondary + Licenses + . + If You choose to distribute Source Code Form that is Incompatible With + Secondary Licenses under the terms of this version of the License, the + notice described in Exhibit B of this License must be attached. + . + Exhibit A - Source Code Form License Notice + ------------------------------------------- + . + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at http://mozilla.org/MPL/2.0/. + . + If it is not possible or desirable to put the notice in a particular + file, then You may include the notice in a location (such as a LICENSE + file in a relevant directory) where a recipient would be likely to look + for such a notice. + . + You may add additional accurate notices of copyright ownership. + . + Exhibit B - "Incompatible With Secondary Licenses" Notice + --------------------------------------------------------- + . + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. diff --git a/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_classmap.php b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_classmap.php new file mode 100644 index 0000000..b6d8155 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_classmap.php @@ -0,0 +1,11 @@ + $vendorDir . '/google/apiclient/src/Google/Service/Exception.php', + 'Google_Service_Resource' => $vendorDir . '/google/apiclient/src/Google/Service/Resource.php', +); diff --git a/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_files.php b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_files.php new file mode 100644 index 0000000..56bb586 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_files.php @@ -0,0 +1,13 @@ + $vendorDir . '/guzzlehttp/psr7/src/functions_include.php', + 'c964ee0ededf28c96ebd9db5099ef910' => $vendorDir . '/guzzlehttp/promises/src/functions_include.php', + '37a3dc5111fe8f707ab4c132ef1dbc62' => $vendorDir . '/guzzlehttp/guzzle/src/functions_include.php', + 'decc78cc4436b1292c6c0d151b19445c' => $vendorDir . '/phpseclib/phpseclib/phpseclib/bootstrap.php', +); diff --git a/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_namespaces.php b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_namespaces.php new file mode 100644 index 0000000..aed9f84 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_namespaces.php @@ -0,0 +1,11 @@ + array($vendorDir . '/google/apiclient-services/src'), + 'Google_' => array($vendorDir . '/google/apiclient/src'), +); diff --git a/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_psr4.php b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_psr4.php new file mode 100644 index 0000000..36bd6b5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_psr4.php @@ -0,0 +1,19 @@ + array($vendorDir . '/phpseclib/phpseclib/phpseclib'), + 'Psr\\Log\\' => array($vendorDir . '/psr/log/Psr/Log'), + 'Psr\\Http\\Message\\' => array($vendorDir . '/psr/http-message/src'), + 'Psr\\Cache\\' => array($vendorDir . '/psr/cache/src'), + 'Monolog\\' => array($vendorDir . '/monolog/monolog/src/Monolog'), + 'GuzzleHttp\\Psr7\\' => array($vendorDir . '/guzzlehttp/psr7/src'), + 'GuzzleHttp\\Promise\\' => array($vendorDir . '/guzzlehttp/promises/src'), + 'GuzzleHttp\\' => array($vendorDir . '/guzzlehttp/guzzle/src'), + 'Google\\Auth\\' => array($vendorDir . '/google/auth/src'), + 'Firebase\\JWT\\' => array($vendorDir . '/firebase/php-jwt/src'), +); diff --git a/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_real.php b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_real.php new file mode 100644 index 0000000..911a302 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/composer/autoload_real.php @@ -0,0 +1,59 @@ + $path) { + $loader->set($namespace, $path); + } + + $map = require __DIR__ . '/autoload_psr4.php'; + foreach ($map as $namespace => $path) { + $loader->setPsr4($namespace, $path); + } + + $classMap = require __DIR__ . '/autoload_classmap.php'; + if ($classMap) { + $loader->addClassMap($classMap); + } + + $loader->register(true); + + $includeFiles = require __DIR__ . '/autoload_files.php'; + foreach ($includeFiles as $fileIdentifier => $file) { + composerRequire328b7bd4030afc05dcba77453babcc0c($fileIdentifier, $file); + } + + return $loader; + } +} + +function composerRequire328b7bd4030afc05dcba77453babcc0c($fileIdentifier, $file) +{ + if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) { + require $file; + + $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/composer/installed.json b/Postman/Postman-Mail/google-api-client/vendor/composer/installed.json new file mode 100644 index 0000000..a91ba35 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/composer/installed.json @@ -0,0 +1,709 @@ +[ + { + "name": "psr/http-message", + "version": "1.0.1", + "version_normalized": "1.0.1.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/http-message.git", + "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/http-message/zipball/f6561bf28d520154e4b0ec72be95418abe6d9363", + "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "time": "2016-08-06 14:39:51", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Psr\\Http\\Message\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Common interface for HTTP messages", + "homepage": "https://github.com/php-fig/http-message", + "keywords": [ + "http", + "http-message", + "psr", + "psr-7", + "request", + "response" + ] + }, + { + "name": "guzzlehttp/psr7", + "version": "1.4.2", + "version_normalized": "1.4.2.0", + "source": { + "type": "git", + "url": "https://github.com/guzzle/psr7.git", + "reference": "f5b8a8512e2b58b0071a7280e39f14f72e05d87c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/psr7/zipball/f5b8a8512e2b58b0071a7280e39f14f72e05d87c", + "reference": "f5b8a8512e2b58b0071a7280e39f14f72e05d87c", + "shasum": "" + }, + "require": { + "php": ">=5.4.0", + "psr/http-message": "~1.0" + }, + "provide": { + "psr/http-message-implementation": "1.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.0" + }, + "time": "2017-03-20 17:10:46", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "GuzzleHttp\\Psr7\\": "src/" + }, + "files": [ + "src/functions_include.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "Tobias Schultze", + "homepage": "https://github.com/Tobion" + } + ], + "description": "PSR-7 message implementation that also provides common utility methods", + "keywords": [ + "http", + "message", + "request", + "response", + "stream", + "uri", + "url" + ] + }, + { + "name": "guzzlehttp/promises", + "version": "v1.3.1", + "version_normalized": "1.3.1.0", + "source": { + "type": "git", + "url": "https://github.com/guzzle/promises.git", + "reference": "a59da6cf61d80060647ff4d3eb2c03a2bc694646" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/promises/zipball/a59da6cf61d80060647ff4d3eb2c03a2bc694646", + "reference": "a59da6cf61d80060647ff4d3eb2c03a2bc694646", + "shasum": "" + }, + "require": { + "php": ">=5.5.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.0" + }, + "time": "2016-12-20 10:07:11", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "GuzzleHttp\\Promise\\": "src/" + }, + "files": [ + "src/functions_include.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + } + ], + "description": "Guzzle promises library", + "keywords": [ + "promise" + ] + }, + { + "name": "guzzlehttp/guzzle", + "version": "6.3.0", + "version_normalized": "6.3.0.0", + "source": { + "type": "git", + "url": "https://github.com/guzzle/guzzle.git", + "reference": "f4db5a78a5ea468d4831de7f0bf9d9415e348699" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/guzzle/zipball/f4db5a78a5ea468d4831de7f0bf9d9415e348699", + "reference": "f4db5a78a5ea468d4831de7f0bf9d9415e348699", + "shasum": "" + }, + "require": { + "guzzlehttp/promises": "^1.0", + "guzzlehttp/psr7": "^1.4", + "php": ">=5.5" + }, + "require-dev": { + "ext-curl": "*", + "phpunit/phpunit": "^4.0 || ^5.0", + "psr/log": "^1.0" + }, + "suggest": { + "psr/log": "Required for using the Log middleware" + }, + "time": "2017-06-22 18:50:49", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "6.2-dev" + } + }, + "installation-source": "dist", + "autoload": { + "files": [ + "src/functions_include.php" + ], + "psr-4": { + "GuzzleHttp\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + } + ], + "description": "Guzzle is a PHP HTTP client library", + "homepage": "http://guzzlephp.org/", + "keywords": [ + "client", + "curl", + "framework", + "http", + "http client", + "rest", + "web service" + ] + }, + { + "name": "phpseclib/phpseclib", + "version": "2.0.10", + "version_normalized": "2.0.10.0", + "source": { + "type": "git", + "url": "https://github.com/phpseclib/phpseclib.git", + "reference": "d305b780829ea4252ed9400b3f5937c2c99b51d4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpseclib/phpseclib/zipball/d305b780829ea4252ed9400b3f5937c2c99b51d4", + "reference": "d305b780829ea4252ed9400b3f5937c2c99b51d4", + "shasum": "" + }, + "require": { + "php": ">=5.3.3" + }, + "require-dev": { + "phing/phing": "~2.7", + "phpunit/phpunit": "^4.8.35|^5.7|^6.0", + "sami/sami": "~2.0", + "squizlabs/php_codesniffer": "~2.0" + }, + "suggest": { + "ext-gmp": "Install the GMP (GNU Multiple Precision) extension in order to speed up arbitrary precision integer arithmetic operations.", + "ext-libsodium": "SSH2/SFTP can make use of some algorithms provided by the libsodium-php extension.", + "ext-mcrypt": "Install the Mcrypt extension in order to speed up a few other cryptographic operations.", + "ext-openssl": "Install the OpenSSL extension in order to speed up a wide variety of cryptographic operations." + }, + "time": "2018-02-19 04:29:13", + "type": "library", + "installation-source": "dist", + "autoload": { + "files": [ + "phpseclib/bootstrap.php" + ], + "psr-4": { + "phpseclib\\": "phpseclib/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jim Wigginton", + "email": "terrafrost@php.net", + "role": "Lead Developer" + }, + { + "name": "Patrick Monnerat", + "email": "pm@datasphere.ch", + "role": "Developer" + }, + { + "name": "Andreas Fischer", + "email": "bantu@phpbb.com", + "role": "Developer" + }, + { + "name": "Hans-Jürgen Petrich", + "email": "petrich@tronic-media.com", + "role": "Developer" + }, + { + "name": "Graham Campbell", + "email": "graham@alt-three.com", + "role": "Developer" + } + ], + "description": "PHP Secure Communications Library - Pure-PHP implementations of RSA, AES, SSH2, SFTP, X.509 etc.", + "homepage": "http://phpseclib.sourceforge.net", + "keywords": [ + "BigInteger", + "aes", + "asn.1", + "asn1", + "blowfish", + "crypto", + "cryptography", + "encryption", + "rsa", + "security", + "sftp", + "signature", + "signing", + "ssh", + "twofish", + "x.509", + "x509" + ] + }, + { + "name": "psr/log", + "version": "1.0.2", + "version_normalized": "1.0.2.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/log.git", + "reference": "4ebe3a8bf773a19edfe0a84b6585ba3d401b724d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/log/zipball/4ebe3a8bf773a19edfe0a84b6585ba3d401b724d", + "reference": "4ebe3a8bf773a19edfe0a84b6585ba3d401b724d", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "time": "2016-10-10 12:19:37", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Psr\\Log\\": "Psr/Log/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Common interface for logging libraries", + "homepage": "https://github.com/php-fig/log", + "keywords": [ + "log", + "psr", + "psr-3" + ] + }, + { + "name": "monolog/monolog", + "version": "1.23.0", + "version_normalized": "1.23.0.0", + "source": { + "type": "git", + "url": "https://github.com/Seldaek/monolog.git", + "reference": "fd8c787753b3a2ad11bc60c063cff1358a32a3b4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/Seldaek/monolog/zipball/fd8c787753b3a2ad11bc60c063cff1358a32a3b4", + "reference": "fd8c787753b3a2ad11bc60c063cff1358a32a3b4", + "shasum": "" + }, + "require": { + "php": ">=5.3.0", + "psr/log": "~1.0" + }, + "provide": { + "psr/log-implementation": "1.0.0" + }, + "require-dev": { + "aws/aws-sdk-php": "^2.4.9 || ^3.0", + "doctrine/couchdb": "~1.0@dev", + "graylog2/gelf-php": "~1.0", + "jakub-onderka/php-parallel-lint": "0.9", + "php-amqplib/php-amqplib": "~2.4", + "php-console/php-console": "^3.1.3", + "phpunit/phpunit": "~4.5", + "phpunit/phpunit-mock-objects": "2.3.0", + "ruflin/elastica": ">=0.90 <3.0", + "sentry/sentry": "^0.13", + "swiftmailer/swiftmailer": "^5.3|^6.0" + }, + "suggest": { + "aws/aws-sdk-php": "Allow sending log messages to AWS services like DynamoDB", + "doctrine/couchdb": "Allow sending log messages to a CouchDB server", + "ext-amqp": "Allow sending log messages to an AMQP server (1.0+ required)", + "ext-mongo": "Allow sending log messages to a MongoDB server", + "graylog2/gelf-php": "Allow sending log messages to a GrayLog2 server", + "mongodb/mongodb": "Allow sending log messages to a MongoDB server via PHP Driver", + "php-amqplib/php-amqplib": "Allow sending log messages to an AMQP server using php-amqplib", + "php-console/php-console": "Allow sending log messages to Google Chrome", + "rollbar/rollbar": "Allow sending log messages to Rollbar", + "ruflin/elastica": "Allow sending log messages to an Elastic Search server", + "sentry/sentry": "Allow sending log messages to a Sentry server" + }, + "time": "2017-06-19 01:22:40", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.0.x-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Monolog\\": "src/Monolog" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "http://seld.be" + } + ], + "description": "Sends your logs to files, sockets, inboxes, databases and various web services", + "homepage": "http://github.com/Seldaek/monolog", + "keywords": [ + "log", + "logging", + "psr-3" + ] + }, + { + "name": "firebase/php-jwt", + "version": "v5.0.0", + "version_normalized": "5.0.0.0", + "source": { + "type": "git", + "url": "https://github.com/firebase/php-jwt.git", + "reference": "9984a4d3a32ae7673d6971ea00bae9d0a1abba0e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/firebase/php-jwt/zipball/9984a4d3a32ae7673d6971ea00bae9d0a1abba0e", + "reference": "9984a4d3a32ae7673d6971ea00bae9d0a1abba0e", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "require-dev": { + "phpunit/phpunit": " 4.8.35" + }, + "time": "2017-06-27 22:17:23", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-4": { + "Firebase\\JWT\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Neuman Vong", + "email": "neuman+pear@twilio.com", + "role": "Developer" + }, + { + "name": "Anant Narayanan", + "email": "anant@php.net", + "role": "Developer" + } + ], + "description": "A simple library to encode and decode JSON Web Tokens (JWT) in PHP. Should conform to the current spec.", + "homepage": "https://github.com/firebase/php-jwt" + }, + { + "name": "google/apiclient-services", + "version": "v0.49", + "version_normalized": "0.49.0.0", + "source": { + "type": "git", + "url": "https://github.com/google/google-api-php-client-services.git", + "reference": "7552d7d1bb92e933fc93088014c8c2555c0feab6" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/google/google-api-php-client-services/zipball/7552d7d1bb92e933fc93088014c8c2555c0feab6", + "reference": "7552d7d1bb92e933fc93088014c8c2555c0feab6", + "shasum": "" + }, + "require": { + "php": ">=5.4" + }, + "require-dev": { + "phpunit/phpunit": "~4.8" + }, + "time": "2018-03-04 00:24:05", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-0": { + "Google_Service_": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "Apache-2.0" + ], + "description": "Client library for Google APIs", + "homepage": "http://developers.google.com/api-client-library/php", + "keywords": [ + "google" + ] + }, + { + "name": "psr/cache", + "version": "1.0.1", + "version_normalized": "1.0.1.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/cache.git", + "reference": "d11b50ad223250cf17b86e38383413f5a6764bf8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/cache/zipball/d11b50ad223250cf17b86e38383413f5a6764bf8", + "reference": "d11b50ad223250cf17b86e38383413f5a6764bf8", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "time": "2016-08-06 20:24:11", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Psr\\Cache\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Common interface for caching libraries", + "keywords": [ + "cache", + "psr", + "psr-6" + ] + }, + { + "name": "google/auth", + "version": "v1.2.1", + "version_normalized": "1.2.1.0", + "source": { + "type": "git", + "url": "https://github.com/google/google-auth-library-php.git", + "reference": "da0062d279c9459350808a4fb63dbc08b90d6b90" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/google/google-auth-library-php/zipball/da0062d279c9459350808a4fb63dbc08b90d6b90", + "reference": "da0062d279c9459350808a4fb63dbc08b90d6b90", + "shasum": "" + }, + "require": { + "firebase/php-jwt": "~2.0|~3.0|~4.0|~5.0", + "guzzlehttp/guzzle": "~5.3.1|~6.0", + "guzzlehttp/psr7": "~1.2", + "php": ">=5.4", + "psr/cache": "^1.0", + "psr/http-message": "^1.0" + }, + "require-dev": { + "friendsofphp/php-cs-fixer": "^1.11", + "guzzlehttp/promises": "0.1.1|^1.3", + "phpunit/phpunit": "^4.8.36|^5.7", + "sebastian/comparator": ">=1.2.3" + }, + "time": "2018-01-24 18:28:42", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-4": { + "Google\\Auth\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "Apache-2.0" + ], + "description": "Google Auth Library for PHP", + "homepage": "http://github.com/google/google-auth-library-php", + "keywords": [ + "Authentication", + "google", + "oauth2" + ] + }, + { + "name": "google/apiclient", + "version": "v2.2.1", + "version_normalized": "2.2.1.0", + "source": { + "type": "git", + "url": "https://github.com/google/google-api-php-client.git", + "reference": "b69b8ac4bf6501793c389d4e013a79d09c85c5f2" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/google/google-api-php-client/zipball/b69b8ac4bf6501793c389d4e013a79d09c85c5f2", + "reference": "b69b8ac4bf6501793c389d4e013a79d09c85c5f2", + "shasum": "" + }, + "require": { + "firebase/php-jwt": "~2.0|~3.0|~4.0|~5.0", + "google/apiclient-services": "~0.13", + "google/auth": "^1.0", + "guzzlehttp/guzzle": "~5.3.1|~6.0", + "guzzlehttp/psr7": "^1.2", + "monolog/monolog": "^1.17", + "php": ">=5.4", + "phpseclib/phpseclib": "~0.3.10|~2.0" + }, + "require-dev": { + "cache/filesystem-adapter": "^0.3.2", + "phpunit/phpunit": "~4", + "squizlabs/php_codesniffer": "~2.3", + "symfony/css-selector": "~2.1", + "symfony/dom-crawler": "~2.1" + }, + "suggest": { + "cache/filesystem-adapter": "For caching certs and tokens (using Google_Client::setCache)" + }, + "time": "2017-11-03 01:19:53", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.x-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-0": { + "Google_": "src/" + }, + "classmap": [ + "src/Google/Service/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "Apache-2.0" + ], + "description": "Client library for Google APIs", + "homepage": "http://developers.google.com/api-client-library/php", + "keywords": [ + "google" + ] + } +] diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/.travis.yml b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/.travis.yml new file mode 100644 index 0000000..07ae303 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/.travis.yml @@ -0,0 +1,15 @@ +language: php + +php: + - 5.4 + - 5.5 + - 5.6 + - 7.0 + - 7.1 + - 7.2 + +install: + - composer install + +script: + - phpunit diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/CONTRIBUTING.md b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/CONTRIBUTING.md new file mode 100644 index 0000000..e852a93 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/CONTRIBUTING.md @@ -0,0 +1,22 @@ +# How to become a contributor and submit your own code + +## Contributor License Agreements + +We'd love to accept your code patches! However, before we can take them, we have to jump a couple of legal hurdles. + +Please fill out either the individual or corporate Contributor License Agreement (CLA). + + * If you are an individual writing original source code and you're sure you own the intellectual property, then you'll need to sign an [individual CLA](http://code.google.com/legal/individual-cla-v1.0.html). + * If you work for a company that wants to allow you to contribute your work to this client library, then you'll need to sign a[corporate CLA](http://code.google.com/legal/corporate-cla-v1.0.html). + +Follow either of the two links above to access the appropriate CLA and instructions for how to sign and return it. Once we receive it, we'll add you to the official list of contributors and be able to accept your patches. + +## Submitting Patches + +1. Fork the PHP client library on GitHub +1. Decide which code you want to submit. A submission should be a set of changes that addresses one issue in the issue tracker. Please file one change per issue, and address one issue per change. If you want to make a change that doesn't have a corresponding issue in the issue tracker, please file a new ticket! +1. Ensure that your code adheres to standard PHP conventions, as used in the rest of the library. +1. Ensure that there are unit tests for your code. +1. Sign a Contributor License Agreement (see above). +1. Submit a pull request with your patch on Github. + diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/LICENSE new file mode 100644 index 0000000..a148ba5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/LICENSE @@ -0,0 +1,203 @@ +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, +and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by +the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all +other entities that control, are controlled by, or are under common +control with that entity. For the purposes of this definition, +"control" means (i) the power, direct or indirect, to cause the +direction or management of such entity, whether by contract or +otherwise, or (ii) ownership of fifty percent (50%) or more of the +outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity +exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, +including but not limited to software source code, documentation +source, and configuration files. + +"Object" form shall mean any form resulting from mechanical +transformation or translation of a Source form, including but +not limited to compiled object code, generated documentation, +and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or +Object form, made available under the License, as indicated by a +copyright notice that is included in or attached to the work +(an example is provided in the Appendix below). + +"Derivative Works" shall mean any work, whether in Source or Object +form, that is based on (or derived from) the Work and for which the +editorial revisions, annotations, elaborations, or other modifications +represent, as a whole, an original work of authorship. For the purposes +of this License, Derivative Works shall not include works that remain +separable from, or merely link (or bind by name) to the interfaces of, +the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including +the original version of the Work and any modifications or additions +to that Work or Derivative Works thereof, that is intentionally +submitted to Licensor for inclusion in the Work by the copyright owner +or by an individual or Legal Entity authorized to submit on behalf of +the copyright owner. For the purposes of this definition, "submitted" +means any form of electronic, verbal, or written communication sent +to the Licensor or its representatives, including but not limited to +communication on electronic mailing lists, source code control systems, +and issue tracking systems that are managed by, or on behalf of, the +Licensor for the purpose of discussing and improving the Work, but +excluding communication that is conspicuously marked or otherwise +designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity +on behalf of whom a Contribution has been received by Licensor and +subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +copyright license to reproduce, prepare Derivative Works of, +publicly display, publicly perform, sublicense, and distribute the +Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +(except as stated in this section) patent license to make, have made, +use, offer to sell, sell, import, and otherwise transfer the Work, +where such license applies only to those patent claims licensable +by such Contributor that are necessarily infringed by their +Contribution(s) alone or by combination of their Contribution(s) +with the Work to which such Contribution(s) was submitted. If You +institute patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Work +or a Contribution incorporated within the Work constitutes direct +or contributory patent infringement, then any patent licenses +granted to You under this License for that Work shall terminate +as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the +Work or Derivative Works thereof in any medium, with or without +modifications, and in Source or Object form, provided that You +meet the following conditions: + +(a) You must give any other recipients of the Work or +Derivative Works a copy of this License; and + +(b) You must cause any modified files to carry prominent notices +stating that You changed the files; and + +(c) You must retain, in the Source form of any Derivative Works +that You distribute, all copyright, patent, trademark, and +attribution notices from the Source form of the Work, +excluding those notices that do not pertain to any part of +the Derivative Works; and + +(d) If the Work includes a "NOTICE" text file as part of its +distribution, then any Derivative Works that You distribute must +include a readable copy of the attribution notices contained +within such NOTICE file, excluding those notices that do not +pertain to any part of the Derivative Works, in at least one +of the following places: within a NOTICE text file distributed +as part of the Derivative Works; within the Source form or +documentation, if provided along with the Derivative Works; or, +within a display generated by the Derivative Works, if and +wherever such third-party notices normally appear. The contents +of the NOTICE file are for informational purposes only and +do not modify the License. You may add Your own attribution +notices within Derivative Works that You distribute, alongside +or as an addendum to the NOTICE text from the Work, provided +that such additional attribution notices cannot be construed +as modifying the License. + +You may add Your own copyright statement to Your modifications and +may provide additional or different license terms and conditions +for use, reproduction, or distribution of Your modifications, or +for any such Derivative Works as a whole, provided Your use, +reproduction, and distribution of the Work otherwise complies with +the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, +any Contribution intentionally submitted for inclusion in the Work +by You to the Licensor shall be under the terms and conditions of +this License, without any additional terms or conditions. +Notwithstanding the above, nothing herein shall supersede or modify +the terms of any separate license agreement you may have executed +with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade +names, trademarks, service marks, or product names of the Licensor, +except as required for reasonable and customary use in describing the +origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or +agreed to in writing, Licensor provides the Work (and each +Contributor provides its Contributions) on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or +implied, including, without limitation, any warranties or conditions +of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A +PARTICULAR PURPOSE. You are solely responsible for determining the +appropriateness of using or redistributing the Work and assume any +risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, +whether in tort (including negligence), contract, or otherwise, +unless required by applicable law (such as deliberate and grossly +negligent acts) or agreed to in writing, shall any Contributor be +liable to You for damages, including any direct, indirect, special, +incidental, or consequential damages of any character arising as a +result of this License or out of the use or inability to use the +Work (including but not limited to damages for loss of goodwill, +work stoppage, computer failure or malfunction, or any and all +other commercial damages or losses), even if such Contributor +has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing +the Work or Derivative Works thereof, You may choose to offer, +and charge a fee for, acceptance of support, warranty, indemnity, +or other liability obligations and/or rights consistent with this +License. However, in accepting such obligations, You may act only +on Your own behalf and on Your sole responsibility, not on behalf +of any other Contributor, and only if You agree to indemnify, +defend, and hold each Contributor harmless for any liability +incurred by, or claims asserted against, such Contributor by reason +of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. + +To apply the Apache License to your work, attach the following +boilerplate notice, with the fields enclosed by brackets "[]" +replaced with your own identifying information. (Don't include +the brackets!) The text should be enclosed in the appropriate +comment syntax for the file format. We also recommend that a +file or class name and description of purpose be included on the +same "printed page" as the copyright notice for easier +identification within third-party archives. + +Copyright [yyyy] [name of copyright owner] + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + + diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/README.md b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/README.md new file mode 100644 index 0000000..0eb62fa --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/README.md @@ -0,0 +1,30 @@ +Google PHP API Client Services +============================== + +## Requirements + +[Google API PHP Client](https://github.com/google/google-api-php-client/releases) + +## Usage in v2 of Google API PHP Client + +This library will be automatically installed with the +[Google API PHP Client](https://github.com/google/google-api-php-client/releases) +via composer. Composer will automatically pull down a monthly tag +from this repository. + +If you'd like to always be up-to-date with the latest release, rather than +wait for monthly tagged releases, request the `dev-master` version in composer: + +```sh +composer require google/apiclient-services:dev-master +``` + +## Usage in v1 + +If you are currently using the [`v1-master`](https://github.com/google/google-api-php-client/tree/v1-master) +branch of the client library, but want to use the latest API services, you can +do so by requiring this library directly into your project via the same composer command: + +```sh +composer require google/apiclient-services:dev-master +``` diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/composer.json b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/composer.json new file mode 100644 index 0000000..7c319d0 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/composer.json @@ -0,0 +1,19 @@ +{ + "name": "google/apiclient-services", + "type": "library", + "description": "Client library for Google APIs", + "keywords": ["google"], + "homepage": "http://developers.google.com/api-client-library/php", + "license": "Apache-2.0", + "require": { + "php": ">=5.4" + }, + "require-dev": { + "phpunit/phpunit": "~4.8" + }, + "autoload": { + "psr-0": { + "Google_Service_": "src" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/phpunit.xml b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/phpunit.xml new file mode 100644 index 0000000..d112e5a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/phpunit.xml @@ -0,0 +1,11 @@ + + + + + tests + + + diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail.php new file mode 100644 index 0000000..b13b852 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail.php @@ -0,0 +1,1136 @@ + + * Access Gmail mailboxes including sending user email.

    + * + *

    + * For more information about this service, see the API + * Documentation + *

    + * + * @author Google, Inc. + */ +class Google_Service_Gmail extends Google_Service +{ + /** Read, send, delete, and manage your email. */ + const MAIL_GOOGLE_COM = + "https://mail.google.com/"; + /** Manage drafts and send emails. */ + const GMAIL_COMPOSE = + "https://www.googleapis.com/auth/gmail.compose"; + /** Insert mail into your mailbox. */ + const GMAIL_INSERT = + "https://www.googleapis.com/auth/gmail.insert"; + /** Manage mailbox labels. */ + const GMAIL_LABELS = + "https://www.googleapis.com/auth/gmail.labels"; + /** View your email message metadata such as labels and headers, but not the email body. */ + const GMAIL_METADATA = + "https://www.googleapis.com/auth/gmail.metadata"; + /** View and modify but not delete your email. */ + const GMAIL_MODIFY = + "https://www.googleapis.com/auth/gmail.modify"; + /** View your email messages and settings. */ + const GMAIL_READONLY = + "https://www.googleapis.com/auth/gmail.readonly"; + /** Send email on your behalf. */ + const GMAIL_SEND = + "https://www.googleapis.com/auth/gmail.send"; + /** Manage your basic mail settings. */ + const GMAIL_SETTINGS_BASIC = + "https://www.googleapis.com/auth/gmail.settings.basic"; + /** Manage your sensitive mail settings, including who can manage your mail. */ + const GMAIL_SETTINGS_SHARING = + "https://www.googleapis.com/auth/gmail.settings.sharing"; + + public $users; + public $users_drafts; + public $users_history; + public $users_labels; + public $users_messages; + public $users_messages_attachments; + public $users_settings; + public $users_settings_filters; + public $users_settings_forwardingAddresses; + public $users_settings_sendAs; + public $users_settings_sendAs_smimeInfo; + public $users_threads; + + /** + * Constructs the internal representation of the Gmail service. + * + * @param Google_Client $client + */ + public function __construct(Google_Client $client) + { + parent::__construct($client); + $this->rootUrl = 'https://www.googleapis.com/'; + $this->servicePath = 'gmail/v1/users/'; + $this->version = 'v1'; + $this->serviceName = 'gmail'; + + $this->users = new Google_Service_Gmail_Resource_Users( + $this, + $this->serviceName, + 'users', + array( + 'methods' => array( + 'getProfile' => array( + 'path' => '{userId}/profile', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'stop' => array( + 'path' => '{userId}/stop', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'watch' => array( + 'path' => '{userId}/watch', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_drafts = new Google_Service_Gmail_Resource_UsersDrafts( + $this, + $this->serviceName, + 'drafts', + array( + 'methods' => array( + 'create' => array( + 'path' => '{userId}/drafts', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'delete' => array( + 'path' => '{userId}/drafts/{id}', + 'httpMethod' => 'DELETE', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'get' => array( + 'path' => '{userId}/drafts/{id}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'format' => array( + 'location' => 'query', + 'type' => 'string', + ), + ), + ),'list' => array( + 'path' => '{userId}/drafts', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'includeSpamTrash' => array( + 'location' => 'query', + 'type' => 'boolean', + ), + 'maxResults' => array( + 'location' => 'query', + 'type' => 'integer', + ), + 'pageToken' => array( + 'location' => 'query', + 'type' => 'string', + ), + 'q' => array( + 'location' => 'query', + 'type' => 'string', + ), + ), + ),'send' => array( + 'path' => '{userId}/drafts/send', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'update' => array( + 'path' => '{userId}/drafts/{id}', + 'httpMethod' => 'PUT', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_history = new Google_Service_Gmail_Resource_UsersHistory( + $this, + $this->serviceName, + 'history', + array( + 'methods' => array( + 'list' => array( + 'path' => '{userId}/history', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'historyTypes' => array( + 'location' => 'query', + 'type' => 'string', + 'repeated' => true, + ), + 'labelId' => array( + 'location' => 'query', + 'type' => 'string', + ), + 'maxResults' => array( + 'location' => 'query', + 'type' => 'integer', + ), + 'pageToken' => array( + 'location' => 'query', + 'type' => 'string', + ), + 'startHistoryId' => array( + 'location' => 'query', + 'type' => 'string', + ), + ), + ), + ) + ) + ); + $this->users_labels = new Google_Service_Gmail_Resource_UsersLabels( + $this, + $this->serviceName, + 'labels', + array( + 'methods' => array( + 'create' => array( + 'path' => '{userId}/labels', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'delete' => array( + 'path' => '{userId}/labels/{id}', + 'httpMethod' => 'DELETE', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'get' => array( + 'path' => '{userId}/labels/{id}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'list' => array( + 'path' => '{userId}/labels', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'patch' => array( + 'path' => '{userId}/labels/{id}', + 'httpMethod' => 'PATCH', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'update' => array( + 'path' => '{userId}/labels/{id}', + 'httpMethod' => 'PUT', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_messages = new Google_Service_Gmail_Resource_UsersMessages( + $this, + $this->serviceName, + 'messages', + array( + 'methods' => array( + 'batchDelete' => array( + 'path' => '{userId}/messages/batchDelete', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'batchModify' => array( + 'path' => '{userId}/messages/batchModify', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'delete' => array( + 'path' => '{userId}/messages/{id}', + 'httpMethod' => 'DELETE', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'get' => array( + 'path' => '{userId}/messages/{id}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'format' => array( + 'location' => 'query', + 'type' => 'string', + ), + 'metadataHeaders' => array( + 'location' => 'query', + 'type' => 'string', + 'repeated' => true, + ), + ), + ),'import' => array( + 'path' => '{userId}/messages/import', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'deleted' => array( + 'location' => 'query', + 'type' => 'boolean', + ), + 'internalDateSource' => array( + 'location' => 'query', + 'type' => 'string', + ), + 'neverMarkSpam' => array( + 'location' => 'query', + 'type' => 'boolean', + ), + 'processForCalendar' => array( + 'location' => 'query', + 'type' => 'boolean', + ), + ), + ),'insert' => array( + 'path' => '{userId}/messages', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'deleted' => array( + 'location' => 'query', + 'type' => 'boolean', + ), + 'internalDateSource' => array( + 'location' => 'query', + 'type' => 'string', + ), + ), + ),'list' => array( + 'path' => '{userId}/messages', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'includeSpamTrash' => array( + 'location' => 'query', + 'type' => 'boolean', + ), + 'labelIds' => array( + 'location' => 'query', + 'type' => 'string', + 'repeated' => true, + ), + 'maxResults' => array( + 'location' => 'query', + 'type' => 'integer', + ), + 'pageToken' => array( + 'location' => 'query', + 'type' => 'string', + ), + 'q' => array( + 'location' => 'query', + 'type' => 'string', + ), + ), + ),'modify' => array( + 'path' => '{userId}/messages/{id}/modify', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'send' => array( + 'path' => '{userId}/messages/send', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'trash' => array( + 'path' => '{userId}/messages/{id}/trash', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'untrash' => array( + 'path' => '{userId}/messages/{id}/untrash', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_messages_attachments = new Google_Service_Gmail_Resource_UsersMessagesAttachments( + $this, + $this->serviceName, + 'attachments', + array( + 'methods' => array( + 'get' => array( + 'path' => '{userId}/messages/{messageId}/attachments/{id}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'messageId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_settings = new Google_Service_Gmail_Resource_UsersSettings( + $this, + $this->serviceName, + 'settings', + array( + 'methods' => array( + 'getAutoForwarding' => array( + 'path' => '{userId}/settings/autoForwarding', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'getImap' => array( + 'path' => '{userId}/settings/imap', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'getPop' => array( + 'path' => '{userId}/settings/pop', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'getVacation' => array( + 'path' => '{userId}/settings/vacation', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'updateAutoForwarding' => array( + 'path' => '{userId}/settings/autoForwarding', + 'httpMethod' => 'PUT', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'updateImap' => array( + 'path' => '{userId}/settings/imap', + 'httpMethod' => 'PUT', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'updatePop' => array( + 'path' => '{userId}/settings/pop', + 'httpMethod' => 'PUT', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'updateVacation' => array( + 'path' => '{userId}/settings/vacation', + 'httpMethod' => 'PUT', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_settings_filters = new Google_Service_Gmail_Resource_UsersSettingsFilters( + $this, + $this->serviceName, + 'filters', + array( + 'methods' => array( + 'create' => array( + 'path' => '{userId}/settings/filters', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'delete' => array( + 'path' => '{userId}/settings/filters/{id}', + 'httpMethod' => 'DELETE', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'get' => array( + 'path' => '{userId}/settings/filters/{id}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'list' => array( + 'path' => '{userId}/settings/filters', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_settings_forwardingAddresses = new Google_Service_Gmail_Resource_UsersSettingsForwardingAddresses( + $this, + $this->serviceName, + 'forwardingAddresses', + array( + 'methods' => array( + 'create' => array( + 'path' => '{userId}/settings/forwardingAddresses', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'delete' => array( + 'path' => '{userId}/settings/forwardingAddresses/{forwardingEmail}', + 'httpMethod' => 'DELETE', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'forwardingEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'get' => array( + 'path' => '{userId}/settings/forwardingAddresses/{forwardingEmail}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'forwardingEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'list' => array( + 'path' => '{userId}/settings/forwardingAddresses', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_settings_sendAs = new Google_Service_Gmail_Resource_UsersSettingsSendAs( + $this, + $this->serviceName, + 'sendAs', + array( + 'methods' => array( + 'create' => array( + 'path' => '{userId}/settings/sendAs', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'delete' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}', + 'httpMethod' => 'DELETE', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'get' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'list' => array( + 'path' => '{userId}/settings/sendAs', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'patch' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}', + 'httpMethod' => 'PATCH', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'update' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}', + 'httpMethod' => 'PUT', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'verify' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}/verify', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_settings_sendAs_smimeInfo = new Google_Service_Gmail_Resource_UsersSettingsSendAsSmimeInfo( + $this, + $this->serviceName, + 'smimeInfo', + array( + 'methods' => array( + 'delete' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}', + 'httpMethod' => 'DELETE', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'get' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'insert' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'list' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'setDefault' => array( + 'path' => '{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'sendAsEmail' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + $this->users_threads = new Google_Service_Gmail_Resource_UsersThreads( + $this, + $this->serviceName, + 'threads', + array( + 'methods' => array( + 'delete' => array( + 'path' => '{userId}/threads/{id}', + 'httpMethod' => 'DELETE', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'get' => array( + 'path' => '{userId}/threads/{id}', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'format' => array( + 'location' => 'query', + 'type' => 'string', + ), + 'metadataHeaders' => array( + 'location' => 'query', + 'type' => 'string', + 'repeated' => true, + ), + ), + ),'list' => array( + 'path' => '{userId}/threads', + 'httpMethod' => 'GET', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'includeSpamTrash' => array( + 'location' => 'query', + 'type' => 'boolean', + ), + 'labelIds' => array( + 'location' => 'query', + 'type' => 'string', + 'repeated' => true, + ), + 'maxResults' => array( + 'location' => 'query', + 'type' => 'integer', + ), + 'pageToken' => array( + 'location' => 'query', + 'type' => 'string', + ), + 'q' => array( + 'location' => 'query', + 'type' => 'string', + ), + ), + ),'modify' => array( + 'path' => '{userId}/threads/{id}/modify', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'trash' => array( + 'path' => '{userId}/threads/{id}/trash', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ),'untrash' => array( + 'path' => '{userId}/threads/{id}/untrash', + 'httpMethod' => 'POST', + 'parameters' => array( + 'userId' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + 'id' => array( + 'location' => 'path', + 'type' => 'string', + 'required' => true, + ), + ), + ), + ) + ) + ); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/AutoForwarding.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/AutoForwarding.php new file mode 100644 index 0000000..86afef2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/AutoForwarding.php @@ -0,0 +1,48 @@ +disposition = $disposition; + } + public function getDisposition() + { + return $this->disposition; + } + public function setEmailAddress($emailAddress) + { + $this->emailAddress = $emailAddress; + } + public function getEmailAddress() + { + return $this->emailAddress; + } + public function setEnabled($enabled) + { + $this->enabled = $enabled; + } + public function getEnabled() + { + return $this->enabled; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/BatchDeleteMessagesRequest.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/BatchDeleteMessagesRequest.php new file mode 100644 index 0000000..136acf6 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/BatchDeleteMessagesRequest.php @@ -0,0 +1,31 @@ +ids = $ids; + } + public function getIds() + { + return $this->ids; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/BatchModifyMessagesRequest.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/BatchModifyMessagesRequest.php new file mode 100644 index 0000000..911c221 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/BatchModifyMessagesRequest.php @@ -0,0 +1,49 @@ +addLabelIds = $addLabelIds; + } + public function getAddLabelIds() + { + return $this->addLabelIds; + } + public function setIds($ids) + { + $this->ids = $ids; + } + public function getIds() + { + return $this->ids; + } + public function setRemoveLabelIds($removeLabelIds) + { + $this->removeLabelIds = $removeLabelIds; + } + public function getRemoveLabelIds() + { + return $this->removeLabelIds; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Draft.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Draft.php new file mode 100644 index 0000000..b2f9cc6 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Draft.php @@ -0,0 +1,46 @@ +id = $id; + } + public function getId() + { + return $this->id; + } + /** + * @param Google_Service_Gmail_Message + */ + public function setMessage(Google_Service_Gmail_Message $message) + { + $this->message = $message; + } + /** + * @return Google_Service_Gmail_Message + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Filter.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Filter.php new file mode 100644 index 0000000..ee40b18 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Filter.php @@ -0,0 +1,62 @@ +action = $action; + } + /** + * @return Google_Service_Gmail_FilterAction + */ + public function getAction() + { + return $this->action; + } + /** + * @param Google_Service_Gmail_FilterCriteria + */ + public function setCriteria(Google_Service_Gmail_FilterCriteria $criteria) + { + $this->criteria = $criteria; + } + /** + * @return Google_Service_Gmail_FilterCriteria + */ + public function getCriteria() + { + return $this->criteria; + } + public function setId($id) + { + $this->id = $id; + } + public function getId() + { + return $this->id; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/FilterAction.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/FilterAction.php new file mode 100644 index 0000000..e11c467 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/FilterAction.php @@ -0,0 +1,49 @@ +addLabelIds = $addLabelIds; + } + public function getAddLabelIds() + { + return $this->addLabelIds; + } + public function setForward($forward) + { + $this->forward = $forward; + } + public function getForward() + { + return $this->forward; + } + public function setRemoveLabelIds($removeLabelIds) + { + $this->removeLabelIds = $removeLabelIds; + } + public function getRemoveLabelIds() + { + return $this->removeLabelIds; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/FilterCriteria.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/FilterCriteria.php new file mode 100644 index 0000000..1b26c4d --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/FilterCriteria.php @@ -0,0 +1,102 @@ +excludeChats = $excludeChats; + } + public function getExcludeChats() + { + return $this->excludeChats; + } + public function setFrom($from) + { + $this->from = $from; + } + public function getFrom() + { + return $this->from; + } + public function setHasAttachment($hasAttachment) + { + $this->hasAttachment = $hasAttachment; + } + public function getHasAttachment() + { + return $this->hasAttachment; + } + public function setNegatedQuery($negatedQuery) + { + $this->negatedQuery = $negatedQuery; + } + public function getNegatedQuery() + { + return $this->negatedQuery; + } + public function setQuery($query) + { + $this->query = $query; + } + public function getQuery() + { + return $this->query; + } + public function setSize($size) + { + $this->size = $size; + } + public function getSize() + { + return $this->size; + } + public function setSizeComparison($sizeComparison) + { + $this->sizeComparison = $sizeComparison; + } + public function getSizeComparison() + { + return $this->sizeComparison; + } + public function setSubject($subject) + { + $this->subject = $subject; + } + public function getSubject() + { + return $this->subject; + } + public function setTo($to) + { + $this->to = $to; + } + public function getTo() + { + return $this->to; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ForwardingAddress.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ForwardingAddress.php new file mode 100644 index 0000000..f2ea60e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ForwardingAddress.php @@ -0,0 +1,39 @@ +forwardingEmail = $forwardingEmail; + } + public function getForwardingEmail() + { + return $this->forwardingEmail; + } + public function setVerificationStatus($verificationStatus) + { + $this->verificationStatus = $verificationStatus; + } + public function getVerificationStatus() + { + return $this->verificationStatus; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/History.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/History.php new file mode 100644 index 0000000..35b65fa --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/History.php @@ -0,0 +1,111 @@ +id = $id; + } + public function getId() + { + return $this->id; + } + /** + * @param Google_Service_Gmail_HistoryLabelAdded + */ + public function setLabelsAdded($labelsAdded) + { + $this->labelsAdded = $labelsAdded; + } + /** + * @return Google_Service_Gmail_HistoryLabelAdded + */ + public function getLabelsAdded() + { + return $this->labelsAdded; + } + /** + * @param Google_Service_Gmail_HistoryLabelRemoved + */ + public function setLabelsRemoved($labelsRemoved) + { + $this->labelsRemoved = $labelsRemoved; + } + /** + * @return Google_Service_Gmail_HistoryLabelRemoved + */ + public function getLabelsRemoved() + { + return $this->labelsRemoved; + } + /** + * @param Google_Service_Gmail_Message + */ + public function setMessages($messages) + { + $this->messages = $messages; + } + /** + * @return Google_Service_Gmail_Message + */ + public function getMessages() + { + return $this->messages; + } + /** + * @param Google_Service_Gmail_HistoryMessageAdded + */ + public function setMessagesAdded($messagesAdded) + { + $this->messagesAdded = $messagesAdded; + } + /** + * @return Google_Service_Gmail_HistoryMessageAdded + */ + public function getMessagesAdded() + { + return $this->messagesAdded; + } + /** + * @param Google_Service_Gmail_HistoryMessageDeleted + */ + public function setMessagesDeleted($messagesDeleted) + { + $this->messagesDeleted = $messagesDeleted; + } + /** + * @return Google_Service_Gmail_HistoryMessageDeleted + */ + public function getMessagesDeleted() + { + return $this->messagesDeleted; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryLabelAdded.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryLabelAdded.php new file mode 100644 index 0000000..8292377 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryLabelAdded.php @@ -0,0 +1,47 @@ +labelIds = $labelIds; + } + public function getLabelIds() + { + return $this->labelIds; + } + /** + * @param Google_Service_Gmail_Message + */ + public function setMessage(Google_Service_Gmail_Message $message) + { + $this->message = $message; + } + /** + * @return Google_Service_Gmail_Message + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryLabelRemoved.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryLabelRemoved.php new file mode 100644 index 0000000..873f6da --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryLabelRemoved.php @@ -0,0 +1,47 @@ +labelIds = $labelIds; + } + public function getLabelIds() + { + return $this->labelIds; + } + /** + * @param Google_Service_Gmail_Message + */ + public function setMessage(Google_Service_Gmail_Message $message) + { + $this->message = $message; + } + /** + * @return Google_Service_Gmail_Message + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryMessageAdded.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryMessageAdded.php new file mode 100644 index 0000000..5f86357 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryMessageAdded.php @@ -0,0 +1,37 @@ +message = $message; + } + /** + * @return Google_Service_Gmail_Message + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryMessageDeleted.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryMessageDeleted.php new file mode 100644 index 0000000..0afa797 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/HistoryMessageDeleted.php @@ -0,0 +1,37 @@ +message = $message; + } + /** + * @return Google_Service_Gmail_Message + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ImapSettings.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ImapSettings.php new file mode 100644 index 0000000..df939b7 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ImapSettings.php @@ -0,0 +1,57 @@ +autoExpunge = $autoExpunge; + } + public function getAutoExpunge() + { + return $this->autoExpunge; + } + public function setEnabled($enabled) + { + $this->enabled = $enabled; + } + public function getEnabled() + { + return $this->enabled; + } + public function setExpungeBehavior($expungeBehavior) + { + $this->expungeBehavior = $expungeBehavior; + } + public function getExpungeBehavior() + { + return $this->expungeBehavior; + } + public function setMaxFolderSize($maxFolderSize) + { + $this->maxFolderSize = $maxFolderSize; + } + public function getMaxFolderSize() + { + return $this->maxFolderSize; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Label.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Label.php new file mode 100644 index 0000000..f428a93 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Label.php @@ -0,0 +1,118 @@ +color = $color; + } + /** + * @return Google_Service_Gmail_LabelColor + */ + public function getColor() + { + return $this->color; + } + public function setId($id) + { + $this->id = $id; + } + public function getId() + { + return $this->id; + } + public function setLabelListVisibility($labelListVisibility) + { + $this->labelListVisibility = $labelListVisibility; + } + public function getLabelListVisibility() + { + return $this->labelListVisibility; + } + public function setMessageListVisibility($messageListVisibility) + { + $this->messageListVisibility = $messageListVisibility; + } + public function getMessageListVisibility() + { + return $this->messageListVisibility; + } + public function setMessagesTotal($messagesTotal) + { + $this->messagesTotal = $messagesTotal; + } + public function getMessagesTotal() + { + return $this->messagesTotal; + } + public function setMessagesUnread($messagesUnread) + { + $this->messagesUnread = $messagesUnread; + } + public function getMessagesUnread() + { + return $this->messagesUnread; + } + public function setName($name) + { + $this->name = $name; + } + public function getName() + { + return $this->name; + } + public function setThreadsTotal($threadsTotal) + { + $this->threadsTotal = $threadsTotal; + } + public function getThreadsTotal() + { + return $this->threadsTotal; + } + public function setThreadsUnread($threadsUnread) + { + $this->threadsUnread = $threadsUnread; + } + public function getThreadsUnread() + { + return $this->threadsUnread; + } + public function setType($type) + { + $this->type = $type; + } + public function getType() + { + return $this->type; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/LabelColor.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/LabelColor.php new file mode 100644 index 0000000..10c3187 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/LabelColor.php @@ -0,0 +1,39 @@ +backgroundColor = $backgroundColor; + } + public function getBackgroundColor() + { + return $this->backgroundColor; + } + public function setTextColor($textColor) + { + $this->textColor = $textColor; + } + public function getTextColor() + { + return $this->textColor; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListDraftsResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListDraftsResponse.php new file mode 100644 index 0000000..dbfce46 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListDraftsResponse.php @@ -0,0 +1,56 @@ +drafts = $drafts; + } + /** + * @return Google_Service_Gmail_Draft + */ + public function getDrafts() + { + return $this->drafts; + } + public function setNextPageToken($nextPageToken) + { + $this->nextPageToken = $nextPageToken; + } + public function getNextPageToken() + { + return $this->nextPageToken; + } + public function setResultSizeEstimate($resultSizeEstimate) + { + $this->resultSizeEstimate = $resultSizeEstimate; + } + public function getResultSizeEstimate() + { + return $this->resultSizeEstimate; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListFiltersResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListFiltersResponse.php new file mode 100644 index 0000000..589d782 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListFiltersResponse.php @@ -0,0 +1,38 @@ +filter = $filter; + } + /** + * @return Google_Service_Gmail_Filter + */ + public function getFilter() + { + return $this->filter; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListForwardingAddressesResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListForwardingAddressesResponse.php new file mode 100644 index 0000000..477f861 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListForwardingAddressesResponse.php @@ -0,0 +1,38 @@ +forwardingAddresses = $forwardingAddresses; + } + /** + * @return Google_Service_Gmail_ForwardingAddress + */ + public function getForwardingAddresses() + { + return $this->forwardingAddresses; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListHistoryResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListHistoryResponse.php new file mode 100644 index 0000000..a0d7d67 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListHistoryResponse.php @@ -0,0 +1,56 @@ +history = $history; + } + /** + * @return Google_Service_Gmail_History + */ + public function getHistory() + { + return $this->history; + } + public function setHistoryId($historyId) + { + $this->historyId = $historyId; + } + public function getHistoryId() + { + return $this->historyId; + } + public function setNextPageToken($nextPageToken) + { + $this->nextPageToken = $nextPageToken; + } + public function getNextPageToken() + { + return $this->nextPageToken; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListLabelsResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListLabelsResponse.php new file mode 100644 index 0000000..9075e9c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListLabelsResponse.php @@ -0,0 +1,38 @@ +labels = $labels; + } + /** + * @return Google_Service_Gmail_Label + */ + public function getLabels() + { + return $this->labels; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListMessagesResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListMessagesResponse.php new file mode 100644 index 0000000..e246fe1 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListMessagesResponse.php @@ -0,0 +1,56 @@ +messages = $messages; + } + /** + * @return Google_Service_Gmail_Message + */ + public function getMessages() + { + return $this->messages; + } + public function setNextPageToken($nextPageToken) + { + $this->nextPageToken = $nextPageToken; + } + public function getNextPageToken() + { + return $this->nextPageToken; + } + public function setResultSizeEstimate($resultSizeEstimate) + { + $this->resultSizeEstimate = $resultSizeEstimate; + } + public function getResultSizeEstimate() + { + return $this->resultSizeEstimate; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListSendAsResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListSendAsResponse.php new file mode 100644 index 0000000..6048c42 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListSendAsResponse.php @@ -0,0 +1,38 @@ +sendAs = $sendAs; + } + /** + * @return Google_Service_Gmail_SendAs + */ + public function getSendAs() + { + return $this->sendAs; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListSmimeInfoResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListSmimeInfoResponse.php new file mode 100644 index 0000000..277907a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListSmimeInfoResponse.php @@ -0,0 +1,38 @@ +smimeInfo = $smimeInfo; + } + /** + * @return Google_Service_Gmail_SmimeInfo + */ + public function getSmimeInfo() + { + return $this->smimeInfo; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListThreadsResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListThreadsResponse.php new file mode 100644 index 0000000..347a39c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ListThreadsResponse.php @@ -0,0 +1,56 @@ +nextPageToken = $nextPageToken; + } + public function getNextPageToken() + { + return $this->nextPageToken; + } + public function setResultSizeEstimate($resultSizeEstimate) + { + $this->resultSizeEstimate = $resultSizeEstimate; + } + public function getResultSizeEstimate() + { + return $this->resultSizeEstimate; + } + /** + * @param Google_Service_Gmail_Thread + */ + public function setThreads($threads) + { + $this->threads = $threads; + } + /** + * @return Google_Service_Gmail_Thread + */ + public function getThreads() + { + return $this->threads; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Message.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Message.php new file mode 100644 index 0000000..b5d0bc8 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Message.php @@ -0,0 +1,110 @@ +historyId = $historyId; + } + public function getHistoryId() + { + return $this->historyId; + } + public function setId($id) + { + $this->id = $id; + } + public function getId() + { + return $this->id; + } + public function setInternalDate($internalDate) + { + $this->internalDate = $internalDate; + } + public function getInternalDate() + { + return $this->internalDate; + } + public function setLabelIds($labelIds) + { + $this->labelIds = $labelIds; + } + public function getLabelIds() + { + return $this->labelIds; + } + /** + * @param Google_Service_Gmail_MessagePart + */ + public function setPayload(Google_Service_Gmail_MessagePart $payload) + { + $this->payload = $payload; + } + /** + * @return Google_Service_Gmail_MessagePart + */ + public function getPayload() + { + return $this->payload; + } + public function setRaw($raw) + { + $this->raw = $raw; + } + public function getRaw() + { + return $this->raw; + } + public function setSizeEstimate($sizeEstimate) + { + $this->sizeEstimate = $sizeEstimate; + } + public function getSizeEstimate() + { + return $this->sizeEstimate; + } + public function setSnippet($snippet) + { + $this->snippet = $snippet; + } + public function getSnippet() + { + return $this->snippet; + } + public function setThreadId($threadId) + { + $this->threadId = $threadId; + } + public function getThreadId() + { + return $this->threadId; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePart.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePart.php new file mode 100644 index 0000000..e8270e1 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePart.php @@ -0,0 +1,97 @@ +body = $body; + } + /** + * @return Google_Service_Gmail_MessagePartBody + */ + public function getBody() + { + return $this->body; + } + public function setFilename($filename) + { + $this->filename = $filename; + } + public function getFilename() + { + return $this->filename; + } + /** + * @param Google_Service_Gmail_MessagePartHeader + */ + public function setHeaders($headers) + { + $this->headers = $headers; + } + /** + * @return Google_Service_Gmail_MessagePartHeader + */ + public function getHeaders() + { + return $this->headers; + } + public function setMimeType($mimeType) + { + $this->mimeType = $mimeType; + } + public function getMimeType() + { + return $this->mimeType; + } + public function setPartId($partId) + { + $this->partId = $partId; + } + public function getPartId() + { + return $this->partId; + } + /** + * @param Google_Service_Gmail_MessagePart + */ + public function setParts($parts) + { + $this->parts = $parts; + } + /** + * @return Google_Service_Gmail_MessagePart + */ + public function getParts() + { + return $this->parts; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePartBody.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePartBody.php new file mode 100644 index 0000000..89323ef --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePartBody.php @@ -0,0 +1,48 @@ +attachmentId = $attachmentId; + } + public function getAttachmentId() + { + return $this->attachmentId; + } + public function setData($data) + { + $this->data = $data; + } + public function getData() + { + return $this->data; + } + public function setSize($size) + { + $this->size = $size; + } + public function getSize() + { + return $this->size; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePartHeader.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePartHeader.php new file mode 100644 index 0000000..8789faf --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/MessagePartHeader.php @@ -0,0 +1,39 @@ +name = $name; + } + public function getName() + { + return $this->name; + } + public function setValue($value) + { + $this->value = $value; + } + public function getValue() + { + return $this->value; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ModifyMessageRequest.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ModifyMessageRequest.php new file mode 100644 index 0000000..7f37a47 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ModifyMessageRequest.php @@ -0,0 +1,40 @@ +addLabelIds = $addLabelIds; + } + public function getAddLabelIds() + { + return $this->addLabelIds; + } + public function setRemoveLabelIds($removeLabelIds) + { + $this->removeLabelIds = $removeLabelIds; + } + public function getRemoveLabelIds() + { + return $this->removeLabelIds; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ModifyThreadRequest.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ModifyThreadRequest.php new file mode 100644 index 0000000..a8fec01 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/ModifyThreadRequest.php @@ -0,0 +1,40 @@ +addLabelIds = $addLabelIds; + } + public function getAddLabelIds() + { + return $this->addLabelIds; + } + public function setRemoveLabelIds($removeLabelIds) + { + $this->removeLabelIds = $removeLabelIds; + } + public function getRemoveLabelIds() + { + return $this->removeLabelIds; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/PopSettings.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/PopSettings.php new file mode 100644 index 0000000..6069dc8 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/PopSettings.php @@ -0,0 +1,39 @@ +accessWindow = $accessWindow; + } + public function getAccessWindow() + { + return $this->accessWindow; + } + public function setDisposition($disposition) + { + $this->disposition = $disposition; + } + public function getDisposition() + { + return $this->disposition; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Profile.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Profile.php new file mode 100644 index 0000000..7dda18c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Profile.php @@ -0,0 +1,57 @@ +emailAddress = $emailAddress; + } + public function getEmailAddress() + { + return $this->emailAddress; + } + public function setHistoryId($historyId) + { + $this->historyId = $historyId; + } + public function getHistoryId() + { + return $this->historyId; + } + public function setMessagesTotal($messagesTotal) + { + $this->messagesTotal = $messagesTotal; + } + public function getMessagesTotal() + { + return $this->messagesTotal; + } + public function setThreadsTotal($threadsTotal) + { + $this->threadsTotal = $threadsTotal; + } + public function getThreadsTotal() + { + return $this->threadsTotal; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/Users.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/Users.php new file mode 100644 index 0000000..947fc56 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/Users.php @@ -0,0 +1,71 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $users = $gmailService->users; + * + */ +class Google_Service_Gmail_Resource_Users extends Google_Service_Resource +{ + /** + * Gets the current user's Gmail profile. (users.getProfile) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Profile + */ + public function getProfile($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('getProfile', array($params), "Google_Service_Gmail_Profile"); + } + /** + * Stop receiving push notifications for the given user mailbox. (users.stop) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + */ + public function stop($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('stop', array($params)); + } + /** + * Set up or update a push notification watch on the given user mailbox. + * (users.watch) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_WatchRequest $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_WatchResponse + */ + public function watch($userId, Google_Service_Gmail_WatchRequest $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('watch', array($params), "Google_Service_Gmail_WatchResponse"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersDrafts.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersDrafts.php new file mode 100644 index 0000000..d0ec543 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersDrafts.php @@ -0,0 +1,130 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $drafts = $gmailService->drafts; + * + */ +class Google_Service_Gmail_Resource_UsersDrafts extends Google_Service_Resource +{ + /** + * Creates a new draft with the DRAFT label. (drafts.create) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_Draft $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Draft + */ + public function create($userId, Google_Service_Gmail_Draft $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('create', array($params), "Google_Service_Gmail_Draft"); + } + /** + * Immediately and permanently deletes the specified draft. Does not simply + * trash it. (drafts.delete) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the draft to delete. + * @param array $optParams Optional parameters. + */ + public function delete($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('delete', array($params)); + } + /** + * Gets the specified draft. (drafts.get) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the draft to retrieve. + * @param array $optParams Optional parameters. + * + * @opt_param string format The format to return the draft in. + * @return Google_Service_Gmail_Draft + */ + public function get($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_Draft"); + } + /** + * Lists the drafts in the user's mailbox. (drafts.listUsersDrafts) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * + * @opt_param bool includeSpamTrash Include drafts from SPAM and TRASH in the + * results. + * @opt_param string maxResults Maximum number of drafts to return. + * @opt_param string pageToken Page token to retrieve a specific page of results + * in the list. + * @opt_param string q Only return draft messages matching the specified query. + * Supports the same query format as the Gmail search box. For example, + * "from:someuser@example.com rfc822msgid: is:unread". + * @return Google_Service_Gmail_ListDraftsResponse + */ + public function listUsersDrafts($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListDraftsResponse"); + } + /** + * Sends the specified, existing draft to the recipients in the To, Cc, and Bcc + * headers. (drafts.send) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_Draft $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Message + */ + public function send($userId, Google_Service_Gmail_Draft $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('send', array($params), "Google_Service_Gmail_Message"); + } + /** + * Replaces a draft's content. (drafts.update) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the draft to update. + * @param Google_Service_Gmail_Draft $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Draft + */ + public function update($userId, $id, Google_Service_Gmail_Draft $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('update', array($params), "Google_Service_Gmail_Draft"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersHistory.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersHistory.php new file mode 100644 index 0000000..128bd17 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersHistory.php @@ -0,0 +1,61 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $history = $gmailService->history; + * + */ +class Google_Service_Gmail_Resource_UsersHistory extends Google_Service_Resource +{ + /** + * Lists the history of all changes to the given mailbox. History results are + * returned in chronological order (increasing historyId). + * (history.listUsersHistory) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * + * @opt_param string historyTypes History types to be returned by the function + * @opt_param string labelId Only return messages with a label matching the ID. + * @opt_param string maxResults The maximum number of history records to return. + * @opt_param string pageToken Page token to retrieve a specific page of results + * in the list. + * @opt_param string startHistoryId Required. Returns history records after the + * specified startHistoryId. The supplied startHistoryId should be obtained from + * the historyId of a message, thread, or previous list response. History IDs + * increase chronologically but are not contiguous with random gaps in between + * valid IDs. Supplying an invalid or out of date startHistoryId typically + * returns an HTTP 404 error code. A historyId is typically valid for at least a + * week, but in some rare circumstances may be valid for only a few hours. If + * you receive an HTTP 404 error response, your application should perform a + * full sync. If you receive no nextPageToken in the response, there are no + * updates to retrieve and you can store the returned historyId for a future + * request. + * @return Google_Service_Gmail_ListHistoryResponse + */ + public function listUsersHistory($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListHistoryResponse"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersLabels.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersLabels.php new file mode 100644 index 0000000..88b33ce --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersLabels.php @@ -0,0 +1,120 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $labels = $gmailService->labels; + * + */ +class Google_Service_Gmail_Resource_UsersLabels extends Google_Service_Resource +{ + /** + * Creates a new label. (labels.create) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_Label $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Label + */ + public function create($userId, Google_Service_Gmail_Label $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('create', array($params), "Google_Service_Gmail_Label"); + } + /** + * Immediately and permanently deletes the specified label and removes it from + * any messages and threads that it is applied to. (labels.delete) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the label to delete. + * @param array $optParams Optional parameters. + */ + public function delete($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('delete', array($params)); + } + /** + * Gets the specified label. (labels.get) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the label to retrieve. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Label + */ + public function get($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_Label"); + } + /** + * Lists all labels in the user's mailbox. (labels.listUsersLabels) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ListLabelsResponse + */ + public function listUsersLabels($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListLabelsResponse"); + } + /** + * Updates the specified label. This method supports patch semantics. + * (labels.patch) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the label to update. + * @param Google_Service_Gmail_Label $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Label + */ + public function patch($userId, $id, Google_Service_Gmail_Label $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('patch', array($params), "Google_Service_Gmail_Label"); + } + /** + * Updates the specified label. (labels.update) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the label to update. + * @param Google_Service_Gmail_Label $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Label + */ + public function update($userId, $id, Google_Service_Gmail_Label $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('update', array($params), "Google_Service_Gmail_Label"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersMessages.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersMessages.php new file mode 100644 index 0000000..67c737b --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersMessages.php @@ -0,0 +1,229 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $messages = $gmailService->messages; + * + */ +class Google_Service_Gmail_Resource_UsersMessages extends Google_Service_Resource +{ + /** + * Deletes many messages by message ID. Provides no guarantees that messages + * were not already deleted or even existed at all. (messages.batchDelete) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_BatchDeleteMessagesRequest $postBody + * @param array $optParams Optional parameters. + */ + public function batchDelete($userId, Google_Service_Gmail_BatchDeleteMessagesRequest $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('batchDelete', array($params)); + } + /** + * Modifies the labels on the specified messages. (messages.batchModify) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_BatchModifyMessagesRequest $postBody + * @param array $optParams Optional parameters. + */ + public function batchModify($userId, Google_Service_Gmail_BatchModifyMessagesRequest $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('batchModify', array($params)); + } + /** + * Immediately and permanently deletes the specified message. This operation + * cannot be undone. Prefer messages.trash instead. (messages.delete) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the message to delete. + * @param array $optParams Optional parameters. + */ + public function delete($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('delete', array($params)); + } + /** + * Gets the specified message. (messages.get) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the message to retrieve. + * @param array $optParams Optional parameters. + * + * @opt_param string format The format to return the message in. + * @opt_param string metadataHeaders When given and format is METADATA, only + * include headers specified. + * @return Google_Service_Gmail_Message + */ + public function get($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_Message"); + } + /** + * Imports a message into only this user's mailbox, with standard email delivery + * scanning and classification similar to receiving via SMTP. Does not send a + * message. (messages.import) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_Message $postBody + * @param array $optParams Optional parameters. + * + * @opt_param bool deleted Mark the email as permanently deleted (not TRASH) and + * only visible in Google Vault to a Vault administrator. Only used for G Suite + * accounts. + * @opt_param string internalDateSource Source for Gmail's internal date of the + * message. + * @opt_param bool neverMarkSpam Ignore the Gmail spam classifier decision and + * never mark this email as SPAM in the mailbox. + * @opt_param bool processForCalendar Process calendar invites in the email and + * add any extracted meetings to the Google Calendar for this user. + * @return Google_Service_Gmail_Message + */ + public function import($userId, Google_Service_Gmail_Message $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('import', array($params), "Google_Service_Gmail_Message"); + } + /** + * Directly inserts a message into only this user's mailbox similar to IMAP + * APPEND, bypassing most scanning and classification. Does not send a message. + * (messages.insert) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_Message $postBody + * @param array $optParams Optional parameters. + * + * @opt_param bool deleted Mark the email as permanently deleted (not TRASH) and + * only visible in Google Vault to a Vault administrator. Only used for G Suite + * accounts. + * @opt_param string internalDateSource Source for Gmail's internal date of the + * message. + * @return Google_Service_Gmail_Message + */ + public function insert($userId, Google_Service_Gmail_Message $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('insert', array($params), "Google_Service_Gmail_Message"); + } + /** + * Lists the messages in the user's mailbox. (messages.listUsersMessages) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * + * @opt_param bool includeSpamTrash Include messages from SPAM and TRASH in the + * results. + * @opt_param string labelIds Only return messages with labels that match all of + * the specified label IDs. + * @opt_param string maxResults Maximum number of messages to return. + * @opt_param string pageToken Page token to retrieve a specific page of results + * in the list. + * @opt_param string q Only return messages matching the specified query. + * Supports the same query format as the Gmail search box. For example, + * "from:someuser@example.com rfc822msgid: is:unread". Parameter cannot be used + * when accessing the api using the gmail.metadata scope. + * @return Google_Service_Gmail_ListMessagesResponse + */ + public function listUsersMessages($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListMessagesResponse"); + } + /** + * Modifies the labels on the specified message. (messages.modify) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the message to modify. + * @param Google_Service_Gmail_ModifyMessageRequest $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Message + */ + public function modify($userId, $id, Google_Service_Gmail_ModifyMessageRequest $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('modify', array($params), "Google_Service_Gmail_Message"); + } + /** + * Sends the specified message to the recipients in the To, Cc, and Bcc headers. + * (messages.send) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_Message $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Message + */ + public function send($userId, Google_Service_Gmail_Message $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('send', array($params), "Google_Service_Gmail_Message"); + } + /** + * Moves the specified message to the trash. (messages.trash) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the message to Trash. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Message + */ + public function trash($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('trash', array($params), "Google_Service_Gmail_Message"); + } + /** + * Removes the specified message from the trash. (messages.untrash) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the message to remove from Trash. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Message + */ + public function untrash($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('untrash', array($params), "Google_Service_Gmail_Message"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersMessagesAttachments.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersMessagesAttachments.php new file mode 100644 index 0000000..6c3a5e4 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersMessagesAttachments.php @@ -0,0 +1,44 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $attachments = $gmailService->attachments; + * + */ +class Google_Service_Gmail_Resource_UsersMessagesAttachments extends Google_Service_Resource +{ + /** + * Gets the specified message attachment. (attachments.get) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $messageId The ID of the message containing the attachment. + * @param string $id The ID of the attachment. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_MessagePartBody + */ + public function get($userId, $messageId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'messageId' => $messageId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_MessagePartBody"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettings.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettings.php new file mode 100644 index 0000000..455d954 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettings.php @@ -0,0 +1,149 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $settings = $gmailService->settings; + * + */ +class Google_Service_Gmail_Resource_UsersSettings extends Google_Service_Resource +{ + /** + * Gets the auto-forwarding setting for the specified account. + * (settings.getAutoForwarding) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_AutoForwarding + */ + public function getAutoForwarding($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('getAutoForwarding', array($params), "Google_Service_Gmail_AutoForwarding"); + } + /** + * Gets IMAP settings. (settings.getImap) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ImapSettings + */ + public function getImap($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('getImap', array($params), "Google_Service_Gmail_ImapSettings"); + } + /** + * Gets POP settings. (settings.getPop) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_PopSettings + */ + public function getPop($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('getPop', array($params), "Google_Service_Gmail_PopSettings"); + } + /** + * Gets vacation responder settings. (settings.getVacation) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_VacationSettings + */ + public function getVacation($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('getVacation', array($params), "Google_Service_Gmail_VacationSettings"); + } + /** + * Updates the auto-forwarding setting for the specified account. A verified + * forwarding address must be specified when auto-forwarding is enabled. + * + * This method is only available to service account clients that have been + * delegated domain-wide authority. (settings.updateAutoForwarding) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_AutoForwarding $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_AutoForwarding + */ + public function updateAutoForwarding($userId, Google_Service_Gmail_AutoForwarding $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('updateAutoForwarding', array($params), "Google_Service_Gmail_AutoForwarding"); + } + /** + * Updates IMAP settings. (settings.updateImap) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_ImapSettings $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ImapSettings + */ + public function updateImap($userId, Google_Service_Gmail_ImapSettings $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('updateImap', array($params), "Google_Service_Gmail_ImapSettings"); + } + /** + * Updates POP settings. (settings.updatePop) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_PopSettings $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_PopSettings + */ + public function updatePop($userId, Google_Service_Gmail_PopSettings $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('updatePop', array($params), "Google_Service_Gmail_PopSettings"); + } + /** + * Updates vacation responder settings. (settings.updateVacation) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_VacationSettings $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_VacationSettings + */ + public function updateVacation($userId, Google_Service_Gmail_VacationSettings $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('updateVacation', array($params), "Google_Service_Gmail_VacationSettings"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsFilters.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsFilters.php new file mode 100644 index 0000000..d142bc2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsFilters.php @@ -0,0 +1,86 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $filters = $gmailService->filters; + * + */ +class Google_Service_Gmail_Resource_UsersSettingsFilters extends Google_Service_Resource +{ + /** + * Creates a filter. (filters.create) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_Filter $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Filter + */ + public function create($userId, Google_Service_Gmail_Filter $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('create', array($params), "Google_Service_Gmail_Filter"); + } + /** + * Deletes a filter. (filters.delete) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $id The ID of the filter to be deleted. + * @param array $optParams Optional parameters. + */ + public function delete($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('delete', array($params)); + } + /** + * Gets a filter. (filters.get) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $id The ID of the filter to be fetched. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Filter + */ + public function get($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_Filter"); + } + /** + * Lists the message filters of a Gmail user. (filters.listUsersSettingsFilters) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ListFiltersResponse + */ + public function listUsersSettingsFilters($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListFiltersResponse"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsForwardingAddresses.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsForwardingAddresses.php new file mode 100644 index 0000000..b0e2508 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsForwardingAddresses.php @@ -0,0 +1,97 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $forwardingAddresses = $gmailService->forwardingAddresses; + * + */ +class Google_Service_Gmail_Resource_UsersSettingsForwardingAddresses extends Google_Service_Resource +{ + /** + * Creates a forwarding address. If ownership verification is required, a + * message will be sent to the recipient and the resource's verification status + * will be set to pending; otherwise, the resource will be created with + * verification status set to accepted. + * + * This method is only available to service account clients that have been + * delegated domain-wide authority. (forwardingAddresses.create) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_ForwardingAddress $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ForwardingAddress + */ + public function create($userId, Google_Service_Gmail_ForwardingAddress $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('create', array($params), "Google_Service_Gmail_ForwardingAddress"); + } + /** + * Deletes the specified forwarding address and revokes any verification that + * may have been required. + * + * This method is only available to service account clients that have been + * delegated domain-wide authority. (forwardingAddresses.delete) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $forwardingEmail The forwarding address to be deleted. + * @param array $optParams Optional parameters. + */ + public function delete($userId, $forwardingEmail, $optParams = array()) + { + $params = array('userId' => $userId, 'forwardingEmail' => $forwardingEmail); + $params = array_merge($params, $optParams); + return $this->call('delete', array($params)); + } + /** + * Gets the specified forwarding address. (forwardingAddresses.get) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $forwardingEmail The forwarding address to be retrieved. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ForwardingAddress + */ + public function get($userId, $forwardingEmail, $optParams = array()) + { + $params = array('userId' => $userId, 'forwardingEmail' => $forwardingEmail); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_ForwardingAddress"); + } + /** + * Lists the forwarding addresses for the specified account. + * (forwardingAddresses.listUsersSettingsForwardingAddresses) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ListForwardingAddressesResponse + */ + public function listUsersSettingsForwardingAddresses($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListForwardingAddressesResponse"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsSendAs.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsSendAs.php new file mode 100644 index 0000000..f3c45cf --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsSendAs.php @@ -0,0 +1,162 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $sendAs = $gmailService->sendAs; + * + */ +class Google_Service_Gmail_Resource_UsersSettingsSendAs extends Google_Service_Resource +{ + /** + * Creates a custom "from" send-as alias. If an SMTP MSA is specified, Gmail + * will attempt to connect to the SMTP service to validate the configuration + * before creating the alias. If ownership verification is required for the + * alias, a message will be sent to the email address and the resource's + * verification status will be set to pending; otherwise, the resource will be + * created with verification status set to accepted. If a signature is provided, + * Gmail will sanitize the HTML before saving it with the alias. + * + * This method is only available to service account clients that have been + * delegated domain-wide authority. (sendAs.create) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param Google_Service_Gmail_SendAs $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_SendAs + */ + public function create($userId, Google_Service_Gmail_SendAs $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('create', array($params), "Google_Service_Gmail_SendAs"); + } + /** + * Deletes the specified send-as alias. Revokes any verification that may have + * been required for using it. + * + * This method is only available to service account clients that have been + * delegated domain-wide authority. (sendAs.delete) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The send-as alias to be deleted. + * @param array $optParams Optional parameters. + */ + public function delete($userId, $sendAsEmail, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail); + $params = array_merge($params, $optParams); + return $this->call('delete', array($params)); + } + /** + * Gets the specified send-as alias. Fails with an HTTP 404 error if the + * specified address is not a member of the collection. (sendAs.get) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The send-as alias to be retrieved. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_SendAs + */ + public function get($userId, $sendAsEmail, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_SendAs"); + } + /** + * Lists the send-as aliases for the specified account. The result includes the + * primary send-as address associated with the account as well as any custom + * "from" aliases. (sendAs.listUsersSettingsSendAs) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ListSendAsResponse + */ + public function listUsersSettingsSendAs($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListSendAsResponse"); + } + /** + * Updates a send-as alias. If a signature is provided, Gmail will sanitize the + * HTML before saving it with the alias. + * + * Addresses other than the primary address for the account can only be updated + * by service account clients that have been delegated domain-wide authority. + * This method supports patch semantics. (sendAs.patch) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The send-as alias to be updated. + * @param Google_Service_Gmail_SendAs $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_SendAs + */ + public function patch($userId, $sendAsEmail, Google_Service_Gmail_SendAs $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('patch', array($params), "Google_Service_Gmail_SendAs"); + } + /** + * Updates a send-as alias. If a signature is provided, Gmail will sanitize the + * HTML before saving it with the alias. + * + * Addresses other than the primary address for the account can only be updated + * by service account clients that have been delegated domain-wide authority. + * (sendAs.update) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The send-as alias to be updated. + * @param Google_Service_Gmail_SendAs $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_SendAs + */ + public function update($userId, $sendAsEmail, Google_Service_Gmail_SendAs $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('update', array($params), "Google_Service_Gmail_SendAs"); + } + /** + * Sends a verification email to the specified send-as alias address. The + * verification status must be pending. + * + * This method is only available to service account clients that have been + * delegated domain-wide authority. (sendAs.verify) + * + * @param string $userId User's email address. The special value "me" can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The send-as alias to be verified. + * @param array $optParams Optional parameters. + */ + public function verify($userId, $sendAsEmail, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail); + $params = array_merge($params, $optParams); + return $this->call('verify', array($params)); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsSendAsSmimeInfo.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsSendAsSmimeInfo.php new file mode 100644 index 0000000..ffb17fa --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersSettingsSendAsSmimeInfo.php @@ -0,0 +1,115 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $smimeInfo = $gmailService->smimeInfo; + * + */ +class Google_Service_Gmail_Resource_UsersSettingsSendAsSmimeInfo extends Google_Service_Resource +{ + /** + * Deletes the specified S/MIME config for the specified send-as alias. + * (smimeInfo.delete) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The email address that appears in the "From:" + * header for mail sent using this alias. + * @param string $id The immutable ID for the SmimeInfo. + * @param array $optParams Optional parameters. + */ + public function delete($userId, $sendAsEmail, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('delete', array($params)); + } + /** + * Gets the specified S/MIME config for the specified send-as alias. + * (smimeInfo.get) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The email address that appears in the "From:" + * header for mail sent using this alias. + * @param string $id The immutable ID for the SmimeInfo. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_SmimeInfo + */ + public function get($userId, $sendAsEmail, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_SmimeInfo"); + } + /** + * Insert (upload) the given S/MIME config for the specified send-as alias. Note + * that pkcs12 format is required for the key. (smimeInfo.insert) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The email address that appears in the "From:" + * header for mail sent using this alias. + * @param Google_Service_Gmail_SmimeInfo $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_SmimeInfo + */ + public function insert($userId, $sendAsEmail, Google_Service_Gmail_SmimeInfo $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('insert', array($params), "Google_Service_Gmail_SmimeInfo"); + } + /** + * Lists S/MIME configs for the specified send-as alias. + * (smimeInfo.listUsersSettingsSendAsSmimeInfo) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The email address that appears in the "From:" + * header for mail sent using this alias. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_ListSmimeInfoResponse + */ + public function listUsersSettingsSendAsSmimeInfo($userId, $sendAsEmail, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListSmimeInfoResponse"); + } + /** + * Sets the default S/MIME config for the specified send-as alias. + * (smimeInfo.setDefault) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $sendAsEmail The email address that appears in the "From:" + * header for mail sent using this alias. + * @param string $id The immutable ID for the SmimeInfo. + * @param array $optParams Optional parameters. + */ + public function setDefault($userId, $sendAsEmail, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'sendAsEmail' => $sendAsEmail, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('setDefault', array($params)); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersThreads.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersThreads.php new file mode 100644 index 0000000..b8909c4 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Resource/UsersThreads.php @@ -0,0 +1,135 @@ + + * $gmailService = new Google_Service_Gmail(...); + * $threads = $gmailService->threads; + * + */ +class Google_Service_Gmail_Resource_UsersThreads extends Google_Service_Resource +{ + /** + * Immediately and permanently deletes the specified thread. This operation + * cannot be undone. Prefer threads.trash instead. (threads.delete) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id ID of the Thread to delete. + * @param array $optParams Optional parameters. + */ + public function delete($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('delete', array($params)); + } + /** + * Gets the specified thread. (threads.get) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the thread to retrieve. + * @param array $optParams Optional parameters. + * + * @opt_param string format The format to return the messages in. + * @opt_param string metadataHeaders When given and format is METADATA, only + * include headers specified. + * @return Google_Service_Gmail_Thread + */ + public function get($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('get', array($params), "Google_Service_Gmail_Thread"); + } + /** + * Lists the threads in the user's mailbox. (threads.listUsersThreads) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param array $optParams Optional parameters. + * + * @opt_param bool includeSpamTrash Include threads from SPAM and TRASH in the + * results. + * @opt_param string labelIds Only return threads with labels that match all of + * the specified label IDs. + * @opt_param string maxResults Maximum number of threads to return. + * @opt_param string pageToken Page token to retrieve a specific page of results + * in the list. + * @opt_param string q Only return threads matching the specified query. + * Supports the same query format as the Gmail search box. For example, + * "from:someuser@example.com rfc822msgid: is:unread". Parameter cannot be used + * when accessing the api using the gmail.metadata scope. + * @return Google_Service_Gmail_ListThreadsResponse + */ + public function listUsersThreads($userId, $optParams = array()) + { + $params = array('userId' => $userId); + $params = array_merge($params, $optParams); + return $this->call('list', array($params), "Google_Service_Gmail_ListThreadsResponse"); + } + /** + * Modifies the labels applied to the thread. This applies to all messages in + * the thread. (threads.modify) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the thread to modify. + * @param Google_Service_Gmail_ModifyThreadRequest $postBody + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Thread + */ + public function modify($userId, $id, Google_Service_Gmail_ModifyThreadRequest $postBody, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id, 'postBody' => $postBody); + $params = array_merge($params, $optParams); + return $this->call('modify', array($params), "Google_Service_Gmail_Thread"); + } + /** + * Moves the specified thread to the trash. (threads.trash) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the thread to Trash. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Thread + */ + public function trash($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('trash', array($params), "Google_Service_Gmail_Thread"); + } + /** + * Removes the specified thread from the trash. (threads.untrash) + * + * @param string $userId The user's email address. The special value me can be + * used to indicate the authenticated user. + * @param string $id The ID of the thread to remove from Trash. + * @param array $optParams Optional parameters. + * @return Google_Service_Gmail_Thread + */ + public function untrash($userId, $id, $optParams = array()) + { + $params = array('userId' => $userId, 'id' => $id); + $params = array_merge($params, $optParams); + return $this->call('untrash', array($params), "Google_Service_Gmail_Thread"); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SendAs.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SendAs.php new file mode 100644 index 0000000..82f96cd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SendAs.php @@ -0,0 +1,109 @@ +displayName = $displayName; + } + public function getDisplayName() + { + return $this->displayName; + } + public function setIsDefault($isDefault) + { + $this->isDefault = $isDefault; + } + public function getIsDefault() + { + return $this->isDefault; + } + public function setIsPrimary($isPrimary) + { + $this->isPrimary = $isPrimary; + } + public function getIsPrimary() + { + return $this->isPrimary; + } + public function setReplyToAddress($replyToAddress) + { + $this->replyToAddress = $replyToAddress; + } + public function getReplyToAddress() + { + return $this->replyToAddress; + } + public function setSendAsEmail($sendAsEmail) + { + $this->sendAsEmail = $sendAsEmail; + } + public function getSendAsEmail() + { + return $this->sendAsEmail; + } + public function setSignature($signature) + { + $this->signature = $signature; + } + public function getSignature() + { + return $this->signature; + } + /** + * @param Google_Service_Gmail_SmtpMsa + */ + public function setSmtpMsa(Google_Service_Gmail_SmtpMsa $smtpMsa) + { + $this->smtpMsa = $smtpMsa; + } + /** + * @return Google_Service_Gmail_SmtpMsa + */ + public function getSmtpMsa() + { + return $this->smtpMsa; + } + public function setTreatAsAlias($treatAsAlias) + { + $this->treatAsAlias = $treatAsAlias; + } + public function getTreatAsAlias() + { + return $this->treatAsAlias; + } + public function setVerificationStatus($verificationStatus) + { + $this->verificationStatus = $verificationStatus; + } + public function getVerificationStatus() + { + return $this->verificationStatus; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SmimeInfo.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SmimeInfo.php new file mode 100644 index 0000000..0e21802 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SmimeInfo.php @@ -0,0 +1,84 @@ +encryptedKeyPassword = $encryptedKeyPassword; + } + public function getEncryptedKeyPassword() + { + return $this->encryptedKeyPassword; + } + public function setExpiration($expiration) + { + $this->expiration = $expiration; + } + public function getExpiration() + { + return $this->expiration; + } + public function setId($id) + { + $this->id = $id; + } + public function getId() + { + return $this->id; + } + public function setIsDefault($isDefault) + { + $this->isDefault = $isDefault; + } + public function getIsDefault() + { + return $this->isDefault; + } + public function setIssuerCn($issuerCn) + { + $this->issuerCn = $issuerCn; + } + public function getIssuerCn() + { + return $this->issuerCn; + } + public function setPem($pem) + { + $this->pem = $pem; + } + public function getPem() + { + return $this->pem; + } + public function setPkcs12($pkcs12) + { + $this->pkcs12 = $pkcs12; + } + public function getPkcs12() + { + return $this->pkcs12; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SmtpMsa.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SmtpMsa.php new file mode 100644 index 0000000..c019138 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/SmtpMsa.php @@ -0,0 +1,66 @@ +host = $host; + } + public function getHost() + { + return $this->host; + } + public function setPassword($password) + { + $this->password = $password; + } + public function getPassword() + { + return $this->password; + } + public function setPort($port) + { + $this->port = $port; + } + public function getPort() + { + return $this->port; + } + public function setSecurityMode($securityMode) + { + $this->securityMode = $securityMode; + } + public function getSecurityMode() + { + return $this->securityMode; + } + public function setUsername($username) + { + $this->username = $username; + } + public function getUsername() + { + return $this->username; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Thread.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Thread.php new file mode 100644 index 0000000..74a0f0a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/Thread.php @@ -0,0 +1,65 @@ +historyId = $historyId; + } + public function getHistoryId() + { + return $this->historyId; + } + public function setId($id) + { + $this->id = $id; + } + public function getId() + { + return $this->id; + } + /** + * @param Google_Service_Gmail_Message + */ + public function setMessages($messages) + { + $this->messages = $messages; + } + /** + * @return Google_Service_Gmail_Message + */ + public function getMessages() + { + return $this->messages; + } + public function setSnippet($snippet) + { + $this->snippet = $snippet; + } + public function getSnippet() + { + return $this->snippet; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/VacationSettings.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/VacationSettings.php new file mode 100644 index 0000000..1e990db --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/VacationSettings.php @@ -0,0 +1,93 @@ +enableAutoReply = $enableAutoReply; + } + public function getEnableAutoReply() + { + return $this->enableAutoReply; + } + public function setEndTime($endTime) + { + $this->endTime = $endTime; + } + public function getEndTime() + { + return $this->endTime; + } + public function setResponseBodyHtml($responseBodyHtml) + { + $this->responseBodyHtml = $responseBodyHtml; + } + public function getResponseBodyHtml() + { + return $this->responseBodyHtml; + } + public function setResponseBodyPlainText($responseBodyPlainText) + { + $this->responseBodyPlainText = $responseBodyPlainText; + } + public function getResponseBodyPlainText() + { + return $this->responseBodyPlainText; + } + public function setResponseSubject($responseSubject) + { + $this->responseSubject = $responseSubject; + } + public function getResponseSubject() + { + return $this->responseSubject; + } + public function setRestrictToContacts($restrictToContacts) + { + $this->restrictToContacts = $restrictToContacts; + } + public function getRestrictToContacts() + { + return $this->restrictToContacts; + } + public function setRestrictToDomain($restrictToDomain) + { + $this->restrictToDomain = $restrictToDomain; + } + public function getRestrictToDomain() + { + return $this->restrictToDomain; + } + public function setStartTime($startTime) + { + $this->startTime = $startTime; + } + public function getStartTime() + { + return $this->startTime; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/WatchRequest.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/WatchRequest.php new file mode 100644 index 0000000..5fa9144 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/WatchRequest.php @@ -0,0 +1,49 @@ +labelFilterAction = $labelFilterAction; + } + public function getLabelFilterAction() + { + return $this->labelFilterAction; + } + public function setLabelIds($labelIds) + { + $this->labelIds = $labelIds; + } + public function getLabelIds() + { + return $this->labelIds; + } + public function setTopicName($topicName) + { + $this->topicName = $topicName; + } + public function getTopicName() + { + return $this->topicName; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/WatchResponse.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/WatchResponse.php new file mode 100644 index 0000000..d7dc3bf --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient-services/src/Google/Service/Gmail/WatchResponse.php @@ -0,0 +1,39 @@ +expiration = $expiration; + } + public function getExpiration() + { + return $this->expiration; + } + public function setHistoryId($historyId) + { + $this->historyId = $historyId; + } + public function getHistoryId() + { + return $this->historyId; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/.gitattributes b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/.gitattributes new file mode 100644 index 0000000..d4e9c25 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/.gitattributes @@ -0,0 +1,9 @@ +/.github export-ignore +/.gitignore export-ignore +/.travis.yml export-ignore +/CONTRIBUTING.md export-ignore +/examples export-ignore +/phpunit.xml.dist export-ignore +/style export-ignore +/tests export-ignore +/UPGRADING.md export-ignore diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/LICENSE new file mode 100644 index 0000000..a148ba5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/LICENSE @@ -0,0 +1,203 @@ +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, +and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by +the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all +other entities that control, are controlled by, or are under common +control with that entity. For the purposes of this definition, +"control" means (i) the power, direct or indirect, to cause the +direction or management of such entity, whether by contract or +otherwise, or (ii) ownership of fifty percent (50%) or more of the +outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity +exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, +including but not limited to software source code, documentation +source, and configuration files. + +"Object" form shall mean any form resulting from mechanical +transformation or translation of a Source form, including but +not limited to compiled object code, generated documentation, +and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or +Object form, made available under the License, as indicated by a +copyright notice that is included in or attached to the work +(an example is provided in the Appendix below). + +"Derivative Works" shall mean any work, whether in Source or Object +form, that is based on (or derived from) the Work and for which the +editorial revisions, annotations, elaborations, or other modifications +represent, as a whole, an original work of authorship. For the purposes +of this License, Derivative Works shall not include works that remain +separable from, or merely link (or bind by name) to the interfaces of, +the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including +the original version of the Work and any modifications or additions +to that Work or Derivative Works thereof, that is intentionally +submitted to Licensor for inclusion in the Work by the copyright owner +or by an individual or Legal Entity authorized to submit on behalf of +the copyright owner. For the purposes of this definition, "submitted" +means any form of electronic, verbal, or written communication sent +to the Licensor or its representatives, including but not limited to +communication on electronic mailing lists, source code control systems, +and issue tracking systems that are managed by, or on behalf of, the +Licensor for the purpose of discussing and improving the Work, but +excluding communication that is conspicuously marked or otherwise +designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity +on behalf of whom a Contribution has been received by Licensor and +subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +copyright license to reproduce, prepare Derivative Works of, +publicly display, publicly perform, sublicense, and distribute the +Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +(except as stated in this section) patent license to make, have made, +use, offer to sell, sell, import, and otherwise transfer the Work, +where such license applies only to those patent claims licensable +by such Contributor that are necessarily infringed by their +Contribution(s) alone or by combination of their Contribution(s) +with the Work to which such Contribution(s) was submitted. If You +institute patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Work +or a Contribution incorporated within the Work constitutes direct +or contributory patent infringement, then any patent licenses +granted to You under this License for that Work shall terminate +as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the +Work or Derivative Works thereof in any medium, with or without +modifications, and in Source or Object form, provided that You +meet the following conditions: + +(a) You must give any other recipients of the Work or +Derivative Works a copy of this License; and + +(b) You must cause any modified files to carry prominent notices +stating that You changed the files; and + +(c) You must retain, in the Source form of any Derivative Works +that You distribute, all copyright, patent, trademark, and +attribution notices from the Source form of the Work, +excluding those notices that do not pertain to any part of +the Derivative Works; and + +(d) If the Work includes a "NOTICE" text file as part of its +distribution, then any Derivative Works that You distribute must +include a readable copy of the attribution notices contained +within such NOTICE file, excluding those notices that do not +pertain to any part of the Derivative Works, in at least one +of the following places: within a NOTICE text file distributed +as part of the Derivative Works; within the Source form or +documentation, if provided along with the Derivative Works; or, +within a display generated by the Derivative Works, if and +wherever such third-party notices normally appear. The contents +of the NOTICE file are for informational purposes only and +do not modify the License. You may add Your own attribution +notices within Derivative Works that You distribute, alongside +or as an addendum to the NOTICE text from the Work, provided +that such additional attribution notices cannot be construed +as modifying the License. + +You may add Your own copyright statement to Your modifications and +may provide additional or different license terms and conditions +for use, reproduction, or distribution of Your modifications, or +for any such Derivative Works as a whole, provided Your use, +reproduction, and distribution of the Work otherwise complies with +the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, +any Contribution intentionally submitted for inclusion in the Work +by You to the Licensor shall be under the terms and conditions of +this License, without any additional terms or conditions. +Notwithstanding the above, nothing herein shall supersede or modify +the terms of any separate license agreement you may have executed +with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade +names, trademarks, service marks, or product names of the Licensor, +except as required for reasonable and customary use in describing the +origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or +agreed to in writing, Licensor provides the Work (and each +Contributor provides its Contributions) on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or +implied, including, without limitation, any warranties or conditions +of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A +PARTICULAR PURPOSE. You are solely responsible for determining the +appropriateness of using or redistributing the Work and assume any +risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, +whether in tort (including negligence), contract, or otherwise, +unless required by applicable law (such as deliberate and grossly +negligent acts) or agreed to in writing, shall any Contributor be +liable to You for damages, including any direct, indirect, special, +incidental, or consequential damages of any character arising as a +result of this License or out of the use or inability to use the +Work (including but not limited to damages for loss of goodwill, +work stoppage, computer failure or malfunction, or any and all +other commercial damages or losses), even if such Contributor +has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing +the Work or Derivative Works thereof, You may choose to offer, +and charge a fee for, acceptance of support, warranty, indemnity, +or other liability obligations and/or rights consistent with this +License. However, in accepting such obligations, You may act only +on Your own behalf and on Your sole responsibility, not on behalf +of any other Contributor, and only if You agree to indemnify, +defend, and hold each Contributor harmless for any liability +incurred by, or claims asserted against, such Contributor by reason +of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. + +To apply the Apache License to your work, attach the following +boilerplate notice, with the fields enclosed by brackets "[]" +replaced with your own identifying information. (Don't include +the brackets!) The text should be enclosed in the appropriate +comment syntax for the file format. We also recommend that a +file or class name and description of purpose be included on the +same "printed page" as the copyright notice for easier +identification within third-party archives. + +Copyright [yyyy] [name of copyright owner] + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + + diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/README.md b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/README.md new file mode 100644 index 0000000..03cea13 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/README.md @@ -0,0 +1,368 @@ +[![Build Status](https://travis-ci.org/google/google-api-php-client.svg?branch=master)](https://travis-ci.org/google/google-api-php-client) + +# Google APIs Client Library for PHP # + +## Library maintenance +This client library is supported but in maintenance mode only. We are fixing necessary bugs and adding essential features to ensure this library continues to meet your needs for accessing Google APIs. Non-critical issues will be closed. Any issue may be reopened if it is causing ongoing problems. + +## Description ## +The Google API Client Library enables you to work with Google APIs such as Google+, Drive, or YouTube on your server. + +## Beta ## +This library is in Beta. We're comfortable enough with the stability and features of the library that we want you to build real production applications on it. We will make an effort to support the public and protected surface of the library and maintain backwards compatibility in the future. While we are still in Beta, we reserve the right to make incompatible changes. + +## Requirements ## +* [PHP 5.4.0 or higher](http://www.php.net/) + +## Google Cloud Platform APIs +If you're looking to call the **Google Cloud Platform** APIs, you will want to use the [Google Cloud PHP](https://github.com/googlecloudplatform/google-cloud-php) library instead of this one. + +## Developer Documentation ## +http://developers.google.com/api-client-library/php + +## Installation ## + +You can use **Composer** or simply **Download the Release** + +### Composer + +The preferred method is via [composer](https://getcomposer.org). Follow the +[installation instructions](https://getcomposer.org/doc/00-intro.md) if you do not already have +composer installed. + +Once composer is installed, execute the following command in your project root to install this library: + +```sh +composer require google/apiclient:^2.0 +``` + +Finally, be sure to include the autoloader: + +```php +require_once '/path/to/your-project/vendor/autoload.php'; +``` + +### Download the Release + +If you abhor using composer, you can download the package in its entirety. The [Releases](https://github.com/google/google-api-php-client/releases) page lists all stable versions. Download any file +with the name `google-api-php-client-[RELEASE_NAME].zip` for a package including this library and its dependencies. + +Uncompress the zip file you download, and include the autoloader in your project: + +```php +require_once '/path/to/google-api-php-client/vendor/autoload.php'; +``` + +For additional installation and setup instructions, see [the documentation](https://developers.google.com/api-client-library/php/start/installation). + +## Examples ## +See the [`examples/`](examples) directory for examples of the key client features. You can +view them in your browser by running the php built-in web server. + +``` +$ php -S localhost:8000 -t examples/ +``` + +And then browsing to the host and port you specified +(in the above example, `http://localhost:8000`). + +### Basic Example ### + +```php +// include your composer dependencies +require_once 'vendor/autoload.php'; + +$client = new Google_Client(); +$client->setApplicationName("Client_Library_Examples"); +$client->setDeveloperKey("YOUR_APP_KEY"); + +$service = new Google_Service_Books($client); +$optParams = array('filter' => 'free-ebooks'); +$results = $service->volumes->listVolumes('Henry David Thoreau', $optParams); + +foreach ($results as $item) { + echo $item['volumeInfo']['title'], "
    \n"; +} +``` + +### Authentication with OAuth ### + +> An example of this can be seen in [`examples/simple-file-upload.php`](examples/simple-file-upload.php). + +1. Follow the instructions to [Create Web Application Credentials](https://developers.google.com/api-client-library/php/auth/web-app#creatingcred) +1. Download the JSON credentials +1. Set the path to these credentials using `Google_Client::setAuthConfig`: + + ```php + $client = new Google_Client(); + $client->setAuthConfig('/path/to/client_credentials.json'); + ``` + +1. Set the scopes required for the API you are going to call + + ```php + $client->addScope(Google_Service_Drive::DRIVE); + ``` + +1. Set your application's redirect URI + + ```php + // Your redirect URI can be any registered URI, but in this example + // we redirect back to this same page + $redirect_uri = 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['PHP_SELF']; + $client->setRedirectUri($redirect_uri); + ``` + +1. In the script handling the redirect URI, exchange the authorization code for an access token: + + ```php + if (isset($_GET['code'])) { + $token = $client->fetchAccessTokenWithAuthCode($_GET['code']); + } + ``` + +### Authentication with Service Accounts ### + +> An example of this can be seen in [`examples/service-account.php`](examples/service-account.php). + +1. Follow the instructions to [Create a Service Account](https://developers.google.com/api-client-library/php/auth/service-accounts#creatinganaccount) +1. Download the JSON credentials +1. Set the path to these credentials using the `GOOGLE_APPLICATION_CREDENTIALS` environment variable: + + ```php + putenv('GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json'); + ``` + +1. Tell the Google client to use your service account credentials to authenticate: + + ```php + $client = new Google_Client(); + $client->useApplicationDefaultCredentials(); + ``` + +1. Set the scopes required for the API you are going to call + + ```php + $client->addScope(Google_Service_Drive::DRIVE); + ``` + +1. If you have delegated domain-wide access to the service account and you want to impersonate a user account, specify the email address of the user account using the method setSubject: + + ```php + $client->setSubject($user_to_impersonate); + ``` + +### Making Requests ### + +The classes used to call the API in [google-api-php-client-services](https://github.com/Google/google-api-php-client-services) are autogenerated. They map directly to the JSON requests and responses found in the [APIs Explorer](https://developers.google.com/apis-explorer/#p/). + +A JSON request to the [Datastore API](https://developers.google.com/apis-explorer/#p/datastore/v1beta3/datastore.projects.runQuery) would look like this: + +```json +POST https://datastore.googleapis.com/v1beta3/projects/YOUR_PROJECT_ID:runQuery?key=YOUR_API_KEY + +{ + "query": { + "kind": [{ + "name": "Book" + }], + "order": [{ + "property": { + "name": "title" + }, + "direction": "descending" + }], + "limit": 10 + } +} +``` + +Using this library, the same call would look something like this: + +```php +// create the datastore service class +$datastore = new Google_Service_Datastore($client); + +// build the query - this maps directly to the JSON +$query = new Google_Service_Datastore_Query([ + 'kind' => [ + [ + 'name' => 'Book', + ], + ], + 'order' => [ + 'property' => [ + 'name' => 'title', + ], + 'direction' => 'descending', + ], + 'limit' => 10, +]); + +// build the request and response +$request = new Google_Service_Datastore_RunQueryRequest(['query' => $query]); +$response = $datastore->projects->runQuery('YOUR_DATASET_ID', $request); +``` + +However, as each property of the JSON API has a corresponding generated class, the above code could also be written like this: + +```php +// create the datastore service class +$datastore = new Google_Service_Datastore($client); + +// build the query +$request = new Google_Service_Datastore_RunQueryRequest(); +$query = new Google_Service_Datastore_Query(); +// - set the order +$order = new Google_Service_Datastore_PropertyOrder(); +$order->setDirection('descending'); +$property = new Google_Service_Datastore_PropertyReference(); +$property->setName('title'); +$order->setProperty($property); +$query->setOrder([$order]); +// - set the kinds +$kind = new Google_Service_Datastore_KindExpression(); +$kind->setName('Book'); +$query->setKinds([$kind]); +// - set the limit +$query->setLimit(10); + +// add the query to the request and make the request +$request->setQuery($query); +$response = $datastore->projects->runQuery('YOUR_DATASET_ID', $request); +``` + +The method used is a matter of preference, but *it will be very difficult to use this library without first understanding the JSON syntax for the API*, so it is recommended to look at the [APIs Explorer](https://developers.google.com/apis-explorer/#p/) before using any of the services here. + +### Making HTTP Requests Directly ### + +If Google Authentication is desired for external applications, or a Google API is not available yet in this library, HTTP requests can be made directly. + +The `authorize` method returns an authorized [Guzzle Client](http://docs.guzzlephp.org/), so any request made using the client will contain the corresponding authorization. + +```php +// create the Google client +$client = new Google_Client(); + +/** + * Set your method for authentication. Depending on the API, This could be + * directly with an access token, API key, or (recommended) using + * Application Default Credentials. + */ +$client->useApplicationDefaultCredentials(); +$client->addScope(Google_Service_Plus::PLUS_ME); + +// returns a Guzzle HTTP Client +$httpClient = $client->authorize(); + +// make an HTTP request +$response = $httpClient->get('https://www.googleapis.com/plus/v1/people/me'); +``` + +### Caching ### + +It is recommended to use another caching library to improve performance. This can be done by passing a [PSR-6](http://www.php-fig.org/psr/psr-6/) compatible library to the client: + +```php +$cache = new Stash\Pool(new Stash\Driver\FileSystem); +$client->setCache($cache); +``` + +In this example we use [StashPHP](http://www.stashphp.com/). Add this to your project with composer: + +``` +composer require tedivm/stash +``` + +### Updating Tokens ### + +When using [Refresh Tokens](https://developers.google.com/identity/protocols/OAuth2InstalledApp#refresh) or [Service Account Credentials](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#overview), it may be useful to perform some action when a new access token is granted. To do this, pass a callable to the `setTokenCallback` method on the client: + +```php +$logger = new Monolog\Logger; +$tokenCallback = function ($cacheKey, $accessToken) use ($logger) { + $logger->debug(sprintf('new access token received at cache key %s', $cacheKey)); +}; +$client->setTokenCallback($tokenCallback); +``` + +### Debugging Your HTTP Request using Charles ### + +It is often very useful to debug your API calls by viewing the raw HTTP request. This library supports the use of [Charles Web Proxy](https://www.charlesproxy.com/documentation/getting-started/). Download and run Charles, and then capture all HTTP traffic through Charles with the following code: + +```php +// FOR DEBUGGING ONLY +$httpClient = new GuzzleHttp\Client([ + 'proxy' => 'localhost:8888', // by default, Charles runs on localhost port 8888 + 'verify' => false, // otherwise HTTPS requests will fail. +]); + +$client = new Google_Client(); +$client->setHttpClient($httpClient); +``` + +Now all calls made by this library will appear in the Charles UI. + +One additional step is required in Charles to view SSL requests. Go to **Charles > Proxy > SSL Proxying Settings** and add the domain you'd like captured. In the case of the Google APIs, this is usually `*.googleapis.com`. + +### Service Specific Examples ### + +YouTube: https://github.com/youtube/api-samples/tree/master/php + +## How Do I Contribute? ## + +Please see the [contributing](CONTRIBUTING.md) page for more information. In particular, we love pull requests - but please make sure to sign the [contributor license agreement](https://developers.google.com/api-client-library/php/contribute). + +## Frequently Asked Questions ## + +### What do I do if something isn't working? ### + +For support with the library the best place to ask is via the google-api-php-client tag on StackOverflow: http://stackoverflow.com/questions/tagged/google-api-php-client + +If there is a specific bug with the library, please [file a issue](https://github.com/google/google-api-php-client/issues) in the Github issues tracker, including an example of the failing code and any specific errors retrieved. Feature requests can also be filed, as long as they are core library requests, and not-API specific: for those, refer to the documentation for the individual APIs for the best place to file requests. Please try to provide a clear statement of the problem that the feature would address. + +### I want an example of X! ### + +If X is a feature of the library, file away! If X is an example of using a specific service, the best place to go is to the teams for those specific APIs - our preference is to link to their examples rather than add them to the library, as they can then pin to specific versions of the library. If you have any examples for other APIs, let us know and we will happily add a link to the README above! + +### Why do you still support 5.2? ### + +When we started working on the 1.0.0 branch we knew there were several fundamental issues to fix with the 0.6 releases of the library. At that time we looked at the usage of the library, and other related projects, and determined that there was still a large and active base of PHP 5.2 installs. You can see this in statistics such as the PHP versions chart in the WordPress stats: http://wordpress.org/about/stats/. We will keep looking at the types of usage we see, and try to take advantage of newer PHP features where possible. + +### Why does Google_..._Service have weird names? ### + +The _Service classes are generally automatically generated from the API discovery documents: https://developers.google.com/discovery/. Sometimes new features are added to APIs with unusual names, which can cause some unexpected or non-standard style naming in the PHP classes. + +### How do I deal with non-JSON response types? ### + +Some services return XML or similar by default, rather than JSON, which is what the library supports. You can request a JSON response by adding an 'alt' argument to optional params that is normally the last argument to a method call: + +``` +$opt_params = array( + 'alt' => "json" +); +``` + +### How do I set a field to null? ### + +The library strips out nulls from the objects sent to the Google APIs as its the default value of all of the uninitialized properties. To work around this, set the field you want to null to `Google_Model::NULL_VALUE`. This is a placeholder that will be replaced with a true null when sent over the wire. + +## Code Quality ## + +Run the PHPUnit tests with PHPUnit. You can configure an API key and token in BaseTest.php to run all calls, but this will require some setup on the Google Developer Console. + + phpunit tests/ + +### Coding Style + +To check for coding style violations, run + +``` +vendor/bin/phpcs src --standard=style/ruleset.xml -np +``` + +To automatically fix (fixable) coding style violations, run + +``` +vendor/bin/phpcbf src --standard=style/ruleset.xml +``` diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/composer.json b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/composer.json new file mode 100644 index 0000000..55129fd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/composer.json @@ -0,0 +1,41 @@ +{ + "name": "google/apiclient", + "type": "library", + "description": "Client library for Google APIs", + "keywords": ["google"], + "homepage": "http://developers.google.com/api-client-library/php", + "license": "Apache-2.0", + "require": { + "php": ">=5.4", + "google/auth": "^1.0", + "google/apiclient-services": "~0.13", + "firebase/php-jwt": "~2.0|~3.0|~4.0|~5.0", + "monolog/monolog": "^1.17", + "phpseclib/phpseclib": "~0.3.10|~2.0", + "guzzlehttp/guzzle": "~5.3.1|~6.0", + "guzzlehttp/psr7": "^1.2" + }, + "require-dev": { + "phpunit/phpunit": "~4", + "squizlabs/php_codesniffer": "~2.3", + "symfony/dom-crawler": "~2.1", + "symfony/css-selector": "~2.1", + "cache/filesystem-adapter": "^0.3.2" + }, + "suggest": { + "cache/filesystem-adapter": "For caching certs and tokens (using Google_Client::setCache)" + }, + "autoload": { + "psr-0": { + "Google_": "src/" + }, + "classmap": [ + "src/Google/Service/" + ] + }, + "extra": { + "branch-alias": { + "dev-master": "2.x-dev" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AccessToken/Revoke.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AccessToken/Revoke.php new file mode 100644 index 0000000..29eb3fb --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AccessToken/Revoke.php @@ -0,0 +1,78 @@ +http = $http; + } + + /** + * Revoke an OAuth2 access token or refresh token. This method will revoke the current access + * token, if a token isn't provided. + * + * @param string|array $token The token (access token or a refresh token) that should be revoked. + * @return boolean Returns True if the revocation was successful, otherwise False. + */ + public function revokeToken($token) + { + if (is_array($token)) { + if (isset($token['refresh_token'])) { + $token = $token['refresh_token']; + } else { + $token = $token['access_token']; + } + } + + $body = Psr7\stream_for(http_build_query(array('token' => $token))); + $request = new Request( + 'POST', + Google_Client::OAUTH2_REVOKE_URI, + [ + 'Cache-Control' => 'no-store', + 'Content-Type' => 'application/x-www-form-urlencoded', + ], + $body + ); + + $httpHandler = HttpHandlerFactory::build($this->http); + + $response = $httpHandler($request); + + return $response->getStatusCode() == 200; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AccessToken/Verify.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AccessToken/Verify.php new file mode 100644 index 0000000..33f1179 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AccessToken/Verify.php @@ -0,0 +1,272 @@ +http = $http; + $this->cache = $cache; + $this->jwt = $jwt ?: $this->getJwtService(); + } + + /** + * Verifies an id token and returns the authenticated apiLoginTicket. + * Throws an exception if the id token is not valid. + * The audience parameter can be used to control which id tokens are + * accepted. By default, the id token must have been issued to this OAuth2 client. + * + * @param $audience + * @return array the token payload, if successful + */ + public function verifyIdToken($idToken, $audience = null) + { + if (empty($idToken)) { + throw new LogicException('id_token cannot be null'); + } + + // set phpseclib constants if applicable + $this->setPhpsecConstants(); + + // Check signature + $certs = $this->getFederatedSignOnCerts(); + foreach ($certs as $cert) { + $bigIntClass = $this->getBigIntClass(); + $rsaClass = $this->getRsaClass(); + $modulus = new $bigIntClass($this->jwt->urlsafeB64Decode($cert['n']), 256); + $exponent = new $bigIntClass($this->jwt->urlsafeB64Decode($cert['e']), 256); + + $rsa = new $rsaClass(); + $rsa->loadKey(array('n' => $modulus, 'e' => $exponent)); + + try { + $payload = $this->jwt->decode( + $idToken, + $rsa->getPublicKey(), + array('RS256') + ); + + if (property_exists($payload, 'aud')) { + if ($audience && $payload->aud != $audience) { + return false; + } + } + + // support HTTP and HTTPS issuers + // @see https://developers.google.com/identity/sign-in/web/backend-auth + $issuers = array(self::OAUTH2_ISSUER, self::OAUTH2_ISSUER_HTTPS); + if (!isset($payload->iss) || !in_array($payload->iss, $issuers)) { + return false; + } + + return (array) $payload; + } catch (ExpiredException $e) { + return false; + } catch (ExpiredExceptionV3 $e) { + return false; + } catch (SignatureInvalidException $e) { + // continue + } catch (DomainException $e) { + // continue + } + } + + return false; + } + + private function getCache() + { + return $this->cache; + } + + /** + * Retrieve and cache a certificates file. + * + * @param $url string location + * @throws Google_Exception + * @return array certificates + */ + private function retrieveCertsFromLocation($url) + { + // If we're retrieving a local file, just grab it. + if (0 !== strpos($url, 'http')) { + if (!$file = file_get_contents($url)) { + throw new Google_Exception( + "Failed to retrieve verification certificates: '" . + $url . "'." + ); + } + + return json_decode($file, true); + } + + $response = $this->http->get($url); + + if ($response->getStatusCode() == 200) { + return json_decode((string) $response->getBody(), true); + } + throw new Google_Exception( + sprintf( + 'Failed to retrieve verification certificates: "%s".', + $response->getBody()->getContents() + ), + $response->getStatusCode() + ); + } + + // Gets federated sign-on certificates to use for verifying identity tokens. + // Returns certs as array structure, where keys are key ids, and values + // are PEM encoded certificates. + private function getFederatedSignOnCerts() + { + $certs = null; + if ($cache = $this->getCache()) { + $cacheItem = $cache->getItem('federated_signon_certs_v3', 3600); + $certs = $cacheItem->get(); + } + + + if (!$certs) { + $certs = $this->retrieveCertsFromLocation( + self::FEDERATED_SIGNON_CERT_URL + ); + + if ($cache) { + $cacheItem->set($certs); + $cache->save($cacheItem); + } + } + + if (!isset($certs['keys'])) { + throw new InvalidArgumentException( + 'federated sign-on certs expects "keys" to be set' + ); + } + + return $certs['keys']; + } + + private function getJwtService() + { + $jwtClass = 'JWT'; + if (class_exists('\Firebase\JWT\JWT')) { + $jwtClass = 'Firebase\JWT\JWT'; + } + + if (property_exists($jwtClass, 'leeway')) { + // adds 1 second to JWT leeway + // @see https://github.com/google/google-api-php-client/issues/827 + $jwtClass::$leeway = 1; + } + + return new $jwtClass; + } + + private function getRsaClass() + { + if (class_exists('phpseclib\Crypt\RSA')) { + return 'phpseclib\Crypt\RSA'; + } + + return 'Crypt_RSA'; + } + + private function getBigIntClass() + { + if (class_exists('phpseclib\Math\BigInteger')) { + return 'phpseclib\Math\BigInteger'; + } + + return 'Math_BigInteger'; + } + + private function getOpenSslConstant() + { + if (class_exists('phpseclib\Crypt\RSA')) { + return 'phpseclib\Crypt\RSA::MODE_OPENSSL'; + } + + if (class_exists('Crypt_RSA')) { + return 'CRYPT_RSA_MODE_OPENSSL'; + } + + throw new \Exception('Cannot find RSA class'); + } + + /** + * phpseclib calls "phpinfo" by default, which requires special + * whitelisting in the AppEngine VM environment. This function + * sets constants to bypass the need for phpseclib to check phpinfo + * + * @see phpseclib/Math/BigInteger + * @see https://github.com/GoogleCloudPlatform/getting-started-php/issues/85 + */ + private function setPhpsecConstants() + { + if (filter_var(getenv('GAE_VM'), FILTER_VALIDATE_BOOLEAN)) { + if (!defined('MATH_BIGINTEGER_OPENSSL_ENABLED')) { + define('MATH_BIGINTEGER_OPENSSL_ENABLED', true); + } + if (!defined('CRYPT_RSA_MODE')) { + define('CRYPT_RSA_MODE', constant($this->getOpenSslConstant())); + } + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/AuthHandlerFactory.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/AuthHandlerFactory.php new file mode 100644 index 0000000..f1a3229 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/AuthHandlerFactory.php @@ -0,0 +1,42 @@ +cache = $cache; + $this->cacheConfig = $cacheConfig; + } + + public function attachCredentials( + ClientInterface $http, + CredentialsLoader $credentials, + callable $tokenCallback = null + ) { + // use the provided cache + if ($this->cache) { + $credentials = new FetchAuthTokenCache( + $credentials, + $this->cacheConfig, + $this->cache + ); + } + // if we end up needing to make an HTTP request to retrieve credentials, we + // can use our existing one, but we need to throw exceptions so the error + // bubbles up. + $authHttp = $this->createAuthHttp($http); + $authHttpHandler = HttpHandlerFactory::build($authHttp); + $subscriber = new AuthTokenSubscriber( + $credentials, + $authHttpHandler, + $tokenCallback + ); + + $http->setDefaultOption('auth', 'google_auth'); + $http->getEmitter()->attach($subscriber); + + return $http; + } + + public function attachToken(ClientInterface $http, array $token, array $scopes) + { + $tokenFunc = function ($scopes) use ($token) { + return $token['access_token']; + }; + + $subscriber = new ScopedAccessTokenSubscriber( + $tokenFunc, + $scopes, + $this->cacheConfig, + $this->cache + ); + + $http->setDefaultOption('auth', 'scoped'); + $http->getEmitter()->attach($subscriber); + + return $http; + } + + public function attachKey(ClientInterface $http, $key) + { + $subscriber = new SimpleSubscriber(['key' => $key]); + + $http->setDefaultOption('auth', 'simple'); + $http->getEmitter()->attach($subscriber); + + return $http; + } + + private function createAuthHttp(ClientInterface $http) + { + return new Client( + [ + 'base_url' => $http->getBaseUrl(), + 'defaults' => [ + 'exceptions' => true, + 'verify' => $http->getDefaultOption('verify'), + 'proxy' => $http->getDefaultOption('proxy'), + ] + ] + ); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/Guzzle6AuthHandler.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/Guzzle6AuthHandler.php new file mode 100644 index 0000000..fcdfb3b --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/AuthHandler/Guzzle6AuthHandler.php @@ -0,0 +1,106 @@ +cache = $cache; + $this->cacheConfig = $cacheConfig; + } + + public function attachCredentials( + ClientInterface $http, + CredentialsLoader $credentials, + callable $tokenCallback = null + ) { + // use the provided cache + if ($this->cache) { + $credentials = new FetchAuthTokenCache( + $credentials, + $this->cacheConfig, + $this->cache + ); + } + // if we end up needing to make an HTTP request to retrieve credentials, we + // can use our existing one, but we need to throw exceptions so the error + // bubbles up. + $authHttp = $this->createAuthHttp($http); + $authHttpHandler = HttpHandlerFactory::build($authHttp); + $middleware = new AuthTokenMiddleware( + $credentials, + $authHttpHandler, + $tokenCallback + ); + + $config = $http->getConfig(); + $config['handler']->remove('google_auth'); + $config['handler']->push($middleware, 'google_auth'); + $config['auth'] = 'google_auth'; + $http = new Client($config); + + return $http; + } + + public function attachToken(ClientInterface $http, array $token, array $scopes) + { + $tokenFunc = function ($scopes) use ($token) { + return $token['access_token']; + }; + + $middleware = new ScopedAccessTokenMiddleware( + $tokenFunc, + $scopes, + $this->cacheConfig, + $this->cache + ); + + $config = $http->getConfig(); + $config['handler']->remove('google_auth'); + $config['handler']->push($middleware, 'google_auth'); + $config['auth'] = 'scoped'; + $http = new Client($config); + + return $http; + } + + public function attachKey(ClientInterface $http, $key) + { + $middleware = new SimpleMiddleware(['key' => $key]); + + $config = $http->getConfig(); + $config['handler']->remove('google_auth'); + $config['handler']->push($middleware, 'google_auth'); + $config['auth'] = 'simple'; + $http = new Client($config); + + return $http; + } + + private function createAuthHttp(ClientInterface $http) + { + return new Client( + [ + 'base_uri' => $http->getConfig('base_uri'), + 'exceptions' => true, + 'verify' => $http->getConfig('verify'), + 'proxy' => $http->getConfig('proxy'), + ] + ); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Client.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Client.php new file mode 100644 index 0000000..8f83293 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Client.php @@ -0,0 +1,1118 @@ +config = array_merge( + [ + 'application_name' => '', + + // Don't change these unless you're working against a special development + // or testing environment. + 'base_path' => self::API_BASE_PATH, + + // https://developers.google.com/console + 'client_id' => '', + 'client_secret' => '', + 'redirect_uri' => null, + 'state' => null, + + // Simple API access key, also from the API console. Ensure you get + // a Server key, and not a Browser key. + 'developer_key' => '', + + // For use with Google Cloud Platform + // fetch the ApplicationDefaultCredentials, if applicable + // @see https://developers.google.com/identity/protocols/application-default-credentials + 'use_application_default_credentials' => false, + 'signing_key' => null, + 'signing_algorithm' => null, + 'subject' => null, + + // Other OAuth2 parameters. + 'hd' => '', + 'prompt' => '', + 'openid.realm' => '', + 'include_granted_scopes' => null, + 'login_hint' => '', + 'request_visible_actions' => '', + 'access_type' => 'online', + 'approval_prompt' => 'auto', + + // Task Runner retry configuration + // @see Google_Task_Runner + 'retry' => array(), + + // cache config for downstream auth caching + 'cache_config' => [], + + // function to be called when an access token is fetched + // follows the signature function ($cacheKey, $accessToken) + 'token_callback' => null, + + // Service class used in Google_Client::verifyIdToken. + // Explicitly pass this in to avoid setting JWT::$leeway + 'jwt' => null, + ], + $config + ); + } + + /** + * Get a string containing the version of the library. + * + * @return string + */ + public function getLibraryVersion() + { + return self::LIBVER; + } + + /** + * For backwards compatibility + * alias for fetchAccessTokenWithAuthCode + * + * @param $code string code from accounts.google.com + * @return array access token + * @deprecated + */ + public function authenticate($code) + { + return $this->fetchAccessTokenWithAuthCode($code); + } + + /** + * Attempt to exchange a code for an valid authentication token. + * Helper wrapped around the OAuth 2.0 implementation. + * + * @param $code string code from accounts.google.com + * @return array access token + */ + public function fetchAccessTokenWithAuthCode($code) + { + if (strlen($code) == 0) { + throw new InvalidArgumentException("Invalid code"); + } + + $auth = $this->getOAuth2Service(); + $auth->setCode($code); + $auth->setRedirectUri($this->getRedirectUri()); + + $httpHandler = HttpHandlerFactory::build($this->getHttpClient()); + $creds = $auth->fetchAuthToken($httpHandler); + if ($creds && isset($creds['access_token'])) { + $creds['created'] = time(); + $this->setAccessToken($creds); + } + + return $creds; + } + + /** + * For backwards compatibility + * alias for fetchAccessTokenWithAssertion + * + * @return array access token + * @deprecated + */ + public function refreshTokenWithAssertion() + { + return $this->fetchAccessTokenWithAssertion(); + } + + /** + * Fetches a fresh access token with a given assertion token. + * @param $assertionCredentials optional. + * @return array access token + */ + public function fetchAccessTokenWithAssertion(ClientInterface $authHttp = null) + { + if (!$this->isUsingApplicationDefaultCredentials()) { + throw new DomainException( + 'set the JSON service account credentials using' + . ' Google_Client::setAuthConfig or set the path to your JSON file' + . ' with the "GOOGLE_APPLICATION_CREDENTIALS" environment variable' + . ' and call Google_Client::useApplicationDefaultCredentials to' + . ' refresh a token with assertion.' + ); + } + + $this->getLogger()->log( + 'info', + 'OAuth2 access token refresh with Signed JWT assertion grants.' + ); + + $credentials = $this->createApplicationDefaultCredentials(); + + $httpHandler = HttpHandlerFactory::build($authHttp); + $creds = $credentials->fetchAuthToken($httpHandler); + if ($creds && isset($creds['access_token'])) { + $creds['created'] = time(); + $this->setAccessToken($creds); + } + + return $creds; + } + + /** + * For backwards compatibility + * alias for fetchAccessTokenWithRefreshToken + * + * @param string $refreshToken + * @return array access token + */ + public function refreshToken($refreshToken) + { + return $this->fetchAccessTokenWithRefreshToken($refreshToken); + } + + /** + * Fetches a fresh OAuth 2.0 access token with the given refresh token. + * @param string $refreshToken + * @return array access token + */ + public function fetchAccessTokenWithRefreshToken($refreshToken = null) + { + if (null === $refreshToken) { + if (!isset($this->token['refresh_token'])) { + throw new LogicException( + 'refresh token must be passed in or set as part of setAccessToken' + ); + } + $refreshToken = $this->token['refresh_token']; + } + $this->getLogger()->info('OAuth2 access token refresh'); + $auth = $this->getOAuth2Service(); + $auth->setRefreshToken($refreshToken); + + $httpHandler = HttpHandlerFactory::build($this->getHttpClient()); + $creds = $auth->fetchAuthToken($httpHandler); + if ($creds && isset($creds['access_token'])) { + $creds['created'] = time(); + if (!isset($creds['refresh_token'])) { + $creds['refresh_token'] = $refreshToken; + } + $this->setAccessToken($creds); + } + + return $creds; + } + + /** + * Create a URL to obtain user authorization. + * The authorization endpoint allows the user to first + * authenticate, and then grant/deny the access request. + * @param string|array $scope The scope is expressed as an array or list of space-delimited strings. + * @return string + */ + public function createAuthUrl($scope = null) + { + if (empty($scope)) { + $scope = $this->prepareScopes(); + } + if (is_array($scope)) { + $scope = implode(' ', $scope); + } + + // only accept one of prompt or approval_prompt + $approvalPrompt = $this->config['prompt'] + ? null + : $this->config['approval_prompt']; + + // include_granted_scopes should be string "true", string "false", or null + $includeGrantedScopes = $this->config['include_granted_scopes'] === null + ? null + : var_export($this->config['include_granted_scopes'], true); + + $params = array_filter( + [ + 'access_type' => $this->config['access_type'], + 'approval_prompt' => $approvalPrompt, + 'hd' => $this->config['hd'], + 'include_granted_scopes' => $includeGrantedScopes, + 'login_hint' => $this->config['login_hint'], + 'openid.realm' => $this->config['openid.realm'], + 'prompt' => $this->config['prompt'], + 'response_type' => 'code', + 'scope' => $scope, + 'state' => $this->config['state'], + ] + ); + + // If the list of scopes contains plus.login, add request_visible_actions + // to auth URL. + $rva = $this->config['request_visible_actions']; + if (strlen($rva) > 0 && false !== strpos($scope, 'plus.login')) { + $params['request_visible_actions'] = $rva; + } + + $auth = $this->getOAuth2Service(); + + return (string) $auth->buildFullAuthorizationUri($params); + } + + /** + * Adds auth listeners to the HTTP client based on the credentials + * set in the Google API Client object + * + * @param GuzzleHttp\ClientInterface $http the http client object. + * @return GuzzleHttp\ClientInterface the http client object + */ + public function authorize(ClientInterface $http = null) + { + $credentials = null; + $token = null; + $scopes = null; + if (null === $http) { + $http = $this->getHttpClient(); + } + + // These conditionals represent the decision tree for authentication + // 1. Check for Application Default Credentials + // 2. Check for API Key + // 3a. Check for an Access Token + // 3b. If access token exists but is expired, try to refresh it + if ($this->isUsingApplicationDefaultCredentials()) { + $credentials = $this->createApplicationDefaultCredentials(); + } elseif ($token = $this->getAccessToken()) { + $scopes = $this->prepareScopes(); + // add refresh subscriber to request a new token + if (isset($token['refresh_token']) && $this->isAccessTokenExpired()) { + $credentials = $this->createUserRefreshCredentials( + $scopes, + $token['refresh_token'] + ); + } + } + + $authHandler = $this->getAuthHandler(); + + if ($credentials) { + $callback = $this->config['token_callback']; + $http = $authHandler->attachCredentials($http, $credentials, $callback); + } elseif ($token) { + $http = $authHandler->attachToken($http, $token, (array) $scopes); + } elseif ($key = $this->config['developer_key']) { + $http = $authHandler->attachKey($http, $key); + } + + return $http; + } + + /** + * Set the configuration to use application default credentials for + * authentication + * + * @see https://developers.google.com/identity/protocols/application-default-credentials + * @param boolean $useAppCreds + */ + public function useApplicationDefaultCredentials($useAppCreds = true) + { + $this->config['use_application_default_credentials'] = $useAppCreds; + } + + /** + * To prevent useApplicationDefaultCredentials from inappropriately being + * called in a conditional + * + * @see https://developers.google.com/identity/protocols/application-default-credentials + */ + public function isUsingApplicationDefaultCredentials() + { + return $this->config['use_application_default_credentials']; + } + + /** + * @param string|array $token + * @throws InvalidArgumentException + */ + public function setAccessToken($token) + { + if (is_string($token)) { + if ($json = json_decode($token, true)) { + $token = $json; + } else { + // assume $token is just the token string + $token = array( + 'access_token' => $token, + ); + } + } + if ($token == null) { + throw new InvalidArgumentException('invalid json token'); + } + if (!isset($token['access_token'])) { + throw new InvalidArgumentException("Invalid token format"); + } + $this->token = $token; + } + + public function getAccessToken() + { + return $this->token; + } + + public function getRefreshToken() + { + if (isset($this->token['refresh_token'])) { + return $this->token['refresh_token']; + } + } + + /** + * Returns if the access_token is expired. + * @return bool Returns True if the access_token is expired. + */ + public function isAccessTokenExpired() + { + if (!$this->token) { + return true; + } + + $created = 0; + if (isset($this->token['created'])) { + $created = $this->token['created']; + } elseif (isset($this->token['id_token'])) { + // check the ID token for "iat" + // signature verification is not required here, as we are just + // using this for convenience to save a round trip request + // to the Google API server + $idToken = $this->token['id_token']; + if (substr_count($idToken, '.') == 2) { + $parts = explode('.', $idToken); + $payload = json_decode(base64_decode($parts[1]), true); + if ($payload && isset($payload['iat'])) { + $created = $payload['iat']; + } + } + } + + // If the token is set to expire in the next 30 seconds. + return ($created + ($this->token['expires_in'] - 30)) < time(); + } + + public function getAuth() + { + throw new BadMethodCallException( + 'This function no longer exists. See UPGRADING.md for more information' + ); + } + + public function setAuth($auth) + { + throw new BadMethodCallException( + 'This function no longer exists. See UPGRADING.md for more information' + ); + } + + /** + * Set the OAuth 2.0 Client ID. + * @param string $clientId + */ + public function setClientId($clientId) + { + $this->config['client_id'] = $clientId; + } + + public function getClientId() + { + return $this->config['client_id']; + } + + /** + * Set the OAuth 2.0 Client Secret. + * @param string $clientSecret + */ + public function setClientSecret($clientSecret) + { + $this->config['client_secret'] = $clientSecret; + } + + public function getClientSecret() + { + return $this->config['client_secret']; + } + + /** + * Set the OAuth 2.0 Redirect URI. + * @param string $redirectUri + */ + public function setRedirectUri($redirectUri) + { + $this->config['redirect_uri'] = $redirectUri; + } + + public function getRedirectUri() + { + return $this->config['redirect_uri']; + } + + /** + * Set OAuth 2.0 "state" parameter to achieve per-request customization. + * @see http://tools.ietf.org/html/draft-ietf-oauth-v2-22#section-3.1.2.2 + * @param string $state + */ + public function setState($state) + { + $this->config['state'] = $state; + } + + /** + * @param string $accessType Possible values for access_type include: + * {@code "offline"} to request offline access from the user. + * {@code "online"} to request online access from the user. + */ + public function setAccessType($accessType) + { + $this->config['access_type'] = $accessType; + } + + /** + * @param string $approvalPrompt Possible values for approval_prompt include: + * {@code "force"} to force the approval UI to appear. + * {@code "auto"} to request auto-approval when possible. (This is the default value) + */ + public function setApprovalPrompt($approvalPrompt) + { + $this->config['approval_prompt'] = $approvalPrompt; + } + + /** + * Set the login hint, email address or sub id. + * @param string $loginHint + */ + public function setLoginHint($loginHint) + { + $this->config['login_hint'] = $loginHint; + } + + /** + * Set the application name, this is included in the User-Agent HTTP header. + * @param string $applicationName + */ + public function setApplicationName($applicationName) + { + $this->config['application_name'] = $applicationName; + } + + /** + * If 'plus.login' is included in the list of requested scopes, you can use + * this method to define types of app activities that your app will write. + * You can find a list of available types here: + * @link https://developers.google.com/+/api/moment-types + * + * @param array $requestVisibleActions Array of app activity types + */ + public function setRequestVisibleActions($requestVisibleActions) + { + if (is_array($requestVisibleActions)) { + $requestVisibleActions = implode(" ", $requestVisibleActions); + } + $this->config['request_visible_actions'] = $requestVisibleActions; + } + + /** + * Set the developer key to use, these are obtained through the API Console. + * @see http://code.google.com/apis/console-help/#generatingdevkeys + * @param string $developerKey + */ + public function setDeveloperKey($developerKey) + { + $this->config['developer_key'] = $developerKey; + } + + /** + * Set the hd (hosted domain) parameter streamlines the login process for + * Google Apps hosted accounts. By including the domain of the user, you + * restrict sign-in to accounts at that domain. + * @param $hd string - the domain to use. + */ + public function setHostedDomain($hd) + { + $this->config['hd'] = $hd; + } + + /** + * Set the prompt hint. Valid values are none, consent and select_account. + * If no value is specified and the user has not previously authorized + * access, then the user is shown a consent screen. + * @param $prompt string + */ + public function setPrompt($prompt) + { + $this->config['prompt'] = $prompt; + } + + /** + * openid.realm is a parameter from the OpenID 2.0 protocol, not from OAuth + * 2.0. It is used in OpenID 2.0 requests to signify the URL-space for which + * an authentication request is valid. + * @param $realm string - the URL-space to use. + */ + public function setOpenidRealm($realm) + { + $this->config['openid.realm'] = $realm; + } + + /** + * If this is provided with the value true, and the authorization request is + * granted, the authorization will include any previous authorizations + * granted to this user/application combination for other scopes. + * @param $include boolean - the URL-space to use. + */ + public function setIncludeGrantedScopes($include) + { + $this->config['include_granted_scopes'] = $include; + } + + /** + * sets function to be called when an access token is fetched + * @param callable $tokenCallback - function ($cacheKey, $accessToken) + */ + public function setTokenCallback(callable $tokenCallback) + { + $this->config['token_callback'] = $tokenCallback; + } + + /** + * Revoke an OAuth2 access token or refresh token. This method will revoke the current access + * token, if a token isn't provided. + * + * @param string|null $token The token (access token or a refresh token) that should be revoked. + * @return boolean Returns True if the revocation was successful, otherwise False. + */ + public function revokeToken($token = null) + { + $tokenRevoker = new Google_AccessToken_Revoke( + $this->getHttpClient() + ); + + return $tokenRevoker->revokeToken($token ?: $this->getAccessToken()); + } + + /** + * Verify an id_token. This method will verify the current id_token, if one + * isn't provided. + * + * @throws LogicException + * @param string|null $idToken The token (id_token) that should be verified. + * @return array|false Returns the token payload as an array if the verification was + * successful, false otherwise. + */ + public function verifyIdToken($idToken = null) + { + $tokenVerifier = new Google_AccessToken_Verify( + $this->getHttpClient(), + $this->getCache(), + $this->config['jwt'] + ); + + if (null === $idToken) { + $token = $this->getAccessToken(); + if (!isset($token['id_token'])) { + throw new LogicException( + 'id_token must be passed in or set as part of setAccessToken' + ); + } + $idToken = $token['id_token']; + } + + return $tokenVerifier->verifyIdToken( + $idToken, + $this->getClientId() + ); + } + + /** + * Set the scopes to be requested. Must be called before createAuthUrl(). + * Will remove any previously configured scopes. + * @param array $scopes, ie: array('https://www.googleapis.com/auth/plus.login', + * 'https://www.googleapis.com/auth/moderator') + */ + public function setScopes($scopes) + { + $this->requestedScopes = array(); + $this->addScope($scopes); + } + + /** + * This functions adds a scope to be requested as part of the OAuth2.0 flow. + * Will append any scopes not previously requested to the scope parameter. + * A single string will be treated as a scope to request. An array of strings + * will each be appended. + * @param $scope_or_scopes string|array e.g. "profile" + */ + public function addScope($scope_or_scopes) + { + if (is_string($scope_or_scopes) && !in_array($scope_or_scopes, $this->requestedScopes)) { + $this->requestedScopes[] = $scope_or_scopes; + } else if (is_array($scope_or_scopes)) { + foreach ($scope_or_scopes as $scope) { + $this->addScope($scope); + } + } + } + + /** + * Returns the list of scopes requested by the client + * @return array the list of scopes + * + */ + public function getScopes() + { + return $this->requestedScopes; + } + + /** + * @return array + * @visible For Testing + */ + public function prepareScopes() + { + if (empty($this->requestedScopes)) { + return null; + } + + return implode(' ', $this->requestedScopes); + } + + /** + * Helper method to execute deferred HTTP requests. + * + * @param $request Psr\Http\Message\RequestInterface|Google_Http_Batch + * @throws Google_Exception + * @return object of the type of the expected class or Psr\Http\Message\ResponseInterface. + */ + public function execute(RequestInterface $request, $expectedClass = null) + { + $request = $request->withHeader( + 'User-Agent', + $this->config['application_name'] + . " " . self::USER_AGENT_SUFFIX + . $this->getLibraryVersion() + ); + + // call the authorize method + // this is where most of the grunt work is done + $http = $this->authorize(); + + return Google_Http_REST::execute($http, $request, $expectedClass, $this->config['retry']); + } + + /** + * Declare whether batch calls should be used. This may increase throughput + * by making multiple requests in one connection. + * + * @param boolean $useBatch True if the batch support should + * be enabled. Defaults to False. + */ + public function setUseBatch($useBatch) + { + // This is actually an alias for setDefer. + $this->setDefer($useBatch); + } + + /** + * Are we running in Google AppEngine? + * return bool + */ + public function isAppEngine() + { + return (isset($_SERVER['SERVER_SOFTWARE']) && + strpos($_SERVER['SERVER_SOFTWARE'], 'Google App Engine') !== false); + } + + public function setConfig($name, $value) + { + $this->config[$name] = $value; + } + + public function getConfig($name, $default = null) + { + return isset($this->config[$name]) ? $this->config[$name] : $default; + } + + /** + * For backwards compatibility + * alias for setAuthConfig + * + * @param string $file the configuration file + * @throws Google_Exception + * @deprecated + */ + public function setAuthConfigFile($file) + { + $this->setAuthConfig($file); + } + + /** + * Set the auth config from new or deprecated JSON config. + * This structure should match the file downloaded from + * the "Download JSON" button on in the Google Developer + * Console. + * @param string|array $config the configuration json + * @throws Google_Exception + */ + public function setAuthConfig($config) + { + if (is_string($config)) { + if (!file_exists($config)) { + throw new InvalidArgumentException('file does not exist'); + } + + $json = file_get_contents($config); + + if (!$config = json_decode($json, true)) { + throw new LogicException('invalid json for auth config'); + } + } + + $key = isset($config['installed']) ? 'installed' : 'web'; + if (isset($config['type']) && $config['type'] == 'service_account') { + // application default credentials + $this->useApplicationDefaultCredentials(); + + // set the information from the config + $this->setClientId($config['client_id']); + $this->config['client_email'] = $config['client_email']; + $this->config['signing_key'] = $config['private_key']; + $this->config['signing_algorithm'] = 'HS256'; + } elseif (isset($config[$key])) { + // old-style + $this->setClientId($config[$key]['client_id']); + $this->setClientSecret($config[$key]['client_secret']); + if (isset($config[$key]['redirect_uris'])) { + $this->setRedirectUri($config[$key]['redirect_uris'][0]); + } + } else { + // new-style + $this->setClientId($config['client_id']); + $this->setClientSecret($config['client_secret']); + if (isset($config['redirect_uris'])) { + $this->setRedirectUri($config['redirect_uris'][0]); + } + } + } + + /** + * Use when the service account has been delegated domain wide access. + * + * @param string subject an email address account to impersonate + */ + public function setSubject($subject) + { + $this->config['subject'] = $subject; + } + + /** + * Declare whether making API calls should make the call immediately, or + * return a request which can be called with ->execute(); + * + * @param boolean $defer True if calls should not be executed right away. + */ + public function setDefer($defer) + { + $this->deferExecution = $defer; + } + + /** + * Whether or not to return raw requests + * @return boolean + */ + public function shouldDefer() + { + return $this->deferExecution; + } + + /** + * @return Google\Auth\OAuth2 implementation + */ + public function getOAuth2Service() + { + if (!isset($this->auth)) { + $this->auth = $this->createOAuth2Service(); + } + + return $this->auth; + } + + /** + * create a default google auth object + */ + protected function createOAuth2Service() + { + $auth = new OAuth2( + [ + 'clientId' => $this->getClientId(), + 'clientSecret' => $this->getClientSecret(), + 'authorizationUri' => self::OAUTH2_AUTH_URL, + 'tokenCredentialUri' => self::OAUTH2_TOKEN_URI, + 'redirectUri' => $this->getRedirectUri(), + 'issuer' => $this->config['client_id'], + 'signingKey' => $this->config['signing_key'], + 'signingAlgorithm' => $this->config['signing_algorithm'], + ] + ); + + return $auth; + } + + /** + * Set the Cache object + * @param Psr\Cache\CacheItemPoolInterface $cache + */ + public function setCache(CacheItemPoolInterface $cache) + { + $this->cache = $cache; + } + + /** + * @return Psr\Cache\CacheItemPoolInterface Cache implementation + */ + public function getCache() + { + if (!$this->cache) { + $this->cache = $this->createDefaultCache(); + } + + return $this->cache; + } + + /** + * @return Google\Auth\CacheInterface Cache implementation + */ + public function setCacheConfig(array $cacheConfig) + { + $this->config['cache_config'] = $cacheConfig; + } + + /** + * Set the Logger object + * @param Psr\Log\LoggerInterface $logger + */ + public function setLogger(LoggerInterface $logger) + { + $this->logger = $logger; + } + + /** + * @return Psr\Log\LoggerInterface implementation + */ + public function getLogger() + { + if (!isset($this->logger)) { + $this->logger = $this->createDefaultLogger(); + } + + return $this->logger; + } + + protected function createDefaultLogger() + { + $logger = new Logger('google-api-php-client'); + if ($this->isAppEngine()) { + $handler = new MonologSyslogHandler('app', LOG_USER, Logger::NOTICE); + } else { + $handler = new MonologStreamHandler('php://stderr', Logger::NOTICE); + } + $logger->pushHandler($handler); + + return $logger; + } + + protected function createDefaultCache() + { + return new MemoryCacheItemPool; + } + + /** + * Set the Http Client object + * @param GuzzleHttp\ClientInterface $http + */ + public function setHttpClient(ClientInterface $http) + { + $this->http = $http; + } + + /** + * @return GuzzleHttp\ClientInterface implementation + */ + public function getHttpClient() + { + if (null === $this->http) { + $this->http = $this->createDefaultHttpClient(); + } + + return $this->http; + } + + protected function createDefaultHttpClient() + { + $options = ['exceptions' => false]; + + $version = ClientInterface::VERSION; + if ('5' === $version[0]) { + $options = [ + 'base_url' => $this->config['base_path'], + 'defaults' => $options, + ]; + if ($this->isAppEngine()) { + // set StreamHandler on AppEngine by default + $options['handler'] = new StreamHandler(); + $options['defaults']['verify'] = '/etc/ca-certificates.crt'; + } + } else { + // guzzle 6 + $options['base_uri'] = $this->config['base_path']; + } + + return new Client($options); + } + + private function createApplicationDefaultCredentials() + { + $scopes = $this->prepareScopes(); + $sub = $this->config['subject']; + $signingKey = $this->config['signing_key']; + + // create credentials using values supplied in setAuthConfig + if ($signingKey) { + $serviceAccountCredentials = array( + 'client_id' => $this->config['client_id'], + 'client_email' => $this->config['client_email'], + 'private_key' => $signingKey, + 'type' => 'service_account', + ); + $credentials = CredentialsLoader::makeCredentials($scopes, $serviceAccountCredentials); + } else { + $credentials = ApplicationDefaultCredentials::getCredentials($scopes); + } + + // for service account domain-wide authority (impersonating a user) + // @see https://developers.google.com/identity/protocols/OAuth2ServiceAccount + if ($sub) { + if (!$credentials instanceof ServiceAccountCredentials) { + throw new DomainException('domain-wide authority requires service account credentials'); + } + + $credentials->setSub($sub); + } + + return $credentials; + } + + protected function getAuthHandler() + { + // Be very careful using the cache, as the underlying auth library's cache + // implementation is naive, and the cache keys do not account for user + // sessions. + // + // @see https://github.com/google/google-api-php-client/issues/821 + return Google_AuthHandler_AuthHandlerFactory::build( + $this->getCache(), + $this->config['cache_config'] + ); + } + + private function createUserRefreshCredentials($scope, $refreshToken) + { + $creds = array_filter( + array( + 'client_id' => $this->getClientId(), + 'client_secret' => $this->getClientSecret(), + 'refresh_token' => $refreshToken, + ) + ); + + return new UserRefreshCredentials($scope, $creds); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Collection.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Collection.php new file mode 100644 index 0000000..df8d444 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Collection.php @@ -0,0 +1,100 @@ +{$this->collection_key}) + && is_array($this->{$this->collection_key})) { + reset($this->{$this->collection_key}); + } + } + + public function current() + { + $this->coerceType($this->key()); + if (is_array($this->{$this->collection_key})) { + return current($this->{$this->collection_key}); + } + } + + public function key() + { + if (isset($this->{$this->collection_key}) + && is_array($this->{$this->collection_key})) { + return key($this->{$this->collection_key}); + } + } + + public function next() + { + return next($this->{$this->collection_key}); + } + + public function valid() + { + $key = $this->key(); + return $key !== null && $key !== false; + } + + public function count() + { + if (!isset($this->{$this->collection_key})) { + return 0; + } + return count($this->{$this->collection_key}); + } + + public function offsetExists($offset) + { + if (!is_numeric($offset)) { + return parent::offsetExists($offset); + } + return isset($this->{$this->collection_key}[$offset]); + } + + public function offsetGet($offset) + { + if (!is_numeric($offset)) { + return parent::offsetGet($offset); + } + $this->coerceType($offset); + return $this->{$this->collection_key}[$offset]; + } + + public function offsetSet($offset, $value) + { + if (!is_numeric($offset)) { + return parent::offsetSet($offset, $value); + } + $this->{$this->collection_key}[$offset] = $value; + } + + public function offsetUnset($offset) + { + if (!is_numeric($offset)) { + return parent::offsetUnset($offset); + } + unset($this->{$this->collection_key}[$offset]); + } + + private function coerceType($offset) + { + $keyType = $this->keyType($this->collection_key); + if ($keyType && !is_object($this->{$this->collection_key}[$offset])) { + $this->{$this->collection_key}[$offset] = + new $keyType($this->{$this->collection_key}[$offset]); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Exception.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Exception.php new file mode 100644 index 0000000..af80269 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Exception.php @@ -0,0 +1,20 @@ +client = $client; + $this->boundary = $boundary ?: mt_rand(); + $this->rootUrl = rtrim($rootUrl ?: $this->client->getConfig('base_path'), '/'); + $this->batchPath = $batchPath ?: self::BATCH_PATH; + } + + public function add(RequestInterface $request, $key = false) + { + if (false == $key) { + $key = mt_rand(); + } + + $this->requests[$key] = $request; + } + + public function execute() + { + $body = ''; + $classes = array(); + $batchHttpTemplate = <<requests as $key => $request) { + $firstLine = sprintf( + '%s %s HTTP/%s', + $request->getMethod(), + $request->getRequestTarget(), + $request->getProtocolVersion() + ); + + $content = (string) $request->getBody(); + + $headers = ''; + foreach ($request->getHeaders() as $name => $values) { + $headers .= sprintf("%s:%s\r\n", $name, implode(', ', $values)); + } + + $body .= sprintf( + $batchHttpTemplate, + $this->boundary, + $key, + $firstLine, + $headers, + $content ? "\n".$content : '' + ); + + $classes['response-' . $key] = $request->getHeaderLine('X-Php-Expected-Class'); + } + + $body .= "--{$this->boundary}--"; + $body = trim($body); + $url = $this->rootUrl . '/' . $this->batchPath; + $headers = array( + 'Content-Type' => sprintf('multipart/mixed; boundary=%s', $this->boundary), + 'Content-Length' => strlen($body), + ); + + $request = new Request( + 'POST', + $url, + $headers, + $body + ); + + $response = $this->client->execute($request); + + return $this->parseResponse($response, $classes); + } + + public function parseResponse(ResponseInterface $response, $classes = array()) + { + $contentType = $response->getHeaderLine('content-type'); + $contentType = explode(';', $contentType); + $boundary = false; + foreach ($contentType as $part) { + $part = explode('=', $part, 2); + if (isset($part[0]) && 'boundary' == trim($part[0])) { + $boundary = $part[1]; + } + } + + $body = (string) $response->getBody(); + if (!empty($body)) { + $body = str_replace("--$boundary--", "--$boundary", $body); + $parts = explode("--$boundary", $body); + $responses = array(); + $requests = array_values($this->requests); + + foreach ($parts as $i => $part) { + $part = trim($part); + if (!empty($part)) { + list($rawHeaders, $part) = explode("\r\n\r\n", $part, 2); + $headers = $this->parseRawHeaders($rawHeaders); + + $status = substr($part, 0, strpos($part, "\n")); + $status = explode(" ", $status); + $status = $status[1]; + + list($partHeaders, $partBody) = $this->parseHttpResponse($part, false); + $response = new Response( + $status, + $partHeaders, + Psr7\stream_for($partBody) + ); + + // Need content id. + $key = $headers['content-id']; + + try { + $response = Google_Http_REST::decodeHttpResponse($response, $requests[$i-1]); + } catch (Google_Service_Exception $e) { + // Store the exception as the response, so successful responses + // can be processed. + $response = $e; + } + + $responses[$key] = $response; + } + } + + return $responses; + } + + return null; + } + + private function parseRawHeaders($rawHeaders) + { + $headers = array(); + $responseHeaderLines = explode("\r\n", $rawHeaders); + foreach ($responseHeaderLines as $headerLine) { + if ($headerLine && strpos($headerLine, ':') !== false) { + list($header, $value) = explode(': ', $headerLine, 2); + $header = strtolower($header); + if (isset($headers[$header])) { + $headers[$header] .= "\n" . $value; + } else { + $headers[$header] = $value; + } + } + } + return $headers; + } + + /** + * Used by the IO lib and also the batch processing. + * + * @param $respData + * @param $headerSize + * @return array + */ + private function parseHttpResponse($respData, $headerSize) + { + // check proxy header + foreach (self::$CONNECTION_ESTABLISHED_HEADERS as $established_header) { + if (stripos($respData, $established_header) !== false) { + // existed, remove it + $respData = str_ireplace($established_header, '', $respData); + // Subtract the proxy header size unless the cURL bug prior to 7.30.0 + // is present which prevented the proxy header size from being taken into + // account. + // @TODO look into this + // if (!$this->needsQuirk()) { + // $headerSize -= strlen($established_header); + // } + break; + } + } + + if ($headerSize) { + $responseBody = substr($respData, $headerSize); + $responseHeaders = substr($respData, 0, $headerSize); + } else { + $responseSegments = explode("\r\n\r\n", $respData, 2); + $responseHeaders = $responseSegments[0]; + $responseBody = isset($responseSegments[1]) ? $responseSegments[1] : + null; + } + + $responseHeaders = $this->parseRawHeaders($responseHeaders); + + return array($responseHeaders, $responseBody); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/MediaFileUpload.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/MediaFileUpload.php new file mode 100644 index 0000000..1ce9bb1 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/MediaFileUpload.php @@ -0,0 +1,351 @@ +client = $client; + $this->request = $request; + $this->mimeType = $mimeType; + $this->data = $data; + $this->resumable = $resumable; + $this->chunkSize = $chunkSize; + $this->progress = 0; + + $this->process(); + } + + /** + * Set the size of the file that is being uploaded. + * @param $size - int file size in bytes + */ + public function setFileSize($size) + { + $this->size = $size; + } + + /** + * Return the progress on the upload + * @return int progress in bytes uploaded. + */ + public function getProgress() + { + return $this->progress; + } + + /** + * Send the next part of the file to upload. + * @param [$chunk] the next set of bytes to send. If false will used $data passed + * at construct time. + */ + public function nextChunk($chunk = false) + { + $resumeUri = $this->getResumeUri(); + + if (false == $chunk) { + $chunk = substr($this->data, $this->progress, $this->chunkSize); + } + + $lastBytePos = $this->progress + strlen($chunk) - 1; + $headers = array( + 'content-range' => "bytes $this->progress-$lastBytePos/$this->size", + 'content-length' => strlen($chunk), + 'expect' => '', + ); + + $request = new Request( + 'PUT', + $resumeUri, + $headers, + Psr7\stream_for($chunk) + ); + + return $this->makePutRequest($request); + } + + /** + * Return the HTTP result code from the last call made. + * @return int code + */ + public function getHttpResultCode() + { + return $this->httpResultCode; + } + + /** + * Sends a PUT-Request to google drive and parses the response, + * setting the appropiate variables from the response() + * + * @param Google_Http_Request $httpRequest the Reuqest which will be send + * + * @return false|mixed false when the upload is unfinished or the decoded http response + * + */ + private function makePutRequest(RequestInterface $request) + { + $response = $this->client->execute($request); + $this->httpResultCode = $response->getStatusCode(); + + if (308 == $this->httpResultCode) { + // Track the amount uploaded. + $range = $response->getHeaderLine('range'); + if ($range) { + $range_array = explode('-', $range); + $this->progress = $range_array[1] + 1; + } + + // Allow for changing upload URLs. + $location = $response->getHeaderLine('location'); + if ($location) { + $this->resumeUri = $location; + } + + // No problems, but upload not complete. + return false; + } + + return Google_Http_REST::decodeHttpResponse($response, $this->request); + } + + /** + * Resume a previously unfinished upload + * @param $resumeUri the resume-URI of the unfinished, resumable upload. + */ + public function resume($resumeUri) + { + $this->resumeUri = $resumeUri; + $headers = array( + 'content-range' => "bytes */$this->size", + 'content-length' => 0, + ); + $httpRequest = new Request( + 'PUT', + $this->resumeUri, + $headers + ); + + return $this->makePutRequest($httpRequest); + } + + /** + * @return Psr\Http\Message\RequestInterface $request + * @visible for testing + */ + private function process() + { + $this->transformToUploadUrl(); + $request = $this->request; + + $postBody = ''; + $contentType = false; + + $meta = (string) $request->getBody(); + $meta = is_string($meta) ? json_decode($meta, true) : $meta; + + $uploadType = $this->getUploadType($meta); + $request = $request->withUri( + Uri::withQueryValue($request->getUri(), 'uploadType', $uploadType) + ); + + $mimeType = $this->mimeType ?: $request->getHeaderLine('content-type'); + + if (self::UPLOAD_RESUMABLE_TYPE == $uploadType) { + $contentType = $mimeType; + $postBody = is_string($meta) ? $meta : json_encode($meta); + } else if (self::UPLOAD_MEDIA_TYPE == $uploadType) { + $contentType = $mimeType; + $postBody = $this->data; + } else if (self::UPLOAD_MULTIPART_TYPE == $uploadType) { + // This is a multipart/related upload. + $boundary = $this->boundary ?: mt_rand(); + $boundary = str_replace('"', '', $boundary); + $contentType = 'multipart/related; boundary=' . $boundary; + $related = "--$boundary\r\n"; + $related .= "Content-Type: application/json; charset=UTF-8\r\n"; + $related .= "\r\n" . json_encode($meta) . "\r\n"; + $related .= "--$boundary\r\n"; + $related .= "Content-Type: $mimeType\r\n"; + $related .= "Content-Transfer-Encoding: base64\r\n"; + $related .= "\r\n" . base64_encode($this->data) . "\r\n"; + $related .= "--$boundary--"; + $postBody = $related; + } + + $request = $request->withBody(Psr7\stream_for($postBody)); + + if (isset($contentType) && $contentType) { + $request = $request->withHeader('content-type', $contentType); + } + + return $this->request = $request; + } + + /** + * Valid upload types: + * - resumable (UPLOAD_RESUMABLE_TYPE) + * - media (UPLOAD_MEDIA_TYPE) + * - multipart (UPLOAD_MULTIPART_TYPE) + * @param $meta + * @return string + * @visible for testing + */ + public function getUploadType($meta) + { + if ($this->resumable) { + return self::UPLOAD_RESUMABLE_TYPE; + } + + if (false == $meta && $this->data) { + return self::UPLOAD_MEDIA_TYPE; + } + + return self::UPLOAD_MULTIPART_TYPE; + } + + public function getResumeUri() + { + if (null === $this->resumeUri) { + $this->resumeUri = $this->fetchResumeUri(); + } + + return $this->resumeUri; + } + + private function fetchResumeUri() + { + $body = $this->request->getBody(); + if ($body) { + $headers = array( + 'content-type' => 'application/json; charset=UTF-8', + 'content-length' => $body->getSize(), + 'x-upload-content-type' => $this->mimeType, + 'x-upload-content-length' => $this->size, + 'expect' => '', + ); + foreach ($headers as $key => $value) { + $this->request = $this->request->withHeader($key, $value); + } + } + + $response = $this->client->execute($this->request, false); + $location = $response->getHeaderLine('location'); + $code = $response->getStatusCode(); + + if (200 == $code && true == $location) { + return $location; + } + + $message = $code; + $body = json_decode((string) $this->request->getBody(), true); + if (isset($body['error']['errors'])) { + $message .= ': '; + foreach ($body['error']['errors'] as $error) { + $message .= "{$error[domain]}, {$error[message]};"; + } + $message = rtrim($message, ';'); + } + + $error = "Failed to start the resumable upload (HTTP {$message})"; + $this->client->getLogger()->error($error); + + throw new Google_Exception($error); + } + + private function transformToUploadUrl() + { + $parts = parse_url((string) $this->request->getUri()); + if (!isset($parts['path'])) { + $parts['path'] = ''; + } + $parts['path'] = '/upload' . $parts['path']; + $uri = Uri::fromParts($parts); + $this->request = $this->request->withUri($uri); + } + + public function setChunkSize($chunkSize) + { + $this->chunkSize = $chunkSize; + } + + public function getRequest() + { + return $this->request; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/REST.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/REST.php new file mode 100644 index 0000000..c2156a2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Http/REST.php @@ -0,0 +1,182 @@ +getMethod(), (string) $request->getUri()), + array(get_class(), 'doExecute'), + array($client, $request, $expectedClass) + ); + + if (null !== $retryMap) { + $runner->setRetryMap($retryMap); + } + + return $runner->run(); + } + + /** + * Executes a Psr\Http\Message\RequestInterface + * + * @param Google_Client $client + * @param Psr\Http\Message\RequestInterface $request + * @return array decoded result + * @throws Google_Service_Exception on server side error (ie: not authenticated, + * invalid or malformed post body, invalid url) + */ + public static function doExecute(ClientInterface $client, RequestInterface $request, $expectedClass = null) + { + try { + $httpHandler = HttpHandlerFactory::build($client); + $response = $httpHandler($request); + } catch (RequestException $e) { + // if Guzzle throws an exception, catch it and handle the response + if (!$e->hasResponse()) { + throw $e; + } + + $response = $e->getResponse(); + // specific checking for Guzzle 5: convert to PSR7 response + if ($response instanceof \GuzzleHttp\Message\ResponseInterface) { + $response = new Response( + $response->getStatusCode(), + $response->getHeaders() ?: [], + $response->getBody(), + $response->getProtocolVersion(), + $response->getReasonPhrase() + ); + } + } + + return self::decodeHttpResponse($response, $request, $expectedClass); + } + + /** + * Decode an HTTP Response. + * @static + * @throws Google_Service_Exception + * @param Psr\Http\Message\RequestInterface $response The http response to be decoded. + * @param Psr\Http\Message\ResponseInterface $response + * @return mixed|null + */ + public static function decodeHttpResponse( + ResponseInterface $response, + RequestInterface $request = null, + $expectedClass = null + ) { + $code = $response->getStatusCode(); + + // retry strategy + if (intVal($code) >= 400) { + // if we errored out, it should be safe to grab the response body + $body = (string) $response->getBody(); + + // Check if we received errors, and add those to the Exception for convenience + throw new Google_Service_Exception($body, $code, null, self::getResponseErrors($body)); + } + + // Ensure we only pull the entire body into memory if the request is not + // of media type + $body = self::decodeBody($response, $request); + + if ($expectedClass = self::determineExpectedClass($expectedClass, $request)) { + $json = json_decode($body, true); + + return new $expectedClass($json); + } + + return $response; + } + + private static function decodeBody(ResponseInterface $response, RequestInterface $request = null) + { + if (self::isAltMedia($request)) { + // don't decode the body, it's probably a really long string + return ''; + } + + return (string) $response->getBody(); + } + + private static function determineExpectedClass($expectedClass, RequestInterface $request = null) + { + // "false" is used to explicitly prevent an expected class from being returned + if (false === $expectedClass) { + return null; + } + + // if we don't have a request, we just use what's passed in + if (null === $request) { + return $expectedClass; + } + + // return what we have in the request header if one was not supplied + return $expectedClass ?: $request->getHeaderLine('X-Php-Expected-Class'); + } + + private static function getResponseErrors($body) + { + $json = json_decode($body, true); + + if (isset($json['error']['errors'])) { + return $json['error']['errors']; + } + + return null; + } + + private static function isAltMedia(RequestInterface $request = null) + { + if ($request && $qs = $request->getUri()->getQuery()) { + parse_str($qs, $query); + if (isset($query['alt']) && $query['alt'] == 'media') { + return true; + } + } + + return false; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Model.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Model.php new file mode 100644 index 0000000..1826260 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Model.php @@ -0,0 +1,317 @@ +mapTypes($array); + } + $this->gapiInit(); + } + + /** + * Getter that handles passthrough access to the data array, and lazy object creation. + * @param string $key Property name. + * @return mixed The value if any, or null. + */ + public function __get($key) + { + $keyType = $this->keyType($key); + $keyDataType = $this->dataType($key); + if ($keyType && !isset($this->processed[$key])) { + if (isset($this->modelData[$key])) { + $val = $this->modelData[$key]; + } elseif ($keyDataType == 'array' || $keyDataType == 'map') { + $val = array(); + } else { + $val = null; + } + + if ($this->isAssociativeArray($val)) { + if ($keyDataType && 'map' == $keyDataType) { + foreach ($val as $arrayKey => $arrayItem) { + $this->modelData[$key][$arrayKey] = + new $keyType($arrayItem); + } + } else { + $this->modelData[$key] = new $keyType($val); + } + } else if (is_array($val)) { + $arrayObject = array(); + foreach ($val as $arrayIndex => $arrayItem) { + $arrayObject[$arrayIndex] = new $keyType($arrayItem); + } + $this->modelData[$key] = $arrayObject; + } + $this->processed[$key] = true; + } + + return isset($this->modelData[$key]) ? $this->modelData[$key] : null; + } + + /** + * Initialize this object's properties from an array. + * + * @param array $array Used to seed this object's properties. + * @return void + */ + protected function mapTypes($array) + { + // Hard initialise simple types, lazy load more complex ones. + foreach ($array as $key => $val) { + if ($keyType = $this->keyType($key)) { + $dataType = $this->dataType($key); + if ($dataType == 'array' || $dataType == 'map') { + $this->$key = array(); + foreach ($val as $itemKey => $itemVal) { + if ($itemVal instanceof $keyType) { + $this->{$key}[$itemKey] = $itemVal; + } else { + $this->{$key}[$itemKey] = new $keyType($itemVal); + } + } + } elseif ($val instanceof $keyType) { + $this->$key = $val; + } else { + $this->$key = new $keyType($val); + } + unset($array[$key]); + } elseif (property_exists($this, $key)) { + $this->$key = $val; + unset($array[$key]); + } elseif (property_exists($this, $camelKey = $this->camelCase($key))) { + // This checks if property exists as camelCase, leaving it in array as snake_case + // in case of backwards compatibility issues. + $this->$camelKey = $val; + } + } + $this->modelData = $array; + } + + /** + * Blank initialiser to be used in subclasses to do post-construction initialisation - this + * avoids the need for subclasses to have to implement the variadics handling in their + * constructors. + */ + protected function gapiInit() + { + return; + } + + /** + * Create a simplified object suitable for straightforward + * conversion to JSON. This is relatively expensive + * due to the usage of reflection, but shouldn't be called + * a whole lot, and is the most straightforward way to filter. + */ + public function toSimpleObject() + { + $object = new stdClass(); + + // Process all other data. + foreach ($this->modelData as $key => $val) { + $result = $this->getSimpleValue($val); + if ($result !== null) { + $object->$key = $this->nullPlaceholderCheck($result); + } + } + + // Process all public properties. + $reflect = new ReflectionObject($this); + $props = $reflect->getProperties(ReflectionProperty::IS_PUBLIC); + foreach ($props as $member) { + $name = $member->getName(); + $result = $this->getSimpleValue($this->$name); + if ($result !== null) { + $name = $this->getMappedName($name); + $object->$name = $this->nullPlaceholderCheck($result); + } + } + + return $object; + } + + /** + * Handle different types of values, primarily + * other objects and map and array data types. + */ + private function getSimpleValue($value) + { + if ($value instanceof Google_Model) { + return $value->toSimpleObject(); + } else if (is_array($value)) { + $return = array(); + foreach ($value as $key => $a_value) { + $a_value = $this->getSimpleValue($a_value); + if ($a_value !== null) { + $key = $this->getMappedName($key); + $return[$key] = $this->nullPlaceholderCheck($a_value); + } + } + return $return; + } + return $value; + } + + /** + * Check whether the value is the null placeholder and return true null. + */ + private function nullPlaceholderCheck($value) + { + if ($value === self::NULL_VALUE) { + return null; + } + return $value; + } + + /** + * If there is an internal name mapping, use that. + */ + private function getMappedName($key) + { + if (isset($this->internal_gapi_mappings, $this->internal_gapi_mappings[$key])) { + $key = $this->internal_gapi_mappings[$key]; + } + return $key; + } + + /** + * Returns true only if the array is associative. + * @param array $array + * @return bool True if the array is associative. + */ + protected function isAssociativeArray($array) + { + if (!is_array($array)) { + return false; + } + $keys = array_keys($array); + foreach ($keys as $key) { + if (is_string($key)) { + return true; + } + } + return false; + } + + /** + * Verify if $obj is an array. + * @throws Google_Exception Thrown if $obj isn't an array. + * @param array $obj Items that should be validated. + * @param string $method Method expecting an array as an argument. + */ + public function assertIsArray($obj, $method) + { + if ($obj && !is_array($obj)) { + throw new Google_Exception( + "Incorrect parameter type passed to $method(). Expected an array." + ); + } + } + + public function offsetExists($offset) + { + return isset($this->$offset) || isset($this->modelData[$offset]); + } + + public function offsetGet($offset) + { + return isset($this->$offset) ? + $this->$offset : + $this->__get($offset); + } + + public function offsetSet($offset, $value) + { + if (property_exists($this, $offset)) { + $this->$offset = $value; + } else { + $this->modelData[$offset] = $value; + $this->processed[$offset] = true; + } + } + + public function offsetUnset($offset) + { + unset($this->modelData[$offset]); + } + + protected function keyType($key) + { + $keyType = $key . "Type"; + + // ensure keyType is a valid class + if (property_exists($this, $keyType) && class_exists($this->$keyType)) { + return $this->$keyType; + } + } + + protected function dataType($key) + { + $dataType = $key . "DataType"; + + if (property_exists($this, $dataType)) { + return $this->$dataType; + } + } + + public function __isset($key) + { + return isset($this->modelData[$key]); + } + + public function __unset($key) + { + unset($this->modelData[$key]); + } + + /** + * Convert a string to camelCase + * @param string $value + * @return string + */ + private function camelCase($value) + { + $value = ucwords(str_replace(array('-', '_'), ' ', $value)); + $value = str_replace(' ', '', $value); + $value[0] = strtolower($value[0]); + return $value; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service.php new file mode 100644 index 0000000..d3fd3b4 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service.php @@ -0,0 +1,56 @@ +client = $client; + } + + /** + * Return the associated Google_Client class. + * @return Google_Client + */ + public function getClient() + { + return $this->client; + } + + /** + * Create a new HTTP Batch handler for this service + * + * @return Google_Http_Batch + */ + public function createBatch() + { + return new Google_Http_Batch( + $this->client, + false, + $this->rootUrl, + $this->batchPath + ); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/Exception.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/Exception.php new file mode 100644 index 0000000..abfd3f7 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/Exception.php @@ -0,0 +1,68 @@ += 0) { + parent::__construct($message, $code, $previous); + } else { + parent::__construct($message, $code); + } + + $this->errors = $errors; + } + + /** + * An example of the possible errors returned. + * + * { + * "domain": "global", + * "reason": "authError", + * "message": "Invalid Credentials", + * "locationType": "header", + * "location": "Authorization", + * } + * + * @return [{string, string}] List of errors return in an HTTP response or []. + */ + public function getErrors() + { + return $this->errors; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/README.md b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/README.md new file mode 100644 index 0000000..0de4862 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/README.md @@ -0,0 +1,5 @@ +# Google API Client Services + +Google API Client Service classes have been moved to the +[google-api-php-client-services](https://github.com/google/google-api-php-client-services) +repository. diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/Resource.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/Resource.php new file mode 100644 index 0000000..fee039b --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Service/Resource.php @@ -0,0 +1,296 @@ + array('type' => 'string', 'location' => 'query'), + 'fields' => array('type' => 'string', 'location' => 'query'), + 'trace' => array('type' => 'string', 'location' => 'query'), + 'userIp' => array('type' => 'string', 'location' => 'query'), + 'quotaUser' => array('type' => 'string', 'location' => 'query'), + 'data' => array('type' => 'string', 'location' => 'body'), + 'mimeType' => array('type' => 'string', 'location' => 'header'), + 'uploadType' => array('type' => 'string', 'location' => 'query'), + 'mediaUpload' => array('type' => 'complex', 'location' => 'query'), + 'prettyPrint' => array('type' => 'string', 'location' => 'query'), + ); + + /** @var string $rootUrl */ + private $rootUrl; + + /** @var Google_Client $client */ + private $client; + + /** @var string $serviceName */ + private $serviceName; + + /** @var string $servicePath */ + private $servicePath; + + /** @var string $resourceName */ + private $resourceName; + + /** @var array $methods */ + private $methods; + + public function __construct($service, $serviceName, $resourceName, $resource) + { + $this->rootUrl = $service->rootUrl; + $this->client = $service->getClient(); + $this->servicePath = $service->servicePath; + $this->serviceName = $serviceName; + $this->resourceName = $resourceName; + $this->methods = is_array($resource) && isset($resource['methods']) ? + $resource['methods'] : + array($resourceName => $resource); + } + + /** + * TODO: This function needs simplifying. + * @param $name + * @param $arguments + * @param $expectedClass - optional, the expected class name + * @return Google_Http_Request|expectedClass + * @throws Google_Exception + */ + public function call($name, $arguments, $expectedClass = null) + { + if (! isset($this->methods[$name])) { + $this->client->getLogger()->error( + 'Service method unknown', + array( + 'service' => $this->serviceName, + 'resource' => $this->resourceName, + 'method' => $name + ) + ); + + throw new Google_Exception( + "Unknown function: " . + "{$this->serviceName}->{$this->resourceName}->{$name}()" + ); + } + $method = $this->methods[$name]; + $parameters = $arguments[0]; + + // postBody is a special case since it's not defined in the discovery + // document as parameter, but we abuse the param entry for storing it. + $postBody = null; + if (isset($parameters['postBody'])) { + if ($parameters['postBody'] instanceof Google_Model) { + // In the cases the post body is an existing object, we want + // to use the smart method to create a simple object for + // for JSONification. + $parameters['postBody'] = $parameters['postBody']->toSimpleObject(); + } else if (is_object($parameters['postBody'])) { + // If the post body is another kind of object, we will try and + // wrangle it into a sensible format. + $parameters['postBody'] = + $this->convertToArrayAndStripNulls($parameters['postBody']); + } + $postBody = (array) $parameters['postBody']; + unset($parameters['postBody']); + } + + // TODO: optParams here probably should have been + // handled already - this may well be redundant code. + if (isset($parameters['optParams'])) { + $optParams = $parameters['optParams']; + unset($parameters['optParams']); + $parameters = array_merge($parameters, $optParams); + } + + if (!isset($method['parameters'])) { + $method['parameters'] = array(); + } + + $method['parameters'] = array_merge( + $this->stackParameters, + $method['parameters'] + ); + + foreach ($parameters as $key => $val) { + if ($key != 'postBody' && ! isset($method['parameters'][$key])) { + $this->client->getLogger()->error( + 'Service parameter unknown', + array( + 'service' => $this->serviceName, + 'resource' => $this->resourceName, + 'method' => $name, + 'parameter' => $key + ) + ); + throw new Google_Exception("($name) unknown parameter: '$key'"); + } + } + + foreach ($method['parameters'] as $paramName => $paramSpec) { + if (isset($paramSpec['required']) && + $paramSpec['required'] && + ! isset($parameters[$paramName]) + ) { + $this->client->getLogger()->error( + 'Service parameter missing', + array( + 'service' => $this->serviceName, + 'resource' => $this->resourceName, + 'method' => $name, + 'parameter' => $paramName + ) + ); + throw new Google_Exception("($name) missing required param: '$paramName'"); + } + if (isset($parameters[$paramName])) { + $value = $parameters[$paramName]; + $parameters[$paramName] = $paramSpec; + $parameters[$paramName]['value'] = $value; + unset($parameters[$paramName]['required']); + } else { + // Ensure we don't pass nulls. + unset($parameters[$paramName]); + } + } + + $this->client->getLogger()->info( + 'Service Call', + array( + 'service' => $this->serviceName, + 'resource' => $this->resourceName, + 'method' => $name, + 'arguments' => $parameters, + ) + ); + + // build the service uri + $url = $this->createRequestUri( + $method['path'], + $parameters + ); + + // NOTE: because we're creating the request by hand, + // and because the service has a rootUrl property + // the "base_uri" of the Http Client is not accounted for + $request = new Request( + $method['httpMethod'], + $url, + ['content-type' => 'application/json'], + $postBody ? json_encode($postBody) : '' + ); + + // support uploads + if (isset($parameters['data'])) { + $mimeType = isset($parameters['mimeType']) + ? $parameters['mimeType']['value'] + : 'application/octet-stream'; + $data = $parameters['data']['value']; + $upload = new Google_Http_MediaFileUpload($this->client, $request, $mimeType, $data); + + // pull down the modified request + $request = $upload->getRequest(); + } + + // if this is a media type, we will return the raw response + // rather than using an expected class + if (isset($parameters['alt']) && $parameters['alt']['value'] == 'media') { + $expectedClass = null; + } + + // if the client is marked for deferring, rather than + // execute the request, return the response + if ($this->client->shouldDefer()) { + // @TODO find a better way to do this + $request = $request + ->withHeader('X-Php-Expected-Class', $expectedClass); + + return $request; + } + + return $this->client->execute($request, $expectedClass); + } + + protected function convertToArrayAndStripNulls($o) + { + $o = (array) $o; + foreach ($o as $k => $v) { + if ($v === null) { + unset($o[$k]); + } elseif (is_object($v) || is_array($v)) { + $o[$k] = $this->convertToArrayAndStripNulls($o[$k]); + } + } + return $o; + } + + /** + * Parse/expand request parameters and create a fully qualified + * request uri. + * @static + * @param string $restPath + * @param array $params + * @return string $requestUrl + */ + public function createRequestUri($restPath, $params) + { + // code for leading slash + $requestUrl = $this->servicePath . $restPath; + if ($this->rootUrl) { + if ('/' !== substr($this->rootUrl, -1) && '/' !== substr($requestUrl, 0, 1)) { + $requestUrl = '/' . $requestUrl; + } + $requestUrl = $this->rootUrl . $requestUrl; + } + $uriTemplateVars = array(); + $queryVars = array(); + foreach ($params as $paramName => $paramSpec) { + if ($paramSpec['type'] == 'boolean') { + $paramSpec['value'] = $paramSpec['value'] ? 'true' : 'false'; + } + if ($paramSpec['location'] == 'path') { + $uriTemplateVars[$paramName] = $paramSpec['value']; + } else if ($paramSpec['location'] == 'query') { + if (is_array($paramSpec['value'])) { + foreach ($paramSpec['value'] as $value) { + $queryVars[] = $paramName . '=' . rawurlencode(rawurldecode($value)); + } + } else { + $queryVars[] = $paramName . '=' . rawurlencode(rawurldecode($paramSpec['value'])); + } + } + } + + if (count($uriTemplateVars)) { + $uriTemplateParser = new Google_Utils_UriTemplate(); + $requestUrl = $uriTemplateParser->parse($requestUrl, $uriTemplateVars); + } + + if (count($queryVars)) { + $requestUrl .= '?' . implode($queryVars, '&'); + } + + return $requestUrl; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Task/Exception.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Task/Exception.php new file mode 100644 index 0000000..5422e6f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Task/Exception.php @@ -0,0 +1,20 @@ + self::TASK_RETRY_ALWAYS, + '503' => self::TASK_RETRY_ALWAYS, + 'rateLimitExceeded' => self::TASK_RETRY_ALWAYS, + 'userRateLimitExceeded' => self::TASK_RETRY_ALWAYS, + 6 => self::TASK_RETRY_ALWAYS, // CURLE_COULDNT_RESOLVE_HOST + 7 => self::TASK_RETRY_ALWAYS, // CURLE_COULDNT_CONNECT + 28 => self::TASK_RETRY_ALWAYS, // CURLE_OPERATION_TIMEOUTED + 35 => self::TASK_RETRY_ALWAYS, // CURLE_SSL_CONNECT_ERROR + 52 => self::TASK_RETRY_ALWAYS // CURLE_GOT_NOTHING + ]; + + /** + * Creates a new task runner with exponential backoff support. + * + * @param array $config The task runner config + * @param string $name The name of the current task (used for logging) + * @param callable $action The task to run and possibly retry + * @param array $arguments The task arguments + * @throws Google_Task_Exception when misconfigured + */ + public function __construct( + $config, + $name, + $action, + array $arguments = array() + ) { + if (isset($config['initial_delay'])) { + if ($config['initial_delay'] < 0) { + throw new Google_Task_Exception( + 'Task configuration `initial_delay` must not be negative.' + ); + } + + $this->delay = $config['initial_delay']; + } + + if (isset($config['max_delay'])) { + if ($config['max_delay'] <= 0) { + throw new Google_Task_Exception( + 'Task configuration `max_delay` must be greater than 0.' + ); + } + + $this->maxDelay = $config['max_delay']; + } + + if (isset($config['factor'])) { + if ($config['factor'] <= 0) { + throw new Google_Task_Exception( + 'Task configuration `factor` must be greater than 0.' + ); + } + + $this->factor = $config['factor']; + } + + if (isset($config['jitter'])) { + if ($config['jitter'] <= 0) { + throw new Google_Task_Exception( + 'Task configuration `jitter` must be greater than 0.' + ); + } + + $this->jitter = $config['jitter']; + } + + if (isset($config['retries'])) { + if ($config['retries'] < 0) { + throw new Google_Task_Exception( + 'Task configuration `retries` must not be negative.' + ); + } + $this->maxAttempts += $config['retries']; + } + + if (!is_callable($action)) { + throw new Google_Task_Exception( + 'Task argument `$action` must be a valid callable.' + ); + } + + $this->action = $action; + $this->arguments = $arguments; + } + + /** + * Checks if a retry can be attempted. + * + * @return boolean + */ + public function canAttempt() + { + return $this->attempts < $this->maxAttempts; + } + + /** + * Runs the task and (if applicable) automatically retries when errors occur. + * + * @return mixed + * @throws Google_Task_Retryable on failure when no retries are available. + */ + public function run() + { + while ($this->attempt()) { + try { + return call_user_func_array($this->action, $this->arguments); + } catch (Google_Service_Exception $exception) { + $allowedRetries = $this->allowedRetries( + $exception->getCode(), + $exception->getErrors() + ); + + if (!$this->canAttempt() || !$allowedRetries) { + throw $exception; + } + + if ($allowedRetries > 0) { + $this->maxAttempts = min( + $this->maxAttempts, + $this->attempts + $allowedRetries + ); + } + } + } + } + + /** + * Runs a task once, if possible. This is useful for bypassing the `run()` + * loop. + * + * NOTE: If this is not the first attempt, this function will sleep in + * accordance to the backoff configurations before running the task. + * + * @return boolean + */ + public function attempt() + { + if (!$this->canAttempt()) { + return false; + } + + if ($this->attempts > 0) { + $this->backOff(); + } + + $this->attempts++; + return true; + } + + /** + * Sleeps in accordance to the backoff configurations. + */ + private function backOff() + { + $delay = $this->getDelay(); + + usleep($delay * 1000000); + } + + /** + * Gets the delay (in seconds) for the current backoff period. + * + * @return float + */ + private function getDelay() + { + $jitter = $this->getJitter(); + $factor = $this->attempts > 1 ? $this->factor + $jitter : 1 + abs($jitter); + + return $this->delay = min($this->maxDelay, $this->delay * $factor); + } + + /** + * Gets the current jitter (random number between -$this->jitter and + * $this->jitter). + * + * @return float + */ + private function getJitter() + { + return $this->jitter * 2 * mt_rand() / mt_getrandmax() - $this->jitter; + } + + /** + * Gets the number of times the associated task can be retried. + * + * NOTE: -1 is returned if the task can be retried indefinitely + * + * @return integer + */ + public function allowedRetries($code, $errors = array()) + { + if (isset($this->retryMap[$code])) { + return $this->retryMap[$code]; + } + + if ( + !empty($errors) && + isset($errors[0]['reason'], $this->retryMap[$errors[0]['reason']]) + ) { + return $this->retryMap[$errors[0]['reason']]; + } + + return 0; + } + + public function setRetryMap($retryMap) + { + $this->retryMap = $retryMap; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Utils/UriTemplate.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Utils/UriTemplate.php new file mode 100644 index 0000000..e59fe9f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/Utils/UriTemplate.php @@ -0,0 +1,333 @@ + "reserved", + "/" => "segments", + "." => "dotprefix", + "#" => "fragment", + ";" => "semicolon", + "?" => "form", + "&" => "continuation" + ); + + /** + * @var reserved array + * These are the characters which should not be URL encoded in reserved + * strings. + */ + private $reserved = array( + "=", ",", "!", "@", "|", ":", "/", "?", "#", + "[", "]",'$', "&", "'", "(", ")", "*", "+", ";" + ); + private $reservedEncoded = array( + "%3D", "%2C", "%21", "%40", "%7C", "%3A", "%2F", "%3F", + "%23", "%5B", "%5D", "%24", "%26", "%27", "%28", "%29", + "%2A", "%2B", "%3B" + ); + + public function parse($string, array $parameters) + { + return $this->resolveNextSection($string, $parameters); + } + + /** + * This function finds the first matching {...} block and + * executes the replacement. It then calls itself to find + * subsequent blocks, if any. + */ + private function resolveNextSection($string, $parameters) + { + $start = strpos($string, "{"); + if ($start === false) { + return $string; + } + $end = strpos($string, "}"); + if ($end === false) { + return $string; + } + $string = $this->replace($string, $start, $end, $parameters); + return $this->resolveNextSection($string, $parameters); + } + + private function replace($string, $start, $end, $parameters) + { + // We know a data block will have {} round it, so we can strip that. + $data = substr($string, $start + 1, $end - $start - 1); + + // If the first character is one of the reserved operators, it effects + // the processing of the stream. + if (isset($this->operators[$data[0]])) { + $op = $this->operators[$data[0]]; + $data = substr($data, 1); + $prefix = ""; + $prefix_on_missing = false; + + switch ($op) { + case "reserved": + // Reserved means certain characters should not be URL encoded + $data = $this->replaceVars($data, $parameters, ",", null, true); + break; + case "fragment": + // Comma separated with fragment prefix. Bare values only. + $prefix = "#"; + $prefix_on_missing = true; + $data = $this->replaceVars($data, $parameters, ",", null, true); + break; + case "segments": + // Slash separated data. Bare values only. + $prefix = "/"; + $data =$this->replaceVars($data, $parameters, "/"); + break; + case "dotprefix": + // Dot separated data. Bare values only. + $prefix = "."; + $prefix_on_missing = true; + $data = $this->replaceVars($data, $parameters, "."); + break; + case "semicolon": + // Semicolon prefixed and separated. Uses the key name + $prefix = ";"; + $data = $this->replaceVars($data, $parameters, ";", "=", false, true, false); + break; + case "form": + // Standard URL format. Uses the key name + $prefix = "?"; + $data = $this->replaceVars($data, $parameters, "&", "="); + break; + case "continuation": + // Standard URL, but with leading ampersand. Uses key name. + $prefix = "&"; + $data = $this->replaceVars($data, $parameters, "&", "="); + break; + } + + // Add the initial prefix character if data is valid. + if ($data || ($data !== false && $prefix_on_missing)) { + $data = $prefix . $data; + } + + } else { + // If no operator we replace with the defaults. + $data = $this->replaceVars($data, $parameters); + } + // This is chops out the {...} and replaces with the new section. + return substr($string, 0, $start) . $data . substr($string, $end + 1); + } + + private function replaceVars( + $section, + $parameters, + $sep = ",", + $combine = null, + $reserved = false, + $tag_empty = false, + $combine_on_empty = true + ) { + if (strpos($section, ",") === false) { + // If we only have a single value, we can immediately process. + return $this->combine( + $section, + $parameters, + $sep, + $combine, + $reserved, + $tag_empty, + $combine_on_empty + ); + } else { + // If we have multiple values, we need to split and loop over them. + // Each is treated individually, then glued together with the + // separator character. + $vars = explode(",", $section); + return $this->combineList( + $vars, + $sep, + $parameters, + $combine, + $reserved, + false, // Never emit empty strings in multi-param replacements + $combine_on_empty + ); + } + } + + public function combine( + $key, + $parameters, + $sep, + $combine, + $reserved, + $tag_empty, + $combine_on_empty + ) { + $length = false; + $explode = false; + $skip_final_combine = false; + $value = false; + + // Check for length restriction. + if (strpos($key, ":") !== false) { + list($key, $length) = explode(":", $key); + } + + // Check for explode parameter. + if ($key[strlen($key) - 1] == "*") { + $explode = true; + $key = substr($key, 0, -1); + $skip_final_combine = true; + } + + // Define the list separator. + $list_sep = $explode ? $sep : ","; + + if (isset($parameters[$key])) { + $data_type = $this->getDataType($parameters[$key]); + switch ($data_type) { + case self::TYPE_SCALAR: + $value = $this->getValue($parameters[$key], $length); + break; + case self::TYPE_LIST: + $values = array(); + foreach ($parameters[$key] as $pkey => $pvalue) { + $pvalue = $this->getValue($pvalue, $length); + if ($combine && $explode) { + $values[$pkey] = $key . $combine . $pvalue; + } else { + $values[$pkey] = $pvalue; + } + } + $value = implode($list_sep, $values); + if ($value == '') { + return ''; + } + break; + case self::TYPE_MAP: + $values = array(); + foreach ($parameters[$key] as $pkey => $pvalue) { + $pvalue = $this->getValue($pvalue, $length); + if ($explode) { + $pkey = $this->getValue($pkey, $length); + $values[] = $pkey . "=" . $pvalue; // Explode triggers = combine. + } else { + $values[] = $pkey; + $values[] = $pvalue; + } + } + $value = implode($list_sep, $values); + if ($value == '') { + return false; + } + break; + } + } else if ($tag_empty) { + // If we are just indicating empty values with their key name, return that. + return $key; + } else { + // Otherwise we can skip this variable due to not being defined. + return false; + } + + if ($reserved) { + $value = str_replace($this->reservedEncoded, $this->reserved, $value); + } + + // If we do not need to include the key name, we just return the raw + // value. + if (!$combine || $skip_final_combine) { + return $value; + } + + // Else we combine the key name: foo=bar, if value is not the empty string. + return $key . ($value != '' || $combine_on_empty ? $combine . $value : ''); + } + + /** + * Return the type of a passed in value + */ + private function getDataType($data) + { + if (is_array($data)) { + reset($data); + if (key($data) !== 0) { + return self::TYPE_MAP; + } + return self::TYPE_LIST; + } + return self::TYPE_SCALAR; + } + + /** + * Utility function that merges multiple combine calls + * for multi-key templates. + */ + private function combineList( + $vars, + $sep, + $parameters, + $combine, + $reserved, + $tag_empty, + $combine_on_empty + ) { + $ret = array(); + foreach ($vars as $var) { + $response = $this->combine( + $var, + $parameters, + $sep, + $combine, + $reserved, + $tag_empty, + $combine_on_empty + ); + if ($response === false) { + continue; + } + $ret[] = $response; + } + return implode($sep, $ret); + } + + /** + * Utility function to encode and trim values + */ + private function getValue($value, $length) + { + if ($length) { + $value = substr($value, 0, $length); + } + $value = rawurlencode($value); + return $value; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/autoload.php b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/autoload.php new file mode 100644 index 0000000..8b49301 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/apiclient/src/Google/autoload.php @@ -0,0 +1,21 @@ +exclude('vendor') + ->in(__DIR__); + +// Return a Code Sniffing configuration using +// all sniffers needed for PSR-2 +// and additionally: +// - Remove leading slashes in use clauses. +// - PHP single-line arrays should not have trailing comma. +// - Single-line whitespace before closing semicolon are prohibited. +// - Remove unused use statements in the PHP source code +// - Ensure Concatenation to have at least one whitespace around +// - Remove trailing whitespace at the end of blank lines. +return Symfony\CS\Config\Config::create() + ->level(Symfony\CS\FixerInterface::PSR2_LEVEL) + ->fixers([ + 'remove_leading_slash_use', + 'single_array_no_trailing_comma', + 'spaces_before_semicolon', + 'unused_use', + 'concat_with_spaces', + 'whitespacy_lines', + 'ordered_use', + 'single_quote', + 'duplicate_semicolon', + 'extra_empty_lines', + 'phpdoc_no_package', + 'phpdoc_scalar', + 'no_empty_lines_after_phpdocs' + ]) + ->finder($finder); diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/.travis.yml b/Postman/Postman-Mail/google-api-client/vendor/google/auth/.travis.yml new file mode 100644 index 0000000..8c1b058 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/.travis.yml @@ -0,0 +1,32 @@ +language: php + +branches: + only: [master] + +sudo: false + +php: + - 5.4 + - 5.5 + - 5.6 + - 7.0 + - 7.1 + - 7.2 + +env: + - + - COMPOSER_ARGS="--prefer-lowest" +matrix: + include: + - php: "7.2" + env: RUN_CS_FIXER=true + +before_script: + - composer update $COMPOSER_ARGS + +script: + - if [ "${RUN_CS_FIXER}" = "true" ]; then + vendor/bin/php-cs-fixer fix --dry-run --diff --config-file=.php_cs .; + else + vendor/bin/phpunit; + fi diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/COPYING b/Postman/Postman-Mail/google-api-client/vendor/google/auth/COPYING new file mode 100644 index 0000000..b5d5055 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/COPYING @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2015 Google Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/google/auth/LICENSE new file mode 100644 index 0000000..a148ba5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/LICENSE @@ -0,0 +1,203 @@ +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, +and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by +the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all +other entities that control, are controlled by, or are under common +control with that entity. For the purposes of this definition, +"control" means (i) the power, direct or indirect, to cause the +direction or management of such entity, whether by contract or +otherwise, or (ii) ownership of fifty percent (50%) or more of the +outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity +exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, +including but not limited to software source code, documentation +source, and configuration files. + +"Object" form shall mean any form resulting from mechanical +transformation or translation of a Source form, including but +not limited to compiled object code, generated documentation, +and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or +Object form, made available under the License, as indicated by a +copyright notice that is included in or attached to the work +(an example is provided in the Appendix below). + +"Derivative Works" shall mean any work, whether in Source or Object +form, that is based on (or derived from) the Work and for which the +editorial revisions, annotations, elaborations, or other modifications +represent, as a whole, an original work of authorship. For the purposes +of this License, Derivative Works shall not include works that remain +separable from, or merely link (or bind by name) to the interfaces of, +the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including +the original version of the Work and any modifications or additions +to that Work or Derivative Works thereof, that is intentionally +submitted to Licensor for inclusion in the Work by the copyright owner +or by an individual or Legal Entity authorized to submit on behalf of +the copyright owner. For the purposes of this definition, "submitted" +means any form of electronic, verbal, or written communication sent +to the Licensor or its representatives, including but not limited to +communication on electronic mailing lists, source code control systems, +and issue tracking systems that are managed by, or on behalf of, the +Licensor for the purpose of discussing and improving the Work, but +excluding communication that is conspicuously marked or otherwise +designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity +on behalf of whom a Contribution has been received by Licensor and +subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +copyright license to reproduce, prepare Derivative Works of, +publicly display, publicly perform, sublicense, and distribute the +Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +(except as stated in this section) patent license to make, have made, +use, offer to sell, sell, import, and otherwise transfer the Work, +where such license applies only to those patent claims licensable +by such Contributor that are necessarily infringed by their +Contribution(s) alone or by combination of their Contribution(s) +with the Work to which such Contribution(s) was submitted. If You +institute patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Work +or a Contribution incorporated within the Work constitutes direct +or contributory patent infringement, then any patent licenses +granted to You under this License for that Work shall terminate +as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the +Work or Derivative Works thereof in any medium, with or without +modifications, and in Source or Object form, provided that You +meet the following conditions: + +(a) You must give any other recipients of the Work or +Derivative Works a copy of this License; and + +(b) You must cause any modified files to carry prominent notices +stating that You changed the files; and + +(c) You must retain, in the Source form of any Derivative Works +that You distribute, all copyright, patent, trademark, and +attribution notices from the Source form of the Work, +excluding those notices that do not pertain to any part of +the Derivative Works; and + +(d) If the Work includes a "NOTICE" text file as part of its +distribution, then any Derivative Works that You distribute must +include a readable copy of the attribution notices contained +within such NOTICE file, excluding those notices that do not +pertain to any part of the Derivative Works, in at least one +of the following places: within a NOTICE text file distributed +as part of the Derivative Works; within the Source form or +documentation, if provided along with the Derivative Works; or, +within a display generated by the Derivative Works, if and +wherever such third-party notices normally appear. The contents +of the NOTICE file are for informational purposes only and +do not modify the License. You may add Your own attribution +notices within Derivative Works that You distribute, alongside +or as an addendum to the NOTICE text from the Work, provided +that such additional attribution notices cannot be construed +as modifying the License. + +You may add Your own copyright statement to Your modifications and +may provide additional or different license terms and conditions +for use, reproduction, or distribution of Your modifications, or +for any such Derivative Works as a whole, provided Your use, +reproduction, and distribution of the Work otherwise complies with +the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, +any Contribution intentionally submitted for inclusion in the Work +by You to the Licensor shall be under the terms and conditions of +this License, without any additional terms or conditions. +Notwithstanding the above, nothing herein shall supersede or modify +the terms of any separate license agreement you may have executed +with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade +names, trademarks, service marks, or product names of the Licensor, +except as required for reasonable and customary use in describing the +origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or +agreed to in writing, Licensor provides the Work (and each +Contributor provides its Contributions) on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or +implied, including, without limitation, any warranties or conditions +of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A +PARTICULAR PURPOSE. You are solely responsible for determining the +appropriateness of using or redistributing the Work and assume any +risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, +whether in tort (including negligence), contract, or otherwise, +unless required by applicable law (such as deliberate and grossly +negligent acts) or agreed to in writing, shall any Contributor be +liable to You for damages, including any direct, indirect, special, +incidental, or consequential damages of any character arising as a +result of this License or out of the use or inability to use the +Work (including but not limited to damages for loss of goodwill, +work stoppage, computer failure or malfunction, or any and all +other commercial damages or losses), even if such Contributor +has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing +the Work or Derivative Works thereof, You may choose to offer, +and charge a fee for, acceptance of support, warranty, indemnity, +or other liability obligations and/or rights consistent with this +License. However, in accepting such obligations, You may act only +on Your own behalf and on Your sole responsibility, not on behalf +of any other Contributor, and only if You agree to indemnify, +defend, and hold each Contributor harmless for any liability +incurred by, or claims asserted against, such Contributor by reason +of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. + +To apply the Apache License to your work, attach the following +boilerplate notice, with the fields enclosed by brackets "[]" +replaced with your own identifying information. (Don't include +the brackets!) The text should be enclosed in the appropriate +comment syntax for the file format. We also recommend that a +file or class name and description of purpose be included on the +same "printed page" as the copyright notice for easier +identification within third-party archives. + +Copyright [yyyy] [name of copyright owner] + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + + diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/README.md b/Postman/Postman-Mail/google-api-client/vendor/google/auth/README.md new file mode 100644 index 0000000..d102382 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/README.md @@ -0,0 +1,150 @@ +# Google Auth Library for PHP + +
    +
    Homepage
    http://www.github.com/google/google-auth-library-php
    +
    Authors
    +
    Tim Emiola
    +
    Stanley Cheung
    +
    Brent Shaffer
    +
    Copyright
    Copyright © 2015 Google, Inc.
    +
    License
    Apache 2.0
    +
    + +## Description + +This is Google's officially supported PHP client library for using OAuth 2.0 +authorization and authentication with Google APIs. + +### Installing via Composer + +The recommended way to install the google auth library is through +[Composer](http://getcomposer.org). + +```bash +# Install Composer +curl -sS https://getcomposer.org/installer | php +``` + +Next, run the Composer command to install the latest stable version: + +```bash +composer.phar require google/auth +``` + +## Application Default Credentials + +This library provides an implementation of +[application default credentials][application default credentials] for PHP. + +The Application Default Credentials provide a simple way to get authorization +credentials for use in calling Google APIs. + +They are best suited for cases when the call needs to have the same identity +and authorization level for the application independent of the user. This is +the recommended approach to authorize calls to Cloud APIs, particularly when +you're building an application that uses Google Compute Engine. + +#### Download your Service Account Credentials JSON file + +To use `Application Default Credentials`, You first need to download a set of +JSON credentials for your project. Go to **APIs & Auth** > **Credentials** in +the [Google Developers Console][developer console] and select +**Service account** from the **Add credentials** dropdown. + +> This file is your *only copy* of these credentials. It should never be +> committed with your source code, and should be stored securely. + +Once downloaded, store the path to this file in the +`GOOGLE_APPLICATION_CREDENTIALS` environment variable. + +```php +putenv('GOOGLE_APPLICATION_CREDENTIALS=/path/to/my/credentials.json'); +``` + +> PHP's `putenv` function is just one way to set an environment variable. +> Consider using `.htaccess` or apache configuration files as well. + +#### Enable the API you want to use + +Before making your API call, you must be sure the API you're calling has been +enabled. Go to **APIs & Auth** > **APIs** in the +[Google Developers Console][developer console] and enable the APIs you'd like to +call. For the example below, you must enable the `Drive API`. + +#### Call the APIs + +As long as you update the environment variable below to point to *your* JSON +credentials file, the following code should output a list of your Drive files. + +```php +use Google\Auth\ApplicationDefaultCredentials; +use GuzzleHttp\Client; +use GuzzleHttp\HandlerStack; + +// specify the path to your application credentials +putenv('GOOGLE_APPLICATION_CREDENTIALS=/path/to/my/credentials.json'); + +// define the scopes for your API call +$scopes = ['https://www.googleapis.com/auth/drive.readonly']; + +// create middleware +$middleware = ApplicationDefaultCredentials::getMiddleware($scopes); +$stack = HandlerStack::create(); +$stack->push($middleware); + +// create the HTTP client +$client = new Client([ + 'handler' => $stack, + 'base_uri' => 'https://www.googleapis.com', + 'auth' => 'google_auth' // authorize all requests +]); + +// make the request +$response = $client->get('drive/v2/files'); + +// show the result! +print_r((string) $response->getBody()); +``` + +##### Guzzle 5 Compatibility + +If you are using [Guzzle 5][Guzzle 5], replace the `create middleware` and +`create the HTTP Client` steps with the following: + +```php +// create the HTTP client +$client = new Client([ + 'base_url' => 'https://www.googleapis.com', + 'auth' => 'google_auth' // authorize all requests +]); + +// create subscriber +$subscriber = ApplicationDefaultCredentials::getSubscriber($scopes); +$client->getEmitter()->attach($subscriber); + +``` + +## License + +This library is licensed under Apache 2.0. Full license text is +available in [COPYING][copying]. + +## Contributing + +See [CONTRIBUTING][contributing]. + +## Support + +Please +[report bugs at the project on Github](https://github.com/google/google-auth-library-php/issues). Don't +hesitate to +[ask questions](http://stackoverflow.com/questions/tagged/google-auth-library-php) +about the client or APIs on [StackOverflow](http://stackoverflow.com). + +[google-apis-php-client]: https://github.com/google/google-api-php-client +[application default credentials]: https://developers.google.com/accounts/docs/application-default-credentials +[contributing]: https://github.com/google/google-auth-library-php/tree/master/CONTRIBUTING.md +[copying]: https://github.com/google/google-auth-library-php/tree/master/COPYING +[Guzzle]: https://github.com/guzzle/guzzle +[Guzzle 5]: http://docs.guzzlephp.org/en/5.3 +[developer console]: https://console.developers.google.com diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/autoload.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/autoload.php new file mode 100644 index 0000000..f547337 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/autoload.php @@ -0,0 +1,34 @@ + 3) { + // Maximum class file path depth in this project is 3. + $classPath = array_slice($classPath, 0, 3); + } + $filePath = dirname(__FILE__) . '/src/' . implode('/', $classPath) . '.php'; + if (file_exists($filePath)) { + require_once $filePath; + } +} + +spl_autoload_register('oauth2client_php_autoload'); diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/composer.json b/Postman/Postman-Mail/google-api-client/vendor/google/auth/composer.json new file mode 100644 index 0000000..0e13606 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/composer.json @@ -0,0 +1,27 @@ +{ + "name": "google/auth", + "type": "library", + "description": "Google Auth Library for PHP", + "keywords": ["google", "oauth2", "authentication"], + "homepage": "http://github.com/google/google-auth-library-php", + "license": "Apache-2.0", + "require": { + "php": ">=5.4", + "firebase/php-jwt": "~2.0|~3.0|~4.0|~5.0", + "guzzlehttp/guzzle": "~5.3.1|~6.0", + "guzzlehttp/psr7": "~1.2", + "psr/http-message": "^1.0", + "psr/cache": "^1.0" + }, + "require-dev": { + "guzzlehttp/promises": "0.1.1|^1.3", + "friendsofphp/php-cs-fixer": "^1.11", + "phpunit/phpunit": "^4.8.36|^5.7", + "sebastian/comparator": ">=1.2.3" + }, + "autoload": { + "psr-4": { + "Google\\Auth\\": "src" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/ApplicationDefaultCredentials.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/ApplicationDefaultCredentials.php new file mode 100644 index 0000000..6465bdc --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/ApplicationDefaultCredentials.php @@ -0,0 +1,173 @@ +push($middleware); + * + * $client = new Client([ + * 'handler' => $stack, + * 'base_uri' => 'https://www.googleapis.com/taskqueue/v1beta2/projects/', + * 'auth' => 'google_auth' // authorize all requests + * ]); + * + * $res = $client->get('myproject/taskqueues/myqueue'); + */ +class ApplicationDefaultCredentials +{ + /** + * Obtains an AuthTokenSubscriber that uses the default FetchAuthTokenInterface + * implementation to use in this environment. + * + * If supplied, $scope is used to in creating the credentials instance if + * this does not fallback to the compute engine defaults. + * + * @param string|array scope the scope of the access request, expressed + * either as an Array or as a space-delimited String. + * @param callable $httpHandler callback which delivers psr7 request + * @param array $cacheConfig configuration for the cache when it's present + * @param CacheItemPoolInterface $cache an implementation of CacheItemPoolInterface + * + * @return AuthTokenSubscriber + * + * @throws DomainException if no implementation can be obtained. + */ + public static function getSubscriber( + $scope = null, + callable $httpHandler = null, + array $cacheConfig = null, + CacheItemPoolInterface $cache = null + ) { + $creds = self::getCredentials($scope, $httpHandler, $cacheConfig, $cache); + + return new AuthTokenSubscriber($creds, $httpHandler); + } + + /** + * Obtains an AuthTokenMiddleware that uses the default FetchAuthTokenInterface + * implementation to use in this environment. + * + * If supplied, $scope is used to in creating the credentials instance if + * this does not fallback to the compute engine defaults. + * + * @param string|array scope the scope of the access request, expressed + * either as an Array or as a space-delimited String. + * @param callable $httpHandler callback which delivers psr7 request + * @param array $cacheConfig configuration for the cache when it's present + * @param CacheItemPoolInterface $cache + * + * @return AuthTokenMiddleware + * + * @throws DomainException if no implementation can be obtained. + */ + public static function getMiddleware( + $scope = null, + callable $httpHandler = null, + array $cacheConfig = null, + CacheItemPoolInterface $cache = null + ) { + $creds = self::getCredentials($scope, $httpHandler, $cacheConfig, $cache); + + return new AuthTokenMiddleware($creds, $httpHandler); + } + + /** + * Obtains the default FetchAuthTokenInterface implementation to use + * in this environment. + * + * If supplied, $scope is used to in creating the credentials instance if + * this does not fallback to the Compute Engine defaults. + * + * @param string|array scope the scope of the access request, expressed + * either as an Array or as a space-delimited String. + * @param callable $httpHandler callback which delivers psr7 request + * @param array $cacheConfig configuration for the cache when it's present + * @param CacheItemPoolInterface $cache + * + * @return CredentialsLoader + * + * @throws DomainException if no implementation can be obtained. + */ + public static function getCredentials( + $scope = null, + callable $httpHandler = null, + array $cacheConfig = null, + CacheItemPoolInterface $cache = null + ) { + $creds = null; + $jsonKey = CredentialsLoader::fromEnv() + ?: CredentialsLoader::fromWellKnownFile(); + + if (!is_null($jsonKey)) { + $creds = CredentialsLoader::makeCredentials($scope, $jsonKey); + } elseif (AppIdentityCredentials::onAppEngine() && !GCECredentials::onAppEngineFlexible()) { + $creds = new AppIdentityCredentials($scope); + } elseif (GCECredentials::onGce($httpHandler)) { + $creds = new GCECredentials(); + } + + if (is_null($creds)) { + throw new \DomainException(self::notFound()); + } + if (!is_null($cache)) { + $creds = new FetchAuthTokenCache($creds, $cacheConfig, $cache); + } + return $creds; + } + + private static function notFound() + { + $msg = 'Could not load the default credentials. Browse to '; + $msg .= 'https://developers.google.com'; + $msg .= '/accounts/docs/application-default-credentials'; + $msg .= ' for more information'; + + return $msg; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/InvalidArgumentException.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/InvalidArgumentException.php new file mode 100644 index 0000000..331e561 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/InvalidArgumentException.php @@ -0,0 +1,24 @@ +key = $key; + } + + /** + * {@inheritdoc} + */ + public function getKey() + { + return $this->key; + } + + /** + * {@inheritdoc} + */ + public function get() + { + return $this->isHit() ? $this->value : null; + } + + /** + * {@inheritdoc} + */ + public function isHit() + { + if (!$this->isHit) { + return false; + } + + if ($this->expiration === null) { + return true; + } + + return new \DateTime() < $this->expiration; + } + + /** + * {@inheritdoc} + */ + public function set($value) + { + $this->isHit = true; + $this->value = $value; + + return $this; + } + + /** + * {@inheritdoc} + */ + public function expiresAt($expiration) + { + if ($this->isValidExpiration($expiration)) { + $this->expiration = $expiration; + + return $this; + } + + $implementationMessage = interface_exists('DateTimeInterface') + ? 'implement interface DateTimeInterface' + : 'be an instance of DateTime'; + + $error = sprintf( + 'Argument 1 passed to %s::expiresAt() must %s, %s given', + get_class($this), + $implementationMessage, + gettype($expiration) + ); + + $this->handleError($error); + } + + /** + * {@inheritdoc} + */ + public function expiresAfter($time) + { + if (is_int($time)) { + $this->expiration = new \DateTime("now + $time seconds"); + } elseif ($time instanceof \DateInterval) { + $this->expiration = (new \DateTime())->add($time); + } elseif ($time === null) { + $this->expiration = $time; + } else { + $message = 'Argument 1 passed to %s::expiresAfter() must be an ' . + 'instance of DateInterval or of the type integer, %s given'; + $error = sprintf($message, get_class($this), gettype($time)); + + $this->handleError($error); + } + + return $this; + } + + /** + * Handles an error. + * + * @param string $error + * @throws \TypeError + */ + private function handleError($error) + { + if (class_exists('TypeError')) { + throw new \TypeError($error); + } + + trigger_error($error, E_USER_ERROR); + } + + /** + * Determines if an expiration is valid based on the rules defined by PSR6. + * + * @param mixed $expiration + * @return bool + */ + private function isValidExpiration($expiration) + { + if ($expiration === null) { + return true; + } + + // We test for two types here due to the fact the DateTimeInterface + // was not introduced until PHP 5.5. Checking for the DateTime type as + // well allows us to support 5.4. + if ($expiration instanceof \DateTimeInterface) { + return true; + } + + if ($expiration instanceof \DateTime) { + return true; + } + + return false; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/MemoryCacheItemPool.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/MemoryCacheItemPool.php new file mode 100644 index 0000000..0af2930 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Cache/MemoryCacheItemPool.php @@ -0,0 +1,154 @@ +getItems([$key])); + } + + /** + * {@inheritdoc} + */ + public function getItems(array $keys = []) + { + $items = []; + + foreach ($keys as $key) { + $items[$key] = $this->hasItem($key) ? clone $this->items[$key] : new Item($key); + } + + return $items; + } + + /** + * {@inheritdoc} + */ + public function hasItem($key) + { + $this->isValidKey($key); + + return isset($this->items[$key]) && $this->items[$key]->isHit(); + } + + /** + * {@inheritdoc} + */ + public function clear() + { + $this->items = []; + $this->deferredItems = []; + + return true; + } + + /** + * {@inheritdoc} + */ + public function deleteItem($key) + { + return $this->deleteItems([$key]); + } + + /** + * {@inheritdoc} + */ + public function deleteItems(array $keys) + { + array_walk($keys, [$this, 'isValidKey']); + + foreach ($keys as $key) { + unset($this->items[$key]); + } + + return true; + } + + /** + * {@inheritdoc} + */ + public function save(CacheItemInterface $item) + { + $this->items[$item->getKey()] = $item; + + return true; + } + + /** + * {@inheritdoc} + */ + public function saveDeferred(CacheItemInterface $item) + { + $this->deferredItems[$item->getKey()] = $item; + + return true; + } + + /** + * {@inheritdoc} + */ + public function commit() + { + foreach ($this->deferredItems as $item) { + $this->save($item); + } + + $this->deferredItems = []; + + return true; + } + + /** + * Determines if the provided key is valid. + * + * @param string $key + * @return bool + * @throws InvalidArgumentException + */ + private function isValidKey($key) + { + $invalidCharacters = '{}()/\\\\@:'; + + if (!is_string($key) || preg_match("#[$invalidCharacters]#", $key)) { + throw new InvalidArgumentException('The provided key is not valid: ' . var_export($key, true)); + } + + return true; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/CacheTrait.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/CacheTrait.php new file mode 100644 index 0000000..217ce8e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/CacheTrait.php @@ -0,0 +1,83 @@ +cache)) { + return; + } + + $key = $this->getFullCacheKey($k); + if (is_null($key)) { + return; + } + + $cacheItem = $this->cache->getItem($key); + if ($cacheItem->isHit()) { + return $cacheItem->get(); + } + } + + /** + * Saves the value in the cache when that is available. + */ + private function setCachedValue($k, $v) + { + if (is_null($this->cache)) { + return; + } + + $key = $this->getFullCacheKey($k); + if (is_null($key)) { + return; + } + + $cacheItem = $this->cache->getItem($key); + $cacheItem->set($v); + $cacheItem->expiresAfter($this->cacheConfig['lifetime']); + return $this->cache->save($cacheItem); + } + + private function getFullCacheKey($key) + { + if (is_null($key)) { + return; + } + + $key = $this->cacheConfig['prefix'] . $key; + + // ensure we do not have illegal characters + $key = preg_replace('|[^a-zA-Z0-9_\.!]|', '', $key); + + // Hash keys if they exceed $maxKeyLength (defaults to 64) + if ($this->maxKeyLength && strlen($key) > $this->maxKeyLength) { + $key = substr(hash('sha256', $key), 0, $this->maxKeyLength); + } + + return $key; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/AppIdentityCredentials.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/AppIdentityCredentials.php new file mode 100644 index 0000000..d0ba703 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/AppIdentityCredentials.php @@ -0,0 +1,159 @@ +push($middleware); + * + * $client = new Client([ + * 'handler' => $stack, + * 'base_uri' => 'https://www.googleapis.com/books/v1', + * 'auth' => 'google_auth' + * ]); + * + * $res = $client->get('volumes?q=Henry+David+Thoreau&country=US'); + */ +class AppIdentityCredentials extends CredentialsLoader +{ + /** + * Result of fetchAuthToken. + * + * @array + */ + protected $lastReceivedToken; + + /** + * Array of OAuth2 scopes to be requested. + */ + private $scope; + + public function __construct($scope = array()) + { + $this->scope = $scope; + } + + /** + * Determines if this an App Engine instance, by accessing the + * SERVER_SOFTWARE environment variable (prod) or the APPENGINE_RUNTIME + * environment variable (dev). + * + * @return true if this an App Engine Instance, false otherwise + */ + public static function onAppEngine() + { + $appEngineProduction = isset($_SERVER['SERVER_SOFTWARE']) && + 0 === strpos($_SERVER['SERVER_SOFTWARE'], 'Google App Engine'); + if ($appEngineProduction) { + return true; + } + $appEngineDevAppServer = isset($_SERVER['APPENGINE_RUNTIME']) && + $_SERVER['APPENGINE_RUNTIME'] == 'php'; + if ($appEngineDevAppServer) { + return true; + } + return false; + } + + /** + * Implements FetchAuthTokenInterface#fetchAuthToken. + * + * Fetches the auth tokens using the AppIdentityService if available. + * As the AppIdentityService uses protobufs to fetch the access token, + * the GuzzleHttp\ClientInterface instance passed in will not be used. + * + * @param callable $httpHandler callback which delivers psr7 request + * + * @return array the auth metadata: + * array(2) { + * ["access_token"]=> + * string(3) "xyz" + * ["expiration_time"]=> + * string(10) "1444339905" + * } + * + * @throws \Exception + */ + public function fetchAuthToken(callable $httpHandler = null) + { + if (!self::onAppEngine()) { + return array(); + } + + if (!class_exists('google\appengine\api\app_identity\AppIdentityService')) { + throw new \Exception( + 'This class must be run in App Engine, or you must include the AppIdentityService ' + . 'mock class defined in tests/mocks/AppIdentityService.php' + ); + } + + // AppIdentityService expects an array when multiple scopes are supplied + $scope = is_array($this->scope) ? $this->scope : explode(' ', $this->scope); + + $token = AppIdentityService::getAccessToken($scope); + $this->lastReceivedToken = $token; + + return $token; + } + + /** + * @return array|null + */ + public function getLastReceivedToken() + { + if ($this->lastReceivedToken) { + return [ + 'access_token' => $this->lastReceivedToken['access_token'], + 'expires_at' => $this->lastReceivedToken['expiration_time'], + ]; + } + + return null; + } + + /** + * Caching is handled by the underlying AppIdentityService, return empty string + * to prevent caching. + * + * @return string + */ + public function getCacheKey() + { + return ''; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/GCECredentials.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/GCECredentials.php new file mode 100644 index 0000000..4311529 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/GCECredentials.php @@ -0,0 +1,219 @@ +push($middleware); + * + * $client = new Client([ + * 'handler' => $stack, + * 'base_uri' => 'https://www.googleapis.com/taskqueue/v1beta2/projects/', + * 'auth' => 'google_auth' + * ]); + * + * $res = $client->get('myproject/taskqueues/myqueue'); + */ +class GCECredentials extends CredentialsLoader +{ + const cacheKey = 'GOOGLE_AUTH_PHP_GCE'; + /** + * The metadata IP address on appengine instances. + * + * The IP is used instead of the domain 'metadata' to avoid slow responses + * when not on Compute Engine. + */ + const METADATA_IP = '169.254.169.254'; + + /** + * The metadata path of the default token. + */ + const TOKEN_URI_PATH = 'v1/instance/service-accounts/default/token'; + + /** + * The header whose presence indicates GCE presence. + */ + const FLAVOR_HEADER = 'Metadata-Flavor'; + + /** + * Flag used to ensure that the onGCE test is only done once;. + * + * @var bool + */ + private $hasCheckedOnGce = false; + + /** + * Flag that stores the value of the onGCE check. + * + * @var bool + */ + private $isOnGce = false; + + /** + * Result of fetchAuthToken. + */ + protected $lastReceivedToken; + + /** + * The full uri for accessing the default token. + * + * @return string + */ + public static function getTokenUri() + { + $base = 'http://' . self::METADATA_IP . '/computeMetadata/'; + + return $base . self::TOKEN_URI_PATH; + } + + /** + * Determines if this an App Engine Flexible instance, by accessing the + * GAE_VM environment variable. + * + * @return true if this an App Engine Flexible Instance, false otherwise + */ + public static function onAppEngineFlexible() + { + return isset($_SERVER['GAE_VM']) && 'true' === $_SERVER['GAE_VM']; + } + + /** + * Determines if this a GCE instance, by accessing the expected metadata + * host. + * If $httpHandler is not specified a the default HttpHandler is used. + * + * @param callable $httpHandler callback which delivers psr7 request + * + * @return true if this a GCEInstance false otherwise + */ + public static function onGce(callable $httpHandler = null) + { + if (is_null($httpHandler)) { + $httpHandler = HttpHandlerFactory::build(); + } + $checkUri = 'http://' . self::METADATA_IP; + try { + // Comment from: oauth2client/client.py + // + // Note: the explicit `timeout` below is a workaround. The underlying + // issue is that resolving an unknown host on some networks will take + // 20-30 seconds; making this timeout short fixes the issue, but + // could lead to false negatives in the event that we are on GCE, but + // the metadata resolution was particularly slow. The latter case is + // "unlikely". + $resp = $httpHandler( + new Request('GET', $checkUri), + ['timeout' => 0.3] + ); + + return $resp->getHeaderLine(self::FLAVOR_HEADER) == 'Google'; + } catch (ClientException $e) { + return false; + } catch (ServerException $e) { + return false; + } catch (RequestException $e) { + return false; + } + } + + /** + * Implements FetchAuthTokenInterface#fetchAuthToken. + * + * Fetches the auth tokens from the GCE metadata host if it is available. + * If $httpHandler is not specified a the default HttpHandler is used. + * + * @param callable $httpHandler callback which delivers psr7 request + * + * @return array the response + * + * @throws \Exception + */ + public function fetchAuthToken(callable $httpHandler = null) + { + if (is_null($httpHandler)) { + $httpHandler = HttpHandlerFactory::build(); + } + if (!$this->hasCheckedOnGce) { + $this->isOnGce = self::onGce($httpHandler); + } + if (!$this->isOnGce) { + return array(); // return an empty array with no access token + } + $resp = $httpHandler( + new Request( + 'GET', + self::getTokenUri(), + [self::FLAVOR_HEADER => 'Google'] + ) + ); + $body = (string)$resp->getBody(); + + // Assume it's JSON; if it's not throw an exception + if (null === $json = json_decode($body, true)) { + throw new \Exception('Invalid JSON response'); + } + + // store this so we can retrieve it later + $this->lastReceivedToken = $json; + $this->lastReceivedToken['expires_at'] = time() + $json['expires_in']; + + return $json; + } + + /** + * @return string + */ + public function getCacheKey() + { + return self::cacheKey; + } + + /** + * @return array|null + */ + public function getLastReceivedToken() + { + if ($this->lastReceivedToken) { + return [ + 'access_token' => $this->lastReceivedToken['access_token'], + 'expires_at' => $this->lastReceivedToken['expires_at'], + ]; + } + + return null; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/IAMCredentials.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/IAMCredentials.php new file mode 100644 index 0000000..0d2a37d --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/IAMCredentials.php @@ -0,0 +1,89 @@ +selector = $selector; + $this->token = $token; + } + + /** + * export a callback function which updates runtime metadata. + * + * @return array updateMetadata function + */ + public function getUpdateMetadataFunc() + { + return array($this, 'updateMetadata'); + } + + /** + * Updates metadata with the appropriate header metadata. + * + * @param array $metadata metadata hashmap + * @param string $unusedAuthUri optional auth uri + * @param callable $httpHandler callback which delivers psr7 request + * Note: this param is unused here, only included here for + * consistency with other credentials class + * + * @return array updated metadata hashmap + */ + public function updateMetadata( + $metadata, + $unusedAuthUri = null, + callable $httpHandler = null + ) { + $metadata_copy = $metadata; + $metadata_copy[self::SELECTOR_KEY] = $this->selector; + $metadata_copy[self::TOKEN_KEY] = $this->token; + + return $metadata_copy; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/ServiceAccountCredentials.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/ServiceAccountCredentials.php new file mode 100644 index 0000000..db391ec --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/ServiceAccountCredentials.php @@ -0,0 +1,177 @@ +push($middleware); + * + * $client = new Client([ + * 'handler' => $stack, + * 'base_uri' => 'https://www.googleapis.com/taskqueue/v1beta2/projects/', + * 'auth' => 'google_auth' // authorize all requests + * ]); + * + * $res = $client->get('myproject/taskqueues/myqueue'); + */ +class ServiceAccountCredentials extends CredentialsLoader +{ + /** + * The OAuth2 instance used to conduct authorization. + * + * @var OAuth2 + */ + protected $auth; + + /** + * Create a new ServiceAccountCredentials. + * + * @param string|array $scope the scope of the access request, expressed + * either as an Array or as a space-delimited String. + * @param string|array $jsonKey JSON credential file path or JSON credentials + * as an associative array + * @param string $sub an email address account to impersonate, in situations when + * the service account has been delegated domain wide access. + */ + public function __construct( + $scope, + $jsonKey, + $sub = null + ) { + if (is_string($jsonKey)) { + if (!file_exists($jsonKey)) { + throw new \InvalidArgumentException('file does not exist'); + } + $jsonKeyStream = file_get_contents($jsonKey); + if (!$jsonKey = json_decode($jsonKeyStream, true)) { + throw new \LogicException('invalid json for auth config'); + } + } + if (!array_key_exists('client_email', $jsonKey)) { + throw new \InvalidArgumentException( + 'json key is missing the client_email field'); + } + if (!array_key_exists('private_key', $jsonKey)) { + throw new \InvalidArgumentException( + 'json key is missing the private_key field'); + } + $this->auth = new OAuth2([ + 'audience' => self::TOKEN_CREDENTIAL_URI, + 'issuer' => $jsonKey['client_email'], + 'scope' => $scope, + 'signingAlgorithm' => 'RS256', + 'signingKey' => $jsonKey['private_key'], + 'sub' => $sub, + 'tokenCredentialUri' => self::TOKEN_CREDENTIAL_URI, + ]); + } + + /** + * @param callable $httpHandler + * + * @return array + */ + public function fetchAuthToken(callable $httpHandler = null) + { + return $this->auth->fetchAuthToken($httpHandler); + } + + /** + * @return string + */ + public function getCacheKey() + { + $key = $this->auth->getIssuer() . ':' . $this->auth->getCacheKey(); + if ($sub = $this->auth->getSub()) { + $key .= ':' . $sub; + } + + return $key; + } + + /** + * @return array + */ + public function getLastReceivedToken() + { + return $this->auth->getLastReceivedToken(); + } + + /** + * Updates metadata with the authorization token. + * + * @param array $metadata metadata hashmap + * @param string $authUri optional auth uri + * @param callable $httpHandler callback which delivers psr7 request + * + * @return array updated metadata hashmap + */ + public function updateMetadata( + $metadata, + $authUri = null, + callable $httpHandler = null + ) { + // scope exists. use oauth implementation + $scope = $this->auth->getScope(); + if (!is_null($scope)) { + return parent::updateMetadata($metadata, $authUri, $httpHandler); + } + + // no scope found. create jwt with the auth uri + $credJson = array( + 'private_key' => $this->auth->getSigningKey(), + 'client_email' => $this->auth->getIssuer(), + ); + $jwtCreds = new ServiceAccountJwtAccessCredentials($credJson); + + return $jwtCreds->updateMetadata($metadata, $authUri, $httpHandler); + } + + /** + * @param string $sub an email address account to impersonate, in situations when + * the service account has been delegated domain wide access. + */ + public function setSub($sub) + { + $this->auth->setSub($sub); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/ServiceAccountJwtAccessCredentials.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/ServiceAccountJwtAccessCredentials.php new file mode 100644 index 0000000..28cc709 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/ServiceAccountJwtAccessCredentials.php @@ -0,0 +1,131 @@ +auth = new OAuth2([ + 'issuer' => $jsonKey['client_email'], + 'sub' => $jsonKey['client_email'], + 'signingAlgorithm' => 'RS256', + 'signingKey' => $jsonKey['private_key'], + ]); + } + + /** + * Updates metadata with the authorization token. + * + * @param array $metadata metadata hashmap + * @param string $authUri optional auth uri + * @param callable $httpHandler callback which delivers psr7 request + * + * @return array updated metadata hashmap + */ + public function updateMetadata( + $metadata, + $authUri = null, + callable $httpHandler = null + ) { + if (empty($authUri)) { + return $metadata; + } + + $this->auth->setAudience($authUri); + + return parent::updateMetadata($metadata, $authUri, $httpHandler); + } + + /** + * Implements FetchAuthTokenInterface#fetchAuthToken. + * + * @param callable $httpHandler + * + * @return array|void + */ + public function fetchAuthToken(callable $httpHandler = null) + { + $audience = $this->auth->getAudience(); + if (empty($audience)) { + return null; + } + + $access_token = $this->auth->toJwt(); + + return array('access_token' => $access_token); + } + + /** + * @return string + */ + public function getCacheKey() + { + return $this->auth->getCacheKey(); + } + + /** + * @return array + */ + public function getLastReceivedToken() + { + return $this->auth->getLastReceivedToken(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/UserRefreshCredentials.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/UserRefreshCredentials.php new file mode 100644 index 0000000..6c7e5cf --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Credentials/UserRefreshCredentials.php @@ -0,0 +1,110 @@ +auth = new OAuth2([ + 'clientId' => $jsonKey['client_id'], + 'clientSecret' => $jsonKey['client_secret'], + 'refresh_token' => $jsonKey['refresh_token'], + 'scope' => $scope, + 'tokenCredentialUri' => self::TOKEN_CREDENTIAL_URI, + ]); + } + + /** + * @param callable $httpHandler + * + * @return array + */ + public function fetchAuthToken(callable $httpHandler = null) + { + return $this->auth->fetchAuthToken($httpHandler); + } + + /** + * @return string + */ + public function getCacheKey() + { + return $this->auth->getClientId() . ':' . $this->auth->getCacheKey(); + } + + /** + * @return array + */ + public function getLastReceivedToken() + { + return $this->auth->getLastReceivedToken(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/CredentialsLoader.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/CredentialsLoader.php new file mode 100644 index 0000000..a21f005 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/CredentialsLoader.php @@ -0,0 +1,210 @@ +setDefaultOption('auth', 'google_auth'); + $subscriber = new Subscriber\AuthTokenSubscriber( + $fetcher, + $httpHandler, + $tokenCallback + ); + $client->getEmitter()->attach($subscriber); + return $client; + case '6': + $middleware = new Middleware\AuthTokenMiddleware( + $fetcher, + $httpHandler, + $tokenCallback + ); + $stack = \GuzzleHttp\HandlerStack::create(); + $stack->push($middleware); + + return new \GuzzleHttp\Client([ + 'handler' => $stack, + 'auth' => 'google_auth', + ] + $httpClientOptions); + default: + throw new \Exception('Version not supported'); + } + } + + /** + * export a callback function which updates runtime metadata. + * + * @return array updateMetadata function + */ + public function getUpdateMetadataFunc() + { + return array($this, 'updateMetadata'); + } + + /** + * Updates metadata with the authorization token. + * + * @param array $metadata metadata hashmap + * @param string $authUri optional auth uri + * @param callable $httpHandler callback which delivers psr7 request + * + * @return array updated metadata hashmap + */ + public function updateMetadata( + $metadata, + $authUri = null, + callable $httpHandler = null + ) { + $result = $this->fetchAuthToken($httpHandler); + if (!isset($result['access_token'])) { + return $metadata; + } + $metadata_copy = $metadata; + $metadata_copy[self::AUTH_METADATA_KEY] = array('Bearer ' . $result['access_token']); + + return $metadata_copy; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/FetchAuthTokenCache.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/FetchAuthTokenCache.php new file mode 100644 index 0000000..5b8e01b --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/FetchAuthTokenCache.php @@ -0,0 +1,108 @@ +fetcher = $fetcher; + $this->cache = $cache; + $this->cacheConfig = array_merge([ + 'lifetime' => 1500, + 'prefix' => '', + ], (array) $cacheConfig); + } + + /** + * Implements FetchAuthTokenInterface#fetchAuthToken. + * + * Checks the cache for a valid auth token and fetches the auth tokens + * from the supplied fetcher. + * + * @param callable $httpHandler callback which delivers psr7 request + * + * @return array the response + * + * @throws \Exception + */ + public function fetchAuthToken(callable $httpHandler = null) + { + // Use the cached value if its available. + // + // TODO: correct caching; update the call to setCachedValue to set the expiry + // to the value returned with the auth token. + // + // TODO: correct caching; enable the cache to be cleared. + $cacheKey = $this->fetcher->getCacheKey(); + $cached = $this->getCachedValue($cacheKey); + if (!empty($cached)) { + return ['access_token' => $cached]; + } + + $auth_token = $this->fetcher->fetchAuthToken($httpHandler); + + if (isset($auth_token['access_token'])) { + $this->setCachedValue($cacheKey, $auth_token['access_token']); + } + + return $auth_token; + } + + /** + * @return string + */ + public function getCacheKey() + { + return $this->getFullCacheKey($this->fetcher->getCacheKey()); + } + + /** + * @return array|null + */ + public function getLastReceivedToken() + { + return $this->fetcher->getLastReceivedToken(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/FetchAuthTokenInterface.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/FetchAuthTokenInterface.php new file mode 100644 index 0000000..e3d8d28 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/FetchAuthTokenInterface.php @@ -0,0 +1,55 @@ +client = $client; + } + + /** + * Accepts a PSR-7 Request and an array of options and returns a PSR-7 response. + * + * @param RequestInterface $request + * @param array $options + * + * @return ResponseInterface + */ + public function __invoke(RequestInterface $request, array $options = []) + { + $response = $this->client->send( + $this->createGuzzle5Request($request, $options) + ); + + return $this->createPsr7Response($response); + } + + /** + * Accepts a PSR-7 request and an array of options and returns a PromiseInterface + * + * @param RequestInterface $request + * @param array $options + * + * @return Promise + */ + public function async(RequestInterface $request, array $options = []) + { + if (!class_exists('GuzzleHttp\Promise\Promise')) { + throw new Exception('Install guzzlehttp/promises to use async with Guzzle 5'); + } + + $futureResponse = $this->client->send( + $this->createGuzzle5Request( + $request, + ['future' => true] + $options + ) + ); + + $promise = new Promise( + function () use ($futureResponse) { + try { + $futureResponse->wait(); + } catch (Exception $e) { + // The promise is already delivered when the exception is + // thrown, so don't rethrow it. + } + }, + [$futureResponse, 'cancel'] + ); + + $futureResponse->then([$promise, 'resolve'], [$promise, 'reject']); + + return $promise->then( + function (Guzzle5ResponseInterface $response) { + // Adapt the Guzzle 5 Response to a PSR-7 Response. + return $this->createPsr7Response($response); + }, + function (Exception $e) { + return new RejectedPromise($e); + } + ); + } + + private function createGuzzle5Request(RequestInterface $request, array $options) + { + return $this->client->createRequest( + $request->getMethod(), + $request->getUri(), + array_merge_recursive([ + 'headers' => $request->getHeaders(), + 'body' => $request->getBody(), + ], $options) + ); + } + + private function createPsr7Response(Guzzle5ResponseInterface $response) + { + return new Response( + $response->getStatusCode(), + $response->getHeaders() ?: [], + $response->getBody(), + $response->getProtocolVersion(), + $response->getReasonPhrase() + ); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/Guzzle6HttpHandler.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/Guzzle6HttpHandler.php new file mode 100644 index 0000000..6dfe9a8 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/Guzzle6HttpHandler.php @@ -0,0 +1,49 @@ +client = $client; + } + + /** + * Accepts a PSR-7 request and an array of options and returns a PSR-7 response. + * + * @param RequestInterface $request + * @param array $options + * + * @return ResponseInterface + */ + public function __invoke(RequestInterface $request, array $options = []) + { + return $this->client->send($request, $options); + } + + /** + * Accepts a PSR-7 request and an array of options and returns a PromiseInterface + * + * @param RequestInterface $request + * @param array $options + * + * @return \GuzzleHttp\Promise\Promise + */ + public function async(RequestInterface $request, array $options = []) + { + return $this->client->sendAsync($request, $options); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/HttpHandlerFactory.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/HttpHandlerFactory.php new file mode 100644 index 0000000..1ede798 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/HttpHandler/HttpHandlerFactory.php @@ -0,0 +1,47 @@ +' + */ +class AuthTokenMiddleware +{ + /** + * @var callback + */ + private $httpHandler; + + /** + * @var FetchAuthTokenInterface + */ + private $fetcher; + + /** + * @var callable + */ + private $tokenCallback; + + /** + * Creates a new AuthTokenMiddleware. + * + * @param FetchAuthTokenInterface $fetcher is used to fetch the auth token + * @param callable $httpHandler (optional) callback which delivers psr7 request + * @param callable $tokenCallback (optional) function to be called when a new token is fetched. + */ + public function __construct( + FetchAuthTokenInterface $fetcher, + callable $httpHandler = null, + callable $tokenCallback = null + ) { + $this->fetcher = $fetcher; + $this->httpHandler = $httpHandler; + $this->tokenCallback = $tokenCallback; + } + + /** + * Updates the request with an Authorization header when auth is 'google_auth'. + * + * use Google\Auth\Middleware\AuthTokenMiddleware; + * use Google\Auth\OAuth2; + * use GuzzleHttp\Client; + * use GuzzleHttp\HandlerStack; + * + * $config = [...]; + * $oauth2 = new OAuth2($config) + * $middleware = new AuthTokenMiddleware($oauth2); + * $stack = HandlerStack::create(); + * $stack->push($middleware); + * + * $client = new Client([ + * 'handler' => $stack, + * 'base_uri' => 'https://www.googleapis.com/taskqueue/v1beta2/projects/', + * 'auth' => 'google_auth' // authorize all requests + * ]); + * + * $res = $client->get('myproject/taskqueues/myqueue'); + * + * @param callable $handler + * + * @return \Closure + */ + public function __invoke(callable $handler) + { + return function (RequestInterface $request, array $options) use ($handler) { + // Requests using "auth"="google_auth" will be authorized. + if (!isset($options['auth']) || $options['auth'] !== 'google_auth') { + return $handler($request, $options); + } + + $request = $request->withHeader('authorization', 'Bearer ' . $this->fetchToken()); + + return $handler($request, $options); + }; + } + + /** + * Call fetcher to fetch the token. + * + * @return string + */ + private function fetchToken() + { + $auth_tokens = $this->fetcher->fetchAuthToken($this->httpHandler); + + if (array_key_exists('access_token', $auth_tokens)) { + // notify the callback if applicable + if ($this->tokenCallback) { + call_user_func($this->tokenCallback, $this->fetcher->getCacheKey(), $auth_tokens['access_token']); + } + + return $auth_tokens['access_token']; + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/ScopedAccessTokenMiddleware.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/ScopedAccessTokenMiddleware.php new file mode 100644 index 0000000..55f04d1 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/ScopedAccessTokenMiddleware.php @@ -0,0 +1,175 @@ +' + */ +class ScopedAccessTokenMiddleware +{ + use CacheTrait; + + const DEFAULT_CACHE_LIFETIME = 1500; + + /** + * @var CacheItemPoolInterface + */ + private $cache; + + /** + * @var array configuration + */ + private $cacheConfig; + + /** + * @var callable + */ + private $tokenFunc; + + /** + * @var array|string + */ + private $scopes; + + /** + * Creates a new ScopedAccessTokenMiddleware. + * + * @param callable $tokenFunc a token generator function + * @param array|string $scopes the token authentication scopes + * @param array $cacheConfig configuration for the cache when it's present + * @param CacheItemPoolInterface $cache an implementation of CacheItemPoolInterface + */ + public function __construct( + callable $tokenFunc, + $scopes, + array $cacheConfig = null, + CacheItemPoolInterface $cache = null + ) { + $this->tokenFunc = $tokenFunc; + if (!(is_string($scopes) || is_array($scopes))) { + throw new \InvalidArgumentException( + 'wants scope should be string or array'); + } + $this->scopes = $scopes; + + if (!is_null($cache)) { + $this->cache = $cache; + $this->cacheConfig = array_merge([ + 'lifetime' => self::DEFAULT_CACHE_LIFETIME, + 'prefix' => '', + ], $cacheConfig); + } + } + + /** + * Updates the request with an Authorization header when auth is 'scoped'. + * + * E.g this could be used to authenticate using the AppEngine + * AppIdentityService. + * + * use google\appengine\api\app_identity\AppIdentityService; + * use Google\Auth\Middleware\ScopedAccessTokenMiddleware; + * use GuzzleHttp\Client; + * use GuzzleHttp\HandlerStack; + * + * $scope = 'https://www.googleapis.com/auth/taskqueue' + * $middleware = new ScopedAccessTokenMiddleware( + * 'AppIdentityService::getAccessToken', + * $scope, + * [ 'prefix' => 'Google\Auth\ScopedAccessToken::' ], + * $cache = new Memcache() + * ); + * $stack = HandlerStack::create(); + * $stack->push($middleware); + * + * $client = new Client([ + * 'handler' => $stack, + * 'base_url' => 'https://www.googleapis.com/taskqueue/v1beta2/projects/', + * 'auth' => 'scoped' // authorize all requests + * ]); + * + * $res = $client->get('myproject/taskqueues/myqueue'); + * + * @param callable $handler + * + * @return \Closure + */ + public function __invoke(callable $handler) + { + return function (RequestInterface $request, array $options) use ($handler) { + // Requests using "auth"="scoped" will be authorized. + if (!isset($options['auth']) || $options['auth'] !== 'scoped') { + return $handler($request, $options); + } + + $request = $request->withHeader('authorization', 'Bearer ' . $this->fetchToken()); + + return $handler($request, $options); + }; + } + + /** + * @return string + */ + private function getCacheKey() + { + $key = null; + + if (is_string($this->scopes)) { + $key .= $this->scopes; + } elseif (is_array($this->scopes)) { + $key .= implode(':', $this->scopes); + } + + return $key; + } + + /** + * Determine if token is available in the cache, if not call tokenFunc to + * fetch it. + * + * @return string + */ + private function fetchToken() + { + $cacheKey = $this->getCacheKey(); + $cached = $this->getCachedValue($cacheKey); + + if (!empty($cached)) { + return $cached; + } + + $token = call_user_func($this->tokenFunc, $this->scopes); + $this->setCachedValue($cacheKey, $token); + + return $token; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/SimpleMiddleware.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/SimpleMiddleware.php new file mode 100644 index 0000000..c31fc65 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Middleware/SimpleMiddleware.php @@ -0,0 +1,93 @@ +config = array_merge(['key' => null], $config); + } + + /** + * Updates the request query with the developer key if auth is set to simple. + * + * use Google\Auth\Middleware\SimpleMiddleware; + * use GuzzleHttp\Client; + * use GuzzleHttp\HandlerStack; + * + * $my_key = 'is not the same as yours'; + * $middleware = new SimpleMiddleware(['key' => $my_key]); + * $stack = HandlerStack::create(); + * $stack->push($middleware); + * + * $client = new Client([ + * 'handler' => $stack, + * 'base_uri' => 'https://www.googleapis.com/discovery/v1/', + * 'auth' => 'simple' + * ]); + * + * $res = $client->get('drive/v2/rest'); + * + * @param callable $handler + * + * @return \Closure + */ + public function __invoke(callable $handler) + { + return function (RequestInterface $request, array $options) use ($handler) { + // Requests using "auth"="scoped" will be authorized. + if (!isset($options['auth']) || $options['auth'] !== 'simple') { + return $handler($request, $options); + } + + $query = Psr7\parse_query($request->getUri()->getQuery()); + $params = array_merge($query, $this->config); + $uri = $request->getUri()->withQuery(Psr7\build_query($params)); + $request = $request->withUri($uri); + + return $handler($request, $options); + }; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/OAuth2.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/OAuth2.php new file mode 100644 index 0000000..3dbceeb --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/OAuth2.php @@ -0,0 +1,1335 @@ + self::DEFAULT_EXPIRY_SECONDS, + 'extensionParams' => [], + 'authorizationUri' => null, + 'redirectUri' => null, + 'tokenCredentialUri' => null, + 'state' => null, + 'username' => null, + 'password' => null, + 'clientId' => null, + 'clientSecret' => null, + 'issuer' => null, + 'sub' => null, + 'audience' => null, + 'signingKey' => null, + 'signingAlgorithm' => null, + 'scope' => null, + 'additionalClaims' => [], + ], $config); + + $this->setAuthorizationUri($opts['authorizationUri']); + $this->setRedirectUri($opts['redirectUri']); + $this->setTokenCredentialUri($opts['tokenCredentialUri']); + $this->setState($opts['state']); + $this->setUsername($opts['username']); + $this->setPassword($opts['password']); + $this->setClientId($opts['clientId']); + $this->setClientSecret($opts['clientSecret']); + $this->setIssuer($opts['issuer']); + $this->setSub($opts['sub']); + $this->setExpiry($opts['expiry']); + $this->setAudience($opts['audience']); + $this->setSigningKey($opts['signingKey']); + $this->setSigningAlgorithm($opts['signingAlgorithm']); + $this->setScope($opts['scope']); + $this->setExtensionParams($opts['extensionParams']); + $this->setAdditionalClaims($opts['additionalClaims']); + $this->updateToken($opts); + } + + /** + * Verifies the idToken if present. + * + * - if none is present, return null + * - if present, but invalid, raises DomainException. + * - otherwise returns the payload in the idtoken as a PHP object. + * + * if $publicKey is null, the key is decoded without being verified. + * + * @param string $publicKey The public key to use to authenticate the token + * @param array $allowed_algs List of supported verification algorithms + * + * @return null|object + */ + public function verifyIdToken($publicKey = null, $allowed_algs = array()) + { + $idToken = $this->getIdToken(); + if (is_null($idToken)) { + return null; + } + + $resp = $this->jwtDecode($idToken, $publicKey, $allowed_algs); + if (!property_exists($resp, 'aud')) { + throw new \DomainException('No audience found the id token'); + } + if ($resp->aud != $this->getAudience()) { + throw new \DomainException('Wrong audience present in the id token'); + } + + return $resp; + } + + /** + * Obtains the encoded jwt from the instance data. + * + * @param array $config array optional configuration parameters + * + * @return string + */ + public function toJwt(array $config = []) + { + if (is_null($this->getSigningKey())) { + throw new \DomainException('No signing key available'); + } + if (is_null($this->getSigningAlgorithm())) { + throw new \DomainException('No signing algorithm specified'); + } + $now = time(); + + $opts = array_merge([ + 'skew' => self::DEFAULT_SKEW_SECONDS, + ], $config); + + $assertion = [ + 'iss' => $this->getIssuer(), + 'aud' => $this->getAudience(), + 'exp' => ($now + $this->getExpiry()), + 'iat' => ($now - $opts['skew']), + ]; + foreach ($assertion as $k => $v) { + if (is_null($v)) { + throw new \DomainException($k . ' should not be null'); + } + } + if (!(is_null($this->getScope()))) { + $assertion['scope'] = $this->getScope(); + } + if (!(is_null($this->getSub()))) { + $assertion['sub'] = $this->getSub(); + } + $assertion += $this->getAdditionalClaims(); + + return $this->jwtEncode($assertion, $this->getSigningKey(), + $this->getSigningAlgorithm()); + } + + /** + * Generates a request for token credentials. + * + * @return RequestInterface the authorization Url. + */ + public function generateCredentialsRequest() + { + $uri = $this->getTokenCredentialUri(); + if (is_null($uri)) { + throw new \DomainException('No token credential URI was set.'); + } + + $grantType = $this->getGrantType(); + $params = array('grant_type' => $grantType); + switch ($grantType) { + case 'authorization_code': + $params['code'] = $this->getCode(); + $params['redirect_uri'] = $this->getRedirectUri(); + $this->addClientCredentials($params); + break; + case 'password': + $params['username'] = $this->getUsername(); + $params['password'] = $this->getPassword(); + $this->addClientCredentials($params); + break; + case 'refresh_token': + $params['refresh_token'] = $this->getRefreshToken(); + $this->addClientCredentials($params); + break; + case self::JWT_URN: + $params['assertion'] = $this->toJwt(); + break; + default: + if (!is_null($this->getRedirectUri())) { + # Grant type was supposed to be 'authorization_code', as there + # is a redirect URI. + throw new \DomainException('Missing authorization code'); + } + unset($params['grant_type']); + if (!is_null($grantType)) { + $params['grant_type'] = $grantType; + } + $params = array_merge($params, $this->getExtensionParams()); + } + + $headers = [ + 'Cache-Control' => 'no-store', + 'Content-Type' => 'application/x-www-form-urlencoded', + ]; + + return new Request( + 'POST', + $uri, + $headers, + Psr7\build_query($params) + ); + } + + /** + * Fetches the auth tokens based on the current state. + * + * @param callable $httpHandler callback which delivers psr7 request + * + * @return array the response + */ + public function fetchAuthToken(callable $httpHandler = null) + { + if (is_null($httpHandler)) { + $httpHandler = HttpHandlerFactory::build(); + } + + $response = $httpHandler($this->generateCredentialsRequest()); + $credentials = $this->parseTokenResponse($response); + $this->updateToken($credentials); + + return $credentials; + } + + /** + * Obtains a key that can used to cache the results of #fetchAuthToken. + * + * The key is derived from the scopes. + * + * @return string a key that may be used to cache the auth token. + */ + public function getCacheKey() + { + if (is_string($this->scope)) { + return $this->scope; + } elseif (is_array($this->scope)) { + return implode(':', $this->scope); + } + + // If scope has not set, return null to indicate no caching. + return null; + } + + /** + * Parses the fetched tokens. + * + * @param ResponseInterface $resp the response. + * + * @return array the tokens parsed from the response body. + * + * @throws \Exception + */ + public function parseTokenResponse(ResponseInterface $resp) + { + $body = (string)$resp->getBody(); + if ($resp->hasHeader('Content-Type') && + $resp->getHeaderLine('Content-Type') == 'application/x-www-form-urlencoded' + ) { + $res = array(); + parse_str($body, $res); + + return $res; + } else { + // Assume it's JSON; if it's not throw an exception + if (null === $res = json_decode($body, true)) { + throw new \Exception('Invalid JSON response'); + } + + return $res; + } + } + + /** + * Updates an OAuth 2.0 client. + * + * @example + * client.updateToken([ + * 'refresh_token' => 'n4E9O119d', + * 'access_token' => 'FJQbwq9', + * 'expires_in' => 3600 + * ]) + * + * @param array $config + * The configuration parameters related to the token. + * + * - refresh_token + * The refresh token associated with the access token + * to be refreshed. + * + * - access_token + * The current access token for this client. + * + * - id_token + * The current ID token for this client. + * + * - expires_in + * The time in seconds until access token expiration. + * + * - expires_at + * The time as an integer number of seconds since the Epoch + * + * - issued_at + * The timestamp that the token was issued at. + */ + public function updateToken(array $config) + { + $opts = array_merge([ + 'extensionParams' => [], + 'access_token' => null, + 'id_token' => null, + 'expires_in' => null, + 'expires_at' => null, + 'issued_at' => null, + ], $config); + + $this->setExpiresAt($opts['expires_at']); + $this->setExpiresIn($opts['expires_in']); + // By default, the token is issued at `Time.now` when `expiresIn` is set, + // but this can be used to supply a more precise time. + if (!is_null($opts['issued_at'])) { + $this->setIssuedAt($opts['issued_at']); + } + + $this->setAccessToken($opts['access_token']); + $this->setIdToken($opts['id_token']); + // The refresh token should only be updated if a value is explicitly + // passed in, as some access token responses do not include a refresh + // token. + if (array_key_exists('refresh_token', $opts)) { + $this->setRefreshToken($opts['refresh_token']); + } + } + + /** + * Builds the authorization Uri that the user should be redirected to. + * + * @param array $config configuration options that customize the return url + * + * @return UriInterface the authorization Url. + * + * @throws InvalidArgumentException + */ + public function buildFullAuthorizationUri(array $config = []) + { + if (is_null($this->getAuthorizationUri())) { + throw new InvalidArgumentException( + 'requires an authorizationUri to have been set'); + } + + $params = array_merge([ + 'response_type' => 'code', + 'access_type' => 'offline', + 'client_id' => $this->clientId, + 'redirect_uri' => $this->redirectUri, + 'state' => $this->state, + 'scope' => $this->getScope(), + ], $config); + + // Validate the auth_params + if (is_null($params['client_id'])) { + throw new InvalidArgumentException( + 'missing the required client identifier'); + } + if (is_null($params['redirect_uri'])) { + throw new InvalidArgumentException('missing the required redirect URI'); + } + if (!empty($params['prompt']) && !empty($params['approval_prompt'])) { + throw new InvalidArgumentException( + 'prompt and approval_prompt are mutually exclusive'); + } + + // Construct the uri object; return it if it is valid. + $result = clone $this->authorizationUri; + $existingParams = Psr7\parse_query($result->getQuery()); + + $result = $result->withQuery( + Psr7\build_query(array_merge($existingParams, $params)) + ); + + if ($result->getScheme() != 'https') { + throw new InvalidArgumentException( + 'Authorization endpoint must be protected by TLS'); + } + + return $result; + } + + /** + * Sets the authorization server's HTTP endpoint capable of authenticating + * the end-user and obtaining authorization. + * + * @param string $uri + */ + public function setAuthorizationUri($uri) + { + $this->authorizationUri = $this->coerceUri($uri); + } + + /** + * Gets the authorization server's HTTP endpoint capable of authenticating + * the end-user and obtaining authorization. + * + * @return UriInterface + */ + public function getAuthorizationUri() + { + return $this->authorizationUri; + } + + /** + * Gets the authorization server's HTTP endpoint capable of issuing tokens + * and refreshing expired tokens. + * + * @return string + */ + public function getTokenCredentialUri() + { + return $this->tokenCredentialUri; + } + + /** + * Sets the authorization server's HTTP endpoint capable of issuing tokens + * and refreshing expired tokens. + * + * @param string $uri + */ + public function setTokenCredentialUri($uri) + { + $this->tokenCredentialUri = $this->coerceUri($uri); + } + + /** + * Gets the redirection URI used in the initial request. + * + * @return string + */ + public function getRedirectUri() + { + return $this->redirectUri; + } + + /** + * Sets the redirection URI used in the initial request. + * + * @param string $uri + */ + public function setRedirectUri($uri) + { + if (is_null($uri)) { + $this->redirectUri = null; + + return; + } + // redirect URI must be absolute + if (!$this->isAbsoluteUri($uri)) { + // "postmessage" is a reserved URI string in Google-land + // @see https://developers.google.com/identity/sign-in/web/server-side-flow + if ('postmessage' !== (string)$uri) { + throw new InvalidArgumentException( + 'Redirect URI must be absolute'); + } + } + $this->redirectUri = (string)$uri; + } + + /** + * Gets the scope of the access requests as a space-delimited String. + * + * @return string + */ + public function getScope() + { + if (is_null($this->scope)) { + return $this->scope; + } + + return implode(' ', $this->scope); + } + + /** + * Sets the scope of the access request, expressed either as an Array or as + * a space-delimited String. + * + * @param string|array $scope + * + * @throws InvalidArgumentException + */ + public function setScope($scope) + { + if (is_null($scope)) { + $this->scope = null; + } elseif (is_string($scope)) { + $this->scope = explode(' ', $scope); + } elseif (is_array($scope)) { + foreach ($scope as $s) { + $pos = strpos($s, ' '); + if ($pos !== false) { + throw new InvalidArgumentException( + 'array scope values should not contain spaces'); + } + } + $this->scope = $scope; + } else { + throw new InvalidArgumentException( + 'scopes should be a string or array of strings'); + } + } + + /** + * Gets the current grant type. + * + * @return string + */ + public function getGrantType() + { + if (!is_null($this->grantType)) { + return $this->grantType; + } + + // Returns the inferred grant type, based on the current object instance + // state. + if (!is_null($this->code)) { + return 'authorization_code'; + } elseif (!is_null($this->refreshToken)) { + return 'refresh_token'; + } elseif (!is_null($this->username) && !is_null($this->password)) { + return 'password'; + } elseif (!is_null($this->issuer) && !is_null($this->signingKey)) { + return self::JWT_URN; + } else { + return null; + } + } + + /** + * Sets the current grant type. + * + * @param $grantType + * + * @throws InvalidArgumentException + */ + public function setGrantType($grantType) + { + if (in_array($grantType, self::$knownGrantTypes)) { + $this->grantType = $grantType; + } else { + // validate URI + if (!$this->isAbsoluteUri($grantType)) { + throw new InvalidArgumentException( + 'invalid grant type'); + } + $this->grantType = (string)$grantType; + } + } + + /** + * Gets an arbitrary string designed to allow the client to maintain state. + * + * @return string + */ + public function getState() + { + return $this->state; + } + + /** + * Sets an arbitrary string designed to allow the client to maintain state. + * + * @param string $state + */ + public function setState($state) + { + $this->state = $state; + } + + /** + * Gets the authorization code issued to this client. + */ + public function getCode() + { + return $this->code; + } + + /** + * Sets the authorization code issued to this client. + * + * @param string $code + */ + public function setCode($code) + { + $this->code = $code; + } + + /** + * Gets the resource owner's username. + */ + public function getUsername() + { + return $this->username; + } + + /** + * Sets the resource owner's username. + * + * @param string $username + */ + public function setUsername($username) + { + $this->username = $username; + } + + /** + * Gets the resource owner's password. + */ + public function getPassword() + { + return $this->password; + } + + /** + * Sets the resource owner's password. + * + * @param $password + */ + public function setPassword($password) + { + $this->password = $password; + } + + /** + * Sets a unique identifier issued to the client to identify itself to the + * authorization server. + */ + public function getClientId() + { + return $this->clientId; + } + + /** + * Sets a unique identifier issued to the client to identify itself to the + * authorization server. + * + * @param $clientId + */ + public function setClientId($clientId) + { + $this->clientId = $clientId; + } + + /** + * Gets a shared symmetric secret issued by the authorization server, which + * is used to authenticate the client. + */ + public function getClientSecret() + { + return $this->clientSecret; + } + + /** + * Sets a shared symmetric secret issued by the authorization server, which + * is used to authenticate the client. + * + * @param $clientSecret + */ + public function setClientSecret($clientSecret) + { + $this->clientSecret = $clientSecret; + } + + /** + * Gets the Issuer ID when using assertion profile. + */ + public function getIssuer() + { + return $this->issuer; + } + + /** + * Sets the Issuer ID when using assertion profile. + * + * @param string $issuer + */ + public function setIssuer($issuer) + { + $this->issuer = $issuer; + } + + /** + * Gets the target sub when issuing assertions. + */ + public function getSub() + { + return $this->sub; + } + + /** + * Sets the target sub when issuing assertions. + * + * @param string $sub + */ + public function setSub($sub) + { + $this->sub = $sub; + } + + /** + * Gets the target audience when issuing assertions. + */ + public function getAudience() + { + return $this->audience; + } + + /** + * Sets the target audience when issuing assertions. + * + * @param string $audience + */ + public function setAudience($audience) + { + $this->audience = $audience; + } + + /** + * Gets the signing key when using an assertion profile. + */ + public function getSigningKey() + { + return $this->signingKey; + } + + /** + * Sets the signing key when using an assertion profile. + * + * @param string $signingKey + */ + public function setSigningKey($signingKey) + { + $this->signingKey = $signingKey; + } + + /** + * Gets the signing algorithm when using an assertion profile. + * + * @return string + */ + public function getSigningAlgorithm() + { + return $this->signingAlgorithm; + } + + /** + * Sets the signing algorithm when using an assertion profile. + * + * @param string $signingAlgorithm + */ + public function setSigningAlgorithm($signingAlgorithm) + { + if (is_null($signingAlgorithm)) { + $this->signingAlgorithm = null; + } elseif (!in_array($signingAlgorithm, self::$knownSigningAlgorithms)) { + throw new InvalidArgumentException('unknown signing algorithm'); + } else { + $this->signingAlgorithm = $signingAlgorithm; + } + } + + /** + * Gets the set of parameters used by extension when using an extension + * grant type. + */ + public function getExtensionParams() + { + return $this->extensionParams; + } + + /** + * Sets the set of parameters used by extension when using an extension + * grant type. + * + * @param $extensionParams + */ + public function setExtensionParams($extensionParams) + { + $this->extensionParams = $extensionParams; + } + + /** + * Gets the number of seconds assertions are valid for. + */ + public function getExpiry() + { + return $this->expiry; + } + + /** + * Sets the number of seconds assertions are valid for. + * + * @param int $expiry + */ + public function setExpiry($expiry) + { + $this->expiry = $expiry; + } + + /** + * Gets the lifetime of the access token in seconds. + */ + public function getExpiresIn() + { + return $this->expiresIn; + } + + /** + * Sets the lifetime of the access token in seconds. + * + * @param int $expiresIn + */ + public function setExpiresIn($expiresIn) + { + if (is_null($expiresIn)) { + $this->expiresIn = null; + $this->issuedAt = null; + } else { + $this->issuedAt = time(); + $this->expiresIn = (int)$expiresIn; + } + } + + /** + * Gets the time the current access token expires at. + * + * @return int + */ + public function getExpiresAt() + { + if (!is_null($this->expiresAt)) { + return $this->expiresAt; + } elseif (!is_null($this->issuedAt) && !is_null($this->expiresIn)) { + return $this->issuedAt + $this->expiresIn; + } + + return null; + } + + /** + * Returns true if the acccess token has expired. + * + * @return bool + */ + public function isExpired() + { + $expiration = $this->getExpiresAt(); + $now = time(); + + return !is_null($expiration) && $now >= $expiration; + } + + /** + * Sets the time the current access token expires at. + * + * @param int $expiresAt + */ + public function setExpiresAt($expiresAt) + { + $this->expiresAt = $expiresAt; + } + + /** + * Gets the time the current access token was issued at. + */ + public function getIssuedAt() + { + return $this->issuedAt; + } + + /** + * Sets the time the current access token was issued at. + * + * @param int $issuedAt + */ + public function setIssuedAt($issuedAt) + { + $this->issuedAt = $issuedAt; + } + + /** + * Gets the current access token. + */ + public function getAccessToken() + { + return $this->accessToken; + } + + /** + * Sets the current access token. + * + * @param string $accessToken + */ + public function setAccessToken($accessToken) + { + $this->accessToken = $accessToken; + } + + /** + * Gets the current ID token. + */ + public function getIdToken() + { + return $this->idToken; + } + + /** + * Sets the current ID token. + * + * @param $idToken + */ + public function setIdToken($idToken) + { + $this->idToken = $idToken; + } + + /** + * Gets the refresh token associated with the current access token. + */ + public function getRefreshToken() + { + return $this->refreshToken; + } + + /** + * Sets the refresh token associated with the current access token. + * + * @param $refreshToken + */ + public function setRefreshToken($refreshToken) + { + $this->refreshToken = $refreshToken; + } + + /** + * Sets additional claims to be included in the JWT token + * + * @param array $additionalClaims + */ + public function setAdditionalClaims(array $additionalClaims) + { + $this->additionalClaims = $additionalClaims; + } + + /** + * Gets the additional claims to be included in the JWT token. + * + * @return array + */ + public function getAdditionalClaims() + { + return $this->additionalClaims; + } + + /** + * The expiration of the last received token. + * + * @return array + */ + public function getLastReceivedToken() + { + if ($token = $this->getAccessToken()) { + return [ + 'access_token' => $token, + 'expires_at' => $this->getExpiresAt(), + ]; + } + + return null; + } + + /** + * @todo handle uri as array + * + * @param string $uri + * + * @return null|UriInterface + */ + private function coerceUri($uri) + { + if (is_null($uri)) { + return; + } + + return Psr7\uri_for($uri); + } + + /** + * @param string $idToken + * @param string|array|null $publicKey + * @param array $allowedAlgs + * + * @return object + */ + private function jwtDecode($idToken, $publicKey, $allowedAlgs) + { + if (class_exists('Firebase\JWT\JWT')) { + return \Firebase\JWT\JWT::decode($idToken, $publicKey, $allowedAlgs); + } + + return \JWT::decode($idToken, $publicKey, $allowedAlgs); + } + + private function jwtEncode($assertion, $signingKey, $signingAlgorithm) + { + if (class_exists('Firebase\JWT\JWT')) { + return \Firebase\JWT\JWT::encode($assertion, $signingKey, + $signingAlgorithm); + } + + return \JWT::encode($assertion, $signingKey, $signingAlgorithm); + } + + /** + * Determines if the URI is absolute based on its scheme and host or path + * (RFC 3986). + * + * @param string $uri + * + * @return bool + */ + private function isAbsoluteUri($uri) + { + $uri = $this->coerceUri($uri); + + return $uri->getScheme() && ($uri->getHost() || $uri->getPath()); + } + + /** + * @param array $params + * + * @return array + */ + private function addClientCredentials(&$params) + { + $clientId = $this->getClientId(); + $clientSecret = $this->getClientSecret(); + + if ($clientId && $clientSecret) { + $params['client_id'] = $clientId; + $params['client_secret'] = $clientSecret; + } + + return $params; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/AuthTokenSubscriber.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/AuthTokenSubscriber.php new file mode 100644 index 0000000..4c78426 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/AuthTokenSubscriber.php @@ -0,0 +1,118 @@ +' + */ +class AuthTokenSubscriber implements SubscriberInterface +{ + /** + * @var callable + */ + private $httpHandler; + + /** + * @var FetchAuthTokenInterface + */ + private $fetcher; + + /** + * @var callable + */ + private $tokenCallback; + + /** + * Creates a new AuthTokenSubscriber. + * + * @param FetchAuthTokenInterface $fetcher is used to fetch the auth token + * @param callable $httpHandler (optional) http client to fetch the token. + * @param callable $tokenCallback (optional) function to be called when a new token is fetched. + */ + public function __construct( + FetchAuthTokenInterface $fetcher, + callable $httpHandler = null, + callable $tokenCallback = null + ) { + $this->fetcher = $fetcher; + $this->httpHandler = $httpHandler; + $this->tokenCallback = $tokenCallback; + } + + /** + * @return array + */ + public function getEvents() + { + return ['before' => ['onBefore', RequestEvents::SIGN_REQUEST]]; + } + + /** + * Updates the request with an Authorization header when auth is 'fetched_auth_token'. + * + * use GuzzleHttp\Client; + * use Google\Auth\OAuth2; + * use Google\Auth\Subscriber\AuthTokenSubscriber; + * + * $config = [...]; + * $oauth2 = new OAuth2($config) + * $subscriber = new AuthTokenSubscriber($oauth2); + * + * $client = new Client([ + * 'base_url' => 'https://www.googleapis.com/taskqueue/v1beta2/projects/', + * 'defaults' => ['auth' => 'google_auth'] + * ]); + * $client->getEmitter()->attach($subscriber); + * + * $res = $client->get('myproject/taskqueues/myqueue'); + * + * @param BeforeEvent $event + */ + public function onBefore(BeforeEvent $event) + { + // Requests using "auth"="google_auth" will be authorized. + $request = $event->getRequest(); + if ($request->getConfig()['auth'] != 'google_auth') { + return; + } + + // Fetch the auth token. + $auth_tokens = $this->fetcher->fetchAuthToken($this->httpHandler); + if (array_key_exists('access_token', $auth_tokens)) { + $request->setHeader('authorization', 'Bearer ' . $auth_tokens['access_token']); + + // notify the callback if applicable + if ($this->tokenCallback) { + call_user_func($this->tokenCallback, $this->fetcher->getCacheKey(), $auth_tokens['access_token']); + } + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/ScopedAccessTokenSubscriber.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/ScopedAccessTokenSubscriber.php new file mode 100644 index 0000000..63b4ca2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/ScopedAccessTokenSubscriber.php @@ -0,0 +1,177 @@ +' + */ +class ScopedAccessTokenSubscriber implements SubscriberInterface +{ + use CacheTrait; + + const DEFAULT_CACHE_LIFETIME = 1500; + + /** + * @var CacheItemPoolInterface + */ + private $cache; + + /** + * @var callable The access token generator function + */ + private $tokenFunc; + + /** + * @var array|string The scopes used to generate the token + */ + private $scopes; + + /** + * @var array + */ + private $cacheConfig; + + /** + * Creates a new ScopedAccessTokenSubscriber. + * + * @param callable $tokenFunc a token generator function + * @param array|string $scopes the token authentication scopes + * @param array $cacheConfig configuration for the cache when it's present + * @param CacheItemPoolInterface $cache an implementation of CacheItemPoolInterface + */ + public function __construct( + callable $tokenFunc, + $scopes, + array $cacheConfig = null, + CacheItemPoolInterface $cache = null + ) { + $this->tokenFunc = $tokenFunc; + if (!(is_string($scopes) || is_array($scopes))) { + throw new \InvalidArgumentException( + 'wants scope should be string or array'); + } + $this->scopes = $scopes; + + if (!is_null($cache)) { + $this->cache = $cache; + $this->cacheConfig = array_merge([ + 'lifetime' => self::DEFAULT_CACHE_LIFETIME, + 'prefix' => '', + ], $cacheConfig); + } + } + + /** + * @return array + */ + public function getEvents() + { + return ['before' => ['onBefore', RequestEvents::SIGN_REQUEST]]; + } + + /** + * Updates the request with an Authorization header when auth is 'scoped'. + * + * E.g this could be used to authenticate using the AppEngine + * AppIdentityService. + * + * use google\appengine\api\app_identity\AppIdentityService; + * use Google\Auth\Subscriber\ScopedAccessTokenSubscriber; + * use GuzzleHttp\Client; + * + * $scope = 'https://www.googleapis.com/auth/taskqueue' + * $subscriber = new ScopedAccessToken( + * 'AppIdentityService::getAccessToken', + * $scope, + * ['prefix' => 'Google\Auth\ScopedAccessToken::'], + * $cache = new Memcache() + * ); + * + * $client = new Client([ + * 'base_url' => 'https://www.googleapis.com/taskqueue/v1beta2/projects/', + * 'defaults' => ['auth' => 'scoped'] + * ]); + * $client->getEmitter()->attach($subscriber); + * + * $res = $client->get('myproject/taskqueues/myqueue'); + * + * @param BeforeEvent $event + */ + public function onBefore(BeforeEvent $event) + { + // Requests using "auth"="scoped" will be authorized. + $request = $event->getRequest(); + if ($request->getConfig()['auth'] != 'scoped') { + return; + } + $auth_header = 'Bearer ' . $this->fetchToken(); + $request->setHeader('authorization', $auth_header); + } + + /** + * @return string + */ + private function getCacheKey() + { + $key = null; + + if (is_string($this->scopes)) { + $key .= $this->scopes; + } elseif (is_array($this->scopes)) { + $key .= implode(':', $this->scopes); + } + + return $key; + } + + /** + * Determine if token is available in the cache, if not call tokenFunc to + * fetch it. + * + * @return string + */ + private function fetchToken() + { + $cacheKey = $this->getCacheKey(); + $cached = $this->getCachedValue($cacheKey); + + if (!empty($cached)) { + return $cached; + } + + $token = call_user_func($this->tokenFunc, $this->scopes); + $this->setCachedValue($cacheKey, $token); + + return $token; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/SimpleSubscriber.php b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/SimpleSubscriber.php new file mode 100644 index 0000000..0c56731 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/google/auth/src/Subscriber/SimpleSubscriber.php @@ -0,0 +1,90 @@ +config = array_merge([], $config); + } + + /** + * @return array + */ + public function getEvents() + { + return ['before' => ['onBefore', RequestEvents::SIGN_REQUEST]]; + } + + /** + * Updates the request query with the developer key if auth is set to simple. + * + * use Google\Auth\Subscriber\SimpleSubscriber; + * use GuzzleHttp\Client; + * + * $my_key = 'is not the same as yours'; + * $subscriber = new SimpleSubscriber(['key' => $my_key]); + * + * $client = new Client([ + * 'base_url' => 'https://www.googleapis.com/discovery/v1/', + * 'defaults' => ['auth' => 'simple'] + * ]); + * $client->getEmitter()->attach($subscriber); + * + * $res = $client->get('drive/v2/rest'); + * + * @param BeforeEvent $event + */ + public function onBefore(BeforeEvent $event) + { + // Requests using "auth"="simple" with the developer key. + $request = $event->getRequest(); + if ($request->getConfig()['auth'] != 'simple') { + return; + } + $request->getQuery()->overwriteWith($this->config); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/CHANGELOG.md b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/CHANGELOG.md new file mode 100644 index 0000000..b265cbc --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/CHANGELOG.md @@ -0,0 +1,1264 @@ +# CHANGELOG + +## 6.3.0 - 2017-06-22 + +* Feature: force IP resolution (ipv4 or ipv6) [#1608](https://github.com/guzzle/guzzle/pull/1608), [#1659](https://github.com/guzzle/guzzle/pull/1659) +* Improvement: Don't include summary in exception message when body is empty [#1621](https://github.com/guzzle/guzzle/pull/1621) +* Improvement: Handle `on_headers` option in MockHandler [#1580](https://github.com/guzzle/guzzle/pull/1580) +* Improvement: Added SUSE Linux CA path [#1609](https://github.com/guzzle/guzzle/issues/1609) +* Improvement: Use class reference for getting the name of the class instead of using hardcoded strings [#1641](https://github.com/guzzle/guzzle/pull/1641) +* Feature: Added `read_timeout` option [#1611](https://github.com/guzzle/guzzle/pull/1611) +* Bug fix: PHP 7.x fixes [#1685](https://github.com/guzzle/guzzle/pull/1685), [#1686](https://github.com/guzzle/guzzle/pull/1686), [#1811](https://github.com/guzzle/guzzle/pull/1811) +* Deprecation: BadResponseException instantiation without a response [#1642](https://github.com/guzzle/guzzle/pull/1642) +* Feature: Added NTLM auth [#1569](https://github.com/guzzle/guzzle/pull/1569) +* Feature: Track redirect HTTP status codes [#1711](https://github.com/guzzle/guzzle/pull/1711) +* Improvement: Check handler type during construction [#1745](https://github.com/guzzle/guzzle/pull/1745) +* Improvement: Always include the Content-Length if there's a body [#1721](https://github.com/guzzle/guzzle/pull/1721) +* Feature: Added convenience method to access a cookie by name [#1318](https://github.com/guzzle/guzzle/pull/1318) +* Bug fix: Fill `CURLOPT_CAPATH` and `CURLOPT_CAINFO` properly [#1684](https://github.com/guzzle/guzzle/pull/1684) +* Improvement: Use `\GuzzleHttp\Promise\rejection_for` function instead of object init [#1827](https://github.com/guzzle/guzzle/pull/1827) + + ++ Minor code cleanups, documentation fixes and clarifications. + +## 6.2.3 - 2017-02-28 + +* Fix deprecations with guzzle/psr7 version 1.4 + +## 6.2.2 - 2016-10-08 + +* Allow to pass nullable Response to delay callable +* Only add scheme when host is present +* Fix drain case where content-length is the literal string zero +* Obfuscate in-URL credentials in exceptions + +## 6.2.1 - 2016-07-18 + +* Address HTTP_PROXY security vulnerability, CVE-2016-5385: + https://httpoxy.org/ +* Fixing timeout bug with StreamHandler: + https://github.com/guzzle/guzzle/pull/1488 +* Only read up to `Content-Length` in PHP StreamHandler to avoid timeouts when + a server does not honor `Connection: close`. +* Ignore URI fragment when sending requests. + +## 6.2.0 - 2016-03-21 + +* Feature: added `GuzzleHttp\json_encode` and `GuzzleHttp\json_decode`. + https://github.com/guzzle/guzzle/pull/1389 +* Bug fix: Fix sleep calculation when waiting for delayed requests. + https://github.com/guzzle/guzzle/pull/1324 +* Feature: More flexible history containers. + https://github.com/guzzle/guzzle/pull/1373 +* Bug fix: defer sink stream opening in StreamHandler. + https://github.com/guzzle/guzzle/pull/1377 +* Bug fix: do not attempt to escape cookie values. + https://github.com/guzzle/guzzle/pull/1406 +* Feature: report original content encoding and length on decoded responses. + https://github.com/guzzle/guzzle/pull/1409 +* Bug fix: rewind seekable request bodies before dispatching to cURL. + https://github.com/guzzle/guzzle/pull/1422 +* Bug fix: provide an empty string to `http_build_query` for HHVM workaround. + https://github.com/guzzle/guzzle/pull/1367 + +## 6.1.1 - 2015-11-22 + +* Bug fix: Proxy::wrapSync() now correctly proxies to the appropriate handler + https://github.com/guzzle/guzzle/commit/911bcbc8b434adce64e223a6d1d14e9a8f63e4e4 +* Feature: HandlerStack is now more generic. + https://github.com/guzzle/guzzle/commit/f2102941331cda544745eedd97fc8fd46e1ee33e +* Bug fix: setting verify to false in the StreamHandler now disables peer + verification. https://github.com/guzzle/guzzle/issues/1256 +* Feature: Middleware now uses an exception factory, including more error + context. https://github.com/guzzle/guzzle/pull/1282 +* Feature: better support for disabled functions. + https://github.com/guzzle/guzzle/pull/1287 +* Bug fix: fixed regression where MockHandler was not using `sink`. + https://github.com/guzzle/guzzle/pull/1292 + +## 6.1.0 - 2015-09-08 + +* Feature: Added the `on_stats` request option to provide access to transfer + statistics for requests. https://github.com/guzzle/guzzle/pull/1202 +* Feature: Added the ability to persist session cookies in CookieJars. + https://github.com/guzzle/guzzle/pull/1195 +* Feature: Some compatibility updates for Google APP Engine + https://github.com/guzzle/guzzle/pull/1216 +* Feature: Added support for NO_PROXY to prevent the use of a proxy based on + a simple set of rules. https://github.com/guzzle/guzzle/pull/1197 +* Feature: Cookies can now contain square brackets. + https://github.com/guzzle/guzzle/pull/1237 +* Bug fix: Now correctly parsing `=` inside of quotes in Cookies. + https://github.com/guzzle/guzzle/pull/1232 +* Bug fix: Cusotm cURL options now correctly override curl options of the + same name. https://github.com/guzzle/guzzle/pull/1221 +* Bug fix: Content-Type header is now added when using an explicitly provided + multipart body. https://github.com/guzzle/guzzle/pull/1218 +* Bug fix: Now ignoring Set-Cookie headers that have no name. +* Bug fix: Reason phrase is no longer cast to an int in some cases in the + cURL handler. https://github.com/guzzle/guzzle/pull/1187 +* Bug fix: Remove the Authorization header when redirecting if the Host + header changes. https://github.com/guzzle/guzzle/pull/1207 +* Bug fix: Cookie path matching fixes + https://github.com/guzzle/guzzle/issues/1129 +* Bug fix: Fixing the cURL `body_as_string` setting + https://github.com/guzzle/guzzle/pull/1201 +* Bug fix: quotes are no longer stripped when parsing cookies. + https://github.com/guzzle/guzzle/issues/1172 +* Bug fix: `form_params` and `query` now always uses the `&` separator. + https://github.com/guzzle/guzzle/pull/1163 +* Bug fix: Adding a Content-Length to PHP stream wrapper requests if not set. + https://github.com/guzzle/guzzle/pull/1189 + +## 6.0.2 - 2015-07-04 + +* Fixed a memory leak in the curl handlers in which references to callbacks + were not being removed by `curl_reset`. +* Cookies are now extracted properly before redirects. +* Cookies now allow more character ranges. +* Decoded Content-Encoding responses are now modified to correctly reflect + their state if the encoding was automatically removed by a handler. This + means that the `Content-Encoding` header may be removed an the + `Content-Length` modified to reflect the message size after removing the + encoding. +* Added a more explicit error message when trying to use `form_params` and + `multipart` in the same request. +* Several fixes for HHVM support. +* Functions are now conditionally required using an additional level of + indirection to help with global Composer installations. + +## 6.0.1 - 2015-05-27 + +* Fixed a bug with serializing the `query` request option where the `&` + separator was missing. +* Added a better error message for when `body` is provided as an array. Please + use `form_params` or `multipart` instead. +* Various doc fixes. + +## 6.0.0 - 2015-05-26 + +* See the UPGRADING.md document for more information. +* Added `multipart` and `form_params` request options. +* Added `synchronous` request option. +* Added the `on_headers` request option. +* Fixed `expect` handling. +* No longer adding default middlewares in the client ctor. These need to be + present on the provided handler in order to work. +* Requests are no longer initiated when sending async requests with the + CurlMultiHandler. This prevents unexpected recursion from requests completing + while ticking the cURL loop. +* Removed the semantics of setting `default` to `true`. This is no longer + required now that the cURL loop is not ticked for async requests. +* Added request and response logging middleware. +* No longer allowing self signed certificates when using the StreamHandler. +* Ensuring that `sink` is valid if saving to a file. +* Request exceptions now include a "handler context" which provides handler + specific contextual information. +* Added `GuzzleHttp\RequestOptions` to allow request options to be applied + using constants. +* `$maxHandles` has been removed from CurlMultiHandler. +* `MultipartPostBody` is now part of the `guzzlehttp/psr7` package. + +## 5.3.0 - 2015-05-19 + +* Mock now supports `save_to` +* Marked `AbstractRequestEvent::getTransaction()` as public. +* Fixed a bug in which multiple headers using different casing would overwrite + previous headers in the associative array. +* Added `Utils::getDefaultHandler()` +* Marked `GuzzleHttp\Client::getDefaultUserAgent` as deprecated. +* URL scheme is now always lowercased. + +## 6.0.0-beta.1 + +* Requires PHP >= 5.5 +* Updated to use PSR-7 + * Requires immutable messages, which basically means an event based system + owned by a request instance is no longer possible. + * Utilizing the [Guzzle PSR-7 package](https://github.com/guzzle/psr7). + * Removed the dependency on `guzzlehttp/streams`. These stream abstractions + are available in the `guzzlehttp/psr7` package under the `GuzzleHttp\Psr7` + namespace. +* Added middleware and handler system + * Replaced the Guzzle event and subscriber system with a middleware system. + * No longer depends on RingPHP, but rather places the HTTP handlers directly + in Guzzle, operating on PSR-7 messages. + * Retry logic is now encapsulated in `GuzzleHttp\Middleware::retry`, which + means the `guzzlehttp/retry-subscriber` is now obsolete. + * Mocking responses is now handled using `GuzzleHttp\Handler\MockHandler`. +* Asynchronous responses + * No longer supports the `future` request option to send an async request. + Instead, use one of the `*Async` methods of a client (e.g., `requestAsync`, + `getAsync`, etc.). + * Utilizing `GuzzleHttp\Promise` instead of React's promise library to avoid + recursion required by chaining and forwarding react promises. See + https://github.com/guzzle/promises + * Added `requestAsync` and `sendAsync` to send request asynchronously. + * Added magic methods for `getAsync()`, `postAsync()`, etc. to send requests + asynchronously. +* Request options + * POST and form updates + * Added the `form_fields` and `form_files` request options. + * Removed the `GuzzleHttp\Post` namespace. + * The `body` request option no longer accepts an array for POST requests. + * The `exceptions` request option has been deprecated in favor of the + `http_errors` request options. + * The `save_to` request option has been deprecated in favor of `sink` request + option. +* Clients no longer accept an array of URI template string and variables for + URI variables. You will need to expand URI templates before passing them + into a client constructor or request method. +* Client methods `get()`, `post()`, `put()`, `patch()`, `options()`, etc. are + now magic methods that will send synchronous requests. +* Replaced `Utils.php` with plain functions in `functions.php`. +* Removed `GuzzleHttp\Collection`. +* Removed `GuzzleHttp\BatchResults`. Batched pool results are now returned as + an array. +* Removed `GuzzleHttp\Query`. Query string handling is now handled using an + associative array passed into the `query` request option. The query string + is serialized using PHP's `http_build_query`. If you need more control, you + can pass the query string in as a string. +* `GuzzleHttp\QueryParser` has been replaced with the + `GuzzleHttp\Psr7\parse_query`. + +## 5.2.0 - 2015-01-27 + +* Added `AppliesHeadersInterface` to make applying headers to a request based + on the body more generic and not specific to `PostBodyInterface`. +* Reduced the number of stack frames needed to send requests. +* Nested futures are now resolved in the client rather than the RequestFsm +* Finishing state transitions is now handled in the RequestFsm rather than the + RingBridge. +* Added a guard in the Pool class to not use recursion for request retries. + +## 5.1.0 - 2014-12-19 + +* Pool class no longer uses recursion when a request is intercepted. +* The size of a Pool can now be dynamically adjusted using a callback. + See https://github.com/guzzle/guzzle/pull/943. +* Setting a request option to `null` when creating a request with a client will + ensure that the option is not set. This allows you to overwrite default + request options on a per-request basis. + See https://github.com/guzzle/guzzle/pull/937. +* Added the ability to limit which protocols are allowed for redirects by + specifying a `protocols` array in the `allow_redirects` request option. +* Nested futures due to retries are now resolved when waiting for synchronous + responses. See https://github.com/guzzle/guzzle/pull/947. +* `"0"` is now an allowed URI path. See + https://github.com/guzzle/guzzle/pull/935. +* `Query` no longer typehints on the `$query` argument in the constructor, + allowing for strings and arrays. +* Exceptions thrown in the `end` event are now correctly wrapped with Guzzle + specific exceptions if necessary. + +## 5.0.3 - 2014-11-03 + +This change updates query strings so that they are treated as un-encoded values +by default where the value represents an un-encoded value to send over the +wire. A Query object then encodes the value before sending over the wire. This +means that even value query string values (e.g., ":") are url encoded. This +makes the Query class match PHP's http_build_query function. However, if you +want to send requests over the wire using valid query string characters that do +not need to be encoded, then you can provide a string to Url::setQuery() and +pass true as the second argument to specify that the query string is a raw +string that should not be parsed or encoded (unless a call to getQuery() is +subsequently made, forcing the query-string to be converted into a Query +object). + +## 5.0.2 - 2014-10-30 + +* Added a trailing `\r\n` to multipart/form-data payloads. See + https://github.com/guzzle/guzzle/pull/871 +* Added a `GuzzleHttp\Pool::send()` convenience method to match the docs. +* Status codes are now returned as integers. See + https://github.com/guzzle/guzzle/issues/881 +* No longer overwriting an existing `application/x-www-form-urlencoded` header + when sending POST requests, allowing for customized headers. See + https://github.com/guzzle/guzzle/issues/877 +* Improved path URL serialization. + + * No longer double percent-encoding characters in the path or query string if + they are already encoded. + * Now properly encoding the supplied path to a URL object, instead of only + encoding ' ' and '?'. + * Note: This has been changed in 5.0.3 to now encode query string values by + default unless the `rawString` argument is provided when setting the query + string on a URL: Now allowing many more characters to be present in the + query string without being percent encoded. See http://tools.ietf.org/html/rfc3986#appendix-A + +## 5.0.1 - 2014-10-16 + +Bugfix release. + +* Fixed an issue where connection errors still returned response object in + error and end events event though the response is unusable. This has been + corrected so that a response is not returned in the `getResponse` method of + these events if the response did not complete. https://github.com/guzzle/guzzle/issues/867 +* Fixed an issue where transfer statistics were not being populated in the + RingBridge. https://github.com/guzzle/guzzle/issues/866 + +## 5.0.0 - 2014-10-12 + +Adding support for non-blocking responses and some minor API cleanup. + +### New Features + +* Added support for non-blocking responses based on `guzzlehttp/guzzle-ring`. +* Added a public API for creating a default HTTP adapter. +* Updated the redirect plugin to be non-blocking so that redirects are sent + concurrently. Other plugins like this can now be updated to be non-blocking. +* Added a "progress" event so that you can get upload and download progress + events. +* Added `GuzzleHttp\Pool` which implements FutureInterface and transfers + requests concurrently using a capped pool size as efficiently as possible. +* Added `hasListeners()` to EmitterInterface. +* Removed `GuzzleHttp\ClientInterface::sendAll` and marked + `GuzzleHttp\Client::sendAll` as deprecated (it's still there, just not the + recommended way). + +### Breaking changes + +The breaking changes in this release are relatively minor. The biggest thing to +look out for is that request and response objects no longer implement fluent +interfaces. + +* Removed the fluent interfaces (i.e., `return $this`) from requests, + responses, `GuzzleHttp\Collection`, `GuzzleHttp\Url`, + `GuzzleHttp\Query`, `GuzzleHttp\Post\PostBody`, and + `GuzzleHttp\Cookie\SetCookie`. This blog post provides a good outline of + why I did this: http://ocramius.github.io/blog/fluent-interfaces-are-evil/. + This also makes the Guzzle message interfaces compatible with the current + PSR-7 message proposal. +* Removed "functions.php", so that Guzzle is truly PSR-4 compliant. Except + for the HTTP request functions from function.php, these functions are now + implemented in `GuzzleHttp\Utils` using camelCase. `GuzzleHttp\json_decode` + moved to `GuzzleHttp\Utils::jsonDecode`. `GuzzleHttp\get_path` moved to + `GuzzleHttp\Utils::getPath`. `GuzzleHttp\set_path` moved to + `GuzzleHttp\Utils::setPath`. `GuzzleHttp\batch` should now be + `GuzzleHttp\Pool::batch`, which returns an `objectStorage`. Using functions.php + caused problems for many users: they aren't PSR-4 compliant, require an + explicit include, and needed an if-guard to ensure that the functions are not + declared multiple times. +* Rewrote adapter layer. + * Removing all classes from `GuzzleHttp\Adapter`, these are now + implemented as callables that are stored in `GuzzleHttp\Ring\Client`. + * Removed the concept of "parallel adapters". Sending requests serially or + concurrently is now handled using a single adapter. + * Moved `GuzzleHttp\Adapter\Transaction` to `GuzzleHttp\Transaction`. The + Transaction object now exposes the request, response, and client as public + properties. The getters and setters have been removed. +* Removed the "headers" event. This event was only useful for changing the + body a response once the headers of the response were known. You can implement + a similar behavior in a number of ways. One example might be to use a + FnStream that has access to the transaction being sent. For example, when the + first byte is written, you could check if the response headers match your + expectations, and if so, change the actual stream body that is being + written to. +* Removed the `asArray` parameter from + `GuzzleHttp\Message\MessageInterface::getHeader`. If you want to get a header + value as an array, then use the newly added `getHeaderAsArray()` method of + `MessageInterface`. This change makes the Guzzle interfaces compatible with + the PSR-7 interfaces. +* `GuzzleHttp\Message\MessageFactory` no longer allows subclasses to add + custom request options using double-dispatch (this was an implementation + detail). Instead, you should now provide an associative array to the + constructor which is a mapping of the request option name mapping to a + function that applies the option value to a request. +* Removed the concept of "throwImmediately" from exceptions and error events. + This control mechanism was used to stop a transfer of concurrent requests + from completing. This can now be handled by throwing the exception or by + cancelling a pool of requests or each outstanding future request individually. +* Updated to "GuzzleHttp\Streams" 3.0. + * `GuzzleHttp\Stream\StreamInterface::getContents()` no longer accepts a + `maxLen` parameter. This update makes the Guzzle streams project + compatible with the current PSR-7 proposal. + * `GuzzleHttp\Stream\Stream::__construct`, + `GuzzleHttp\Stream\Stream::factory`, and + `GuzzleHttp\Stream\Utils::create` no longer accept a size in the second + argument. They now accept an associative array of options, including the + "size" key and "metadata" key which can be used to provide custom metadata. + +## 4.2.2 - 2014-09-08 + +* Fixed a memory leak in the CurlAdapter when reusing cURL handles. +* No longer using `request_fulluri` in stream adapter proxies. +* Relative redirects are now based on the last response, not the first response. + +## 4.2.1 - 2014-08-19 + +* Ensuring that the StreamAdapter does not always add a Content-Type header +* Adding automated github releases with a phar and zip + +## 4.2.0 - 2014-08-17 + +* Now merging in default options using a case-insensitive comparison. + Closes https://github.com/guzzle/guzzle/issues/767 +* Added the ability to automatically decode `Content-Encoding` response bodies + using the `decode_content` request option. This is set to `true` by default + to decode the response body if it comes over the wire with a + `Content-Encoding`. Set this value to `false` to disable decoding the + response content, and pass a string to provide a request `Accept-Encoding` + header and turn on automatic response decoding. This feature now allows you + to pass an `Accept-Encoding` header in the headers of a request but still + disable automatic response decoding. + Closes https://github.com/guzzle/guzzle/issues/764 +* Added the ability to throw an exception immediately when transferring + requests in parallel. Closes https://github.com/guzzle/guzzle/issues/760 +* Updating guzzlehttp/streams dependency to ~2.1 +* No longer utilizing the now deprecated namespaced methods from the stream + package. + +## 4.1.8 - 2014-08-14 + +* Fixed an issue in the CurlFactory that caused setting the `stream=false` + request option to throw an exception. + See: https://github.com/guzzle/guzzle/issues/769 +* TransactionIterator now calls rewind on the inner iterator. + See: https://github.com/guzzle/guzzle/pull/765 +* You can now set the `Content-Type` header to `multipart/form-data` + when creating POST requests to force multipart bodies. + See https://github.com/guzzle/guzzle/issues/768 + +## 4.1.7 - 2014-08-07 + +* Fixed an error in the HistoryPlugin that caused the same request and response + to be logged multiple times when an HTTP protocol error occurs. +* Ensuring that cURL does not add a default Content-Type when no Content-Type + has been supplied by the user. This prevents the adapter layer from modifying + the request that is sent over the wire after any listeners may have already + put the request in a desired state (e.g., signed the request). +* Throwing an exception when you attempt to send requests that have the + "stream" set to true in parallel using the MultiAdapter. +* Only calling curl_multi_select when there are active cURL handles. This was + previously changed and caused performance problems on some systems due to PHP + always selecting until the maximum select timeout. +* Fixed a bug where multipart/form-data POST fields were not correctly + aggregated (e.g., values with "&"). + +## 4.1.6 - 2014-08-03 + +* Added helper methods to make it easier to represent messages as strings, + including getting the start line and getting headers as a string. + +## 4.1.5 - 2014-08-02 + +* Automatically retrying cURL "Connection died, retrying a fresh connect" + errors when possible. +* cURL implementation cleanup +* Allowing multiple event subscriber listeners to be registered per event by + passing an array of arrays of listener configuration. + +## 4.1.4 - 2014-07-22 + +* Fixed a bug that caused multi-part POST requests with more than one field to + serialize incorrectly. +* Paths can now be set to "0" +* `ResponseInterface::xml` now accepts a `libxml_options` option and added a + missing default argument that was required when parsing XML response bodies. +* A `save_to` stream is now created lazily, which means that files are not + created on disk unless a request succeeds. + +## 4.1.3 - 2014-07-15 + +* Various fixes to multipart/form-data POST uploads +* Wrapping function.php in an if-statement to ensure Guzzle can be used + globally and in a Composer install +* Fixed an issue with generating and merging in events to an event array +* POST headers are only applied before sending a request to allow you to change + the query aggregator used before uploading +* Added much more robust query string parsing +* Fixed various parsing and normalization issues with URLs +* Fixing an issue where multi-valued headers were not being utilized correctly + in the StreamAdapter + +## 4.1.2 - 2014-06-18 + +* Added support for sending payloads with GET requests + +## 4.1.1 - 2014-06-08 + +* Fixed an issue related to using custom message factory options in subclasses +* Fixed an issue with nested form fields in a multi-part POST +* Fixed an issue with using the `json` request option for POST requests +* Added `ToArrayInterface` to `GuzzleHttp\Cookie\CookieJar` + +## 4.1.0 - 2014-05-27 + +* Added a `json` request option to easily serialize JSON payloads. +* Added a `GuzzleHttp\json_decode()` wrapper to safely parse JSON. +* Added `setPort()` and `getPort()` to `GuzzleHttp\Message\RequestInterface`. +* Added the ability to provide an emitter to a client in the client constructor. +* Added the ability to persist a cookie session using $_SESSION. +* Added a trait that can be used to add event listeners to an iterator. +* Removed request method constants from RequestInterface. +* Fixed warning when invalid request start-lines are received. +* Updated MessageFactory to work with custom request option methods. +* Updated cacert bundle to latest build. + +4.0.2 (2014-04-16) +------------------ + +* Proxy requests using the StreamAdapter now properly use request_fulluri (#632) +* Added the ability to set scalars as POST fields (#628) + +## 4.0.1 - 2014-04-04 + +* The HTTP status code of a response is now set as the exception code of + RequestException objects. +* 303 redirects will now correctly switch from POST to GET requests. +* The default parallel adapter of a client now correctly uses the MultiAdapter. +* HasDataTrait now initializes the internal data array as an empty array so + that the toArray() method always returns an array. + +## 4.0.0 - 2014-03-29 + +* For more information on the 4.0 transition, see: + http://mtdowling.com/blog/2014/03/15/guzzle-4-rc/ +* For information on changes and upgrading, see: + https://github.com/guzzle/guzzle/blob/master/UPGRADING.md#3x-to-40 +* Added `GuzzleHttp\batch()` as a convenience function for sending requests in + parallel without needing to write asynchronous code. +* Restructured how events are added to `GuzzleHttp\ClientInterface::sendAll()`. + You can now pass a callable or an array of associative arrays where each + associative array contains the "fn", "priority", and "once" keys. + +## 4.0.0.rc-2 - 2014-03-25 + +* Removed `getConfig()` and `setConfig()` from clients to avoid confusion + around whether things like base_url, message_factory, etc. should be able to + be retrieved or modified. +* Added `getDefaultOption()` and `setDefaultOption()` to ClientInterface +* functions.php functions were renamed using snake_case to match PHP idioms +* Added support for `HTTP_PROXY`, `HTTPS_PROXY`, and + `GUZZLE_CURL_SELECT_TIMEOUT` environment variables +* Added the ability to specify custom `sendAll()` event priorities +* Added the ability to specify custom stream context options to the stream + adapter. +* Added a functions.php function for `get_path()` and `set_path()` +* CurlAdapter and MultiAdapter now use a callable to generate curl resources +* MockAdapter now properly reads a body and emits a `headers` event +* Updated Url class to check if a scheme and host are set before adding ":" + and "//". This allows empty Url (e.g., "") to be serialized as "". +* Parsing invalid XML no longer emits warnings +* Curl classes now properly throw AdapterExceptions +* Various performance optimizations +* Streams are created with the faster `Stream\create()` function +* Marked deprecation_proxy() as internal +* Test server is now a collection of static methods on a class + +## 4.0.0-rc.1 - 2014-03-15 + +* See https://github.com/guzzle/guzzle/blob/master/UPGRADING.md#3x-to-40 + +## 3.8.1 - 2014-01-28 + +* Bug: Always using GET requests when redirecting from a 303 response +* Bug: CURLOPT_SSL_VERIFYHOST is now correctly set to false when setting `$certificateAuthority` to false in + `Guzzle\Http\ClientInterface::setSslVerification()` +* Bug: RedirectPlugin now uses strict RFC 3986 compliance when combining a base URL with a relative URL +* Bug: The body of a request can now be set to `"0"` +* Sending PHP stream requests no longer forces `HTTP/1.0` +* Adding more information to ExceptionCollection exceptions so that users have more context, including a stack trace of + each sub-exception +* Updated the `$ref` attribute in service descriptions to merge over any existing parameters of a schema (rather than + clobbering everything). +* Merging URLs will now use the query string object from the relative URL (thus allowing custom query aggregators) +* Query strings are now parsed in a way that they do no convert empty keys with no value to have a dangling `=`. + For example `foo&bar=baz` is now correctly parsed and recognized as `foo&bar=baz` rather than `foo=&bar=baz`. +* Now properly escaping the regular expression delimiter when matching Cookie domains. +* Network access is now disabled when loading XML documents + +## 3.8.0 - 2013-12-05 + +* Added the ability to define a POST name for a file +* JSON response parsing now properly walks additionalProperties +* cURL error code 18 is now retried automatically in the BackoffPlugin +* Fixed a cURL error when URLs contain fragments +* Fixed an issue in the BackoffPlugin retry event where it was trying to access all exceptions as if they were + CurlExceptions +* CURLOPT_PROGRESS function fix for PHP 5.5 (69fcc1e) +* Added the ability for Guzzle to work with older versions of cURL that do not support `CURLOPT_TIMEOUT_MS` +* Fixed a bug that was encountered when parsing empty header parameters +* UriTemplate now has a `setRegex()` method to match the docs +* The `debug` request parameter now checks if it is truthy rather than if it exists +* Setting the `debug` request parameter to true shows verbose cURL output instead of using the LogPlugin +* Added the ability to combine URLs using strict RFC 3986 compliance +* Command objects can now return the validation errors encountered by the command +* Various fixes to cache revalidation (#437 and 29797e5) +* Various fixes to the AsyncPlugin +* Cleaned up build scripts + +## 3.7.4 - 2013-10-02 + +* Bug fix: 0 is now an allowed value in a description parameter that has a default value (#430) +* Bug fix: SchemaFormatter now returns an integer when formatting to a Unix timestamp + (see https://github.com/aws/aws-sdk-php/issues/147) +* Bug fix: Cleaned up and fixed URL dot segment removal to properly resolve internal dots +* Minimum PHP version is now properly specified as 5.3.3 (up from 5.3.2) (#420) +* Updated the bundled cacert.pem (#419) +* OauthPlugin now supports adding authentication to headers or query string (#425) + +## 3.7.3 - 2013-09-08 + +* Added the ability to get the exception associated with a request/command when using `MultiTransferException` and + `CommandTransferException`. +* Setting `additionalParameters` of a response to false is now honored when parsing responses with a service description +* Schemas are only injected into response models when explicitly configured. +* No longer guessing Content-Type based on the path of a request. Content-Type is now only guessed based on the path of + an EntityBody. +* Bug fix: ChunkedIterator can now properly chunk a \Traversable as well as an \Iterator. +* Bug fix: FilterIterator now relies on `\Iterator` instead of `\Traversable`. +* Bug fix: Gracefully handling malformed responses in RequestMediator::writeResponseBody() +* Bug fix: Replaced call to canCache with canCacheRequest in the CallbackCanCacheStrategy of the CachePlugin +* Bug fix: Visiting XML attributes first before visiting XML children when serializing requests +* Bug fix: Properly parsing headers that contain commas contained in quotes +* Bug fix: mimetype guessing based on a filename is now case-insensitive + +## 3.7.2 - 2013-08-02 + +* Bug fix: Properly URL encoding paths when using the PHP-only version of the UriTemplate expander + See https://github.com/guzzle/guzzle/issues/371 +* Bug fix: Cookie domains are now matched correctly according to RFC 6265 + See https://github.com/guzzle/guzzle/issues/377 +* Bug fix: GET parameters are now used when calculating an OAuth signature +* Bug fix: Fixed an issue with cache revalidation where the If-None-Match header was being double quoted +* `Guzzle\Common\AbstractHasDispatcher::dispatch()` now returns the event that was dispatched +* `Guzzle\Http\QueryString::factory()` now guesses the most appropriate query aggregator to used based on the input. + See https://github.com/guzzle/guzzle/issues/379 +* Added a way to add custom domain objects to service description parsing using the `operation.parse_class` event. See + https://github.com/guzzle/guzzle/pull/380 +* cURL multi cleanup and optimizations + +## 3.7.1 - 2013-07-05 + +* Bug fix: Setting default options on a client now works +* Bug fix: Setting options on HEAD requests now works. See #352 +* Bug fix: Moving stream factory before send event to before building the stream. See #353 +* Bug fix: Cookies no longer match on IP addresses per RFC 6265 +* Bug fix: Correctly parsing header parameters that are in `<>` and quotes +* Added `cert` and `ssl_key` as request options +* `Host` header can now diverge from the host part of a URL if the header is set manually +* `Guzzle\Service\Command\LocationVisitor\Request\XmlVisitor` was rewritten to change from using SimpleXML to XMLWriter +* OAuth parameters are only added via the plugin if they aren't already set +* Exceptions are now thrown when a URL cannot be parsed +* Returning `false` if `Guzzle\Http\EntityBody::getContentMd5()` fails +* Not setting a `Content-MD5` on a command if calculating the Content-MD5 fails via the CommandContentMd5Plugin + +## 3.7.0 - 2013-06-10 + +* See UPGRADING.md for more information on how to upgrade. +* Requests now support the ability to specify an array of $options when creating a request to more easily modify a + request. You can pass a 'request.options' configuration setting to a client to apply default request options to + every request created by a client (e.g. default query string variables, headers, curl options, etc.). +* Added a static facade class that allows you to use Guzzle with static methods and mount the class to `\Guzzle`. + See `Guzzle\Http\StaticClient::mount`. +* Added `command.request_options` to `Guzzle\Service\Command\AbstractCommand` to pass request options to requests + created by a command (e.g. custom headers, query string variables, timeout settings, etc.). +* Stream size in `Guzzle\Stream\PhpStreamRequestFactory` will now be set if Content-Length is returned in the + headers of a response +* Added `Guzzle\Common\Collection::setPath($path, $value)` to set a value into an array using a nested key + (e.g. `$collection->setPath('foo/baz/bar', 'test'); echo $collection['foo']['bar']['bar'];`) +* ServiceBuilders now support storing and retrieving arbitrary data +* CachePlugin can now purge all resources for a given URI +* CachePlugin can automatically purge matching cached items when a non-idempotent request is sent to a resource +* CachePlugin now uses the Vary header to determine if a resource is a cache hit +* `Guzzle\Http\Message\Response` now implements `\Serializable` +* Added `Guzzle\Cache\CacheAdapterFactory::fromCache()` to more easily create cache adapters +* `Guzzle\Service\ClientInterface::execute()` now accepts an array, single command, or Traversable +* Fixed a bug in `Guzzle\Http\Message\Header\Link::addLink()` +* Better handling of calculating the size of a stream in `Guzzle\Stream\Stream` using fstat() and caching the size +* `Guzzle\Common\Exception\ExceptionCollection` now creates a more readable exception message +* Fixing BC break: Added back the MonologLogAdapter implementation rather than extending from PsrLog so that older + Symfony users can still use the old version of Monolog. +* Fixing BC break: Added the implementation back in for `Guzzle\Http\Message\AbstractMessage::getTokenizedHeader()`. + Now triggering an E_USER_DEPRECATED warning when used. Use `$message->getHeader()->parseParams()`. +* Several performance improvements to `Guzzle\Common\Collection` +* Added an `$options` argument to the end of the following methods of `Guzzle\Http\ClientInterface`: + createRequest, head, delete, put, patch, post, options, prepareRequest +* Added an `$options` argument to the end of `Guzzle\Http\Message\Request\RequestFactoryInterface::createRequest()` +* Added an `applyOptions()` method to `Guzzle\Http\Message\Request\RequestFactoryInterface` +* Changed `Guzzle\Http\ClientInterface::get($uri = null, $headers = null, $body = null)` to + `Guzzle\Http\ClientInterface::get($uri = null, $headers = null, $options = array())`. You can still pass in a + resource, string, or EntityBody into the $options parameter to specify the download location of the response. +* Changed `Guzzle\Common\Collection::__construct($data)` to no longer accepts a null value for `$data` but a + default `array()` +* Added `Guzzle\Stream\StreamInterface::isRepeatable` +* Removed `Guzzle\Http\ClientInterface::setDefaultHeaders(). Use + $client->getConfig()->setPath('request.options/headers/{header_name}', 'value')`. or + $client->getConfig()->setPath('request.options/headers', array('header_name' => 'value'))`. +* Removed `Guzzle\Http\ClientInterface::getDefaultHeaders(). Use $client->getConfig()->getPath('request.options/headers')`. +* Removed `Guzzle\Http\ClientInterface::expandTemplate()` +* Removed `Guzzle\Http\ClientInterface::setRequestFactory()` +* Removed `Guzzle\Http\ClientInterface::getCurlMulti()` +* Removed `Guzzle\Http\Message\RequestInterface::canCache` +* Removed `Guzzle\Http\Message\RequestInterface::setIsRedirect` +* Removed `Guzzle\Http\Message\RequestInterface::isRedirect` +* Made `Guzzle\Http\Client::expandTemplate` and `getUriTemplate` protected methods. +* You can now enable E_USER_DEPRECATED warnings to see if you are using a deprecated method by setting + `Guzzle\Common\Version::$emitWarnings` to true. +* Marked `Guzzle\Http\Message\Request::isResponseBodyRepeatable()` as deprecated. Use + `$request->getResponseBody()->isRepeatable()` instead. +* Marked `Guzzle\Http\Message\Request::canCache()` as deprecated. Use + `Guzzle\Plugin\Cache\DefaultCanCacheStrategy->canCacheRequest()` instead. +* Marked `Guzzle\Http\Message\Request::canCache()` as deprecated. Use + `Guzzle\Plugin\Cache\DefaultCanCacheStrategy->canCacheRequest()` instead. +* Marked `Guzzle\Http\Message\Request::setIsRedirect()` as deprecated. Use the HistoryPlugin instead. +* Marked `Guzzle\Http\Message\Request::isRedirect()` as deprecated. Use the HistoryPlugin instead. +* Marked `Guzzle\Cache\CacheAdapterFactory::factory()` as deprecated +* Marked 'command.headers', 'command.response_body' and 'command.on_complete' as deprecated for AbstractCommand. + These will work through Guzzle 4.0 +* Marked 'request.params' for `Guzzle\Http\Client` as deprecated. Use [request.options][params]. +* Marked `Guzzle\Service\Client::enableMagicMethods()` as deprecated. Magic methods can no longer be disabled on a Guzzle\Service\Client. +* Marked `Guzzle\Service\Client::getDefaultHeaders()` as deprecated. Use $client->getConfig()->getPath('request.options/headers')`. +* Marked `Guzzle\Service\Client::setDefaultHeaders()` as deprecated. Use $client->getConfig()->setPath('request.options/headers/{header_name}', 'value')`. +* Marked `Guzzle\Parser\Url\UrlParser` as deprecated. Just use PHP's `parse_url()` and percent encode your UTF-8. +* Marked `Guzzle\Common\Collection::inject()` as deprecated. +* Marked `Guzzle\Plugin\CurlAuth\CurlAuthPlugin` as deprecated. Use `$client->getConfig()->setPath('request.options/auth', array('user', 'pass', 'Basic|Digest');` +* CacheKeyProviderInterface and DefaultCacheKeyProvider are no longer used. All of this logic is handled in a + CacheStorageInterface. These two objects and interface will be removed in a future version. +* Always setting X-cache headers on cached responses +* Default cache TTLs are now handled by the CacheStorageInterface of a CachePlugin +* `CacheStorageInterface::cache($key, Response $response, $ttl = null)` has changed to `cache(RequestInterface + $request, Response $response);` +* `CacheStorageInterface::fetch($key)` has changed to `fetch(RequestInterface $request);` +* `CacheStorageInterface::delete($key)` has changed to `delete(RequestInterface $request);` +* Added `CacheStorageInterface::purge($url)` +* `DefaultRevalidation::__construct(CacheKeyProviderInterface $cacheKey, CacheStorageInterface $cache, CachePlugin + $plugin)` has changed to `DefaultRevalidation::__construct(CacheStorageInterface $cache, + CanCacheStrategyInterface $canCache = null)` +* Added `RevalidationInterface::shouldRevalidate(RequestInterface $request, Response $response)` + +## 3.6.0 - 2013-05-29 + +* ServiceDescription now implements ToArrayInterface +* Added command.hidden_params to blacklist certain headers from being treated as additionalParameters +* Guzzle can now correctly parse incomplete URLs +* Mixed casing of headers are now forced to be a single consistent casing across all values for that header. +* Messages internally use a HeaderCollection object to delegate handling case-insensitive header resolution +* Removed the whole changedHeader() function system of messages because all header changes now go through addHeader(). +* Specific header implementations can be created for complex headers. When a message creates a header, it uses a + HeaderFactory which can map specific headers to specific header classes. There is now a Link header and + CacheControl header implementation. +* Removed from interface: Guzzle\Http\ClientInterface::setUriTemplate +* Removed from interface: Guzzle\Http\ClientInterface::setCurlMulti() +* Removed Guzzle\Http\Message\Request::receivedRequestHeader() and implemented this functionality in + Guzzle\Http\Curl\RequestMediator +* Removed the optional $asString parameter from MessageInterface::getHeader(). Just cast the header to a string. +* Removed the optional $tryChunkedTransfer option from Guzzle\Http\Message\EntityEnclosingRequestInterface +* Removed the $asObjects argument from Guzzle\Http\Message\MessageInterface::getHeaders() +* Removed Guzzle\Parser\ParserRegister::get(). Use getParser() +* Removed Guzzle\Parser\ParserRegister::set(). Use registerParser(). +* All response header helper functions return a string rather than mixing Header objects and strings inconsistently +* Removed cURL blacklist support. This is no longer necessary now that Expect, Accept, etc. are managed by Guzzle + directly via interfaces +* Removed the injecting of a request object onto a response object. The methods to get and set a request still exist + but are a no-op until removed. +* Most classes that used to require a `Guzzle\Service\Command\CommandInterface` typehint now request a + `Guzzle\Service\Command\ArrayCommandInterface`. +* Added `Guzzle\Http\Message\RequestInterface::startResponse()` to the RequestInterface to handle injecting a response + on a request while the request is still being transferred +* The ability to case-insensitively search for header values +* Guzzle\Http\Message\Header::hasExactHeader +* Guzzle\Http\Message\Header::raw. Use getAll() +* Deprecated cache control specific methods on Guzzle\Http\Message\AbstractMessage. Use the CacheControl header object + instead. +* `Guzzle\Service\Command\CommandInterface` now extends from ToArrayInterface and ArrayAccess +* Added the ability to cast Model objects to a string to view debug information. + +## 3.5.0 - 2013-05-13 + +* Bug: Fixed a regression so that request responses are parsed only once per oncomplete event rather than multiple times +* Bug: Better cleanup of one-time events across the board (when an event is meant to fire once, it will now remove + itself from the EventDispatcher) +* Bug: `Guzzle\Log\MessageFormatter` now properly writes "total_time" and "connect_time" values +* Bug: Cloning an EntityEnclosingRequest now clones the EntityBody too +* Bug: Fixed an undefined index error when parsing nested JSON responses with a sentAs parameter that reference a + non-existent key +* Bug: All __call() method arguments are now required (helps with mocking frameworks) +* Deprecating Response::getRequest() and now using a shallow clone of a request object to remove a circular reference + to help with refcount based garbage collection of resources created by sending a request +* Deprecating ZF1 cache and log adapters. These will be removed in the next major version. +* Deprecating `Response::getPreviousResponse()` (method signature still exists, but it's deprecated). Use the + HistoryPlugin for a history. +* Added a `responseBody` alias for the `response_body` location +* Refactored internals to no longer rely on Response::getRequest() +* HistoryPlugin can now be cast to a string +* HistoryPlugin now logs transactions rather than requests and responses to more accurately keep track of the requests + and responses that are sent over the wire +* Added `getEffectiveUrl()` and `getRedirectCount()` to Response objects + +## 3.4.3 - 2013-04-30 + +* Bug fix: Fixing bug introduced in 3.4.2 where redirect responses are duplicated on the final redirected response +* Added a check to re-extract the temp cacert bundle from the phar before sending each request + +## 3.4.2 - 2013-04-29 + +* Bug fix: Stream objects now work correctly with "a" and "a+" modes +* Bug fix: Removing `Transfer-Encoding: chunked` header when a Content-Length is present +* Bug fix: AsyncPlugin no longer forces HEAD requests +* Bug fix: DateTime timezones are now properly handled when using the service description schema formatter +* Bug fix: CachePlugin now properly handles stale-if-error directives when a request to the origin server fails +* Setting a response on a request will write to the custom request body from the response body if one is specified +* LogPlugin now writes to php://output when STDERR is undefined +* Added the ability to set multiple POST files for the same key in a single call +* application/x-www-form-urlencoded POSTs now use the utf-8 charset by default +* Added the ability to queue CurlExceptions to the MockPlugin +* Cleaned up how manual responses are queued on requests (removed "queued_response" and now using request.before_send) +* Configuration loading now allows remote files + +## 3.4.1 - 2013-04-16 + +* Large refactoring to how CurlMulti handles work. There is now a proxy that sits in front of a pool of CurlMulti + handles. This greatly simplifies the implementation, fixes a couple bugs, and provides a small performance boost. +* Exceptions are now properly grouped when sending requests in parallel +* Redirects are now properly aggregated when a multi transaction fails +* Redirects now set the response on the original object even in the event of a failure +* Bug fix: Model names are now properly set even when using $refs +* Added support for PHP 5.5's CurlFile to prevent warnings with the deprecated @ syntax +* Added support for oauth_callback in OAuth signatures +* Added support for oauth_verifier in OAuth signatures +* Added support to attempt to retrieve a command first literally, then ucfirst, the with inflection + +## 3.4.0 - 2013-04-11 + +* Bug fix: URLs are now resolved correctly based on http://tools.ietf.org/html/rfc3986#section-5.2. #289 +* Bug fix: Absolute URLs with a path in a service description will now properly override the base URL. #289 +* Bug fix: Parsing a query string with a single PHP array value will now result in an array. #263 +* Bug fix: Better normalization of the User-Agent header to prevent duplicate headers. #264. +* Bug fix: Added `number` type to service descriptions. +* Bug fix: empty parameters are removed from an OAuth signature +* Bug fix: Revalidating a cache entry prefers the Last-Modified over the Date header +* Bug fix: Fixed "array to string" error when validating a union of types in a service description +* Bug fix: Removed code that attempted to determine the size of a stream when data is written to the stream +* Bug fix: Not including an `oauth_token` if the value is null in the OauthPlugin. +* Bug fix: Now correctly aggregating successful requests and failed requests in CurlMulti when a redirect occurs. +* The new default CURLOPT_TIMEOUT setting has been increased to 150 seconds so that Guzzle works on poor connections. +* Added a feature to EntityEnclosingRequest::setBody() that will automatically set the Content-Type of the request if + the Content-Type can be determined based on the entity body or the path of the request. +* Added the ability to overwrite configuration settings in a client when grabbing a throwaway client from a builder. +* Added support for a PSR-3 LogAdapter. +* Added a `command.after_prepare` event +* Added `oauth_callback` parameter to the OauthPlugin +* Added the ability to create a custom stream class when using a stream factory +* Added a CachingEntityBody decorator +* Added support for `additionalParameters` in service descriptions to define how custom parameters are serialized. +* The bundled SSL certificate is now provided in the phar file and extracted when running Guzzle from a phar. +* You can now send any EntityEnclosingRequest with POST fields or POST files and cURL will handle creating bodies +* POST requests using a custom entity body are now treated exactly like PUT requests but with a custom cURL method. This + means that the redirect behavior of POST requests with custom bodies will not be the same as POST requests that use + POST fields or files (the latter is only used when emulating a form POST in the browser). +* Lots of cleanup to CurlHandle::factory and RequestFactory::createRequest + +## 3.3.1 - 2013-03-10 + +* Added the ability to create PHP streaming responses from HTTP requests +* Bug fix: Running any filters when parsing response headers with service descriptions +* Bug fix: OauthPlugin fixes to allow for multi-dimensional array signing, and sorting parameters before signing +* Bug fix: Removed the adding of default empty arrays and false Booleans to responses in order to be consistent across + response location visitors. +* Bug fix: Removed the possibility of creating configuration files with circular dependencies +* RequestFactory::create() now uses the key of a POST file when setting the POST file name +* Added xmlAllowEmpty to serialize an XML body even if no XML specific parameters are set + +## 3.3.0 - 2013-03-03 + +* A large number of performance optimizations have been made +* Bug fix: Added 'wb' as a valid write mode for streams +* Bug fix: `Guzzle\Http\Message\Response::json()` now allows scalar values to be returned +* Bug fix: Fixed bug in `Guzzle\Http\Message\Response` where wrapping quotes were stripped from `getEtag()` +* BC: Removed `Guzzle\Http\Utils` class +* BC: Setting a service description on a client will no longer modify the client's command factories. +* BC: Emitting IO events from a RequestMediator is now a parameter that must be set in a request's curl options using + the 'emit_io' key. This was previously set under a request's parameters using 'curl.emit_io' +* BC: `Guzzle\Stream\Stream::getWrapper()` and `Guzzle\Stream\Stream::getSteamType()` are no longer converted to + lowercase +* Operation parameter objects are now lazy loaded internally +* Added ErrorResponsePlugin that can throw errors for responses defined in service description operations' errorResponses +* Added support for instantiating responseType=class responseClass classes. Classes must implement + `Guzzle\Service\Command\ResponseClassInterface` +* Added support for additionalProperties for top-level parameters in responseType=model responseClasses. These + additional properties also support locations and can be used to parse JSON responses where the outermost part of the + JSON is an array +* Added support for nested renaming of JSON models (rename sentAs to name) +* CachePlugin + * Added support for stale-if-error so that the CachePlugin can now serve stale content from the cache on error + * Debug headers can now added to cached response in the CachePlugin + +## 3.2.0 - 2013-02-14 + +* CurlMulti is no longer reused globally. A new multi object is created per-client. This helps to isolate clients. +* URLs with no path no longer contain a "/" by default +* Guzzle\Http\QueryString does no longer manages the leading "?". This is now handled in Guzzle\Http\Url. +* BadResponseException no longer includes the full request and response message +* Adding setData() to Guzzle\Service\Description\ServiceDescriptionInterface +* Adding getResponseBody() to Guzzle\Http\Message\RequestInterface +* Various updates to classes to use ServiceDescriptionInterface type hints rather than ServiceDescription +* Header values can now be normalized into distinct values when multiple headers are combined with a comma separated list +* xmlEncoding can now be customized for the XML declaration of a XML service description operation +* Guzzle\Http\QueryString now uses Guzzle\Http\QueryAggregator\QueryAggregatorInterface objects to add custom value + aggregation and no longer uses callbacks +* The URL encoding implementation of Guzzle\Http\QueryString can now be customized +* Bug fix: Filters were not always invoked for array service description parameters +* Bug fix: Redirects now use a target response body rather than a temporary response body +* Bug fix: The default exponential backoff BackoffPlugin was not giving when the request threshold was exceeded +* Bug fix: Guzzle now takes the first found value when grabbing Cache-Control directives + +## 3.1.2 - 2013-01-27 + +* Refactored how operation responses are parsed. Visitors now include a before() method responsible for parsing the + response body. For example, the XmlVisitor now parses the XML response into an array in the before() method. +* Fixed an issue where cURL would not automatically decompress responses when the Accept-Encoding header was sent +* CURLOPT_SSL_VERIFYHOST is never set to 1 because it is deprecated (see 5e0ff2ef20f839e19d1eeb298f90ba3598784444) +* Fixed a bug where redirect responses were not chained correctly using getPreviousResponse() +* Setting default headers on a client after setting the user-agent will not erase the user-agent setting + +## 3.1.1 - 2013-01-20 + +* Adding wildcard support to Guzzle\Common\Collection::getPath() +* Adding alias support to ServiceBuilder configs +* Adding Guzzle\Service\Resource\CompositeResourceIteratorFactory and cleaning up factory interface + +## 3.1.0 - 2013-01-12 + +* BC: CurlException now extends from RequestException rather than BadResponseException +* BC: Renamed Guzzle\Plugin\Cache\CanCacheStrategyInterface::canCache() to canCacheRequest() and added CanCacheResponse() +* Added getData to ServiceDescriptionInterface +* Added context array to RequestInterface::setState() +* Bug: Removing hard dependency on the BackoffPlugin from Guzzle\Http +* Bug: Adding required content-type when JSON request visitor adds JSON to a command +* Bug: Fixing the serialization of a service description with custom data +* Made it easier to deal with exceptions thrown when transferring commands or requests in parallel by providing + an array of successful and failed responses +* Moved getPath from Guzzle\Service\Resource\Model to Guzzle\Common\Collection +* Added Guzzle\Http\IoEmittingEntityBody +* Moved command filtration from validators to location visitors +* Added `extends` attributes to service description parameters +* Added getModels to ServiceDescriptionInterface + +## 3.0.7 - 2012-12-19 + +* Fixing phar detection when forcing a cacert to system if null or true +* Allowing filename to be passed to `Guzzle\Http\Message\Request::setResponseBody()` +* Cleaning up `Guzzle\Common\Collection::inject` method +* Adding a response_body location to service descriptions + +## 3.0.6 - 2012-12-09 + +* CurlMulti performance improvements +* Adding setErrorResponses() to Operation +* composer.json tweaks + +## 3.0.5 - 2012-11-18 + +* Bug: Fixing an infinite recursion bug caused from revalidating with the CachePlugin +* Bug: Response body can now be a string containing "0" +* Bug: Using Guzzle inside of a phar uses system by default but now allows for a custom cacert +* Bug: QueryString::fromString now properly parses query string parameters that contain equal signs +* Added support for XML attributes in service description responses +* DefaultRequestSerializer now supports array URI parameter values for URI template expansion +* Added better mimetype guessing to requests and post files + +## 3.0.4 - 2012-11-11 + +* Bug: Fixed a bug when adding multiple cookies to a request to use the correct glue value +* Bug: Cookies can now be added that have a name, domain, or value set to "0" +* Bug: Using the system cacert bundle when using the Phar +* Added json and xml methods to Response to make it easier to parse JSON and XML response data into data structures +* Enhanced cookie jar de-duplication +* Added the ability to enable strict cookie jars that throw exceptions when invalid cookies are added +* Added setStream to StreamInterface to actually make it possible to implement custom rewind behavior for entity bodies +* Added the ability to create any sort of hash for a stream rather than just an MD5 hash + +## 3.0.3 - 2012-11-04 + +* Implementing redirects in PHP rather than cURL +* Added PECL URI template extension and using as default parser if available +* Bug: Fixed Content-Length parsing of Response factory +* Adding rewind() method to entity bodies and streams. Allows for custom rewinding of non-repeatable streams. +* Adding ToArrayInterface throughout library +* Fixing OauthPlugin to create unique nonce values per request + +## 3.0.2 - 2012-10-25 + +* Magic methods are enabled by default on clients +* Magic methods return the result of a command +* Service clients no longer require a base_url option in the factory +* Bug: Fixed an issue with URI templates where null template variables were being expanded + +## 3.0.1 - 2012-10-22 + +* Models can now be used like regular collection objects by calling filter, map, etc. +* Models no longer require a Parameter structure or initial data in the constructor +* Added a custom AppendIterator to get around a PHP bug with the `\AppendIterator` + +## 3.0.0 - 2012-10-15 + +* Rewrote service description format to be based on Swagger + * Now based on JSON schema + * Added nested input structures and nested response models + * Support for JSON and XML input and output models + * Renamed `commands` to `operations` + * Removed dot class notation + * Removed custom types +* Broke the project into smaller top-level namespaces to be more component friendly +* Removed support for XML configs and descriptions. Use arrays or JSON files. +* Removed the Validation component and Inspector +* Moved all cookie code to Guzzle\Plugin\Cookie +* Magic methods on a Guzzle\Service\Client now return the command un-executed. +* Calling getResult() or getResponse() on a command will lazily execute the command if needed. +* Now shipping with cURL's CA certs and using it by default +* Added previousResponse() method to response objects +* No longer sending Accept and Accept-Encoding headers on every request +* Only sending an Expect header by default when a payload is greater than 1MB +* Added/moved client options: + * curl.blacklist to curl.option.blacklist + * Added ssl.certificate_authority +* Added a Guzzle\Iterator component +* Moved plugins from Guzzle\Http\Plugin to Guzzle\Plugin +* Added a more robust backoff retry strategy (replaced the ExponentialBackoffPlugin) +* Added a more robust caching plugin +* Added setBody to response objects +* Updating LogPlugin to use a more flexible MessageFormatter +* Added a completely revamped build process +* Cleaning up Collection class and removing default values from the get method +* Fixed ZF2 cache adapters + +## 2.8.8 - 2012-10-15 + +* Bug: Fixed a cookie issue that caused dot prefixed domains to not match where popular browsers did + +## 2.8.7 - 2012-09-30 + +* Bug: Fixed config file aliases for JSON includes +* Bug: Fixed cookie bug on a request object by using CookieParser to parse cookies on requests +* Bug: Removing the path to a file when sending a Content-Disposition header on a POST upload +* Bug: Hardening request and response parsing to account for missing parts +* Bug: Fixed PEAR packaging +* Bug: Fixed Request::getInfo +* Bug: Fixed cases where CURLM_CALL_MULTI_PERFORM return codes were causing curl transactions to fail +* Adding the ability for the namespace Iterator factory to look in multiple directories +* Added more getters/setters/removers from service descriptions +* Added the ability to remove POST fields from OAuth signatures +* OAuth plugin now supports 2-legged OAuth + +## 2.8.6 - 2012-09-05 + +* Added the ability to modify and build service descriptions +* Added the use of visitors to apply parameters to locations in service descriptions using the dynamic command +* Added a `json` parameter location +* Now allowing dot notation for classes in the CacheAdapterFactory +* Using the union of two arrays rather than an array_merge when extending service builder services and service params +* Ensuring that a service is a string before doing strpos() checks on it when substituting services for references + in service builder config files. +* Services defined in two different config files that include one another will by default replace the previously + defined service, but you can now create services that extend themselves and merge their settings over the previous +* The JsonLoader now supports aliasing filenames with different filenames. This allows you to alias something like + '_default' with a default JSON configuration file. + +## 2.8.5 - 2012-08-29 + +* Bug: Suppressed empty arrays from URI templates +* Bug: Added the missing $options argument from ServiceDescription::factory to enable caching +* Added support for HTTP responses that do not contain a reason phrase in the start-line +* AbstractCommand commands are now invokable +* Added a way to get the data used when signing an Oauth request before a request is sent + +## 2.8.4 - 2012-08-15 + +* Bug: Custom delay time calculations are no longer ignored in the ExponentialBackoffPlugin +* Added the ability to transfer entity bodies as a string rather than streamed. This gets around curl error 65. Set `body_as_string` in a request's curl options to enable. +* Added a StreamInterface, EntityBodyInterface, and added ftell() to Guzzle\Common\Stream +* Added an AbstractEntityBodyDecorator and a ReadLimitEntityBody decorator to transfer only a subset of a decorated stream +* Stream and EntityBody objects will now return the file position to the previous position after a read required operation (e.g. getContentMd5()) +* Added additional response status codes +* Removed SSL information from the default User-Agent header +* DELETE requests can now send an entity body +* Added an EventDispatcher to the ExponentialBackoffPlugin and added an ExponentialBackoffLogger to log backoff retries +* Added the ability of the MockPlugin to consume mocked request bodies +* LogPlugin now exposes request and response objects in the extras array + +## 2.8.3 - 2012-07-30 + +* Bug: Fixed a case where empty POST requests were sent as GET requests +* Bug: Fixed a bug in ExponentialBackoffPlugin that caused fatal errors when retrying an EntityEnclosingRequest that does not have a body +* Bug: Setting the response body of a request to null after completing a request, not when setting the state of a request to new +* Added multiple inheritance to service description commands +* Added an ApiCommandInterface and added `getParamNames()` and `hasParam()` +* Removed the default 2mb size cutoff from the Md5ValidatorPlugin so that it now defaults to validating everything +* Changed CurlMulti::perform to pass a smaller timeout to CurlMulti::executeHandles + +## 2.8.2 - 2012-07-24 + +* Bug: Query string values set to 0 are no longer dropped from the query string +* Bug: A Collection object is no longer created each time a call is made to `Guzzle\Service\Command\AbstractCommand::getRequestHeaders()` +* Bug: `+` is now treated as an encoded space when parsing query strings +* QueryString and Collection performance improvements +* Allowing dot notation for class paths in filters attribute of a service descriptions + +## 2.8.1 - 2012-07-16 + +* Loosening Event Dispatcher dependency +* POST redirects can now be customized using CURLOPT_POSTREDIR + +## 2.8.0 - 2012-07-15 + +* BC: Guzzle\Http\Query + * Query strings with empty variables will always show an equal sign unless the variable is set to QueryString::BLANK (e.g. ?acl= vs ?acl) + * Changed isEncodingValues() and isEncodingFields() to isUrlEncoding() + * Changed setEncodeValues(bool) and setEncodeFields(bool) to useUrlEncoding(bool) + * Changed the aggregation functions of QueryString to be static methods + * Can now use fromString() with querystrings that have a leading ? +* cURL configuration values can be specified in service descriptions using `curl.` prefixed parameters +* Content-Length is set to 0 before emitting the request.before_send event when sending an empty request body +* Cookies are no longer URL decoded by default +* Bug: URI template variables set to null are no longer expanded + +## 2.7.2 - 2012-07-02 + +* BC: Moving things to get ready for subtree splits. Moving Inflection into Common. Moving Guzzle\Http\Parser to Guzzle\Parser. +* BC: Removing Guzzle\Common\Batch\Batch::count() and replacing it with isEmpty() +* CachePlugin now allows for a custom request parameter function to check if a request can be cached +* Bug fix: CachePlugin now only caches GET and HEAD requests by default +* Bug fix: Using header glue when transferring headers over the wire +* Allowing deeply nested arrays for composite variables in URI templates +* Batch divisors can now return iterators or arrays + +## 2.7.1 - 2012-06-26 + +* Minor patch to update version number in UA string +* Updating build process + +## 2.7.0 - 2012-06-25 + +* BC: Inflection classes moved to Guzzle\Inflection. No longer static methods. Can now inject custom inflectors into classes. +* BC: Removed magic setX methods from commands +* BC: Magic methods mapped to service description commands are now inflected in the command factory rather than the client __call() method +* Verbose cURL options are no longer enabled by default. Set curl.debug to true on a client to enable. +* Bug: Now allowing colons in a response start-line (e.g. HTTP/1.1 503 Service Unavailable: Back-end server is at capacity) +* Guzzle\Service\Resource\ResourceIteratorApplyBatched now internally uses the Guzzle\Common\Batch namespace +* Added Guzzle\Service\Plugin namespace and a PluginCollectionPlugin +* Added the ability to set POST fields and files in a service description +* Guzzle\Http\EntityBody::factory() now accepts objects with a __toString() method +* Adding a command.before_prepare event to clients +* Added BatchClosureTransfer and BatchClosureDivisor +* BatchTransferException now includes references to the batch divisor and transfer strategies +* Fixed some tests so that they pass more reliably +* Added Guzzle\Common\Log\ArrayLogAdapter + +## 2.6.6 - 2012-06-10 + +* BC: Removing Guzzle\Http\Plugin\BatchQueuePlugin +* BC: Removing Guzzle\Service\Command\CommandSet +* Adding generic batching system (replaces the batch queue plugin and command set) +* Updating ZF cache and log adapters and now using ZF's composer repository +* Bug: Setting the name of each ApiParam when creating through an ApiCommand +* Adding result_type, result_doc, deprecated, and doc_url to service descriptions +* Bug: Changed the default cookie header casing back to 'Cookie' + +## 2.6.5 - 2012-06-03 + +* BC: Renaming Guzzle\Http\Message\RequestInterface::getResourceUri() to getResource() +* BC: Removing unused AUTH_BASIC and AUTH_DIGEST constants from +* BC: Guzzle\Http\Cookie is now used to manage Set-Cookie data, not Cookie data +* BC: Renaming methods in the CookieJarInterface +* Moving almost all cookie logic out of the CookiePlugin and into the Cookie or CookieJar implementations +* Making the default glue for HTTP headers ';' instead of ',' +* Adding a removeValue to Guzzle\Http\Message\Header +* Adding getCookies() to request interface. +* Making it easier to add event subscribers to HasDispatcherInterface classes. Can now directly call addSubscriber() + +## 2.6.4 - 2012-05-30 + +* BC: Cleaning up how POST files are stored in EntityEnclosingRequest objects. Adding PostFile class. +* BC: Moving ApiCommand specific functionality from the Inspector and on to the ApiCommand +* Bug: Fixing magic method command calls on clients +* Bug: Email constraint only validates strings +* Bug: Aggregate POST fields when POST files are present in curl handle +* Bug: Fixing default User-Agent header +* Bug: Only appending or prepending parameters in commands if they are specified +* Bug: Not requiring response reason phrases or status codes to match a predefined list of codes +* Allowing the use of dot notation for class namespaces when using instance_of constraint +* Added any_match validation constraint +* Added an AsyncPlugin +* Passing request object to the calculateWait method of the ExponentialBackoffPlugin +* Allowing the result of a command object to be changed +* Parsing location and type sub values when instantiating a service description rather than over and over at runtime + +## 2.6.3 - 2012-05-23 + +* [BC] Guzzle\Common\FromConfigInterface no longer requires any config options. +* [BC] Refactoring how POST files are stored on an EntityEnclosingRequest. They are now separate from POST fields. +* You can now use an array of data when creating PUT request bodies in the request factory. +* Removing the requirement that HTTPS requests needed a Cache-Control: public directive to be cacheable. +* [Http] Adding support for Content-Type in multipart POST uploads per upload +* [Http] Added support for uploading multiple files using the same name (foo[0], foo[1]) +* Adding more POST data operations for easier manipulation of POST data. +* You can now set empty POST fields. +* The body of a request is only shown on EntityEnclosingRequest objects that do not use POST files. +* Split the Guzzle\Service\Inspector::validateConfig method into two methods. One to initialize when a command is created, and one to validate. +* CS updates + +## 2.6.2 - 2012-05-19 + +* [Http] Better handling of nested scope requests in CurlMulti. Requests are now always prepares in the send() method rather than the addRequest() method. + +## 2.6.1 - 2012-05-19 + +* [BC] Removing 'path' support in service descriptions. Use 'uri'. +* [BC] Guzzle\Service\Inspector::parseDocBlock is now protected. Adding getApiParamsForClass() with cache. +* [BC] Removing Guzzle\Common\NullObject. Use https://github.com/mtdowling/NullObject if you need it. +* [BC] Removing Guzzle\Common\XmlElement. +* All commands, both dynamic and concrete, have ApiCommand objects. +* Adding a fix for CurlMulti so that if all of the connections encounter some sort of curl error, then the loop exits. +* Adding checks to EntityEnclosingRequest so that empty POST files and fields are ignored. +* Making the method signature of Guzzle\Service\Builder\ServiceBuilder::factory more flexible. + +## 2.6.0 - 2012-05-15 + +* [BC] Moving Guzzle\Service\Builder to Guzzle\Service\Builder\ServiceBuilder +* [BC] Executing a Command returns the result of the command rather than the command +* [BC] Moving all HTTP parsing logic to Guzzle\Http\Parsers. Allows for faster C implementations if needed. +* [BC] Changing the Guzzle\Http\Message\Response::setProtocol() method to accept a protocol and version in separate args. +* [BC] Moving ResourceIterator* to Guzzle\Service\Resource +* [BC] Completely refactored ResourceIterators to iterate over a cloned command object +* [BC] Moved Guzzle\Http\UriTemplate to Guzzle\Http\Parser\UriTemplate\UriTemplate +* [BC] Guzzle\Guzzle is now deprecated +* Moving Guzzle\Common\Guzzle::inject to Guzzle\Common\Collection::inject +* Adding Guzzle\Version class to give version information about Guzzle +* Adding Guzzle\Http\Utils class to provide getDefaultUserAgent() and getHttpDate() +* Adding Guzzle\Curl\CurlVersion to manage caching curl_version() data +* ServiceDescription and ServiceBuilder are now cacheable using similar configs +* Changing the format of XML and JSON service builder configs. Backwards compatible. +* Cleaned up Cookie parsing +* Trimming the default Guzzle User-Agent header +* Adding a setOnComplete() method to Commands that is called when a command completes +* Keeping track of requests that were mocked in the MockPlugin +* Fixed a caching bug in the CacheAdapterFactory +* Inspector objects can be injected into a Command object +* Refactoring a lot of code and tests to be case insensitive when dealing with headers +* Adding Guzzle\Http\Message\HeaderComparison for easy comparison of HTTP headers using a DSL +* Adding the ability to set global option overrides to service builder configs +* Adding the ability to include other service builder config files from within XML and JSON files +* Moving the parseQuery method out of Url and on to QueryString::fromString() as a static factory method. + +## 2.5.0 - 2012-05-08 + +* Major performance improvements +* [BC] Simplifying Guzzle\Common\Collection. Please check to see if you are using features that are now deprecated. +* [BC] Using a custom validation system that allows a flyweight implementation for much faster validation. No longer using Symfony2 Validation component. +* [BC] No longer supporting "{{ }}" for injecting into command or UriTemplates. Use "{}" +* Added the ability to passed parameters to all requests created by a client +* Added callback functionality to the ExponentialBackoffPlugin +* Using microtime in ExponentialBackoffPlugin to allow more granular backoff strategies. +* Rewinding request stream bodies when retrying requests +* Exception is thrown when JSON response body cannot be decoded +* Added configurable magic method calls to clients and commands. This is off by default. +* Fixed a defect that added a hash to every parsed URL part +* Fixed duplicate none generation for OauthPlugin. +* Emitting an event each time a client is generated by a ServiceBuilder +* Using an ApiParams object instead of a Collection for parameters of an ApiCommand +* cache.* request parameters should be renamed to params.cache.* +* Added the ability to set arbitrary curl options on requests (disable_wire, progress, etc.). See CurlHandle. +* Added the ability to disable type validation of service descriptions +* ServiceDescriptions and ServiceBuilders are now Serializable diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/LICENSE new file mode 100644 index 0000000..ea7f07c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2011-2016 Michael Dowling, https://github.com/mtdowling + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/README.md b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/README.md new file mode 100644 index 0000000..2f614d6 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/README.md @@ -0,0 +1,89 @@ +Guzzle, PHP HTTP client +======================= + +[![Build Status](https://travis-ci.org/guzzle/guzzle.svg?branch=master)](https://travis-ci.org/guzzle/guzzle) + +Guzzle is a PHP HTTP client that makes it easy to send HTTP requests and +trivial to integrate with web services. + +- Simple interface for building query strings, POST requests, streaming large + uploads, streaming large downloads, using HTTP cookies, uploading JSON data, + etc... +- Can send both synchronous and asynchronous requests using the same interface. +- Uses PSR-7 interfaces for requests, responses, and streams. This allows you + to utilize other PSR-7 compatible libraries with Guzzle. +- Abstracts away the underlying HTTP transport, allowing you to write + environment and transport agnostic code; i.e., no hard dependency on cURL, + PHP streams, sockets, or non-blocking event loops. +- Middleware system allows you to augment and compose client behavior. + +```php +$client = new \GuzzleHttp\Client(); +$res = $client->request('GET', 'https://api.github.com/repos/guzzle/guzzle'); +echo $res->getStatusCode(); +// 200 +echo $res->getHeaderLine('content-type'); +// 'application/json; charset=utf8' +echo $res->getBody(); +// '{"id": 1420053, "name": "guzzle", ...}' + +// Send an asynchronous request. +$request = new \GuzzleHttp\Psr7\Request('GET', 'http://httpbin.org'); +$promise = $client->sendAsync($request)->then(function ($response) { + echo 'I completed! ' . $response->getBody(); +}); +$promise->wait(); +``` + +## Help and docs + +- [Documentation](http://guzzlephp.org/) +- [Stack Overflow](http://stackoverflow.com/questions/tagged/guzzle) +- [Gitter](https://gitter.im/guzzle/guzzle) + + +## Installing Guzzle + +The recommended way to install Guzzle is through +[Composer](http://getcomposer.org). + +```bash +# Install Composer +curl -sS https://getcomposer.org/installer | php +``` + +Next, run the Composer command to install the latest stable version of Guzzle: + +```bash +php composer.phar require guzzlehttp/guzzle +``` + +After installing, you need to require Composer's autoloader: + +```php +require 'vendor/autoload.php'; +``` + +You can then later update Guzzle using composer: + + ```bash +composer.phar update + ``` + + +## Version Guidance + +| Version | Status | Packagist | Namespace | Repo | Docs | PSR-7 | PHP Version | +|---------|------------|---------------------|--------------|---------------------|---------------------|-------|-------------| +| 3.x | EOL | `guzzle/guzzle` | `Guzzle` | [v3][guzzle-3-repo] | [v3][guzzle-3-docs] | No | >= 5.3.3 | +| 4.x | EOL | `guzzlehttp/guzzle` | `GuzzleHttp` | [v4][guzzle-4-repo] | N/A | No | >= 5.4 | +| 5.x | Maintained | `guzzlehttp/guzzle` | `GuzzleHttp` | [v5][guzzle-5-repo] | [v5][guzzle-5-docs] | No | >= 5.4 | +| 6.x | Latest | `guzzlehttp/guzzle` | `GuzzleHttp` | [v6][guzzle-6-repo] | [v6][guzzle-6-docs] | Yes | >= 5.5 | + +[guzzle-3-repo]: https://github.com/guzzle/guzzle3 +[guzzle-4-repo]: https://github.com/guzzle/guzzle/tree/4.x +[guzzle-5-repo]: https://github.com/guzzle/guzzle/tree/5.3 +[guzzle-6-repo]: https://github.com/guzzle/guzzle +[guzzle-3-docs]: http://guzzle3.readthedocs.org/en/latest/ +[guzzle-5-docs]: http://guzzle.readthedocs.org/en/5.3/ +[guzzle-6-docs]: http://guzzle.readthedocs.org/en/latest/ diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/UPGRADING.md b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/UPGRADING.md new file mode 100644 index 0000000..91d1dcc --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/UPGRADING.md @@ -0,0 +1,1203 @@ +Guzzle Upgrade Guide +==================== + +5.0 to 6.0 +---------- + +Guzzle now uses [PSR-7](http://www.php-fig.org/psr/psr-7/) for HTTP messages. +Due to the fact that these messages are immutable, this prompted a refactoring +of Guzzle to use a middleware based system rather than an event system. Any +HTTP message interaction (e.g., `GuzzleHttp\Message\Request`) need to be +updated to work with the new immutable PSR-7 request and response objects. Any +event listeners or subscribers need to be updated to become middleware +functions that wrap handlers (or are injected into a +`GuzzleHttp\HandlerStack`). + +- Removed `GuzzleHttp\BatchResults` +- Removed `GuzzleHttp\Collection` +- Removed `GuzzleHttp\HasDataTrait` +- Removed `GuzzleHttp\ToArrayInterface` +- The `guzzlehttp/streams` dependency has been removed. Stream functionality + is now present in the `GuzzleHttp\Psr7` namespace provided by the + `guzzlehttp/psr7` package. +- Guzzle no longer uses ReactPHP promises and now uses the + `guzzlehttp/promises` library. We use a custom promise library for three + significant reasons: + 1. React promises (at the time of writing this) are recursive. Promise + chaining and promise resolution will eventually blow the stack. Guzzle + promises are not recursive as they use a sort of trampolining technique. + Note: there has been movement in the React project to modify promises to + no longer utilize recursion. + 2. Guzzle needs to have the ability to synchronously block on a promise to + wait for a result. Guzzle promises allows this functionality (and does + not require the use of recursion). + 3. Because we need to be able to wait on a result, doing so using React + promises requires wrapping react promises with RingPHP futures. This + overhead is no longer needed, reducing stack sizes, reducing complexity, + and improving performance. +- `GuzzleHttp\Mimetypes` has been moved to a function in + `GuzzleHttp\Psr7\mimetype_from_extension` and + `GuzzleHttp\Psr7\mimetype_from_filename`. +- `GuzzleHttp\Query` and `GuzzleHttp\QueryParser` have been removed. Query + strings must now be passed into request objects as strings, or provided to + the `query` request option when creating requests with clients. The `query` + option uses PHP's `http_build_query` to convert an array to a string. If you + need a different serialization technique, you will need to pass the query + string in as a string. There are a couple helper functions that will make + working with query strings easier: `GuzzleHttp\Psr7\parse_query` and + `GuzzleHttp\Psr7\build_query`. +- Guzzle no longer has a dependency on RingPHP. Due to the use of a middleware + system based on PSR-7, using RingPHP and it's middleware system as well adds + more complexity than the benefits it provides. All HTTP handlers that were + present in RingPHP have been modified to work directly with PSR-7 messages + and placed in the `GuzzleHttp\Handler` namespace. This significantly reduces + complexity in Guzzle, removes a dependency, and improves performance. RingPHP + will be maintained for Guzzle 5 support, but will no longer be a part of + Guzzle 6. +- As Guzzle now uses a middleware based systems the event system and RingPHP + integration has been removed. Note: while the event system has been removed, + it is possible to add your own type of event system that is powered by the + middleware system. + - Removed the `Event` namespace. + - Removed the `Subscriber` namespace. + - Removed `Transaction` class + - Removed `RequestFsm` + - Removed `RingBridge` + - `GuzzleHttp\Subscriber\Cookie` is now provided by + `GuzzleHttp\Middleware::cookies` + - `GuzzleHttp\Subscriber\HttpError` is now provided by + `GuzzleHttp\Middleware::httpError` + - `GuzzleHttp\Subscriber\History` is now provided by + `GuzzleHttp\Middleware::history` + - `GuzzleHttp\Subscriber\Mock` is now provided by + `GuzzleHttp\Handler\MockHandler` + - `GuzzleHttp\Subscriber\Prepare` is now provided by + `GuzzleHttp\PrepareBodyMiddleware` + - `GuzzleHttp\Subscriber\Redirect` is now provided by + `GuzzleHttp\RedirectMiddleware` +- Guzzle now uses `Psr\Http\Message\UriInterface` (implements in + `GuzzleHttp\Psr7\Uri`) for URI support. `GuzzleHttp\Url` is now gone. +- Static functions in `GuzzleHttp\Utils` have been moved to namespaced + functions under the `GuzzleHttp` namespace. This requires either a Composer + based autoloader or you to include functions.php. +- `GuzzleHttp\ClientInterface::getDefaultOption` has been renamed to + `GuzzleHttp\ClientInterface::getConfig`. +- `GuzzleHttp\ClientInterface::setDefaultOption` has been removed. +- The `json` and `xml` methods of response objects has been removed. With the + migration to strictly adhering to PSR-7 as the interface for Guzzle messages, + adding methods to message interfaces would actually require Guzzle messages + to extend from PSR-7 messages rather then work with them directly. + +## Migrating to middleware + +The change to PSR-7 unfortunately required significant refactoring to Guzzle +due to the fact that PSR-7 messages are immutable. Guzzle 5 relied on an event +system from plugins. The event system relied on mutability of HTTP messages and +side effects in order to work. With immutable messages, you have to change your +workflow to become more about either returning a value (e.g., functional +middlewares) or setting a value on an object. Guzzle v6 has chosen the +functional middleware approach. + +Instead of using the event system to listen for things like the `before` event, +you now create a stack based middleware function that intercepts a request on +the way in and the promise of the response on the way out. This is a much +simpler and more predictable approach than the event system and works nicely +with PSR-7 middleware. Due to the use of promises, the middleware system is +also asynchronous. + +v5: + +```php +use GuzzleHttp\Event\BeforeEvent; +$client = new GuzzleHttp\Client(); +// Get the emitter and listen to the before event. +$client->getEmitter()->on('before', function (BeforeEvent $e) { + // Guzzle v5 events relied on mutation + $e->getRequest()->setHeader('X-Foo', 'Bar'); +}); +``` + +v6: + +In v6, you can modify the request before it is sent using the `mapRequest` +middleware. The idiomatic way in v6 to modify the request/response lifecycle is +to setup a handler middleware stack up front and inject the handler into a +client. + +```php +use GuzzleHttp\Middleware; +// Create a handler stack that has all of the default middlewares attached +$handler = GuzzleHttp\HandlerStack::create(); +// Push the handler onto the handler stack +$handler->push(Middleware::mapRequest(function (RequestInterface $request) { + // Notice that we have to return a request object + return $request->withHeader('X-Foo', 'Bar'); +})); +// Inject the handler into the client +$client = new GuzzleHttp\Client(['handler' => $handler]); +``` + +## POST Requests + +This version added the [`form_params`](http://guzzle.readthedocs.org/en/latest/request-options.html#form_params) +and `multipart` request options. `form_params` is an associative array of +strings or array of strings and is used to serialize an +`application/x-www-form-urlencoded` POST request. The +[`multipart`](http://guzzle.readthedocs.org/en/latest/request-options.html#multipart) +option is now used to send a multipart/form-data POST request. + +`GuzzleHttp\Post\PostFile` has been removed. Use the `multipart` option to add +POST files to a multipart/form-data request. + +The `body` option no longer accepts an array to send POST requests. Please use +`multipart` or `form_params` instead. + +The `base_url` option has been renamed to `base_uri`. + +4.x to 5.0 +---------- + +## Rewritten Adapter Layer + +Guzzle now uses [RingPHP](http://ringphp.readthedocs.org/en/latest) to send +HTTP requests. The `adapter` option in a `GuzzleHttp\Client` constructor +is still supported, but it has now been renamed to `handler`. Instead of +passing a `GuzzleHttp\Adapter\AdapterInterface`, you must now pass a PHP +`callable` that follows the RingPHP specification. + +## Removed Fluent Interfaces + +[Fluent interfaces were removed](http://ocramius.github.io/blog/fluent-interfaces-are-evil) +from the following classes: + +- `GuzzleHttp\Collection` +- `GuzzleHttp\Url` +- `GuzzleHttp\Query` +- `GuzzleHttp\Post\PostBody` +- `GuzzleHttp\Cookie\SetCookie` + +## Removed functions.php + +Removed "functions.php", so that Guzzle is truly PSR-4 compliant. The following +functions can be used as replacements. + +- `GuzzleHttp\json_decode` -> `GuzzleHttp\Utils::jsonDecode` +- `GuzzleHttp\get_path` -> `GuzzleHttp\Utils::getPath` +- `GuzzleHttp\Utils::setPath` -> `GuzzleHttp\set_path` +- `GuzzleHttp\Pool::batch` -> `GuzzleHttp\batch`. This function is, however, + deprecated in favor of using `GuzzleHttp\Pool::batch()`. + +The "procedural" global client has been removed with no replacement (e.g., +`GuzzleHttp\get()`, `GuzzleHttp\post()`, etc.). Use a `GuzzleHttp\Client` +object as a replacement. + +## `throwImmediately` has been removed + +The concept of "throwImmediately" has been removed from exceptions and error +events. This control mechanism was used to stop a transfer of concurrent +requests from completing. This can now be handled by throwing the exception or +by cancelling a pool of requests or each outstanding future request +individually. + +## headers event has been removed + +Removed the "headers" event. This event was only useful for changing the +body a response once the headers of the response were known. You can implement +a similar behavior in a number of ways. One example might be to use a +FnStream that has access to the transaction being sent. For example, when the +first byte is written, you could check if the response headers match your +expectations, and if so, change the actual stream body that is being +written to. + +## Updates to HTTP Messages + +Removed the `asArray` parameter from +`GuzzleHttp\Message\MessageInterface::getHeader`. If you want to get a header +value as an array, then use the newly added `getHeaderAsArray()` method of +`MessageInterface`. This change makes the Guzzle interfaces compatible with +the PSR-7 interfaces. + +3.x to 4.0 +---------- + +## Overarching changes: + +- Now requires PHP 5.4 or greater. +- No longer requires cURL to send requests. +- Guzzle no longer wraps every exception it throws. Only exceptions that are + recoverable are now wrapped by Guzzle. +- Various namespaces have been removed or renamed. +- No longer requiring the Symfony EventDispatcher. A custom event dispatcher + based on the Symfony EventDispatcher is + now utilized in `GuzzleHttp\Event\EmitterInterface` (resulting in significant + speed and functionality improvements). + +Changes per Guzzle 3.x namespace are described below. + +## Batch + +The `Guzzle\Batch` namespace has been removed. This is best left to +third-parties to implement on top of Guzzle's core HTTP library. + +## Cache + +The `Guzzle\Cache` namespace has been removed. (Todo: No suitable replacement +has been implemented yet, but hoping to utilize a PSR cache interface). + +## Common + +- Removed all of the wrapped exceptions. It's better to use the standard PHP + library for unrecoverable exceptions. +- `FromConfigInterface` has been removed. +- `Guzzle\Common\Version` has been removed. The VERSION constant can be found + at `GuzzleHttp\ClientInterface::VERSION`. + +### Collection + +- `getAll` has been removed. Use `toArray` to convert a collection to an array. +- `inject` has been removed. +- `keySearch` has been removed. +- `getPath` no longer supports wildcard expressions. Use something better like + JMESPath for this. +- `setPath` now supports appending to an existing array via the `[]` notation. + +### Events + +Guzzle no longer requires Symfony's EventDispatcher component. Guzzle now uses +`GuzzleHttp\Event\Emitter`. + +- `Symfony\Component\EventDispatcher\EventDispatcherInterface` is replaced by + `GuzzleHttp\Event\EmitterInterface`. +- `Symfony\Component\EventDispatcher\EventDispatcher` is replaced by + `GuzzleHttp\Event\Emitter`. +- `Symfony\Component\EventDispatcher\Event` is replaced by + `GuzzleHttp\Event\Event`, and Guzzle now has an EventInterface in + `GuzzleHttp\Event\EventInterface`. +- `AbstractHasDispatcher` has moved to a trait, `HasEmitterTrait`, and + `HasDispatcherInterface` has moved to `HasEmitterInterface`. Retrieving the + event emitter of a request, client, etc. now uses the `getEmitter` method + rather than the `getDispatcher` method. + +#### Emitter + +- Use the `once()` method to add a listener that automatically removes itself + the first time it is invoked. +- Use the `listeners()` method to retrieve a list of event listeners rather than + the `getListeners()` method. +- Use `emit()` instead of `dispatch()` to emit an event from an emitter. +- Use `attach()` instead of `addSubscriber()` and `detach()` instead of + `removeSubscriber()`. + +```php +$mock = new Mock(); +// 3.x +$request->getEventDispatcher()->addSubscriber($mock); +$request->getEventDispatcher()->removeSubscriber($mock); +// 4.x +$request->getEmitter()->attach($mock); +$request->getEmitter()->detach($mock); +``` + +Use the `on()` method to add a listener rather than the `addListener()` method. + +```php +// 3.x +$request->getEventDispatcher()->addListener('foo', function (Event $event) { /* ... */ } ); +// 4.x +$request->getEmitter()->on('foo', function (Event $event, $name) { /* ... */ } ); +``` + +## Http + +### General changes + +- The cacert.pem certificate has been moved to `src/cacert.pem`. +- Added the concept of adapters that are used to transfer requests over the + wire. +- Simplified the event system. +- Sending requests in parallel is still possible, but batching is no longer a + concept of the HTTP layer. Instead, you must use the `complete` and `error` + events to asynchronously manage parallel request transfers. +- `Guzzle\Http\Url` has moved to `GuzzleHttp\Url`. +- `Guzzle\Http\QueryString` has moved to `GuzzleHttp\Query`. +- QueryAggregators have been rewritten so that they are simply callable + functions. +- `GuzzleHttp\StaticClient` has been removed. Use the functions provided in + `functions.php` for an easy to use static client instance. +- Exceptions in `GuzzleHttp\Exception` have been updated to all extend from + `GuzzleHttp\Exception\TransferException`. + +### Client + +Calling methods like `get()`, `post()`, `head()`, etc. no longer create and +return a request, but rather creates a request, sends the request, and returns +the response. + +```php +// 3.0 +$request = $client->get('/'); +$response = $request->send(); + +// 4.0 +$response = $client->get('/'); + +// or, to mirror the previous behavior +$request = $client->createRequest('GET', '/'); +$response = $client->send($request); +``` + +`GuzzleHttp\ClientInterface` has changed. + +- The `send` method no longer accepts more than one request. Use `sendAll` to + send multiple requests in parallel. +- `setUserAgent()` has been removed. Use a default request option instead. You + could, for example, do something like: + `$client->setConfig('defaults/headers/User-Agent', 'Foo/Bar ' . $client::getDefaultUserAgent())`. +- `setSslVerification()` has been removed. Use default request options instead, + like `$client->setConfig('defaults/verify', true)`. + +`GuzzleHttp\Client` has changed. + +- The constructor now accepts only an associative array. You can include a + `base_url` string or array to use a URI template as the base URL of a client. + You can also specify a `defaults` key that is an associative array of default + request options. You can pass an `adapter` to use a custom adapter, + `batch_adapter` to use a custom adapter for sending requests in parallel, or + a `message_factory` to change the factory used to create HTTP requests and + responses. +- The client no longer emits a `client.create_request` event. +- Creating requests with a client no longer automatically utilize a URI + template. You must pass an array into a creational method (e.g., + `createRequest`, `get`, `put`, etc.) in order to expand a URI template. + +### Messages + +Messages no longer have references to their counterparts (i.e., a request no +longer has a reference to it's response, and a response no loger has a +reference to its request). This association is now managed through a +`GuzzleHttp\Adapter\TransactionInterface` object. You can get references to +these transaction objects using request events that are emitted over the +lifecycle of a request. + +#### Requests with a body + +- `GuzzleHttp\Message\EntityEnclosingRequest` and + `GuzzleHttp\Message\EntityEnclosingRequestInterface` have been removed. The + separation between requests that contain a body and requests that do not + contain a body has been removed, and now `GuzzleHttp\Message\RequestInterface` + handles both use cases. +- Any method that previously accepts a `GuzzleHttp\Response` object now accept a + `GuzzleHttp\Message\ResponseInterface`. +- `GuzzleHttp\Message\RequestFactoryInterface` has been renamed to + `GuzzleHttp\Message\MessageFactoryInterface`. This interface is used to create + both requests and responses and is implemented in + `GuzzleHttp\Message\MessageFactory`. +- POST field and file methods have been removed from the request object. You + must now use the methods made available to `GuzzleHttp\Post\PostBodyInterface` + to control the format of a POST body. Requests that are created using a + standard `GuzzleHttp\Message\MessageFactoryInterface` will automatically use + a `GuzzleHttp\Post\PostBody` body if the body was passed as an array or if + the method is POST and no body is provided. + +```php +$request = $client->createRequest('POST', '/'); +$request->getBody()->setField('foo', 'bar'); +$request->getBody()->addFile(new PostFile('file_key', fopen('/path/to/content', 'r'))); +``` + +#### Headers + +- `GuzzleHttp\Message\Header` has been removed. Header values are now simply + represented by an array of values or as a string. Header values are returned + as a string by default when retrieving a header value from a message. You can + pass an optional argument of `true` to retrieve a header value as an array + of strings instead of a single concatenated string. +- `GuzzleHttp\PostFile` and `GuzzleHttp\PostFileInterface` have been moved to + `GuzzleHttp\Post`. This interface has been simplified and now allows the + addition of arbitrary headers. +- Custom headers like `GuzzleHttp\Message\Header\Link` have been removed. Most + of the custom headers are now handled separately in specific + subscribers/plugins, and `GuzzleHttp\Message\HeaderValues::parseParams()` has + been updated to properly handle headers that contain parameters (like the + `Link` header). + +#### Responses + +- `GuzzleHttp\Message\Response::getInfo()` and + `GuzzleHttp\Message\Response::setInfo()` have been removed. Use the event + system to retrieve this type of information. +- `GuzzleHttp\Message\Response::getRawHeaders()` has been removed. +- `GuzzleHttp\Message\Response::getMessage()` has been removed. +- `GuzzleHttp\Message\Response::calculateAge()` and other cache specific + methods have moved to the CacheSubscriber. +- Header specific helper functions like `getContentMd5()` have been removed. + Just use `getHeader('Content-MD5')` instead. +- `GuzzleHttp\Message\Response::setRequest()` and + `GuzzleHttp\Message\Response::getRequest()` have been removed. Use the event + system to work with request and response objects as a transaction. +- `GuzzleHttp\Message\Response::getRedirectCount()` has been removed. Use the + Redirect subscriber instead. +- `GuzzleHttp\Message\Response::isSuccessful()` and other related methods have + been removed. Use `getStatusCode()` instead. + +#### Streaming responses + +Streaming requests can now be created by a client directly, returning a +`GuzzleHttp\Message\ResponseInterface` object that contains a body stream +referencing an open PHP HTTP stream. + +```php +// 3.0 +use Guzzle\Stream\PhpStreamRequestFactory; +$request = $client->get('/'); +$factory = new PhpStreamRequestFactory(); +$stream = $factory->fromRequest($request); +$data = $stream->read(1024); + +// 4.0 +$response = $client->get('/', ['stream' => true]); +// Read some data off of the stream in the response body +$data = $response->getBody()->read(1024); +``` + +#### Redirects + +The `configureRedirects()` method has been removed in favor of a +`allow_redirects` request option. + +```php +// Standard redirects with a default of a max of 5 redirects +$request = $client->createRequest('GET', '/', ['allow_redirects' => true]); + +// Strict redirects with a custom number of redirects +$request = $client->createRequest('GET', '/', [ + 'allow_redirects' => ['max' => 5, 'strict' => true] +]); +``` + +#### EntityBody + +EntityBody interfaces and classes have been removed or moved to +`GuzzleHttp\Stream`. All classes and interfaces that once required +`GuzzleHttp\EntityBodyInterface` now require +`GuzzleHttp\Stream\StreamInterface`. Creating a new body for a request no +longer uses `GuzzleHttp\EntityBody::factory` but now uses +`GuzzleHttp\Stream\Stream::factory` or even better: +`GuzzleHttp\Stream\create()`. + +- `Guzzle\Http\EntityBodyInterface` is now `GuzzleHttp\Stream\StreamInterface` +- `Guzzle\Http\EntityBody` is now `GuzzleHttp\Stream\Stream` +- `Guzzle\Http\CachingEntityBody` is now `GuzzleHttp\Stream\CachingStream` +- `Guzzle\Http\ReadLimitEntityBody` is now `GuzzleHttp\Stream\LimitStream` +- `Guzzle\Http\IoEmittyinEntityBody` has been removed. + +#### Request lifecycle events + +Requests previously submitted a large number of requests. The number of events +emitted over the lifecycle of a request has been significantly reduced to make +it easier to understand how to extend the behavior of a request. All events +emitted during the lifecycle of a request now emit a custom +`GuzzleHttp\Event\EventInterface` object that contains context providing +methods and a way in which to modify the transaction at that specific point in +time (e.g., intercept the request and set a response on the transaction). + +- `request.before_send` has been renamed to `before` and now emits a + `GuzzleHttp\Event\BeforeEvent` +- `request.complete` has been renamed to `complete` and now emits a + `GuzzleHttp\Event\CompleteEvent`. +- `request.sent` has been removed. Use `complete`. +- `request.success` has been removed. Use `complete`. +- `error` is now an event that emits a `GuzzleHttp\Event\ErrorEvent`. +- `request.exception` has been removed. Use `error`. +- `request.receive.status_line` has been removed. +- `curl.callback.progress` has been removed. Use a custom `StreamInterface` to + maintain a status update. +- `curl.callback.write` has been removed. Use a custom `StreamInterface` to + intercept writes. +- `curl.callback.read` has been removed. Use a custom `StreamInterface` to + intercept reads. + +`headers` is a new event that is emitted after the response headers of a +request have been received before the body of the response is downloaded. This +event emits a `GuzzleHttp\Event\HeadersEvent`. + +You can intercept a request and inject a response using the `intercept()` event +of a `GuzzleHttp\Event\BeforeEvent`, `GuzzleHttp\Event\CompleteEvent`, and +`GuzzleHttp\Event\ErrorEvent` event. + +See: http://docs.guzzlephp.org/en/latest/events.html + +## Inflection + +The `Guzzle\Inflection` namespace has been removed. This is not a core concern +of Guzzle. + +## Iterator + +The `Guzzle\Iterator` namespace has been removed. + +- `Guzzle\Iterator\AppendIterator`, `Guzzle\Iterator\ChunkedIterator`, and + `Guzzle\Iterator\MethodProxyIterator` are nice, but not a core requirement of + Guzzle itself. +- `Guzzle\Iterator\FilterIterator` is no longer needed because an equivalent + class is shipped with PHP 5.4. +- `Guzzle\Iterator\MapIterator` is not really needed when using PHP 5.5 because + it's easier to just wrap an iterator in a generator that maps values. + +For a replacement of these iterators, see https://github.com/nikic/iter + +## Log + +The LogPlugin has moved to https://github.com/guzzle/log-subscriber. The +`Guzzle\Log` namespace has been removed. Guzzle now relies on +`Psr\Log\LoggerInterface` for all logging. The MessageFormatter class has been +moved to `GuzzleHttp\Subscriber\Log\Formatter`. + +## Parser + +The `Guzzle\Parser` namespace has been removed. This was previously used to +make it possible to plug in custom parsers for cookies, messages, URI +templates, and URLs; however, this level of complexity is not needed in Guzzle +so it has been removed. + +- Cookie: Cookie parsing logic has been moved to + `GuzzleHttp\Cookie\SetCookie::fromString`. +- Message: Message parsing logic for both requests and responses has been moved + to `GuzzleHttp\Message\MessageFactory::fromMessage`. Message parsing is only + used in debugging or deserializing messages, so it doesn't make sense for + Guzzle as a library to add this level of complexity to parsing messages. +- UriTemplate: URI template parsing has been moved to + `GuzzleHttp\UriTemplate`. The Guzzle library will automatically use the PECL + URI template library if it is installed. +- Url: URL parsing is now performed in `GuzzleHttp\Url::fromString` (previously + it was `Guzzle\Http\Url::factory()`). If custom URL parsing is necessary, + then developers are free to subclass `GuzzleHttp\Url`. + +## Plugin + +The `Guzzle\Plugin` namespace has been renamed to `GuzzleHttp\Subscriber`. +Several plugins are shipping with the core Guzzle library under this namespace. + +- `GuzzleHttp\Subscriber\Cookie`: Replaces the old CookiePlugin. Cookie jar + code has moved to `GuzzleHttp\Cookie`. +- `GuzzleHttp\Subscriber\History`: Replaces the old HistoryPlugin. +- `GuzzleHttp\Subscriber\HttpError`: Throws errors when a bad HTTP response is + received. +- `GuzzleHttp\Subscriber\Mock`: Replaces the old MockPlugin. +- `GuzzleHttp\Subscriber\Prepare`: Prepares the body of a request just before + sending. This subscriber is attached to all requests by default. +- `GuzzleHttp\Subscriber\Redirect`: Replaces the RedirectPlugin. + +The following plugins have been removed (third-parties are free to re-implement +these if needed): + +- `GuzzleHttp\Plugin\Async` has been removed. +- `GuzzleHttp\Plugin\CurlAuth` has been removed. +- `GuzzleHttp\Plugin\ErrorResponse\ErrorResponsePlugin` has been removed. This + functionality should instead be implemented with event listeners that occur + after normal response parsing occurs in the guzzle/command package. + +The following plugins are not part of the core Guzzle package, but are provided +in separate repositories: + +- `Guzzle\Http\Plugin\BackoffPlugin` has been rewritten to be much simpler + to build custom retry policies using simple functions rather than various + chained classes. See: https://github.com/guzzle/retry-subscriber +- `Guzzle\Http\Plugin\Cache\CachePlugin` has moved to + https://github.com/guzzle/cache-subscriber +- `Guzzle\Http\Plugin\Log\LogPlugin` has moved to + https://github.com/guzzle/log-subscriber +- `Guzzle\Http\Plugin\Md5\Md5Plugin` has moved to + https://github.com/guzzle/message-integrity-subscriber +- `Guzzle\Http\Plugin\Mock\MockPlugin` has moved to + `GuzzleHttp\Subscriber\MockSubscriber`. +- `Guzzle\Http\Plugin\Oauth\OauthPlugin` has moved to + https://github.com/guzzle/oauth-subscriber + +## Service + +The service description layer of Guzzle has moved into two separate packages: + +- http://github.com/guzzle/command Provides a high level abstraction over web + services by representing web service operations using commands. +- http://github.com/guzzle/guzzle-services Provides an implementation of + guzzle/command that provides request serialization and response parsing using + Guzzle service descriptions. + +## Stream + +Stream have moved to a separate package available at +https://github.com/guzzle/streams. + +`Guzzle\Stream\StreamInterface` has been given a large update to cleanly take +on the responsibilities of `Guzzle\Http\EntityBody` and +`Guzzle\Http\EntityBodyInterface` now that they have been removed. The number +of methods implemented by the `StreamInterface` has been drastically reduced to +allow developers to more easily extend and decorate stream behavior. + +## Removed methods from StreamInterface + +- `getStream` and `setStream` have been removed to better encapsulate streams. +- `getMetadata` and `setMetadata` have been removed in favor of + `GuzzleHttp\Stream\MetadataStreamInterface`. +- `getWrapper`, `getWrapperData`, `getStreamType`, and `getUri` have all been + removed. This data is accessible when + using streams that implement `GuzzleHttp\Stream\MetadataStreamInterface`. +- `rewind` has been removed. Use `seek(0)` for a similar behavior. + +## Renamed methods + +- `detachStream` has been renamed to `detach`. +- `feof` has been renamed to `eof`. +- `ftell` has been renamed to `tell`. +- `readLine` has moved from an instance method to a static class method of + `GuzzleHttp\Stream\Stream`. + +## Metadata streams + +`GuzzleHttp\Stream\MetadataStreamInterface` has been added to denote streams +that contain additional metadata accessible via `getMetadata()`. +`GuzzleHttp\Stream\StreamInterface::getMetadata` and +`GuzzleHttp\Stream\StreamInterface::setMetadata` have been removed. + +## StreamRequestFactory + +The entire concept of the StreamRequestFactory has been removed. The way this +was used in Guzzle 3 broke the actual interface of sending streaming requests +(instead of getting back a Response, you got a StreamInterface). Streaming +PHP requests are now implemented through the `GuzzleHttp\Adapter\StreamAdapter`. + +3.6 to 3.7 +---------- + +### Deprecations + +- You can now enable E_USER_DEPRECATED warnings to see if you are using any deprecated methods.: + +```php +\Guzzle\Common\Version::$emitWarnings = true; +``` + +The following APIs and options have been marked as deprecated: + +- Marked `Guzzle\Http\Message\Request::isResponseBodyRepeatable()` as deprecated. Use `$request->getResponseBody()->isRepeatable()` instead. +- Marked `Guzzle\Http\Message\Request::canCache()` as deprecated. Use `Guzzle\Plugin\Cache\DefaultCanCacheStrategy->canCacheRequest()` instead. +- Marked `Guzzle\Http\Message\Request::canCache()` as deprecated. Use `Guzzle\Plugin\Cache\DefaultCanCacheStrategy->canCacheRequest()` instead. +- Marked `Guzzle\Http\Message\Request::setIsRedirect()` as deprecated. Use the HistoryPlugin instead. +- Marked `Guzzle\Http\Message\Request::isRedirect()` as deprecated. Use the HistoryPlugin instead. +- Marked `Guzzle\Cache\CacheAdapterFactory::factory()` as deprecated +- Marked `Guzzle\Service\Client::enableMagicMethods()` as deprecated. Magic methods can no longer be disabled on a Guzzle\Service\Client. +- Marked `Guzzle\Parser\Url\UrlParser` as deprecated. Just use PHP's `parse_url()` and percent encode your UTF-8. +- Marked `Guzzle\Common\Collection::inject()` as deprecated. +- Marked `Guzzle\Plugin\CurlAuth\CurlAuthPlugin` as deprecated. Use + `$client->getConfig()->setPath('request.options/auth', array('user', 'pass', 'Basic|Digest|NTLM|Any'));` or + `$client->setDefaultOption('auth', array('user', 'pass', 'Basic|Digest|NTLM|Any'));` + +3.7 introduces `request.options` as a parameter for a client configuration and as an optional argument to all creational +request methods. When paired with a client's configuration settings, these options allow you to specify default settings +for various aspects of a request. Because these options make other previous configuration options redundant, several +configuration options and methods of a client and AbstractCommand have been deprecated. + +- Marked `Guzzle\Service\Client::getDefaultHeaders()` as deprecated. Use `$client->getDefaultOption('headers')`. +- Marked `Guzzle\Service\Client::setDefaultHeaders()` as deprecated. Use `$client->setDefaultOption('headers/{header_name}', 'value')`. +- Marked 'request.params' for `Guzzle\Http\Client` as deprecated. Use `$client->setDefaultOption('params/{param_name}', 'value')` +- Marked 'command.headers', 'command.response_body' and 'command.on_complete' as deprecated for AbstractCommand. These will work through Guzzle 4.0 + + $command = $client->getCommand('foo', array( + 'command.headers' => array('Test' => '123'), + 'command.response_body' => '/path/to/file' + )); + + // Should be changed to: + + $command = $client->getCommand('foo', array( + 'command.request_options' => array( + 'headers' => array('Test' => '123'), + 'save_as' => '/path/to/file' + ) + )); + +### Interface changes + +Additions and changes (you will need to update any implementations or subclasses you may have created): + +- Added an `$options` argument to the end of the following methods of `Guzzle\Http\ClientInterface`: + createRequest, head, delete, put, patch, post, options, prepareRequest +- Added an `$options` argument to the end of `Guzzle\Http\Message\Request\RequestFactoryInterface::createRequest()` +- Added an `applyOptions()` method to `Guzzle\Http\Message\Request\RequestFactoryInterface` +- Changed `Guzzle\Http\ClientInterface::get($uri = null, $headers = null, $body = null)` to + `Guzzle\Http\ClientInterface::get($uri = null, $headers = null, $options = array())`. You can still pass in a + resource, string, or EntityBody into the $options parameter to specify the download location of the response. +- Changed `Guzzle\Common\Collection::__construct($data)` to no longer accepts a null value for `$data` but a + default `array()` +- Added `Guzzle\Stream\StreamInterface::isRepeatable` +- Made `Guzzle\Http\Client::expandTemplate` and `getUriTemplate` protected methods. + +The following methods were removed from interfaces. All of these methods are still available in the concrete classes +that implement them, but you should update your code to use alternative methods: + +- Removed `Guzzle\Http\ClientInterface::setDefaultHeaders(). Use + `$client->getConfig()->setPath('request.options/headers/{header_name}', 'value')`. or + `$client->getConfig()->setPath('request.options/headers', array('header_name' => 'value'))` or + `$client->setDefaultOption('headers/{header_name}', 'value')`. or + `$client->setDefaultOption('headers', array('header_name' => 'value'))`. +- Removed `Guzzle\Http\ClientInterface::getDefaultHeaders(). Use `$client->getConfig()->getPath('request.options/headers')`. +- Removed `Guzzle\Http\ClientInterface::expandTemplate()`. This is an implementation detail. +- Removed `Guzzle\Http\ClientInterface::setRequestFactory()`. This is an implementation detail. +- Removed `Guzzle\Http\ClientInterface::getCurlMulti()`. This is a very specific implementation detail. +- Removed `Guzzle\Http\Message\RequestInterface::canCache`. Use the CachePlugin. +- Removed `Guzzle\Http\Message\RequestInterface::setIsRedirect`. Use the HistoryPlugin. +- Removed `Guzzle\Http\Message\RequestInterface::isRedirect`. Use the HistoryPlugin. + +### Cache plugin breaking changes + +- CacheKeyProviderInterface and DefaultCacheKeyProvider are no longer used. All of this logic is handled in a + CacheStorageInterface. These two objects and interface will be removed in a future version. +- Always setting X-cache headers on cached responses +- Default cache TTLs are now handled by the CacheStorageInterface of a CachePlugin +- `CacheStorageInterface::cache($key, Response $response, $ttl = null)` has changed to `cache(RequestInterface + $request, Response $response);` +- `CacheStorageInterface::fetch($key)` has changed to `fetch(RequestInterface $request);` +- `CacheStorageInterface::delete($key)` has changed to `delete(RequestInterface $request);` +- Added `CacheStorageInterface::purge($url)` +- `DefaultRevalidation::__construct(CacheKeyProviderInterface $cacheKey, CacheStorageInterface $cache, CachePlugin + $plugin)` has changed to `DefaultRevalidation::__construct(CacheStorageInterface $cache, + CanCacheStrategyInterface $canCache = null)` +- Added `RevalidationInterface::shouldRevalidate(RequestInterface $request, Response $response)` + +3.5 to 3.6 +---------- + +* Mixed casing of headers are now forced to be a single consistent casing across all values for that header. +* Messages internally use a HeaderCollection object to delegate handling case-insensitive header resolution +* Removed the whole changedHeader() function system of messages because all header changes now go through addHeader(). + For example, setHeader() first removes the header using unset on a HeaderCollection and then calls addHeader(). + Keeping the Host header and URL host in sync is now handled by overriding the addHeader method in Request. +* Specific header implementations can be created for complex headers. When a message creates a header, it uses a + HeaderFactory which can map specific headers to specific header classes. There is now a Link header and + CacheControl header implementation. +* Moved getLinks() from Response to just be used on a Link header object. + +If you previously relied on Guzzle\Http\Message\Header::raw(), then you will need to update your code to use the +HeaderInterface (e.g. toArray(), getAll(), etc.). + +### Interface changes + +* Removed from interface: Guzzle\Http\ClientInterface::setUriTemplate +* Removed from interface: Guzzle\Http\ClientInterface::setCurlMulti() +* Removed Guzzle\Http\Message\Request::receivedRequestHeader() and implemented this functionality in + Guzzle\Http\Curl\RequestMediator +* Removed the optional $asString parameter from MessageInterface::getHeader(). Just cast the header to a string. +* Removed the optional $tryChunkedTransfer option from Guzzle\Http\Message\EntityEnclosingRequestInterface +* Removed the $asObjects argument from Guzzle\Http\Message\MessageInterface::getHeaders() + +### Removed deprecated functions + +* Removed Guzzle\Parser\ParserRegister::get(). Use getParser() +* Removed Guzzle\Parser\ParserRegister::set(). Use registerParser(). + +### Deprecations + +* The ability to case-insensitively search for header values +* Guzzle\Http\Message\Header::hasExactHeader +* Guzzle\Http\Message\Header::raw. Use getAll() +* Deprecated cache control specific methods on Guzzle\Http\Message\AbstractMessage. Use the CacheControl header object + instead. + +### Other changes + +* All response header helper functions return a string rather than mixing Header objects and strings inconsistently +* Removed cURL blacklist support. This is no longer necessary now that Expect, Accept, etc. are managed by Guzzle + directly via interfaces +* Removed the injecting of a request object onto a response object. The methods to get and set a request still exist + but are a no-op until removed. +* Most classes that used to require a `Guzzle\Service\Command\CommandInterface` typehint now request a + `Guzzle\Service\Command\ArrayCommandInterface`. +* Added `Guzzle\Http\Message\RequestInterface::startResponse()` to the RequestInterface to handle injecting a response + on a request while the request is still being transferred +* `Guzzle\Service\Command\CommandInterface` now extends from ToArrayInterface and ArrayAccess + +3.3 to 3.4 +---------- + +Base URLs of a client now follow the rules of http://tools.ietf.org/html/rfc3986#section-5.2.2 when merging URLs. + +3.2 to 3.3 +---------- + +### Response::getEtag() quote stripping removed + +`Guzzle\Http\Message\Response::getEtag()` no longer strips quotes around the ETag response header + +### Removed `Guzzle\Http\Utils` + +The `Guzzle\Http\Utils` class was removed. This class was only used for testing. + +### Stream wrapper and type + +`Guzzle\Stream\Stream::getWrapper()` and `Guzzle\Stream\Stream::getStreamType()` are no longer converted to lowercase. + +### curl.emit_io became emit_io + +Emitting IO events from a RequestMediator is now a parameter that must be set in a request's curl options using the +'emit_io' key. This was previously set under a request's parameters using 'curl.emit_io' + +3.1 to 3.2 +---------- + +### CurlMulti is no longer reused globally + +Before 3.2, the same CurlMulti object was reused globally for each client. This can cause issue where plugins added +to a single client can pollute requests dispatched from other clients. + +If you still wish to reuse the same CurlMulti object with each client, then you can add a listener to the +ServiceBuilder's `service_builder.create_client` event to inject a custom CurlMulti object into each client as it is +created. + +```php +$multi = new Guzzle\Http\Curl\CurlMulti(); +$builder = Guzzle\Service\Builder\ServiceBuilder::factory('/path/to/config.json'); +$builder->addListener('service_builder.create_client', function ($event) use ($multi) { + $event['client']->setCurlMulti($multi); +} +}); +``` + +### No default path + +URLs no longer have a default path value of '/' if no path was specified. + +Before: + +```php +$request = $client->get('http://www.foo.com'); +echo $request->getUrl(); +// >> http://www.foo.com/ +``` + +After: + +```php +$request = $client->get('http://www.foo.com'); +echo $request->getUrl(); +// >> http://www.foo.com +``` + +### Less verbose BadResponseException + +The exception message for `Guzzle\Http\Exception\BadResponseException` no longer contains the full HTTP request and +response information. You can, however, get access to the request and response object by calling `getRequest()` or +`getResponse()` on the exception object. + +### Query parameter aggregation + +Multi-valued query parameters are no longer aggregated using a callback function. `Guzzle\Http\Query` now has a +setAggregator() method that accepts a `Guzzle\Http\QueryAggregator\QueryAggregatorInterface` object. This object is +responsible for handling the aggregation of multi-valued query string variables into a flattened hash. + +2.8 to 3.x +---------- + +### Guzzle\Service\Inspector + +Change `\Guzzle\Service\Inspector::fromConfig` to `\Guzzle\Common\Collection::fromConfig` + +**Before** + +```php +use Guzzle\Service\Inspector; + +class YourClient extends \Guzzle\Service\Client +{ + public static function factory($config = array()) + { + $default = array(); + $required = array('base_url', 'username', 'api_key'); + $config = Inspector::fromConfig($config, $default, $required); + + $client = new self( + $config->get('base_url'), + $config->get('username'), + $config->get('api_key') + ); + $client->setConfig($config); + + $client->setDescription(ServiceDescription::factory(__DIR__ . DIRECTORY_SEPARATOR . 'client.json')); + + return $client; + } +``` + +**After** + +```php +use Guzzle\Common\Collection; + +class YourClient extends \Guzzle\Service\Client +{ + public static function factory($config = array()) + { + $default = array(); + $required = array('base_url', 'username', 'api_key'); + $config = Collection::fromConfig($config, $default, $required); + + $client = new self( + $config->get('base_url'), + $config->get('username'), + $config->get('api_key') + ); + $client->setConfig($config); + + $client->setDescription(ServiceDescription::factory(__DIR__ . DIRECTORY_SEPARATOR . 'client.json')); + + return $client; + } +``` + +### Convert XML Service Descriptions to JSON + +**Before** + +```xml + + + + + + Get a list of groups + + + Uses a search query to get a list of groups + + + + Create a group + + + + + Delete a group by ID + + + + + + + Update a group + + + + + + +``` + +**After** + +```json +{ + "name": "Zendesk REST API v2", + "apiVersion": "2012-12-31", + "description":"Provides access to Zendesk views, groups, tickets, ticket fields, and users", + "operations": { + "list_groups": { + "httpMethod":"GET", + "uri": "groups.json", + "summary": "Get a list of groups" + }, + "search_groups":{ + "httpMethod":"GET", + "uri": "search.json?query=\"{query} type:group\"", + "summary": "Uses a search query to get a list of groups", + "parameters":{ + "query":{ + "location": "uri", + "description":"Zendesk Search Query", + "type": "string", + "required": true + } + } + }, + "create_group": { + "httpMethod":"POST", + "uri": "groups.json", + "summary": "Create a group", + "parameters":{ + "data": { + "type": "array", + "location": "body", + "description":"Group JSON", + "filters": "json_encode", + "required": true + }, + "Content-Type":{ + "type": "string", + "location":"header", + "static": "application/json" + } + } + }, + "delete_group": { + "httpMethod":"DELETE", + "uri": "groups/{id}.json", + "summary": "Delete a group", + "parameters":{ + "id":{ + "location": "uri", + "description":"Group to delete by ID", + "type": "integer", + "required": true + } + } + }, + "get_group": { + "httpMethod":"GET", + "uri": "groups/{id}.json", + "summary": "Get a ticket", + "parameters":{ + "id":{ + "location": "uri", + "description":"Group to get by ID", + "type": "integer", + "required": true + } + } + }, + "update_group": { + "httpMethod":"PUT", + "uri": "groups/{id}.json", + "summary": "Update a group", + "parameters":{ + "id": { + "location": "uri", + "description":"Group to update by ID", + "type": "integer", + "required": true + }, + "data": { + "type": "array", + "location": "body", + "description":"Group JSON", + "filters": "json_encode", + "required": true + }, + "Content-Type":{ + "type": "string", + "location":"header", + "static": "application/json" + } + } + } +} +``` + +### Guzzle\Service\Description\ServiceDescription + +Commands are now called Operations + +**Before** + +```php +use Guzzle\Service\Description\ServiceDescription; + +$sd = new ServiceDescription(); +$sd->getCommands(); // @returns ApiCommandInterface[] +$sd->hasCommand($name); +$sd->getCommand($name); // @returns ApiCommandInterface|null +$sd->addCommand($command); // @param ApiCommandInterface $command +``` + +**After** + +```php +use Guzzle\Service\Description\ServiceDescription; + +$sd = new ServiceDescription(); +$sd->getOperations(); // @returns OperationInterface[] +$sd->hasOperation($name); +$sd->getOperation($name); // @returns OperationInterface|null +$sd->addOperation($operation); // @param OperationInterface $operation +``` + +### Guzzle\Common\Inflection\Inflector + +Namespace is now `Guzzle\Inflection\Inflector` + +### Guzzle\Http\Plugin + +Namespace is now `Guzzle\Plugin`. Many other changes occur within this namespace and are detailed in their own sections below. + +### Guzzle\Http\Plugin\LogPlugin and Guzzle\Common\Log + +Now `Guzzle\Plugin\Log\LogPlugin` and `Guzzle\Log` respectively. + +**Before** + +```php +use Guzzle\Common\Log\ClosureLogAdapter; +use Guzzle\Http\Plugin\LogPlugin; + +/** @var \Guzzle\Http\Client */ +$client; + +// $verbosity is an integer indicating desired message verbosity level +$client->addSubscriber(new LogPlugin(new ClosureLogAdapter(function($m) { echo $m; }, $verbosity = LogPlugin::LOG_VERBOSE); +``` + +**After** + +```php +use Guzzle\Log\ClosureLogAdapter; +use Guzzle\Log\MessageFormatter; +use Guzzle\Plugin\Log\LogPlugin; + +/** @var \Guzzle\Http\Client */ +$client; + +// $format is a string indicating desired message format -- @see MessageFormatter +$client->addSubscriber(new LogPlugin(new ClosureLogAdapter(function($m) { echo $m; }, $format = MessageFormatter::DEBUG_FORMAT); +``` + +### Guzzle\Http\Plugin\CurlAuthPlugin + +Now `Guzzle\Plugin\CurlAuth\CurlAuthPlugin`. + +### Guzzle\Http\Plugin\ExponentialBackoffPlugin + +Now `Guzzle\Plugin\Backoff\BackoffPlugin`, and other changes. + +**Before** + +```php +use Guzzle\Http\Plugin\ExponentialBackoffPlugin; + +$backoffPlugin = new ExponentialBackoffPlugin($maxRetries, array_merge( + ExponentialBackoffPlugin::getDefaultFailureCodes(), array(429) + )); + +$client->addSubscriber($backoffPlugin); +``` + +**After** + +```php +use Guzzle\Plugin\Backoff\BackoffPlugin; +use Guzzle\Plugin\Backoff\HttpBackoffStrategy; + +// Use convenient factory method instead -- see implementation for ideas of what +// you can do with chaining backoff strategies +$backoffPlugin = BackoffPlugin::getExponentialBackoff($maxRetries, array_merge( + HttpBackoffStrategy::getDefaultFailureCodes(), array(429) + )); +$client->addSubscriber($backoffPlugin); +``` + +### Known Issues + +#### [BUG] Accept-Encoding header behavior changed unintentionally. + +(See #217) (Fixed in 09daeb8c666fb44499a0646d655a8ae36456575e) + +In version 2.8 setting the `Accept-Encoding` header would set the CURLOPT_ENCODING option, which permitted cURL to +properly handle gzip/deflate compressed responses from the server. In versions affected by this bug this does not happen. +See issue #217 for a workaround, or use a version containing the fix. diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/composer.json b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/composer.json new file mode 100644 index 0000000..65687a5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/composer.json @@ -0,0 +1,44 @@ +{ + "name": "guzzlehttp/guzzle", + "type": "library", + "description": "Guzzle is a PHP HTTP client library", + "keywords": ["framework", "http", "rest", "web service", "curl", "client", "HTTP client"], + "homepage": "http://guzzlephp.org/", + "license": "MIT", + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + } + ], + "require": { + "php": ">=5.5", + "guzzlehttp/psr7": "^1.4", + "guzzlehttp/promises": "^1.0" + }, + "require-dev": { + "ext-curl": "*", + "phpunit/phpunit": "^4.0 || ^5.0", + "psr/log": "^1.0" + }, + "autoload": { + "files": ["src/functions_include.php"], + "psr-4": { + "GuzzleHttp\\": "src/" + } + }, + "autoload-dev": { + "psr-4": { + "GuzzleHttp\\Tests\\": "tests/" + } + }, + "suggest": { + "psr/log": "Required for using the Log middleware" + }, + "extra": { + "branch-alias": { + "dev-master": "6.2-dev" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Client.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Client.php new file mode 100644 index 0000000..de4df8a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Client.php @@ -0,0 +1,414 @@ + 'http://www.foo.com/1.0/', + * 'timeout' => 0, + * 'allow_redirects' => false, + * 'proxy' => '192.168.16.1:10' + * ]); + * + * Client configuration settings include the following options: + * + * - handler: (callable) Function that transfers HTTP requests over the + * wire. The function is called with a Psr7\Http\Message\RequestInterface + * and array of transfer options, and must return a + * GuzzleHttp\Promise\PromiseInterface that is fulfilled with a + * Psr7\Http\Message\ResponseInterface on success. "handler" is a + * constructor only option that cannot be overridden in per/request + * options. If no handler is provided, a default handler will be created + * that enables all of the request options below by attaching all of the + * default middleware to the handler. + * - base_uri: (string|UriInterface) Base URI of the client that is merged + * into relative URIs. Can be a string or instance of UriInterface. + * - **: any request option + * + * @param array $config Client configuration settings. + * + * @see \GuzzleHttp\RequestOptions for a list of available request options. + */ + public function __construct(array $config = []) + { + if (!isset($config['handler'])) { + $config['handler'] = HandlerStack::create(); + } elseif (!is_callable($config['handler'])) { + throw new \InvalidArgumentException('handler must be a callable'); + } + + // Convert the base_uri to a UriInterface + if (isset($config['base_uri'])) { + $config['base_uri'] = Psr7\uri_for($config['base_uri']); + } + + $this->configureDefaults($config); + } + + public function __call($method, $args) + { + if (count($args) < 1) { + throw new \InvalidArgumentException('Magic request methods require a URI and optional options array'); + } + + $uri = $args[0]; + $opts = isset($args[1]) ? $args[1] : []; + + return substr($method, -5) === 'Async' + ? $this->requestAsync(substr($method, 0, -5), $uri, $opts) + : $this->request($method, $uri, $opts); + } + + public function sendAsync(RequestInterface $request, array $options = []) + { + // Merge the base URI into the request URI if needed. + $options = $this->prepareDefaults($options); + + return $this->transfer( + $request->withUri($this->buildUri($request->getUri(), $options), $request->hasHeader('Host')), + $options + ); + } + + public function send(RequestInterface $request, array $options = []) + { + $options[RequestOptions::SYNCHRONOUS] = true; + return $this->sendAsync($request, $options)->wait(); + } + + public function requestAsync($method, $uri = '', array $options = []) + { + $options = $this->prepareDefaults($options); + // Remove request modifying parameter because it can be done up-front. + $headers = isset($options['headers']) ? $options['headers'] : []; + $body = isset($options['body']) ? $options['body'] : null; + $version = isset($options['version']) ? $options['version'] : '1.1'; + // Merge the URI into the base URI. + $uri = $this->buildUri($uri, $options); + if (is_array($body)) { + $this->invalidBody(); + } + $request = new Psr7\Request($method, $uri, $headers, $body, $version); + // Remove the option so that they are not doubly-applied. + unset($options['headers'], $options['body'], $options['version']); + + return $this->transfer($request, $options); + } + + public function request($method, $uri = '', array $options = []) + { + $options[RequestOptions::SYNCHRONOUS] = true; + return $this->requestAsync($method, $uri, $options)->wait(); + } + + public function getConfig($option = null) + { + return $option === null + ? $this->config + : (isset($this->config[$option]) ? $this->config[$option] : null); + } + + private function buildUri($uri, array $config) + { + // for BC we accept null which would otherwise fail in uri_for + $uri = Psr7\uri_for($uri === null ? '' : $uri); + + if (isset($config['base_uri'])) { + $uri = Psr7\UriResolver::resolve(Psr7\uri_for($config['base_uri']), $uri); + } + + return $uri->getScheme() === '' && $uri->getHost() !== '' ? $uri->withScheme('http') : $uri; + } + + /** + * Configures the default options for a client. + * + * @param array $config + */ + private function configureDefaults(array $config) + { + $defaults = [ + 'allow_redirects' => RedirectMiddleware::$defaultSettings, + 'http_errors' => true, + 'decode_content' => true, + 'verify' => true, + 'cookies' => false + ]; + + // Use the standard Linux HTTP_PROXY and HTTPS_PROXY if set. + + // We can only trust the HTTP_PROXY environment variable in a CLI + // process due to the fact that PHP has no reliable mechanism to + // get environment variables that start with "HTTP_". + if (php_sapi_name() == 'cli' && getenv('HTTP_PROXY')) { + $defaults['proxy']['http'] = getenv('HTTP_PROXY'); + } + + if ($proxy = getenv('HTTPS_PROXY')) { + $defaults['proxy']['https'] = $proxy; + } + + if ($noProxy = getenv('NO_PROXY')) { + $cleanedNoProxy = str_replace(' ', '', $noProxy); + $defaults['proxy']['no'] = explode(',', $cleanedNoProxy); + } + + $this->config = $config + $defaults; + + if (!empty($config['cookies']) && $config['cookies'] === true) { + $this->config['cookies'] = new CookieJar(); + } + + // Add the default user-agent header. + if (!isset($this->config['headers'])) { + $this->config['headers'] = ['User-Agent' => default_user_agent()]; + } else { + // Add the User-Agent header if one was not already set. + foreach (array_keys($this->config['headers']) as $name) { + if (strtolower($name) === 'user-agent') { + return; + } + } + $this->config['headers']['User-Agent'] = default_user_agent(); + } + } + + /** + * Merges default options into the array. + * + * @param array $options Options to modify by reference + * + * @return array + */ + private function prepareDefaults($options) + { + $defaults = $this->config; + + if (!empty($defaults['headers'])) { + // Default headers are only added if they are not present. + $defaults['_conditional'] = $defaults['headers']; + unset($defaults['headers']); + } + + // Special handling for headers is required as they are added as + // conditional headers and as headers passed to a request ctor. + if (array_key_exists('headers', $options)) { + // Allows default headers to be unset. + if ($options['headers'] === null) { + $defaults['_conditional'] = null; + unset($options['headers']); + } elseif (!is_array($options['headers'])) { + throw new \InvalidArgumentException('headers must be an array'); + } + } + + // Shallow merge defaults underneath options. + $result = $options + $defaults; + + // Remove null values. + foreach ($result as $k => $v) { + if ($v === null) { + unset($result[$k]); + } + } + + return $result; + } + + /** + * Transfers the given request and applies request options. + * + * The URI of the request is not modified and the request options are used + * as-is without merging in default options. + * + * @param RequestInterface $request + * @param array $options + * + * @return Promise\PromiseInterface + */ + private function transfer(RequestInterface $request, array $options) + { + // save_to -> sink + if (isset($options['save_to'])) { + $options['sink'] = $options['save_to']; + unset($options['save_to']); + } + + // exceptions -> http_errors + if (isset($options['exceptions'])) { + $options['http_errors'] = $options['exceptions']; + unset($options['exceptions']); + } + + $request = $this->applyOptions($request, $options); + $handler = $options['handler']; + + try { + return Promise\promise_for($handler($request, $options)); + } catch (\Exception $e) { + return Promise\rejection_for($e); + } + } + + /** + * Applies the array of request options to a request. + * + * @param RequestInterface $request + * @param array $options + * + * @return RequestInterface + */ + private function applyOptions(RequestInterface $request, array &$options) + { + $modify = []; + + if (isset($options['form_params'])) { + if (isset($options['multipart'])) { + throw new \InvalidArgumentException('You cannot use ' + . 'form_params and multipart at the same time. Use the ' + . 'form_params option if you want to send application/' + . 'x-www-form-urlencoded requests, and the multipart ' + . 'option to send multipart/form-data requests.'); + } + $options['body'] = http_build_query($options['form_params'], '', '&'); + unset($options['form_params']); + $options['_conditional']['Content-Type'] = 'application/x-www-form-urlencoded'; + } + + if (isset($options['multipart'])) { + $options['body'] = new Psr7\MultipartStream($options['multipart']); + unset($options['multipart']); + } + + if (isset($options['json'])) { + $options['body'] = \GuzzleHttp\json_encode($options['json']); + unset($options['json']); + $options['_conditional']['Content-Type'] = 'application/json'; + } + + if (!empty($options['decode_content']) + && $options['decode_content'] !== true + ) { + $modify['set_headers']['Accept-Encoding'] = $options['decode_content']; + } + + if (isset($options['headers'])) { + if (isset($modify['set_headers'])) { + $modify['set_headers'] = $options['headers'] + $modify['set_headers']; + } else { + $modify['set_headers'] = $options['headers']; + } + unset($options['headers']); + } + + if (isset($options['body'])) { + if (is_array($options['body'])) { + $this->invalidBody(); + } + $modify['body'] = Psr7\stream_for($options['body']); + unset($options['body']); + } + + if (!empty($options['auth']) && is_array($options['auth'])) { + $value = $options['auth']; + $type = isset($value[2]) ? strtolower($value[2]) : 'basic'; + switch ($type) { + case 'basic': + $modify['set_headers']['Authorization'] = 'Basic ' + . base64_encode("$value[0]:$value[1]"); + break; + case 'digest': + // @todo: Do not rely on curl + $options['curl'][CURLOPT_HTTPAUTH] = CURLAUTH_DIGEST; + $options['curl'][CURLOPT_USERPWD] = "$value[0]:$value[1]"; + break; + case 'ntlm': + $options['curl'][CURLOPT_HTTPAUTH] = CURLAUTH_NTLM; + $options['curl'][CURLOPT_USERPWD] = "$value[0]:$value[1]"; + break; + } + } + + if (isset($options['query'])) { + $value = $options['query']; + if (is_array($value)) { + $value = http_build_query($value, null, '&', PHP_QUERY_RFC3986); + } + if (!is_string($value)) { + throw new \InvalidArgumentException('query must be a string or array'); + } + $modify['query'] = $value; + unset($options['query']); + } + + // Ensure that sink is not an invalid value. + if (isset($options['sink'])) { + // TODO: Add more sink validation? + if (is_bool($options['sink'])) { + throw new \InvalidArgumentException('sink must not be a boolean'); + } + } + + $request = Psr7\modify_request($request, $modify); + if ($request->getBody() instanceof Psr7\MultipartStream) { + // Use a multipart/form-data POST if a Content-Type is not set. + $options['_conditional']['Content-Type'] = 'multipart/form-data; boundary=' + . $request->getBody()->getBoundary(); + } + + // Merge in conditional headers if they are not present. + if (isset($options['_conditional'])) { + // Build up the changes so it's in a single clone of the message. + $modify = []; + foreach ($options['_conditional'] as $k => $v) { + if (!$request->hasHeader($k)) { + $modify['set_headers'][$k] = $v; + } + } + $request = Psr7\modify_request($request, $modify); + // Don't pass this internal value along to middleware/handlers. + unset($options['_conditional']); + } + + return $request; + } + + private function invalidBody() + { + throw new \InvalidArgumentException('Passing in the "body" request ' + . 'option as an array to send a POST request has been deprecated. ' + . 'Please use the "form_params" request option to send a ' + . 'application/x-www-form-urlencoded request, or the "multipart" ' + . 'request option to send a multipart/form-data request.'); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/ClientInterface.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/ClientInterface.php new file mode 100644 index 0000000..5a67b66 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/ClientInterface.php @@ -0,0 +1,84 @@ +strictMode = $strictMode; + + foreach ($cookieArray as $cookie) { + if (!($cookie instanceof SetCookie)) { + $cookie = new SetCookie($cookie); + } + $this->setCookie($cookie); + } + } + + /** + * Create a new Cookie jar from an associative array and domain. + * + * @param array $cookies Cookies to create the jar from + * @param string $domain Domain to set the cookies to + * + * @return self + */ + public static function fromArray(array $cookies, $domain) + { + $cookieJar = new self(); + foreach ($cookies as $name => $value) { + $cookieJar->setCookie(new SetCookie([ + 'Domain' => $domain, + 'Name' => $name, + 'Value' => $value, + 'Discard' => true + ])); + } + + return $cookieJar; + } + + /** + * @deprecated + */ + public static function getCookieValue($value) + { + return $value; + } + + /** + * Evaluate if this cookie should be persisted to storage + * that survives between requests. + * + * @param SetCookie $cookie Being evaluated. + * @param bool $allowSessionCookies If we should persist session cookies + * @return bool + */ + public static function shouldPersist( + SetCookie $cookie, + $allowSessionCookies = false + ) { + if ($cookie->getExpires() || $allowSessionCookies) { + if (!$cookie->getDiscard()) { + return true; + } + } + + return false; + } + + /** + * Finds and returns the cookie based on the name + * + * @param string $name cookie name to search for + * @return SetCookie|null cookie that was found or null if not found + */ + public function getCookieByName($name) + { + // don't allow a null name + if($name === null) { + return null; + } + foreach($this->cookies as $cookie) { + if($cookie->getName() !== null && strcasecmp($cookie->getName(), $name) === 0) { + return $cookie; + } + } + } + + public function toArray() + { + return array_map(function (SetCookie $cookie) { + return $cookie->toArray(); + }, $this->getIterator()->getArrayCopy()); + } + + public function clear($domain = null, $path = null, $name = null) + { + if (!$domain) { + $this->cookies = []; + return; + } elseif (!$path) { + $this->cookies = array_filter( + $this->cookies, + function (SetCookie $cookie) use ($path, $domain) { + return !$cookie->matchesDomain($domain); + } + ); + } elseif (!$name) { + $this->cookies = array_filter( + $this->cookies, + function (SetCookie $cookie) use ($path, $domain) { + return !($cookie->matchesPath($path) && + $cookie->matchesDomain($domain)); + } + ); + } else { + $this->cookies = array_filter( + $this->cookies, + function (SetCookie $cookie) use ($path, $domain, $name) { + return !($cookie->getName() == $name && + $cookie->matchesPath($path) && + $cookie->matchesDomain($domain)); + } + ); + } + } + + public function clearSessionCookies() + { + $this->cookies = array_filter( + $this->cookies, + function (SetCookie $cookie) { + return !$cookie->getDiscard() && $cookie->getExpires(); + } + ); + } + + public function setCookie(SetCookie $cookie) + { + // If the name string is empty (but not 0), ignore the set-cookie + // string entirely. + $name = $cookie->getName(); + if (!$name && $name !== '0') { + return false; + } + + // Only allow cookies with set and valid domain, name, value + $result = $cookie->validate(); + if ($result !== true) { + if ($this->strictMode) { + throw new \RuntimeException('Invalid cookie: ' . $result); + } else { + $this->removeCookieIfEmpty($cookie); + return false; + } + } + + // Resolve conflicts with previously set cookies + foreach ($this->cookies as $i => $c) { + + // Two cookies are identical, when their path, and domain are + // identical. + if ($c->getPath() != $cookie->getPath() || + $c->getDomain() != $cookie->getDomain() || + $c->getName() != $cookie->getName() + ) { + continue; + } + + // The previously set cookie is a discard cookie and this one is + // not so allow the new cookie to be set + if (!$cookie->getDiscard() && $c->getDiscard()) { + unset($this->cookies[$i]); + continue; + } + + // If the new cookie's expiration is further into the future, then + // replace the old cookie + if ($cookie->getExpires() > $c->getExpires()) { + unset($this->cookies[$i]); + continue; + } + + // If the value has changed, we better change it + if ($cookie->getValue() !== $c->getValue()) { + unset($this->cookies[$i]); + continue; + } + + // The cookie exists, so no need to continue + return false; + } + + $this->cookies[] = $cookie; + + return true; + } + + public function count() + { + return count($this->cookies); + } + + public function getIterator() + { + return new \ArrayIterator(array_values($this->cookies)); + } + + public function extractCookies( + RequestInterface $request, + ResponseInterface $response + ) { + if ($cookieHeader = $response->getHeader('Set-Cookie')) { + foreach ($cookieHeader as $cookie) { + $sc = SetCookie::fromString($cookie); + if (!$sc->getDomain()) { + $sc->setDomain($request->getUri()->getHost()); + } + if (0 !== strpos($sc->getPath(), '/')) { + $sc->setPath($this->getCookiePathFromRequest($request)); + } + $this->setCookie($sc); + } + } + } + + /** + * Computes cookie path following RFC 6265 section 5.1.4 + * + * @link https://tools.ietf.org/html/rfc6265#section-5.1.4 + * + * @param RequestInterface $request + * @return string + */ + private function getCookiePathFromRequest(RequestInterface $request) + { + $uriPath = $request->getUri()->getPath(); + if ('' === $uriPath) { + return '/'; + } + if (0 !== strpos($uriPath, '/')) { + return '/'; + } + if ('/' === $uriPath) { + return '/'; + } + if (0 === $lastSlashPos = strrpos($uriPath, '/')) { + return '/'; + } + + return substr($uriPath, 0, $lastSlashPos); + } + + public function withCookieHeader(RequestInterface $request) + { + $values = []; + $uri = $request->getUri(); + $scheme = $uri->getScheme(); + $host = $uri->getHost(); + $path = $uri->getPath() ?: '/'; + + foreach ($this->cookies as $cookie) { + if ($cookie->matchesPath($path) && + $cookie->matchesDomain($host) && + !$cookie->isExpired() && + (!$cookie->getSecure() || $scheme === 'https') + ) { + $values[] = $cookie->getName() . '=' + . $cookie->getValue(); + } + } + + return $values + ? $request->withHeader('Cookie', implode('; ', $values)) + : $request; + } + + /** + * If a cookie already exists and the server asks to set it again with a + * null value, the cookie must be deleted. + * + * @param SetCookie $cookie + */ + private function removeCookieIfEmpty(SetCookie $cookie) + { + $cookieValue = $cookie->getValue(); + if ($cookieValue === null || $cookieValue === '') { + $this->clear( + $cookie->getDomain(), + $cookie->getPath(), + $cookie->getName() + ); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/CookieJarInterface.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/CookieJarInterface.php new file mode 100644 index 0000000..2cf298a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/CookieJarInterface.php @@ -0,0 +1,84 @@ +filename = $cookieFile; + $this->storeSessionCookies = $storeSessionCookies; + + if (file_exists($cookieFile)) { + $this->load($cookieFile); + } + } + + /** + * Saves the file when shutting down + */ + public function __destruct() + { + $this->save($this->filename); + } + + /** + * Saves the cookies to a file. + * + * @param string $filename File to save + * @throws \RuntimeException if the file cannot be found or created + */ + public function save($filename) + { + $json = []; + foreach ($this as $cookie) { + /** @var SetCookie $cookie */ + if (CookieJar::shouldPersist($cookie, $this->storeSessionCookies)) { + $json[] = $cookie->toArray(); + } + } + + $jsonStr = \GuzzleHttp\json_encode($json); + if (false === file_put_contents($filename, $jsonStr)) { + throw new \RuntimeException("Unable to save file {$filename}"); + } + } + + /** + * Load cookies from a JSON formatted file. + * + * Old cookies are kept unless overwritten by newly loaded ones. + * + * @param string $filename Cookie file to load. + * @throws \RuntimeException if the file cannot be loaded. + */ + public function load($filename) + { + $json = file_get_contents($filename); + if (false === $json) { + throw new \RuntimeException("Unable to load file {$filename}"); + } elseif ($json === '') { + return; + } + + $data = \GuzzleHttp\json_decode($json, true); + if (is_array($data)) { + foreach (json_decode($json, true) as $cookie) { + $this->setCookie(new SetCookie($cookie)); + } + } elseif (strlen($data)) { + throw new \RuntimeException("Invalid cookie file: {$filename}"); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/SessionCookieJar.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/SessionCookieJar.php new file mode 100644 index 0000000..e4bfafd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/SessionCookieJar.php @@ -0,0 +1,71 @@ +sessionKey = $sessionKey; + $this->storeSessionCookies = $storeSessionCookies; + $this->load(); + } + + /** + * Saves cookies to session when shutting down + */ + public function __destruct() + { + $this->save(); + } + + /** + * Save cookies to the client session + */ + public function save() + { + $json = []; + foreach ($this as $cookie) { + /** @var SetCookie $cookie */ + if (CookieJar::shouldPersist($cookie, $this->storeSessionCookies)) { + $json[] = $cookie->toArray(); + } + } + + $_SESSION[$this->sessionKey] = json_encode($json); + } + + /** + * Load the contents of the client session into the data array + */ + protected function load() + { + if (!isset($_SESSION[$this->sessionKey])) { + return; + } + $data = json_decode($_SESSION[$this->sessionKey], true); + if (is_array($data)) { + foreach ($data as $cookie) { + $this->setCookie(new SetCookie($cookie)); + } + } elseif (strlen($data)) { + throw new \RuntimeException("Invalid cookie data"); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/SetCookie.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/SetCookie.php new file mode 100644 index 0000000..c911e2a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Cookie/SetCookie.php @@ -0,0 +1,404 @@ + null, + 'Value' => null, + 'Domain' => null, + 'Path' => '/', + 'Max-Age' => null, + 'Expires' => null, + 'Secure' => false, + 'Discard' => false, + 'HttpOnly' => false + ]; + + /** @var array Cookie data */ + private $data; + + /** + * Create a new SetCookie object from a string + * + * @param string $cookie Set-Cookie header string + * + * @return self + */ + public static function fromString($cookie) + { + // Create the default return array + $data = self::$defaults; + // Explode the cookie string using a series of semicolons + $pieces = array_filter(array_map('trim', explode(';', $cookie))); + // The name of the cookie (first kvp) must include an equal sign. + if (empty($pieces) || !strpos($pieces[0], '=')) { + return new self($data); + } + + // Add the cookie pieces into the parsed data array + foreach ($pieces as $part) { + + $cookieParts = explode('=', $part, 2); + $key = trim($cookieParts[0]); + $value = isset($cookieParts[1]) + ? trim($cookieParts[1], " \n\r\t\0\x0B") + : true; + + // Only check for non-cookies when cookies have been found + if (empty($data['Name'])) { + $data['Name'] = $key; + $data['Value'] = $value; + } else { + foreach (array_keys(self::$defaults) as $search) { + if (!strcasecmp($search, $key)) { + $data[$search] = $value; + continue 2; + } + } + $data[$key] = $value; + } + } + + return new self($data); + } + + /** + * @param array $data Array of cookie data provided by a Cookie parser + */ + public function __construct(array $data = []) + { + $this->data = array_replace(self::$defaults, $data); + // Extract the Expires value and turn it into a UNIX timestamp if needed + if (!$this->getExpires() && $this->getMaxAge()) { + // Calculate the Expires date + $this->setExpires(time() + $this->getMaxAge()); + } elseif ($this->getExpires() && !is_numeric($this->getExpires())) { + $this->setExpires($this->getExpires()); + } + } + + public function __toString() + { + $str = $this->data['Name'] . '=' . $this->data['Value'] . '; '; + foreach ($this->data as $k => $v) { + if ($k !== 'Name' && $k !== 'Value' && $v !== null && $v !== false) { + if ($k === 'Expires') { + $str .= 'Expires=' . gmdate('D, d M Y H:i:s \G\M\T', $v) . '; '; + } else { + $str .= ($v === true ? $k : "{$k}={$v}") . '; '; + } + } + } + + return rtrim($str, '; '); + } + + public function toArray() + { + return $this->data; + } + + /** + * Get the cookie name + * + * @return string + */ + public function getName() + { + return $this->data['Name']; + } + + /** + * Set the cookie name + * + * @param string $name Cookie name + */ + public function setName($name) + { + $this->data['Name'] = $name; + } + + /** + * Get the cookie value + * + * @return string + */ + public function getValue() + { + return $this->data['Value']; + } + + /** + * Set the cookie value + * + * @param string $value Cookie value + */ + public function setValue($value) + { + $this->data['Value'] = $value; + } + + /** + * Get the domain + * + * @return string|null + */ + public function getDomain() + { + return $this->data['Domain']; + } + + /** + * Set the domain of the cookie + * + * @param string $domain + */ + public function setDomain($domain) + { + $this->data['Domain'] = $domain; + } + + /** + * Get the path + * + * @return string + */ + public function getPath() + { + return $this->data['Path']; + } + + /** + * Set the path of the cookie + * + * @param string $path Path of the cookie + */ + public function setPath($path) + { + $this->data['Path'] = $path; + } + + /** + * Maximum lifetime of the cookie in seconds + * + * @return int|null + */ + public function getMaxAge() + { + return $this->data['Max-Age']; + } + + /** + * Set the max-age of the cookie + * + * @param int $maxAge Max age of the cookie in seconds + */ + public function setMaxAge($maxAge) + { + $this->data['Max-Age'] = $maxAge; + } + + /** + * The UNIX timestamp when the cookie Expires + * + * @return mixed + */ + public function getExpires() + { + return $this->data['Expires']; + } + + /** + * Set the unix timestamp for which the cookie will expire + * + * @param int $timestamp Unix timestamp + */ + public function setExpires($timestamp) + { + $this->data['Expires'] = is_numeric($timestamp) + ? (int) $timestamp + : strtotime($timestamp); + } + + /** + * Get whether or not this is a secure cookie + * + * @return null|bool + */ + public function getSecure() + { + return $this->data['Secure']; + } + + /** + * Set whether or not the cookie is secure + * + * @param bool $secure Set to true or false if secure + */ + public function setSecure($secure) + { + $this->data['Secure'] = $secure; + } + + /** + * Get whether or not this is a session cookie + * + * @return null|bool + */ + public function getDiscard() + { + return $this->data['Discard']; + } + + /** + * Set whether or not this is a session cookie + * + * @param bool $discard Set to true or false if this is a session cookie + */ + public function setDiscard($discard) + { + $this->data['Discard'] = $discard; + } + + /** + * Get whether or not this is an HTTP only cookie + * + * @return bool + */ + public function getHttpOnly() + { + return $this->data['HttpOnly']; + } + + /** + * Set whether or not this is an HTTP only cookie + * + * @param bool $httpOnly Set to true or false if this is HTTP only + */ + public function setHttpOnly($httpOnly) + { + $this->data['HttpOnly'] = $httpOnly; + } + + /** + * Check if the cookie matches a path value. + * + * A request-path path-matches a given cookie-path if at least one of + * the following conditions holds: + * + * - The cookie-path and the request-path are identical. + * - The cookie-path is a prefix of the request-path, and the last + * character of the cookie-path is %x2F ("/"). + * - The cookie-path is a prefix of the request-path, and the first + * character of the request-path that is not included in the cookie- + * path is a %x2F ("/") character. + * + * @param string $requestPath Path to check against + * + * @return bool + */ + public function matchesPath($requestPath) + { + $cookiePath = $this->getPath(); + + // Match on exact matches or when path is the default empty "/" + if ($cookiePath === '/' || $cookiePath == $requestPath) { + return true; + } + + // Ensure that the cookie-path is a prefix of the request path. + if (0 !== strpos($requestPath, $cookiePath)) { + return false; + } + + // Match if the last character of the cookie-path is "/" + if (substr($cookiePath, -1, 1) === '/') { + return true; + } + + // Match if the first character not included in cookie path is "/" + return substr($requestPath, strlen($cookiePath), 1) === '/'; + } + + /** + * Check if the cookie matches a domain value + * + * @param string $domain Domain to check against + * + * @return bool + */ + public function matchesDomain($domain) + { + // Remove the leading '.' as per spec in RFC 6265. + // http://tools.ietf.org/html/rfc6265#section-5.2.3 + $cookieDomain = ltrim($this->getDomain(), '.'); + + // Domain not set or exact match. + if (!$cookieDomain || !strcasecmp($domain, $cookieDomain)) { + return true; + } + + // Matching the subdomain according to RFC 6265. + // http://tools.ietf.org/html/rfc6265#section-5.1.3 + if (filter_var($domain, FILTER_VALIDATE_IP)) { + return false; + } + + return (bool) preg_match('/\.' . preg_quote($cookieDomain) . '$/', $domain); + } + + /** + * Check if the cookie is expired + * + * @return bool + */ + public function isExpired() + { + return $this->getExpires() && time() > $this->getExpires(); + } + + /** + * Check if the cookie is valid according to RFC 6265 + * + * @return bool|string Returns true if valid or an error message if invalid + */ + public function validate() + { + // Names must not be empty, but can be 0 + $name = $this->getName(); + if (empty($name) && !is_numeric($name)) { + return 'The cookie name must not be empty'; + } + + // Check if any of the invalid characters are present in the cookie name + if (preg_match( + '/[\x00-\x20\x22\x28-\x29\x2c\x2f\x3a-\x40\x5c\x7b\x7d\x7f]/', + $name) + ) { + return 'Cookie name must not contain invalid characters: ASCII ' + . 'Control characters (0-31;127), space, tab and the ' + . 'following characters: ()<>@,;:\"/?={}'; + } + + // Value must not be empty, but can be 0 + $value = $this->getValue(); + if (empty($value) && !is_numeric($value)) { + return 'The cookie value must not be empty'; + } + + // Domains must not be empty, but can be 0 + // A "0" is not a valid internet domain, but may be used as server name + // in a private network. + $domain = $this->getDomain(); + if (empty($domain) && !is_numeric($domain)) { + return 'The cookie domain must not be empty'; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/BadResponseException.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/BadResponseException.php new file mode 100644 index 0000000..427d896 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/BadResponseException.php @@ -0,0 +1,27 @@ +getStatusCode() + : 0; + parent::__construct($message, $code, $previous); + $this->request = $request; + $this->response = $response; + $this->handlerContext = $handlerContext; + } + + /** + * Wrap non-RequestExceptions with a RequestException + * + * @param RequestInterface $request + * @param \Exception $e + * + * @return RequestException + */ + public static function wrapException(RequestInterface $request, \Exception $e) + { + return $e instanceof RequestException + ? $e + : new RequestException($e->getMessage(), $request, null, $e); + } + + /** + * Factory method to create a new exception with a normalized error message + * + * @param RequestInterface $request Request + * @param ResponseInterface $response Response received + * @param \Exception $previous Previous exception + * @param array $ctx Optional handler context. + * + * @return self + */ + public static function create( + RequestInterface $request, + ResponseInterface $response = null, + \Exception $previous = null, + array $ctx = [] + ) { + if (!$response) { + return new self( + 'Error completing request', + $request, + null, + $previous, + $ctx + ); + } + + $level = (int) floor($response->getStatusCode() / 100); + if ($level === 4) { + $label = 'Client error'; + $className = ClientException::class; + } elseif ($level === 5) { + $label = 'Server error'; + $className = ServerException::class; + } else { + $label = 'Unsuccessful request'; + $className = __CLASS__; + } + + $uri = $request->getUri(); + $uri = static::obfuscateUri($uri); + + // Client Error: `GET /` resulted in a `404 Not Found` response: + // ... (truncated) + $message = sprintf( + '%s: `%s %s` resulted in a `%s %s` response', + $label, + $request->getMethod(), + $uri, + $response->getStatusCode(), + $response->getReasonPhrase() + ); + + $summary = static::getResponseBodySummary($response); + + if ($summary !== null) { + $message .= ":\n{$summary}\n"; + } + + return new $className($message, $request, $response, $previous, $ctx); + } + + /** + * Get a short summary of the response + * + * Will return `null` if the response is not printable. + * + * @param ResponseInterface $response + * + * @return string|null + */ + public static function getResponseBodySummary(ResponseInterface $response) + { + $body = $response->getBody(); + + if (!$body->isSeekable()) { + return null; + } + + $size = $body->getSize(); + + if ($size === 0) { + return null; + } + + $summary = $body->read(120); + $body->rewind(); + + if ($size > 120) { + $summary .= ' (truncated...)'; + } + + // Matches any printable character, including unicode characters: + // letters, marks, numbers, punctuation, spacing, and separators. + if (preg_match('/[^\pL\pM\pN\pP\pS\pZ\n\r\t]/', $summary)) { + return null; + } + + return $summary; + } + + /** + * Obfuscates URI if there is an username and a password present + * + * @param UriInterface $uri + * + * @return UriInterface + */ + private static function obfuscateUri($uri) + { + $userInfo = $uri->getUserInfo(); + + if (false !== ($pos = strpos($userInfo, ':'))) { + return $uri->withUserInfo(substr($userInfo, 0, $pos), '***'); + } + + return $uri; + } + + /** + * Get the request that caused the exception + * + * @return RequestInterface + */ + public function getRequest() + { + return $this->request; + } + + /** + * Get the associated response + * + * @return ResponseInterface|null + */ + public function getResponse() + { + return $this->response; + } + + /** + * Check if a response was received + * + * @return bool + */ + public function hasResponse() + { + return $this->response !== null; + } + + /** + * Get contextual information about the error from the underlying handler. + * + * The contents of this array will vary depending on which handler you are + * using. It may also be just an empty array. Relying on this data will + * couple you to a specific handler, but can give more debug information + * when needed. + * + * @return array + */ + public function getHandlerContext() + { + return $this->handlerContext; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/SeekException.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/SeekException.php new file mode 100644 index 0000000..a77c289 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/SeekException.php @@ -0,0 +1,27 @@ +stream = $stream; + $msg = $msg ?: 'Could not seek the stream to position ' . $pos; + parent::__construct($msg); + } + + /** + * @return StreamInterface + */ + public function getStream() + { + return $this->stream; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/ServerException.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/ServerException.php new file mode 100644 index 0000000..7cdd340 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Exception/ServerException.php @@ -0,0 +1,7 @@ +maxHandles = $maxHandles; + } + + public function create(RequestInterface $request, array $options) + { + if (isset($options['curl']['body_as_string'])) { + $options['_body_as_string'] = $options['curl']['body_as_string']; + unset($options['curl']['body_as_string']); + } + + $easy = new EasyHandle; + $easy->request = $request; + $easy->options = $options; + $conf = $this->getDefaultConf($easy); + $this->applyMethod($easy, $conf); + $this->applyHandlerOptions($easy, $conf); + $this->applyHeaders($easy, $conf); + unset($conf['_headers']); + + // Add handler options from the request configuration options + if (isset($options['curl'])) { + $conf = array_replace($conf, $options['curl']); + } + + $conf[CURLOPT_HEADERFUNCTION] = $this->createHeaderFn($easy); + $easy->handle = $this->handles + ? array_pop($this->handles) + : curl_init(); + curl_setopt_array($easy->handle, $conf); + + return $easy; + } + + public function release(EasyHandle $easy) + { + $resource = $easy->handle; + unset($easy->handle); + + if (count($this->handles) >= $this->maxHandles) { + curl_close($resource); + } else { + // Remove all callback functions as they can hold onto references + // and are not cleaned up by curl_reset. Using curl_setopt_array + // does not work for some reason, so removing each one + // individually. + curl_setopt($resource, CURLOPT_HEADERFUNCTION, null); + curl_setopt($resource, CURLOPT_READFUNCTION, null); + curl_setopt($resource, CURLOPT_WRITEFUNCTION, null); + curl_setopt($resource, CURLOPT_PROGRESSFUNCTION, null); + curl_reset($resource); + $this->handles[] = $resource; + } + } + + /** + * Completes a cURL transaction, either returning a response promise or a + * rejected promise. + * + * @param callable $handler + * @param EasyHandle $easy + * @param CurlFactoryInterface $factory Dictates how the handle is released + * + * @return \GuzzleHttp\Promise\PromiseInterface + */ + public static function finish( + callable $handler, + EasyHandle $easy, + CurlFactoryInterface $factory + ) { + if (isset($easy->options['on_stats'])) { + self::invokeStats($easy); + } + + if (!$easy->response || $easy->errno) { + return self::finishError($handler, $easy, $factory); + } + + // Return the response if it is present and there is no error. + $factory->release($easy); + + // Rewind the body of the response if possible. + $body = $easy->response->getBody(); + if ($body->isSeekable()) { + $body->rewind(); + } + + return new FulfilledPromise($easy->response); + } + + private static function invokeStats(EasyHandle $easy) + { + $curlStats = curl_getinfo($easy->handle); + $stats = new TransferStats( + $easy->request, + $easy->response, + $curlStats['total_time'], + $easy->errno, + $curlStats + ); + call_user_func($easy->options['on_stats'], $stats); + } + + private static function finishError( + callable $handler, + EasyHandle $easy, + CurlFactoryInterface $factory + ) { + // Get error information and release the handle to the factory. + $ctx = [ + 'errno' => $easy->errno, + 'error' => curl_error($easy->handle), + ] + curl_getinfo($easy->handle); + $factory->release($easy); + + // Retry when nothing is present or when curl failed to rewind. + if (empty($easy->options['_err_message']) + && (!$easy->errno || $easy->errno == 65) + ) { + return self::retryFailedRewind($handler, $easy, $ctx); + } + + return self::createRejection($easy, $ctx); + } + + private static function createRejection(EasyHandle $easy, array $ctx) + { + static $connectionErrors = [ + CURLE_OPERATION_TIMEOUTED => true, + CURLE_COULDNT_RESOLVE_HOST => true, + CURLE_COULDNT_CONNECT => true, + CURLE_SSL_CONNECT_ERROR => true, + CURLE_GOT_NOTHING => true, + ]; + + // If an exception was encountered during the onHeaders event, then + // return a rejected promise that wraps that exception. + if ($easy->onHeadersException) { + return \GuzzleHttp\Promise\rejection_for( + new RequestException( + 'An error was encountered during the on_headers event', + $easy->request, + $easy->response, + $easy->onHeadersException, + $ctx + ) + ); + } + + $message = sprintf( + 'cURL error %s: %s (%s)', + $ctx['errno'], + $ctx['error'], + 'see http://curl.haxx.se/libcurl/c/libcurl-errors.html' + ); + + // Create a connection exception if it was a specific error code. + $error = isset($connectionErrors[$easy->errno]) + ? new ConnectException($message, $easy->request, null, $ctx) + : new RequestException($message, $easy->request, $easy->response, null, $ctx); + + return \GuzzleHttp\Promise\rejection_for($error); + } + + private function getDefaultConf(EasyHandle $easy) + { + $conf = [ + '_headers' => $easy->request->getHeaders(), + CURLOPT_CUSTOMREQUEST => $easy->request->getMethod(), + CURLOPT_URL => (string) $easy->request->getUri()->withFragment(''), + CURLOPT_RETURNTRANSFER => false, + CURLOPT_HEADER => false, + CURLOPT_CONNECTTIMEOUT => 150, + ]; + + if (defined('CURLOPT_PROTOCOLS')) { + $conf[CURLOPT_PROTOCOLS] = CURLPROTO_HTTP | CURLPROTO_HTTPS; + } + + $version = $easy->request->getProtocolVersion(); + if ($version == 1.1) { + $conf[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1; + } elseif ($version == 2.0) { + $conf[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_2_0; + } else { + $conf[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_0; + } + + return $conf; + } + + private function applyMethod(EasyHandle $easy, array &$conf) + { + $body = $easy->request->getBody(); + $size = $body->getSize(); + + if ($size === null || $size > 0) { + $this->applyBody($easy->request, $easy->options, $conf); + return; + } + + $method = $easy->request->getMethod(); + if ($method === 'PUT' || $method === 'POST') { + // See http://tools.ietf.org/html/rfc7230#section-3.3.2 + if (!$easy->request->hasHeader('Content-Length')) { + $conf[CURLOPT_HTTPHEADER][] = 'Content-Length: 0'; + } + } elseif ($method === 'HEAD') { + $conf[CURLOPT_NOBODY] = true; + unset( + $conf[CURLOPT_WRITEFUNCTION], + $conf[CURLOPT_READFUNCTION], + $conf[CURLOPT_FILE], + $conf[CURLOPT_INFILE] + ); + } + } + + private function applyBody(RequestInterface $request, array $options, array &$conf) + { + $size = $request->hasHeader('Content-Length') + ? (int) $request->getHeaderLine('Content-Length') + : null; + + // Send the body as a string if the size is less than 1MB OR if the + // [curl][body_as_string] request value is set. + if (($size !== null && $size < 1000000) || + !empty($options['_body_as_string']) + ) { + $conf[CURLOPT_POSTFIELDS] = (string) $request->getBody(); + // Don't duplicate the Content-Length header + $this->removeHeader('Content-Length', $conf); + $this->removeHeader('Transfer-Encoding', $conf); + } else { + $conf[CURLOPT_UPLOAD] = true; + if ($size !== null) { + $conf[CURLOPT_INFILESIZE] = $size; + $this->removeHeader('Content-Length', $conf); + } + $body = $request->getBody(); + if ($body->isSeekable()) { + $body->rewind(); + } + $conf[CURLOPT_READFUNCTION] = function ($ch, $fd, $length) use ($body) { + return $body->read($length); + }; + } + + // If the Expect header is not present, prevent curl from adding it + if (!$request->hasHeader('Expect')) { + $conf[CURLOPT_HTTPHEADER][] = 'Expect:'; + } + + // cURL sometimes adds a content-type by default. Prevent this. + if (!$request->hasHeader('Content-Type')) { + $conf[CURLOPT_HTTPHEADER][] = 'Content-Type:'; + } + } + + private function applyHeaders(EasyHandle $easy, array &$conf) + { + foreach ($conf['_headers'] as $name => $values) { + foreach ($values as $value) { + $conf[CURLOPT_HTTPHEADER][] = "$name: $value"; + } + } + + // Remove the Accept header if one was not set + if (!$easy->request->hasHeader('Accept')) { + $conf[CURLOPT_HTTPHEADER][] = 'Accept:'; + } + } + + /** + * Remove a header from the options array. + * + * @param string $name Case-insensitive header to remove + * @param array $options Array of options to modify + */ + private function removeHeader($name, array &$options) + { + foreach (array_keys($options['_headers']) as $key) { + if (!strcasecmp($key, $name)) { + unset($options['_headers'][$key]); + return; + } + } + } + + private function applyHandlerOptions(EasyHandle $easy, array &$conf) + { + $options = $easy->options; + if (isset($options['verify'])) { + if ($options['verify'] === false) { + unset($conf[CURLOPT_CAINFO]); + $conf[CURLOPT_SSL_VERIFYHOST] = 0; + $conf[CURLOPT_SSL_VERIFYPEER] = false; + } else { + $conf[CURLOPT_SSL_VERIFYHOST] = 2; + $conf[CURLOPT_SSL_VERIFYPEER] = true; + if (is_string($options['verify'])) { + // Throw an error if the file/folder/link path is not valid or doesn't exist. + if (!file_exists($options['verify'])) { + throw new \InvalidArgumentException( + "SSL CA bundle not found: {$options['verify']}" + ); + } + // If it's a directory or a link to a directory use CURLOPT_CAPATH. + // If not, it's probably a file, or a link to a file, so use CURLOPT_CAINFO. + if (is_dir($options['verify']) || + (is_link($options['verify']) && is_dir(readlink($options['verify'])))) { + $conf[CURLOPT_CAPATH] = $options['verify']; + } else { + $conf[CURLOPT_CAINFO] = $options['verify']; + } + } + } + } + + if (!empty($options['decode_content'])) { + $accept = $easy->request->getHeaderLine('Accept-Encoding'); + if ($accept) { + $conf[CURLOPT_ENCODING] = $accept; + } else { + $conf[CURLOPT_ENCODING] = ''; + // Don't let curl send the header over the wire + $conf[CURLOPT_HTTPHEADER][] = 'Accept-Encoding:'; + } + } + + if (isset($options['sink'])) { + $sink = $options['sink']; + if (!is_string($sink)) { + $sink = \GuzzleHttp\Psr7\stream_for($sink); + } elseif (!is_dir(dirname($sink))) { + // Ensure that the directory exists before failing in curl. + throw new \RuntimeException(sprintf( + 'Directory %s does not exist for sink value of %s', + dirname($sink), + $sink + )); + } else { + $sink = new LazyOpenStream($sink, 'w+'); + } + $easy->sink = $sink; + $conf[CURLOPT_WRITEFUNCTION] = function ($ch, $write) use ($sink) { + return $sink->write($write); + }; + } else { + // Use a default temp stream if no sink was set. + $conf[CURLOPT_FILE] = fopen('php://temp', 'w+'); + $easy->sink = Psr7\stream_for($conf[CURLOPT_FILE]); + } + $timeoutRequiresNoSignal = false; + if (isset($options['timeout'])) { + $timeoutRequiresNoSignal |= $options['timeout'] < 1; + $conf[CURLOPT_TIMEOUT_MS] = $options['timeout'] * 1000; + } + + // CURL default value is CURL_IPRESOLVE_WHATEVER + if (isset($options['force_ip_resolve'])) { + if ('v4' === $options['force_ip_resolve']) { + $conf[CURLOPT_IPRESOLVE] = CURL_IPRESOLVE_V4; + } else if ('v6' === $options['force_ip_resolve']) { + $conf[CURLOPT_IPRESOLVE] = CURL_IPRESOLVE_V6; + } + } + + if (isset($options['connect_timeout'])) { + $timeoutRequiresNoSignal |= $options['connect_timeout'] < 1; + $conf[CURLOPT_CONNECTTIMEOUT_MS] = $options['connect_timeout'] * 1000; + } + + if ($timeoutRequiresNoSignal && strtoupper(substr(PHP_OS, 0, 3)) !== 'WIN') { + $conf[CURLOPT_NOSIGNAL] = true; + } + + if (isset($options['proxy'])) { + if (!is_array($options['proxy'])) { + $conf[CURLOPT_PROXY] = $options['proxy']; + } else { + $scheme = $easy->request->getUri()->getScheme(); + if (isset($options['proxy'][$scheme])) { + $host = $easy->request->getUri()->getHost(); + if (!isset($options['proxy']['no']) || + !\GuzzleHttp\is_host_in_noproxy($host, $options['proxy']['no']) + ) { + $conf[CURLOPT_PROXY] = $options['proxy'][$scheme]; + } + } + } + } + + if (isset($options['cert'])) { + $cert = $options['cert']; + if (is_array($cert)) { + $conf[CURLOPT_SSLCERTPASSWD] = $cert[1]; + $cert = $cert[0]; + } + if (!file_exists($cert)) { + throw new \InvalidArgumentException( + "SSL certificate not found: {$cert}" + ); + } + $conf[CURLOPT_SSLCERT] = $cert; + } + + if (isset($options['ssl_key'])) { + $sslKey = $options['ssl_key']; + if (is_array($sslKey)) { + $conf[CURLOPT_SSLKEYPASSWD] = $sslKey[1]; + $sslKey = $sslKey[0]; + } + if (!file_exists($sslKey)) { + throw new \InvalidArgumentException( + "SSL private key not found: {$sslKey}" + ); + } + $conf[CURLOPT_SSLKEY] = $sslKey; + } + + if (isset($options['progress'])) { + $progress = $options['progress']; + if (!is_callable($progress)) { + throw new \InvalidArgumentException( + 'progress client option must be callable' + ); + } + $conf[CURLOPT_NOPROGRESS] = false; + $conf[CURLOPT_PROGRESSFUNCTION] = function () use ($progress) { + $args = func_get_args(); + // PHP 5.5 pushed the handle onto the start of the args + if (is_resource($args[0])) { + array_shift($args); + } + call_user_func_array($progress, $args); + }; + } + + if (!empty($options['debug'])) { + $conf[CURLOPT_STDERR] = \GuzzleHttp\debug_resource($options['debug']); + $conf[CURLOPT_VERBOSE] = true; + } + } + + /** + * This function ensures that a response was set on a transaction. If one + * was not set, then the request is retried if possible. This error + * typically means you are sending a payload, curl encountered a + * "Connection died, retrying a fresh connect" error, tried to rewind the + * stream, and then encountered a "necessary data rewind wasn't possible" + * error, causing the request to be sent through curl_multi_info_read() + * without an error status. + */ + private static function retryFailedRewind( + callable $handler, + EasyHandle $easy, + array $ctx + ) { + try { + // Only rewind if the body has been read from. + $body = $easy->request->getBody(); + if ($body->tell() > 0) { + $body->rewind(); + } + } catch (\RuntimeException $e) { + $ctx['error'] = 'The connection unexpectedly failed without ' + . 'providing an error. The request would have been retried, ' + . 'but attempting to rewind the request body failed. ' + . 'Exception: ' . $e; + return self::createRejection($easy, $ctx); + } + + // Retry no more than 3 times before giving up. + if (!isset($easy->options['_curl_retries'])) { + $easy->options['_curl_retries'] = 1; + } elseif ($easy->options['_curl_retries'] == 2) { + $ctx['error'] = 'The cURL request was retried 3 times ' + . 'and did not succeed. The most likely reason for the failure ' + . 'is that cURL was unable to rewind the body of the request ' + . 'and subsequent retries resulted in the same error. Turn on ' + . 'the debug option to see what went wrong. See ' + . 'https://bugs.php.net/bug.php?id=47204 for more information.'; + return self::createRejection($easy, $ctx); + } else { + $easy->options['_curl_retries']++; + } + + return $handler($easy->request, $easy->options); + } + + private function createHeaderFn(EasyHandle $easy) + { + if (isset($easy->options['on_headers'])) { + $onHeaders = $easy->options['on_headers']; + + if (!is_callable($onHeaders)) { + throw new \InvalidArgumentException('on_headers must be callable'); + } + } else { + $onHeaders = null; + } + + return function ($ch, $h) use ( + $onHeaders, + $easy, + &$startingResponse + ) { + $value = trim($h); + if ($value === '') { + $startingResponse = true; + $easy->createResponse(); + if ($onHeaders !== null) { + try { + $onHeaders($easy->response); + } catch (\Exception $e) { + // Associate the exception with the handle and trigger + // a curl header write error by returning 0. + $easy->onHeadersException = $e; + return -1; + } + } + } elseif ($startingResponse) { + $startingResponse = false; + $easy->headers = [$value]; + } else { + $easy->headers[] = $value; + } + return strlen($h); + }; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlFactoryInterface.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlFactoryInterface.php new file mode 100644 index 0000000..b0fc236 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlFactoryInterface.php @@ -0,0 +1,27 @@ +factory = isset($options['handle_factory']) + ? $options['handle_factory'] + : new CurlFactory(3); + } + + public function __invoke(RequestInterface $request, array $options) + { + if (isset($options['delay'])) { + usleep($options['delay'] * 1000); + } + + $easy = $this->factory->create($request, $options); + curl_exec($easy->handle); + $easy->errno = curl_errno($easy->handle); + + return CurlFactory::finish($this, $easy, $this->factory); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlMultiHandler.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlMultiHandler.php new file mode 100644 index 0000000..945d06e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/CurlMultiHandler.php @@ -0,0 +1,197 @@ +factory = isset($options['handle_factory']) + ? $options['handle_factory'] : new CurlFactory(50); + $this->selectTimeout = isset($options['select_timeout']) + ? $options['select_timeout'] : 1; + } + + public function __get($name) + { + if ($name === '_mh') { + return $this->_mh = curl_multi_init(); + } + + throw new \BadMethodCallException(); + } + + public function __destruct() + { + if (isset($this->_mh)) { + curl_multi_close($this->_mh); + unset($this->_mh); + } + } + + public function __invoke(RequestInterface $request, array $options) + { + $easy = $this->factory->create($request, $options); + $id = (int) $easy->handle; + + $promise = new Promise( + [$this, 'execute'], + function () use ($id) { return $this->cancel($id); } + ); + + $this->addRequest(['easy' => $easy, 'deferred' => $promise]); + + return $promise; + } + + /** + * Ticks the curl event loop. + */ + public function tick() + { + // Add any delayed handles if needed. + if ($this->delays) { + $currentTime = microtime(true); + foreach ($this->delays as $id => $delay) { + if ($currentTime >= $delay) { + unset($this->delays[$id]); + curl_multi_add_handle( + $this->_mh, + $this->handles[$id]['easy']->handle + ); + } + } + } + + // Step through the task queue which may add additional requests. + P\queue()->run(); + + if ($this->active && + curl_multi_select($this->_mh, $this->selectTimeout) === -1 + ) { + // Perform a usleep if a select returns -1. + // See: https://bugs.php.net/bug.php?id=61141 + usleep(250); + } + + while (curl_multi_exec($this->_mh, $this->active) === CURLM_CALL_MULTI_PERFORM); + + $this->processMessages(); + } + + /** + * Runs until all outstanding connections have completed. + */ + public function execute() + { + $queue = P\queue(); + + while ($this->handles || !$queue->isEmpty()) { + // If there are no transfers, then sleep for the next delay + if (!$this->active && $this->delays) { + usleep($this->timeToNext()); + } + $this->tick(); + } + } + + private function addRequest(array $entry) + { + $easy = $entry['easy']; + $id = (int) $easy->handle; + $this->handles[$id] = $entry; + if (empty($easy->options['delay'])) { + curl_multi_add_handle($this->_mh, $easy->handle); + } else { + $this->delays[$id] = microtime(true) + ($easy->options['delay'] / 1000); + } + } + + /** + * Cancels a handle from sending and removes references to it. + * + * @param int $id Handle ID to cancel and remove. + * + * @return bool True on success, false on failure. + */ + private function cancel($id) + { + // Cannot cancel if it has been processed. + if (!isset($this->handles[$id])) { + return false; + } + + $handle = $this->handles[$id]['easy']->handle; + unset($this->delays[$id], $this->handles[$id]); + curl_multi_remove_handle($this->_mh, $handle); + curl_close($handle); + + return true; + } + + private function processMessages() + { + while ($done = curl_multi_info_read($this->_mh)) { + $id = (int) $done['handle']; + curl_multi_remove_handle($this->_mh, $done['handle']); + + if (!isset($this->handles[$id])) { + // Probably was cancelled. + continue; + } + + $entry = $this->handles[$id]; + unset($this->handles[$id], $this->delays[$id]); + $entry['easy']->errno = $done['result']; + $entry['deferred']->resolve( + CurlFactory::finish( + $this, + $entry['easy'], + $this->factory + ) + ); + } + } + + private function timeToNext() + { + $currentTime = microtime(true); + $nextTime = PHP_INT_MAX; + foreach ($this->delays as $time) { + if ($time < $nextTime) { + $nextTime = $time; + } + } + + return max(0, $nextTime - $currentTime) * 1000000; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/EasyHandle.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/EasyHandle.php new file mode 100644 index 0000000..7754e91 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/EasyHandle.php @@ -0,0 +1,92 @@ +headers)) { + throw new \RuntimeException('No headers have been received'); + } + + // HTTP-version SP status-code SP reason-phrase + $startLine = explode(' ', array_shift($this->headers), 3); + $headers = \GuzzleHttp\headers_from_lines($this->headers); + $normalizedKeys = \GuzzleHttp\normalize_header_keys($headers); + + if (!empty($this->options['decode_content']) + && isset($normalizedKeys['content-encoding']) + ) { + $headers['x-encoded-content-encoding'] + = $headers[$normalizedKeys['content-encoding']]; + unset($headers[$normalizedKeys['content-encoding']]); + if (isset($normalizedKeys['content-length'])) { + $headers['x-encoded-content-length'] + = $headers[$normalizedKeys['content-length']]; + + $bodyLength = (int) $this->sink->getSize(); + if ($bodyLength) { + $headers[$normalizedKeys['content-length']] = $bodyLength; + } else { + unset($headers[$normalizedKeys['content-length']]); + } + } + } + + // Attach a response to the easy handle with the parsed headers. + $this->response = new Response( + $startLine[1], + $headers, + $this->sink, + substr($startLine[0], 5), + isset($startLine[2]) ? (string) $startLine[2] : null + ); + } + + public function __get($name) + { + $msg = $name === 'handle' + ? 'The EasyHandle has been released' + : 'Invalid property: ' . $name; + throw new \BadMethodCallException($msg); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/MockHandler.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/MockHandler.php new file mode 100644 index 0000000..d892061 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/MockHandler.php @@ -0,0 +1,189 @@ +onFulfilled = $onFulfilled; + $this->onRejected = $onRejected; + + if ($queue) { + call_user_func_array([$this, 'append'], $queue); + } + } + + public function __invoke(RequestInterface $request, array $options) + { + if (!$this->queue) { + throw new \OutOfBoundsException('Mock queue is empty'); + } + + if (isset($options['delay'])) { + usleep($options['delay'] * 1000); + } + + $this->lastRequest = $request; + $this->lastOptions = $options; + $response = array_shift($this->queue); + + if (isset($options['on_headers'])) { + if (!is_callable($options['on_headers'])) { + throw new \InvalidArgumentException('on_headers must be callable'); + } + try { + $options['on_headers']($response); + } catch (\Exception $e) { + $msg = 'An error was encountered during the on_headers event'; + $response = new RequestException($msg, $request, $response, $e); + } + } + + if (is_callable($response)) { + $response = call_user_func($response, $request, $options); + } + + $response = $response instanceof \Exception + ? \GuzzleHttp\Promise\rejection_for($response) + : \GuzzleHttp\Promise\promise_for($response); + + return $response->then( + function ($value) use ($request, $options) { + $this->invokeStats($request, $options, $value); + if ($this->onFulfilled) { + call_user_func($this->onFulfilled, $value); + } + if (isset($options['sink'])) { + $contents = (string) $value->getBody(); + $sink = $options['sink']; + + if (is_resource($sink)) { + fwrite($sink, $contents); + } elseif (is_string($sink)) { + file_put_contents($sink, $contents); + } elseif ($sink instanceof \Psr\Http\Message\StreamInterface) { + $sink->write($contents); + } + } + + return $value; + }, + function ($reason) use ($request, $options) { + $this->invokeStats($request, $options, null, $reason); + if ($this->onRejected) { + call_user_func($this->onRejected, $reason); + } + return \GuzzleHttp\Promise\rejection_for($reason); + } + ); + } + + /** + * Adds one or more variadic requests, exceptions, callables, or promises + * to the queue. + */ + public function append() + { + foreach (func_get_args() as $value) { + if ($value instanceof ResponseInterface + || $value instanceof \Exception + || $value instanceof PromiseInterface + || is_callable($value) + ) { + $this->queue[] = $value; + } else { + throw new \InvalidArgumentException('Expected a response or ' + . 'exception. Found ' . \GuzzleHttp\describe_type($value)); + } + } + } + + /** + * Get the last received request. + * + * @return RequestInterface + */ + public function getLastRequest() + { + return $this->lastRequest; + } + + /** + * Get the last received request options. + * + * @return array + */ + public function getLastOptions() + { + return $this->lastOptions; + } + + /** + * Returns the number of remaining items in the queue. + * + * @return int + */ + public function count() + { + return count($this->queue); + } + + private function invokeStats( + RequestInterface $request, + array $options, + ResponseInterface $response = null, + $reason = null + ) { + if (isset($options['on_stats'])) { + $stats = new TransferStats($request, $response, 0, $reason); + call_user_func($options['on_stats'], $stats); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/Proxy.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/Proxy.php new file mode 100644 index 0000000..f8b00be --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Handler/Proxy.php @@ -0,0 +1,55 @@ +withoutHeader('Expect'); + + // Append a content-length header if body size is zero to match + // cURL's behavior. + if (0 === $request->getBody()->getSize()) { + $request = $request->withHeader('Content-Length', 0); + } + + return $this->createResponse( + $request, + $options, + $this->createStream($request, $options), + $startTime + ); + } catch (\InvalidArgumentException $e) { + throw $e; + } catch (\Exception $e) { + // Determine if the error was a networking error. + $message = $e->getMessage(); + // This list can probably get more comprehensive. + if (strpos($message, 'getaddrinfo') // DNS lookup failed + || strpos($message, 'Connection refused') + || strpos($message, "couldn't connect to host") // error on HHVM + ) { + $e = new ConnectException($e->getMessage(), $request, $e); + } + $e = RequestException::wrapException($request, $e); + $this->invokeStats($options, $request, $startTime, null, $e); + + return \GuzzleHttp\Promise\rejection_for($e); + } + } + + private function invokeStats( + array $options, + RequestInterface $request, + $startTime, + ResponseInterface $response = null, + $error = null + ) { + if (isset($options['on_stats'])) { + $stats = new TransferStats( + $request, + $response, + microtime(true) - $startTime, + $error, + [] + ); + call_user_func($options['on_stats'], $stats); + } + } + + private function createResponse( + RequestInterface $request, + array $options, + $stream, + $startTime + ) { + $hdrs = $this->lastHeaders; + $this->lastHeaders = []; + $parts = explode(' ', array_shift($hdrs), 3); + $ver = explode('/', $parts[0])[1]; + $status = $parts[1]; + $reason = isset($parts[2]) ? $parts[2] : null; + $headers = \GuzzleHttp\headers_from_lines($hdrs); + list ($stream, $headers) = $this->checkDecode($options, $headers, $stream); + $stream = Psr7\stream_for($stream); + $sink = $stream; + + if (strcasecmp('HEAD', $request->getMethod())) { + $sink = $this->createSink($stream, $options); + } + + $response = new Psr7\Response($status, $headers, $sink, $ver, $reason); + + if (isset($options['on_headers'])) { + try { + $options['on_headers']($response); + } catch (\Exception $e) { + $msg = 'An error was encountered during the on_headers event'; + $ex = new RequestException($msg, $request, $response, $e); + return \GuzzleHttp\Promise\rejection_for($ex); + } + } + + // Do not drain when the request is a HEAD request because they have + // no body. + if ($sink !== $stream) { + $this->drain( + $stream, + $sink, + $response->getHeaderLine('Content-Length') + ); + } + + $this->invokeStats($options, $request, $startTime, $response, null); + + return new FulfilledPromise($response); + } + + private function createSink(StreamInterface $stream, array $options) + { + if (!empty($options['stream'])) { + return $stream; + } + + $sink = isset($options['sink']) + ? $options['sink'] + : fopen('php://temp', 'r+'); + + return is_string($sink) + ? new Psr7\LazyOpenStream($sink, 'w+') + : Psr7\stream_for($sink); + } + + private function checkDecode(array $options, array $headers, $stream) + { + // Automatically decode responses when instructed. + if (!empty($options['decode_content'])) { + $normalizedKeys = \GuzzleHttp\normalize_header_keys($headers); + if (isset($normalizedKeys['content-encoding'])) { + $encoding = $headers[$normalizedKeys['content-encoding']]; + if ($encoding[0] === 'gzip' || $encoding[0] === 'deflate') { + $stream = new Psr7\InflateStream( + Psr7\stream_for($stream) + ); + $headers['x-encoded-content-encoding'] + = $headers[$normalizedKeys['content-encoding']]; + // Remove content-encoding header + unset($headers[$normalizedKeys['content-encoding']]); + // Fix content-length header + if (isset($normalizedKeys['content-length'])) { + $headers['x-encoded-content-length'] + = $headers[$normalizedKeys['content-length']]; + + $length = (int) $stream->getSize(); + if ($length === 0) { + unset($headers[$normalizedKeys['content-length']]); + } else { + $headers[$normalizedKeys['content-length']] = [$length]; + } + } + } + } + } + + return [$stream, $headers]; + } + + /** + * Drains the source stream into the "sink" client option. + * + * @param StreamInterface $source + * @param StreamInterface $sink + * @param string $contentLength Header specifying the amount of + * data to read. + * + * @return StreamInterface + * @throws \RuntimeException when the sink option is invalid. + */ + private function drain( + StreamInterface $source, + StreamInterface $sink, + $contentLength + ) { + // If a content-length header is provided, then stop reading once + // that number of bytes has been read. This can prevent infinitely + // reading from a stream when dealing with servers that do not honor + // Connection: Close headers. + Psr7\copy_to_stream( + $source, + $sink, + (strlen($contentLength) > 0 && (int) $contentLength > 0) ? (int) $contentLength : -1 + ); + + $sink->seek(0); + $source->close(); + + return $sink; + } + + /** + * Create a resource and check to ensure it was created successfully + * + * @param callable $callback Callable that returns stream resource + * + * @return resource + * @throws \RuntimeException on error + */ + private function createResource(callable $callback) + { + $errors = null; + set_error_handler(function ($_, $msg, $file, $line) use (&$errors) { + $errors[] = [ + 'message' => $msg, + 'file' => $file, + 'line' => $line + ]; + return true; + }); + + $resource = $callback(); + restore_error_handler(); + + if (!$resource) { + $message = 'Error creating resource: '; + foreach ($errors as $err) { + foreach ($err as $key => $value) { + $message .= "[$key] $value" . PHP_EOL; + } + } + throw new \RuntimeException(trim($message)); + } + + return $resource; + } + + private function createStream(RequestInterface $request, array $options) + { + static $methods; + if (!$methods) { + $methods = array_flip(get_class_methods(__CLASS__)); + } + + // HTTP/1.1 streams using the PHP stream wrapper require a + // Connection: close header + if ($request->getProtocolVersion() == '1.1' + && !$request->hasHeader('Connection') + ) { + $request = $request->withHeader('Connection', 'close'); + } + + // Ensure SSL is verified by default + if (!isset($options['verify'])) { + $options['verify'] = true; + } + + $params = []; + $context = $this->getDefaultContext($request, $options); + + if (isset($options['on_headers']) && !is_callable($options['on_headers'])) { + throw new \InvalidArgumentException('on_headers must be callable'); + } + + if (!empty($options)) { + foreach ($options as $key => $value) { + $method = "add_{$key}"; + if (isset($methods[$method])) { + $this->{$method}($request, $context, $value, $params); + } + } + } + + if (isset($options['stream_context'])) { + if (!is_array($options['stream_context'])) { + throw new \InvalidArgumentException('stream_context must be an array'); + } + $context = array_replace_recursive( + $context, + $options['stream_context'] + ); + } + + // Microsoft NTLM authentication only supported with curl handler + if (isset($options['auth']) + && is_array($options['auth']) + && isset($options['auth'][2]) + && 'ntlm' == $options['auth'][2] + ) { + + throw new \InvalidArgumentException('Microsoft NTLM authentication only supported with curl handler'); + } + + $uri = $this->resolveHost($request, $options); + + $context = $this->createResource( + function () use ($context, $params) { + return stream_context_create($context, $params); + } + ); + + return $this->createResource( + function () use ($uri, &$http_response_header, $context, $options) { + $resource = fopen((string) $uri, 'r', null, $context); + $this->lastHeaders = $http_response_header; + + if (isset($options['read_timeout'])) { + $readTimeout = $options['read_timeout']; + $sec = (int) $readTimeout; + $usec = ($readTimeout - $sec) * 100000; + stream_set_timeout($resource, $sec, $usec); + } + + return $resource; + } + ); + } + + private function resolveHost(RequestInterface $request, array $options) + { + $uri = $request->getUri(); + + if (isset($options['force_ip_resolve']) && !filter_var($uri->getHost(), FILTER_VALIDATE_IP)) { + if ('v4' === $options['force_ip_resolve']) { + $records = dns_get_record($uri->getHost(), DNS_A); + if (!isset($records[0]['ip'])) { + throw new ConnectException(sprintf("Could not resolve IPv4 address for host '%s'", $uri->getHost()), $request); + } + $uri = $uri->withHost($records[0]['ip']); + } elseif ('v6' === $options['force_ip_resolve']) { + $records = dns_get_record($uri->getHost(), DNS_AAAA); + if (!isset($records[0]['ipv6'])) { + throw new ConnectException(sprintf("Could not resolve IPv6 address for host '%s'", $uri->getHost()), $request); + } + $uri = $uri->withHost('[' . $records[0]['ipv6'] . ']'); + } + } + + return $uri; + } + + private function getDefaultContext(RequestInterface $request) + { + $headers = ''; + foreach ($request->getHeaders() as $name => $value) { + foreach ($value as $val) { + $headers .= "$name: $val\r\n"; + } + } + + $context = [ + 'http' => [ + 'method' => $request->getMethod(), + 'header' => $headers, + 'protocol_version' => $request->getProtocolVersion(), + 'ignore_errors' => true, + 'follow_location' => 0, + ], + ]; + + $body = (string) $request->getBody(); + + if (!empty($body)) { + $context['http']['content'] = $body; + // Prevent the HTTP handler from adding a Content-Type header. + if (!$request->hasHeader('Content-Type')) { + $context['http']['header'] .= "Content-Type:\r\n"; + } + } + + $context['http']['header'] = rtrim($context['http']['header']); + + return $context; + } + + private function add_proxy(RequestInterface $request, &$options, $value, &$params) + { + if (!is_array($value)) { + $options['http']['proxy'] = $value; + } else { + $scheme = $request->getUri()->getScheme(); + if (isset($value[$scheme])) { + if (!isset($value['no']) + || !\GuzzleHttp\is_host_in_noproxy( + $request->getUri()->getHost(), + $value['no'] + ) + ) { + $options['http']['proxy'] = $value[$scheme]; + } + } + } + } + + private function add_timeout(RequestInterface $request, &$options, $value, &$params) + { + if ($value > 0) { + $options['http']['timeout'] = $value; + } + } + + private function add_verify(RequestInterface $request, &$options, $value, &$params) + { + if ($value === true) { + // PHP 5.6 or greater will find the system cert by default. When + // < 5.6, use the Guzzle bundled cacert. + if (PHP_VERSION_ID < 50600) { + $options['ssl']['cafile'] = \GuzzleHttp\default_ca_bundle(); + } + } elseif (is_string($value)) { + $options['ssl']['cafile'] = $value; + if (!file_exists($value)) { + throw new \RuntimeException("SSL CA bundle not found: $value"); + } + } elseif ($value === false) { + $options['ssl']['verify_peer'] = false; + $options['ssl']['verify_peer_name'] = false; + return; + } else { + throw new \InvalidArgumentException('Invalid verify request option'); + } + + $options['ssl']['verify_peer'] = true; + $options['ssl']['verify_peer_name'] = true; + $options['ssl']['allow_self_signed'] = false; + } + + private function add_cert(RequestInterface $request, &$options, $value, &$params) + { + if (is_array($value)) { + $options['ssl']['passphrase'] = $value[1]; + $value = $value[0]; + } + + if (!file_exists($value)) { + throw new \RuntimeException("SSL certificate not found: {$value}"); + } + + $options['ssl']['local_cert'] = $value; + } + + private function add_progress(RequestInterface $request, &$options, $value, &$params) + { + $this->addNotification( + $params, + function ($code, $a, $b, $c, $transferred, $total) use ($value) { + if ($code == STREAM_NOTIFY_PROGRESS) { + $value($total, $transferred, null, null); + } + } + ); + } + + private function add_debug(RequestInterface $request, &$options, $value, &$params) + { + if ($value === false) { + return; + } + + static $map = [ + STREAM_NOTIFY_CONNECT => 'CONNECT', + STREAM_NOTIFY_AUTH_REQUIRED => 'AUTH_REQUIRED', + STREAM_NOTIFY_AUTH_RESULT => 'AUTH_RESULT', + STREAM_NOTIFY_MIME_TYPE_IS => 'MIME_TYPE_IS', + STREAM_NOTIFY_FILE_SIZE_IS => 'FILE_SIZE_IS', + STREAM_NOTIFY_REDIRECTED => 'REDIRECTED', + STREAM_NOTIFY_PROGRESS => 'PROGRESS', + STREAM_NOTIFY_FAILURE => 'FAILURE', + STREAM_NOTIFY_COMPLETED => 'COMPLETED', + STREAM_NOTIFY_RESOLVE => 'RESOLVE', + ]; + static $args = ['severity', 'message', 'message_code', + 'bytes_transferred', 'bytes_max']; + + $value = \GuzzleHttp\debug_resource($value); + $ident = $request->getMethod() . ' ' . $request->getUri()->withFragment(''); + $this->addNotification( + $params, + function () use ($ident, $value, $map, $args) { + $passed = func_get_args(); + $code = array_shift($passed); + fprintf($value, '<%s> [%s] ', $ident, $map[$code]); + foreach (array_filter($passed) as $i => $v) { + fwrite($value, $args[$i] . ': "' . $v . '" '); + } + fwrite($value, "\n"); + } + ); + } + + private function addNotification(array &$params, callable $notify) + { + // Wrap the existing function if needed. + if (!isset($params['notification'])) { + $params['notification'] = $notify; + } else { + $params['notification'] = $this->callArray([ + $params['notification'], + $notify + ]); + } + } + + private function callArray(array $functions) + { + return function () use ($functions) { + $args = func_get_args(); + foreach ($functions as $fn) { + call_user_func_array($fn, $args); + } + }; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/HandlerStack.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/HandlerStack.php new file mode 100644 index 0000000..a72e38a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/HandlerStack.php @@ -0,0 +1,273 @@ +push(Middleware::httpErrors(), 'http_errors'); + $stack->push(Middleware::redirect(), 'allow_redirects'); + $stack->push(Middleware::cookies(), 'cookies'); + $stack->push(Middleware::prepareBody(), 'prepare_body'); + + return $stack; + } + + /** + * @param callable $handler Underlying HTTP handler. + */ + public function __construct(callable $handler = null) + { + $this->handler = $handler; + } + + /** + * Invokes the handler stack as a composed handler + * + * @param RequestInterface $request + * @param array $options + */ + public function __invoke(RequestInterface $request, array $options) + { + $handler = $this->resolve(); + + return $handler($request, $options); + } + + /** + * Dumps a string representation of the stack. + * + * @return string + */ + public function __toString() + { + $depth = 0; + $stack = []; + if ($this->handler) { + $stack[] = "0) Handler: " . $this->debugCallable($this->handler); + } + + $result = ''; + foreach (array_reverse($this->stack) as $tuple) { + $depth++; + $str = "{$depth}) Name: '{$tuple[1]}', "; + $str .= "Function: " . $this->debugCallable($tuple[0]); + $result = "> {$str}\n{$result}"; + $stack[] = $str; + } + + foreach (array_keys($stack) as $k) { + $result .= "< {$stack[$k]}\n"; + } + + return $result; + } + + /** + * Set the HTTP handler that actually returns a promise. + * + * @param callable $handler Accepts a request and array of options and + * returns a Promise. + */ + public function setHandler(callable $handler) + { + $this->handler = $handler; + $this->cached = null; + } + + /** + * Returns true if the builder has a handler. + * + * @return bool + */ + public function hasHandler() + { + return (bool) $this->handler; + } + + /** + * Unshift a middleware to the bottom of the stack. + * + * @param callable $middleware Middleware function + * @param string $name Name to register for this middleware. + */ + public function unshift(callable $middleware, $name = null) + { + array_unshift($this->stack, [$middleware, $name]); + $this->cached = null; + } + + /** + * Push a middleware to the top of the stack. + * + * @param callable $middleware Middleware function + * @param string $name Name to register for this middleware. + */ + public function push(callable $middleware, $name = '') + { + $this->stack[] = [$middleware, $name]; + $this->cached = null; + } + + /** + * Add a middleware before another middleware by name. + * + * @param string $findName Middleware to find + * @param callable $middleware Middleware function + * @param string $withName Name to register for this middleware. + */ + public function before($findName, callable $middleware, $withName = '') + { + $this->splice($findName, $withName, $middleware, true); + } + + /** + * Add a middleware after another middleware by name. + * + * @param string $findName Middleware to find + * @param callable $middleware Middleware function + * @param string $withName Name to register for this middleware. + */ + public function after($findName, callable $middleware, $withName = '') + { + $this->splice($findName, $withName, $middleware, false); + } + + /** + * Remove a middleware by instance or name from the stack. + * + * @param callable|string $remove Middleware to remove by instance or name. + */ + public function remove($remove) + { + $this->cached = null; + $idx = is_callable($remove) ? 0 : 1; + $this->stack = array_values(array_filter( + $this->stack, + function ($tuple) use ($idx, $remove) { + return $tuple[$idx] !== $remove; + } + )); + } + + /** + * Compose the middleware and handler into a single callable function. + * + * @return callable + */ + public function resolve() + { + if (!$this->cached) { + if (!($prev = $this->handler)) { + throw new \LogicException('No handler has been specified'); + } + + foreach (array_reverse($this->stack) as $fn) { + $prev = $fn[0]($prev); + } + + $this->cached = $prev; + } + + return $this->cached; + } + + /** + * @param $name + * @return int + */ + private function findByName($name) + { + foreach ($this->stack as $k => $v) { + if ($v[1] === $name) { + return $k; + } + } + + throw new \InvalidArgumentException("Middleware not found: $name"); + } + + /** + * Splices a function into the middleware list at a specific position. + * + * @param $findName + * @param $withName + * @param callable $middleware + * @param $before + */ + private function splice($findName, $withName, callable $middleware, $before) + { + $this->cached = null; + $idx = $this->findByName($findName); + $tuple = [$middleware, $withName]; + + if ($before) { + if ($idx === 0) { + array_unshift($this->stack, $tuple); + } else { + $replacement = [$tuple, $this->stack[$idx]]; + array_splice($this->stack, $idx, 1, $replacement); + } + } elseif ($idx === count($this->stack) - 1) { + $this->stack[] = $tuple; + } else { + $replacement = [$this->stack[$idx], $tuple]; + array_splice($this->stack, $idx, 1, $replacement); + } + } + + /** + * Provides a debug string for a given callable. + * + * @param array|callable $fn Function to write as a string. + * + * @return string + */ + private function debugCallable($fn) + { + if (is_string($fn)) { + return "callable({$fn})"; + } + + if (is_array($fn)) { + return is_string($fn[0]) + ? "callable({$fn[0]}::{$fn[1]})" + : "callable(['" . get_class($fn[0]) . "', '{$fn[1]}'])"; + } + + return 'callable(' . spl_object_hash($fn) . ')'; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/MessageFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/MessageFormatter.php new file mode 100644 index 0000000..6b090a9 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/MessageFormatter.php @@ -0,0 +1,182 @@ +>>>>>>>\n{request}\n<<<<<<<<\n{response}\n--------\n{error}"; + const SHORT = '[{ts}] "{method} {target} HTTP/{version}" {code}'; + + /** @var string Template used to format log messages */ + private $template; + + /** + * @param string $template Log message template + */ + public function __construct($template = self::CLF) + { + $this->template = $template ?: self::CLF; + } + + /** + * Returns a formatted message string. + * + * @param RequestInterface $request Request that was sent + * @param ResponseInterface $response Response that was received + * @param \Exception $error Exception that was received + * + * @return string + */ + public function format( + RequestInterface $request, + ResponseInterface $response = null, + \Exception $error = null + ) { + $cache = []; + + return preg_replace_callback( + '/{\s*([A-Za-z_\-\.0-9]+)\s*}/', + function (array $matches) use ($request, $response, $error, &$cache) { + + if (isset($cache[$matches[1]])) { + return $cache[$matches[1]]; + } + + $result = ''; + switch ($matches[1]) { + case 'request': + $result = Psr7\str($request); + break; + case 'response': + $result = $response ? Psr7\str($response) : ''; + break; + case 'req_headers': + $result = trim($request->getMethod() + . ' ' . $request->getRequestTarget()) + . ' HTTP/' . $request->getProtocolVersion() . "\r\n" + . $this->headers($request); + break; + case 'res_headers': + $result = $response ? + sprintf( + 'HTTP/%s %d %s', + $response->getProtocolVersion(), + $response->getStatusCode(), + $response->getReasonPhrase() + ) . "\r\n" . $this->headers($response) + : 'NULL'; + break; + case 'req_body': + $result = $request->getBody(); + break; + case 'res_body': + $result = $response ? $response->getBody() : 'NULL'; + break; + case 'ts': + case 'date_iso_8601': + $result = gmdate('c'); + break; + case 'date_common_log': + $result = date('d/M/Y:H:i:s O'); + break; + case 'method': + $result = $request->getMethod(); + break; + case 'version': + $result = $request->getProtocolVersion(); + break; + case 'uri': + case 'url': + $result = $request->getUri(); + break; + case 'target': + $result = $request->getRequestTarget(); + break; + case 'req_version': + $result = $request->getProtocolVersion(); + break; + case 'res_version': + $result = $response + ? $response->getProtocolVersion() + : 'NULL'; + break; + case 'host': + $result = $request->getHeaderLine('Host'); + break; + case 'hostname': + $result = gethostname(); + break; + case 'code': + $result = $response ? $response->getStatusCode() : 'NULL'; + break; + case 'phrase': + $result = $response ? $response->getReasonPhrase() : 'NULL'; + break; + case 'error': + $result = $error ? $error->getMessage() : 'NULL'; + break; + default: + // handle prefixed dynamic headers + if (strpos($matches[1], 'req_header_') === 0) { + $result = $request->getHeaderLine(substr($matches[1], 11)); + } elseif (strpos($matches[1], 'res_header_') === 0) { + $result = $response + ? $response->getHeaderLine(substr($matches[1], 11)) + : 'NULL'; + } + } + + $cache[$matches[1]] = $result; + return $result; + }, + $this->template + ); + } + + private function headers(MessageInterface $message) + { + $result = ''; + foreach ($message->getHeaders() as $name => $values) { + $result .= $name . ': ' . implode(', ', $values) . "\r\n"; + } + + return trim($result); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Middleware.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Middleware.php new file mode 100644 index 0000000..9d79bd2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Middleware.php @@ -0,0 +1,254 @@ +withCookieHeader($request); + return $handler($request, $options) + ->then(function ($response) use ($cookieJar, $request) { + $cookieJar->extractCookies($request, $response); + return $response; + } + ); + }; + }; + } + + /** + * Middleware that throws exceptions for 4xx or 5xx responses when the + * "http_error" request option is set to true. + * + * @return callable Returns a function that accepts the next handler. + */ + public static function httpErrors() + { + return function (callable $handler) { + return function ($request, array $options) use ($handler) { + if (empty($options['http_errors'])) { + return $handler($request, $options); + } + return $handler($request, $options)->then( + function (ResponseInterface $response) use ($request, $handler) { + $code = $response->getStatusCode(); + if ($code < 400) { + return $response; + } + throw RequestException::create($request, $response); + } + ); + }; + }; + } + + /** + * Middleware that pushes history data to an ArrayAccess container. + * + * @param array $container Container to hold the history (by reference). + * + * @return callable Returns a function that accepts the next handler. + * @throws \InvalidArgumentException if container is not an array or ArrayAccess. + */ + public static function history(&$container) + { + if (!is_array($container) && !$container instanceof \ArrayAccess) { + throw new \InvalidArgumentException('history container must be an array or object implementing ArrayAccess'); + } + + return function (callable $handler) use (&$container) { + return function ($request, array $options) use ($handler, &$container) { + return $handler($request, $options)->then( + function ($value) use ($request, &$container, $options) { + $container[] = [ + 'request' => $request, + 'response' => $value, + 'error' => null, + 'options' => $options + ]; + return $value; + }, + function ($reason) use ($request, &$container, $options) { + $container[] = [ + 'request' => $request, + 'response' => null, + 'error' => $reason, + 'options' => $options + ]; + return \GuzzleHttp\Promise\rejection_for($reason); + } + ); + }; + }; + } + + /** + * Middleware that invokes a callback before and after sending a request. + * + * The provided listener cannot modify or alter the response. It simply + * "taps" into the chain to be notified before returning the promise. The + * before listener accepts a request and options array, and the after + * listener accepts a request, options array, and response promise. + * + * @param callable $before Function to invoke before forwarding the request. + * @param callable $after Function invoked after forwarding. + * + * @return callable Returns a function that accepts the next handler. + */ + public static function tap(callable $before = null, callable $after = null) + { + return function (callable $handler) use ($before, $after) { + return function ($request, array $options) use ($handler, $before, $after) { + if ($before) { + $before($request, $options); + } + $response = $handler($request, $options); + if ($after) { + $after($request, $options, $response); + } + return $response; + }; + }; + } + + /** + * Middleware that handles request redirects. + * + * @return callable Returns a function that accepts the next handler. + */ + public static function redirect() + { + return function (callable $handler) { + return new RedirectMiddleware($handler); + }; + } + + /** + * Middleware that retries requests based on the boolean result of + * invoking the provided "decider" function. + * + * If no delay function is provided, a simple implementation of exponential + * backoff will be utilized. + * + * @param callable $decider Function that accepts the number of retries, + * a request, [response], and [exception] and + * returns true if the request is to be retried. + * @param callable $delay Function that accepts the number of retries and + * returns the number of milliseconds to delay. + * + * @return callable Returns a function that accepts the next handler. + */ + public static function retry(callable $decider, callable $delay = null) + { + return function (callable $handler) use ($decider, $delay) { + return new RetryMiddleware($decider, $handler, $delay); + }; + } + + /** + * Middleware that logs requests, responses, and errors using a message + * formatter. + * + * @param LoggerInterface $logger Logs messages. + * @param MessageFormatter $formatter Formatter used to create message strings. + * @param string $logLevel Level at which to log requests. + * + * @return callable Returns a function that accepts the next handler. + */ + public static function log(LoggerInterface $logger, MessageFormatter $formatter, $logLevel = LogLevel::INFO) + { + return function (callable $handler) use ($logger, $formatter, $logLevel) { + return function ($request, array $options) use ($handler, $logger, $formatter, $logLevel) { + return $handler($request, $options)->then( + function ($response) use ($logger, $request, $formatter, $logLevel) { + $message = $formatter->format($request, $response); + $logger->log($logLevel, $message); + return $response; + }, + function ($reason) use ($logger, $request, $formatter) { + $response = $reason instanceof RequestException + ? $reason->getResponse() + : null; + $message = $formatter->format($request, $response, $reason); + $logger->notice($message); + return \GuzzleHttp\Promise\rejection_for($reason); + } + ); + }; + }; + } + + /** + * This middleware adds a default content-type if possible, a default + * content-length or transfer-encoding header, and the expect header. + * + * @return callable + */ + public static function prepareBody() + { + return function (callable $handler) { + return new PrepareBodyMiddleware($handler); + }; + } + + /** + * Middleware that applies a map function to the request before passing to + * the next handler. + * + * @param callable $fn Function that accepts a RequestInterface and returns + * a RequestInterface. + * @return callable + */ + public static function mapRequest(callable $fn) + { + return function (callable $handler) use ($fn) { + return function ($request, array $options) use ($handler, $fn) { + return $handler($fn($request), $options); + }; + }; + } + + /** + * Middleware that applies a map function to the resolved promise's + * response. + * + * @param callable $fn Function that accepts a ResponseInterface and + * returns a ResponseInterface. + * @return callable + */ + public static function mapResponse(callable $fn) + { + return function (callable $handler) use ($fn) { + return function ($request, array $options) use ($handler, $fn) { + return $handler($request, $options)->then($fn); + }; + }; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Pool.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Pool.php new file mode 100644 index 0000000..8f1be33 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/Pool.php @@ -0,0 +1,123 @@ + $rfn) { + if ($rfn instanceof RequestInterface) { + yield $key => $client->sendAsync($rfn, $opts); + } elseif (is_callable($rfn)) { + yield $key => $rfn($opts); + } else { + throw new \InvalidArgumentException('Each value yielded by ' + . 'the iterator must be a Psr7\Http\Message\RequestInterface ' + . 'or a callable that returns a promise that fulfills ' + . 'with a Psr7\Message\Http\ResponseInterface object.'); + } + } + }; + + $this->each = new EachPromise($requests(), $config); + } + + public function promise() + { + return $this->each->promise(); + } + + /** + * Sends multiple requests concurrently and returns an array of responses + * and exceptions that uses the same ordering as the provided requests. + * + * IMPORTANT: This method keeps every request and response in memory, and + * as such, is NOT recommended when sending a large number or an + * indeterminate number of requests concurrently. + * + * @param ClientInterface $client Client used to send the requests + * @param array|\Iterator $requests Requests to send concurrently. + * @param array $options Passes through the options available in + * {@see GuzzleHttp\Pool::__construct} + * + * @return array Returns an array containing the response or an exception + * in the same order that the requests were sent. + * @throws \InvalidArgumentException if the event format is incorrect. + */ + public static function batch( + ClientInterface $client, + $requests, + array $options = [] + ) { + $res = []; + self::cmpCallback($options, 'fulfilled', $res); + self::cmpCallback($options, 'rejected', $res); + $pool = new static($client, $requests, $options); + $pool->promise()->wait(); + ksort($res); + + return $res; + } + + private static function cmpCallback(array &$options, $name, array &$results) + { + if (!isset($options[$name])) { + $options[$name] = function ($v, $k) use (&$results) { + $results[$k] = $v; + }; + } else { + $currentFn = $options[$name]; + $options[$name] = function ($v, $k) use (&$results, $currentFn) { + $currentFn($v, $k); + $results[$k] = $v; + }; + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/PrepareBodyMiddleware.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/PrepareBodyMiddleware.php new file mode 100644 index 0000000..2eb95f9 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/PrepareBodyMiddleware.php @@ -0,0 +1,106 @@ +nextHandler = $nextHandler; + } + + /** + * @param RequestInterface $request + * @param array $options + * + * @return PromiseInterface + */ + public function __invoke(RequestInterface $request, array $options) + { + $fn = $this->nextHandler; + + // Don't do anything if the request has no body. + if ($request->getBody()->getSize() === 0) { + return $fn($request, $options); + } + + $modify = []; + + // Add a default content-type if possible. + if (!$request->hasHeader('Content-Type')) { + if ($uri = $request->getBody()->getMetadata('uri')) { + if ($type = Psr7\mimetype_from_filename($uri)) { + $modify['set_headers']['Content-Type'] = $type; + } + } + } + + // Add a default content-length or transfer-encoding header. + if (!$request->hasHeader('Content-Length') + && !$request->hasHeader('Transfer-Encoding') + ) { + $size = $request->getBody()->getSize(); + if ($size !== null) { + $modify['set_headers']['Content-Length'] = $size; + } else { + $modify['set_headers']['Transfer-Encoding'] = 'chunked'; + } + } + + // Add the expect header if needed. + $this->addExpectHeader($request, $options, $modify); + + return $fn(Psr7\modify_request($request, $modify), $options); + } + + private function addExpectHeader( + RequestInterface $request, + array $options, + array &$modify + ) { + // Determine if the Expect header should be used + if ($request->hasHeader('Expect')) { + return; + } + + $expect = isset($options['expect']) ? $options['expect'] : null; + + // Return if disabled or if you're not using HTTP/1.1 or HTTP/2.0 + if ($expect === false || $request->getProtocolVersion() < 1.1) { + return; + } + + // The expect header is unconditionally enabled + if ($expect === true) { + $modify['set_headers']['Expect'] = '100-Continue'; + return; + } + + // By default, send the expect header when the payload is > 1mb + if ($expect === null) { + $expect = 1048576; + } + + // Always add if the body cannot be rewound, the size cannot be + // determined, or the size is greater than the cutoff threshold + $body = $request->getBody(); + $size = $body->getSize(); + + if ($size === null || $size >= (int) $expect || !$body->isSeekable()) { + $modify['set_headers']['Expect'] = '100-Continue'; + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RedirectMiddleware.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RedirectMiddleware.php new file mode 100644 index 0000000..131b771 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RedirectMiddleware.php @@ -0,0 +1,237 @@ + 5, + 'protocols' => ['http', 'https'], + 'strict' => false, + 'referer' => false, + 'track_redirects' => false, + ]; + + /** @var callable */ + private $nextHandler; + + /** + * @param callable $nextHandler Next handler to invoke. + */ + public function __construct(callable $nextHandler) + { + $this->nextHandler = $nextHandler; + } + + /** + * @param RequestInterface $request + * @param array $options + * + * @return PromiseInterface + */ + public function __invoke(RequestInterface $request, array $options) + { + $fn = $this->nextHandler; + + if (empty($options['allow_redirects'])) { + return $fn($request, $options); + } + + if ($options['allow_redirects'] === true) { + $options['allow_redirects'] = self::$defaultSettings; + } elseif (!is_array($options['allow_redirects'])) { + throw new \InvalidArgumentException('allow_redirects must be true, false, or array'); + } else { + // Merge the default settings with the provided settings + $options['allow_redirects'] += self::$defaultSettings; + } + + if (empty($options['allow_redirects']['max'])) { + return $fn($request, $options); + } + + return $fn($request, $options) + ->then(function (ResponseInterface $response) use ($request, $options) { + return $this->checkRedirect($request, $options, $response); + }); + } + + /** + * @param RequestInterface $request + * @param array $options + * @param ResponseInterface|PromiseInterface $response + * + * @return ResponseInterface|PromiseInterface + */ + public function checkRedirect( + RequestInterface $request, + array $options, + ResponseInterface $response + ) { + if (substr($response->getStatusCode(), 0, 1) != '3' + || !$response->hasHeader('Location') + ) { + return $response; + } + + $this->guardMax($request, $options); + $nextRequest = $this->modifyRequest($request, $options, $response); + + if (isset($options['allow_redirects']['on_redirect'])) { + call_user_func( + $options['allow_redirects']['on_redirect'], + $request, + $response, + $nextRequest->getUri() + ); + } + + /** @var PromiseInterface|ResponseInterface $promise */ + $promise = $this($nextRequest, $options); + + // Add headers to be able to track history of redirects. + if (!empty($options['allow_redirects']['track_redirects'])) { + return $this->withTracking( + $promise, + (string) $nextRequest->getUri(), + $response->getStatusCode() + ); + } + + return $promise; + } + + private function withTracking(PromiseInterface $promise, $uri, $statusCode) + { + return $promise->then( + function (ResponseInterface $response) use ($uri, $statusCode) { + // Note that we are pushing to the front of the list as this + // would be an earlier response than what is currently present + // in the history header. + $historyHeader = $response->getHeader(self::HISTORY_HEADER); + $statusHeader = $response->getHeader(self::STATUS_HISTORY_HEADER); + array_unshift($historyHeader, $uri); + array_unshift($statusHeader, $statusCode); + return $response->withHeader(self::HISTORY_HEADER, $historyHeader) + ->withHeader(self::STATUS_HISTORY_HEADER, $statusHeader); + } + ); + } + + private function guardMax(RequestInterface $request, array &$options) + { + $current = isset($options['__redirect_count']) + ? $options['__redirect_count'] + : 0; + $options['__redirect_count'] = $current + 1; + $max = $options['allow_redirects']['max']; + + if ($options['__redirect_count'] > $max) { + throw new TooManyRedirectsException( + "Will not follow more than {$max} redirects", + $request + ); + } + } + + /** + * @param RequestInterface $request + * @param array $options + * @param ResponseInterface $response + * + * @return RequestInterface + */ + public function modifyRequest( + RequestInterface $request, + array $options, + ResponseInterface $response + ) { + // Request modifications to apply. + $modify = []; + $protocols = $options['allow_redirects']['protocols']; + + // Use a GET request if this is an entity enclosing request and we are + // not forcing RFC compliance, but rather emulating what all browsers + // would do. + $statusCode = $response->getStatusCode(); + if ($statusCode == 303 || + ($statusCode <= 302 && $request->getBody() && !$options['allow_redirects']['strict']) + ) { + $modify['method'] = 'GET'; + $modify['body'] = ''; + } + + $modify['uri'] = $this->redirectUri($request, $response, $protocols); + Psr7\rewind_body($request); + + // Add the Referer header if it is told to do so and only + // add the header if we are not redirecting from https to http. + if ($options['allow_redirects']['referer'] + && $modify['uri']->getScheme() === $request->getUri()->getScheme() + ) { + $uri = $request->getUri()->withUserInfo('', ''); + $modify['set_headers']['Referer'] = (string) $uri; + } else { + $modify['remove_headers'][] = 'Referer'; + } + + // Remove Authorization header if host is different. + if ($request->getUri()->getHost() !== $modify['uri']->getHost()) { + $modify['remove_headers'][] = 'Authorization'; + } + + return Psr7\modify_request($request, $modify); + } + + /** + * Set the appropriate URL on the request based on the location header + * + * @param RequestInterface $request + * @param ResponseInterface $response + * @param array $protocols + * + * @return UriInterface + */ + private function redirectUri( + RequestInterface $request, + ResponseInterface $response, + array $protocols + ) { + $location = Psr7\UriResolver::resolve( + $request->getUri(), + new Psr7\Uri($response->getHeaderLine('Location')) + ); + + // Ensure that the redirect URI is allowed based on the protocols. + if (!in_array($location->getScheme(), $protocols)) { + throw new BadResponseException( + sprintf( + 'Redirect URI, %s, does not use one of the allowed redirect protocols: %s', + $location, + implode(', ', $protocols) + ), + $request, + $response + ); + } + + return $location; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RequestOptions.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RequestOptions.php new file mode 100644 index 0000000..c6aacfb --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/RequestOptions.php @@ -0,0 +1,255 @@ +decider = $decider; + $this->nextHandler = $nextHandler; + $this->delay = $delay ?: __CLASS__ . '::exponentialDelay'; + } + + /** + * Default exponential backoff delay function. + * + * @param $retries + * + * @return int + */ + public static function exponentialDelay($retries) + { + return (int) pow(2, $retries - 1); + } + + /** + * @param RequestInterface $request + * @param array $options + * + * @return PromiseInterface + */ + public function __invoke(RequestInterface $request, array $options) + { + if (!isset($options['retries'])) { + $options['retries'] = 0; + } + + $fn = $this->nextHandler; + return $fn($request, $options) + ->then( + $this->onFulfilled($request, $options), + $this->onRejected($request, $options) + ); + } + + private function onFulfilled(RequestInterface $req, array $options) + { + return function ($value) use ($req, $options) { + if (!call_user_func( + $this->decider, + $options['retries'], + $req, + $value, + null + )) { + return $value; + } + return $this->doRetry($req, $options, $value); + }; + } + + private function onRejected(RequestInterface $req, array $options) + { + return function ($reason) use ($req, $options) { + if (!call_user_func( + $this->decider, + $options['retries'], + $req, + null, + $reason + )) { + return \GuzzleHttp\Promise\rejection_for($reason); + } + return $this->doRetry($req, $options); + }; + } + + private function doRetry(RequestInterface $request, array $options, ResponseInterface $response = null) + { + $options['delay'] = call_user_func($this->delay, ++$options['retries'], $response); + + return $this($request, $options); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/TransferStats.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/TransferStats.php new file mode 100644 index 0000000..15f717e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/TransferStats.php @@ -0,0 +1,126 @@ +request = $request; + $this->response = $response; + $this->transferTime = $transferTime; + $this->handlerErrorData = $handlerErrorData; + $this->handlerStats = $handlerStats; + } + + /** + * @return RequestInterface + */ + public function getRequest() + { + return $this->request; + } + + /** + * Returns the response that was received (if any). + * + * @return ResponseInterface|null + */ + public function getResponse() + { + return $this->response; + } + + /** + * Returns true if a response was received. + * + * @return bool + */ + public function hasResponse() + { + return $this->response !== null; + } + + /** + * Gets handler specific error data. + * + * This might be an exception, a integer representing an error code, or + * anything else. Relying on this value assumes that you know what handler + * you are using. + * + * @return mixed + */ + public function getHandlerErrorData() + { + return $this->handlerErrorData; + } + + /** + * Get the effective URI the request was sent to. + * + * @return UriInterface + */ + public function getEffectiveUri() + { + return $this->request->getUri(); + } + + /** + * Get the estimated time the request was being transferred by the handler. + * + * @return float Time in seconds. + */ + public function getTransferTime() + { + return $this->transferTime; + } + + /** + * Gets an array of all of the handler specific transfer data. + * + * @return array + */ + public function getHandlerStats() + { + return $this->handlerStats; + } + + /** + * Get a specific handler statistic from the handler by name. + * + * @param string $stat Handler specific transfer stat to retrieve. + * + * @return mixed|null + */ + public function getHandlerStat($stat) + { + return isset($this->handlerStats[$stat]) + ? $this->handlerStats[$stat] + : null; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/UriTemplate.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/UriTemplate.php new file mode 100644 index 0000000..0b1623e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/UriTemplate.php @@ -0,0 +1,241 @@ + ['prefix' => '', 'joiner' => ',', 'query' => false], + '+' => ['prefix' => '', 'joiner' => ',', 'query' => false], + '#' => ['prefix' => '#', 'joiner' => ',', 'query' => false], + '.' => ['prefix' => '.', 'joiner' => '.', 'query' => false], + '/' => ['prefix' => '/', 'joiner' => '/', 'query' => false], + ';' => ['prefix' => ';', 'joiner' => ';', 'query' => true], + '?' => ['prefix' => '?', 'joiner' => '&', 'query' => true], + '&' => ['prefix' => '&', 'joiner' => '&', 'query' => true] + ]; + + /** @var array Delimiters */ + private static $delims = [':', '/', '?', '#', '[', ']', '@', '!', '$', + '&', '\'', '(', ')', '*', '+', ',', ';', '=']; + + /** @var array Percent encoded delimiters */ + private static $delimsPct = ['%3A', '%2F', '%3F', '%23', '%5B', '%5D', + '%40', '%21', '%24', '%26', '%27', '%28', '%29', '%2A', '%2B', '%2C', + '%3B', '%3D']; + + public function expand($template, array $variables) + { + if (false === strpos($template, '{')) { + return $template; + } + + $this->template = $template; + $this->variables = $variables; + + return preg_replace_callback( + '/\{([^\}]+)\}/', + [$this, 'expandMatch'], + $this->template + ); + } + + /** + * Parse an expression into parts + * + * @param string $expression Expression to parse + * + * @return array Returns an associative array of parts + */ + private function parseExpression($expression) + { + $result = []; + + if (isset(self::$operatorHash[$expression[0]])) { + $result['operator'] = $expression[0]; + $expression = substr($expression, 1); + } else { + $result['operator'] = ''; + } + + foreach (explode(',', $expression) as $value) { + $value = trim($value); + $varspec = []; + if ($colonPos = strpos($value, ':')) { + $varspec['value'] = substr($value, 0, $colonPos); + $varspec['modifier'] = ':'; + $varspec['position'] = (int) substr($value, $colonPos + 1); + } elseif (substr($value, -1) === '*') { + $varspec['modifier'] = '*'; + $varspec['value'] = substr($value, 0, -1); + } else { + $varspec['value'] = (string) $value; + $varspec['modifier'] = ''; + } + $result['values'][] = $varspec; + } + + return $result; + } + + /** + * Process an expansion + * + * @param array $matches Matches met in the preg_replace_callback + * + * @return string Returns the replacement string + */ + private function expandMatch(array $matches) + { + static $rfc1738to3986 = ['+' => '%20', '%7e' => '~']; + + $replacements = []; + $parsed = self::parseExpression($matches[1]); + $prefix = self::$operatorHash[$parsed['operator']]['prefix']; + $joiner = self::$operatorHash[$parsed['operator']]['joiner']; + $useQuery = self::$operatorHash[$parsed['operator']]['query']; + + foreach ($parsed['values'] as $value) { + + if (!isset($this->variables[$value['value']])) { + continue; + } + + $variable = $this->variables[$value['value']]; + $actuallyUseQuery = $useQuery; + $expanded = ''; + + if (is_array($variable)) { + + $isAssoc = $this->isAssoc($variable); + $kvp = []; + foreach ($variable as $key => $var) { + + if ($isAssoc) { + $key = rawurlencode($key); + $isNestedArray = is_array($var); + } else { + $isNestedArray = false; + } + + if (!$isNestedArray) { + $var = rawurlencode($var); + if ($parsed['operator'] === '+' || + $parsed['operator'] === '#' + ) { + $var = $this->decodeReserved($var); + } + } + + if ($value['modifier'] === '*') { + if ($isAssoc) { + if ($isNestedArray) { + // Nested arrays must allow for deeply nested + // structures. + $var = strtr( + http_build_query([$key => $var]), + $rfc1738to3986 + ); + } else { + $var = $key . '=' . $var; + } + } elseif ($key > 0 && $actuallyUseQuery) { + $var = $value['value'] . '=' . $var; + } + } + + $kvp[$key] = $var; + } + + if (empty($variable)) { + $actuallyUseQuery = false; + } elseif ($value['modifier'] === '*') { + $expanded = implode($joiner, $kvp); + if ($isAssoc) { + // Don't prepend the value name when using the explode + // modifier with an associative array. + $actuallyUseQuery = false; + } + } else { + if ($isAssoc) { + // When an associative array is encountered and the + // explode modifier is not set, then the result must be + // a comma separated list of keys followed by their + // respective values. + foreach ($kvp as $k => &$v) { + $v = $k . ',' . $v; + } + } + $expanded = implode(',', $kvp); + } + + } else { + if ($value['modifier'] === ':') { + $variable = substr($variable, 0, $value['position']); + } + $expanded = rawurlencode($variable); + if ($parsed['operator'] === '+' || $parsed['operator'] === '#') { + $expanded = $this->decodeReserved($expanded); + } + } + + if ($actuallyUseQuery) { + if (!$expanded && $joiner !== '&') { + $expanded = $value['value']; + } else { + $expanded = $value['value'] . '=' . $expanded; + } + } + + $replacements[] = $expanded; + } + + $ret = implode($joiner, $replacements); + if ($ret && $prefix) { + return $prefix . $ret; + } + + return $ret; + } + + /** + * Determines if an array is associative. + * + * This makes the assumption that input arrays are sequences or hashes. + * This assumption is a tradeoff for accuracy in favor of speed, but it + * should work in almost every case where input is supplied for a URI + * template. + * + * @param array $array Array to check + * + * @return bool + */ + private function isAssoc(array $array) + { + return $array && array_keys($array)[0] !== 0; + } + + /** + * Removes percent encoding on reserved characters (used with + and # + * modifiers). + * + * @param string $string String to fix + * + * @return string + */ + private function decodeReserved($string) + { + return str_replace(self::$delimsPct, self::$delims, $string); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/functions.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/functions.php new file mode 100644 index 0000000..59e212e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/functions.php @@ -0,0 +1,331 @@ +expand($template, $variables); +} + +/** + * Debug function used to describe the provided value type and class. + * + * @param mixed $input + * + * @return string Returns a string containing the type of the variable and + * if a class is provided, the class name. + */ +function describe_type($input) +{ + switch (gettype($input)) { + case 'object': + return 'object(' . get_class($input) . ')'; + case 'array': + return 'array(' . count($input) . ')'; + default: + ob_start(); + var_dump($input); + // normalize float vs double + return str_replace('double(', 'float(', rtrim(ob_get_clean())); + } +} + +/** + * Parses an array of header lines into an associative array of headers. + * + * @param array $lines Header lines array of strings in the following + * format: "Name: Value" + * @return array + */ +function headers_from_lines($lines) +{ + $headers = []; + + foreach ($lines as $line) { + $parts = explode(':', $line, 2); + $headers[trim($parts[0])][] = isset($parts[1]) + ? trim($parts[1]) + : null; + } + + return $headers; +} + +/** + * Returns a debug stream based on the provided variable. + * + * @param mixed $value Optional value + * + * @return resource + */ +function debug_resource($value = null) +{ + if (is_resource($value)) { + return $value; + } elseif (defined('STDOUT')) { + return STDOUT; + } + + return fopen('php://output', 'w'); +} + +/** + * Chooses and creates a default handler to use based on the environment. + * + * The returned handler is not wrapped by any default middlewares. + * + * @throws \RuntimeException if no viable Handler is available. + * @return callable Returns the best handler for the given system. + */ +function choose_handler() +{ + $handler = null; + if (function_exists('curl_multi_exec') && function_exists('curl_exec')) { + $handler = Proxy::wrapSync(new CurlMultiHandler(), new CurlHandler()); + } elseif (function_exists('curl_exec')) { + $handler = new CurlHandler(); + } elseif (function_exists('curl_multi_exec')) { + $handler = new CurlMultiHandler(); + } + + if (ini_get('allow_url_fopen')) { + $handler = $handler + ? Proxy::wrapStreaming($handler, new StreamHandler()) + : new StreamHandler(); + } elseif (!$handler) { + throw new \RuntimeException('GuzzleHttp requires cURL, the ' + . 'allow_url_fopen ini setting, or a custom HTTP handler.'); + } + + return $handler; +} + +/** + * Get the default User-Agent string to use with Guzzle + * + * @return string + */ +function default_user_agent() +{ + static $defaultAgent = ''; + + if (!$defaultAgent) { + $defaultAgent = 'GuzzleHttp/' . Client::VERSION; + if (extension_loaded('curl') && function_exists('curl_version')) { + $defaultAgent .= ' curl/' . \curl_version()['version']; + } + $defaultAgent .= ' PHP/' . PHP_VERSION; + } + + return $defaultAgent; +} + +/** + * Returns the default cacert bundle for the current system. + * + * First, the openssl.cafile and curl.cainfo php.ini settings are checked. + * If those settings are not configured, then the common locations for + * bundles found on Red Hat, CentOS, Fedora, Ubuntu, Debian, FreeBSD, OS X + * and Windows are checked. If any of these file locations are found on + * disk, they will be utilized. + * + * Note: the result of this function is cached for subsequent calls. + * + * @return string + * @throws \RuntimeException if no bundle can be found. + */ +function default_ca_bundle() +{ + static $cached = null; + static $cafiles = [ + // Red Hat, CentOS, Fedora (provided by the ca-certificates package) + '/etc/pki/tls/certs/ca-bundle.crt', + // Ubuntu, Debian (provided by the ca-certificates package) + '/etc/ssl/certs/ca-certificates.crt', + // FreeBSD (provided by the ca_root_nss package) + '/usr/local/share/certs/ca-root-nss.crt', + // SLES 12 (provided by the ca-certificates package) + '/var/lib/ca-certificates/ca-bundle.pem', + // OS X provided by homebrew (using the default path) + '/usr/local/etc/openssl/cert.pem', + // Google app engine + '/etc/ca-certificates.crt', + // Windows? + 'C:\\windows\\system32\\curl-ca-bundle.crt', + 'C:\\windows\\curl-ca-bundle.crt', + ]; + + if ($cached) { + return $cached; + } + + if ($ca = ini_get('openssl.cafile')) { + return $cached = $ca; + } + + if ($ca = ini_get('curl.cainfo')) { + return $cached = $ca; + } + + foreach ($cafiles as $filename) { + if (file_exists($filename)) { + return $cached = $filename; + } + } + + throw new \RuntimeException(<<< EOT +No system CA bundle could be found in any of the the common system locations. +PHP versions earlier than 5.6 are not properly configured to use the system's +CA bundle by default. In order to verify peer certificates, you will need to +supply the path on disk to a certificate bundle to the 'verify' request +option: http://docs.guzzlephp.org/en/latest/clients.html#verify. If you do not +need a specific certificate bundle, then Mozilla provides a commonly used CA +bundle which can be downloaded here (provided by the maintainer of cURL): +https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt. Once +you have a CA bundle available on disk, you can set the 'openssl.cafile' PHP +ini setting to point to the path to the file, allowing you to omit the 'verify' +request option. See http://curl.haxx.se/docs/sslcerts.html for more +information. +EOT + ); +} + +/** + * Creates an associative array of lowercase header names to the actual + * header casing. + * + * @param array $headers + * + * @return array + */ +function normalize_header_keys(array $headers) +{ + $result = []; + foreach (array_keys($headers) as $key) { + $result[strtolower($key)] = $key; + } + + return $result; +} + +/** + * Returns true if the provided host matches any of the no proxy areas. + * + * This method will strip a port from the host if it is present. Each pattern + * can be matched with an exact match (e.g., "foo.com" == "foo.com") or a + * partial match: (e.g., "foo.com" == "baz.foo.com" and ".foo.com" == + * "baz.foo.com", but ".foo.com" != "foo.com"). + * + * Areas are matched in the following cases: + * 1. "*" (without quotes) always matches any hosts. + * 2. An exact match. + * 3. The area starts with "." and the area is the last part of the host. e.g. + * '.mit.edu' will match any host that ends with '.mit.edu'. + * + * @param string $host Host to check against the patterns. + * @param array $noProxyArray An array of host patterns. + * + * @return bool + */ +function is_host_in_noproxy($host, array $noProxyArray) +{ + if (strlen($host) === 0) { + throw new \InvalidArgumentException('Empty host provided'); + } + + // Strip port if present. + if (strpos($host, ':')) { + $host = explode($host, ':', 2)[0]; + } + + foreach ($noProxyArray as $area) { + // Always match on wildcards. + if ($area === '*') { + return true; + } elseif (empty($area)) { + // Don't match on empty values. + continue; + } elseif ($area === $host) { + // Exact matches. + return true; + } else { + // Special match if the area when prefixed with ".". Remove any + // existing leading "." and add a new leading ".". + $area = '.' . ltrim($area, '.'); + if (substr($host, -(strlen($area))) === $area) { + return true; + } + } + } + + return false; +} + +/** + * Wrapper for json_decode that throws when an error occurs. + * + * @param string $json JSON data to parse + * @param bool $assoc When true, returned objects will be converted + * into associative arrays. + * @param int $depth User specified recursion depth. + * @param int $options Bitmask of JSON decode options. + * + * @return mixed + * @throws \InvalidArgumentException if the JSON cannot be decoded. + * @link http://www.php.net/manual/en/function.json-decode.php + */ +function json_decode($json, $assoc = false, $depth = 512, $options = 0) +{ + $data = \json_decode($json, $assoc, $depth, $options); + if (JSON_ERROR_NONE !== json_last_error()) { + throw new \InvalidArgumentException( + 'json_decode error: ' . json_last_error_msg()); + } + + return $data; +} + +/** + * Wrapper for JSON encoding that throws when an error occurs. + * + * @param mixed $value The value being encoded + * @param int $options JSON encode option bitmask + * @param int $depth Set the maximum depth. Must be greater than zero. + * + * @return string + * @throws \InvalidArgumentException if the JSON cannot be encoded. + * @link http://www.php.net/manual/en/function.json-encode.php + */ +function json_encode($value, $options = 0, $depth = 512) +{ + $json = \json_encode($value, $options, $depth); + if (JSON_ERROR_NONE !== json_last_error()) { + throw new \InvalidArgumentException( + 'json_encode error: ' . json_last_error_msg()); + } + + return $json; +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/functions_include.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/functions_include.php new file mode 100644 index 0000000..a93393a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/guzzle/src/functions_include.php @@ -0,0 +1,6 @@ + + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/Makefile b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/Makefile new file mode 100644 index 0000000..8d5b3ef --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/Makefile @@ -0,0 +1,13 @@ +all: clean test + +test: + vendor/bin/phpunit + +coverage: + vendor/bin/phpunit --coverage-html=artifacts/coverage + +view-coverage: + open artifacts/coverage/index.html + +clean: + rm -rf artifacts/* diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/README.md b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/README.md new file mode 100644 index 0000000..7b607e2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/README.md @@ -0,0 +1,504 @@ +# Guzzle Promises + +[Promises/A+](https://promisesaplus.com/) implementation that handles promise +chaining and resolution iteratively, allowing for "infinite" promise chaining +while keeping the stack size constant. Read [this blog post](https://blog.domenic.me/youre-missing-the-point-of-promises/) +for a general introduction to promises. + +- [Features](#features) +- [Quick start](#quick-start) +- [Synchronous wait](#synchronous-wait) +- [Cancellation](#cancellation) +- [API](#api) + - [Promise](#promise) + - [FulfilledPromise](#fulfilledpromise) + - [RejectedPromise](#rejectedpromise) +- [Promise interop](#promise-interop) +- [Implementation notes](#implementation-notes) + + +# Features + +- [Promises/A+](https://promisesaplus.com/) implementation. +- Promise resolution and chaining is handled iteratively, allowing for + "infinite" promise chaining. +- Promises have a synchronous `wait` method. +- Promises can be cancelled. +- Works with any object that has a `then` function. +- C# style async/await coroutine promises using + `GuzzleHttp\Promise\coroutine()`. + + +# Quick start + +A *promise* represents the eventual result of an asynchronous operation. The +primary way of interacting with a promise is through its `then` method, which +registers callbacks to receive either a promise's eventual value or the reason +why the promise cannot be fulfilled. + + +## Callbacks + +Callbacks are registered with the `then` method by providing an optional +`$onFulfilled` followed by an optional `$onRejected` function. + + +```php +use GuzzleHttp\Promise\Promise; + +$promise = new Promise(); +$promise->then( + // $onFulfilled + function ($value) { + echo 'The promise was fulfilled.'; + }, + // $onRejected + function ($reason) { + echo 'The promise was rejected.'; + } +); +``` + +*Resolving* a promise means that you either fulfill a promise with a *value* or +reject a promise with a *reason*. Resolving a promises triggers callbacks +registered with the promises's `then` method. These callbacks are triggered +only once and in the order in which they were added. + + +## Resolving a promise + +Promises are fulfilled using the `resolve($value)` method. Resolving a promise +with any value other than a `GuzzleHttp\Promise\RejectedPromise` will trigger +all of the onFulfilled callbacks (resolving a promise with a rejected promise +will reject the promise and trigger the `$onRejected` callbacks). + +```php +use GuzzleHttp\Promise\Promise; + +$promise = new Promise(); +$promise + ->then(function ($value) { + // Return a value and don't break the chain + return "Hello, " . $value; + }) + // This then is executed after the first then and receives the value + // returned from the first then. + ->then(function ($value) { + echo $value; + }); + +// Resolving the promise triggers the $onFulfilled callbacks and outputs +// "Hello, reader". +$promise->resolve('reader.'); +``` + + +## Promise forwarding + +Promises can be chained one after the other. Each then in the chain is a new +promise. The return value of a promise is what's forwarded to the next +promise in the chain. Returning a promise in a `then` callback will cause the +subsequent promises in the chain to only be fulfilled when the returned promise +has been fulfilled. The next promise in the chain will be invoked with the +resolved value of the promise. + +```php +use GuzzleHttp\Promise\Promise; + +$promise = new Promise(); +$nextPromise = new Promise(); + +$promise + ->then(function ($value) use ($nextPromise) { + echo $value; + return $nextPromise; + }) + ->then(function ($value) { + echo $value; + }); + +// Triggers the first callback and outputs "A" +$promise->resolve('A'); +// Triggers the second callback and outputs "B" +$nextPromise->resolve('B'); +``` + +## Promise rejection + +When a promise is rejected, the `$onRejected` callbacks are invoked with the +rejection reason. + +```php +use GuzzleHttp\Promise\Promise; + +$promise = new Promise(); +$promise->then(null, function ($reason) { + echo $reason; +}); + +$promise->reject('Error!'); +// Outputs "Error!" +``` + +## Rejection forwarding + +If an exception is thrown in an `$onRejected` callback, subsequent +`$onRejected` callbacks are invoked with the thrown exception as the reason. + +```php +use GuzzleHttp\Promise\Promise; + +$promise = new Promise(); +$promise->then(null, function ($reason) { + throw new \Exception($reason); +})->then(null, function ($reason) { + assert($reason->getMessage() === 'Error!'); +}); + +$promise->reject('Error!'); +``` + +You can also forward a rejection down the promise chain by returning a +`GuzzleHttp\Promise\RejectedPromise` in either an `$onFulfilled` or +`$onRejected` callback. + +```php +use GuzzleHttp\Promise\Promise; +use GuzzleHttp\Promise\RejectedPromise; + +$promise = new Promise(); +$promise->then(null, function ($reason) { + return new RejectedPromise($reason); +})->then(null, function ($reason) { + assert($reason === 'Error!'); +}); + +$promise->reject('Error!'); +``` + +If an exception is not thrown in a `$onRejected` callback and the callback +does not return a rejected promise, downstream `$onFulfilled` callbacks are +invoked using the value returned from the `$onRejected` callback. + +```php +use GuzzleHttp\Promise\Promise; +use GuzzleHttp\Promise\RejectedPromise; + +$promise = new Promise(); +$promise + ->then(null, function ($reason) { + return "It's ok"; + }) + ->then(function ($value) { + assert($value === "It's ok"); + }); + +$promise->reject('Error!'); +``` + +# Synchronous wait + +You can synchronously force promises to complete using a promise's `wait` +method. When creating a promise, you can provide a wait function that is used +to synchronously force a promise to complete. When a wait function is invoked +it is expected to deliver a value to the promise or reject the promise. If the +wait function does not deliver a value, then an exception is thrown. The wait +function provided to a promise constructor is invoked when the `wait` function +of the promise is called. + +```php +$promise = new Promise(function () use (&$promise) { + $promise->resolve('foo'); +}); + +// Calling wait will return the value of the promise. +echo $promise->wait(); // outputs "foo" +``` + +If an exception is encountered while invoking the wait function of a promise, +the promise is rejected with the exception and the exception is thrown. + +```php +$promise = new Promise(function () use (&$promise) { + throw new \Exception('foo'); +}); + +$promise->wait(); // throws the exception. +``` + +Calling `wait` on a promise that has been fulfilled will not trigger the wait +function. It will simply return the previously resolved value. + +```php +$promise = new Promise(function () { die('this is not called!'); }); +$promise->resolve('foo'); +echo $promise->wait(); // outputs "foo" +``` + +Calling `wait` on a promise that has been rejected will throw an exception. If +the rejection reason is an instance of `\Exception` the reason is thrown. +Otherwise, a `GuzzleHttp\Promise\RejectionException` is thrown and the reason +can be obtained by calling the `getReason` method of the exception. + +```php +$promise = new Promise(); +$promise->reject('foo'); +$promise->wait(); +``` + +> PHP Fatal error: Uncaught exception 'GuzzleHttp\Promise\RejectionException' with message 'The promise was rejected with value: foo' + + +## Unwrapping a promise + +When synchronously waiting on a promise, you are joining the state of the +promise into the current state of execution (i.e., return the value of the +promise if it was fulfilled or throw an exception if it was rejected). This is +called "unwrapping" the promise. Waiting on a promise will by default unwrap +the promise state. + +You can force a promise to resolve and *not* unwrap the state of the promise +by passing `false` to the first argument of the `wait` function: + +```php +$promise = new Promise(); +$promise->reject('foo'); +// This will not throw an exception. It simply ensures the promise has +// been resolved. +$promise->wait(false); +``` + +When unwrapping a promise, the resolved value of the promise will be waited +upon until the unwrapped value is not a promise. This means that if you resolve +promise A with a promise B and unwrap promise A, the value returned by the +wait function will be the value delivered to promise B. + +**Note**: when you do not unwrap the promise, no value is returned. + + +# Cancellation + +You can cancel a promise that has not yet been fulfilled using the `cancel()` +method of a promise. When creating a promise you can provide an optional +cancel function that when invoked cancels the action of computing a resolution +of the promise. + + +# API + + +## Promise + +When creating a promise object, you can provide an optional `$waitFn` and +`$cancelFn`. `$waitFn` is a function that is invoked with no arguments and is +expected to resolve the promise. `$cancelFn` is a function with no arguments +that is expected to cancel the computation of a promise. It is invoked when the +`cancel()` method of a promise is called. + +```php +use GuzzleHttp\Promise\Promise; + +$promise = new Promise( + function () use (&$promise) { + $promise->resolve('waited'); + }, + function () { + // do something that will cancel the promise computation (e.g., close + // a socket, cancel a database query, etc...) + } +); + +assert('waited' === $promise->wait()); +``` + +A promise has the following methods: + +- `then(callable $onFulfilled, callable $onRejected) : PromiseInterface` + + Appends fulfillment and rejection handlers to the promise, and returns a new promise resolving to the return value of the called handler. + +- `otherwise(callable $onRejected) : PromiseInterface` + + Appends a rejection handler callback to the promise, and returns a new promise resolving to the return value of the callback if it is called, or to its original fulfillment value if the promise is instead fulfilled. + +- `wait($unwrap = true) : mixed` + + Synchronously waits on the promise to complete. + + `$unwrap` controls whether or not the value of the promise is returned for a + fulfilled promise or if an exception is thrown if the promise is rejected. + This is set to `true` by default. + +- `cancel()` + + Attempts to cancel the promise if possible. The promise being cancelled and + the parent most ancestor that has not yet been resolved will also be + cancelled. Any promises waiting on the cancelled promise to resolve will also + be cancelled. + +- `getState() : string` + + Returns the state of the promise. One of `pending`, `fulfilled`, or + `rejected`. + +- `resolve($value)` + + Fulfills the promise with the given `$value`. + +- `reject($reason)` + + Rejects the promise with the given `$reason`. + + +## FulfilledPromise + +A fulfilled promise can be created to represent a promise that has been +fulfilled. + +```php +use GuzzleHttp\Promise\FulfilledPromise; + +$promise = new FulfilledPromise('value'); + +// Fulfilled callbacks are immediately invoked. +$promise->then(function ($value) { + echo $value; +}); +``` + + +## RejectedPromise + +A rejected promise can be created to represent a promise that has been +rejected. + +```php +use GuzzleHttp\Promise\RejectedPromise; + +$promise = new RejectedPromise('Error'); + +// Rejected callbacks are immediately invoked. +$promise->then(null, function ($reason) { + echo $reason; +}); +``` + + +# Promise interop + +This library works with foreign promises that have a `then` method. This means +you can use Guzzle promises with [React promises](https://github.com/reactphp/promise) +for example. When a foreign promise is returned inside of a then method +callback, promise resolution will occur recursively. + +```php +// Create a React promise +$deferred = new React\Promise\Deferred(); +$reactPromise = $deferred->promise(); + +// Create a Guzzle promise that is fulfilled with a React promise. +$guzzlePromise = new \GuzzleHttp\Promise\Promise(); +$guzzlePromise->then(function ($value) use ($reactPromise) { + // Do something something with the value... + // Return the React promise + return $reactPromise; +}); +``` + +Please note that wait and cancel chaining is no longer possible when forwarding +a foreign promise. You will need to wrap a third-party promise with a Guzzle +promise in order to utilize wait and cancel functions with foreign promises. + + +## Event Loop Integration + +In order to keep the stack size constant, Guzzle promises are resolved +asynchronously using a task queue. When waiting on promises synchronously, the +task queue will be automatically run to ensure that the blocking promise and +any forwarded promises are resolved. When using promises asynchronously in an +event loop, you will need to run the task queue on each tick of the loop. If +you do not run the task queue, then promises will not be resolved. + +You can run the task queue using the `run()` method of the global task queue +instance. + +```php +// Get the global task queue +$queue = \GuzzleHttp\Promise\queue(); +$queue->run(); +``` + +For example, you could use Guzzle promises with React using a periodic timer: + +```php +$loop = React\EventLoop\Factory::create(); +$loop->addPeriodicTimer(0, [$queue, 'run']); +``` + +*TODO*: Perhaps adding a `futureTick()` on each tick would be faster? + + +# Implementation notes + + +## Promise resolution and chaining is handled iteratively + +By shuffling pending handlers from one owner to another, promises are +resolved iteratively, allowing for "infinite" then chaining. + +```php +then(function ($v) { + // The stack size remains constant (a good thing) + echo xdebug_get_stack_depth() . ', '; + return $v + 1; + }); +} + +$parent->resolve(0); +var_dump($p->wait()); // int(1000) + +``` + +When a promise is fulfilled or rejected with a non-promise value, the promise +then takes ownership of the handlers of each child promise and delivers values +down the chain without using recursion. + +When a promise is resolved with another promise, the original promise transfers +all of its pending handlers to the new promise. When the new promise is +eventually resolved, all of the pending handlers are delivered the forwarded +value. + + +## A promise is the deferred. + +Some promise libraries implement promises using a deferred object to represent +a computation and a promise object to represent the delivery of the result of +the computation. This is a nice separation of computation and delivery because +consumers of the promise cannot modify the value that will be eventually +delivered. + +One side effect of being able to implement promise resolution and chaining +iteratively is that you need to be able for one promise to reach into the state +of another promise to shuffle around ownership of handlers. In order to achieve +this without making the handlers of a promise publicly mutable, a promise is +also the deferred value, allowing promises of the same parent class to reach +into and modify the private properties of promises of the same type. While this +does allow consumers of the value to modify the resolution or rejection of the +deferred, it is a small price to pay for keeping the stack size constant. + +```php +$promise = new Promise(); +$promise->then(function ($value) { echo $value; }); +// The promise is the deferred value, so you can deliver a value to it. +$promise->resolve('foo'); +// prints "foo" +``` diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/composer.json b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/composer.json new file mode 100644 index 0000000..ec41a61 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/composer.json @@ -0,0 +1,34 @@ +{ + "name": "guzzlehttp/promises", + "description": "Guzzle promises library", + "keywords": ["promise"], + "license": "MIT", + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + } + ], + "require": { + "php": ">=5.5.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.0" + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\Promise\\": "src/" + }, + "files": ["src/functions_include.php"] + }, + "scripts": { + "test": "vendor/bin/phpunit", + "test-ci": "vendor/bin/phpunit --coverage-text" + }, + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/AggregateException.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/AggregateException.php new file mode 100644 index 0000000..6a5690c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/AggregateException.php @@ -0,0 +1,16 @@ +then(function ($v) { echo $v; }); + * + * @param callable $generatorFn Generator function to wrap into a promise. + * + * @return Promise + * @link https://github.com/petkaantonov/bluebird/blob/master/API.md#generators inspiration + */ +final class Coroutine implements PromiseInterface +{ + /** + * @var PromiseInterface|null + */ + private $currentPromise; + + /** + * @var Generator + */ + private $generator; + + /** + * @var Promise + */ + private $result; + + public function __construct(callable $generatorFn) + { + $this->generator = $generatorFn(); + $this->result = new Promise(function () { + while (isset($this->currentPromise)) { + $this->currentPromise->wait(); + } + }); + $this->nextCoroutine($this->generator->current()); + } + + public function then( + callable $onFulfilled = null, + callable $onRejected = null + ) { + return $this->result->then($onFulfilled, $onRejected); + } + + public function otherwise(callable $onRejected) + { + return $this->result->otherwise($onRejected); + } + + public function wait($unwrap = true) + { + return $this->result->wait($unwrap); + } + + public function getState() + { + return $this->result->getState(); + } + + public function resolve($value) + { + $this->result->resolve($value); + } + + public function reject($reason) + { + $this->result->reject($reason); + } + + public function cancel() + { + $this->currentPromise->cancel(); + $this->result->cancel(); + } + + private function nextCoroutine($yielded) + { + $this->currentPromise = promise_for($yielded) + ->then([$this, '_handleSuccess'], [$this, '_handleFailure']); + } + + /** + * @internal + */ + public function _handleSuccess($value) + { + unset($this->currentPromise); + try { + $next = $this->generator->send($value); + if ($this->generator->valid()) { + $this->nextCoroutine($next); + } else { + $this->result->resolve($value); + } + } catch (Exception $exception) { + $this->result->reject($exception); + } catch (Throwable $throwable) { + $this->result->reject($throwable); + } + } + + /** + * @internal + */ + public function _handleFailure($reason) + { + unset($this->currentPromise); + try { + $nextYield = $this->generator->throw(exception_for($reason)); + // The throw was caught, so keep iterating on the coroutine + $this->nextCoroutine($nextYield); + } catch (Exception $exception) { + $this->result->reject($exception); + } catch (Throwable $throwable) { + $this->result->reject($throwable); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/EachPromise.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/EachPromise.php new file mode 100644 index 0000000..d0ddf60 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/EachPromise.php @@ -0,0 +1,229 @@ +iterable = iter_for($iterable); + + if (isset($config['concurrency'])) { + $this->concurrency = $config['concurrency']; + } + + if (isset($config['fulfilled'])) { + $this->onFulfilled = $config['fulfilled']; + } + + if (isset($config['rejected'])) { + $this->onRejected = $config['rejected']; + } + } + + public function promise() + { + if ($this->aggregate) { + return $this->aggregate; + } + + try { + $this->createPromise(); + $this->iterable->rewind(); + $this->refillPending(); + } catch (\Throwable $e) { + $this->aggregate->reject($e); + } catch (\Exception $e) { + $this->aggregate->reject($e); + } + + return $this->aggregate; + } + + private function createPromise() + { + $this->mutex = false; + $this->aggregate = new Promise(function () { + reset($this->pending); + if (empty($this->pending) && !$this->iterable->valid()) { + $this->aggregate->resolve(null); + return; + } + + // Consume a potentially fluctuating list of promises while + // ensuring that indexes are maintained (precluding array_shift). + while ($promise = current($this->pending)) { + next($this->pending); + $promise->wait(); + if ($this->aggregate->getState() !== PromiseInterface::PENDING) { + return; + } + } + }); + + // Clear the references when the promise is resolved. + $clearFn = function () { + $this->iterable = $this->concurrency = $this->pending = null; + $this->onFulfilled = $this->onRejected = null; + }; + + $this->aggregate->then($clearFn, $clearFn); + } + + private function refillPending() + { + if (!$this->concurrency) { + // Add all pending promises. + while ($this->addPending() && $this->advanceIterator()); + return; + } + + // Add only up to N pending promises. + $concurrency = is_callable($this->concurrency) + ? call_user_func($this->concurrency, count($this->pending)) + : $this->concurrency; + $concurrency = max($concurrency - count($this->pending), 0); + // Concurrency may be set to 0 to disallow new promises. + if (!$concurrency) { + return; + } + // Add the first pending promise. + $this->addPending(); + // Note this is special handling for concurrency=1 so that we do + // not advance the iterator after adding the first promise. This + // helps work around issues with generators that might not have the + // next value to yield until promise callbacks are called. + while (--$concurrency + && $this->advanceIterator() + && $this->addPending()); + } + + private function addPending() + { + if (!$this->iterable || !$this->iterable->valid()) { + return false; + } + + $promise = promise_for($this->iterable->current()); + $idx = $this->iterable->key(); + + $this->pending[$idx] = $promise->then( + function ($value) use ($idx) { + if ($this->onFulfilled) { + call_user_func( + $this->onFulfilled, $value, $idx, $this->aggregate + ); + } + $this->step($idx); + }, + function ($reason) use ($idx) { + if ($this->onRejected) { + call_user_func( + $this->onRejected, $reason, $idx, $this->aggregate + ); + } + $this->step($idx); + } + ); + + return true; + } + + private function advanceIterator() + { + // Place a lock on the iterator so that we ensure to not recurse, + // preventing fatal generator errors. + if ($this->mutex) { + return false; + } + + $this->mutex = true; + + try { + $this->iterable->next(); + $this->mutex = false; + return true; + } catch (\Throwable $e) { + $this->aggregate->reject($e); + $this->mutex = false; + return false; + } catch (\Exception $e) { + $this->aggregate->reject($e); + $this->mutex = false; + return false; + } + } + + private function step($idx) + { + // If the promise was already resolved, then ignore this step. + if ($this->aggregate->getState() !== PromiseInterface::PENDING) { + return; + } + + unset($this->pending[$idx]); + + // Only refill pending promises if we are not locked, preventing the + // EachPromise to recursively invoke the provided iterator, which + // cause a fatal error: "Cannot resume an already running generator" + if ($this->advanceIterator() && !$this->checkIfFinished()) { + // Add more pending promises if possible. + $this->refillPending(); + } + } + + private function checkIfFinished() + { + if (!$this->pending && !$this->iterable->valid()) { + // Resolve the promise if there's nothing left to do. + $this->aggregate->resolve(null); + return true; + } + + return false; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/FulfilledPromise.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/FulfilledPromise.php new file mode 100644 index 0000000..dbbeeb9 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/FulfilledPromise.php @@ -0,0 +1,82 @@ +value = $value; + } + + public function then( + callable $onFulfilled = null, + callable $onRejected = null + ) { + // Return itself if there is no onFulfilled function. + if (!$onFulfilled) { + return $this; + } + + $queue = queue(); + $p = new Promise([$queue, 'run']); + $value = $this->value; + $queue->add(static function () use ($p, $value, $onFulfilled) { + if ($p->getState() === self::PENDING) { + try { + $p->resolve($onFulfilled($value)); + } catch (\Throwable $e) { + $p->reject($e); + } catch (\Exception $e) { + $p->reject($e); + } + } + }); + + return $p; + } + + public function otherwise(callable $onRejected) + { + return $this->then(null, $onRejected); + } + + public function wait($unwrap = true, $defaultDelivery = null) + { + return $unwrap ? $this->value : null; + } + + public function getState() + { + return self::FULFILLED; + } + + public function resolve($value) + { + if ($value !== $this->value) { + throw new \LogicException("Cannot resolve a fulfilled promise"); + } + } + + public function reject($reason) + { + throw new \LogicException("Cannot reject a fulfilled promise"); + } + + public function cancel() + { + // pass + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/Promise.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/Promise.php new file mode 100644 index 0000000..844ada0 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/Promise.php @@ -0,0 +1,280 @@ +waitFn = $waitFn; + $this->cancelFn = $cancelFn; + } + + public function then( + callable $onFulfilled = null, + callable $onRejected = null + ) { + if ($this->state === self::PENDING) { + $p = new Promise(null, [$this, 'cancel']); + $this->handlers[] = [$p, $onFulfilled, $onRejected]; + $p->waitList = $this->waitList; + $p->waitList[] = $this; + return $p; + } + + // Return a fulfilled promise and immediately invoke any callbacks. + if ($this->state === self::FULFILLED) { + return $onFulfilled + ? promise_for($this->result)->then($onFulfilled) + : promise_for($this->result); + } + + // It's either cancelled or rejected, so return a rejected promise + // and immediately invoke any callbacks. + $rejection = rejection_for($this->result); + return $onRejected ? $rejection->then(null, $onRejected) : $rejection; + } + + public function otherwise(callable $onRejected) + { + return $this->then(null, $onRejected); + } + + public function wait($unwrap = true) + { + $this->waitIfPending(); + + $inner = $this->result instanceof PromiseInterface + ? $this->result->wait($unwrap) + : $this->result; + + if ($unwrap) { + if ($this->result instanceof PromiseInterface + || $this->state === self::FULFILLED + ) { + return $inner; + } else { + // It's rejected so "unwrap" and throw an exception. + throw exception_for($inner); + } + } + } + + public function getState() + { + return $this->state; + } + + public function cancel() + { + if ($this->state !== self::PENDING) { + return; + } + + $this->waitFn = $this->waitList = null; + + if ($this->cancelFn) { + $fn = $this->cancelFn; + $this->cancelFn = null; + try { + $fn(); + } catch (\Throwable $e) { + $this->reject($e); + } catch (\Exception $e) { + $this->reject($e); + } + } + + // Reject the promise only if it wasn't rejected in a then callback. + if ($this->state === self::PENDING) { + $this->reject(new CancellationException('Promise has been cancelled')); + } + } + + public function resolve($value) + { + $this->settle(self::FULFILLED, $value); + } + + public function reject($reason) + { + $this->settle(self::REJECTED, $reason); + } + + private function settle($state, $value) + { + if ($this->state !== self::PENDING) { + // Ignore calls with the same resolution. + if ($state === $this->state && $value === $this->result) { + return; + } + throw $this->state === $state + ? new \LogicException("The promise is already {$state}.") + : new \LogicException("Cannot change a {$this->state} promise to {$state}"); + } + + if ($value === $this) { + throw new \LogicException('Cannot fulfill or reject a promise with itself'); + } + + // Clear out the state of the promise but stash the handlers. + $this->state = $state; + $this->result = $value; + $handlers = $this->handlers; + $this->handlers = null; + $this->waitList = $this->waitFn = null; + $this->cancelFn = null; + + if (!$handlers) { + return; + } + + // If the value was not a settled promise or a thenable, then resolve + // it in the task queue using the correct ID. + if (!method_exists($value, 'then')) { + $id = $state === self::FULFILLED ? 1 : 2; + // It's a success, so resolve the handlers in the queue. + queue()->add(static function () use ($id, $value, $handlers) { + foreach ($handlers as $handler) { + self::callHandler($id, $value, $handler); + } + }); + } elseif ($value instanceof Promise + && $value->getState() === self::PENDING + ) { + // We can just merge our handlers onto the next promise. + $value->handlers = array_merge($value->handlers, $handlers); + } else { + // Resolve the handlers when the forwarded promise is resolved. + $value->then( + static function ($value) use ($handlers) { + foreach ($handlers as $handler) { + self::callHandler(1, $value, $handler); + } + }, + static function ($reason) use ($handlers) { + foreach ($handlers as $handler) { + self::callHandler(2, $reason, $handler); + } + } + ); + } + } + + /** + * Call a stack of handlers using a specific callback index and value. + * + * @param int $index 1 (resolve) or 2 (reject). + * @param mixed $value Value to pass to the callback. + * @param array $handler Array of handler data (promise and callbacks). + * + * @return array Returns the next group to resolve. + */ + private static function callHandler($index, $value, array $handler) + { + /** @var PromiseInterface $promise */ + $promise = $handler[0]; + + // The promise may have been cancelled or resolved before placing + // this thunk in the queue. + if ($promise->getState() !== self::PENDING) { + return; + } + + try { + if (isset($handler[$index])) { + $promise->resolve($handler[$index]($value)); + } elseif ($index === 1) { + // Forward resolution values as-is. + $promise->resolve($value); + } else { + // Forward rejections down the chain. + $promise->reject($value); + } + } catch (\Throwable $reason) { + $promise->reject($reason); + } catch (\Exception $reason) { + $promise->reject($reason); + } + } + + private function waitIfPending() + { + if ($this->state !== self::PENDING) { + return; + } elseif ($this->waitFn) { + $this->invokeWaitFn(); + } elseif ($this->waitList) { + $this->invokeWaitList(); + } else { + // If there's not wait function, then reject the promise. + $this->reject('Cannot wait on a promise that has ' + . 'no internal wait function. You must provide a wait ' + . 'function when constructing the promise to be able to ' + . 'wait on a promise.'); + } + + queue()->run(); + + if ($this->state === self::PENDING) { + $this->reject('Invoking the wait callback did not resolve the promise'); + } + } + + private function invokeWaitFn() + { + try { + $wfn = $this->waitFn; + $this->waitFn = null; + $wfn(true); + } catch (\Exception $reason) { + if ($this->state === self::PENDING) { + // The promise has not been resolved yet, so reject the promise + // with the exception. + $this->reject($reason); + } else { + // The promise was already resolved, so there's a problem in + // the application. + throw $reason; + } + } + } + + private function invokeWaitList() + { + $waitList = $this->waitList; + $this->waitList = null; + + foreach ($waitList as $result) { + while (true) { + $result->waitIfPending(); + + if ($result->result instanceof Promise) { + $result = $result->result; + } else { + if ($result->result instanceof PromiseInterface) { + $result->result->wait(false); + } + break; + } + } + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/PromiseInterface.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/PromiseInterface.php new file mode 100644 index 0000000..8f5f4b9 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/PromiseInterface.php @@ -0,0 +1,93 @@ +reason = $reason; + } + + public function then( + callable $onFulfilled = null, + callable $onRejected = null + ) { + // If there's no onRejected callback then just return self. + if (!$onRejected) { + return $this; + } + + $queue = queue(); + $reason = $this->reason; + $p = new Promise([$queue, 'run']); + $queue->add(static function () use ($p, $reason, $onRejected) { + if ($p->getState() === self::PENDING) { + try { + // Return a resolved promise if onRejected does not throw. + $p->resolve($onRejected($reason)); + } catch (\Throwable $e) { + // onRejected threw, so return a rejected promise. + $p->reject($e); + } catch (\Exception $e) { + // onRejected threw, so return a rejected promise. + $p->reject($e); + } + } + }); + + return $p; + } + + public function otherwise(callable $onRejected) + { + return $this->then(null, $onRejected); + } + + public function wait($unwrap = true, $defaultDelivery = null) + { + if ($unwrap) { + throw exception_for($this->reason); + } + } + + public function getState() + { + return self::REJECTED; + } + + public function resolve($value) + { + throw new \LogicException("Cannot resolve a rejected promise"); + } + + public function reject($reason) + { + if ($reason !== $this->reason) { + throw new \LogicException("Cannot reject a rejected promise"); + } + } + + public function cancel() + { + // pass + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/RejectionException.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/RejectionException.php new file mode 100644 index 0000000..07c1136 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/RejectionException.php @@ -0,0 +1,47 @@ +reason = $reason; + + $message = 'The promise was rejected'; + + if ($description) { + $message .= ' with reason: ' . $description; + } elseif (is_string($reason) + || (is_object($reason) && method_exists($reason, '__toString')) + ) { + $message .= ' with reason: ' . $this->reason; + } elseif ($reason instanceof \JsonSerializable) { + $message .= ' with reason: ' + . json_encode($this->reason, JSON_PRETTY_PRINT); + } + + parent::__construct($message); + } + + /** + * Returns the rejection reason. + * + * @return mixed + */ + public function getReason() + { + return $this->reason; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/TaskQueue.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/TaskQueue.php new file mode 100644 index 0000000..6e8a2a0 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/TaskQueue.php @@ -0,0 +1,66 @@ +run(); + */ +class TaskQueue implements TaskQueueInterface +{ + private $enableShutdown = true; + private $queue = []; + + public function __construct($withShutdown = true) + { + if ($withShutdown) { + register_shutdown_function(function () { + if ($this->enableShutdown) { + // Only run the tasks if an E_ERROR didn't occur. + $err = error_get_last(); + if (!$err || ($err['type'] ^ E_ERROR)) { + $this->run(); + } + } + }); + } + } + + public function isEmpty() + { + return !$this->queue; + } + + public function add(callable $task) + { + $this->queue[] = $task; + } + + public function run() + { + /** @var callable $task */ + while ($task = array_shift($this->queue)) { + $task(); + } + } + + /** + * The task queue will be run and exhausted by default when the process + * exits IFF the exit is not the result of a PHP E_ERROR error. + * + * You can disable running the automatic shutdown of the queue by calling + * this function. If you disable the task queue shutdown process, then you + * MUST either run the task queue (as a result of running your event loop + * or manually using the run() method) or wait on each outstanding promise. + * + * Note: This shutdown will occur before any destructors are triggered. + */ + public function disableShutdown() + { + $this->enableShutdown = false; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/TaskQueueInterface.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/TaskQueueInterface.php new file mode 100644 index 0000000..ac8306e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/TaskQueueInterface.php @@ -0,0 +1,25 @@ + + * while ($eventLoop->isRunning()) { + * GuzzleHttp\Promise\queue()->run(); + * } + * + * + * @param TaskQueueInterface $assign Optionally specify a new queue instance. + * + * @return TaskQueueInterface + */ +function queue(TaskQueueInterface $assign = null) +{ + static $queue; + + if ($assign) { + $queue = $assign; + } elseif (!$queue) { + $queue = new TaskQueue(); + } + + return $queue; +} + +/** + * Adds a function to run in the task queue when it is next `run()` and returns + * a promise that is fulfilled or rejected with the result. + * + * @param callable $task Task function to run. + * + * @return PromiseInterface + */ +function task(callable $task) +{ + $queue = queue(); + $promise = new Promise([$queue, 'run']); + $queue->add(function () use ($task, $promise) { + try { + $promise->resolve($task()); + } catch (\Throwable $e) { + $promise->reject($e); + } catch (\Exception $e) { + $promise->reject($e); + } + }); + + return $promise; +} + +/** + * Creates a promise for a value if the value is not a promise. + * + * @param mixed $value Promise or value. + * + * @return PromiseInterface + */ +function promise_for($value) +{ + if ($value instanceof PromiseInterface) { + return $value; + } + + // Return a Guzzle promise that shadows the given promise. + if (method_exists($value, 'then')) { + $wfn = method_exists($value, 'wait') ? [$value, 'wait'] : null; + $cfn = method_exists($value, 'cancel') ? [$value, 'cancel'] : null; + $promise = new Promise($wfn, $cfn); + $value->then([$promise, 'resolve'], [$promise, 'reject']); + return $promise; + } + + return new FulfilledPromise($value); +} + +/** + * Creates a rejected promise for a reason if the reason is not a promise. If + * the provided reason is a promise, then it is returned as-is. + * + * @param mixed $reason Promise or reason. + * + * @return PromiseInterface + */ +function rejection_for($reason) +{ + if ($reason instanceof PromiseInterface) { + return $reason; + } + + return new RejectedPromise($reason); +} + +/** + * Create an exception for a rejected promise value. + * + * @param mixed $reason + * + * @return \Exception|\Throwable + */ +function exception_for($reason) +{ + return $reason instanceof \Exception || $reason instanceof \Throwable + ? $reason + : new RejectionException($reason); +} + +/** + * Returns an iterator for the given value. + * + * @param mixed $value + * + * @return \Iterator + */ +function iter_for($value) +{ + if ($value instanceof \Iterator) { + return $value; + } elseif (is_array($value)) { + return new \ArrayIterator($value); + } else { + return new \ArrayIterator([$value]); + } +} + +/** + * Synchronously waits on a promise to resolve and returns an inspection state + * array. + * + * Returns a state associative array containing a "state" key mapping to a + * valid promise state. If the state of the promise is "fulfilled", the array + * will contain a "value" key mapping to the fulfilled value of the promise. If + * the promise is rejected, the array will contain a "reason" key mapping to + * the rejection reason of the promise. + * + * @param PromiseInterface $promise Promise or value. + * + * @return array + */ +function inspect(PromiseInterface $promise) +{ + try { + return [ + 'state' => PromiseInterface::FULFILLED, + 'value' => $promise->wait() + ]; + } catch (RejectionException $e) { + return ['state' => PromiseInterface::REJECTED, 'reason' => $e->getReason()]; + } catch (\Throwable $e) { + return ['state' => PromiseInterface::REJECTED, 'reason' => $e]; + } catch (\Exception $e) { + return ['state' => PromiseInterface::REJECTED, 'reason' => $e]; + } +} + +/** + * Waits on all of the provided promises, but does not unwrap rejected promises + * as thrown exception. + * + * Returns an array of inspection state arrays. + * + * @param PromiseInterface[] $promises Traversable of promises to wait upon. + * + * @return array + * @see GuzzleHttp\Promise\inspect for the inspection state array format. + */ +function inspect_all($promises) +{ + $results = []; + foreach ($promises as $key => $promise) { + $results[$key] = inspect($promise); + } + + return $results; +} + +/** + * Waits on all of the provided promises and returns the fulfilled values. + * + * Returns an array that contains the value of each promise (in the same order + * the promises were provided). An exception is thrown if any of the promises + * are rejected. + * + * @param mixed $promises Iterable of PromiseInterface objects to wait on. + * + * @return array + * @throws \Exception on error + * @throws \Throwable on error in PHP >=7 + */ +function unwrap($promises) +{ + $results = []; + foreach ($promises as $key => $promise) { + $results[$key] = $promise->wait(); + } + + return $results; +} + +/** + * Given an array of promises, return a promise that is fulfilled when all the + * items in the array are fulfilled. + * + * The promise's fulfillment value is an array with fulfillment values at + * respective positions to the original array. If any promise in the array + * rejects, the returned promise is rejected with the rejection reason. + * + * @param mixed $promises Promises or values. + * + * @return PromiseInterface + */ +function all($promises) +{ + $results = []; + return each( + $promises, + function ($value, $idx) use (&$results) { + $results[$idx] = $value; + }, + function ($reason, $idx, Promise $aggregate) { + $aggregate->reject($reason); + } + )->then(function () use (&$results) { + ksort($results); + return $results; + }); +} + +/** + * Initiate a competitive race between multiple promises or values (values will + * become immediately fulfilled promises). + * + * When count amount of promises have been fulfilled, the returned promise is + * fulfilled with an array that contains the fulfillment values of the winners + * in order of resolution. + * + * This prommise is rejected with a {@see GuzzleHttp\Promise\AggregateException} + * if the number of fulfilled promises is less than the desired $count. + * + * @param int $count Total number of promises. + * @param mixed $promises Promises or values. + * + * @return PromiseInterface + */ +function some($count, $promises) +{ + $results = []; + $rejections = []; + + return each( + $promises, + function ($value, $idx, PromiseInterface $p) use (&$results, $count) { + if ($p->getState() !== PromiseInterface::PENDING) { + return; + } + $results[$idx] = $value; + if (count($results) >= $count) { + $p->resolve(null); + } + }, + function ($reason) use (&$rejections) { + $rejections[] = $reason; + } + )->then( + function () use (&$results, &$rejections, $count) { + if (count($results) !== $count) { + throw new AggregateException( + 'Not enough promises to fulfill count', + $rejections + ); + } + ksort($results); + return array_values($results); + } + ); +} + +/** + * Like some(), with 1 as count. However, if the promise fulfills, the + * fulfillment value is not an array of 1 but the value directly. + * + * @param mixed $promises Promises or values. + * + * @return PromiseInterface + */ +function any($promises) +{ + return some(1, $promises)->then(function ($values) { return $values[0]; }); +} + +/** + * Returns a promise that is fulfilled when all of the provided promises have + * been fulfilled or rejected. + * + * The returned promise is fulfilled with an array of inspection state arrays. + * + * @param mixed $promises Promises or values. + * + * @return PromiseInterface + * @see GuzzleHttp\Promise\inspect for the inspection state array format. + */ +function settle($promises) +{ + $results = []; + + return each( + $promises, + function ($value, $idx) use (&$results) { + $results[$idx] = ['state' => PromiseInterface::FULFILLED, 'value' => $value]; + }, + function ($reason, $idx) use (&$results) { + $results[$idx] = ['state' => PromiseInterface::REJECTED, 'reason' => $reason]; + } + )->then(function () use (&$results) { + ksort($results); + return $results; + }); +} + +/** + * Given an iterator that yields promises or values, returns a promise that is + * fulfilled with a null value when the iterator has been consumed or the + * aggregate promise has been fulfilled or rejected. + * + * $onFulfilled is a function that accepts the fulfilled value, iterator + * index, and the aggregate promise. The callback can invoke any necessary side + * effects and choose to resolve or reject the aggregate promise if needed. + * + * $onRejected is a function that accepts the rejection reason, iterator + * index, and the aggregate promise. The callback can invoke any necessary side + * effects and choose to resolve or reject the aggregate promise if needed. + * + * @param mixed $iterable Iterator or array to iterate over. + * @param callable $onFulfilled + * @param callable $onRejected + * + * @return PromiseInterface + */ +function each( + $iterable, + callable $onFulfilled = null, + callable $onRejected = null +) { + return (new EachPromise($iterable, [ + 'fulfilled' => $onFulfilled, + 'rejected' => $onRejected + ]))->promise(); +} + +/** + * Like each, but only allows a certain number of outstanding promises at any + * given time. + * + * $concurrency may be an integer or a function that accepts the number of + * pending promises and returns a numeric concurrency limit value to allow for + * dynamic a concurrency size. + * + * @param mixed $iterable + * @param int|callable $concurrency + * @param callable $onFulfilled + * @param callable $onRejected + * + * @return PromiseInterface + */ +function each_limit( + $iterable, + $concurrency, + callable $onFulfilled = null, + callable $onRejected = null +) { + return (new EachPromise($iterable, [ + 'fulfilled' => $onFulfilled, + 'rejected' => $onRejected, + 'concurrency' => $concurrency + ]))->promise(); +} + +/** + * Like each_limit, but ensures that no promise in the given $iterable argument + * is rejected. If any promise is rejected, then the aggregate promise is + * rejected with the encountered rejection. + * + * @param mixed $iterable + * @param int|callable $concurrency + * @param callable $onFulfilled + * + * @return PromiseInterface + */ +function each_limit_all( + $iterable, + $concurrency, + callable $onFulfilled = null +) { + return each_limit( + $iterable, + $concurrency, + $onFulfilled, + function ($reason, $idx, PromiseInterface $aggregate) { + $aggregate->reject($reason); + } + ); +} + +/** + * Returns true if a promise is fulfilled. + * + * @param PromiseInterface $promise + * + * @return bool + */ +function is_fulfilled(PromiseInterface $promise) +{ + return $promise->getState() === PromiseInterface::FULFILLED; +} + +/** + * Returns true if a promise is rejected. + * + * @param PromiseInterface $promise + * + * @return bool + */ +function is_rejected(PromiseInterface $promise) +{ + return $promise->getState() === PromiseInterface::REJECTED; +} + +/** + * Returns true if a promise is fulfilled or rejected. + * + * @param PromiseInterface $promise + * + * @return bool + */ +function is_settled(PromiseInterface $promise) +{ + return $promise->getState() !== PromiseInterface::PENDING; +} + +/** + * @see Coroutine + * + * @param callable $generatorFn + * + * @return PromiseInterface + */ +function coroutine(callable $generatorFn) +{ + return new Coroutine($generatorFn); +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/functions_include.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/functions_include.php new file mode 100644 index 0000000..34cd171 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/promises/src/functions_include.php @@ -0,0 +1,6 @@ +withPath('foo')->withHost('example.com')` will throw an exception + because the path of a URI with an authority must start with a slash "/" or be empty + - `(new Uri())->withScheme('http')` will return `'http://localhost'` +* Fix compatibility of URIs with `file` scheme and empty host. +* Added common URI utility methods based on RFC 3986 (see documentation in the readme): + - `Uri::isDefaultPort` + - `Uri::isAbsolute` + - `Uri::isNetworkPathReference` + - `Uri::isAbsolutePathReference` + - `Uri::isRelativePathReference` + - `Uri::isSameDocumentReference` + - `Uri::composeComponents` + - `UriNormalizer::normalize` + - `UriNormalizer::isEquivalent` + - `UriResolver::relativize` +* Deprecated `Uri::resolve` in favor of `UriResolver::resolve` +* Deprecated `Uri::removeDotSegments` in favor of `UriResolver::removeDotSegments` + +## 1.3.1 - 2016-06-25 + +* Fix `Uri::__toString` for network path references, e.g. `//example.org`. +* Fix missing lowercase normalization for host. +* Fix handling of URI components in case they are `'0'` in a lot of places, + e.g. as a user info password. +* Fix `Uri::withAddedHeader` to correctly merge headers with different case. +* Fix trimming of header values in `Uri::withAddedHeader`. Header values may + be surrounded by whitespace which should be ignored according to RFC 7230 + Section 3.2.4. This does not apply to header names. +* Fix `Uri::withAddedHeader` with an array of header values. +* Fix `Uri::resolve` when base path has no slash and handling of fragment. +* Fix handling of encoding in `Uri::with(out)QueryValue` so one can pass the + key/value both in encoded as well as decoded form to those methods. This is + consistent with withPath, withQuery etc. +* Fix `ServerRequest::withoutAttribute` when attribute value is null. + +## 1.3.0 - 2016-04-13 + +* Added remaining interfaces needed for full PSR7 compatibility + (ServerRequestInterface, UploadedFileInterface, etc.). +* Added support for stream_for from scalars. +* Can now extend Uri. +* Fixed a bug in validating request methods by making it more permissive. + +## 1.2.3 - 2016-02-18 + +* Fixed support in `GuzzleHttp\Psr7\CachingStream` for seeking forward on remote + streams, which can sometimes return fewer bytes than requested with `fread`. +* Fixed handling of gzipped responses with FNAME headers. + +## 1.2.2 - 2016-01-22 + +* Added support for URIs without any authority. +* Added support for HTTP 451 'Unavailable For Legal Reasons.' +* Added support for using '0' as a filename. +* Added support for including non-standard ports in Host headers. + +## 1.2.1 - 2015-11-02 + +* Now supporting negative offsets when seeking to SEEK_END. + +## 1.2.0 - 2015-08-15 + +* Body as `"0"` is now properly added to a response. +* Now allowing forward seeking in CachingStream. +* Now properly parsing HTTP requests that contain proxy targets in + `parse_request`. +* functions.php is now conditionally required. +* user-info is no longer dropped when resolving URIs. + +## 1.1.0 - 2015-06-24 + +* URIs can now be relative. +* `multipart/form-data` headers are now overridden case-insensitively. +* URI paths no longer encode the following characters because they are allowed + in URIs: "(", ")", "*", "!", "'" +* A port is no longer added to a URI when the scheme is missing and no port is + present. + +## 1.0.0 - 2015-05-19 + +Initial release. + +Currently unsupported: + +- `Psr\Http\Message\ServerRequestInterface` +- `Psr\Http\Message\UploadedFileInterface` diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/LICENSE new file mode 100644 index 0000000..581d95f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2015 Michael Dowling, https://github.com/mtdowling + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/README.md b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/README.md new file mode 100644 index 0000000..1649935 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/README.md @@ -0,0 +1,739 @@ +# PSR-7 Message Implementation + +This repository contains a full [PSR-7](http://www.php-fig.org/psr/psr-7/) +message implementation, several stream decorators, and some helpful +functionality like query string parsing. + + +[![Build Status](https://travis-ci.org/guzzle/psr7.svg?branch=master)](https://travis-ci.org/guzzle/psr7) + + +# Stream implementation + +This package comes with a number of stream implementations and stream +decorators. + + +## AppendStream + +`GuzzleHttp\Psr7\AppendStream` + +Reads from multiple streams, one after the other. + +```php +use GuzzleHttp\Psr7; + +$a = Psr7\stream_for('abc, '); +$b = Psr7\stream_for('123.'); +$composed = new Psr7\AppendStream([$a, $b]); + +$composed->addStream(Psr7\stream_for(' Above all listen to me')); + +echo $composed; // abc, 123. Above all listen to me. +``` + + +## BufferStream + +`GuzzleHttp\Psr7\BufferStream` + +Provides a buffer stream that can be written to fill a buffer, and read +from to remove bytes from the buffer. + +This stream returns a "hwm" metadata value that tells upstream consumers +what the configured high water mark of the stream is, or the maximum +preferred size of the buffer. + +```php +use GuzzleHttp\Psr7; + +// When more than 1024 bytes are in the buffer, it will begin returning +// false to writes. This is an indication that writers should slow down. +$buffer = new Psr7\BufferStream(1024); +``` + + +## CachingStream + +The CachingStream is used to allow seeking over previously read bytes on +non-seekable streams. This can be useful when transferring a non-seekable +entity body fails due to needing to rewind the stream (for example, resulting +from a redirect). Data that is read from the remote stream will be buffered in +a PHP temp stream so that previously read bytes are cached first in memory, +then on disk. + +```php +use GuzzleHttp\Psr7; + +$original = Psr7\stream_for(fopen('http://www.google.com', 'r')); +$stream = new Psr7\CachingStream($original); + +$stream->read(1024); +echo $stream->tell(); +// 1024 + +$stream->seek(0); +echo $stream->tell(); +// 0 +``` + + +## DroppingStream + +`GuzzleHttp\Psr7\DroppingStream` + +Stream decorator that begins dropping data once the size of the underlying +stream becomes too full. + +```php +use GuzzleHttp\Psr7; + +// Create an empty stream +$stream = Psr7\stream_for(); + +// Start dropping data when the stream has more than 10 bytes +$dropping = new Psr7\DroppingStream($stream, 10); + +$dropping->write('01234567890123456789'); +echo $stream; // 0123456789 +``` + + +## FnStream + +`GuzzleHttp\Psr7\FnStream` + +Compose stream implementations based on a hash of functions. + +Allows for easy testing and extension of a provided stream without needing +to create a concrete class for a simple extension point. + +```php + +use GuzzleHttp\Psr7; + +$stream = Psr7\stream_for('hi'); +$fnStream = Psr7\FnStream::decorate($stream, [ + 'rewind' => function () use ($stream) { + echo 'About to rewind - '; + $stream->rewind(); + echo 'rewound!'; + } +]); + +$fnStream->rewind(); +// Outputs: About to rewind - rewound! +``` + + +## InflateStream + +`GuzzleHttp\Psr7\InflateStream` + +Uses PHP's zlib.inflate filter to inflate deflate or gzipped content. + +This stream decorator skips the first 10 bytes of the given stream to remove +the gzip header, converts the provided stream to a PHP stream resource, +then appends the zlib.inflate filter. The stream is then converted back +to a Guzzle stream resource to be used as a Guzzle stream. + + +## LazyOpenStream + +`GuzzleHttp\Psr7\LazyOpenStream` + +Lazily reads or writes to a file that is opened only after an IO operation +take place on the stream. + +```php +use GuzzleHttp\Psr7; + +$stream = new Psr7\LazyOpenStream('/path/to/file', 'r'); +// The file has not yet been opened... + +echo $stream->read(10); +// The file is opened and read from only when needed. +``` + + +## LimitStream + +`GuzzleHttp\Psr7\LimitStream` + +LimitStream can be used to read a subset or slice of an existing stream object. +This can be useful for breaking a large file into smaller pieces to be sent in +chunks (e.g. Amazon S3's multipart upload API). + +```php +use GuzzleHttp\Psr7; + +$original = Psr7\stream_for(fopen('/tmp/test.txt', 'r+')); +echo $original->getSize(); +// >>> 1048576 + +// Limit the size of the body to 1024 bytes and start reading from byte 2048 +$stream = new Psr7\LimitStream($original, 1024, 2048); +echo $stream->getSize(); +// >>> 1024 +echo $stream->tell(); +// >>> 0 +``` + + +## MultipartStream + +`GuzzleHttp\Psr7\MultipartStream` + +Stream that when read returns bytes for a streaming multipart or +multipart/form-data stream. + + +## NoSeekStream + +`GuzzleHttp\Psr7\NoSeekStream` + +NoSeekStream wraps a stream and does not allow seeking. + +```php +use GuzzleHttp\Psr7; + +$original = Psr7\stream_for('foo'); +$noSeek = new Psr7\NoSeekStream($original); + +echo $noSeek->read(3); +// foo +var_export($noSeek->isSeekable()); +// false +$noSeek->seek(0); +var_export($noSeek->read(3)); +// NULL +``` + + +## PumpStream + +`GuzzleHttp\Psr7\PumpStream` + +Provides a read only stream that pumps data from a PHP callable. + +When invoking the provided callable, the PumpStream will pass the amount of +data requested to read to the callable. The callable can choose to ignore +this value and return fewer or more bytes than requested. Any extra data +returned by the provided callable is buffered internally until drained using +the read() function of the PumpStream. The provided callable MUST return +false when there is no more data to read. + + +## Implementing stream decorators + +Creating a stream decorator is very easy thanks to the +`GuzzleHttp\Psr7\StreamDecoratorTrait`. This trait provides methods that +implement `Psr\Http\Message\StreamInterface` by proxying to an underlying +stream. Just `use` the `StreamDecoratorTrait` and implement your custom +methods. + +For example, let's say we wanted to call a specific function each time the last +byte is read from a stream. This could be implemented by overriding the +`read()` method. + +```php +use Psr\Http\Message\StreamInterface; +use GuzzleHttp\Psr7\StreamDecoratorTrait; + +class EofCallbackStream implements StreamInterface +{ + use StreamDecoratorTrait; + + private $callback; + + public function __construct(StreamInterface $stream, callable $cb) + { + $this->stream = $stream; + $this->callback = $cb; + } + + public function read($length) + { + $result = $this->stream->read($length); + + // Invoke the callback when EOF is hit. + if ($this->eof()) { + call_user_func($this->callback); + } + + return $result; + } +} +``` + +This decorator could be added to any existing stream and used like so: + +```php +use GuzzleHttp\Psr7; + +$original = Psr7\stream_for('foo'); + +$eofStream = new EofCallbackStream($original, function () { + echo 'EOF!'; +}); + +$eofStream->read(2); +$eofStream->read(1); +// echoes "EOF!" +$eofStream->seek(0); +$eofStream->read(3); +// echoes "EOF!" +``` + + +## PHP StreamWrapper + +You can use the `GuzzleHttp\Psr7\StreamWrapper` class if you need to use a +PSR-7 stream as a PHP stream resource. + +Use the `GuzzleHttp\Psr7\StreamWrapper::getResource()` method to create a PHP +stream from a PSR-7 stream. + +```php +use GuzzleHttp\Psr7\StreamWrapper; + +$stream = GuzzleHttp\Psr7\stream_for('hello!'); +$resource = StreamWrapper::getResource($stream); +echo fread($resource, 6); // outputs hello! +``` + + +# Function API + +There are various functions available under the `GuzzleHttp\Psr7` namespace. + + +## `function str` + +`function str(MessageInterface $message)` + +Returns the string representation of an HTTP message. + +```php +$request = new GuzzleHttp\Psr7\Request('GET', 'http://example.com'); +echo GuzzleHttp\Psr7\str($request); +``` + + +## `function uri_for` + +`function uri_for($uri)` + +This function accepts a string or `Psr\Http\Message\UriInterface` and returns a +UriInterface for the given value. If the value is already a `UriInterface`, it +is returned as-is. + +```php +$uri = GuzzleHttp\Psr7\uri_for('http://example.com'); +assert($uri === GuzzleHttp\Psr7\uri_for($uri)); +``` + + +## `function stream_for` + +`function stream_for($resource = '', array $options = [])` + +Create a new stream based on the input type. + +Options is an associative array that can contain the following keys: + +* - metadata: Array of custom metadata. +* - size: Size of the stream. + +This method accepts the following `$resource` types: + +- `Psr\Http\Message\StreamInterface`: Returns the value as-is. +- `string`: Creates a stream object that uses the given string as the contents. +- `resource`: Creates a stream object that wraps the given PHP stream resource. +- `Iterator`: If the provided value implements `Iterator`, then a read-only + stream object will be created that wraps the given iterable. Each time the + stream is read from, data from the iterator will fill a buffer and will be + continuously called until the buffer is equal to the requested read size. + Subsequent read calls will first read from the buffer and then call `next` + on the underlying iterator until it is exhausted. +- `object` with `__toString()`: If the object has the `__toString()` method, + the object will be cast to a string and then a stream will be returned that + uses the string value. +- `NULL`: When `null` is passed, an empty stream object is returned. +- `callable` When a callable is passed, a read-only stream object will be + created that invokes the given callable. The callable is invoked with the + number of suggested bytes to read. The callable can return any number of + bytes, but MUST return `false` when there is no more data to return. The + stream object that wraps the callable will invoke the callable until the + number of requested bytes are available. Any additional bytes will be + buffered and used in subsequent reads. + +```php +$stream = GuzzleHttp\Psr7\stream_for('foo'); +$stream = GuzzleHttp\Psr7\stream_for(fopen('/path/to/file', 'r')); + +$generator function ($bytes) { + for ($i = 0; $i < $bytes; $i++) { + yield ' '; + } +} + +$stream = GuzzleHttp\Psr7\stream_for($generator(100)); +``` + + +## `function parse_header` + +`function parse_header($header)` + +Parse an array of header values containing ";" separated data into an array of +associative arrays representing the header key value pair data of the header. +When a parameter does not contain a value, but just contains a key, this +function will inject a key with a '' string value. + + +## `function normalize_header` + +`function normalize_header($header)` + +Converts an array of header values that may contain comma separated headers +into an array of headers with no comma separated values. + + +## `function modify_request` + +`function modify_request(RequestInterface $request, array $changes)` + +Clone and modify a request with the given changes. This method is useful for +reducing the number of clones needed to mutate a message. + +The changes can be one of: + +- method: (string) Changes the HTTP method. +- set_headers: (array) Sets the given headers. +- remove_headers: (array) Remove the given headers. +- body: (mixed) Sets the given body. +- uri: (UriInterface) Set the URI. +- query: (string) Set the query string value of the URI. +- version: (string) Set the protocol version. + + +## `function rewind_body` + +`function rewind_body(MessageInterface $message)` + +Attempts to rewind a message body and throws an exception on failure. The body +of the message will only be rewound if a call to `tell()` returns a value other +than `0`. + + +## `function try_fopen` + +`function try_fopen($filename, $mode)` + +Safely opens a PHP stream resource using a filename. + +When fopen fails, PHP normally raises a warning. This function adds an error +handler that checks for errors and throws an exception instead. + + +## `function copy_to_string` + +`function copy_to_string(StreamInterface $stream, $maxLen = -1)` + +Copy the contents of a stream into a string until the given number of bytes +have been read. + + +## `function copy_to_stream` + +`function copy_to_stream(StreamInterface $source, StreamInterface $dest, $maxLen = -1)` + +Copy the contents of a stream into another stream until the given number of +bytes have been read. + + +## `function hash` + +`function hash(StreamInterface $stream, $algo, $rawOutput = false)` + +Calculate a hash of a Stream. This method reads the entire stream to calculate +a rolling hash (based on PHP's hash_init functions). + + +## `function readline` + +`function readline(StreamInterface $stream, $maxLength = null)` + +Read a line from the stream up to the maximum allowed buffer length. + + +## `function parse_request` + +`function parse_request($message)` + +Parses a request message string into a request object. + + +## `function parse_response` + +`function parse_response($message)` + +Parses a response message string into a response object. + + +## `function parse_query` + +`function parse_query($str, $urlEncoding = true)` + +Parse a query string into an associative array. + +If multiple values are found for the same key, the value of that key value pair +will become an array. This function does not parse nested PHP style arrays into +an associative array (e.g., `foo[a]=1&foo[b]=2` will be parsed into +`['foo[a]' => '1', 'foo[b]' => '2']`). + + +## `function build_query` + +`function build_query(array $params, $encoding = PHP_QUERY_RFC3986)` + +Build a query string from an array of key value pairs. + +This function can use the return value of parse_query() to build a query string. +This function does not modify the provided keys when an array is encountered +(like http_build_query would). + + +## `function mimetype_from_filename` + +`function mimetype_from_filename($filename)` + +Determines the mimetype of a file by looking at its extension. + + +## `function mimetype_from_extension` + +`function mimetype_from_extension($extension)` + +Maps a file extensions to a mimetype. + + +# Additional URI Methods + +Aside from the standard `Psr\Http\Message\UriInterface` implementation in form of the `GuzzleHttp\Psr7\Uri` class, +this library also provides additional functionality when working with URIs as static methods. + +## URI Types + +An instance of `Psr\Http\Message\UriInterface` can either be an absolute URI or a relative reference. +An absolute URI has a scheme. A relative reference is used to express a URI relative to another URI, +the base URI. Relative references can be divided into several forms according to +[RFC 3986 Section 4.2](https://tools.ietf.org/html/rfc3986#section-4.2): + +- network-path references, e.g. `//example.com/path` +- absolute-path references, e.g. `/path` +- relative-path references, e.g. `subpath` + +The following methods can be used to identify the type of the URI. + +### `GuzzleHttp\Psr7\Uri::isAbsolute` + +`public static function isAbsolute(UriInterface $uri): bool` + +Whether the URI is absolute, i.e. it has a scheme. + +### `GuzzleHttp\Psr7\Uri::isNetworkPathReference` + +`public static function isNetworkPathReference(UriInterface $uri): bool` + +Whether the URI is a network-path reference. A relative reference that begins with two slash characters is +termed an network-path reference. + +### `GuzzleHttp\Psr7\Uri::isAbsolutePathReference` + +`public static function isAbsolutePathReference(UriInterface $uri): bool` + +Whether the URI is a absolute-path reference. A relative reference that begins with a single slash character is +termed an absolute-path reference. + +### `GuzzleHttp\Psr7\Uri::isRelativePathReference` + +`public static function isRelativePathReference(UriInterface $uri): bool` + +Whether the URI is a relative-path reference. A relative reference that does not begin with a slash character is +termed a relative-path reference. + +### `GuzzleHttp\Psr7\Uri::isSameDocumentReference` + +`public static function isSameDocumentReference(UriInterface $uri, UriInterface $base = null): bool` + +Whether the URI is a same-document reference. A same-document reference refers to a URI that is, aside from its +fragment component, identical to the base URI. When no base URI is given, only an empty URI reference +(apart from its fragment) is considered a same-document reference. + +## URI Components + +Additional methods to work with URI components. + +### `GuzzleHttp\Psr7\Uri::isDefaultPort` + +`public static function isDefaultPort(UriInterface $uri): bool` + +Whether the URI has the default port of the current scheme. `Psr\Http\Message\UriInterface::getPort` may return null +or the standard port. This method can be used independently of the implementation. + +### `GuzzleHttp\Psr7\Uri::composeComponents` + +`public static function composeComponents($scheme, $authority, $path, $query, $fragment): string` + +Composes a URI reference string from its various components according to +[RFC 3986 Section 5.3](https://tools.ietf.org/html/rfc3986#section-5.3). Usually this method does not need to be called +manually but instead is used indirectly via `Psr\Http\Message\UriInterface::__toString`. + +### `GuzzleHttp\Psr7\Uri::fromParts` + +`public static function fromParts(array $parts): UriInterface` + +Creates a URI from a hash of [`parse_url`](http://php.net/manual/en/function.parse-url.php) components. + + +### `GuzzleHttp\Psr7\Uri::withQueryValue` + +`public static function withQueryValue(UriInterface $uri, $key, $value): UriInterface` + +Creates a new URI with a specific query string value. Any existing query string values that exactly match the +provided key are removed and replaced with the given key value pair. A value of null will set the query string +key without a value, e.g. "key" instead of "key=value". + + +### `GuzzleHttp\Psr7\Uri::withoutQueryValue` + +`public static function withoutQueryValue(UriInterface $uri, $key): UriInterface` + +Creates a new URI with a specific query string value removed. Any existing query string values that exactly match the +provided key are removed. + +## Reference Resolution + +`GuzzleHttp\Psr7\UriResolver` provides methods to resolve a URI reference in the context of a base URI according +to [RFC 3986 Section 5](https://tools.ietf.org/html/rfc3986#section-5). This is for example also what web browsers +do when resolving a link in a website based on the current request URI. + +### `GuzzleHttp\Psr7\UriResolver::resolve` + +`public static function resolve(UriInterface $base, UriInterface $rel): UriInterface` + +Converts the relative URI into a new URI that is resolved against the base URI. + +### `GuzzleHttp\Psr7\UriResolver::removeDotSegments` + +`public static function removeDotSegments(string $path): string` + +Removes dot segments from a path and returns the new path according to +[RFC 3986 Section 5.2.4](https://tools.ietf.org/html/rfc3986#section-5.2.4). + +### `GuzzleHttp\Psr7\UriResolver::relativize` + +`public static function relativize(UriInterface $base, UriInterface $target): UriInterface` + +Returns the target URI as a relative reference from the base URI. This method is the counterpart to resolve(): + +```php +(string) $target === (string) UriResolver::resolve($base, UriResolver::relativize($base, $target)) +``` + +One use-case is to use the current request URI as base URI and then generate relative links in your documents +to reduce the document size or offer self-contained downloadable document archives. + +```php +$base = new Uri('http://example.com/a/b/'); +echo UriResolver::relativize($base, new Uri('http://example.com/a/b/c')); // prints 'c'. +echo UriResolver::relativize($base, new Uri('http://example.com/a/x/y')); // prints '../x/y'. +echo UriResolver::relativize($base, new Uri('http://example.com/a/b/?q')); // prints '?q'. +echo UriResolver::relativize($base, new Uri('http://example.org/a/b/')); // prints '//example.org/a/b/'. +``` + +## Normalization and Comparison + +`GuzzleHttp\Psr7\UriNormalizer` provides methods to normalize and compare URIs according to +[RFC 3986 Section 6](https://tools.ietf.org/html/rfc3986#section-6). + +### `GuzzleHttp\Psr7\UriNormalizer::normalize` + +`public static function normalize(UriInterface $uri, $flags = self::PRESERVING_NORMALIZATIONS): UriInterface` + +Returns a normalized URI. The scheme and host component are already normalized to lowercase per PSR-7 UriInterface. +This methods adds additional normalizations that can be configured with the `$flags` parameter which is a bitmask +of normalizations to apply. The following normalizations are available: + +- `UriNormalizer::PRESERVING_NORMALIZATIONS` + + Default normalizations which only include the ones that preserve semantics. + +- `UriNormalizer::CAPITALIZE_PERCENT_ENCODING` + + All letters within a percent-encoding triplet (e.g., "%3A") are case-insensitive, and should be capitalized. + + Example: `http://example.org/a%c2%b1b` → `http://example.org/a%C2%B1b` + +- `UriNormalizer::DECODE_UNRESERVED_CHARACTERS` + + Decodes percent-encoded octets of unreserved characters. For consistency, percent-encoded octets in the ranges of + ALPHA (%41–%5A and %61–%7A), DIGIT (%30–%39), hyphen (%2D), period (%2E), underscore (%5F), or tilde (%7E) should + not be created by URI producers and, when found in a URI, should be decoded to their corresponding unreserved + characters by URI normalizers. + + Example: `http://example.org/%7Eusern%61me/` → `http://example.org/~username/` + +- `UriNormalizer::CONVERT_EMPTY_PATH` + + Converts the empty path to "/" for http and https URIs. + + Example: `http://example.org` → `http://example.org/` + +- `UriNormalizer::REMOVE_DEFAULT_HOST` + + Removes the default host of the given URI scheme from the URI. Only the "file" scheme defines the default host + "localhost". All of `file:/myfile`, `file:///myfile`, and `file://localhost/myfile` are equivalent according to + RFC 3986. + + Example: `file://localhost/myfile` → `file:///myfile` + +- `UriNormalizer::REMOVE_DEFAULT_PORT` + + Removes the default port of the given URI scheme from the URI. + + Example: `http://example.org:80/` → `http://example.org/` + +- `UriNormalizer::REMOVE_DOT_SEGMENTS` + + Removes unnecessary dot-segments. Dot-segments in relative-path references are not removed as it would + change the semantics of the URI reference. + + Example: `http://example.org/../a/b/../c/./d.html` → `http://example.org/a/c/d.html` + +- `UriNormalizer::REMOVE_DUPLICATE_SLASHES` + + Paths which include two or more adjacent slashes are converted to one. Webservers usually ignore duplicate slashes + and treat those URIs equivalent. But in theory those URIs do not need to be equivalent. So this normalization + may change the semantics. Encoded slashes (%2F) are not removed. + + Example: `http://example.org//foo///bar.html` → `http://example.org/foo/bar.html` + +- `UriNormalizer::SORT_QUERY_PARAMETERS` + + Sort query parameters with their values in alphabetical order. However, the order of parameters in a URI may be + significant (this is not defined by the standard). So this normalization is not safe and may change the semantics + of the URI. + + Example: `?lang=en&article=fred` → `?article=fred&lang=en` + +### `GuzzleHttp\Psr7\UriNormalizer::isEquivalent` + +`public static function isEquivalent(UriInterface $uri1, UriInterface $uri2, $normalizations = self::PRESERVING_NORMALIZATIONS): bool` + +Whether two URIs can be considered equivalent. Both URIs are normalized automatically before comparison with the given +`$normalizations` bitmask. The method also accepts relative URI references and returns true when they are equivalent. +This of course assumes they will be resolved against the same base URI. If this is not the case, determination of +equivalence or difference of relative references does not mean anything. diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/composer.json b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/composer.json new file mode 100644 index 0000000..b1c5a90 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/composer.json @@ -0,0 +1,39 @@ +{ + "name": "guzzlehttp/psr7", + "type": "library", + "description": "PSR-7 message implementation that also provides common utility methods", + "keywords": ["request", "response", "message", "stream", "http", "uri", "url"], + "license": "MIT", + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "Tobias Schultze", + "homepage": "https://github.com/Tobion" + } + ], + "require": { + "php": ">=5.4.0", + "psr/http-message": "~1.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.0" + }, + "provide": { + "psr/http-message-implementation": "1.0" + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\Psr7\\": "src/" + }, + "files": ["src/functions_include.php"] + }, + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/AppendStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/AppendStream.php new file mode 100644 index 0000000..23039fd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/AppendStream.php @@ -0,0 +1,233 @@ +addStream($stream); + } + } + + public function __toString() + { + try { + $this->rewind(); + return $this->getContents(); + } catch (\Exception $e) { + return ''; + } + } + + /** + * Add a stream to the AppendStream + * + * @param StreamInterface $stream Stream to append. Must be readable. + * + * @throws \InvalidArgumentException if the stream is not readable + */ + public function addStream(StreamInterface $stream) + { + if (!$stream->isReadable()) { + throw new \InvalidArgumentException('Each stream must be readable'); + } + + // The stream is only seekable if all streams are seekable + if (!$stream->isSeekable()) { + $this->seekable = false; + } + + $this->streams[] = $stream; + } + + public function getContents() + { + return copy_to_string($this); + } + + /** + * Closes each attached stream. + * + * {@inheritdoc} + */ + public function close() + { + $this->pos = $this->current = 0; + + foreach ($this->streams as $stream) { + $stream->close(); + } + + $this->streams = []; + } + + /** + * Detaches each attached stream + * + * {@inheritdoc} + */ + public function detach() + { + $this->close(); + $this->detached = true; + } + + public function tell() + { + return $this->pos; + } + + /** + * Tries to calculate the size by adding the size of each stream. + * + * If any of the streams do not return a valid number, then the size of the + * append stream cannot be determined and null is returned. + * + * {@inheritdoc} + */ + public function getSize() + { + $size = 0; + + foreach ($this->streams as $stream) { + $s = $stream->getSize(); + if ($s === null) { + return null; + } + $size += $s; + } + + return $size; + } + + public function eof() + { + return !$this->streams || + ($this->current >= count($this->streams) - 1 && + $this->streams[$this->current]->eof()); + } + + public function rewind() + { + $this->seek(0); + } + + /** + * Attempts to seek to the given position. Only supports SEEK_SET. + * + * {@inheritdoc} + */ + public function seek($offset, $whence = SEEK_SET) + { + if (!$this->seekable) { + throw new \RuntimeException('This AppendStream is not seekable'); + } elseif ($whence !== SEEK_SET) { + throw new \RuntimeException('The AppendStream can only seek with SEEK_SET'); + } + + $this->pos = $this->current = 0; + + // Rewind each stream + foreach ($this->streams as $i => $stream) { + try { + $stream->rewind(); + } catch (\Exception $e) { + throw new \RuntimeException('Unable to seek stream ' + . $i . ' of the AppendStream', 0, $e); + } + } + + // Seek to the actual position by reading from each stream + while ($this->pos < $offset && !$this->eof()) { + $result = $this->read(min(8096, $offset - $this->pos)); + if ($result === '') { + break; + } + } + } + + /** + * Reads from all of the appended streams until the length is met or EOF. + * + * {@inheritdoc} + */ + public function read($length) + { + $buffer = ''; + $total = count($this->streams) - 1; + $remaining = $length; + $progressToNext = false; + + while ($remaining > 0) { + + // Progress to the next stream if needed. + if ($progressToNext || $this->streams[$this->current]->eof()) { + $progressToNext = false; + if ($this->current === $total) { + break; + } + $this->current++; + } + + $result = $this->streams[$this->current]->read($remaining); + + // Using a loose comparison here to match on '', false, and null + if ($result == null) { + $progressToNext = true; + continue; + } + + $buffer .= $result; + $remaining = $length - strlen($buffer); + } + + $this->pos += strlen($buffer); + + return $buffer; + } + + public function isReadable() + { + return true; + } + + public function isWritable() + { + return false; + } + + public function isSeekable() + { + return $this->seekable; + } + + public function write($string) + { + throw new \RuntimeException('Cannot write to an AppendStream'); + } + + public function getMetadata($key = null) + { + return $key ? null : []; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/BufferStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/BufferStream.php new file mode 100644 index 0000000..af4d4c2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/BufferStream.php @@ -0,0 +1,137 @@ +hwm = $hwm; + } + + public function __toString() + { + return $this->getContents(); + } + + public function getContents() + { + $buffer = $this->buffer; + $this->buffer = ''; + + return $buffer; + } + + public function close() + { + $this->buffer = ''; + } + + public function detach() + { + $this->close(); + } + + public function getSize() + { + return strlen($this->buffer); + } + + public function isReadable() + { + return true; + } + + public function isWritable() + { + return true; + } + + public function isSeekable() + { + return false; + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + throw new \RuntimeException('Cannot seek a BufferStream'); + } + + public function eof() + { + return strlen($this->buffer) === 0; + } + + public function tell() + { + throw new \RuntimeException('Cannot determine the position of a BufferStream'); + } + + /** + * Reads data from the buffer. + */ + public function read($length) + { + $currentLength = strlen($this->buffer); + + if ($length >= $currentLength) { + // No need to slice the buffer because we don't have enough data. + $result = $this->buffer; + $this->buffer = ''; + } else { + // Slice up the result to provide a subset of the buffer. + $result = substr($this->buffer, 0, $length); + $this->buffer = substr($this->buffer, $length); + } + + return $result; + } + + /** + * Writes data to the buffer. + */ + public function write($string) + { + $this->buffer .= $string; + + // TODO: What should happen here? + if (strlen($this->buffer) >= $this->hwm) { + return false; + } + + return strlen($string); + } + + public function getMetadata($key = null) + { + if ($key == 'hwm') { + return $this->hwm; + } + + return $key ? null : []; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/CachingStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/CachingStream.php new file mode 100644 index 0000000..ed68f08 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/CachingStream.php @@ -0,0 +1,138 @@ +remoteStream = $stream; + $this->stream = $target ?: new Stream(fopen('php://temp', 'r+')); + } + + public function getSize() + { + return max($this->stream->getSize(), $this->remoteStream->getSize()); + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + if ($whence == SEEK_SET) { + $byte = $offset; + } elseif ($whence == SEEK_CUR) { + $byte = $offset + $this->tell(); + } elseif ($whence == SEEK_END) { + $size = $this->remoteStream->getSize(); + if ($size === null) { + $size = $this->cacheEntireStream(); + } + $byte = $size + $offset; + } else { + throw new \InvalidArgumentException('Invalid whence'); + } + + $diff = $byte - $this->stream->getSize(); + + if ($diff > 0) { + // Read the remoteStream until we have read in at least the amount + // of bytes requested, or we reach the end of the file. + while ($diff > 0 && !$this->remoteStream->eof()) { + $this->read($diff); + $diff = $byte - $this->stream->getSize(); + } + } else { + // We can just do a normal seek since we've already seen this byte. + $this->stream->seek($byte); + } + } + + public function read($length) + { + // Perform a regular read on any previously read data from the buffer + $data = $this->stream->read($length); + $remaining = $length - strlen($data); + + // More data was requested so read from the remote stream + if ($remaining) { + // If data was written to the buffer in a position that would have + // been filled from the remote stream, then we must skip bytes on + // the remote stream to emulate overwriting bytes from that + // position. This mimics the behavior of other PHP stream wrappers. + $remoteData = $this->remoteStream->read( + $remaining + $this->skipReadBytes + ); + + if ($this->skipReadBytes) { + $len = strlen($remoteData); + $remoteData = substr($remoteData, $this->skipReadBytes); + $this->skipReadBytes = max(0, $this->skipReadBytes - $len); + } + + $data .= $remoteData; + $this->stream->write($remoteData); + } + + return $data; + } + + public function write($string) + { + // When appending to the end of the currently read stream, you'll want + // to skip bytes from being read from the remote stream to emulate + // other stream wrappers. Basically replacing bytes of data of a fixed + // length. + $overflow = (strlen($string) + $this->tell()) - $this->remoteStream->tell(); + if ($overflow > 0) { + $this->skipReadBytes += $overflow; + } + + return $this->stream->write($string); + } + + public function eof() + { + return $this->stream->eof() && $this->remoteStream->eof(); + } + + /** + * Close both the remote stream and buffer stream + */ + public function close() + { + $this->remoteStream->close() && $this->stream->close(); + } + + private function cacheEntireStream() + { + $target = new FnStream(['write' => 'strlen']); + copy_to_stream($this, $target); + + return $this->tell(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/DroppingStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/DroppingStream.php new file mode 100644 index 0000000..8935c80 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/DroppingStream.php @@ -0,0 +1,42 @@ +stream = $stream; + $this->maxLength = $maxLength; + } + + public function write($string) + { + $diff = $this->maxLength - $this->stream->getSize(); + + // Begin returning 0 when the underlying stream is too large. + if ($diff <= 0) { + return 0; + } + + // Write the stream or a subset of the stream if needed. + if (strlen($string) < $diff) { + return $this->stream->write($string); + } + + return $this->stream->write(substr($string, 0, $diff)); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/FnStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/FnStream.php new file mode 100644 index 0000000..cc9b445 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/FnStream.php @@ -0,0 +1,149 @@ +methods = $methods; + + // Create the functions on the class + foreach ($methods as $name => $fn) { + $this->{'_fn_' . $name} = $fn; + } + } + + /** + * Lazily determine which methods are not implemented. + * @throws \BadMethodCallException + */ + public function __get($name) + { + throw new \BadMethodCallException(str_replace('_fn_', '', $name) + . '() is not implemented in the FnStream'); + } + + /** + * The close method is called on the underlying stream only if possible. + */ + public function __destruct() + { + if (isset($this->_fn_close)) { + call_user_func($this->_fn_close); + } + } + + /** + * Adds custom functionality to an underlying stream by intercepting + * specific method calls. + * + * @param StreamInterface $stream Stream to decorate + * @param array $methods Hash of method name to a closure + * + * @return FnStream + */ + public static function decorate(StreamInterface $stream, array $methods) + { + // If any of the required methods were not provided, then simply + // proxy to the decorated stream. + foreach (array_diff(self::$slots, array_keys($methods)) as $diff) { + $methods[$diff] = [$stream, $diff]; + } + + return new self($methods); + } + + public function __toString() + { + return call_user_func($this->_fn___toString); + } + + public function close() + { + return call_user_func($this->_fn_close); + } + + public function detach() + { + return call_user_func($this->_fn_detach); + } + + public function getSize() + { + return call_user_func($this->_fn_getSize); + } + + public function tell() + { + return call_user_func($this->_fn_tell); + } + + public function eof() + { + return call_user_func($this->_fn_eof); + } + + public function isSeekable() + { + return call_user_func($this->_fn_isSeekable); + } + + public function rewind() + { + call_user_func($this->_fn_rewind); + } + + public function seek($offset, $whence = SEEK_SET) + { + call_user_func($this->_fn_seek, $offset, $whence); + } + + public function isWritable() + { + return call_user_func($this->_fn_isWritable); + } + + public function write($string) + { + return call_user_func($this->_fn_write, $string); + } + + public function isReadable() + { + return call_user_func($this->_fn_isReadable); + } + + public function read($length) + { + return call_user_func($this->_fn_read, $length); + } + + public function getContents() + { + return call_user_func($this->_fn_getContents); + } + + public function getMetadata($key = null) + { + return call_user_func($this->_fn_getMetadata, $key); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/InflateStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/InflateStream.php new file mode 100644 index 0000000..0051d3f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/InflateStream.php @@ -0,0 +1,52 @@ +read(10); + $filenameHeaderLength = $this->getLengthOfPossibleFilenameHeader($stream, $header); + // Skip the header, that is 10 + length of filename + 1 (nil) bytes + $stream = new LimitStream($stream, -1, 10 + $filenameHeaderLength); + $resource = StreamWrapper::getResource($stream); + stream_filter_append($resource, 'zlib.inflate', STREAM_FILTER_READ); + $this->stream = new Stream($resource); + } + + /** + * @param StreamInterface $stream + * @param $header + * @return int + */ + private function getLengthOfPossibleFilenameHeader(StreamInterface $stream, $header) + { + $filename_header_length = 0; + + if (substr(bin2hex($header), 6, 2) === '08') { + // we have a filename, read until nil + $filename_header_length = 1; + while ($stream->read(1) !== chr(0)) { + $filename_header_length++; + } + } + + return $filename_header_length; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/LazyOpenStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/LazyOpenStream.php new file mode 100644 index 0000000..02cec3a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/LazyOpenStream.php @@ -0,0 +1,39 @@ +filename = $filename; + $this->mode = $mode; + } + + /** + * Creates the underlying stream lazily when required. + * + * @return StreamInterface + */ + protected function createStream() + { + return stream_for(try_fopen($this->filename, $this->mode)); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/LimitStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/LimitStream.php new file mode 100644 index 0000000..3c13d4f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/LimitStream.php @@ -0,0 +1,155 @@ +stream = $stream; + $this->setLimit($limit); + $this->setOffset($offset); + } + + public function eof() + { + // Always return true if the underlying stream is EOF + if ($this->stream->eof()) { + return true; + } + + // No limit and the underlying stream is not at EOF + if ($this->limit == -1) { + return false; + } + + return $this->stream->tell() >= $this->offset + $this->limit; + } + + /** + * Returns the size of the limited subset of data + * {@inheritdoc} + */ + public function getSize() + { + if (null === ($length = $this->stream->getSize())) { + return null; + } elseif ($this->limit == -1) { + return $length - $this->offset; + } else { + return min($this->limit, $length - $this->offset); + } + } + + /** + * Allow for a bounded seek on the read limited stream + * {@inheritdoc} + */ + public function seek($offset, $whence = SEEK_SET) + { + if ($whence !== SEEK_SET || $offset < 0) { + throw new \RuntimeException(sprintf( + 'Cannot seek to offset % with whence %s', + $offset, + $whence + )); + } + + $offset += $this->offset; + + if ($this->limit !== -1) { + if ($offset > $this->offset + $this->limit) { + $offset = $this->offset + $this->limit; + } + } + + $this->stream->seek($offset); + } + + /** + * Give a relative tell() + * {@inheritdoc} + */ + public function tell() + { + return $this->stream->tell() - $this->offset; + } + + /** + * Set the offset to start limiting from + * + * @param int $offset Offset to seek to and begin byte limiting from + * + * @throws \RuntimeException if the stream cannot be seeked. + */ + public function setOffset($offset) + { + $current = $this->stream->tell(); + + if ($current !== $offset) { + // If the stream cannot seek to the offset position, then read to it + if ($this->stream->isSeekable()) { + $this->stream->seek($offset); + } elseif ($current > $offset) { + throw new \RuntimeException("Could not seek to stream offset $offset"); + } else { + $this->stream->read($offset - $current); + } + } + + $this->offset = $offset; + } + + /** + * Set the limit of bytes that the decorator allows to be read from the + * stream. + * + * @param int $limit Number of bytes to allow to be read from the stream. + * Use -1 for no limit. + */ + public function setLimit($limit) + { + $this->limit = $limit; + } + + public function read($length) + { + if ($this->limit == -1) { + return $this->stream->read($length); + } + + // Check if the current position is less than the total allowed + // bytes + original offset + $remaining = ($this->offset + $this->limit) - $this->stream->tell(); + if ($remaining > 0) { + // Only return the amount of requested data, ensuring that the byte + // limit is not exceeded + return $this->stream->read(min($remaining, $length)); + } + + return ''; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/MessageTrait.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/MessageTrait.php new file mode 100644 index 0000000..1e4da64 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/MessageTrait.php @@ -0,0 +1,183 @@ + array of values */ + private $headers = []; + + /** @var array Map of lowercase header name => original name at registration */ + private $headerNames = []; + + /** @var string */ + private $protocol = '1.1'; + + /** @var StreamInterface */ + private $stream; + + public function getProtocolVersion() + { + return $this->protocol; + } + + public function withProtocolVersion($version) + { + if ($this->protocol === $version) { + return $this; + } + + $new = clone $this; + $new->protocol = $version; + return $new; + } + + public function getHeaders() + { + return $this->headers; + } + + public function hasHeader($header) + { + return isset($this->headerNames[strtolower($header)]); + } + + public function getHeader($header) + { + $header = strtolower($header); + + if (!isset($this->headerNames[$header])) { + return []; + } + + $header = $this->headerNames[$header]; + + return $this->headers[$header]; + } + + public function getHeaderLine($header) + { + return implode(', ', $this->getHeader($header)); + } + + public function withHeader($header, $value) + { + if (!is_array($value)) { + $value = [$value]; + } + + $value = $this->trimHeaderValues($value); + $normalized = strtolower($header); + + $new = clone $this; + if (isset($new->headerNames[$normalized])) { + unset($new->headers[$new->headerNames[$normalized]]); + } + $new->headerNames[$normalized] = $header; + $new->headers[$header] = $value; + + return $new; + } + + public function withAddedHeader($header, $value) + { + if (!is_array($value)) { + $value = [$value]; + } + + $value = $this->trimHeaderValues($value); + $normalized = strtolower($header); + + $new = clone $this; + if (isset($new->headerNames[$normalized])) { + $header = $this->headerNames[$normalized]; + $new->headers[$header] = array_merge($this->headers[$header], $value); + } else { + $new->headerNames[$normalized] = $header; + $new->headers[$header] = $value; + } + + return $new; + } + + public function withoutHeader($header) + { + $normalized = strtolower($header); + + if (!isset($this->headerNames[$normalized])) { + return $this; + } + + $header = $this->headerNames[$normalized]; + + $new = clone $this; + unset($new->headers[$header], $new->headerNames[$normalized]); + + return $new; + } + + public function getBody() + { + if (!$this->stream) { + $this->stream = stream_for(''); + } + + return $this->stream; + } + + public function withBody(StreamInterface $body) + { + if ($body === $this->stream) { + return $this; + } + + $new = clone $this; + $new->stream = $body; + return $new; + } + + private function setHeaders(array $headers) + { + $this->headerNames = $this->headers = []; + foreach ($headers as $header => $value) { + if (!is_array($value)) { + $value = [$value]; + } + + $value = $this->trimHeaderValues($value); + $normalized = strtolower($header); + if (isset($this->headerNames[$normalized])) { + $header = $this->headerNames[$normalized]; + $this->headers[$header] = array_merge($this->headers[$header], $value); + } else { + $this->headerNames[$normalized] = $header; + $this->headers[$header] = $value; + } + } + } + + /** + * Trims whitespace from the header values. + * + * Spaces and tabs ought to be excluded by parsers when extracting the field value from a header field. + * + * header-field = field-name ":" OWS field-value OWS + * OWS = *( SP / HTAB ) + * + * @param string[] $values Header values + * + * @return string[] Trimmed header values + * + * @see https://tools.ietf.org/html/rfc7230#section-3.2.4 + */ + private function trimHeaderValues(array $values) + { + return array_map(function ($value) { + return trim($value, " \t"); + }, $values); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/MultipartStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/MultipartStream.php new file mode 100644 index 0000000..c0fd584 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/MultipartStream.php @@ -0,0 +1,153 @@ +boundary = $boundary ?: sha1(uniqid('', true)); + $this->stream = $this->createStream($elements); + } + + /** + * Get the boundary + * + * @return string + */ + public function getBoundary() + { + return $this->boundary; + } + + public function isWritable() + { + return false; + } + + /** + * Get the headers needed before transferring the content of a POST file + */ + private function getHeaders(array $headers) + { + $str = ''; + foreach ($headers as $key => $value) { + $str .= "{$key}: {$value}\r\n"; + } + + return "--{$this->boundary}\r\n" . trim($str) . "\r\n\r\n"; + } + + /** + * Create the aggregate stream that will be used to upload the POST data + */ + protected function createStream(array $elements) + { + $stream = new AppendStream(); + + foreach ($elements as $element) { + $this->addElement($stream, $element); + } + + // Add the trailing boundary with CRLF + $stream->addStream(stream_for("--{$this->boundary}--\r\n")); + + return $stream; + } + + private function addElement(AppendStream $stream, array $element) + { + foreach (['contents', 'name'] as $key) { + if (!array_key_exists($key, $element)) { + throw new \InvalidArgumentException("A '{$key}' key is required"); + } + } + + $element['contents'] = stream_for($element['contents']); + + if (empty($element['filename'])) { + $uri = $element['contents']->getMetadata('uri'); + if (substr($uri, 0, 6) !== 'php://') { + $element['filename'] = $uri; + } + } + + list($body, $headers) = $this->createElement( + $element['name'], + $element['contents'], + isset($element['filename']) ? $element['filename'] : null, + isset($element['headers']) ? $element['headers'] : [] + ); + + $stream->addStream(stream_for($this->getHeaders($headers))); + $stream->addStream($body); + $stream->addStream(stream_for("\r\n")); + } + + /** + * @return array + */ + private function createElement($name, StreamInterface $stream, $filename, array $headers) + { + // Set a default content-disposition header if one was no provided + $disposition = $this->getHeader($headers, 'content-disposition'); + if (!$disposition) { + $headers['Content-Disposition'] = ($filename === '0' || $filename) + ? sprintf('form-data; name="%s"; filename="%s"', + $name, + basename($filename)) + : "form-data; name=\"{$name}\""; + } + + // Set a default content-length header if one was no provided + $length = $this->getHeader($headers, 'content-length'); + if (!$length) { + if ($length = $stream->getSize()) { + $headers['Content-Length'] = (string) $length; + } + } + + // Set a default Content-Type if one was not supplied + $type = $this->getHeader($headers, 'content-type'); + if (!$type && ($filename === '0' || $filename)) { + if ($type = mimetype_from_filename($filename)) { + $headers['Content-Type'] = $type; + } + } + + return [$stream, $headers]; + } + + private function getHeader(array $headers, $key) + { + $lowercaseHeader = strtolower($key); + foreach ($headers as $k => $v) { + if (strtolower($k) === $lowercaseHeader) { + return $v; + } + } + + return null; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/NoSeekStream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/NoSeekStream.php new file mode 100644 index 0000000..2332218 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/NoSeekStream.php @@ -0,0 +1,22 @@ +source = $source; + $this->size = isset($options['size']) ? $options['size'] : null; + $this->metadata = isset($options['metadata']) ? $options['metadata'] : []; + $this->buffer = new BufferStream(); + } + + public function __toString() + { + try { + return copy_to_string($this); + } catch (\Exception $e) { + return ''; + } + } + + public function close() + { + $this->detach(); + } + + public function detach() + { + $this->tellPos = false; + $this->source = null; + } + + public function getSize() + { + return $this->size; + } + + public function tell() + { + return $this->tellPos; + } + + public function eof() + { + return !$this->source; + } + + public function isSeekable() + { + return false; + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + throw new \RuntimeException('Cannot seek a PumpStream'); + } + + public function isWritable() + { + return false; + } + + public function write($string) + { + throw new \RuntimeException('Cannot write to a PumpStream'); + } + + public function isReadable() + { + return true; + } + + public function read($length) + { + $data = $this->buffer->read($length); + $readLen = strlen($data); + $this->tellPos += $readLen; + $remaining = $length - $readLen; + + if ($remaining) { + $this->pump($remaining); + $data .= $this->buffer->read($remaining); + $this->tellPos += strlen($data) - $readLen; + } + + return $data; + } + + public function getContents() + { + $result = ''; + while (!$this->eof()) { + $result .= $this->read(1000000); + } + + return $result; + } + + public function getMetadata($key = null) + { + if (!$key) { + return $this->metadata; + } + + return isset($this->metadata[$key]) ? $this->metadata[$key] : null; + } + + private function pump($length) + { + if ($this->source) { + do { + $data = call_user_func($this->source, $length); + if ($data === false || $data === null) { + $this->source = null; + return; + } + $this->buffer->write($data); + $length -= strlen($data); + } while ($length > 0); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Request.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Request.php new file mode 100644 index 0000000..0828548 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Request.php @@ -0,0 +1,142 @@ +method = strtoupper($method); + $this->uri = $uri; + $this->setHeaders($headers); + $this->protocol = $version; + + if (!$this->hasHeader('Host')) { + $this->updateHostFromUri(); + } + + if ($body !== '' && $body !== null) { + $this->stream = stream_for($body); + } + } + + public function getRequestTarget() + { + if ($this->requestTarget !== null) { + return $this->requestTarget; + } + + $target = $this->uri->getPath(); + if ($target == '') { + $target = '/'; + } + if ($this->uri->getQuery() != '') { + $target .= '?' . $this->uri->getQuery(); + } + + return $target; + } + + public function withRequestTarget($requestTarget) + { + if (preg_match('#\s#', $requestTarget)) { + throw new InvalidArgumentException( + 'Invalid request target provided; cannot contain whitespace' + ); + } + + $new = clone $this; + $new->requestTarget = $requestTarget; + return $new; + } + + public function getMethod() + { + return $this->method; + } + + public function withMethod($method) + { + $new = clone $this; + $new->method = strtoupper($method); + return $new; + } + + public function getUri() + { + return $this->uri; + } + + public function withUri(UriInterface $uri, $preserveHost = false) + { + if ($uri === $this->uri) { + return $this; + } + + $new = clone $this; + $new->uri = $uri; + + if (!$preserveHost) { + $new->updateHostFromUri(); + } + + return $new; + } + + private function updateHostFromUri() + { + $host = $this->uri->getHost(); + + if ($host == '') { + return; + } + + if (($port = $this->uri->getPort()) !== null) { + $host .= ':' . $port; + } + + if (isset($this->headerNames['host'])) { + $header = $this->headerNames['host']; + } else { + $header = 'Host'; + $this->headerNames['host'] = 'Host'; + } + // Ensure Host is the first header. + // See: http://tools.ietf.org/html/rfc7230#section-5.4 + $this->headers = [$header => [$host]] + $this->headers; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Response.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Response.php new file mode 100644 index 0000000..2830c6c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Response.php @@ -0,0 +1,132 @@ + 'Continue', + 101 => 'Switching Protocols', + 102 => 'Processing', + 200 => 'OK', + 201 => 'Created', + 202 => 'Accepted', + 203 => 'Non-Authoritative Information', + 204 => 'No Content', + 205 => 'Reset Content', + 206 => 'Partial Content', + 207 => 'Multi-status', + 208 => 'Already Reported', + 300 => 'Multiple Choices', + 301 => 'Moved Permanently', + 302 => 'Found', + 303 => 'See Other', + 304 => 'Not Modified', + 305 => 'Use Proxy', + 306 => 'Switch Proxy', + 307 => 'Temporary Redirect', + 400 => 'Bad Request', + 401 => 'Unauthorized', + 402 => 'Payment Required', + 403 => 'Forbidden', + 404 => 'Not Found', + 405 => 'Method Not Allowed', + 406 => 'Not Acceptable', + 407 => 'Proxy Authentication Required', + 408 => 'Request Time-out', + 409 => 'Conflict', + 410 => 'Gone', + 411 => 'Length Required', + 412 => 'Precondition Failed', + 413 => 'Request Entity Too Large', + 414 => 'Request-URI Too Large', + 415 => 'Unsupported Media Type', + 416 => 'Requested range not satisfiable', + 417 => 'Expectation Failed', + 418 => 'I\'m a teapot', + 422 => 'Unprocessable Entity', + 423 => 'Locked', + 424 => 'Failed Dependency', + 425 => 'Unordered Collection', + 426 => 'Upgrade Required', + 428 => 'Precondition Required', + 429 => 'Too Many Requests', + 431 => 'Request Header Fields Too Large', + 451 => 'Unavailable For Legal Reasons', + 500 => 'Internal Server Error', + 501 => 'Not Implemented', + 502 => 'Bad Gateway', + 503 => 'Service Unavailable', + 504 => 'Gateway Time-out', + 505 => 'HTTP Version not supported', + 506 => 'Variant Also Negotiates', + 507 => 'Insufficient Storage', + 508 => 'Loop Detected', + 511 => 'Network Authentication Required', + ]; + + /** @var string */ + private $reasonPhrase = ''; + + /** @var int */ + private $statusCode = 200; + + /** + * @param int $status Status code + * @param array $headers Response headers + * @param string|null|resource|StreamInterface $body Response body + * @param string $version Protocol version + * @param string|null $reason Reason phrase (when empty a default will be used based on the status code) + */ + public function __construct( + $status = 200, + array $headers = [], + $body = null, + $version = '1.1', + $reason = null + ) { + $this->statusCode = (int) $status; + + if ($body !== '' && $body !== null) { + $this->stream = stream_for($body); + } + + $this->setHeaders($headers); + if ($reason == '' && isset(self::$phrases[$this->statusCode])) { + $this->reasonPhrase = self::$phrases[$this->statusCode]; + } else { + $this->reasonPhrase = (string) $reason; + } + + $this->protocol = $version; + } + + public function getStatusCode() + { + return $this->statusCode; + } + + public function getReasonPhrase() + { + return $this->reasonPhrase; + } + + public function withStatus($code, $reasonPhrase = '') + { + $new = clone $this; + $new->statusCode = (int) $code; + if ($reasonPhrase == '' && isset(self::$phrases[$new->statusCode])) { + $reasonPhrase = self::$phrases[$new->statusCode]; + } + $new->reasonPhrase = $reasonPhrase; + return $new; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/ServerRequest.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/ServerRequest.php new file mode 100644 index 0000000..575aab8 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/ServerRequest.php @@ -0,0 +1,358 @@ +serverParams = $serverParams; + + parent::__construct($method, $uri, $headers, $body, $version); + } + + /** + * Return an UploadedFile instance array. + * + * @param array $files A array which respect $_FILES structure + * @throws InvalidArgumentException for unrecognized values + * @return array + */ + public static function normalizeFiles(array $files) + { + $normalized = []; + + foreach ($files as $key => $value) { + if ($value instanceof UploadedFileInterface) { + $normalized[$key] = $value; + } elseif (is_array($value) && isset($value['tmp_name'])) { + $normalized[$key] = self::createUploadedFileFromSpec($value); + } elseif (is_array($value)) { + $normalized[$key] = self::normalizeFiles($value); + continue; + } else { + throw new InvalidArgumentException('Invalid value in files specification'); + } + } + + return $normalized; + } + + /** + * Create and return an UploadedFile instance from a $_FILES specification. + * + * If the specification represents an array of values, this method will + * delegate to normalizeNestedFileSpec() and return that return value. + * + * @param array $value $_FILES struct + * @return array|UploadedFileInterface + */ + private static function createUploadedFileFromSpec(array $value) + { + if (is_array($value['tmp_name'])) { + return self::normalizeNestedFileSpec($value); + } + + return new UploadedFile( + $value['tmp_name'], + (int) $value['size'], + (int) $value['error'], + $value['name'], + $value['type'] + ); + } + + /** + * Normalize an array of file specifications. + * + * Loops through all nested files and returns a normalized array of + * UploadedFileInterface instances. + * + * @param array $files + * @return UploadedFileInterface[] + */ + private static function normalizeNestedFileSpec(array $files = []) + { + $normalizedFiles = []; + + foreach (array_keys($files['tmp_name']) as $key) { + $spec = [ + 'tmp_name' => $files['tmp_name'][$key], + 'size' => $files['size'][$key], + 'error' => $files['error'][$key], + 'name' => $files['name'][$key], + 'type' => $files['type'][$key], + ]; + $normalizedFiles[$key] = self::createUploadedFileFromSpec($spec); + } + + return $normalizedFiles; + } + + /** + * Return a ServerRequest populated with superglobals: + * $_GET + * $_POST + * $_COOKIE + * $_FILES + * $_SERVER + * + * @return ServerRequestInterface + */ + public static function fromGlobals() + { + $method = isset($_SERVER['REQUEST_METHOD']) ? $_SERVER['REQUEST_METHOD'] : 'GET'; + $headers = function_exists('getallheaders') ? getallheaders() : []; + $uri = self::getUriFromGlobals(); + $body = new LazyOpenStream('php://input', 'r+'); + $protocol = isset($_SERVER['SERVER_PROTOCOL']) ? str_replace('HTTP/', '', $_SERVER['SERVER_PROTOCOL']) : '1.1'; + + $serverRequest = new ServerRequest($method, $uri, $headers, $body, $protocol, $_SERVER); + + return $serverRequest + ->withCookieParams($_COOKIE) + ->withQueryParams($_GET) + ->withParsedBody($_POST) + ->withUploadedFiles(self::normalizeFiles($_FILES)); + } + + /** + * Get a Uri populated with values from $_SERVER. + * + * @return UriInterface + */ + public static function getUriFromGlobals() { + $uri = new Uri(''); + + $uri = $uri->withScheme(!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off' ? 'https' : 'http'); + + $hasPort = false; + if (isset($_SERVER['HTTP_HOST'])) { + $hostHeaderParts = explode(':', $_SERVER['HTTP_HOST']); + $uri = $uri->withHost($hostHeaderParts[0]); + if (isset($hostHeaderParts[1])) { + $hasPort = true; + $uri = $uri->withPort($hostHeaderParts[1]); + } + } elseif (isset($_SERVER['SERVER_NAME'])) { + $uri = $uri->withHost($_SERVER['SERVER_NAME']); + } elseif (isset($_SERVER['SERVER_ADDR'])) { + $uri = $uri->withHost($_SERVER['SERVER_ADDR']); + } + + if (!$hasPort && isset($_SERVER['SERVER_PORT'])) { + $uri = $uri->withPort($_SERVER['SERVER_PORT']); + } + + $hasQuery = false; + if (isset($_SERVER['REQUEST_URI'])) { + $requestUriParts = explode('?', $_SERVER['REQUEST_URI']); + $uri = $uri->withPath($requestUriParts[0]); + if (isset($requestUriParts[1])) { + $hasQuery = true; + $uri = $uri->withQuery($requestUriParts[1]); + } + } + + if (!$hasQuery && isset($_SERVER['QUERY_STRING'])) { + $uri = $uri->withQuery($_SERVER['QUERY_STRING']); + } + + return $uri; + } + + + /** + * {@inheritdoc} + */ + public function getServerParams() + { + return $this->serverParams; + } + + /** + * {@inheritdoc} + */ + public function getUploadedFiles() + { + return $this->uploadedFiles; + } + + /** + * {@inheritdoc} + */ + public function withUploadedFiles(array $uploadedFiles) + { + $new = clone $this; + $new->uploadedFiles = $uploadedFiles; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getCookieParams() + { + return $this->cookieParams; + } + + /** + * {@inheritdoc} + */ + public function withCookieParams(array $cookies) + { + $new = clone $this; + $new->cookieParams = $cookies; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getQueryParams() + { + return $this->queryParams; + } + + /** + * {@inheritdoc} + */ + public function withQueryParams(array $query) + { + $new = clone $this; + $new->queryParams = $query; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getParsedBody() + { + return $this->parsedBody; + } + + /** + * {@inheritdoc} + */ + public function withParsedBody($data) + { + $new = clone $this; + $new->parsedBody = $data; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getAttributes() + { + return $this->attributes; + } + + /** + * {@inheritdoc} + */ + public function getAttribute($attribute, $default = null) + { + if (false === array_key_exists($attribute, $this->attributes)) { + return $default; + } + + return $this->attributes[$attribute]; + } + + /** + * {@inheritdoc} + */ + public function withAttribute($attribute, $value) + { + $new = clone $this; + $new->attributes[$attribute] = $value; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function withoutAttribute($attribute) + { + if (false === array_key_exists($attribute, $this->attributes)) { + return $this; + } + + $new = clone $this; + unset($new->attributes[$attribute]); + + return $new; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Stream.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Stream.php new file mode 100644 index 0000000..e336628 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Stream.php @@ -0,0 +1,257 @@ + [ + 'r' => true, 'w+' => true, 'r+' => true, 'x+' => true, 'c+' => true, + 'rb' => true, 'w+b' => true, 'r+b' => true, 'x+b' => true, + 'c+b' => true, 'rt' => true, 'w+t' => true, 'r+t' => true, + 'x+t' => true, 'c+t' => true, 'a+' => true + ], + 'write' => [ + 'w' => true, 'w+' => true, 'rw' => true, 'r+' => true, 'x+' => true, + 'c+' => true, 'wb' => true, 'w+b' => true, 'r+b' => true, + 'x+b' => true, 'c+b' => true, 'w+t' => true, 'r+t' => true, + 'x+t' => true, 'c+t' => true, 'a' => true, 'a+' => true + ] + ]; + + /** + * This constructor accepts an associative array of options. + * + * - size: (int) If a read stream would otherwise have an indeterminate + * size, but the size is known due to foreknowledge, then you can + * provide that size, in bytes. + * - metadata: (array) Any additional metadata to return when the metadata + * of the stream is accessed. + * + * @param resource $stream Stream resource to wrap. + * @param array $options Associative array of options. + * + * @throws \InvalidArgumentException if the stream is not a stream resource + */ + public function __construct($stream, $options = []) + { + if (!is_resource($stream)) { + throw new \InvalidArgumentException('Stream must be a resource'); + } + + if (isset($options['size'])) { + $this->size = $options['size']; + } + + $this->customMetadata = isset($options['metadata']) + ? $options['metadata'] + : []; + + $this->stream = $stream; + $meta = stream_get_meta_data($this->stream); + $this->seekable = $meta['seekable']; + $this->readable = isset(self::$readWriteHash['read'][$meta['mode']]); + $this->writable = isset(self::$readWriteHash['write'][$meta['mode']]); + $this->uri = $this->getMetadata('uri'); + } + + public function __get($name) + { + if ($name == 'stream') { + throw new \RuntimeException('The stream is detached'); + } + + throw new \BadMethodCallException('No value for ' . $name); + } + + /** + * Closes the stream when the destructed + */ + public function __destruct() + { + $this->close(); + } + + public function __toString() + { + try { + $this->seek(0); + return (string) stream_get_contents($this->stream); + } catch (\Exception $e) { + return ''; + } + } + + public function getContents() + { + $contents = stream_get_contents($this->stream); + + if ($contents === false) { + throw new \RuntimeException('Unable to read stream contents'); + } + + return $contents; + } + + public function close() + { + if (isset($this->stream)) { + if (is_resource($this->stream)) { + fclose($this->stream); + } + $this->detach(); + } + } + + public function detach() + { + if (!isset($this->stream)) { + return null; + } + + $result = $this->stream; + unset($this->stream); + $this->size = $this->uri = null; + $this->readable = $this->writable = $this->seekable = false; + + return $result; + } + + public function getSize() + { + if ($this->size !== null) { + return $this->size; + } + + if (!isset($this->stream)) { + return null; + } + + // Clear the stat cache if the stream has a URI + if ($this->uri) { + clearstatcache(true, $this->uri); + } + + $stats = fstat($this->stream); + if (isset($stats['size'])) { + $this->size = $stats['size']; + return $this->size; + } + + return null; + } + + public function isReadable() + { + return $this->readable; + } + + public function isWritable() + { + return $this->writable; + } + + public function isSeekable() + { + return $this->seekable; + } + + public function eof() + { + return !$this->stream || feof($this->stream); + } + + public function tell() + { + $result = ftell($this->stream); + + if ($result === false) { + throw new \RuntimeException('Unable to determine stream position'); + } + + return $result; + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + if (!$this->seekable) { + throw new \RuntimeException('Stream is not seekable'); + } elseif (fseek($this->stream, $offset, $whence) === -1) { + throw new \RuntimeException('Unable to seek to stream position ' + . $offset . ' with whence ' . var_export($whence, true)); + } + } + + public function read($length) + { + if (!$this->readable) { + throw new \RuntimeException('Cannot read from non-readable stream'); + } + if ($length < 0) { + throw new \RuntimeException('Length parameter cannot be negative'); + } + + if (0 === $length) { + return ''; + } + + $string = fread($this->stream, $length); + if (false === $string) { + throw new \RuntimeException('Unable to read from stream'); + } + + return $string; + } + + public function write($string) + { + if (!$this->writable) { + throw new \RuntimeException('Cannot write to a non-writable stream'); + } + + // We can't know the size after writing anything + $this->size = null; + $result = fwrite($this->stream, $string); + + if ($result === false) { + throw new \RuntimeException('Unable to write to stream'); + } + + return $result; + } + + public function getMetadata($key = null) + { + if (!isset($this->stream)) { + return $key ? null : []; + } elseif (!$key) { + return $this->customMetadata + stream_get_meta_data($this->stream); + } elseif (isset($this->customMetadata[$key])) { + return $this->customMetadata[$key]; + } + + $meta = stream_get_meta_data($this->stream); + + return isset($meta[$key]) ? $meta[$key] : null; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/StreamDecoratorTrait.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/StreamDecoratorTrait.php new file mode 100644 index 0000000..daec6f5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/StreamDecoratorTrait.php @@ -0,0 +1,149 @@ +stream = $stream; + } + + /** + * Magic method used to create a new stream if streams are not added in + * the constructor of a decorator (e.g., LazyOpenStream). + * + * @param string $name Name of the property (allows "stream" only). + * + * @return StreamInterface + */ + public function __get($name) + { + if ($name == 'stream') { + $this->stream = $this->createStream(); + return $this->stream; + } + + throw new \UnexpectedValueException("$name not found on class"); + } + + public function __toString() + { + try { + if ($this->isSeekable()) { + $this->seek(0); + } + return $this->getContents(); + } catch (\Exception $e) { + // Really, PHP? https://bugs.php.net/bug.php?id=53648 + trigger_error('StreamDecorator::__toString exception: ' + . (string) $e, E_USER_ERROR); + return ''; + } + } + + public function getContents() + { + return copy_to_string($this); + } + + /** + * Allow decorators to implement custom methods + * + * @param string $method Missing method name + * @param array $args Method arguments + * + * @return mixed + */ + public function __call($method, array $args) + { + $result = call_user_func_array([$this->stream, $method], $args); + + // Always return the wrapped object if the result is a return $this + return $result === $this->stream ? $this : $result; + } + + public function close() + { + $this->stream->close(); + } + + public function getMetadata($key = null) + { + return $this->stream->getMetadata($key); + } + + public function detach() + { + return $this->stream->detach(); + } + + public function getSize() + { + return $this->stream->getSize(); + } + + public function eof() + { + return $this->stream->eof(); + } + + public function tell() + { + return $this->stream->tell(); + } + + public function isReadable() + { + return $this->stream->isReadable(); + } + + public function isWritable() + { + return $this->stream->isWritable(); + } + + public function isSeekable() + { + return $this->stream->isSeekable(); + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + $this->stream->seek($offset, $whence); + } + + public function read($length) + { + return $this->stream->read($length); + } + + public function write($string) + { + return $this->stream->write($string); + } + + /** + * Implement in subclasses to dynamically create streams when requested. + * + * @return StreamInterface + * @throws \BadMethodCallException + */ + protected function createStream() + { + throw new \BadMethodCallException('Not implemented'); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/StreamWrapper.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/StreamWrapper.php new file mode 100644 index 0000000..cf7b223 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/StreamWrapper.php @@ -0,0 +1,121 @@ +isReadable()) { + $mode = $stream->isWritable() ? 'r+' : 'r'; + } elseif ($stream->isWritable()) { + $mode = 'w'; + } else { + throw new \InvalidArgumentException('The stream must be readable, ' + . 'writable, or both.'); + } + + return fopen('guzzle://stream', $mode, null, stream_context_create([ + 'guzzle' => ['stream' => $stream] + ])); + } + + /** + * Registers the stream wrapper if needed + */ + public static function register() + { + if (!in_array('guzzle', stream_get_wrappers())) { + stream_wrapper_register('guzzle', __CLASS__); + } + } + + public function stream_open($path, $mode, $options, &$opened_path) + { + $options = stream_context_get_options($this->context); + + if (!isset($options['guzzle']['stream'])) { + return false; + } + + $this->mode = $mode; + $this->stream = $options['guzzle']['stream']; + + return true; + } + + public function stream_read($count) + { + return $this->stream->read($count); + } + + public function stream_write($data) + { + return (int) $this->stream->write($data); + } + + public function stream_tell() + { + return $this->stream->tell(); + } + + public function stream_eof() + { + return $this->stream->eof(); + } + + public function stream_seek($offset, $whence) + { + $this->stream->seek($offset, $whence); + + return true; + } + + public function stream_stat() + { + static $modeMap = [ + 'r' => 33060, + 'r+' => 33206, + 'w' => 33188 + ]; + + return [ + 'dev' => 0, + 'ino' => 0, + 'mode' => $modeMap[$this->mode], + 'nlink' => 0, + 'uid' => 0, + 'gid' => 0, + 'rdev' => 0, + 'size' => $this->stream->getSize() ?: 0, + 'atime' => 0, + 'mtime' => 0, + 'ctime' => 0, + 'blksize' => 0, + 'blocks' => 0 + ]; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UploadedFile.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UploadedFile.php new file mode 100644 index 0000000..e62bd5c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UploadedFile.php @@ -0,0 +1,316 @@ +setError($errorStatus); + $this->setSize($size); + $this->setClientFilename($clientFilename); + $this->setClientMediaType($clientMediaType); + + if ($this->isOk()) { + $this->setStreamOrFile($streamOrFile); + } + } + + /** + * Depending on the value set file or stream variable + * + * @param mixed $streamOrFile + * @throws InvalidArgumentException + */ + private function setStreamOrFile($streamOrFile) + { + if (is_string($streamOrFile)) { + $this->file = $streamOrFile; + } elseif (is_resource($streamOrFile)) { + $this->stream = new Stream($streamOrFile); + } elseif ($streamOrFile instanceof StreamInterface) { + $this->stream = $streamOrFile; + } else { + throw new InvalidArgumentException( + 'Invalid stream or file provided for UploadedFile' + ); + } + } + + /** + * @param int $error + * @throws InvalidArgumentException + */ + private function setError($error) + { + if (false === is_int($error)) { + throw new InvalidArgumentException( + 'Upload file error status must be an integer' + ); + } + + if (false === in_array($error, UploadedFile::$errors)) { + throw new InvalidArgumentException( + 'Invalid error status for UploadedFile' + ); + } + + $this->error = $error; + } + + /** + * @param int $size + * @throws InvalidArgumentException + */ + private function setSize($size) + { + if (false === is_int($size)) { + throw new InvalidArgumentException( + 'Upload file size must be an integer' + ); + } + + $this->size = $size; + } + + /** + * @param mixed $param + * @return boolean + */ + private function isStringOrNull($param) + { + return in_array(gettype($param), ['string', 'NULL']); + } + + /** + * @param mixed $param + * @return boolean + */ + private function isStringNotEmpty($param) + { + return is_string($param) && false === empty($param); + } + + /** + * @param string|null $clientFilename + * @throws InvalidArgumentException + */ + private function setClientFilename($clientFilename) + { + if (false === $this->isStringOrNull($clientFilename)) { + throw new InvalidArgumentException( + 'Upload file client filename must be a string or null' + ); + } + + $this->clientFilename = $clientFilename; + } + + /** + * @param string|null $clientMediaType + * @throws InvalidArgumentException + */ + private function setClientMediaType($clientMediaType) + { + if (false === $this->isStringOrNull($clientMediaType)) { + throw new InvalidArgumentException( + 'Upload file client media type must be a string or null' + ); + } + + $this->clientMediaType = $clientMediaType; + } + + /** + * Return true if there is no upload error + * + * @return boolean + */ + private function isOk() + { + return $this->error === UPLOAD_ERR_OK; + } + + /** + * @return boolean + */ + public function isMoved() + { + return $this->moved; + } + + /** + * @throws RuntimeException if is moved or not ok + */ + private function validateActive() + { + if (false === $this->isOk()) { + throw new RuntimeException('Cannot retrieve stream due to upload error'); + } + + if ($this->isMoved()) { + throw new RuntimeException('Cannot retrieve stream after it has already been moved'); + } + } + + /** + * {@inheritdoc} + * @throws RuntimeException if the upload was not successful. + */ + public function getStream() + { + $this->validateActive(); + + if ($this->stream instanceof StreamInterface) { + return $this->stream; + } + + return new LazyOpenStream($this->file, 'r+'); + } + + /** + * {@inheritdoc} + * + * @see http://php.net/is_uploaded_file + * @see http://php.net/move_uploaded_file + * @param string $targetPath Path to which to move the uploaded file. + * @throws RuntimeException if the upload was not successful. + * @throws InvalidArgumentException if the $path specified is invalid. + * @throws RuntimeException on any error during the move operation, or on + * the second or subsequent call to the method. + */ + public function moveTo($targetPath) + { + $this->validateActive(); + + if (false === $this->isStringNotEmpty($targetPath)) { + throw new InvalidArgumentException( + 'Invalid path provided for move operation; must be a non-empty string' + ); + } + + if ($this->file) { + $this->moved = php_sapi_name() == 'cli' + ? rename($this->file, $targetPath) + : move_uploaded_file($this->file, $targetPath); + } else { + copy_to_stream( + $this->getStream(), + new LazyOpenStream($targetPath, 'w') + ); + + $this->moved = true; + } + + if (false === $this->moved) { + throw new RuntimeException( + sprintf('Uploaded file could not be moved to %s', $targetPath) + ); + } + } + + /** + * {@inheritdoc} + * + * @return int|null The file size in bytes or null if unknown. + */ + public function getSize() + { + return $this->size; + } + + /** + * {@inheritdoc} + * + * @see http://php.net/manual/en/features.file-upload.errors.php + * @return int One of PHP's UPLOAD_ERR_XXX constants. + */ + public function getError() + { + return $this->error; + } + + /** + * {@inheritdoc} + * + * @return string|null The filename sent by the client or null if none + * was provided. + */ + public function getClientFilename() + { + return $this->clientFilename; + } + + /** + * {@inheritdoc} + */ + public function getClientMediaType() + { + return $this->clientMediaType; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Uri.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Uri.php new file mode 100644 index 0000000..f46c1db --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/Uri.php @@ -0,0 +1,702 @@ + 80, + 'https' => 443, + 'ftp' => 21, + 'gopher' => 70, + 'nntp' => 119, + 'news' => 119, + 'telnet' => 23, + 'tn3270' => 23, + 'imap' => 143, + 'pop' => 110, + 'ldap' => 389, + ]; + + private static $charUnreserved = 'a-zA-Z0-9_\-\.~'; + private static $charSubDelims = '!\$&\'\(\)\*\+,;='; + private static $replaceQuery = ['=' => '%3D', '&' => '%26']; + + /** @var string Uri scheme. */ + private $scheme = ''; + + /** @var string Uri user info. */ + private $userInfo = ''; + + /** @var string Uri host. */ + private $host = ''; + + /** @var int|null Uri port. */ + private $port; + + /** @var string Uri path. */ + private $path = ''; + + /** @var string Uri query string. */ + private $query = ''; + + /** @var string Uri fragment. */ + private $fragment = ''; + + /** + * @param string $uri URI to parse + */ + public function __construct($uri = '') + { + // weak type check to also accept null until we can add scalar type hints + if ($uri != '') { + $parts = parse_url($uri); + if ($parts === false) { + throw new \InvalidArgumentException("Unable to parse URI: $uri"); + } + $this->applyParts($parts); + } + } + + public function __toString() + { + return self::composeComponents( + $this->scheme, + $this->getAuthority(), + $this->path, + $this->query, + $this->fragment + ); + } + + /** + * Composes a URI reference string from its various components. + * + * Usually this method does not need to be called manually but instead is used indirectly via + * `Psr\Http\Message\UriInterface::__toString`. + * + * PSR-7 UriInterface treats an empty component the same as a missing component as + * getQuery(), getFragment() etc. always return a string. This explains the slight + * difference to RFC 3986 Section 5.3. + * + * Another adjustment is that the authority separator is added even when the authority is missing/empty + * for the "file" scheme. This is because PHP stream functions like `file_get_contents` only work with + * `file:///myfile` but not with `file:/myfile` although they are equivalent according to RFC 3986. But + * `file:///` is the more common syntax for the file scheme anyway (Chrome for example redirects to + * that format). + * + * @param string $scheme + * @param string $authority + * @param string $path + * @param string $query + * @param string $fragment + * + * @return string + * + * @link https://tools.ietf.org/html/rfc3986#section-5.3 + */ + public static function composeComponents($scheme, $authority, $path, $query, $fragment) + { + $uri = ''; + + // weak type checks to also accept null until we can add scalar type hints + if ($scheme != '') { + $uri .= $scheme . ':'; + } + + if ($authority != ''|| $scheme === 'file') { + $uri .= '//' . $authority; + } + + $uri .= $path; + + if ($query != '') { + $uri .= '?' . $query; + } + + if ($fragment != '') { + $uri .= '#' . $fragment; + } + + return $uri; + } + + /** + * Whether the URI has the default port of the current scheme. + * + * `Psr\Http\Message\UriInterface::getPort` may return null or the standard port. This method can be used + * independently of the implementation. + * + * @param UriInterface $uri + * + * @return bool + */ + public static function isDefaultPort(UriInterface $uri) + { + return $uri->getPort() === null + || (isset(self::$defaultPorts[$uri->getScheme()]) && $uri->getPort() === self::$defaultPorts[$uri->getScheme()]); + } + + /** + * Whether the URI is absolute, i.e. it has a scheme. + * + * An instance of UriInterface can either be an absolute URI or a relative reference. This method returns true + * if it is the former. An absolute URI has a scheme. A relative reference is used to express a URI relative + * to another URI, the base URI. Relative references can be divided into several forms: + * - network-path references, e.g. '//example.com/path' + * - absolute-path references, e.g. '/path' + * - relative-path references, e.g. 'subpath' + * + * @param UriInterface $uri + * + * @return bool + * @see Uri::isNetworkPathReference + * @see Uri::isAbsolutePathReference + * @see Uri::isRelativePathReference + * @link https://tools.ietf.org/html/rfc3986#section-4 + */ + public static function isAbsolute(UriInterface $uri) + { + return $uri->getScheme() !== ''; + } + + /** + * Whether the URI is a network-path reference. + * + * A relative reference that begins with two slash characters is termed an network-path reference. + * + * @param UriInterface $uri + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public static function isNetworkPathReference(UriInterface $uri) + { + return $uri->getScheme() === '' && $uri->getAuthority() !== ''; + } + + /** + * Whether the URI is a absolute-path reference. + * + * A relative reference that begins with a single slash character is termed an absolute-path reference. + * + * @param UriInterface $uri + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public static function isAbsolutePathReference(UriInterface $uri) + { + return $uri->getScheme() === '' + && $uri->getAuthority() === '' + && isset($uri->getPath()[0]) + && $uri->getPath()[0] === '/'; + } + + /** + * Whether the URI is a relative-path reference. + * + * A relative reference that does not begin with a slash character is termed a relative-path reference. + * + * @param UriInterface $uri + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public static function isRelativePathReference(UriInterface $uri) + { + return $uri->getScheme() === '' + && $uri->getAuthority() === '' + && (!isset($uri->getPath()[0]) || $uri->getPath()[0] !== '/'); + } + + /** + * Whether the URI is a same-document reference. + * + * A same-document reference refers to a URI that is, aside from its fragment + * component, identical to the base URI. When no base URI is given, only an empty + * URI reference (apart from its fragment) is considered a same-document reference. + * + * @param UriInterface $uri The URI to check + * @param UriInterface|null $base An optional base URI to compare against + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.4 + */ + public static function isSameDocumentReference(UriInterface $uri, UriInterface $base = null) + { + if ($base !== null) { + $uri = UriResolver::resolve($base, $uri); + + return ($uri->getScheme() === $base->getScheme()) + && ($uri->getAuthority() === $base->getAuthority()) + && ($uri->getPath() === $base->getPath()) + && ($uri->getQuery() === $base->getQuery()); + } + + return $uri->getScheme() === '' && $uri->getAuthority() === '' && $uri->getPath() === '' && $uri->getQuery() === ''; + } + + /** + * Removes dot segments from a path and returns the new path. + * + * @param string $path + * + * @return string + * + * @deprecated since version 1.4. Use UriResolver::removeDotSegments instead. + * @see UriResolver::removeDotSegments + */ + public static function removeDotSegments($path) + { + return UriResolver::removeDotSegments($path); + } + + /** + * Converts the relative URI into a new URI that is resolved against the base URI. + * + * @param UriInterface $base Base URI + * @param string|UriInterface $rel Relative URI + * + * @return UriInterface + * + * @deprecated since version 1.4. Use UriResolver::resolve instead. + * @see UriResolver::resolve + */ + public static function resolve(UriInterface $base, $rel) + { + if (!($rel instanceof UriInterface)) { + $rel = new self($rel); + } + + return UriResolver::resolve($base, $rel); + } + + /** + * Creates a new URI with a specific query string value removed. + * + * Any existing query string values that exactly match the provided key are + * removed. + * + * @param UriInterface $uri URI to use as a base. + * @param string $key Query string key to remove. + * + * @return UriInterface + */ + public static function withoutQueryValue(UriInterface $uri, $key) + { + $current = $uri->getQuery(); + if ($current === '') { + return $uri; + } + + $decodedKey = rawurldecode($key); + $result = array_filter(explode('&', $current), function ($part) use ($decodedKey) { + return rawurldecode(explode('=', $part)[0]) !== $decodedKey; + }); + + return $uri->withQuery(implode('&', $result)); + } + + /** + * Creates a new URI with a specific query string value. + * + * Any existing query string values that exactly match the provided key are + * removed and replaced with the given key value pair. + * + * A value of null will set the query string key without a value, e.g. "key" + * instead of "key=value". + * + * @param UriInterface $uri URI to use as a base. + * @param string $key Key to set. + * @param string|null $value Value to set + * + * @return UriInterface + */ + public static function withQueryValue(UriInterface $uri, $key, $value) + { + $current = $uri->getQuery(); + + if ($current === '') { + $result = []; + } else { + $decodedKey = rawurldecode($key); + $result = array_filter(explode('&', $current), function ($part) use ($decodedKey) { + return rawurldecode(explode('=', $part)[0]) !== $decodedKey; + }); + } + + // Query string separators ("=", "&") within the key or value need to be encoded + // (while preventing double-encoding) before setting the query string. All other + // chars that need percent-encoding will be encoded by withQuery(). + $key = strtr($key, self::$replaceQuery); + + if ($value !== null) { + $result[] = $key . '=' . strtr($value, self::$replaceQuery); + } else { + $result[] = $key; + } + + return $uri->withQuery(implode('&', $result)); + } + + /** + * Creates a URI from a hash of `parse_url` components. + * + * @param array $parts + * + * @return UriInterface + * @link http://php.net/manual/en/function.parse-url.php + * + * @throws \InvalidArgumentException If the components do not form a valid URI. + */ + public static function fromParts(array $parts) + { + $uri = new self(); + $uri->applyParts($parts); + $uri->validateState(); + + return $uri; + } + + public function getScheme() + { + return $this->scheme; + } + + public function getAuthority() + { + $authority = $this->host; + if ($this->userInfo !== '') { + $authority = $this->userInfo . '@' . $authority; + } + + if ($this->port !== null) { + $authority .= ':' . $this->port; + } + + return $authority; + } + + public function getUserInfo() + { + return $this->userInfo; + } + + public function getHost() + { + return $this->host; + } + + public function getPort() + { + return $this->port; + } + + public function getPath() + { + return $this->path; + } + + public function getQuery() + { + return $this->query; + } + + public function getFragment() + { + return $this->fragment; + } + + public function withScheme($scheme) + { + $scheme = $this->filterScheme($scheme); + + if ($this->scheme === $scheme) { + return $this; + } + + $new = clone $this; + $new->scheme = $scheme; + $new->removeDefaultPort(); + $new->validateState(); + + return $new; + } + + public function withUserInfo($user, $password = null) + { + $info = $user; + if ($password != '') { + $info .= ':' . $password; + } + + if ($this->userInfo === $info) { + return $this; + } + + $new = clone $this; + $new->userInfo = $info; + $new->validateState(); + + return $new; + } + + public function withHost($host) + { + $host = $this->filterHost($host); + + if ($this->host === $host) { + return $this; + } + + $new = clone $this; + $new->host = $host; + $new->validateState(); + + return $new; + } + + public function withPort($port) + { + $port = $this->filterPort($port); + + if ($this->port === $port) { + return $this; + } + + $new = clone $this; + $new->port = $port; + $new->removeDefaultPort(); + $new->validateState(); + + return $new; + } + + public function withPath($path) + { + $path = $this->filterPath($path); + + if ($this->path === $path) { + return $this; + } + + $new = clone $this; + $new->path = $path; + $new->validateState(); + + return $new; + } + + public function withQuery($query) + { + $query = $this->filterQueryAndFragment($query); + + if ($this->query === $query) { + return $this; + } + + $new = clone $this; + $new->query = $query; + + return $new; + } + + public function withFragment($fragment) + { + $fragment = $this->filterQueryAndFragment($fragment); + + if ($this->fragment === $fragment) { + return $this; + } + + $new = clone $this; + $new->fragment = $fragment; + + return $new; + } + + /** + * Apply parse_url parts to a URI. + * + * @param array $parts Array of parse_url parts to apply. + */ + private function applyParts(array $parts) + { + $this->scheme = isset($parts['scheme']) + ? $this->filterScheme($parts['scheme']) + : ''; + $this->userInfo = isset($parts['user']) ? $parts['user'] : ''; + $this->host = isset($parts['host']) + ? $this->filterHost($parts['host']) + : ''; + $this->port = isset($parts['port']) + ? $this->filterPort($parts['port']) + : null; + $this->path = isset($parts['path']) + ? $this->filterPath($parts['path']) + : ''; + $this->query = isset($parts['query']) + ? $this->filterQueryAndFragment($parts['query']) + : ''; + $this->fragment = isset($parts['fragment']) + ? $this->filterQueryAndFragment($parts['fragment']) + : ''; + if (isset($parts['pass'])) { + $this->userInfo .= ':' . $parts['pass']; + } + + $this->removeDefaultPort(); + } + + /** + * @param string $scheme + * + * @return string + * + * @throws \InvalidArgumentException If the scheme is invalid. + */ + private function filterScheme($scheme) + { + if (!is_string($scheme)) { + throw new \InvalidArgumentException('Scheme must be a string'); + } + + return strtolower($scheme); + } + + /** + * @param string $host + * + * @return string + * + * @throws \InvalidArgumentException If the host is invalid. + */ + private function filterHost($host) + { + if (!is_string($host)) { + throw new \InvalidArgumentException('Host must be a string'); + } + + return strtolower($host); + } + + /** + * @param int|null $port + * + * @return int|null + * + * @throws \InvalidArgumentException If the port is invalid. + */ + private function filterPort($port) + { + if ($port === null) { + return null; + } + + $port = (int) $port; + if (1 > $port || 0xffff < $port) { + throw new \InvalidArgumentException( + sprintf('Invalid port: %d. Must be between 1 and 65535', $port) + ); + } + + return $port; + } + + private function removeDefaultPort() + { + if ($this->port !== null && self::isDefaultPort($this)) { + $this->port = null; + } + } + + /** + * Filters the path of a URI + * + * @param string $path + * + * @return string + * + * @throws \InvalidArgumentException If the path is invalid. + */ + private function filterPath($path) + { + if (!is_string($path)) { + throw new \InvalidArgumentException('Path must be a string'); + } + + return preg_replace_callback( + '/(?:[^' . self::$charUnreserved . self::$charSubDelims . '%:@\/]++|%(?![A-Fa-f0-9]{2}))/', + [$this, 'rawurlencodeMatchZero'], + $path + ); + } + + /** + * Filters the query string or fragment of a URI. + * + * @param string $str + * + * @return string + * + * @throws \InvalidArgumentException If the query or fragment is invalid. + */ + private function filterQueryAndFragment($str) + { + if (!is_string($str)) { + throw new \InvalidArgumentException('Query and fragment must be a string'); + } + + return preg_replace_callback( + '/(?:[^' . self::$charUnreserved . self::$charSubDelims . '%:@\/\?]++|%(?![A-Fa-f0-9]{2}))/', + [$this, 'rawurlencodeMatchZero'], + $str + ); + } + + private function rawurlencodeMatchZero(array $match) + { + return rawurlencode($match[0]); + } + + private function validateState() + { + if ($this->host === '' && ($this->scheme === 'http' || $this->scheme === 'https')) { + $this->host = self::HTTP_DEFAULT_HOST; + } + + if ($this->getAuthority() === '') { + if (0 === strpos($this->path, '//')) { + throw new \InvalidArgumentException('The path of a URI without an authority must not start with two slashes "//"'); + } + if ($this->scheme === '' && false !== strpos(explode('/', $this->path, 2)[0], ':')) { + throw new \InvalidArgumentException('A relative URI must not have a path beginning with a segment containing a colon'); + } + } elseif (isset($this->path[0]) && $this->path[0] !== '/') { + @trigger_error( + 'The path of a URI with an authority must start with a slash "/" or be empty. Automagically fixing the URI ' . + 'by adding a leading slash to the path is deprecated since version 1.4 and will throw an exception instead.', + E_USER_DEPRECATED + ); + $this->path = '/'. $this->path; + //throw new \InvalidArgumentException('The path of a URI with an authority must start with a slash "/" or be empty'); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UriNormalizer.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UriNormalizer.php new file mode 100644 index 0000000..384c29e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UriNormalizer.php @@ -0,0 +1,216 @@ +getPath() === '' && + ($uri->getScheme() === 'http' || $uri->getScheme() === 'https') + ) { + $uri = $uri->withPath('/'); + } + + if ($flags & self::REMOVE_DEFAULT_HOST && $uri->getScheme() === 'file' && $uri->getHost() === 'localhost') { + $uri = $uri->withHost(''); + } + + if ($flags & self::REMOVE_DEFAULT_PORT && $uri->getPort() !== null && Uri::isDefaultPort($uri)) { + $uri = $uri->withPort(null); + } + + if ($flags & self::REMOVE_DOT_SEGMENTS && !Uri::isRelativePathReference($uri)) { + $uri = $uri->withPath(UriResolver::removeDotSegments($uri->getPath())); + } + + if ($flags & self::REMOVE_DUPLICATE_SLASHES) { + $uri = $uri->withPath(preg_replace('#//++#', '/', $uri->getPath())); + } + + if ($flags & self::SORT_QUERY_PARAMETERS && $uri->getQuery() !== '') { + $queryKeyValues = explode('&', $uri->getQuery()); + sort($queryKeyValues); + $uri = $uri->withQuery(implode('&', $queryKeyValues)); + } + + return $uri; + } + + /** + * Whether two URIs can be considered equivalent. + * + * Both URIs are normalized automatically before comparison with the given $normalizations bitmask. The method also + * accepts relative URI references and returns true when they are equivalent. This of course assumes they will be + * resolved against the same base URI. If this is not the case, determination of equivalence or difference of + * relative references does not mean anything. + * + * @param UriInterface $uri1 An URI to compare + * @param UriInterface $uri2 An URI to compare + * @param int $normalizations A bitmask of normalizations to apply, see constants + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-6.1 + */ + public static function isEquivalent(UriInterface $uri1, UriInterface $uri2, $normalizations = self::PRESERVING_NORMALIZATIONS) + { + return (string) self::normalize($uri1, $normalizations) === (string) self::normalize($uri2, $normalizations); + } + + private static function capitalizePercentEncoding(UriInterface $uri) + { + $regex = '/(?:%[A-Fa-f0-9]{2})++/'; + + $callback = function (array $match) { + return strtoupper($match[0]); + }; + + return + $uri->withPath( + preg_replace_callback($regex, $callback, $uri->getPath()) + )->withQuery( + preg_replace_callback($regex, $callback, $uri->getQuery()) + ); + } + + private static function decodeUnreservedCharacters(UriInterface $uri) + { + $regex = '/%(?:2D|2E|5F|7E|3[0-9]|[46][1-9A-F]|[57][0-9A])/i'; + + $callback = function (array $match) { + return rawurldecode($match[0]); + }; + + return + $uri->withPath( + preg_replace_callback($regex, $callback, $uri->getPath()) + )->withQuery( + preg_replace_callback($regex, $callback, $uri->getQuery()) + ); + } + + private function __construct() + { + // cannot be instantiated + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UriResolver.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UriResolver.php new file mode 100644 index 0000000..c1cb8a2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/UriResolver.php @@ -0,0 +1,219 @@ +getScheme() != '') { + return $rel->withPath(self::removeDotSegments($rel->getPath())); + } + + if ($rel->getAuthority() != '') { + $targetAuthority = $rel->getAuthority(); + $targetPath = self::removeDotSegments($rel->getPath()); + $targetQuery = $rel->getQuery(); + } else { + $targetAuthority = $base->getAuthority(); + if ($rel->getPath() === '') { + $targetPath = $base->getPath(); + $targetQuery = $rel->getQuery() != '' ? $rel->getQuery() : $base->getQuery(); + } else { + if ($rel->getPath()[0] === '/') { + $targetPath = $rel->getPath(); + } else { + if ($targetAuthority != '' && $base->getPath() === '') { + $targetPath = '/' . $rel->getPath(); + } else { + $lastSlashPos = strrpos($base->getPath(), '/'); + if ($lastSlashPos === false) { + $targetPath = $rel->getPath(); + } else { + $targetPath = substr($base->getPath(), 0, $lastSlashPos + 1) . $rel->getPath(); + } + } + } + $targetPath = self::removeDotSegments($targetPath); + $targetQuery = $rel->getQuery(); + } + } + + return new Uri(Uri::composeComponents( + $base->getScheme(), + $targetAuthority, + $targetPath, + $targetQuery, + $rel->getFragment() + )); + } + + /** + * Returns the target URI as a relative reference from the base URI. + * + * This method is the counterpart to resolve(): + * + * (string) $target === (string) UriResolver::resolve($base, UriResolver::relativize($base, $target)) + * + * One use-case is to use the current request URI as base URI and then generate relative links in your documents + * to reduce the document size or offer self-contained downloadable document archives. + * + * $base = new Uri('http://example.com/a/b/'); + * echo UriResolver::relativize($base, new Uri('http://example.com/a/b/c')); // prints 'c'. + * echo UriResolver::relativize($base, new Uri('http://example.com/a/x/y')); // prints '../x/y'. + * echo UriResolver::relativize($base, new Uri('http://example.com/a/b/?q')); // prints '?q'. + * echo UriResolver::relativize($base, new Uri('http://example.org/a/b/')); // prints '//example.org/a/b/'. + * + * This method also accepts a target that is already relative and will try to relativize it further. Only a + * relative-path reference will be returned as-is. + * + * echo UriResolver::relativize($base, new Uri('/a/b/c')); // prints 'c' as well + * + * @param UriInterface $base Base URI + * @param UriInterface $target Target URI + * + * @return UriInterface The relative URI reference + */ + public static function relativize(UriInterface $base, UriInterface $target) + { + if ($target->getScheme() !== '' && + ($base->getScheme() !== $target->getScheme() || $target->getAuthority() === '' && $base->getAuthority() !== '') + ) { + return $target; + } + + if (Uri::isRelativePathReference($target)) { + // As the target is already highly relative we return it as-is. It would be possible to resolve + // the target with `$target = self::resolve($base, $target);` and then try make it more relative + // by removing a duplicate query. But let's not do that automatically. + return $target; + } + + if ($target->getAuthority() !== '' && $base->getAuthority() !== $target->getAuthority()) { + return $target->withScheme(''); + } + + // We must remove the path before removing the authority because if the path starts with two slashes, the URI + // would turn invalid. And we also cannot set a relative path before removing the authority, as that is also + // invalid. + $emptyPathUri = $target->withScheme('')->withPath('')->withUserInfo('')->withPort(null)->withHost(''); + + if ($base->getPath() !== $target->getPath()) { + return $emptyPathUri->withPath(self::getRelativePath($base, $target)); + } + + if ($base->getQuery() === $target->getQuery()) { + // Only the target fragment is left. And it must be returned even if base and target fragment are the same. + return $emptyPathUri->withQuery(''); + } + + // If the base URI has a query but the target has none, we cannot return an empty path reference as it would + // inherit the base query component when resolving. + if ($target->getQuery() === '') { + $segments = explode('/', $target->getPath()); + $lastSegment = end($segments); + + return $emptyPathUri->withPath($lastSegment === '' ? './' : $lastSegment); + } + + return $emptyPathUri; + } + + private static function getRelativePath(UriInterface $base, UriInterface $target) + { + $sourceSegments = explode('/', $base->getPath()); + $targetSegments = explode('/', $target->getPath()); + array_pop($sourceSegments); + $targetLastSegment = array_pop($targetSegments); + foreach ($sourceSegments as $i => $segment) { + if (isset($targetSegments[$i]) && $segment === $targetSegments[$i]) { + unset($sourceSegments[$i], $targetSegments[$i]); + } else { + break; + } + } + $targetSegments[] = $targetLastSegment; + $relativePath = str_repeat('../', count($sourceSegments)) . implode('/', $targetSegments); + + // A reference to am empty last segment or an empty first sub-segment must be prefixed with "./". + // This also applies to a segment with a colon character (e.g., "file:colon") that cannot be used + // as the first segment of a relative-path reference, as it would be mistaken for a scheme name. + if ('' === $relativePath || false !== strpos(explode('/', $relativePath, 2)[0], ':')) { + $relativePath = "./$relativePath"; + } elseif ('/' === $relativePath[0]) { + if ($base->getAuthority() != '' && $base->getPath() === '') { + // In this case an extra slash is added by resolve() automatically. So we must not add one here. + $relativePath = ".$relativePath"; + } else { + $relativePath = "./$relativePath"; + } + } + + return $relativePath; + } + + private function __construct() + { + // cannot be instantiated + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/functions.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/functions.php new file mode 100644 index 0000000..e40348d --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/functions.php @@ -0,0 +1,828 @@ +getMethod() . ' ' + . $message->getRequestTarget()) + . ' HTTP/' . $message->getProtocolVersion(); + if (!$message->hasHeader('host')) { + $msg .= "\r\nHost: " . $message->getUri()->getHost(); + } + } elseif ($message instanceof ResponseInterface) { + $msg = 'HTTP/' . $message->getProtocolVersion() . ' ' + . $message->getStatusCode() . ' ' + . $message->getReasonPhrase(); + } else { + throw new \InvalidArgumentException('Unknown message type'); + } + + foreach ($message->getHeaders() as $name => $values) { + $msg .= "\r\n{$name}: " . implode(', ', $values); + } + + return "{$msg}\r\n\r\n" . $message->getBody(); +} + +/** + * Returns a UriInterface for the given value. + * + * This function accepts a string or {@see Psr\Http\Message\UriInterface} and + * returns a UriInterface for the given value. If the value is already a + * `UriInterface`, it is returned as-is. + * + * @param string|UriInterface $uri + * + * @return UriInterface + * @throws \InvalidArgumentException + */ +function uri_for($uri) +{ + if ($uri instanceof UriInterface) { + return $uri; + } elseif (is_string($uri)) { + return new Uri($uri); + } + + throw new \InvalidArgumentException('URI must be a string or UriInterface'); +} + +/** + * Create a new stream based on the input type. + * + * Options is an associative array that can contain the following keys: + * - metadata: Array of custom metadata. + * - size: Size of the stream. + * + * @param resource|string|null|int|float|bool|StreamInterface|callable $resource Entity body data + * @param array $options Additional options + * + * @return Stream + * @throws \InvalidArgumentException if the $resource arg is not valid. + */ +function stream_for($resource = '', array $options = []) +{ + if (is_scalar($resource)) { + $stream = fopen('php://temp', 'r+'); + if ($resource !== '') { + fwrite($stream, $resource); + fseek($stream, 0); + } + return new Stream($stream, $options); + } + + switch (gettype($resource)) { + case 'resource': + return new Stream($resource, $options); + case 'object': + if ($resource instanceof StreamInterface) { + return $resource; + } elseif ($resource instanceof \Iterator) { + return new PumpStream(function () use ($resource) { + if (!$resource->valid()) { + return false; + } + $result = $resource->current(); + $resource->next(); + return $result; + }, $options); + } elseif (method_exists($resource, '__toString')) { + return stream_for((string) $resource, $options); + } + break; + case 'NULL': + return new Stream(fopen('php://temp', 'r+'), $options); + } + + if (is_callable($resource)) { + return new PumpStream($resource, $options); + } + + throw new \InvalidArgumentException('Invalid resource type: ' . gettype($resource)); +} + +/** + * Parse an array of header values containing ";" separated data into an + * array of associative arrays representing the header key value pair + * data of the header. When a parameter does not contain a value, but just + * contains a key, this function will inject a key with a '' string value. + * + * @param string|array $header Header to parse into components. + * + * @return array Returns the parsed header values. + */ +function parse_header($header) +{ + static $trimmed = "\"' \n\t\r"; + $params = $matches = []; + + foreach (normalize_header($header) as $val) { + $part = []; + foreach (preg_split('/;(?=([^"]*"[^"]*")*[^"]*$)/', $val) as $kvp) { + if (preg_match_all('/<[^>]+>|[^=]+/', $kvp, $matches)) { + $m = $matches[0]; + if (isset($m[1])) { + $part[trim($m[0], $trimmed)] = trim($m[1], $trimmed); + } else { + $part[] = trim($m[0], $trimmed); + } + } + } + if ($part) { + $params[] = $part; + } + } + + return $params; +} + +/** + * Converts an array of header values that may contain comma separated + * headers into an array of headers with no comma separated values. + * + * @param string|array $header Header to normalize. + * + * @return array Returns the normalized header field values. + */ +function normalize_header($header) +{ + if (!is_array($header)) { + return array_map('trim', explode(',', $header)); + } + + $result = []; + foreach ($header as $value) { + foreach ((array) $value as $v) { + if (strpos($v, ',') === false) { + $result[] = $v; + continue; + } + foreach (preg_split('/,(?=([^"]*"[^"]*")*[^"]*$)/', $v) as $vv) { + $result[] = trim($vv); + } + } + } + + return $result; +} + +/** + * Clone and modify a request with the given changes. + * + * The changes can be one of: + * - method: (string) Changes the HTTP method. + * - set_headers: (array) Sets the given headers. + * - remove_headers: (array) Remove the given headers. + * - body: (mixed) Sets the given body. + * - uri: (UriInterface) Set the URI. + * - query: (string) Set the query string value of the URI. + * - version: (string) Set the protocol version. + * + * @param RequestInterface $request Request to clone and modify. + * @param array $changes Changes to apply. + * + * @return RequestInterface + */ +function modify_request(RequestInterface $request, array $changes) +{ + if (!$changes) { + return $request; + } + + $headers = $request->getHeaders(); + + if (!isset($changes['uri'])) { + $uri = $request->getUri(); + } else { + // Remove the host header if one is on the URI + if ($host = $changes['uri']->getHost()) { + $changes['set_headers']['Host'] = $host; + + if ($port = $changes['uri']->getPort()) { + $standardPorts = ['http' => 80, 'https' => 443]; + $scheme = $changes['uri']->getScheme(); + if (isset($standardPorts[$scheme]) && $port != $standardPorts[$scheme]) { + $changes['set_headers']['Host'] .= ':'.$port; + } + } + } + $uri = $changes['uri']; + } + + if (!empty($changes['remove_headers'])) { + $headers = _caseless_remove($changes['remove_headers'], $headers); + } + + if (!empty($changes['set_headers'])) { + $headers = _caseless_remove(array_keys($changes['set_headers']), $headers); + $headers = $changes['set_headers'] + $headers; + } + + if (isset($changes['query'])) { + $uri = $uri->withQuery($changes['query']); + } + + if ($request instanceof ServerRequestInterface) { + return new ServerRequest( + isset($changes['method']) ? $changes['method'] : $request->getMethod(), + $uri, + $headers, + isset($changes['body']) ? $changes['body'] : $request->getBody(), + isset($changes['version']) + ? $changes['version'] + : $request->getProtocolVersion(), + $request->getServerParams() + ); + } + + return new Request( + isset($changes['method']) ? $changes['method'] : $request->getMethod(), + $uri, + $headers, + isset($changes['body']) ? $changes['body'] : $request->getBody(), + isset($changes['version']) + ? $changes['version'] + : $request->getProtocolVersion() + ); +} + +/** + * Attempts to rewind a message body and throws an exception on failure. + * + * The body of the message will only be rewound if a call to `tell()` returns a + * value other than `0`. + * + * @param MessageInterface $message Message to rewind + * + * @throws \RuntimeException + */ +function rewind_body(MessageInterface $message) +{ + $body = $message->getBody(); + + if ($body->tell()) { + $body->rewind(); + } +} + +/** + * Safely opens a PHP stream resource using a filename. + * + * When fopen fails, PHP normally raises a warning. This function adds an + * error handler that checks for errors and throws an exception instead. + * + * @param string $filename File to open + * @param string $mode Mode used to open the file + * + * @return resource + * @throws \RuntimeException if the file cannot be opened + */ +function try_fopen($filename, $mode) +{ + $ex = null; + set_error_handler(function () use ($filename, $mode, &$ex) { + $ex = new \RuntimeException(sprintf( + 'Unable to open %s using mode %s: %s', + $filename, + $mode, + func_get_args()[1] + )); + }); + + $handle = fopen($filename, $mode); + restore_error_handler(); + + if ($ex) { + /** @var $ex \RuntimeException */ + throw $ex; + } + + return $handle; +} + +/** + * Copy the contents of a stream into a string until the given number of + * bytes have been read. + * + * @param StreamInterface $stream Stream to read + * @param int $maxLen Maximum number of bytes to read. Pass -1 + * to read the entire stream. + * @return string + * @throws \RuntimeException on error. + */ +function copy_to_string(StreamInterface $stream, $maxLen = -1) +{ + $buffer = ''; + + if ($maxLen === -1) { + while (!$stream->eof()) { + $buf = $stream->read(1048576); + // Using a loose equality here to match on '' and false. + if ($buf == null) { + break; + } + $buffer .= $buf; + } + return $buffer; + } + + $len = 0; + while (!$stream->eof() && $len < $maxLen) { + $buf = $stream->read($maxLen - $len); + // Using a loose equality here to match on '' and false. + if ($buf == null) { + break; + } + $buffer .= $buf; + $len = strlen($buffer); + } + + return $buffer; +} + +/** + * Copy the contents of a stream into another stream until the given number + * of bytes have been read. + * + * @param StreamInterface $source Stream to read from + * @param StreamInterface $dest Stream to write to + * @param int $maxLen Maximum number of bytes to read. Pass -1 + * to read the entire stream. + * + * @throws \RuntimeException on error. + */ +function copy_to_stream( + StreamInterface $source, + StreamInterface $dest, + $maxLen = -1 +) { + $bufferSize = 8192; + + if ($maxLen === -1) { + while (!$source->eof()) { + if (!$dest->write($source->read($bufferSize))) { + break; + } + } + } else { + $remaining = $maxLen; + while ($remaining > 0 && !$source->eof()) { + $buf = $source->read(min($bufferSize, $remaining)); + $len = strlen($buf); + if (!$len) { + break; + } + $remaining -= $len; + $dest->write($buf); + } + } +} + +/** + * Calculate a hash of a Stream + * + * @param StreamInterface $stream Stream to calculate the hash for + * @param string $algo Hash algorithm (e.g. md5, crc32, etc) + * @param bool $rawOutput Whether or not to use raw output + * + * @return string Returns the hash of the stream + * @throws \RuntimeException on error. + */ +function hash( + StreamInterface $stream, + $algo, + $rawOutput = false +) { + $pos = $stream->tell(); + + if ($pos > 0) { + $stream->rewind(); + } + + $ctx = hash_init($algo); + while (!$stream->eof()) { + hash_update($ctx, $stream->read(1048576)); + } + + $out = hash_final($ctx, (bool) $rawOutput); + $stream->seek($pos); + + return $out; +} + +/** + * Read a line from the stream up to the maximum allowed buffer length + * + * @param StreamInterface $stream Stream to read from + * @param int $maxLength Maximum buffer length + * + * @return string|bool + */ +function readline(StreamInterface $stream, $maxLength = null) +{ + $buffer = ''; + $size = 0; + + while (!$stream->eof()) { + // Using a loose equality here to match on '' and false. + if (null == ($byte = $stream->read(1))) { + return $buffer; + } + $buffer .= $byte; + // Break when a new line is found or the max length - 1 is reached + if ($byte === "\n" || ++$size === $maxLength - 1) { + break; + } + } + + return $buffer; +} + +/** + * Parses a request message string into a request object. + * + * @param string $message Request message string. + * + * @return Request + */ +function parse_request($message) +{ + $data = _parse_message($message); + $matches = []; + if (!preg_match('/^[\S]+\s+([a-zA-Z]+:\/\/|\/).*/', $data['start-line'], $matches)) { + throw new \InvalidArgumentException('Invalid request string'); + } + $parts = explode(' ', $data['start-line'], 3); + $version = isset($parts[2]) ? explode('/', $parts[2])[1] : '1.1'; + + $request = new Request( + $parts[0], + $matches[1] === '/' ? _parse_request_uri($parts[1], $data['headers']) : $parts[1], + $data['headers'], + $data['body'], + $version + ); + + return $matches[1] === '/' ? $request : $request->withRequestTarget($parts[1]); +} + +/** + * Parses a response message string into a response object. + * + * @param string $message Response message string. + * + * @return Response + */ +function parse_response($message) +{ + $data = _parse_message($message); + // According to https://tools.ietf.org/html/rfc7230#section-3.1.2 the space + // between status-code and reason-phrase is required. But browsers accept + // responses without space and reason as well. + if (!preg_match('/^HTTP\/.* [0-9]{3}( .*|$)/', $data['start-line'])) { + throw new \InvalidArgumentException('Invalid response string'); + } + $parts = explode(' ', $data['start-line'], 3); + + return new Response( + $parts[1], + $data['headers'], + $data['body'], + explode('/', $parts[0])[1], + isset($parts[2]) ? $parts[2] : null + ); +} + +/** + * Parse a query string into an associative array. + * + * If multiple values are found for the same key, the value of that key + * value pair will become an array. This function does not parse nested + * PHP style arrays into an associative array (e.g., foo[a]=1&foo[b]=2 will + * be parsed into ['foo[a]' => '1', 'foo[b]' => '2']). + * + * @param string $str Query string to parse + * @param bool|string $urlEncoding How the query string is encoded + * + * @return array + */ +function parse_query($str, $urlEncoding = true) +{ + $result = []; + + if ($str === '') { + return $result; + } + + if ($urlEncoding === true) { + $decoder = function ($value) { + return rawurldecode(str_replace('+', ' ', $value)); + }; + } elseif ($urlEncoding == PHP_QUERY_RFC3986) { + $decoder = 'rawurldecode'; + } elseif ($urlEncoding == PHP_QUERY_RFC1738) { + $decoder = 'urldecode'; + } else { + $decoder = function ($str) { return $str; }; + } + + foreach (explode('&', $str) as $kvp) { + $parts = explode('=', $kvp, 2); + $key = $decoder($parts[0]); + $value = isset($parts[1]) ? $decoder($parts[1]) : null; + if (!isset($result[$key])) { + $result[$key] = $value; + } else { + if (!is_array($result[$key])) { + $result[$key] = [$result[$key]]; + } + $result[$key][] = $value; + } + } + + return $result; +} + +/** + * Build a query string from an array of key value pairs. + * + * This function can use the return value of parse_query() to build a query + * string. This function does not modify the provided keys when an array is + * encountered (like http_build_query would). + * + * @param array $params Query string parameters. + * @param int|false $encoding Set to false to not encode, PHP_QUERY_RFC3986 + * to encode using RFC3986, or PHP_QUERY_RFC1738 + * to encode using RFC1738. + * @return string + */ +function build_query(array $params, $encoding = PHP_QUERY_RFC3986) +{ + if (!$params) { + return ''; + } + + if ($encoding === false) { + $encoder = function ($str) { return $str; }; + } elseif ($encoding === PHP_QUERY_RFC3986) { + $encoder = 'rawurlencode'; + } elseif ($encoding === PHP_QUERY_RFC1738) { + $encoder = 'urlencode'; + } else { + throw new \InvalidArgumentException('Invalid type'); + } + + $qs = ''; + foreach ($params as $k => $v) { + $k = $encoder($k); + if (!is_array($v)) { + $qs .= $k; + if ($v !== null) { + $qs .= '=' . $encoder($v); + } + $qs .= '&'; + } else { + foreach ($v as $vv) { + $qs .= $k; + if ($vv !== null) { + $qs .= '=' . $encoder($vv); + } + $qs .= '&'; + } + } + } + + return $qs ? (string) substr($qs, 0, -1) : ''; +} + +/** + * Determines the mimetype of a file by looking at its extension. + * + * @param $filename + * + * @return null|string + */ +function mimetype_from_filename($filename) +{ + return mimetype_from_extension(pathinfo($filename, PATHINFO_EXTENSION)); +} + +/** + * Maps a file extensions to a mimetype. + * + * @param $extension string The file extension. + * + * @return string|null + * @link http://svn.apache.org/repos/asf/httpd/httpd/branches/1.3.x/conf/mime.types + */ +function mimetype_from_extension($extension) +{ + static $mimetypes = [ + '7z' => 'application/x-7z-compressed', + 'aac' => 'audio/x-aac', + 'ai' => 'application/postscript', + 'aif' => 'audio/x-aiff', + 'asc' => 'text/plain', + 'asf' => 'video/x-ms-asf', + 'atom' => 'application/atom+xml', + 'avi' => 'video/x-msvideo', + 'bmp' => 'image/bmp', + 'bz2' => 'application/x-bzip2', + 'cer' => 'application/pkix-cert', + 'crl' => 'application/pkix-crl', + 'crt' => 'application/x-x509-ca-cert', + 'css' => 'text/css', + 'csv' => 'text/csv', + 'cu' => 'application/cu-seeme', + 'deb' => 'application/x-debian-package', + 'doc' => 'application/msword', + 'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', + 'dvi' => 'application/x-dvi', + 'eot' => 'application/vnd.ms-fontobject', + 'eps' => 'application/postscript', + 'epub' => 'application/epub+zip', + 'etx' => 'text/x-setext', + 'flac' => 'audio/flac', + 'flv' => 'video/x-flv', + 'gif' => 'image/gif', + 'gz' => 'application/gzip', + 'htm' => 'text/html', + 'html' => 'text/html', + 'ico' => 'image/x-icon', + 'ics' => 'text/calendar', + 'ini' => 'text/plain', + 'iso' => 'application/x-iso9660-image', + 'jar' => 'application/java-archive', + 'jpe' => 'image/jpeg', + 'jpeg' => 'image/jpeg', + 'jpg' => 'image/jpeg', + 'js' => 'text/javascript', + 'json' => 'application/json', + 'latex' => 'application/x-latex', + 'log' => 'text/plain', + 'm4a' => 'audio/mp4', + 'm4v' => 'video/mp4', + 'mid' => 'audio/midi', + 'midi' => 'audio/midi', + 'mov' => 'video/quicktime', + 'mp3' => 'audio/mpeg', + 'mp4' => 'video/mp4', + 'mp4a' => 'audio/mp4', + 'mp4v' => 'video/mp4', + 'mpe' => 'video/mpeg', + 'mpeg' => 'video/mpeg', + 'mpg' => 'video/mpeg', + 'mpg4' => 'video/mp4', + 'oga' => 'audio/ogg', + 'ogg' => 'audio/ogg', + 'ogv' => 'video/ogg', + 'ogx' => 'application/ogg', + 'pbm' => 'image/x-portable-bitmap', + 'pdf' => 'application/pdf', + 'pgm' => 'image/x-portable-graymap', + 'png' => 'image/png', + 'pnm' => 'image/x-portable-anymap', + 'ppm' => 'image/x-portable-pixmap', + 'ppt' => 'application/vnd.ms-powerpoint', + 'pptx' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation', + 'ps' => 'application/postscript', + 'qt' => 'video/quicktime', + 'rar' => 'application/x-rar-compressed', + 'ras' => 'image/x-cmu-raster', + 'rss' => 'application/rss+xml', + 'rtf' => 'application/rtf', + 'sgm' => 'text/sgml', + 'sgml' => 'text/sgml', + 'svg' => 'image/svg+xml', + 'swf' => 'application/x-shockwave-flash', + 'tar' => 'application/x-tar', + 'tif' => 'image/tiff', + 'tiff' => 'image/tiff', + 'torrent' => 'application/x-bittorrent', + 'ttf' => 'application/x-font-ttf', + 'txt' => 'text/plain', + 'wav' => 'audio/x-wav', + 'webm' => 'video/webm', + 'wma' => 'audio/x-ms-wma', + 'wmv' => 'video/x-ms-wmv', + 'woff' => 'application/x-font-woff', + 'wsdl' => 'application/wsdl+xml', + 'xbm' => 'image/x-xbitmap', + 'xls' => 'application/vnd.ms-excel', + 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', + 'xml' => 'application/xml', + 'xpm' => 'image/x-xpixmap', + 'xwd' => 'image/x-xwindowdump', + 'yaml' => 'text/yaml', + 'yml' => 'text/yaml', + 'zip' => 'application/zip', + ]; + + $extension = strtolower($extension); + + return isset($mimetypes[$extension]) + ? $mimetypes[$extension] + : null; +} + +/** + * Parses an HTTP message into an associative array. + * + * The array contains the "start-line" key containing the start line of + * the message, "headers" key containing an associative array of header + * array values, and a "body" key containing the body of the message. + * + * @param string $message HTTP request or response to parse. + * + * @return array + * @internal + */ +function _parse_message($message) +{ + if (!$message) { + throw new \InvalidArgumentException('Invalid message'); + } + + // Iterate over each line in the message, accounting for line endings + $lines = preg_split('/(\\r?\\n)/', $message, -1, PREG_SPLIT_DELIM_CAPTURE); + $result = ['start-line' => array_shift($lines), 'headers' => [], 'body' => '']; + array_shift($lines); + + for ($i = 0, $totalLines = count($lines); $i < $totalLines; $i += 2) { + $line = $lines[$i]; + // If two line breaks were encountered, then this is the end of body + if (empty($line)) { + if ($i < $totalLines - 1) { + $result['body'] = implode('', array_slice($lines, $i + 2)); + } + break; + } + if (strpos($line, ':')) { + $parts = explode(':', $line, 2); + $key = trim($parts[0]); + $value = isset($parts[1]) ? trim($parts[1]) : ''; + $result['headers'][$key][] = $value; + } + } + + return $result; +} + +/** + * Constructs a URI for an HTTP request message. + * + * @param string $path Path from the start-line + * @param array $headers Array of headers (each value an array). + * + * @return string + * @internal + */ +function _parse_request_uri($path, array $headers) +{ + $hostKey = array_filter(array_keys($headers), function ($k) { + return strtolower($k) === 'host'; + }); + + // If no host is found, then a full URI cannot be constructed. + if (!$hostKey) { + return $path; + } + + $host = $headers[reset($hostKey)][0]; + $scheme = substr($host, -4) === ':443' ? 'https' : 'http'; + + return $scheme . '://' . $host . '/' . ltrim($path, '/'); +} + +/** @internal */ +function _caseless_remove($keys, array $data) +{ + $result = []; + + foreach ($keys as &$key) { + $key = strtolower($key); + } + + foreach ($data as $k => $v) { + if (!in_array(strtolower($k), $keys)) { + $result[$k] = $v; + } + } + + return $result; +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/functions_include.php b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/functions_include.php new file mode 100644 index 0000000..96a4a83 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/guzzlehttp/psr7/src/functions_include.php @@ -0,0 +1,6 @@ + + +For the full copyright and license information, please view the LICENSE +file that was distributed with this source code. +EOF; + +$finder = Symfony\CS\Finder::create() + ->files() + ->name('*.php') + ->exclude('Fixtures') + ->in(__DIR__.'/src') + ->in(__DIR__.'/tests') +; + +return Symfony\CS\Config::create() + ->setUsingCache(true) + //->setUsingLinter(false) + ->setRiskyAllowed(true) + ->setRules(array( + '@PSR2' => true, + 'binary_operator_spaces' => true, + 'blank_line_before_return' => true, + 'header_comment' => array('header' => $header), + 'include' => true, + 'long_array_syntax' => true, + 'method_separation' => true, + 'no_blank_lines_after_class_opening' => true, + 'no_blank_lines_after_phpdoc' => true, + 'no_blank_lines_between_uses' => true, + 'no_duplicate_semicolons' => true, + 'no_extra_consecutive_blank_lines' => true, + 'no_leading_import_slash' => true, + 'no_leading_namespace_whitespace' => true, + 'no_trailing_comma_in_singleline_array' => true, + 'no_unused_imports' => true, + 'object_operator_without_whitespace' => true, + 'phpdoc_align' => true, + 'phpdoc_indent' => true, + 'phpdoc_no_access' => true, + 'phpdoc_no_package' => true, + 'phpdoc_order' => true, + 'phpdoc_scalar' => true, + 'phpdoc_trim' => true, + 'phpdoc_type_to_var' => true, + 'psr0' => true, + 'single_blank_line_before_namespace' => true, + 'spaces_cast' => true, + 'standardize_not_equals' => true, + 'ternary_operator_spaces' => true, + 'trailing_comma_in_multiline_array' => true, + 'whitespacy_lines' => true, + )) + ->finder($finder) +; diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/LICENSE new file mode 100644 index 0000000..1647321 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2011-2016 Jordi Boggiano + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/composer.json b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/composer.json new file mode 100644 index 0000000..3b0c880 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/composer.json @@ -0,0 +1,66 @@ +{ + "name": "monolog/monolog", + "description": "Sends your logs to files, sockets, inboxes, databases and various web services", + "keywords": ["log", "logging", "psr-3"], + "homepage": "http://github.com/Seldaek/monolog", + "type": "library", + "license": "MIT", + "authors": [ + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "http://seld.be" + } + ], + "require": { + "php": ">=5.3.0", + "psr/log": "~1.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.5", + "graylog2/gelf-php": "~1.0", + "sentry/sentry": "^0.13", + "ruflin/elastica": ">=0.90 <3.0", + "doctrine/couchdb": "~1.0@dev", + "aws/aws-sdk-php": "^2.4.9 || ^3.0", + "php-amqplib/php-amqplib": "~2.4", + "swiftmailer/swiftmailer": "^5.3|^6.0", + "php-console/php-console": "^3.1.3", + "phpunit/phpunit-mock-objects": "2.3.0", + "jakub-onderka/php-parallel-lint": "0.9" + }, + "_": "phpunit/phpunit-mock-objects required in 2.3.0 due to https://github.com/sebastianbergmann/phpunit-mock-objects/issues/223 - needs hhvm 3.8+ on travis", + "suggest": { + "graylog2/gelf-php": "Allow sending log messages to a GrayLog2 server", + "sentry/sentry": "Allow sending log messages to a Sentry server", + "doctrine/couchdb": "Allow sending log messages to a CouchDB server", + "ruflin/elastica": "Allow sending log messages to an Elastic Search server", + "php-amqplib/php-amqplib": "Allow sending log messages to an AMQP server using php-amqplib", + "ext-amqp": "Allow sending log messages to an AMQP server (1.0+ required)", + "ext-mongo": "Allow sending log messages to a MongoDB server", + "mongodb/mongodb": "Allow sending log messages to a MongoDB server via PHP Driver", + "aws/aws-sdk-php": "Allow sending log messages to AWS services like DynamoDB", + "rollbar/rollbar": "Allow sending log messages to Rollbar", + "php-console/php-console": "Allow sending log messages to Google Chrome" + }, + "autoload": { + "psr-4": {"Monolog\\": "src/Monolog"} + }, + "autoload-dev": { + "psr-4": {"Monolog\\": "tests/Monolog"} + }, + "provide": { + "psr/log-implementation": "1.0.0" + }, + "extra": { + "branch-alias": { + "dev-master": "2.0.x-dev" + } + }, + "scripts": { + "test": [ + "parallel-lint . --exclude vendor", + "phpunit" + ] + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/ErrorHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/ErrorHandler.php new file mode 100644 index 0000000..7bfcd83 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/ErrorHandler.php @@ -0,0 +1,230 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog; + +use Psr\Log\LoggerInterface; +use Psr\Log\LogLevel; +use Monolog\Handler\AbstractHandler; + +/** + * Monolog error handler + * + * A facility to enable logging of runtime errors, exceptions and fatal errors. + * + * Quick setup: ErrorHandler::register($logger); + * + * @author Jordi Boggiano + */ +class ErrorHandler +{ + private $logger; + + private $previousExceptionHandler; + private $uncaughtExceptionLevel; + + private $previousErrorHandler; + private $errorLevelMap; + private $handleOnlyReportedErrors; + + private $hasFatalErrorHandler; + private $fatalLevel; + private $reservedMemory; + private static $fatalErrors = array(E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR); + + public function __construct(LoggerInterface $logger) + { + $this->logger = $logger; + } + + /** + * Registers a new ErrorHandler for a given Logger + * + * By default it will handle errors, exceptions and fatal errors + * + * @param LoggerInterface $logger + * @param array|false $errorLevelMap an array of E_* constant to LogLevel::* constant mapping, or false to disable error handling + * @param int|false $exceptionLevel a LogLevel::* constant, or false to disable exception handling + * @param int|false $fatalLevel a LogLevel::* constant, or false to disable fatal error handling + * @return ErrorHandler + */ + public static function register(LoggerInterface $logger, $errorLevelMap = array(), $exceptionLevel = null, $fatalLevel = null) + { + //Forces the autoloader to run for LogLevel. Fixes an autoload issue at compile-time on PHP5.3. See https://github.com/Seldaek/monolog/pull/929 + class_exists('\\Psr\\Log\\LogLevel', true); + + $handler = new static($logger); + if ($errorLevelMap !== false) { + $handler->registerErrorHandler($errorLevelMap); + } + if ($exceptionLevel !== false) { + $handler->registerExceptionHandler($exceptionLevel); + } + if ($fatalLevel !== false) { + $handler->registerFatalHandler($fatalLevel); + } + + return $handler; + } + + public function registerExceptionHandler($level = null, $callPrevious = true) + { + $prev = set_exception_handler(array($this, 'handleException')); + $this->uncaughtExceptionLevel = $level; + if ($callPrevious && $prev) { + $this->previousExceptionHandler = $prev; + } + } + + public function registerErrorHandler(array $levelMap = array(), $callPrevious = true, $errorTypes = -1, $handleOnlyReportedErrors = true) + { + $prev = set_error_handler(array($this, 'handleError'), $errorTypes); + $this->errorLevelMap = array_replace($this->defaultErrorLevelMap(), $levelMap); + if ($callPrevious) { + $this->previousErrorHandler = $prev ?: true; + } + + $this->handleOnlyReportedErrors = $handleOnlyReportedErrors; + } + + public function registerFatalHandler($level = null, $reservedMemorySize = 20) + { + register_shutdown_function(array($this, 'handleFatalError')); + + $this->reservedMemory = str_repeat(' ', 1024 * $reservedMemorySize); + $this->fatalLevel = $level; + $this->hasFatalErrorHandler = true; + } + + protected function defaultErrorLevelMap() + { + return array( + E_ERROR => LogLevel::CRITICAL, + E_WARNING => LogLevel::WARNING, + E_PARSE => LogLevel::ALERT, + E_NOTICE => LogLevel::NOTICE, + E_CORE_ERROR => LogLevel::CRITICAL, + E_CORE_WARNING => LogLevel::WARNING, + E_COMPILE_ERROR => LogLevel::ALERT, + E_COMPILE_WARNING => LogLevel::WARNING, + E_USER_ERROR => LogLevel::ERROR, + E_USER_WARNING => LogLevel::WARNING, + E_USER_NOTICE => LogLevel::NOTICE, + E_STRICT => LogLevel::NOTICE, + E_RECOVERABLE_ERROR => LogLevel::ERROR, + E_DEPRECATED => LogLevel::NOTICE, + E_USER_DEPRECATED => LogLevel::NOTICE, + ); + } + + /** + * @private + */ + public function handleException($e) + { + $this->logger->log( + $this->uncaughtExceptionLevel === null ? LogLevel::ERROR : $this->uncaughtExceptionLevel, + sprintf('Uncaught Exception %s: "%s" at %s line %s', get_class($e), $e->getMessage(), $e->getFile(), $e->getLine()), + array('exception' => $e) + ); + + if ($this->previousExceptionHandler) { + call_user_func($this->previousExceptionHandler, $e); + } + + exit(255); + } + + /** + * @private + */ + public function handleError($code, $message, $file = '', $line = 0, $context = array()) + { + if ($this->handleOnlyReportedErrors && !(error_reporting() & $code)) { + return; + } + + // fatal error codes are ignored if a fatal error handler is present as well to avoid duplicate log entries + if (!$this->hasFatalErrorHandler || !in_array($code, self::$fatalErrors, true)) { + $level = isset($this->errorLevelMap[$code]) ? $this->errorLevelMap[$code] : LogLevel::CRITICAL; + $this->logger->log($level, self::codeToString($code).': '.$message, array('code' => $code, 'message' => $message, 'file' => $file, 'line' => $line)); + } + + if ($this->previousErrorHandler === true) { + return false; + } elseif ($this->previousErrorHandler) { + return call_user_func($this->previousErrorHandler, $code, $message, $file, $line, $context); + } + } + + /** + * @private + */ + public function handleFatalError() + { + $this->reservedMemory = null; + + $lastError = error_get_last(); + if ($lastError && in_array($lastError['type'], self::$fatalErrors, true)) { + $this->logger->log( + $this->fatalLevel === null ? LogLevel::ALERT : $this->fatalLevel, + 'Fatal Error ('.self::codeToString($lastError['type']).'): '.$lastError['message'], + array('code' => $lastError['type'], 'message' => $lastError['message'], 'file' => $lastError['file'], 'line' => $lastError['line']) + ); + + if ($this->logger instanceof Logger) { + foreach ($this->logger->getHandlers() as $handler) { + if ($handler instanceof AbstractHandler) { + $handler->close(); + } + } + } + } + } + + private static function codeToString($code) + { + switch ($code) { + case E_ERROR: + return 'E_ERROR'; + case E_WARNING: + return 'E_WARNING'; + case E_PARSE: + return 'E_PARSE'; + case E_NOTICE: + return 'E_NOTICE'; + case E_CORE_ERROR: + return 'E_CORE_ERROR'; + case E_CORE_WARNING: + return 'E_CORE_WARNING'; + case E_COMPILE_ERROR: + return 'E_COMPILE_ERROR'; + case E_COMPILE_WARNING: + return 'E_COMPILE_WARNING'; + case E_USER_ERROR: + return 'E_USER_ERROR'; + case E_USER_WARNING: + return 'E_USER_WARNING'; + case E_USER_NOTICE: + return 'E_USER_NOTICE'; + case E_STRICT: + return 'E_STRICT'; + case E_RECOVERABLE_ERROR: + return 'E_RECOVERABLE_ERROR'; + case E_DEPRECATED: + return 'E_DEPRECATED'; + case E_USER_DEPRECATED: + return 'E_USER_DEPRECATED'; + } + + return 'Unknown PHP error'; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ChromePHPFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ChromePHPFormatter.php new file mode 100644 index 0000000..9beda1e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ChromePHPFormatter.php @@ -0,0 +1,78 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +use Monolog\Logger; + +/** + * Formats a log message according to the ChromePHP array format + * + * @author Christophe Coevoet + */ +class ChromePHPFormatter implements FormatterInterface +{ + /** + * Translates Monolog log levels to Wildfire levels. + */ + private $logLevels = array( + Logger::DEBUG => 'log', + Logger::INFO => 'info', + Logger::NOTICE => 'info', + Logger::WARNING => 'warn', + Logger::ERROR => 'error', + Logger::CRITICAL => 'error', + Logger::ALERT => 'error', + Logger::EMERGENCY => 'error', + ); + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + // Retrieve the line and file if set and remove them from the formatted extra + $backtrace = 'unknown'; + if (isset($record['extra']['file'], $record['extra']['line'])) { + $backtrace = $record['extra']['file'].' : '.$record['extra']['line']; + unset($record['extra']['file'], $record['extra']['line']); + } + + $message = array('message' => $record['message']); + if ($record['context']) { + $message['context'] = $record['context']; + } + if ($record['extra']) { + $message['extra'] = $record['extra']; + } + if (count($message) === 1) { + $message = reset($message); + } + + return array( + $record['channel'], + $message, + $backtrace, + $this->logLevels[$record['level']], + ); + } + + public function formatBatch(array $records) + { + $formatted = array(); + + foreach ($records as $record) { + $formatted[] = $this->format($record); + } + + return $formatted; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ElasticaFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ElasticaFormatter.php new file mode 100644 index 0000000..4c556cf --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ElasticaFormatter.php @@ -0,0 +1,89 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +use Elastica\Document; + +/** + * Format a log message into an Elastica Document + * + * @author Jelle Vink + */ +class ElasticaFormatter extends NormalizerFormatter +{ + /** + * @var string Elastic search index name + */ + protected $index; + + /** + * @var string Elastic search document type + */ + protected $type; + + /** + * @param string $index Elastic Search index name + * @param string $type Elastic Search document type + */ + public function __construct($index, $type) + { + // elasticsearch requires a ISO 8601 format date with optional millisecond precision. + parent::__construct('Y-m-d\TH:i:s.uP'); + + $this->index = $index; + $this->type = $type; + } + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + $record = parent::format($record); + + return $this->getDocument($record); + } + + /** + * Getter index + * @return string + */ + public function getIndex() + { + return $this->index; + } + + /** + * Getter type + * @return string + */ + public function getType() + { + return $this->type; + } + + /** + * Convert a log message into an Elastica Document + * + * @param array $record Log message + * @return Document + */ + protected function getDocument($record) + { + $document = new Document(); + $document->setData($record); + $document->setType($this->type); + $document->setIndex($this->index); + + return $document; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FlowdockFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FlowdockFormatter.php new file mode 100644 index 0000000..5094af3 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FlowdockFormatter.php @@ -0,0 +1,116 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +/** + * formats the record to be used in the FlowdockHandler + * + * @author Dominik Liebler + */ +class FlowdockFormatter implements FormatterInterface +{ + /** + * @var string + */ + private $source; + + /** + * @var string + */ + private $sourceEmail; + + /** + * @param string $source + * @param string $sourceEmail + */ + public function __construct($source, $sourceEmail) + { + $this->source = $source; + $this->sourceEmail = $sourceEmail; + } + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + $tags = array( + '#logs', + '#' . strtolower($record['level_name']), + '#' . $record['channel'], + ); + + foreach ($record['extra'] as $value) { + $tags[] = '#' . $value; + } + + $subject = sprintf( + 'in %s: %s - %s', + $this->source, + $record['level_name'], + $this->getShortMessage($record['message']) + ); + + $record['flowdock'] = array( + 'source' => $this->source, + 'from_address' => $this->sourceEmail, + 'subject' => $subject, + 'content' => $record['message'], + 'tags' => $tags, + 'project' => $this->source, + ); + + return $record; + } + + /** + * {@inheritdoc} + */ + public function formatBatch(array $records) + { + $formatted = array(); + + foreach ($records as $record) { + $formatted[] = $this->format($record); + } + + return $formatted; + } + + /** + * @param string $message + * + * @return string + */ + public function getShortMessage($message) + { + static $hasMbString; + + if (null === $hasMbString) { + $hasMbString = function_exists('mb_strlen'); + } + + $maxLength = 45; + + if ($hasMbString) { + if (mb_strlen($message, 'UTF-8') > $maxLength) { + $message = mb_substr($message, 0, $maxLength - 4, 'UTF-8') . ' ...'; + } + } else { + if (strlen($message) > $maxLength) { + $message = substr($message, 0, $maxLength - 4) . ' ...'; + } + } + + return $message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FluentdFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FluentdFormatter.php new file mode 100644 index 0000000..02632bb --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FluentdFormatter.php @@ -0,0 +1,85 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +/** + * Class FluentdFormatter + * + * Serializes a log message to Fluentd unix socket protocol + * + * Fluentd config: + * + * + * type unix + * path /var/run/td-agent/td-agent.sock + * + * + * Monolog setup: + * + * $logger = new Monolog\Logger('fluent.tag'); + * $fluentHandler = new Monolog\Handler\SocketHandler('unix:///var/run/td-agent/td-agent.sock'); + * $fluentHandler->setFormatter(new Monolog\Formatter\FluentdFormatter()); + * $logger->pushHandler($fluentHandler); + * + * @author Andrius Putna + */ +class FluentdFormatter implements FormatterInterface +{ + /** + * @var bool $levelTag should message level be a part of the fluentd tag + */ + protected $levelTag = false; + + public function __construct($levelTag = false) + { + if (!function_exists('json_encode')) { + throw new \RuntimeException('PHP\'s json extension is required to use Monolog\'s FluentdUnixFormatter'); + } + + $this->levelTag = (bool) $levelTag; + } + + public function isUsingLevelsInTag() + { + return $this->levelTag; + } + + public function format(array $record) + { + $tag = $record['channel']; + if ($this->levelTag) { + $tag .= '.' . strtolower($record['level_name']); + } + + $message = array( + 'message' => $record['message'], + 'extra' => $record['extra'], + ); + + if (!$this->levelTag) { + $message['level'] = $record['level']; + $message['level_name'] = $record['level_name']; + } + + return json_encode(array($tag, $record['datetime']->getTimestamp(), $message)); + } + + public function formatBatch(array $records) + { + $message = ''; + foreach ($records as $record) { + $message .= $this->format($record); + } + + return $message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FormatterInterface.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FormatterInterface.php new file mode 100644 index 0000000..b5de751 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/FormatterInterface.php @@ -0,0 +1,36 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +/** + * Interface for formatters + * + * @author Jordi Boggiano + */ +interface FormatterInterface +{ + /** + * Formats a log record. + * + * @param array $record A record to format + * @return mixed The formatted record + */ + public function format(array $record); + + /** + * Formats a set of log records. + * + * @param array $records A set of records to format + * @return mixed The formatted set of records + */ + public function formatBatch(array $records); +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/GelfMessageFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/GelfMessageFormatter.php new file mode 100644 index 0000000..2c1b0e8 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/GelfMessageFormatter.php @@ -0,0 +1,138 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +use Monolog\Logger; +use Gelf\Message; + +/** + * Serializes a log message to GELF + * @see http://www.graylog2.org/about/gelf + * + * @author Matt Lehner + */ +class GelfMessageFormatter extends NormalizerFormatter +{ + const DEFAULT_MAX_LENGTH = 32766; + + /** + * @var string the name of the system for the Gelf log message + */ + protected $systemName; + + /** + * @var string a prefix for 'extra' fields from the Monolog record (optional) + */ + protected $extraPrefix; + + /** + * @var string a prefix for 'context' fields from the Monolog record (optional) + */ + protected $contextPrefix; + + /** + * @var int max length per field + */ + protected $maxLength; + + /** + * Translates Monolog log levels to Graylog2 log priorities. + */ + private $logLevels = array( + Logger::DEBUG => 7, + Logger::INFO => 6, + Logger::NOTICE => 5, + Logger::WARNING => 4, + Logger::ERROR => 3, + Logger::CRITICAL => 2, + Logger::ALERT => 1, + Logger::EMERGENCY => 0, + ); + + public function __construct($systemName = null, $extraPrefix = null, $contextPrefix = 'ctxt_', $maxLength = null) + { + parent::__construct('U.u'); + + $this->systemName = $systemName ?: gethostname(); + + $this->extraPrefix = $extraPrefix; + $this->contextPrefix = $contextPrefix; + $this->maxLength = is_null($maxLength) ? self::DEFAULT_MAX_LENGTH : $maxLength; + } + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + $record = parent::format($record); + + if (!isset($record['datetime'], $record['message'], $record['level'])) { + throw new \InvalidArgumentException('The record should at least contain datetime, message and level keys, '.var_export($record, true).' given'); + } + + $message = new Message(); + $message + ->setTimestamp($record['datetime']) + ->setShortMessage((string) $record['message']) + ->setHost($this->systemName) + ->setLevel($this->logLevels[$record['level']]); + + // message length + system name length + 200 for padding / metadata + $len = 200 + strlen((string) $record['message']) + strlen($this->systemName); + + if ($len > $this->maxLength) { + $message->setShortMessage(substr($record['message'], 0, $this->maxLength)); + } + + if (isset($record['channel'])) { + $message->setFacility($record['channel']); + } + if (isset($record['extra']['line'])) { + $message->setLine($record['extra']['line']); + unset($record['extra']['line']); + } + if (isset($record['extra']['file'])) { + $message->setFile($record['extra']['file']); + unset($record['extra']['file']); + } + + foreach ($record['extra'] as $key => $val) { + $val = is_scalar($val) || null === $val ? $val : $this->toJson($val); + $len = strlen($this->extraPrefix . $key . $val); + if ($len > $this->maxLength) { + $message->setAdditional($this->extraPrefix . $key, substr($val, 0, $this->maxLength)); + break; + } + $message->setAdditional($this->extraPrefix . $key, $val); + } + + foreach ($record['context'] as $key => $val) { + $val = is_scalar($val) || null === $val ? $val : $this->toJson($val); + $len = strlen($this->contextPrefix . $key . $val); + if ($len > $this->maxLength) { + $message->setAdditional($this->contextPrefix . $key, substr($val, 0, $this->maxLength)); + break; + } + $message->setAdditional($this->contextPrefix . $key, $val); + } + + if (null === $message->getFile() && isset($record['context']['exception']['file'])) { + if (preg_match("/^(.+):([0-9]+)$/", $record['context']['exception']['file'], $matches)) { + $message->setFile($matches[1]); + $message->setLine($matches[2]); + } + } + + return $message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/HtmlFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/HtmlFormatter.php new file mode 100644 index 0000000..3eec95f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/HtmlFormatter.php @@ -0,0 +1,141 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +use Monolog\Logger; + +/** + * Formats incoming records into an HTML table + * + * This is especially useful for html email logging + * + * @author Tiago Brito + */ +class HtmlFormatter extends NormalizerFormatter +{ + /** + * Translates Monolog log levels to html color priorities. + */ + protected $logLevels = array( + Logger::DEBUG => '#cccccc', + Logger::INFO => '#468847', + Logger::NOTICE => '#3a87ad', + Logger::WARNING => '#c09853', + Logger::ERROR => '#f0ad4e', + Logger::CRITICAL => '#FF7708', + Logger::ALERT => '#C12A19', + Logger::EMERGENCY => '#000000', + ); + + /** + * @param string $dateFormat The format of the timestamp: one supported by DateTime::format + */ + public function __construct($dateFormat = null) + { + parent::__construct($dateFormat); + } + + /** + * Creates an HTML table row + * + * @param string $th Row header content + * @param string $td Row standard cell content + * @param bool $escapeTd false if td content must not be html escaped + * @return string + */ + protected function addRow($th, $td = ' ', $escapeTd = true) + { + $th = htmlspecialchars($th, ENT_NOQUOTES, 'UTF-8'); + if ($escapeTd) { + $td = '
    '.htmlspecialchars($td, ENT_NOQUOTES, 'UTF-8').'
    '; + } + + return "\n$th:\n".$td."\n"; + } + + /** + * Create a HTML h1 tag + * + * @param string $title Text to be in the h1 + * @param int $level Error level + * @return string + */ + protected function addTitle($title, $level) + { + $title = htmlspecialchars($title, ENT_NOQUOTES, 'UTF-8'); + + return '

    '.$title.'

    '; + } + + /** + * Formats a log record. + * + * @param array $record A record to format + * @return mixed The formatted record + */ + public function format(array $record) + { + $output = $this->addTitle($record['level_name'], $record['level']); + $output .= ''; + + $output .= $this->addRow('Message', (string) $record['message']); + $output .= $this->addRow('Time', $record['datetime']->format($this->dateFormat)); + $output .= $this->addRow('Channel', $record['channel']); + if ($record['context']) { + $embeddedTable = '
    '; + foreach ($record['context'] as $key => $value) { + $embeddedTable .= $this->addRow($key, $this->convertToString($value)); + } + $embeddedTable .= '
    '; + $output .= $this->addRow('Context', $embeddedTable, false); + } + if ($record['extra']) { + $embeddedTable = ''; + foreach ($record['extra'] as $key => $value) { + $embeddedTable .= $this->addRow($key, $this->convertToString($value)); + } + $embeddedTable .= '
    '; + $output .= $this->addRow('Extra', $embeddedTable, false); + } + + return $output.''; + } + + /** + * Formats a set of log records. + * + * @param array $records A set of records to format + * @return mixed The formatted set of records + */ + public function formatBatch(array $records) + { + $message = ''; + foreach ($records as $record) { + $message .= $this->format($record); + } + + return $message; + } + + protected function convertToString($data) + { + if (null === $data || is_scalar($data)) { + return (string) $data; + } + + $data = $this->normalize($data); + if (version_compare(PHP_VERSION, '5.4.0', '>=')) { + return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE); + } + + return str_replace('\\/', '/', json_encode($data)); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/JsonFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/JsonFormatter.php new file mode 100644 index 0000000..0782f14 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/JsonFormatter.php @@ -0,0 +1,208 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +use Exception; +use Throwable; + +/** + * Encodes whatever record data is passed to it as json + * + * This can be useful to log to databases or remote APIs + * + * @author Jordi Boggiano + */ +class JsonFormatter extends NormalizerFormatter +{ + const BATCH_MODE_JSON = 1; + const BATCH_MODE_NEWLINES = 2; + + protected $batchMode; + protected $appendNewline; + + /** + * @var bool + */ + protected $includeStacktraces = false; + + /** + * @param int $batchMode + * @param bool $appendNewline + */ + public function __construct($batchMode = self::BATCH_MODE_JSON, $appendNewline = true) + { + $this->batchMode = $batchMode; + $this->appendNewline = $appendNewline; + } + + /** + * The batch mode option configures the formatting style for + * multiple records. By default, multiple records will be + * formatted as a JSON-encoded array. However, for + * compatibility with some API endpoints, alternative styles + * are available. + * + * @return int + */ + public function getBatchMode() + { + return $this->batchMode; + } + + /** + * True if newlines are appended to every formatted record + * + * @return bool + */ + public function isAppendingNewlines() + { + return $this->appendNewline; + } + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + return $this->toJson($this->normalize($record), true) . ($this->appendNewline ? "\n" : ''); + } + + /** + * {@inheritdoc} + */ + public function formatBatch(array $records) + { + switch ($this->batchMode) { + case static::BATCH_MODE_NEWLINES: + return $this->formatBatchNewlines($records); + + case static::BATCH_MODE_JSON: + default: + return $this->formatBatchJson($records); + } + } + + /** + * @param bool $include + */ + public function includeStacktraces($include = true) + { + $this->includeStacktraces = $include; + } + + /** + * Return a JSON-encoded array of records. + * + * @param array $records + * @return string + */ + protected function formatBatchJson(array $records) + { + return $this->toJson($this->normalize($records), true); + } + + /** + * Use new lines to separate records instead of a + * JSON-encoded array. + * + * @param array $records + * @return string + */ + protected function formatBatchNewlines(array $records) + { + $instance = $this; + + $oldNewline = $this->appendNewline; + $this->appendNewline = false; + array_walk($records, function (&$value, $key) use ($instance) { + $value = $instance->format($value); + }); + $this->appendNewline = $oldNewline; + + return implode("\n", $records); + } + + /** + * Normalizes given $data. + * + * @param mixed $data + * + * @return mixed + */ + protected function normalize($data) + { + if (is_array($data) || $data instanceof \Traversable) { + $normalized = array(); + + $count = 1; + foreach ($data as $key => $value) { + if ($count++ >= 1000) { + $normalized['...'] = 'Over 1000 items, aborting normalization'; + break; + } + $normalized[$key] = $this->normalize($value); + } + + return $normalized; + } + + if ($data instanceof Exception || $data instanceof Throwable) { + return $this->normalizeException($data); + } + + return $data; + } + + /** + * Normalizes given exception with or without its own stack trace based on + * `includeStacktraces` property. + * + * @param Exception|Throwable $e + * + * @return array + */ + protected function normalizeException($e) + { + // TODO 2.0 only check for Throwable + if (!$e instanceof Exception && !$e instanceof Throwable) { + throw new \InvalidArgumentException('Exception/Throwable expected, got '.gettype($e).' / '.get_class($e)); + } + + $data = array( + 'class' => get_class($e), + 'message' => $e->getMessage(), + 'code' => $e->getCode(), + 'file' => $e->getFile().':'.$e->getLine(), + ); + + if ($this->includeStacktraces) { + $trace = $e->getTrace(); + foreach ($trace as $frame) { + if (isset($frame['file'])) { + $data['trace'][] = $frame['file'].':'.$frame['line']; + } elseif (isset($frame['function']) && $frame['function'] === '{closure}') { + // We should again normalize the frames, because it might contain invalid items + $data['trace'][] = $frame['function']; + } else { + // We should again normalize the frames, because it might contain invalid items + $data['trace'][] = $this->normalize($frame); + } + } + } + + if ($previous = $e->getPrevious()) { + $data['previous'] = $this->normalizeException($previous); + } + + return $data; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LineFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LineFormatter.php new file mode 100644 index 0000000..d3e209e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LineFormatter.php @@ -0,0 +1,179 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +/** + * Formats incoming records into a one-line string + * + * This is especially useful for logging to files + * + * @author Jordi Boggiano + * @author Christophe Coevoet + */ +class LineFormatter extends NormalizerFormatter +{ + const SIMPLE_FORMAT = "[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n"; + + protected $format; + protected $allowInlineLineBreaks; + protected $ignoreEmptyContextAndExtra; + protected $includeStacktraces; + + /** + * @param string $format The format of the message + * @param string $dateFormat The format of the timestamp: one supported by DateTime::format + * @param bool $allowInlineLineBreaks Whether to allow inline line breaks in log entries + * @param bool $ignoreEmptyContextAndExtra + */ + public function __construct($format = null, $dateFormat = null, $allowInlineLineBreaks = false, $ignoreEmptyContextAndExtra = false) + { + $this->format = $format ?: static::SIMPLE_FORMAT; + $this->allowInlineLineBreaks = $allowInlineLineBreaks; + $this->ignoreEmptyContextAndExtra = $ignoreEmptyContextAndExtra; + parent::__construct($dateFormat); + } + + public function includeStacktraces($include = true) + { + $this->includeStacktraces = $include; + if ($this->includeStacktraces) { + $this->allowInlineLineBreaks = true; + } + } + + public function allowInlineLineBreaks($allow = true) + { + $this->allowInlineLineBreaks = $allow; + } + + public function ignoreEmptyContextAndExtra($ignore = true) + { + $this->ignoreEmptyContextAndExtra = $ignore; + } + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + $vars = parent::format($record); + + $output = $this->format; + + foreach ($vars['extra'] as $var => $val) { + if (false !== strpos($output, '%extra.'.$var.'%')) { + $output = str_replace('%extra.'.$var.'%', $this->stringify($val), $output); + unset($vars['extra'][$var]); + } + } + + + foreach ($vars['context'] as $var => $val) { + if (false !== strpos($output, '%context.'.$var.'%')) { + $output = str_replace('%context.'.$var.'%', $this->stringify($val), $output); + unset($vars['context'][$var]); + } + } + + if ($this->ignoreEmptyContextAndExtra) { + if (empty($vars['context'])) { + unset($vars['context']); + $output = str_replace('%context%', '', $output); + } + + if (empty($vars['extra'])) { + unset($vars['extra']); + $output = str_replace('%extra%', '', $output); + } + } + + foreach ($vars as $var => $val) { + if (false !== strpos($output, '%'.$var.'%')) { + $output = str_replace('%'.$var.'%', $this->stringify($val), $output); + } + } + + // remove leftover %extra.xxx% and %context.xxx% if any + if (false !== strpos($output, '%')) { + $output = preg_replace('/%(?:extra|context)\..+?%/', '', $output); + } + + return $output; + } + + public function formatBatch(array $records) + { + $message = ''; + foreach ($records as $record) { + $message .= $this->format($record); + } + + return $message; + } + + public function stringify($value) + { + return $this->replaceNewlines($this->convertToString($value)); + } + + protected function normalizeException($e) + { + // TODO 2.0 only check for Throwable + if (!$e instanceof \Exception && !$e instanceof \Throwable) { + throw new \InvalidArgumentException('Exception/Throwable expected, got '.gettype($e).' / '.get_class($e)); + } + + $previousText = ''; + if ($previous = $e->getPrevious()) { + do { + $previousText .= ', '.get_class($previous).'(code: '.$previous->getCode().'): '.$previous->getMessage().' at '.$previous->getFile().':'.$previous->getLine(); + } while ($previous = $previous->getPrevious()); + } + + $str = '[object] ('.get_class($e).'(code: '.$e->getCode().'): '.$e->getMessage().' at '.$e->getFile().':'.$e->getLine().$previousText.')'; + if ($this->includeStacktraces) { + $str .= "\n[stacktrace]\n".$e->getTraceAsString()."\n"; + } + + return $str; + } + + protected function convertToString($data) + { + if (null === $data || is_bool($data)) { + return var_export($data, true); + } + + if (is_scalar($data)) { + return (string) $data; + } + + if (version_compare(PHP_VERSION, '5.4.0', '>=')) { + return $this->toJson($data, true); + } + + return str_replace('\\/', '/', @json_encode($data)); + } + + protected function replaceNewlines($str) + { + if ($this->allowInlineLineBreaks) { + if (0 === strpos($str, '{')) { + return str_replace(array('\r', '\n'), array("\r", "\n"), $str); + } + + return $str; + } + + return str_replace(array("\r\n", "\r", "\n"), ' ', $str); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LogglyFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LogglyFormatter.php new file mode 100644 index 0000000..401859b --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LogglyFormatter.php @@ -0,0 +1,47 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +/** + * Encodes message information into JSON in a format compatible with Loggly. + * + * @author Adam Pancutt + */ +class LogglyFormatter extends JsonFormatter +{ + /** + * Overrides the default batch mode to new lines for compatibility with the + * Loggly bulk API. + * + * @param int $batchMode + */ + public function __construct($batchMode = self::BATCH_MODE_NEWLINES, $appendNewline = false) + { + parent::__construct($batchMode, $appendNewline); + } + + /** + * Appends the 'timestamp' parameter for indexing by Loggly. + * + * @see https://www.loggly.com/docs/automated-parsing/#json + * @see \Monolog\Formatter\JsonFormatter::format() + */ + public function format(array $record) + { + if (isset($record["datetime"]) && ($record["datetime"] instanceof \DateTime)) { + $record["timestamp"] = $record["datetime"]->format("Y-m-d\TH:i:s.uO"); + // TODO 2.0 unset the 'datetime' parameter, retained for BC + } + + return parent::format($record); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LogstashFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LogstashFormatter.php new file mode 100644 index 0000000..8f83bec --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/LogstashFormatter.php @@ -0,0 +1,166 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +/** + * Serializes a log message to Logstash Event Format + * + * @see http://logstash.net/ + * @see https://github.com/logstash/logstash/blob/master/lib/logstash/event.rb + * + * @author Tim Mower + */ +class LogstashFormatter extends NormalizerFormatter +{ + const V0 = 0; + const V1 = 1; + + /** + * @var string the name of the system for the Logstash log message, used to fill the @source field + */ + protected $systemName; + + /** + * @var string an application name for the Logstash log message, used to fill the @type field + */ + protected $applicationName; + + /** + * @var string a prefix for 'extra' fields from the Monolog record (optional) + */ + protected $extraPrefix; + + /** + * @var string a prefix for 'context' fields from the Monolog record (optional) + */ + protected $contextPrefix; + + /** + * @var int logstash format version to use + */ + protected $version; + + /** + * @param string $applicationName the application that sends the data, used as the "type" field of logstash + * @param string $systemName the system/machine name, used as the "source" field of logstash, defaults to the hostname of the machine + * @param string $extraPrefix prefix for extra keys inside logstash "fields" + * @param string $contextPrefix prefix for context keys inside logstash "fields", defaults to ctxt_ + * @param int $version the logstash format version to use, defaults to 0 + */ + public function __construct($applicationName, $systemName = null, $extraPrefix = null, $contextPrefix = 'ctxt_', $version = self::V0) + { + // logstash requires a ISO 8601 format date with optional millisecond precision. + parent::__construct('Y-m-d\TH:i:s.uP'); + + $this->systemName = $systemName ?: gethostname(); + $this->applicationName = $applicationName; + $this->extraPrefix = $extraPrefix; + $this->contextPrefix = $contextPrefix; + $this->version = $version; + } + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + $record = parent::format($record); + + if ($this->version === self::V1) { + $message = $this->formatV1($record); + } else { + $message = $this->formatV0($record); + } + + return $this->toJson($message) . "\n"; + } + + protected function formatV0(array $record) + { + if (empty($record['datetime'])) { + $record['datetime'] = gmdate('c'); + } + $message = array( + '@timestamp' => $record['datetime'], + '@source' => $this->systemName, + '@fields' => array(), + ); + if (isset($record['message'])) { + $message['@message'] = $record['message']; + } + if (isset($record['channel'])) { + $message['@tags'] = array($record['channel']); + $message['@fields']['channel'] = $record['channel']; + } + if (isset($record['level'])) { + $message['@fields']['level'] = $record['level']; + } + if ($this->applicationName) { + $message['@type'] = $this->applicationName; + } + if (isset($record['extra']['server'])) { + $message['@source_host'] = $record['extra']['server']; + } + if (isset($record['extra']['url'])) { + $message['@source_path'] = $record['extra']['url']; + } + if (!empty($record['extra'])) { + foreach ($record['extra'] as $key => $val) { + $message['@fields'][$this->extraPrefix . $key] = $val; + } + } + if (!empty($record['context'])) { + foreach ($record['context'] as $key => $val) { + $message['@fields'][$this->contextPrefix . $key] = $val; + } + } + + return $message; + } + + protected function formatV1(array $record) + { + if (empty($record['datetime'])) { + $record['datetime'] = gmdate('c'); + } + $message = array( + '@timestamp' => $record['datetime'], + '@version' => 1, + 'host' => $this->systemName, + ); + if (isset($record['message'])) { + $message['message'] = $record['message']; + } + if (isset($record['channel'])) { + $message['type'] = $record['channel']; + $message['channel'] = $record['channel']; + } + if (isset($record['level_name'])) { + $message['level'] = $record['level_name']; + } + if ($this->applicationName) { + $message['type'] = $this->applicationName; + } + if (!empty($record['extra'])) { + foreach ($record['extra'] as $key => $val) { + $message[$this->extraPrefix . $key] = $val; + } + } + if (!empty($record['context'])) { + foreach ($record['context'] as $key => $val) { + $message[$this->contextPrefix . $key] = $val; + } + } + + return $message; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/MongoDBFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/MongoDBFormatter.php new file mode 100644 index 0000000..eb067bb --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/MongoDBFormatter.php @@ -0,0 +1,105 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +/** + * Formats a record for use with the MongoDBHandler. + * + * @author Florian Plattner + */ +class MongoDBFormatter implements FormatterInterface +{ + private $exceptionTraceAsString; + private $maxNestingLevel; + + /** + * @param int $maxNestingLevel 0 means infinite nesting, the $record itself is level 1, $record['context'] is 2 + * @param bool $exceptionTraceAsString set to false to log exception traces as a sub documents instead of strings + */ + public function __construct($maxNestingLevel = 3, $exceptionTraceAsString = true) + { + $this->maxNestingLevel = max($maxNestingLevel, 0); + $this->exceptionTraceAsString = (bool) $exceptionTraceAsString; + } + + /** + * {@inheritDoc} + */ + public function format(array $record) + { + return $this->formatArray($record); + } + + /** + * {@inheritDoc} + */ + public function formatBatch(array $records) + { + foreach ($records as $key => $record) { + $records[$key] = $this->format($record); + } + + return $records; + } + + protected function formatArray(array $record, $nestingLevel = 0) + { + if ($this->maxNestingLevel == 0 || $nestingLevel <= $this->maxNestingLevel) { + foreach ($record as $name => $value) { + if ($value instanceof \DateTime) { + $record[$name] = $this->formatDate($value, $nestingLevel + 1); + } elseif ($value instanceof \Exception) { + $record[$name] = $this->formatException($value, $nestingLevel + 1); + } elseif (is_array($value)) { + $record[$name] = $this->formatArray($value, $nestingLevel + 1); + } elseif (is_object($value)) { + $record[$name] = $this->formatObject($value, $nestingLevel + 1); + } + } + } else { + $record = '[...]'; + } + + return $record; + } + + protected function formatObject($value, $nestingLevel) + { + $objectVars = get_object_vars($value); + $objectVars['class'] = get_class($value); + + return $this->formatArray($objectVars, $nestingLevel); + } + + protected function formatException(\Exception $exception, $nestingLevel) + { + $formattedException = array( + 'class' => get_class($exception), + 'message' => $exception->getMessage(), + 'code' => $exception->getCode(), + 'file' => $exception->getFile() . ':' . $exception->getLine(), + ); + + if ($this->exceptionTraceAsString === true) { + $formattedException['trace'] = $exception->getTraceAsString(); + } else { + $formattedException['trace'] = $exception->getTrace(); + } + + return $this->formatArray($formattedException, $nestingLevel); + } + + protected function formatDate(\DateTime $value, $nestingLevel) + { + return new \MongoDate($value->getTimestamp()); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/NormalizerFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/NormalizerFormatter.php new file mode 100644 index 0000000..d441488 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/NormalizerFormatter.php @@ -0,0 +1,297 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +use Exception; + +/** + * Normalizes incoming records to remove objects/resources so it's easier to dump to various targets + * + * @author Jordi Boggiano + */ +class NormalizerFormatter implements FormatterInterface +{ + const SIMPLE_DATE = "Y-m-d H:i:s"; + + protected $dateFormat; + + /** + * @param string $dateFormat The format of the timestamp: one supported by DateTime::format + */ + public function __construct($dateFormat = null) + { + $this->dateFormat = $dateFormat ?: static::SIMPLE_DATE; + if (!function_exists('json_encode')) { + throw new \RuntimeException('PHP\'s json extension is required to use Monolog\'s NormalizerFormatter'); + } + } + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + return $this->normalize($record); + } + + /** + * {@inheritdoc} + */ + public function formatBatch(array $records) + { + foreach ($records as $key => $record) { + $records[$key] = $this->format($record); + } + + return $records; + } + + protected function normalize($data) + { + if (null === $data || is_scalar($data)) { + if (is_float($data)) { + if (is_infinite($data)) { + return ($data > 0 ? '' : '-') . 'INF'; + } + if (is_nan($data)) { + return 'NaN'; + } + } + + return $data; + } + + if (is_array($data)) { + $normalized = array(); + + $count = 1; + foreach ($data as $key => $value) { + if ($count++ >= 1000) { + $normalized['...'] = 'Over 1000 items ('.count($data).' total), aborting normalization'; + break; + } + $normalized[$key] = $this->normalize($value); + } + + return $normalized; + } + + if ($data instanceof \DateTime) { + return $data->format($this->dateFormat); + } + + if (is_object($data)) { + // TODO 2.0 only check for Throwable + if ($data instanceof Exception || (PHP_VERSION_ID > 70000 && $data instanceof \Throwable)) { + return $this->normalizeException($data); + } + + // non-serializable objects that implement __toString stringified + if (method_exists($data, '__toString') && !$data instanceof \JsonSerializable) { + $value = $data->__toString(); + } else { + // the rest is json-serialized in some way + $value = $this->toJson($data, true); + } + + return sprintf("[object] (%s: %s)", get_class($data), $value); + } + + if (is_resource($data)) { + return sprintf('[resource] (%s)', get_resource_type($data)); + } + + return '[unknown('.gettype($data).')]'; + } + + protected function normalizeException($e) + { + // TODO 2.0 only check for Throwable + if (!$e instanceof Exception && !$e instanceof \Throwable) { + throw new \InvalidArgumentException('Exception/Throwable expected, got '.gettype($e).' / '.get_class($e)); + } + + $data = array( + 'class' => get_class($e), + 'message' => $e->getMessage(), + 'code' => $e->getCode(), + 'file' => $e->getFile().':'.$e->getLine(), + ); + + if ($e instanceof \SoapFault) { + if (isset($e->faultcode)) { + $data['faultcode'] = $e->faultcode; + } + + if (isset($e->faultactor)) { + $data['faultactor'] = $e->faultactor; + } + + if (isset($e->detail)) { + $data['detail'] = $e->detail; + } + } + + $trace = $e->getTrace(); + foreach ($trace as $frame) { + if (isset($frame['file'])) { + $data['trace'][] = $frame['file'].':'.$frame['line']; + } elseif (isset($frame['function']) && $frame['function'] === '{closure}') { + // We should again normalize the frames, because it might contain invalid items + $data['trace'][] = $frame['function']; + } else { + // We should again normalize the frames, because it might contain invalid items + $data['trace'][] = $this->toJson($this->normalize($frame), true); + } + } + + if ($previous = $e->getPrevious()) { + $data['previous'] = $this->normalizeException($previous); + } + + return $data; + } + + /** + * Return the JSON representation of a value + * + * @param mixed $data + * @param bool $ignoreErrors + * @throws \RuntimeException if encoding fails and errors are not ignored + * @return string + */ + protected function toJson($data, $ignoreErrors = false) + { + // suppress json_encode errors since it's twitchy with some inputs + if ($ignoreErrors) { + return @$this->jsonEncode($data); + } + + $json = $this->jsonEncode($data); + + if ($json === false) { + $json = $this->handleJsonError(json_last_error(), $data); + } + + return $json; + } + + /** + * @param mixed $data + * @return string JSON encoded data or null on failure + */ + private function jsonEncode($data) + { + if (version_compare(PHP_VERSION, '5.4.0', '>=')) { + return json_encode($data, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE); + } + + return json_encode($data); + } + + /** + * Handle a json_encode failure. + * + * If the failure is due to invalid string encoding, try to clean the + * input and encode again. If the second encoding attempt fails, the + * inital error is not encoding related or the input can't be cleaned then + * raise a descriptive exception. + * + * @param int $code return code of json_last_error function + * @param mixed $data data that was meant to be encoded + * @throws \RuntimeException if failure can't be corrected + * @return string JSON encoded data after error correction + */ + private function handleJsonError($code, $data) + { + if ($code !== JSON_ERROR_UTF8) { + $this->throwEncodeError($code, $data); + } + + if (is_string($data)) { + $this->detectAndCleanUtf8($data); + } elseif (is_array($data)) { + array_walk_recursive($data, array($this, 'detectAndCleanUtf8')); + } else { + $this->throwEncodeError($code, $data); + } + + $json = $this->jsonEncode($data); + + if ($json === false) { + $this->throwEncodeError(json_last_error(), $data); + } + + return $json; + } + + /** + * Throws an exception according to a given code with a customized message + * + * @param int $code return code of json_last_error function + * @param mixed $data data that was meant to be encoded + * @throws \RuntimeException + */ + private function throwEncodeError($code, $data) + { + switch ($code) { + case JSON_ERROR_DEPTH: + $msg = 'Maximum stack depth exceeded'; + break; + case JSON_ERROR_STATE_MISMATCH: + $msg = 'Underflow or the modes mismatch'; + break; + case JSON_ERROR_CTRL_CHAR: + $msg = 'Unexpected control character found'; + break; + case JSON_ERROR_UTF8: + $msg = 'Malformed UTF-8 characters, possibly incorrectly encoded'; + break; + default: + $msg = 'Unknown error'; + } + + throw new \RuntimeException('JSON encoding failed: '.$msg.'. Encoding: '.var_export($data, true)); + } + + /** + * Detect invalid UTF-8 string characters and convert to valid UTF-8. + * + * Valid UTF-8 input will be left unmodified, but strings containing + * invalid UTF-8 codepoints will be reencoded as UTF-8 with an assumed + * original encoding of ISO-8859-15. This conversion may result in + * incorrect output if the actual encoding was not ISO-8859-15, but it + * will be clean UTF-8 output and will not rely on expensive and fragile + * detection algorithms. + * + * Function converts the input in place in the passed variable so that it + * can be used as a callback for array_walk_recursive. + * + * @param mixed &$data Input to check and convert if needed + * @private + */ + public function detectAndCleanUtf8(&$data) + { + if (is_string($data) && !preg_match('//u', $data)) { + $data = preg_replace_callback( + '/[\x80-\xFF]+/', + function ($m) { return utf8_encode($m[0]); }, + $data + ); + $data = str_replace( + array('¤', '¦', '¨', '´', '¸', '¼', '½', '¾'), + array('€', 'Š', 'š', 'Ž', 'ž', 'Œ', 'œ', 'Ÿ'), + $data + ); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ScalarFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ScalarFormatter.php new file mode 100644 index 0000000..5d345d5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/ScalarFormatter.php @@ -0,0 +1,48 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +/** + * Formats data into an associative array of scalar values. + * Objects and arrays will be JSON encoded. + * + * @author Andrew Lawson + */ +class ScalarFormatter extends NormalizerFormatter +{ + /** + * {@inheritdoc} + */ + public function format(array $record) + { + foreach ($record as $key => $value) { + $record[$key] = $this->normalizeValue($value); + } + + return $record; + } + + /** + * @param mixed $value + * @return mixed + */ + protected function normalizeValue($value) + { + $normalized = $this->normalize($value); + + if (is_array($normalized) || is_object($normalized)) { + return $this->toJson($normalized, true); + } + + return $normalized; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/WildfireFormatter.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/WildfireFormatter.php new file mode 100644 index 0000000..654710a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Formatter/WildfireFormatter.php @@ -0,0 +1,113 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Formatter; + +use Monolog\Logger; + +/** + * Serializes a log message according to Wildfire's header requirements + * + * @author Eric Clemmons (@ericclemmons) + * @author Christophe Coevoet + * @author Kirill chEbba Chebunin + */ +class WildfireFormatter extends NormalizerFormatter +{ + const TABLE = 'table'; + + /** + * Translates Monolog log levels to Wildfire levels. + */ + private $logLevels = array( + Logger::DEBUG => 'LOG', + Logger::INFO => 'INFO', + Logger::NOTICE => 'INFO', + Logger::WARNING => 'WARN', + Logger::ERROR => 'ERROR', + Logger::CRITICAL => 'ERROR', + Logger::ALERT => 'ERROR', + Logger::EMERGENCY => 'ERROR', + ); + + /** + * {@inheritdoc} + */ + public function format(array $record) + { + // Retrieve the line and file if set and remove them from the formatted extra + $file = $line = ''; + if (isset($record['extra']['file'])) { + $file = $record['extra']['file']; + unset($record['extra']['file']); + } + if (isset($record['extra']['line'])) { + $line = $record['extra']['line']; + unset($record['extra']['line']); + } + + $record = $this->normalize($record); + $message = array('message' => $record['message']); + $handleError = false; + if ($record['context']) { + $message['context'] = $record['context']; + $handleError = true; + } + if ($record['extra']) { + $message['extra'] = $record['extra']; + $handleError = true; + } + if (count($message) === 1) { + $message = reset($message); + } + + if (isset($record['context'][self::TABLE])) { + $type = 'TABLE'; + $label = $record['channel'] .': '. $record['message']; + $message = $record['context'][self::TABLE]; + } else { + $type = $this->logLevels[$record['level']]; + $label = $record['channel']; + } + + // Create JSON object describing the appearance of the message in the console + $json = $this->toJson(array( + array( + 'Type' => $type, + 'File' => $file, + 'Line' => $line, + 'Label' => $label, + ), + $message, + ), $handleError); + + // The message itself is a serialization of the above JSON object + it's length + return sprintf( + '%s|%s|', + strlen($json), + $json + ); + } + + public function formatBatch(array $records) + { + throw new \BadMethodCallException('Batch formatting does not make sense for the WildfireFormatter'); + } + + protected function normalize($data) + { + if (is_object($data) && !$data instanceof \DateTime) { + return $data; + } + + return parent::normalize($data); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractHandler.php new file mode 100644 index 0000000..758a425 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractHandler.php @@ -0,0 +1,186 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\FormatterInterface; +use Monolog\Formatter\LineFormatter; + +/** + * Base Handler class providing the Handler structure + * + * @author Jordi Boggiano + */ +abstract class AbstractHandler implements HandlerInterface +{ + protected $level = Logger::DEBUG; + protected $bubble = true; + + /** + * @var FormatterInterface + */ + protected $formatter; + protected $processors = array(); + + /** + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($level = Logger::DEBUG, $bubble = true) + { + $this->setLevel($level); + $this->bubble = $bubble; + } + + /** + * {@inheritdoc} + */ + public function isHandling(array $record) + { + return $record['level'] >= $this->level; + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + foreach ($records as $record) { + $this->handle($record); + } + } + + /** + * Closes the handler. + * + * This will be called automatically when the object is destroyed + */ + public function close() + { + } + + /** + * {@inheritdoc} + */ + public function pushProcessor($callback) + { + if (!is_callable($callback)) { + throw new \InvalidArgumentException('Processors must be valid callables (callback or object with an __invoke method), '.var_export($callback, true).' given'); + } + array_unshift($this->processors, $callback); + + return $this; + } + + /** + * {@inheritdoc} + */ + public function popProcessor() + { + if (!$this->processors) { + throw new \LogicException('You tried to pop from an empty processor stack.'); + } + + return array_shift($this->processors); + } + + /** + * {@inheritdoc} + */ + public function setFormatter(FormatterInterface $formatter) + { + $this->formatter = $formatter; + + return $this; + } + + /** + * {@inheritdoc} + */ + public function getFormatter() + { + if (!$this->formatter) { + $this->formatter = $this->getDefaultFormatter(); + } + + return $this->formatter; + } + + /** + * Sets minimum logging level at which this handler will be triggered. + * + * @param int|string $level Level or level name + * @return self + */ + public function setLevel($level) + { + $this->level = Logger::toMonologLevel($level); + + return $this; + } + + /** + * Gets minimum logging level at which this handler will be triggered. + * + * @return int + */ + public function getLevel() + { + return $this->level; + } + + /** + * Sets the bubbling behavior. + * + * @param Boolean $bubble true means that this handler allows bubbling. + * false means that bubbling is not permitted. + * @return self + */ + public function setBubble($bubble) + { + $this->bubble = $bubble; + + return $this; + } + + /** + * Gets the bubbling behavior. + * + * @return Boolean true means that this handler allows bubbling. + * false means that bubbling is not permitted. + */ + public function getBubble() + { + return $this->bubble; + } + + public function __destruct() + { + try { + $this->close(); + } catch (\Exception $e) { + // do nothing + } catch (\Throwable $e) { + // do nothing + } + } + + /** + * Gets the default formatter. + * + * @return FormatterInterface + */ + protected function getDefaultFormatter() + { + return new LineFormatter(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractProcessingHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractProcessingHandler.php new file mode 100644 index 0000000..6f18f72 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractProcessingHandler.php @@ -0,0 +1,66 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +/** + * Base Handler class providing the Handler structure + * + * Classes extending it should (in most cases) only implement write($record) + * + * @author Jordi Boggiano + * @author Christophe Coevoet + */ +abstract class AbstractProcessingHandler extends AbstractHandler +{ + /** + * {@inheritdoc} + */ + public function handle(array $record) + { + if (!$this->isHandling($record)) { + return false; + } + + $record = $this->processRecord($record); + + $record['formatted'] = $this->getFormatter()->format($record); + + $this->write($record); + + return false === $this->bubble; + } + + /** + * Writes the record down to the log of the implementing handler + * + * @param array $record + * @return void + */ + abstract protected function write(array $record); + + /** + * Processes a record. + * + * @param array $record + * @return array + */ + protected function processRecord(array $record) + { + if ($this->processors) { + foreach ($this->processors as $processor) { + $record = call_user_func($processor, $record); + } + } + + return $record; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractSyslogHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractSyslogHandler.php new file mode 100644 index 0000000..e2b2832 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AbstractSyslogHandler.php @@ -0,0 +1,101 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\LineFormatter; + +/** + * Common syslog functionality + */ +abstract class AbstractSyslogHandler extends AbstractProcessingHandler +{ + protected $facility; + + /** + * Translates Monolog log levels to syslog log priorities. + */ + protected $logLevels = array( + Logger::DEBUG => LOG_DEBUG, + Logger::INFO => LOG_INFO, + Logger::NOTICE => LOG_NOTICE, + Logger::WARNING => LOG_WARNING, + Logger::ERROR => LOG_ERR, + Logger::CRITICAL => LOG_CRIT, + Logger::ALERT => LOG_ALERT, + Logger::EMERGENCY => LOG_EMERG, + ); + + /** + * List of valid log facility names. + */ + protected $facilities = array( + 'auth' => LOG_AUTH, + 'authpriv' => LOG_AUTHPRIV, + 'cron' => LOG_CRON, + 'daemon' => LOG_DAEMON, + 'kern' => LOG_KERN, + 'lpr' => LOG_LPR, + 'mail' => LOG_MAIL, + 'news' => LOG_NEWS, + 'syslog' => LOG_SYSLOG, + 'user' => LOG_USER, + 'uucp' => LOG_UUCP, + ); + + /** + * @param mixed $facility + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($facility = LOG_USER, $level = Logger::DEBUG, $bubble = true) + { + parent::__construct($level, $bubble); + + if (!defined('PHP_WINDOWS_VERSION_BUILD')) { + $this->facilities['local0'] = LOG_LOCAL0; + $this->facilities['local1'] = LOG_LOCAL1; + $this->facilities['local2'] = LOG_LOCAL2; + $this->facilities['local3'] = LOG_LOCAL3; + $this->facilities['local4'] = LOG_LOCAL4; + $this->facilities['local5'] = LOG_LOCAL5; + $this->facilities['local6'] = LOG_LOCAL6; + $this->facilities['local7'] = LOG_LOCAL7; + } else { + $this->facilities['local0'] = 128; // LOG_LOCAL0 + $this->facilities['local1'] = 136; // LOG_LOCAL1 + $this->facilities['local2'] = 144; // LOG_LOCAL2 + $this->facilities['local3'] = 152; // LOG_LOCAL3 + $this->facilities['local4'] = 160; // LOG_LOCAL4 + $this->facilities['local5'] = 168; // LOG_LOCAL5 + $this->facilities['local6'] = 176; // LOG_LOCAL6 + $this->facilities['local7'] = 184; // LOG_LOCAL7 + } + + // convert textual description of facility to syslog constant + if (array_key_exists(strtolower($facility), $this->facilities)) { + $facility = $this->facilities[strtolower($facility)]; + } elseif (!in_array($facility, array_values($this->facilities), true)) { + throw new \UnexpectedValueException('Unknown facility value "'.$facility.'" given'); + } + + $this->facility = $facility; + } + + /** + * {@inheritdoc} + */ + protected function getDefaultFormatter() + { + return new LineFormatter('%channel%.%level_name%: %message% %context% %extra%'); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AmqpHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AmqpHandler.php new file mode 100644 index 0000000..e5a46bc --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/AmqpHandler.php @@ -0,0 +1,148 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\JsonFormatter; +use PhpAmqpLib\Message\AMQPMessage; +use PhpAmqpLib\Channel\AMQPChannel; +use AMQPExchange; + +class AmqpHandler extends AbstractProcessingHandler +{ + /** + * @var AMQPExchange|AMQPChannel $exchange + */ + protected $exchange; + + /** + * @var string + */ + protected $exchangeName; + + /** + * @param AMQPExchange|AMQPChannel $exchange AMQPExchange (php AMQP ext) or PHP AMQP lib channel, ready for use + * @param string $exchangeName + * @param int $level + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($exchange, $exchangeName = 'log', $level = Logger::DEBUG, $bubble = true) + { + if ($exchange instanceof AMQPExchange) { + $exchange->setName($exchangeName); + } elseif ($exchange instanceof AMQPChannel) { + $this->exchangeName = $exchangeName; + } else { + throw new \InvalidArgumentException('PhpAmqpLib\Channel\AMQPChannel or AMQPExchange instance required'); + } + $this->exchange = $exchange; + + parent::__construct($level, $bubble); + } + + /** + * {@inheritDoc} + */ + protected function write(array $record) + { + $data = $record["formatted"]; + $routingKey = $this->getRoutingKey($record); + + if ($this->exchange instanceof AMQPExchange) { + $this->exchange->publish( + $data, + $routingKey, + 0, + array( + 'delivery_mode' => 2, + 'content_type' => 'application/json', + ) + ); + } else { + $this->exchange->basic_publish( + $this->createAmqpMessage($data), + $this->exchangeName, + $routingKey + ); + } + } + + /** + * {@inheritDoc} + */ + public function handleBatch(array $records) + { + if ($this->exchange instanceof AMQPExchange) { + parent::handleBatch($records); + + return; + } + + foreach ($records as $record) { + if (!$this->isHandling($record)) { + continue; + } + + $record = $this->processRecord($record); + $data = $this->getFormatter()->format($record); + + $this->exchange->batch_basic_publish( + $this->createAmqpMessage($data), + $this->exchangeName, + $this->getRoutingKey($record) + ); + } + + $this->exchange->publish_batch(); + } + + /** + * Gets the routing key for the AMQP exchange + * + * @param array $record + * @return string + */ + protected function getRoutingKey(array $record) + { + $routingKey = sprintf( + '%s.%s', + // TODO 2.0 remove substr call + substr($record['level_name'], 0, 4), + $record['channel'] + ); + + return strtolower($routingKey); + } + + /** + * @param string $data + * @return AMQPMessage + */ + private function createAmqpMessage($data) + { + return new AMQPMessage( + (string) $data, + array( + 'delivery_mode' => 2, + 'content_type' => 'application/json', + ) + ); + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new JsonFormatter(JsonFormatter::BATCH_MODE_JSON, false); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php new file mode 100644 index 0000000..b3a21bd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php @@ -0,0 +1,230 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\LineFormatter; + +/** + * Handler sending logs to browser's javascript console with no browser extension required + * + * @author Olivier Poitrey + */ +class BrowserConsoleHandler extends AbstractProcessingHandler +{ + protected static $initialized = false; + protected static $records = array(); + + /** + * {@inheritDoc} + * + * Formatted output may contain some formatting markers to be transferred to `console.log` using the %c format. + * + * Example of formatted string: + * + * You can do [[blue text]]{color: blue} or [[green background]]{background-color: green; color: white} + */ + protected function getDefaultFormatter() + { + return new LineFormatter('[[%channel%]]{macro: autolabel} [[%level_name%]]{font-weight: bold} %message%'); + } + + /** + * {@inheritDoc} + */ + protected function write(array $record) + { + // Accumulate records + self::$records[] = $record; + + // Register shutdown handler if not already done + if (!self::$initialized) { + self::$initialized = true; + $this->registerShutdownFunction(); + } + } + + /** + * Convert records to javascript console commands and send it to the browser. + * This method is automatically called on PHP shutdown if output is HTML or Javascript. + */ + public static function send() + { + $format = self::getResponseFormat(); + if ($format === 'unknown') { + return; + } + + if (count(self::$records)) { + if ($format === 'html') { + self::writeOutput(''); + } elseif ($format === 'js') { + self::writeOutput(self::generateScript()); + } + self::reset(); + } + } + + /** + * Forget all logged records + */ + public static function reset() + { + self::$records = array(); + } + + /** + * Wrapper for register_shutdown_function to allow overriding + */ + protected function registerShutdownFunction() + { + if (PHP_SAPI !== 'cli') { + register_shutdown_function(array('Monolog\Handler\BrowserConsoleHandler', 'send')); + } + } + + /** + * Wrapper for echo to allow overriding + * + * @param string $str + */ + protected static function writeOutput($str) + { + echo $str; + } + + /** + * Checks the format of the response + * + * If Content-Type is set to application/javascript or text/javascript -> js + * If Content-Type is set to text/html, or is unset -> html + * If Content-Type is anything else -> unknown + * + * @return string One of 'js', 'html' or 'unknown' + */ + protected static function getResponseFormat() + { + // Check content type + foreach (headers_list() as $header) { + if (stripos($header, 'content-type:') === 0) { + // This handler only works with HTML and javascript outputs + // text/javascript is obsolete in favour of application/javascript, but still used + if (stripos($header, 'application/javascript') !== false || stripos($header, 'text/javascript') !== false) { + return 'js'; + } + if (stripos($header, 'text/html') === false) { + return 'unknown'; + } + break; + } + } + + return 'html'; + } + + private static function generateScript() + { + $script = array(); + foreach (self::$records as $record) { + $context = self::dump('Context', $record['context']); + $extra = self::dump('Extra', $record['extra']); + + if (empty($context) && empty($extra)) { + $script[] = self::call_array('log', self::handleStyles($record['formatted'])); + } else { + $script = array_merge($script, + array(self::call_array('groupCollapsed', self::handleStyles($record['formatted']))), + $context, + $extra, + array(self::call('groupEnd')) + ); + } + } + + return "(function (c) {if (c && c.groupCollapsed) {\n" . implode("\n", $script) . "\n}})(console);"; + } + + private static function handleStyles($formatted) + { + $args = array(self::quote('font-weight: normal')); + $format = '%c' . $formatted; + preg_match_all('/\[\[(.*?)\]\]\{([^}]*)\}/s', $format, $matches, PREG_OFFSET_CAPTURE | PREG_SET_ORDER); + + foreach (array_reverse($matches) as $match) { + $args[] = self::quote(self::handleCustomStyles($match[2][0], $match[1][0])); + $args[] = '"font-weight: normal"'; + + $pos = $match[0][1]; + $format = substr($format, 0, $pos) . '%c' . $match[1][0] . '%c' . substr($format, $pos + strlen($match[0][0])); + } + + array_unshift($args, self::quote($format)); + + return $args; + } + + private static function handleCustomStyles($style, $string) + { + static $colors = array('blue', 'green', 'red', 'magenta', 'orange', 'black', 'grey'); + static $labels = array(); + + return preg_replace_callback('/macro\s*:(.*?)(?:;|$)/', function ($m) use ($string, &$colors, &$labels) { + if (trim($m[1]) === 'autolabel') { + // Format the string as a label with consistent auto assigned background color + if (!isset($labels[$string])) { + $labels[$string] = $colors[count($labels) % count($colors)]; + } + $color = $labels[$string]; + + return "background-color: $color; color: white; border-radius: 3px; padding: 0 2px 0 2px"; + } + + return $m[1]; + }, $style); + } + + private static function dump($title, array $dict) + { + $script = array(); + $dict = array_filter($dict); + if (empty($dict)) { + return $script; + } + $script[] = self::call('log', self::quote('%c%s'), self::quote('font-weight: bold'), self::quote($title)); + foreach ($dict as $key => $value) { + $value = json_encode($value); + if (empty($value)) { + $value = self::quote(''); + } + $script[] = self::call('log', self::quote('%s: %o'), self::quote($key), $value); + } + + return $script; + } + + private static function quote($arg) + { + return '"' . addcslashes($arg, "\"\n\\") . '"'; + } + + private static function call() + { + $args = func_get_args(); + $method = array_shift($args); + + return self::call_array($method, $args); + } + + private static function call_array($method, array $args) + { + return 'c.' . $method . '(' . implode(', ', $args) . ');'; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/BufferHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/BufferHandler.php new file mode 100644 index 0000000..72f8953 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/BufferHandler.php @@ -0,0 +1,117 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Buffers all records until closing the handler and then pass them as batch. + * + * This is useful for a MailHandler to send only one mail per request instead of + * sending one per log message. + * + * @author Christophe Coevoet + */ +class BufferHandler extends AbstractHandler +{ + protected $handler; + protected $bufferSize = 0; + protected $bufferLimit; + protected $flushOnOverflow; + protected $buffer = array(); + protected $initialized = false; + + /** + * @param HandlerInterface $handler Handler. + * @param int $bufferLimit How many entries should be buffered at most, beyond that the oldest items are removed from the buffer. + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + * @param Boolean $flushOnOverflow If true, the buffer is flushed when the max size has been reached, by default oldest entries are discarded + */ + public function __construct(HandlerInterface $handler, $bufferLimit = 0, $level = Logger::DEBUG, $bubble = true, $flushOnOverflow = false) + { + parent::__construct($level, $bubble); + $this->handler = $handler; + $this->bufferLimit = (int) $bufferLimit; + $this->flushOnOverflow = $flushOnOverflow; + } + + /** + * {@inheritdoc} + */ + public function handle(array $record) + { + if ($record['level'] < $this->level) { + return false; + } + + if (!$this->initialized) { + // __destructor() doesn't get called on Fatal errors + register_shutdown_function(array($this, 'close')); + $this->initialized = true; + } + + if ($this->bufferLimit > 0 && $this->bufferSize === $this->bufferLimit) { + if ($this->flushOnOverflow) { + $this->flush(); + } else { + array_shift($this->buffer); + $this->bufferSize--; + } + } + + if ($this->processors) { + foreach ($this->processors as $processor) { + $record = call_user_func($processor, $record); + } + } + + $this->buffer[] = $record; + $this->bufferSize++; + + return false === $this->bubble; + } + + public function flush() + { + if ($this->bufferSize === 0) { + return; + } + + $this->handler->handleBatch($this->buffer); + $this->clear(); + } + + public function __destruct() + { + // suppress the parent behavior since we already have register_shutdown_function() + // to call close(), and the reference contained there will prevent this from being + // GC'd until the end of the request + } + + /** + * {@inheritdoc} + */ + public function close() + { + $this->flush(); + } + + /** + * Clears the buffer without flushing any messages down to the wrapped handler. + */ + public function clear() + { + $this->bufferSize = 0; + $this->buffer = array(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ChromePHPHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ChromePHPHandler.php new file mode 100644 index 0000000..785cb0c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ChromePHPHandler.php @@ -0,0 +1,211 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\ChromePHPFormatter; +use Monolog\Logger; + +/** + * Handler sending logs to the ChromePHP extension (http://www.chromephp.com/) + * + * This also works out of the box with Firefox 43+ + * + * @author Christophe Coevoet + */ +class ChromePHPHandler extends AbstractProcessingHandler +{ + /** + * Version of the extension + */ + const VERSION = '4.0'; + + /** + * Header name + */ + const HEADER_NAME = 'X-ChromeLogger-Data'; + + /** + * Regular expression to detect supported browsers (matches any Chrome, or Firefox 43+) + */ + const USER_AGENT_REGEX = '{\b(?:Chrome/\d+(?:\.\d+)*|HeadlessChrome|Firefox/(?:4[3-9]|[5-9]\d|\d{3,})(?:\.\d)*)\b}'; + + protected static $initialized = false; + + /** + * Tracks whether we sent too much data + * + * Chrome limits the headers to 256KB, so when we sent 240KB we stop sending + * + * @var Boolean + */ + protected static $overflowed = false; + + protected static $json = array( + 'version' => self::VERSION, + 'columns' => array('label', 'log', 'backtrace', 'type'), + 'rows' => array(), + ); + + protected static $sendHeaders = true; + + /** + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($level = Logger::DEBUG, $bubble = true) + { + parent::__construct($level, $bubble); + if (!function_exists('json_encode')) { + throw new \RuntimeException('PHP\'s json extension is required to use Monolog\'s ChromePHPHandler'); + } + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + $messages = array(); + + foreach ($records as $record) { + if ($record['level'] < $this->level) { + continue; + } + $messages[] = $this->processRecord($record); + } + + if (!empty($messages)) { + $messages = $this->getFormatter()->formatBatch($messages); + self::$json['rows'] = array_merge(self::$json['rows'], $messages); + $this->send(); + } + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new ChromePHPFormatter(); + } + + /** + * Creates & sends header for a record + * + * @see sendHeader() + * @see send() + * @param array $record + */ + protected function write(array $record) + { + self::$json['rows'][] = $record['formatted']; + + $this->send(); + } + + /** + * Sends the log header + * + * @see sendHeader() + */ + protected function send() + { + if (self::$overflowed || !self::$sendHeaders) { + return; + } + + if (!self::$initialized) { + self::$initialized = true; + + self::$sendHeaders = $this->headersAccepted(); + if (!self::$sendHeaders) { + return; + } + + self::$json['request_uri'] = isset($_SERVER['REQUEST_URI']) ? $_SERVER['REQUEST_URI'] : ''; + } + + $json = @json_encode(self::$json); + $data = base64_encode(utf8_encode($json)); + if (strlen($data) > 240 * 1024) { + self::$overflowed = true; + + $record = array( + 'message' => 'Incomplete logs, chrome header size limit reached', + 'context' => array(), + 'level' => Logger::WARNING, + 'level_name' => Logger::getLevelName(Logger::WARNING), + 'channel' => 'monolog', + 'datetime' => new \DateTime(), + 'extra' => array(), + ); + self::$json['rows'][count(self::$json['rows']) - 1] = $this->getFormatter()->format($record); + $json = @json_encode(self::$json); + $data = base64_encode(utf8_encode($json)); + } + + if (trim($data) !== '') { + $this->sendHeader(self::HEADER_NAME, $data); + } + } + + /** + * Send header string to the client + * + * @param string $header + * @param string $content + */ + protected function sendHeader($header, $content) + { + if (!headers_sent() && self::$sendHeaders) { + header(sprintf('%s: %s', $header, $content)); + } + } + + /** + * Verifies if the headers are accepted by the current user agent + * + * @return Boolean + */ + protected function headersAccepted() + { + if (empty($_SERVER['HTTP_USER_AGENT'])) { + return false; + } + + return preg_match(self::USER_AGENT_REGEX, $_SERVER['HTTP_USER_AGENT']); + } + + /** + * BC getter for the sendHeaders property that has been made static + */ + public function __get($property) + { + if ('sendHeaders' !== $property) { + throw new \InvalidArgumentException('Undefined property '.$property); + } + + return static::$sendHeaders; + } + + /** + * BC setter for the sendHeaders property that has been made static + */ + public function __set($property, $value) + { + if ('sendHeaders' !== $property) { + throw new \InvalidArgumentException('Undefined property '.$property); + } + + static::$sendHeaders = $value; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/CouchDBHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/CouchDBHandler.php new file mode 100644 index 0000000..cc98697 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/CouchDBHandler.php @@ -0,0 +1,72 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\JsonFormatter; +use Monolog\Logger; + +/** + * CouchDB handler + * + * @author Markus Bachmann + */ +class CouchDBHandler extends AbstractProcessingHandler +{ + private $options; + + public function __construct(array $options = array(), $level = Logger::DEBUG, $bubble = true) + { + $this->options = array_merge(array( + 'host' => 'localhost', + 'port' => 5984, + 'dbname' => 'logger', + 'username' => null, + 'password' => null, + ), $options); + + parent::__construct($level, $bubble); + } + + /** + * {@inheritDoc} + */ + protected function write(array $record) + { + $basicAuth = null; + if ($this->options['username']) { + $basicAuth = sprintf('%s:%s@', $this->options['username'], $this->options['password']); + } + + $url = 'http://'.$basicAuth.$this->options['host'].':'.$this->options['port'].'/'.$this->options['dbname']; + $context = stream_context_create(array( + 'http' => array( + 'method' => 'POST', + 'content' => $record['formatted'], + 'ignore_errors' => true, + 'max_redirects' => 0, + 'header' => 'Content-type: application/json', + ), + )); + + if (false === @file_get_contents($url, null, $context)) { + throw new \RuntimeException(sprintf('Could not connect to %s', $url)); + } + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new JsonFormatter(JsonFormatter::BATCH_MODE_JSON, false); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/CubeHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/CubeHandler.php new file mode 100644 index 0000000..96b3ca0 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/CubeHandler.php @@ -0,0 +1,151 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Logs to Cube. + * + * @link http://square.github.com/cube/ + * @author Wan Chen + */ +class CubeHandler extends AbstractProcessingHandler +{ + private $udpConnection; + private $httpConnection; + private $scheme; + private $host; + private $port; + private $acceptedSchemes = array('http', 'udp'); + + /** + * Create a Cube handler + * + * @throws \UnexpectedValueException when given url is not a valid url. + * A valid url must consist of three parts : protocol://host:port + * Only valid protocols used by Cube are http and udp + */ + public function __construct($url, $level = Logger::DEBUG, $bubble = true) + { + $urlInfo = parse_url($url); + + if (!isset($urlInfo['scheme'], $urlInfo['host'], $urlInfo['port'])) { + throw new \UnexpectedValueException('URL "'.$url.'" is not valid'); + } + + if (!in_array($urlInfo['scheme'], $this->acceptedSchemes)) { + throw new \UnexpectedValueException( + 'Invalid protocol (' . $urlInfo['scheme'] . ').' + . ' Valid options are ' . implode(', ', $this->acceptedSchemes)); + } + + $this->scheme = $urlInfo['scheme']; + $this->host = $urlInfo['host']; + $this->port = $urlInfo['port']; + + parent::__construct($level, $bubble); + } + + /** + * Establish a connection to an UDP socket + * + * @throws \LogicException when unable to connect to the socket + * @throws MissingExtensionException when there is no socket extension + */ + protected function connectUdp() + { + if (!extension_loaded('sockets')) { + throw new MissingExtensionException('The sockets extension is required to use udp URLs with the CubeHandler'); + } + + $this->udpConnection = socket_create(AF_INET, SOCK_DGRAM, 0); + if (!$this->udpConnection) { + throw new \LogicException('Unable to create a socket'); + } + + if (!socket_connect($this->udpConnection, $this->host, $this->port)) { + throw new \LogicException('Unable to connect to the socket at ' . $this->host . ':' . $this->port); + } + } + + /** + * Establish a connection to a http server + * @throws \LogicException when no curl extension + */ + protected function connectHttp() + { + if (!extension_loaded('curl')) { + throw new \LogicException('The curl extension is needed to use http URLs with the CubeHandler'); + } + + $this->httpConnection = curl_init('http://'.$this->host.':'.$this->port.'/1.0/event/put'); + + if (!$this->httpConnection) { + throw new \LogicException('Unable to connect to ' . $this->host . ':' . $this->port); + } + + curl_setopt($this->httpConnection, CURLOPT_CUSTOMREQUEST, "POST"); + curl_setopt($this->httpConnection, CURLOPT_RETURNTRANSFER, true); + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + $date = $record['datetime']; + + $data = array('time' => $date->format('Y-m-d\TH:i:s.uO')); + unset($record['datetime']); + + if (isset($record['context']['type'])) { + $data['type'] = $record['context']['type']; + unset($record['context']['type']); + } else { + $data['type'] = $record['channel']; + } + + $data['data'] = $record['context']; + $data['data']['level'] = $record['level']; + + if ($this->scheme === 'http') { + $this->writeHttp(json_encode($data)); + } else { + $this->writeUdp(json_encode($data)); + } + } + + private function writeUdp($data) + { + if (!$this->udpConnection) { + $this->connectUdp(); + } + + socket_send($this->udpConnection, $data, strlen($data), 0); + } + + private function writeHttp($data) + { + if (!$this->httpConnection) { + $this->connectHttp(); + } + + curl_setopt($this->httpConnection, CURLOPT_POSTFIELDS, '['.$data.']'); + curl_setopt($this->httpConnection, CURLOPT_HTTPHEADER, array( + 'Content-Type: application/json', + 'Content-Length: ' . strlen('['.$data.']'), + )); + + Curl\Util::execute($this->httpConnection, 5, false); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/Curl/Util.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/Curl/Util.php new file mode 100644 index 0000000..48d30b3 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/Curl/Util.php @@ -0,0 +1,57 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler\Curl; + +class Util +{ + private static $retriableErrorCodes = array( + CURLE_COULDNT_RESOLVE_HOST, + CURLE_COULDNT_CONNECT, + CURLE_HTTP_NOT_FOUND, + CURLE_READ_ERROR, + CURLE_OPERATION_TIMEOUTED, + CURLE_HTTP_POST_ERROR, + CURLE_SSL_CONNECT_ERROR, + ); + + /** + * Executes a CURL request with optional retries and exception on failure + * + * @param resource $ch curl handler + * @throws \RuntimeException + */ + public static function execute($ch, $retries = 5, $closeAfterDone = true) + { + while ($retries--) { + if (curl_exec($ch) === false) { + $curlErrno = curl_errno($ch); + + if (false === in_array($curlErrno, self::$retriableErrorCodes, true) || !$retries) { + $curlError = curl_error($ch); + + if ($closeAfterDone) { + curl_close($ch); + } + + throw new \RuntimeException(sprintf('Curl error (code %s): %s', $curlErrno, $curlError)); + } + + continue; + } + + if ($closeAfterDone) { + curl_close($ch); + } + break; + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DeduplicationHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DeduplicationHandler.php new file mode 100644 index 0000000..7778c22 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DeduplicationHandler.php @@ -0,0 +1,169 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Simple handler wrapper that deduplicates log records across multiple requests + * + * It also includes the BufferHandler functionality and will buffer + * all messages until the end of the request or flush() is called. + * + * This works by storing all log records' messages above $deduplicationLevel + * to the file specified by $deduplicationStore. When further logs come in at the end of the + * request (or when flush() is called), all those above $deduplicationLevel are checked + * against the existing stored logs. If they match and the timestamps in the stored log is + * not older than $time seconds, the new log record is discarded. If no log record is new, the + * whole data set is discarded. + * + * This is mainly useful in combination with Mail handlers or things like Slack or HipChat handlers + * that send messages to people, to avoid spamming with the same message over and over in case of + * a major component failure like a database server being down which makes all requests fail in the + * same way. + * + * @author Jordi Boggiano + */ +class DeduplicationHandler extends BufferHandler +{ + /** + * @var string + */ + protected $deduplicationStore; + + /** + * @var int + */ + protected $deduplicationLevel; + + /** + * @var int + */ + protected $time; + + /** + * @var bool + */ + private $gc = false; + + /** + * @param HandlerInterface $handler Handler. + * @param string $deduplicationStore The file/path where the deduplication log should be kept + * @param int $deduplicationLevel The minimum logging level for log records to be looked at for deduplication purposes + * @param int $time The period (in seconds) during which duplicate entries should be suppressed after a given log is sent through + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct(HandlerInterface $handler, $deduplicationStore = null, $deduplicationLevel = Logger::ERROR, $time = 60, $bubble = true) + { + parent::__construct($handler, 0, Logger::DEBUG, $bubble, false); + + $this->deduplicationStore = $deduplicationStore === null ? sys_get_temp_dir() . '/monolog-dedup-' . substr(md5(__FILE__), 0, 20) .'.log' : $deduplicationStore; + $this->deduplicationLevel = Logger::toMonologLevel($deduplicationLevel); + $this->time = $time; + } + + public function flush() + { + if ($this->bufferSize === 0) { + return; + } + + $passthru = null; + + foreach ($this->buffer as $record) { + if ($record['level'] >= $this->deduplicationLevel) { + + $passthru = $passthru || !$this->isDuplicate($record); + if ($passthru) { + $this->appendRecord($record); + } + } + } + + // default of null is valid as well as if no record matches duplicationLevel we just pass through + if ($passthru === true || $passthru === null) { + $this->handler->handleBatch($this->buffer); + } + + $this->clear(); + + if ($this->gc) { + $this->collectLogs(); + } + } + + private function isDuplicate(array $record) + { + if (!file_exists($this->deduplicationStore)) { + return false; + } + + $store = file($this->deduplicationStore, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES); + if (!is_array($store)) { + return false; + } + + $yesterday = time() - 86400; + $timestampValidity = $record['datetime']->getTimestamp() - $this->time; + $expectedMessage = preg_replace('{[\r\n].*}', '', $record['message']); + + for ($i = count($store) - 1; $i >= 0; $i--) { + list($timestamp, $level, $message) = explode(':', $store[$i], 3); + + if ($level === $record['level_name'] && $message === $expectedMessage && $timestamp > $timestampValidity) { + return true; + } + + if ($timestamp < $yesterday) { + $this->gc = true; + } + } + + return false; + } + + private function collectLogs() + { + if (!file_exists($this->deduplicationStore)) { + return false; + } + + $handle = fopen($this->deduplicationStore, 'rw+'); + flock($handle, LOCK_EX); + $validLogs = array(); + + $timestampValidity = time() - $this->time; + + while (!feof($handle)) { + $log = fgets($handle); + if (substr($log, 0, 10) >= $timestampValidity) { + $validLogs[] = $log; + } + } + + ftruncate($handle, 0); + rewind($handle); + foreach ($validLogs as $log) { + fwrite($handle, $log); + } + + flock($handle, LOCK_UN); + fclose($handle); + + $this->gc = false; + } + + private function appendRecord(array $record) + { + file_put_contents($this->deduplicationStore, $record['datetime']->getTimestamp() . ':' . $record['level_name'] . ':' . preg_replace('{[\r\n].*}', '', $record['message']) . "\n", FILE_APPEND); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DoctrineCouchDBHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DoctrineCouchDBHandler.php new file mode 100644 index 0000000..b91ffec --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DoctrineCouchDBHandler.php @@ -0,0 +1,45 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\NormalizerFormatter; +use Doctrine\CouchDB\CouchDBClient; + +/** + * CouchDB handler for Doctrine CouchDB ODM + * + * @author Markus Bachmann + */ +class DoctrineCouchDBHandler extends AbstractProcessingHandler +{ + private $client; + + public function __construct(CouchDBClient $client, $level = Logger::DEBUG, $bubble = true) + { + $this->client = $client; + parent::__construct($level, $bubble); + } + + /** + * {@inheritDoc} + */ + protected function write(array $record) + { + $this->client->postDocument($record['formatted']); + } + + protected function getDefaultFormatter() + { + return new NormalizerFormatter; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DynamoDbHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DynamoDbHandler.php new file mode 100644 index 0000000..237b71f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/DynamoDbHandler.php @@ -0,0 +1,107 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Aws\Sdk; +use Aws\DynamoDb\DynamoDbClient; +use Aws\DynamoDb\Marshaler; +use Monolog\Formatter\ScalarFormatter; +use Monolog\Logger; + +/** + * Amazon DynamoDB handler (http://aws.amazon.com/dynamodb/) + * + * @link https://github.com/aws/aws-sdk-php/ + * @author Andrew Lawson + */ +class DynamoDbHandler extends AbstractProcessingHandler +{ + const DATE_FORMAT = 'Y-m-d\TH:i:s.uO'; + + /** + * @var DynamoDbClient + */ + protected $client; + + /** + * @var string + */ + protected $table; + + /** + * @var int + */ + protected $version; + + /** + * @var Marshaler + */ + protected $marshaler; + + /** + * @param DynamoDbClient $client + * @param string $table + * @param int $level + * @param bool $bubble + */ + public function __construct(DynamoDbClient $client, $table, $level = Logger::DEBUG, $bubble = true) + { + if (defined('Aws\Sdk::VERSION') && version_compare(Sdk::VERSION, '3.0', '>=')) { + $this->version = 3; + $this->marshaler = new Marshaler; + } else { + $this->version = 2; + } + + $this->client = $client; + $this->table = $table; + + parent::__construct($level, $bubble); + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + $filtered = $this->filterEmptyFields($record['formatted']); + if ($this->version === 3) { + $formatted = $this->marshaler->marshalItem($filtered); + } else { + $formatted = $this->client->formatAttributes($filtered); + } + + $this->client->putItem(array( + 'TableName' => $this->table, + 'Item' => $formatted, + )); + } + + /** + * @param array $record + * @return array + */ + protected function filterEmptyFields(array $record) + { + return array_filter($record, function ($value) { + return !empty($value) || false === $value || 0 === $value; + }); + } + + /** + * {@inheritdoc} + */ + protected function getDefaultFormatter() + { + return new ScalarFormatter(self::DATE_FORMAT); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ElasticSearchHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ElasticSearchHandler.php new file mode 100644 index 0000000..8196740 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ElasticSearchHandler.php @@ -0,0 +1,128 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\FormatterInterface; +use Monolog\Formatter\ElasticaFormatter; +use Monolog\Logger; +use Elastica\Client; +use Elastica\Exception\ExceptionInterface; + +/** + * Elastic Search handler + * + * Usage example: + * + * $client = new \Elastica\Client(); + * $options = array( + * 'index' => 'elastic_index_name', + * 'type' => 'elastic_doc_type', + * ); + * $handler = new ElasticSearchHandler($client, $options); + * $log = new Logger('application'); + * $log->pushHandler($handler); + * + * @author Jelle Vink + */ +class ElasticSearchHandler extends AbstractProcessingHandler +{ + /** + * @var Client + */ + protected $client; + + /** + * @var array Handler config options + */ + protected $options = array(); + + /** + * @param Client $client Elastica Client object + * @param array $options Handler configuration + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct(Client $client, array $options = array(), $level = Logger::DEBUG, $bubble = true) + { + parent::__construct($level, $bubble); + $this->client = $client; + $this->options = array_merge( + array( + 'index' => 'monolog', // Elastic index name + 'type' => 'record', // Elastic document type + 'ignore_error' => false, // Suppress Elastica exceptions + ), + $options + ); + } + + /** + * {@inheritDoc} + */ + protected function write(array $record) + { + $this->bulkSend(array($record['formatted'])); + } + + /** + * {@inheritdoc} + */ + public function setFormatter(FormatterInterface $formatter) + { + if ($formatter instanceof ElasticaFormatter) { + return parent::setFormatter($formatter); + } + throw new \InvalidArgumentException('ElasticSearchHandler is only compatible with ElasticaFormatter'); + } + + /** + * Getter options + * @return array + */ + public function getOptions() + { + return $this->options; + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new ElasticaFormatter($this->options['index'], $this->options['type']); + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + $documents = $this->getFormatter()->formatBatch($records); + $this->bulkSend($documents); + } + + /** + * Use Elasticsearch bulk API to send list of documents + * @param array $documents + * @throws \RuntimeException + */ + protected function bulkSend(array $documents) + { + try { + $this->client->addDocuments($documents); + } catch (ExceptionInterface $e) { + if (!$this->options['ignore_error']) { + throw new \RuntimeException("Error sending messages to Elasticsearch", 0, $e); + } + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ErrorLogHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ErrorLogHandler.php new file mode 100644 index 0000000..1447a58 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ErrorLogHandler.php @@ -0,0 +1,82 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\LineFormatter; +use Monolog\Logger; + +/** + * Stores to PHP error_log() handler. + * + * @author Elan Ruusamäe + */ +class ErrorLogHandler extends AbstractProcessingHandler +{ + const OPERATING_SYSTEM = 0; + const SAPI = 4; + + protected $messageType; + protected $expandNewlines; + + /** + * @param int $messageType Says where the error should go. + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + * @param Boolean $expandNewlines If set to true, newlines in the message will be expanded to be take multiple log entries + */ + public function __construct($messageType = self::OPERATING_SYSTEM, $level = Logger::DEBUG, $bubble = true, $expandNewlines = false) + { + parent::__construct($level, $bubble); + + if (false === in_array($messageType, self::getAvailableTypes())) { + $message = sprintf('The given message type "%s" is not supported', print_r($messageType, true)); + throw new \InvalidArgumentException($message); + } + + $this->messageType = $messageType; + $this->expandNewlines = $expandNewlines; + } + + /** + * @return array With all available types + */ + public static function getAvailableTypes() + { + return array( + self::OPERATING_SYSTEM, + self::SAPI, + ); + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new LineFormatter('[%datetime%] %channel%.%level_name%: %message% %context% %extra%'); + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + if ($this->expandNewlines) { + $lines = preg_split('{[\r\n]+}', (string) $record['formatted']); + foreach ($lines as $line) { + error_log($line, $this->messageType); + } + } else { + error_log((string) $record['formatted'], $this->messageType); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FilterHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FilterHandler.php new file mode 100644 index 0000000..2a0f7fd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FilterHandler.php @@ -0,0 +1,140 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Simple handler wrapper that filters records based on a list of levels + * + * It can be configured with an exact list of levels to allow, or a min/max level. + * + * @author Hennadiy Verkh + * @author Jordi Boggiano + */ +class FilterHandler extends AbstractHandler +{ + /** + * Handler or factory callable($record, $this) + * + * @var callable|\Monolog\Handler\HandlerInterface + */ + protected $handler; + + /** + * Minimum level for logs that are passed to handler + * + * @var int[] + */ + protected $acceptedLevels; + + /** + * Whether the messages that are handled can bubble up the stack or not + * + * @var Boolean + */ + protected $bubble; + + /** + * @param callable|HandlerInterface $handler Handler or factory callable($record, $this). + * @param int|array $minLevelOrList A list of levels to accept or a minimum level if maxLevel is provided + * @param int $maxLevel Maximum level to accept, only used if $minLevelOrList is not an array + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($handler, $minLevelOrList = Logger::DEBUG, $maxLevel = Logger::EMERGENCY, $bubble = true) + { + $this->handler = $handler; + $this->bubble = $bubble; + $this->setAcceptedLevels($minLevelOrList, $maxLevel); + + if (!$this->handler instanceof HandlerInterface && !is_callable($this->handler)) { + throw new \RuntimeException("The given handler (".json_encode($this->handler).") is not a callable nor a Monolog\Handler\HandlerInterface object"); + } + } + + /** + * @return array + */ + public function getAcceptedLevels() + { + return array_flip($this->acceptedLevels); + } + + /** + * @param int|string|array $minLevelOrList A list of levels to accept or a minimum level or level name if maxLevel is provided + * @param int|string $maxLevel Maximum level or level name to accept, only used if $minLevelOrList is not an array + */ + public function setAcceptedLevels($minLevelOrList = Logger::DEBUG, $maxLevel = Logger::EMERGENCY) + { + if (is_array($minLevelOrList)) { + $acceptedLevels = array_map('Monolog\Logger::toMonologLevel', $minLevelOrList); + } else { + $minLevelOrList = Logger::toMonologLevel($minLevelOrList); + $maxLevel = Logger::toMonologLevel($maxLevel); + $acceptedLevels = array_values(array_filter(Logger::getLevels(), function ($level) use ($minLevelOrList, $maxLevel) { + return $level >= $minLevelOrList && $level <= $maxLevel; + })); + } + $this->acceptedLevels = array_flip($acceptedLevels); + } + + /** + * {@inheritdoc} + */ + public function isHandling(array $record) + { + return isset($this->acceptedLevels[$record['level']]); + } + + /** + * {@inheritdoc} + */ + public function handle(array $record) + { + if (!$this->isHandling($record)) { + return false; + } + + // The same logic as in FingersCrossedHandler + if (!$this->handler instanceof HandlerInterface) { + $this->handler = call_user_func($this->handler, $record, $this); + if (!$this->handler instanceof HandlerInterface) { + throw new \RuntimeException("The factory callable should return a HandlerInterface"); + } + } + + if ($this->processors) { + foreach ($this->processors as $processor) { + $record = call_user_func($processor, $record); + } + } + + $this->handler->handle($record); + + return false === $this->bubble; + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + $filtered = array(); + foreach ($records as $record) { + if ($this->isHandling($record)) { + $filtered[] = $record; + } + } + + $this->handler->handleBatch($filtered); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ActivationStrategyInterface.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ActivationStrategyInterface.php new file mode 100644 index 0000000..c3e42ef --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ActivationStrategyInterface.php @@ -0,0 +1,28 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler\FingersCrossed; + +/** + * Interface for activation strategies for the FingersCrossedHandler. + * + * @author Johannes M. Schmitt + */ +interface ActivationStrategyInterface +{ + /** + * Returns whether the given record activates the handler. + * + * @param array $record + * @return Boolean + */ + public function isHandlerActivated(array $record); +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ChannelLevelActivationStrategy.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ChannelLevelActivationStrategy.php new file mode 100644 index 0000000..2a2a64d --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ChannelLevelActivationStrategy.php @@ -0,0 +1,59 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler\FingersCrossed; + +use Monolog\Logger; + +/** + * Channel and Error level based monolog activation strategy. Allows to trigger activation + * based on level per channel. e.g. trigger activation on level 'ERROR' by default, except + * for records of the 'sql' channel; those should trigger activation on level 'WARN'. + * + * Example: + * + * + * $activationStrategy = new ChannelLevelActivationStrategy( + * Logger::CRITICAL, + * array( + * 'request' => Logger::ALERT, + * 'sensitive' => Logger::ERROR, + * ) + * ); + * $handler = new FingersCrossedHandler(new StreamHandler('php://stderr'), $activationStrategy); + * + * + * @author Mike Meessen + */ +class ChannelLevelActivationStrategy implements ActivationStrategyInterface +{ + private $defaultActionLevel; + private $channelToActionLevel; + + /** + * @param int $defaultActionLevel The default action level to be used if the record's category doesn't match any + * @param array $channelToActionLevel An array that maps channel names to action levels. + */ + public function __construct($defaultActionLevel, $channelToActionLevel = array()) + { + $this->defaultActionLevel = Logger::toMonologLevel($defaultActionLevel); + $this->channelToActionLevel = array_map('Monolog\Logger::toMonologLevel', $channelToActionLevel); + } + + public function isHandlerActivated(array $record) + { + if (isset($this->channelToActionLevel[$record['channel']])) { + return $record['level'] >= $this->channelToActionLevel[$record['channel']]; + } + + return $record['level'] >= $this->defaultActionLevel; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ErrorLevelActivationStrategy.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ErrorLevelActivationStrategy.php new file mode 100644 index 0000000..6e63085 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ErrorLevelActivationStrategy.php @@ -0,0 +1,34 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler\FingersCrossed; + +use Monolog\Logger; + +/** + * Error level based activation strategy. + * + * @author Johannes M. Schmitt + */ +class ErrorLevelActivationStrategy implements ActivationStrategyInterface +{ + private $actionLevel; + + public function __construct($actionLevel) + { + $this->actionLevel = Logger::toMonologLevel($actionLevel); + } + + public function isHandlerActivated(array $record) + { + return $record['level'] >= $this->actionLevel; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossedHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossedHandler.php new file mode 100644 index 0000000..d1dcaac --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FingersCrossedHandler.php @@ -0,0 +1,163 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Handler\FingersCrossed\ErrorLevelActivationStrategy; +use Monolog\Handler\FingersCrossed\ActivationStrategyInterface; +use Monolog\Logger; + +/** + * Buffers all records until a certain level is reached + * + * The advantage of this approach is that you don't get any clutter in your log files. + * Only requests which actually trigger an error (or whatever your actionLevel is) will be + * in the logs, but they will contain all records, not only those above the level threshold. + * + * You can find the various activation strategies in the + * Monolog\Handler\FingersCrossed\ namespace. + * + * @author Jordi Boggiano + */ +class FingersCrossedHandler extends AbstractHandler +{ + protected $handler; + protected $activationStrategy; + protected $buffering = true; + protected $bufferSize; + protected $buffer = array(); + protected $stopBuffering; + protected $passthruLevel; + + /** + * @param callable|HandlerInterface $handler Handler or factory callable($record, $fingersCrossedHandler). + * @param int|ActivationStrategyInterface $activationStrategy Strategy which determines when this handler takes action + * @param int $bufferSize How many entries should be buffered at most, beyond that the oldest items are removed from the buffer. + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + * @param Boolean $stopBuffering Whether the handler should stop buffering after being triggered (default true) + * @param int $passthruLevel Minimum level to always flush to handler on close, even if strategy not triggered + */ + public function __construct($handler, $activationStrategy = null, $bufferSize = 0, $bubble = true, $stopBuffering = true, $passthruLevel = null) + { + if (null === $activationStrategy) { + $activationStrategy = new ErrorLevelActivationStrategy(Logger::WARNING); + } + + // convert simple int activationStrategy to an object + if (!$activationStrategy instanceof ActivationStrategyInterface) { + $activationStrategy = new ErrorLevelActivationStrategy($activationStrategy); + } + + $this->handler = $handler; + $this->activationStrategy = $activationStrategy; + $this->bufferSize = $bufferSize; + $this->bubble = $bubble; + $this->stopBuffering = $stopBuffering; + + if ($passthruLevel !== null) { + $this->passthruLevel = Logger::toMonologLevel($passthruLevel); + } + + if (!$this->handler instanceof HandlerInterface && !is_callable($this->handler)) { + throw new \RuntimeException("The given handler (".json_encode($this->handler).") is not a callable nor a Monolog\Handler\HandlerInterface object"); + } + } + + /** + * {@inheritdoc} + */ + public function isHandling(array $record) + { + return true; + } + + /** + * Manually activate this logger regardless of the activation strategy + */ + public function activate() + { + if ($this->stopBuffering) { + $this->buffering = false; + } + if (!$this->handler instanceof HandlerInterface) { + $record = end($this->buffer) ?: null; + + $this->handler = call_user_func($this->handler, $record, $this); + if (!$this->handler instanceof HandlerInterface) { + throw new \RuntimeException("The factory callable should return a HandlerInterface"); + } + } + $this->handler->handleBatch($this->buffer); + $this->buffer = array(); + } + + /** + * {@inheritdoc} + */ + public function handle(array $record) + { + if ($this->processors) { + foreach ($this->processors as $processor) { + $record = call_user_func($processor, $record); + } + } + + if ($this->buffering) { + $this->buffer[] = $record; + if ($this->bufferSize > 0 && count($this->buffer) > $this->bufferSize) { + array_shift($this->buffer); + } + if ($this->activationStrategy->isHandlerActivated($record)) { + $this->activate(); + } + } else { + $this->handler->handle($record); + } + + return false === $this->bubble; + } + + /** + * {@inheritdoc} + */ + public function close() + { + if (null !== $this->passthruLevel) { + $level = $this->passthruLevel; + $this->buffer = array_filter($this->buffer, function ($record) use ($level) { + return $record['level'] >= $level; + }); + if (count($this->buffer) > 0) { + $this->handler->handleBatch($this->buffer); + $this->buffer = array(); + } + } + } + + /** + * Resets the state of the handler. Stops forwarding records to the wrapped handler. + */ + public function reset() + { + $this->buffering = true; + } + + /** + * Clears the buffer without flushing any messages down to the wrapped handler. + * + * It also resets the handler to its initial buffering state. + */ + public function clear() + { + $this->buffer = array(); + $this->reset(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FirePHPHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FirePHPHandler.php new file mode 100644 index 0000000..fee4795 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FirePHPHandler.php @@ -0,0 +1,195 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\WildfireFormatter; + +/** + * Simple FirePHP Handler (http://www.firephp.org/), which uses the Wildfire protocol. + * + * @author Eric Clemmons (@ericclemmons) + */ +class FirePHPHandler extends AbstractProcessingHandler +{ + /** + * WildFire JSON header message format + */ + const PROTOCOL_URI = 'http://meta.wildfirehq.org/Protocol/JsonStream/0.2'; + + /** + * FirePHP structure for parsing messages & their presentation + */ + const STRUCTURE_URI = 'http://meta.firephp.org/Wildfire/Structure/FirePHP/FirebugConsole/0.1'; + + /** + * Must reference a "known" plugin, otherwise headers won't display in FirePHP + */ + const PLUGIN_URI = 'http://meta.firephp.org/Wildfire/Plugin/FirePHP/Library-FirePHPCore/0.3'; + + /** + * Header prefix for Wildfire to recognize & parse headers + */ + const HEADER_PREFIX = 'X-Wf'; + + /** + * Whether or not Wildfire vendor-specific headers have been generated & sent yet + */ + protected static $initialized = false; + + /** + * Shared static message index between potentially multiple handlers + * @var int + */ + protected static $messageIndex = 1; + + protected static $sendHeaders = true; + + /** + * Base header creation function used by init headers & record headers + * + * @param array $meta Wildfire Plugin, Protocol & Structure Indexes + * @param string $message Log message + * @return array Complete header string ready for the client as key and message as value + */ + protected function createHeader(array $meta, $message) + { + $header = sprintf('%s-%s', self::HEADER_PREFIX, join('-', $meta)); + + return array($header => $message); + } + + /** + * Creates message header from record + * + * @see createHeader() + * @param array $record + * @return string + */ + protected function createRecordHeader(array $record) + { + // Wildfire is extensible to support multiple protocols & plugins in a single request, + // but we're not taking advantage of that (yet), so we're using "1" for simplicity's sake. + return $this->createHeader( + array(1, 1, 1, self::$messageIndex++), + $record['formatted'] + ); + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new WildfireFormatter(); + } + + /** + * Wildfire initialization headers to enable message parsing + * + * @see createHeader() + * @see sendHeader() + * @return array + */ + protected function getInitHeaders() + { + // Initial payload consists of required headers for Wildfire + return array_merge( + $this->createHeader(array('Protocol', 1), self::PROTOCOL_URI), + $this->createHeader(array(1, 'Structure', 1), self::STRUCTURE_URI), + $this->createHeader(array(1, 'Plugin', 1), self::PLUGIN_URI) + ); + } + + /** + * Send header string to the client + * + * @param string $header + * @param string $content + */ + protected function sendHeader($header, $content) + { + if (!headers_sent() && self::$sendHeaders) { + header(sprintf('%s: %s', $header, $content)); + } + } + + /** + * Creates & sends header for a record, ensuring init headers have been sent prior + * + * @see sendHeader() + * @see sendInitHeaders() + * @param array $record + */ + protected function write(array $record) + { + if (!self::$sendHeaders) { + return; + } + + // WildFire-specific headers must be sent prior to any messages + if (!self::$initialized) { + self::$initialized = true; + + self::$sendHeaders = $this->headersAccepted(); + if (!self::$sendHeaders) { + return; + } + + foreach ($this->getInitHeaders() as $header => $content) { + $this->sendHeader($header, $content); + } + } + + $header = $this->createRecordHeader($record); + if (trim(current($header)) !== '') { + $this->sendHeader(key($header), current($header)); + } + } + + /** + * Verifies if the headers are accepted by the current user agent + * + * @return Boolean + */ + protected function headersAccepted() + { + if (!empty($_SERVER['HTTP_USER_AGENT']) && preg_match('{\bFirePHP/\d+\.\d+\b}', $_SERVER['HTTP_USER_AGENT'])) { + return true; + } + + return isset($_SERVER['HTTP_X_FIREPHP_VERSION']); + } + + /** + * BC getter for the sendHeaders property that has been made static + */ + public function __get($property) + { + if ('sendHeaders' !== $property) { + throw new \InvalidArgumentException('Undefined property '.$property); + } + + return static::$sendHeaders; + } + + /** + * BC setter for the sendHeaders property that has been made static + */ + public function __set($property, $value) + { + if ('sendHeaders' !== $property) { + throw new \InvalidArgumentException('Undefined property '.$property); + } + + static::$sendHeaders = $value; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FleepHookHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FleepHookHandler.php new file mode 100644 index 0000000..c43c013 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FleepHookHandler.php @@ -0,0 +1,126 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\LineFormatter; +use Monolog\Logger; + +/** + * Sends logs to Fleep.io using Webhook integrations + * + * You'll need a Fleep.io account to use this handler. + * + * @see https://fleep.io/integrations/webhooks/ Fleep Webhooks Documentation + * @author Ando Roots + */ +class FleepHookHandler extends SocketHandler +{ + const FLEEP_HOST = 'fleep.io'; + + const FLEEP_HOOK_URI = '/hook/'; + + /** + * @var string Webhook token (specifies the conversation where logs are sent) + */ + protected $token; + + /** + * Construct a new Fleep.io Handler. + * + * For instructions on how to create a new web hook in your conversations + * see https://fleep.io/integrations/webhooks/ + * + * @param string $token Webhook token + * @param bool|int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + * @throws MissingExtensionException + */ + public function __construct($token, $level = Logger::DEBUG, $bubble = true) + { + if (!extension_loaded('openssl')) { + throw new MissingExtensionException('The OpenSSL PHP extension is required to use the FleepHookHandler'); + } + + $this->token = $token; + + $connectionString = 'ssl://' . self::FLEEP_HOST . ':443'; + parent::__construct($connectionString, $level, $bubble); + } + + /** + * Returns the default formatter to use with this handler + * + * Overloaded to remove empty context and extra arrays from the end of the log message. + * + * @return LineFormatter + */ + protected function getDefaultFormatter() + { + return new LineFormatter(null, null, true, true); + } + + /** + * Handles a log record + * + * @param array $record + */ + public function write(array $record) + { + parent::write($record); + $this->closeSocket(); + } + + /** + * {@inheritdoc} + * + * @param array $record + * @return string + */ + protected function generateDataStream($record) + { + $content = $this->buildContent($record); + + return $this->buildHeader($content) . $content; + } + + /** + * Builds the header of the API Call + * + * @param string $content + * @return string + */ + private function buildHeader($content) + { + $header = "POST " . self::FLEEP_HOOK_URI . $this->token . " HTTP/1.1\r\n"; + $header .= "Host: " . self::FLEEP_HOST . "\r\n"; + $header .= "Content-Type: application/x-www-form-urlencoded\r\n"; + $header .= "Content-Length: " . strlen($content) . "\r\n"; + $header .= "\r\n"; + + return $header; + } + + /** + * Builds the body of API call + * + * @param array $record + * @return string + */ + private function buildContent($record) + { + $dataArray = array( + 'message' => $record['formatted'], + ); + + return http_build_query($dataArray); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FlowdockHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FlowdockHandler.php new file mode 100644 index 0000000..dd9a361 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/FlowdockHandler.php @@ -0,0 +1,127 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\FlowdockFormatter; +use Monolog\Formatter\FormatterInterface; + +/** + * Sends notifications through the Flowdock push API + * + * This must be configured with a FlowdockFormatter instance via setFormatter() + * + * Notes: + * API token - Flowdock API token + * + * @author Dominik Liebler + * @see https://www.flowdock.com/api/push + */ +class FlowdockHandler extends SocketHandler +{ + /** + * @var string + */ + protected $apiToken; + + /** + * @param string $apiToken + * @param bool|int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + * + * @throws MissingExtensionException if OpenSSL is missing + */ + public function __construct($apiToken, $level = Logger::DEBUG, $bubble = true) + { + if (!extension_loaded('openssl')) { + throw new MissingExtensionException('The OpenSSL PHP extension is required to use the FlowdockHandler'); + } + + parent::__construct('ssl://api.flowdock.com:443', $level, $bubble); + $this->apiToken = $apiToken; + } + + /** + * {@inheritdoc} + */ + public function setFormatter(FormatterInterface $formatter) + { + if (!$formatter instanceof FlowdockFormatter) { + throw new \InvalidArgumentException('The FlowdockHandler requires an instance of Monolog\Formatter\FlowdockFormatter to function correctly'); + } + + return parent::setFormatter($formatter); + } + + /** + * Gets the default formatter. + * + * @return FormatterInterface + */ + protected function getDefaultFormatter() + { + throw new \InvalidArgumentException('The FlowdockHandler must be configured (via setFormatter) with an instance of Monolog\Formatter\FlowdockFormatter to function correctly'); + } + + /** + * {@inheritdoc} + * + * @param array $record + */ + protected function write(array $record) + { + parent::write($record); + + $this->closeSocket(); + } + + /** + * {@inheritdoc} + * + * @param array $record + * @return string + */ + protected function generateDataStream($record) + { + $content = $this->buildContent($record); + + return $this->buildHeader($content) . $content; + } + + /** + * Builds the body of API call + * + * @param array $record + * @return string + */ + private function buildContent($record) + { + return json_encode($record['formatted']['flowdock']); + } + + /** + * Builds the header of the API Call + * + * @param string $content + * @return string + */ + private function buildHeader($content) + { + $header = "POST /v1/messages/team_inbox/" . $this->apiToken . " HTTP/1.1\r\n"; + $header .= "Host: api.flowdock.com\r\n"; + $header .= "Content-Type: application/json\r\n"; + $header .= "Content-Length: " . strlen($content) . "\r\n"; + $header .= "\r\n"; + + return $header; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/GelfHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/GelfHandler.php new file mode 100644 index 0000000..d3847d8 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/GelfHandler.php @@ -0,0 +1,73 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Gelf\IMessagePublisher; +use Gelf\PublisherInterface; +use Gelf\Publisher; +use InvalidArgumentException; +use Monolog\Logger; +use Monolog\Formatter\GelfMessageFormatter; + +/** + * Handler to send messages to a Graylog2 (http://www.graylog2.org) server + * + * @author Matt Lehner + * @author Benjamin Zikarsky + */ +class GelfHandler extends AbstractProcessingHandler +{ + /** + * @var Publisher the publisher object that sends the message to the server + */ + protected $publisher; + + /** + * @param PublisherInterface|IMessagePublisher|Publisher $publisher a publisher object + * @param int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($publisher, $level = Logger::DEBUG, $bubble = true) + { + parent::__construct($level, $bubble); + + if (!$publisher instanceof Publisher && !$publisher instanceof IMessagePublisher && !$publisher instanceof PublisherInterface) { + throw new InvalidArgumentException('Invalid publisher, expected a Gelf\Publisher, Gelf\IMessagePublisher or Gelf\PublisherInterface instance'); + } + + $this->publisher = $publisher; + } + + /** + * {@inheritdoc} + */ + public function close() + { + $this->publisher = null; + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + $this->publisher->publish($record['formatted']); + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new GelfMessageFormatter(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/GroupHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/GroupHandler.php new file mode 100644 index 0000000..663f5a9 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/GroupHandler.php @@ -0,0 +1,104 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\FormatterInterface; + +/** + * Forwards records to multiple handlers + * + * @author Lenar Lõhmus + */ +class GroupHandler extends AbstractHandler +{ + protected $handlers; + + /** + * @param array $handlers Array of Handlers. + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct(array $handlers, $bubble = true) + { + foreach ($handlers as $handler) { + if (!$handler instanceof HandlerInterface) { + throw new \InvalidArgumentException('The first argument of the GroupHandler must be an array of HandlerInterface instances.'); + } + } + + $this->handlers = $handlers; + $this->bubble = $bubble; + } + + /** + * {@inheritdoc} + */ + public function isHandling(array $record) + { + foreach ($this->handlers as $handler) { + if ($handler->isHandling($record)) { + return true; + } + } + + return false; + } + + /** + * {@inheritdoc} + */ + public function handle(array $record) + { + if ($this->processors) { + foreach ($this->processors as $processor) { + $record = call_user_func($processor, $record); + } + } + + foreach ($this->handlers as $handler) { + $handler->handle($record); + } + + return false === $this->bubble; + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + if ($this->processors) { + $processed = array(); + foreach ($records as $record) { + foreach ($this->processors as $processor) { + $processed[] = call_user_func($processor, $record); + } + } + $records = $processed; + } + + foreach ($this->handlers as $handler) { + $handler->handleBatch($records); + } + } + + /** + * {@inheritdoc} + */ + public function setFormatter(FormatterInterface $formatter) + { + foreach ($this->handlers as $handler) { + $handler->setFormatter($formatter); + } + + return $this; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HandlerInterface.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HandlerInterface.php new file mode 100644 index 0000000..d920c4b --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HandlerInterface.php @@ -0,0 +1,90 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\FormatterInterface; + +/** + * Interface that all Monolog Handlers must implement + * + * @author Jordi Boggiano + */ +interface HandlerInterface +{ + /** + * Checks whether the given record will be handled by this handler. + * + * This is mostly done for performance reasons, to avoid calling processors for nothing. + * + * Handlers should still check the record levels within handle(), returning false in isHandling() + * is no guarantee that handle() will not be called, and isHandling() might not be called + * for a given record. + * + * @param array $record Partial log record containing only a level key + * + * @return Boolean + */ + public function isHandling(array $record); + + /** + * Handles a record. + * + * All records may be passed to this method, and the handler should discard + * those that it does not want to handle. + * + * The return value of this function controls the bubbling process of the handler stack. + * Unless the bubbling is interrupted (by returning true), the Logger class will keep on + * calling further handlers in the stack with a given log record. + * + * @param array $record The record to handle + * @return Boolean true means that this handler handled the record, and that bubbling is not permitted. + * false means the record was either not processed or that this handler allows bubbling. + */ + public function handle(array $record); + + /** + * Handles a set of records at once. + * + * @param array $records The records to handle (an array of record arrays) + */ + public function handleBatch(array $records); + + /** + * Adds a processor in the stack. + * + * @param callable $callback + * @return self + */ + public function pushProcessor($callback); + + /** + * Removes the processor on top of the stack and returns it. + * + * @return callable + */ + public function popProcessor(); + + /** + * Sets the formatter. + * + * @param FormatterInterface $formatter + * @return self + */ + public function setFormatter(FormatterInterface $formatter); + + /** + * Gets the formatter. + * + * @return FormatterInterface + */ + public function getFormatter(); +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HandlerWrapper.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HandlerWrapper.php new file mode 100644 index 0000000..e540d80 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HandlerWrapper.php @@ -0,0 +1,108 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\FormatterInterface; + +/** + * This simple wrapper class can be used to extend handlers functionality. + * + * Example: A custom filtering that can be applied to any handler. + * + * Inherit from this class and override handle() like this: + * + * public function handle(array $record) + * { + * if ($record meets certain conditions) { + * return false; + * } + * return $this->handler->handle($record); + * } + * + * @author Alexey Karapetov + */ +class HandlerWrapper implements HandlerInterface +{ + /** + * @var HandlerInterface + */ + protected $handler; + + /** + * HandlerWrapper constructor. + * @param HandlerInterface $handler + */ + public function __construct(HandlerInterface $handler) + { + $this->handler = $handler; + } + + /** + * {@inheritdoc} + */ + public function isHandling(array $record) + { + return $this->handler->isHandling($record); + } + + /** + * {@inheritdoc} + */ + public function handle(array $record) + { + return $this->handler->handle($record); + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + return $this->handler->handleBatch($records); + } + + /** + * {@inheritdoc} + */ + public function pushProcessor($callback) + { + $this->handler->pushProcessor($callback); + + return $this; + } + + /** + * {@inheritdoc} + */ + public function popProcessor() + { + return $this->handler->popProcessor(); + } + + /** + * {@inheritdoc} + */ + public function setFormatter(FormatterInterface $formatter) + { + $this->handler->setFormatter($formatter); + + return $this; + } + + /** + * {@inheritdoc} + */ + public function getFormatter() + { + return $this->handler->getFormatter(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HipChatHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HipChatHandler.php new file mode 100644 index 0000000..73049f3 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/HipChatHandler.php @@ -0,0 +1,350 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Sends notifications through the hipchat api to a hipchat room + * + * Notes: + * API token - HipChat API token + * Room - HipChat Room Id or name, where messages are sent + * Name - Name used to send the message (from) + * notify - Should the message trigger a notification in the clients + * version - The API version to use (HipChatHandler::API_V1 | HipChatHandler::API_V2) + * + * @author Rafael Dohms + * @see https://www.hipchat.com/docs/api + */ +class HipChatHandler extends SocketHandler +{ + /** + * Use API version 1 + */ + const API_V1 = 'v1'; + + /** + * Use API version v2 + */ + const API_V2 = 'v2'; + + /** + * The maximum allowed length for the name used in the "from" field. + */ + const MAXIMUM_NAME_LENGTH = 15; + + /** + * The maximum allowed length for the message. + */ + const MAXIMUM_MESSAGE_LENGTH = 9500; + + /** + * @var string + */ + private $token; + + /** + * @var string + */ + private $room; + + /** + * @var string + */ + private $name; + + /** + * @var bool + */ + private $notify; + + /** + * @var string + */ + private $format; + + /** + * @var string + */ + private $host; + + /** + * @var string + */ + private $version; + + /** + * @param string $token HipChat API Token + * @param string $room The room that should be alerted of the message (Id or Name) + * @param string $name Name used in the "from" field. + * @param bool $notify Trigger a notification in clients or not + * @param int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + * @param bool $useSSL Whether to connect via SSL. + * @param string $format The format of the messages (default to text, can be set to html if you have html in the messages) + * @param string $host The HipChat server hostname. + * @param string $version The HipChat API version (default HipChatHandler::API_V1) + */ + public function __construct($token, $room, $name = 'Monolog', $notify = false, $level = Logger::CRITICAL, $bubble = true, $useSSL = true, $format = 'text', $host = 'api.hipchat.com', $version = self::API_V1) + { + if ($version == self::API_V1 && !$this->validateStringLength($name, static::MAXIMUM_NAME_LENGTH)) { + throw new \InvalidArgumentException('The supplied name is too long. HipChat\'s v1 API supports names up to 15 UTF-8 characters.'); + } + + $connectionString = $useSSL ? 'ssl://'.$host.':443' : $host.':80'; + parent::__construct($connectionString, $level, $bubble); + + $this->token = $token; + $this->name = $name; + $this->notify = $notify; + $this->room = $room; + $this->format = $format; + $this->host = $host; + $this->version = $version; + } + + /** + * {@inheritdoc} + * + * @param array $record + * @return string + */ + protected function generateDataStream($record) + { + $content = $this->buildContent($record); + + return $this->buildHeader($content) . $content; + } + + /** + * Builds the body of API call + * + * @param array $record + * @return string + */ + private function buildContent($record) + { + $dataArray = array( + 'notify' => $this->version == self::API_V1 ? + ($this->notify ? 1 : 0) : + ($this->notify ? 'true' : 'false'), + 'message' => $record['formatted'], + 'message_format' => $this->format, + 'color' => $this->getAlertColor($record['level']), + ); + + if (!$this->validateStringLength($dataArray['message'], static::MAXIMUM_MESSAGE_LENGTH)) { + if (function_exists('mb_substr')) { + $dataArray['message'] = mb_substr($dataArray['message'], 0, static::MAXIMUM_MESSAGE_LENGTH).' [truncated]'; + } else { + $dataArray['message'] = substr($dataArray['message'], 0, static::MAXIMUM_MESSAGE_LENGTH).' [truncated]'; + } + } + + // if we are using the legacy API then we need to send some additional information + if ($this->version == self::API_V1) { + $dataArray['room_id'] = $this->room; + } + + // append the sender name if it is set + // always append it if we use the v1 api (it is required in v1) + if ($this->version == self::API_V1 || $this->name !== null) { + $dataArray['from'] = (string) $this->name; + } + + return http_build_query($dataArray); + } + + /** + * Builds the header of the API Call + * + * @param string $content + * @return string + */ + private function buildHeader($content) + { + if ($this->version == self::API_V1) { + $header = "POST /v1/rooms/message?format=json&auth_token={$this->token} HTTP/1.1\r\n"; + } else { + // needed for rooms with special (spaces, etc) characters in the name + $room = rawurlencode($this->room); + $header = "POST /v2/room/{$room}/notification?auth_token={$this->token} HTTP/1.1\r\n"; + } + + $header .= "Host: {$this->host}\r\n"; + $header .= "Content-Type: application/x-www-form-urlencoded\r\n"; + $header .= "Content-Length: " . strlen($content) . "\r\n"; + $header .= "\r\n"; + + return $header; + } + + /** + * Assigns a color to each level of log records. + * + * @param int $level + * @return string + */ + protected function getAlertColor($level) + { + switch (true) { + case $level >= Logger::ERROR: + return 'red'; + case $level >= Logger::WARNING: + return 'yellow'; + case $level >= Logger::INFO: + return 'green'; + case $level == Logger::DEBUG: + return 'gray'; + default: + return 'yellow'; + } + } + + /** + * {@inheritdoc} + * + * @param array $record + */ + protected function write(array $record) + { + parent::write($record); + $this->closeSocket(); + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + if (count($records) == 0) { + return true; + } + + $batchRecords = $this->combineRecords($records); + + $handled = false; + foreach ($batchRecords as $batchRecord) { + if ($this->isHandling($batchRecord)) { + $this->write($batchRecord); + $handled = true; + } + } + + if (!$handled) { + return false; + } + + return false === $this->bubble; + } + + /** + * Combines multiple records into one. Error level of the combined record + * will be the highest level from the given records. Datetime will be taken + * from the first record. + * + * @param $records + * @return array + */ + private function combineRecords($records) + { + $batchRecord = null; + $batchRecords = array(); + $messages = array(); + $formattedMessages = array(); + $level = 0; + $levelName = null; + $datetime = null; + + foreach ($records as $record) { + $record = $this->processRecord($record); + + if ($record['level'] > $level) { + $level = $record['level']; + $levelName = $record['level_name']; + } + + if (null === $datetime) { + $datetime = $record['datetime']; + } + + $messages[] = $record['message']; + $messageStr = implode(PHP_EOL, $messages); + $formattedMessages[] = $this->getFormatter()->format($record); + $formattedMessageStr = implode('', $formattedMessages); + + $batchRecord = array( + 'message' => $messageStr, + 'formatted' => $formattedMessageStr, + 'context' => array(), + 'extra' => array(), + ); + + if (!$this->validateStringLength($batchRecord['formatted'], static::MAXIMUM_MESSAGE_LENGTH)) { + // Pop the last message and implode the remaining messages + $lastMessage = array_pop($messages); + $lastFormattedMessage = array_pop($formattedMessages); + $batchRecord['message'] = implode(PHP_EOL, $messages); + $batchRecord['formatted'] = implode('', $formattedMessages); + + $batchRecords[] = $batchRecord; + $messages = array($lastMessage); + $formattedMessages = array($lastFormattedMessage); + + $batchRecord = null; + } + } + + if (null !== $batchRecord) { + $batchRecords[] = $batchRecord; + } + + // Set the max level and datetime for all records + foreach ($batchRecords as &$batchRecord) { + $batchRecord = array_merge( + $batchRecord, + array( + 'level' => $level, + 'level_name' => $levelName, + 'datetime' => $datetime, + ) + ); + } + + return $batchRecords; + } + + /** + * Validates the length of a string. + * + * If the `mb_strlen()` function is available, it will use that, as HipChat + * allows UTF-8 characters. Otherwise, it will fall back to `strlen()`. + * + * Note that this might cause false failures in the specific case of using + * a valid name with less than 16 characters, but 16 or more bytes, on a + * system where `mb_strlen()` is unavailable. + * + * @param string $str + * @param int $length + * + * @return bool + */ + private function validateStringLength($str, $length) + { + if (function_exists('mb_strlen')) { + return (mb_strlen($str) <= $length); + } + + return (strlen($str) <= $length); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/IFTTTHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/IFTTTHandler.php new file mode 100644 index 0000000..d60a3c8 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/IFTTTHandler.php @@ -0,0 +1,69 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * IFTTTHandler uses cURL to trigger IFTTT Maker actions + * + * Register a secret key and trigger/event name at https://ifttt.com/maker + * + * value1 will be the channel from monolog's Logger constructor, + * value2 will be the level name (ERROR, WARNING, ..) + * value3 will be the log record's message + * + * @author Nehal Patel + */ +class IFTTTHandler extends AbstractProcessingHandler +{ + private $eventName; + private $secretKey; + + /** + * @param string $eventName The name of the IFTTT Maker event that should be triggered + * @param string $secretKey A valid IFTTT secret key + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($eventName, $secretKey, $level = Logger::ERROR, $bubble = true) + { + $this->eventName = $eventName; + $this->secretKey = $secretKey; + + parent::__construct($level, $bubble); + } + + /** + * {@inheritdoc} + */ + public function write(array $record) + { + $postData = array( + "value1" => $record["channel"], + "value2" => $record["level_name"], + "value3" => $record["message"], + ); + $postString = json_encode($postData); + + $ch = curl_init(); + curl_setopt($ch, CURLOPT_URL, "https://maker.ifttt.com/trigger/" . $this->eventName . "/with/key/" . $this->secretKey); + curl_setopt($ch, CURLOPT_POST, true); + curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); + curl_setopt($ch, CURLOPT_POSTFIELDS, $postString); + curl_setopt($ch, CURLOPT_HTTPHEADER, array( + "Content-Type: application/json", + )); + + Curl\Util::execute($ch); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/LogEntriesHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/LogEntriesHandler.php new file mode 100644 index 0000000..494c605 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/LogEntriesHandler.php @@ -0,0 +1,55 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * @author Robert Kaufmann III + */ +class LogEntriesHandler extends SocketHandler +{ + /** + * @var string + */ + protected $logToken; + + /** + * @param string $token Log token supplied by LogEntries + * @param bool $useSSL Whether or not SSL encryption should be used. + * @param int $level The minimum logging level to trigger this handler + * @param bool $bubble Whether or not messages that are handled should bubble up the stack. + * + * @throws MissingExtensionException If SSL encryption is set to true and OpenSSL is missing + */ + public function __construct($token, $useSSL = true, $level = Logger::DEBUG, $bubble = true) + { + if ($useSSL && !extension_loaded('openssl')) { + throw new MissingExtensionException('The OpenSSL PHP plugin is required to use SSL encrypted connection for LogEntriesHandler'); + } + + $endpoint = $useSSL ? 'ssl://data.logentries.com:443' : 'data.logentries.com:80'; + parent::__construct($endpoint, $level, $bubble); + $this->logToken = $token; + } + + /** + * {@inheritdoc} + * + * @param array $record + * @return string + */ + protected function generateDataStream($record) + { + return $this->logToken . ' ' . $record['formatted']; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/LogglyHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/LogglyHandler.php new file mode 100644 index 0000000..bcd62e1 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/LogglyHandler.php @@ -0,0 +1,102 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\LogglyFormatter; + +/** + * Sends errors to Loggly. + * + * @author Przemek Sobstel + * @author Adam Pancutt + * @author Gregory Barchard + */ +class LogglyHandler extends AbstractProcessingHandler +{ + const HOST = 'logs-01.loggly.com'; + const ENDPOINT_SINGLE = 'inputs'; + const ENDPOINT_BATCH = 'bulk'; + + protected $token; + + protected $tag = array(); + + public function __construct($token, $level = Logger::DEBUG, $bubble = true) + { + if (!extension_loaded('curl')) { + throw new \LogicException('The curl extension is needed to use the LogglyHandler'); + } + + $this->token = $token; + + parent::__construct($level, $bubble); + } + + public function setTag($tag) + { + $tag = !empty($tag) ? $tag : array(); + $this->tag = is_array($tag) ? $tag : array($tag); + } + + public function addTag($tag) + { + if (!empty($tag)) { + $tag = is_array($tag) ? $tag : array($tag); + $this->tag = array_unique(array_merge($this->tag, $tag)); + } + } + + protected function write(array $record) + { + $this->send($record["formatted"], self::ENDPOINT_SINGLE); + } + + public function handleBatch(array $records) + { + $level = $this->level; + + $records = array_filter($records, function ($record) use ($level) { + return ($record['level'] >= $level); + }); + + if ($records) { + $this->send($this->getFormatter()->formatBatch($records), self::ENDPOINT_BATCH); + } + } + + protected function send($data, $endpoint) + { + $url = sprintf("https://%s/%s/%s/", self::HOST, $endpoint, $this->token); + + $headers = array('Content-Type: application/json'); + + if (!empty($this->tag)) { + $headers[] = 'X-LOGGLY-TAG: '.implode(',', $this->tag); + } + + $ch = curl_init(); + + curl_setopt($ch, CURLOPT_URL, $url); + curl_setopt($ch, CURLOPT_POST, true); + curl_setopt($ch, CURLOPT_POSTFIELDS, $data); + curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); + curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); + + Curl\Util::execute($ch); + } + + protected function getDefaultFormatter() + { + return new LogglyFormatter(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MailHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MailHandler.php new file mode 100644 index 0000000..9e23283 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MailHandler.php @@ -0,0 +1,67 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +/** + * Base class for all mail handlers + * + * @author Gyula Sallai + */ +abstract class MailHandler extends AbstractProcessingHandler +{ + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + $messages = array(); + + foreach ($records as $record) { + if ($record['level'] < $this->level) { + continue; + } + $messages[] = $this->processRecord($record); + } + + if (!empty($messages)) { + $this->send((string) $this->getFormatter()->formatBatch($messages), $messages); + } + } + + /** + * Send a mail with the given content + * + * @param string $content formatted email body to be sent + * @param array $records the array of log records that formed this content + */ + abstract protected function send($content, array $records); + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + $this->send((string) $record['formatted'], array($record)); + } + + protected function getHighestRecord(array $records) + { + $highestRecord = null; + foreach ($records as $record) { + if ($highestRecord === null || $highestRecord['level'] < $record['level']) { + $highestRecord = $record; + } + } + + return $highestRecord; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MandrillHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MandrillHandler.php new file mode 100644 index 0000000..ab95924 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MandrillHandler.php @@ -0,0 +1,68 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * MandrillHandler uses cURL to send the emails to the Mandrill API + * + * @author Adam Nicholson + */ +class MandrillHandler extends MailHandler +{ + protected $message; + protected $apiKey; + + /** + * @param string $apiKey A valid Mandrill API key + * @param callable|\Swift_Message $message An example message for real messages, only the body will be replaced + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($apiKey, $message, $level = Logger::ERROR, $bubble = true) + { + parent::__construct($level, $bubble); + + if (!$message instanceof \Swift_Message && is_callable($message)) { + $message = call_user_func($message); + } + if (!$message instanceof \Swift_Message) { + throw new \InvalidArgumentException('You must provide either a Swift_Message instance or a callable returning it'); + } + $this->message = $message; + $this->apiKey = $apiKey; + } + + /** + * {@inheritdoc} + */ + protected function send($content, array $records) + { + $message = clone $this->message; + $message->setBody($content); + $message->setDate(time()); + + $ch = curl_init(); + + curl_setopt($ch, CURLOPT_URL, 'https://mandrillapp.com/api/1.0/messages/send-raw.json'); + curl_setopt($ch, CURLOPT_POST, 1); + curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); + curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(array( + 'key' => $this->apiKey, + 'raw_message' => (string) $message, + 'async' => false, + ))); + + Curl\Util::execute($ch); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MissingExtensionException.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MissingExtensionException.php new file mode 100644 index 0000000..4724a7e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MissingExtensionException.php @@ -0,0 +1,21 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +/** + * Exception can be thrown if an extension for an handler is missing + * + * @author Christian Bergau + */ +class MissingExtensionException extends \Exception +{ +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MongoDBHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MongoDBHandler.php new file mode 100644 index 0000000..56fe755 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/MongoDBHandler.php @@ -0,0 +1,59 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\NormalizerFormatter; + +/** + * Logs to a MongoDB database. + * + * usage example: + * + * $log = new Logger('application'); + * $mongodb = new MongoDBHandler(new \Mongo("mongodb://localhost:27017"), "logs", "prod"); + * $log->pushHandler($mongodb); + * + * @author Thomas Tourlourat + */ +class MongoDBHandler extends AbstractProcessingHandler +{ + protected $mongoCollection; + + public function __construct($mongo, $database, $collection, $level = Logger::DEBUG, $bubble = true) + { + if (!($mongo instanceof \MongoClient || $mongo instanceof \Mongo || $mongo instanceof \MongoDB\Client)) { + throw new \InvalidArgumentException('MongoClient, Mongo or MongoDB\Client instance required'); + } + + $this->mongoCollection = $mongo->selectCollection($database, $collection); + + parent::__construct($level, $bubble); + } + + protected function write(array $record) + { + if ($this->mongoCollection instanceof \MongoDB\Collection) { + $this->mongoCollection->insertOne($record["formatted"]); + } else { + $this->mongoCollection->save($record["formatted"]); + } + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new NormalizerFormatter(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NativeMailerHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NativeMailerHandler.php new file mode 100644 index 0000000..d7807fd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NativeMailerHandler.php @@ -0,0 +1,185 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\LineFormatter; + +/** + * NativeMailerHandler uses the mail() function to send the emails + * + * @author Christophe Coevoet + * @author Mark Garrett + */ +class NativeMailerHandler extends MailHandler +{ + /** + * The email addresses to which the message will be sent + * @var array + */ + protected $to; + + /** + * The subject of the email + * @var string + */ + protected $subject; + + /** + * Optional headers for the message + * @var array + */ + protected $headers = array(); + + /** + * Optional parameters for the message + * @var array + */ + protected $parameters = array(); + + /** + * The wordwrap length for the message + * @var int + */ + protected $maxColumnWidth; + + /** + * The Content-type for the message + * @var string + */ + protected $contentType = 'text/plain'; + + /** + * The encoding for the message + * @var string + */ + protected $encoding = 'utf-8'; + + /** + * @param string|array $to The receiver of the mail + * @param string $subject The subject of the mail + * @param string $from The sender of the mail + * @param int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + * @param int $maxColumnWidth The maximum column width that the message lines will have + */ + public function __construct($to, $subject, $from, $level = Logger::ERROR, $bubble = true, $maxColumnWidth = 70) + { + parent::__construct($level, $bubble); + $this->to = is_array($to) ? $to : array($to); + $this->subject = $subject; + $this->addHeader(sprintf('From: %s', $from)); + $this->maxColumnWidth = $maxColumnWidth; + } + + /** + * Add headers to the message + * + * @param string|array $headers Custom added headers + * @return self + */ + public function addHeader($headers) + { + foreach ((array) $headers as $header) { + if (strpos($header, "\n") !== false || strpos($header, "\r") !== false) { + throw new \InvalidArgumentException('Headers can not contain newline characters for security reasons'); + } + $this->headers[] = $header; + } + + return $this; + } + + /** + * Add parameters to the message + * + * @param string|array $parameters Custom added parameters + * @return self + */ + public function addParameter($parameters) + { + $this->parameters = array_merge($this->parameters, (array) $parameters); + + return $this; + } + + /** + * {@inheritdoc} + */ + protected function send($content, array $records) + { + $content = wordwrap($content, $this->maxColumnWidth); + $headers = ltrim(implode("\r\n", $this->headers) . "\r\n", "\r\n"); + $headers .= 'Content-type: ' . $this->getContentType() . '; charset=' . $this->getEncoding() . "\r\n"; + if ($this->getContentType() == 'text/html' && false === strpos($headers, 'MIME-Version:')) { + $headers .= 'MIME-Version: 1.0' . "\r\n"; + } + + $subject = $this->subject; + if ($records) { + $subjectFormatter = new LineFormatter($this->subject); + $subject = $subjectFormatter->format($this->getHighestRecord($records)); + } + + $parameters = implode(' ', $this->parameters); + foreach ($this->to as $to) { + mail($to, $subject, $content, $headers, $parameters); + } + } + + /** + * @return string $contentType + */ + public function getContentType() + { + return $this->contentType; + } + + /** + * @return string $encoding + */ + public function getEncoding() + { + return $this->encoding; + } + + /** + * @param string $contentType The content type of the email - Defaults to text/plain. Use text/html for HTML + * messages. + * @return self + */ + public function setContentType($contentType) + { + if (strpos($contentType, "\n") !== false || strpos($contentType, "\r") !== false) { + throw new \InvalidArgumentException('The content type can not contain newline characters to prevent email header injection'); + } + + $this->contentType = $contentType; + + return $this; + } + + /** + * @param string $encoding + * @return self + */ + public function setEncoding($encoding) + { + if (strpos($encoding, "\n") !== false || strpos($encoding, "\r") !== false) { + throw new \InvalidArgumentException('The encoding can not contain newline characters to prevent email header injection'); + } + + $this->encoding = $encoding; + + return $this; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NewRelicHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NewRelicHandler.php new file mode 100644 index 0000000..6718e9e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NewRelicHandler.php @@ -0,0 +1,202 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\NormalizerFormatter; + +/** + * Class to record a log on a NewRelic application. + * Enabling New Relic High Security mode may prevent capture of useful information. + * + * @see https://docs.newrelic.com/docs/agents/php-agent + * @see https://docs.newrelic.com/docs/accounts-partnerships/accounts/security/high-security + */ +class NewRelicHandler extends AbstractProcessingHandler +{ + /** + * Name of the New Relic application that will receive logs from this handler. + * + * @var string + */ + protected $appName; + + /** + * Name of the current transaction + * + * @var string + */ + protected $transactionName; + + /** + * Some context and extra data is passed into the handler as arrays of values. Do we send them as is + * (useful if we are using the API), or explode them for display on the NewRelic RPM website? + * + * @var bool + */ + protected $explodeArrays; + + /** + * {@inheritDoc} + * + * @param string $appName + * @param bool $explodeArrays + * @param string $transactionName + */ + public function __construct( + $level = Logger::ERROR, + $bubble = true, + $appName = null, + $explodeArrays = false, + $transactionName = null + ) { + parent::__construct($level, $bubble); + + $this->appName = $appName; + $this->explodeArrays = $explodeArrays; + $this->transactionName = $transactionName; + } + + /** + * {@inheritDoc} + */ + protected function write(array $record) + { + if (!$this->isNewRelicEnabled()) { + throw new MissingExtensionException('The newrelic PHP extension is required to use the NewRelicHandler'); + } + + if ($appName = $this->getAppName($record['context'])) { + $this->setNewRelicAppName($appName); + } + + if ($transactionName = $this->getTransactionName($record['context'])) { + $this->setNewRelicTransactionName($transactionName); + unset($record['formatted']['context']['transaction_name']); + } + + if (isset($record['context']['exception']) && $record['context']['exception'] instanceof \Exception) { + newrelic_notice_error($record['message'], $record['context']['exception']); + unset($record['formatted']['context']['exception']); + } else { + newrelic_notice_error($record['message']); + } + + if (isset($record['formatted']['context']) && is_array($record['formatted']['context'])) { + foreach ($record['formatted']['context'] as $key => $parameter) { + if (is_array($parameter) && $this->explodeArrays) { + foreach ($parameter as $paramKey => $paramValue) { + $this->setNewRelicParameter('context_' . $key . '_' . $paramKey, $paramValue); + } + } else { + $this->setNewRelicParameter('context_' . $key, $parameter); + } + } + } + + if (isset($record['formatted']['extra']) && is_array($record['formatted']['extra'])) { + foreach ($record['formatted']['extra'] as $key => $parameter) { + if (is_array($parameter) && $this->explodeArrays) { + foreach ($parameter as $paramKey => $paramValue) { + $this->setNewRelicParameter('extra_' . $key . '_' . $paramKey, $paramValue); + } + } else { + $this->setNewRelicParameter('extra_' . $key, $parameter); + } + } + } + } + + /** + * Checks whether the NewRelic extension is enabled in the system. + * + * @return bool + */ + protected function isNewRelicEnabled() + { + return extension_loaded('newrelic'); + } + + /** + * Returns the appname where this log should be sent. Each log can override the default appname, set in this + * handler's constructor, by providing the appname in it's context. + * + * @param array $context + * @return null|string + */ + protected function getAppName(array $context) + { + if (isset($context['appname'])) { + return $context['appname']; + } + + return $this->appName; + } + + /** + * Returns the name of the current transaction. Each log can override the default transaction name, set in this + * handler's constructor, by providing the transaction_name in it's context + * + * @param array $context + * + * @return null|string + */ + protected function getTransactionName(array $context) + { + if (isset($context['transaction_name'])) { + return $context['transaction_name']; + } + + return $this->transactionName; + } + + /** + * Sets the NewRelic application that should receive this log. + * + * @param string $appName + */ + protected function setNewRelicAppName($appName) + { + newrelic_set_appname($appName); + } + + /** + * Overwrites the name of the current transaction + * + * @param string $transactionName + */ + protected function setNewRelicTransactionName($transactionName) + { + newrelic_name_transaction($transactionName); + } + + /** + * @param string $key + * @param mixed $value + */ + protected function setNewRelicParameter($key, $value) + { + if (null === $value || is_scalar($value)) { + newrelic_add_custom_parameter($key, $value); + } else { + newrelic_add_custom_parameter($key, @json_encode($value)); + } + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new NormalizerFormatter(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NullHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NullHandler.php new file mode 100644 index 0000000..4b84588 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/NullHandler.php @@ -0,0 +1,45 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Blackhole + * + * Any record it can handle will be thrown away. This can be used + * to put on top of an existing stack to override it temporarily. + * + * @author Jordi Boggiano + */ +class NullHandler extends AbstractHandler +{ + /** + * @param int $level The minimum logging level at which this handler will be triggered + */ + public function __construct($level = Logger::DEBUG) + { + parent::__construct($level, false); + } + + /** + * {@inheritdoc} + */ + public function handle(array $record) + { + if ($record['level'] < $this->level) { + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PHPConsoleHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PHPConsoleHandler.php new file mode 100644 index 0000000..1f2076a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PHPConsoleHandler.php @@ -0,0 +1,242 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Exception; +use Monolog\Formatter\LineFormatter; +use Monolog\Logger; +use PhpConsole\Connector; +use PhpConsole\Handler; +use PhpConsole\Helper; + +/** + * Monolog handler for Google Chrome extension "PHP Console" + * + * Display PHP error/debug log messages in Google Chrome console and notification popups, executes PHP code remotely + * + * Usage: + * 1. Install Google Chrome extension https://chrome.google.com/webstore/detail/php-console/nfhmhhlpfleoednkpnnnkolmclajemef + * 2. See overview https://github.com/barbushin/php-console#overview + * 3. Install PHP Console library https://github.com/barbushin/php-console#installation + * 4. Example (result will looks like http://i.hizliresim.com/vg3Pz4.png) + * + * $logger = new \Monolog\Logger('all', array(new \Monolog\Handler\PHPConsoleHandler())); + * \Monolog\ErrorHandler::register($logger); + * echo $undefinedVar; + * $logger->addDebug('SELECT * FROM users', array('db', 'time' => 0.012)); + * PC::debug($_SERVER); // PHP Console debugger for any type of vars + * + * @author Sergey Barbushin https://www.linkedin.com/in/barbushin + */ +class PHPConsoleHandler extends AbstractProcessingHandler +{ + private $options = array( + 'enabled' => true, // bool Is PHP Console server enabled + 'classesPartialsTraceIgnore' => array('Monolog\\'), // array Hide calls of classes started with... + 'debugTagsKeysInContext' => array(0, 'tag'), // bool Is PHP Console server enabled + 'useOwnErrorsHandler' => false, // bool Enable errors handling + 'useOwnExceptionsHandler' => false, // bool Enable exceptions handling + 'sourcesBasePath' => null, // string Base path of all project sources to strip in errors source paths + 'registerHelper' => true, // bool Register PhpConsole\Helper that allows short debug calls like PC::debug($var, 'ta.g.s') + 'serverEncoding' => null, // string|null Server internal encoding + 'headersLimit' => null, // int|null Set headers size limit for your web-server + 'password' => null, // string|null Protect PHP Console connection by password + 'enableSslOnlyMode' => false, // bool Force connection by SSL for clients with PHP Console installed + 'ipMasks' => array(), // array Set IP masks of clients that will be allowed to connect to PHP Console: array('192.168.*.*', '127.0.0.1') + 'enableEvalListener' => false, // bool Enable eval request to be handled by eval dispatcher(if enabled, 'password' option is also required) + 'dumperDetectCallbacks' => false, // bool Convert callback items in dumper vars to (callback SomeClass::someMethod) strings + 'dumperLevelLimit' => 5, // int Maximum dumped vars array or object nested dump level + 'dumperItemsCountLimit' => 100, // int Maximum dumped var same level array items or object properties number + 'dumperItemSizeLimit' => 5000, // int Maximum length of any string or dumped array item + 'dumperDumpSizeLimit' => 500000, // int Maximum approximate size of dumped vars result formatted in JSON + 'detectDumpTraceAndSource' => false, // bool Autodetect and append trace data to debug + 'dataStorage' => null, // PhpConsole\Storage|null Fixes problem with custom $_SESSION handler(see http://goo.gl/Ne8juJ) + ); + + /** @var Connector */ + private $connector; + + /** + * @param array $options See \Monolog\Handler\PHPConsoleHandler::$options for more details + * @param Connector|null $connector Instance of \PhpConsole\Connector class (optional) + * @param int $level + * @param bool $bubble + * @throws Exception + */ + public function __construct(array $options = array(), Connector $connector = null, $level = Logger::DEBUG, $bubble = true) + { + if (!class_exists('PhpConsole\Connector')) { + throw new Exception('PHP Console library not found. See https://github.com/barbushin/php-console#installation'); + } + parent::__construct($level, $bubble); + $this->options = $this->initOptions($options); + $this->connector = $this->initConnector($connector); + } + + private function initOptions(array $options) + { + $wrongOptions = array_diff(array_keys($options), array_keys($this->options)); + if ($wrongOptions) { + throw new Exception('Unknown options: ' . implode(', ', $wrongOptions)); + } + + return array_replace($this->options, $options); + } + + private function initConnector(Connector $connector = null) + { + if (!$connector) { + if ($this->options['dataStorage']) { + Connector::setPostponeStorage($this->options['dataStorage']); + } + $connector = Connector::getInstance(); + } + + if ($this->options['registerHelper'] && !Helper::isRegistered()) { + Helper::register(); + } + + if ($this->options['enabled'] && $connector->isActiveClient()) { + if ($this->options['useOwnErrorsHandler'] || $this->options['useOwnExceptionsHandler']) { + $handler = Handler::getInstance(); + $handler->setHandleErrors($this->options['useOwnErrorsHandler']); + $handler->setHandleExceptions($this->options['useOwnExceptionsHandler']); + $handler->start(); + } + if ($this->options['sourcesBasePath']) { + $connector->setSourcesBasePath($this->options['sourcesBasePath']); + } + if ($this->options['serverEncoding']) { + $connector->setServerEncoding($this->options['serverEncoding']); + } + if ($this->options['password']) { + $connector->setPassword($this->options['password']); + } + if ($this->options['enableSslOnlyMode']) { + $connector->enableSslOnlyMode(); + } + if ($this->options['ipMasks']) { + $connector->setAllowedIpMasks($this->options['ipMasks']); + } + if ($this->options['headersLimit']) { + $connector->setHeadersLimit($this->options['headersLimit']); + } + if ($this->options['detectDumpTraceAndSource']) { + $connector->getDebugDispatcher()->detectTraceAndSource = true; + } + $dumper = $connector->getDumper(); + $dumper->levelLimit = $this->options['dumperLevelLimit']; + $dumper->itemsCountLimit = $this->options['dumperItemsCountLimit']; + $dumper->itemSizeLimit = $this->options['dumperItemSizeLimit']; + $dumper->dumpSizeLimit = $this->options['dumperDumpSizeLimit']; + $dumper->detectCallbacks = $this->options['dumperDetectCallbacks']; + if ($this->options['enableEvalListener']) { + $connector->startEvalRequestsListener(); + } + } + + return $connector; + } + + public function getConnector() + { + return $this->connector; + } + + public function getOptions() + { + return $this->options; + } + + public function handle(array $record) + { + if ($this->options['enabled'] && $this->connector->isActiveClient()) { + return parent::handle($record); + } + + return !$this->bubble; + } + + /** + * Writes the record down to the log of the implementing handler + * + * @param array $record + * @return void + */ + protected function write(array $record) + { + if ($record['level'] < Logger::NOTICE) { + $this->handleDebugRecord($record); + } elseif (isset($record['context']['exception']) && $record['context']['exception'] instanceof Exception) { + $this->handleExceptionRecord($record); + } else { + $this->handleErrorRecord($record); + } + } + + private function handleDebugRecord(array $record) + { + $tags = $this->getRecordTags($record); + $message = $record['message']; + if ($record['context']) { + $message .= ' ' . json_encode($this->connector->getDumper()->dump(array_filter($record['context']))); + } + $this->connector->getDebugDispatcher()->dispatchDebug($message, $tags, $this->options['classesPartialsTraceIgnore']); + } + + private function handleExceptionRecord(array $record) + { + $this->connector->getErrorsDispatcher()->dispatchException($record['context']['exception']); + } + + private function handleErrorRecord(array $record) + { + $context = $record['context']; + + $this->connector->getErrorsDispatcher()->dispatchError( + isset($context['code']) ? $context['code'] : null, + isset($context['message']) ? $context['message'] : $record['message'], + isset($context['file']) ? $context['file'] : null, + isset($context['line']) ? $context['line'] : null, + $this->options['classesPartialsTraceIgnore'] + ); + } + + private function getRecordTags(array &$record) + { + $tags = null; + if (!empty($record['context'])) { + $context = & $record['context']; + foreach ($this->options['debugTagsKeysInContext'] as $key) { + if (!empty($context[$key])) { + $tags = $context[$key]; + if ($key === 0) { + array_shift($context); + } else { + unset($context[$key]); + } + break; + } + } + } + + return $tags ?: strtolower($record['level_name']); + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new LineFormatter('%message%'); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PsrHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PsrHandler.php new file mode 100644 index 0000000..1ae8584 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PsrHandler.php @@ -0,0 +1,56 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Psr\Log\LoggerInterface; + +/** + * Proxies log messages to an existing PSR-3 compliant logger. + * + * @author Michael Moussa + */ +class PsrHandler extends AbstractHandler +{ + /** + * PSR-3 compliant logger + * + * @var LoggerInterface + */ + protected $logger; + + /** + * @param LoggerInterface $logger The underlying PSR-3 compliant logger to which messages will be proxied + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct(LoggerInterface $logger, $level = Logger::DEBUG, $bubble = true) + { + parent::__construct($level, $bubble); + + $this->logger = $logger; + } + + /** + * {@inheritDoc} + */ + public function handle(array $record) + { + if (!$this->isHandling($record)) { + return false; + } + + $this->logger->log(strtolower($record['level_name']), $record['message'], $record['context']); + + return false === $this->bubble; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PushoverHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PushoverHandler.php new file mode 100644 index 0000000..bba7200 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/PushoverHandler.php @@ -0,0 +1,185 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Sends notifications through the pushover api to mobile phones + * + * @author Sebastian Göttschkes + * @see https://www.pushover.net/api + */ +class PushoverHandler extends SocketHandler +{ + private $token; + private $users; + private $title; + private $user; + private $retry; + private $expire; + + private $highPriorityLevel; + private $emergencyLevel; + private $useFormattedMessage = false; + + /** + * All parameters that can be sent to Pushover + * @see https://pushover.net/api + * @var array + */ + private $parameterNames = array( + 'token' => true, + 'user' => true, + 'message' => true, + 'device' => true, + 'title' => true, + 'url' => true, + 'url_title' => true, + 'priority' => true, + 'timestamp' => true, + 'sound' => true, + 'retry' => true, + 'expire' => true, + 'callback' => true, + ); + + /** + * Sounds the api supports by default + * @see https://pushover.net/api#sounds + * @var array + */ + private $sounds = array( + 'pushover', 'bike', 'bugle', 'cashregister', 'classical', 'cosmic', 'falling', 'gamelan', 'incoming', + 'intermission', 'magic', 'mechanical', 'pianobar', 'siren', 'spacealarm', 'tugboat', 'alien', 'climb', + 'persistent', 'echo', 'updown', 'none', + ); + + /** + * @param string $token Pushover api token + * @param string|array $users Pushover user id or array of ids the message will be sent to + * @param string $title Title sent to the Pushover API + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + * @param Boolean $useSSL Whether to connect via SSL. Required when pushing messages to users that are not + * the pushover.net app owner. OpenSSL is required for this option. + * @param int $highPriorityLevel The minimum logging level at which this handler will start + * sending "high priority" requests to the Pushover API + * @param int $emergencyLevel The minimum logging level at which this handler will start + * sending "emergency" requests to the Pushover API + * @param int $retry The retry parameter specifies how often (in seconds) the Pushover servers will send the same notification to the user. + * @param int $expire The expire parameter specifies how many seconds your notification will continue to be retried for (every retry seconds). + */ + public function __construct($token, $users, $title = null, $level = Logger::CRITICAL, $bubble = true, $useSSL = true, $highPriorityLevel = Logger::CRITICAL, $emergencyLevel = Logger::EMERGENCY, $retry = 30, $expire = 25200) + { + $connectionString = $useSSL ? 'ssl://api.pushover.net:443' : 'api.pushover.net:80'; + parent::__construct($connectionString, $level, $bubble); + + $this->token = $token; + $this->users = (array) $users; + $this->title = $title ?: gethostname(); + $this->highPriorityLevel = Logger::toMonologLevel($highPriorityLevel); + $this->emergencyLevel = Logger::toMonologLevel($emergencyLevel); + $this->retry = $retry; + $this->expire = $expire; + } + + protected function generateDataStream($record) + { + $content = $this->buildContent($record); + + return $this->buildHeader($content) . $content; + } + + private function buildContent($record) + { + // Pushover has a limit of 512 characters on title and message combined. + $maxMessageLength = 512 - strlen($this->title); + + $message = ($this->useFormattedMessage) ? $record['formatted'] : $record['message']; + $message = substr($message, 0, $maxMessageLength); + + $timestamp = $record['datetime']->getTimestamp(); + + $dataArray = array( + 'token' => $this->token, + 'user' => $this->user, + 'message' => $message, + 'title' => $this->title, + 'timestamp' => $timestamp, + ); + + if (isset($record['level']) && $record['level'] >= $this->emergencyLevel) { + $dataArray['priority'] = 2; + $dataArray['retry'] = $this->retry; + $dataArray['expire'] = $this->expire; + } elseif (isset($record['level']) && $record['level'] >= $this->highPriorityLevel) { + $dataArray['priority'] = 1; + } + + // First determine the available parameters + $context = array_intersect_key($record['context'], $this->parameterNames); + $extra = array_intersect_key($record['extra'], $this->parameterNames); + + // Least important info should be merged with subsequent info + $dataArray = array_merge($extra, $context, $dataArray); + + // Only pass sounds that are supported by the API + if (isset($dataArray['sound']) && !in_array($dataArray['sound'], $this->sounds)) { + unset($dataArray['sound']); + } + + return http_build_query($dataArray); + } + + private function buildHeader($content) + { + $header = "POST /1/messages.json HTTP/1.1\r\n"; + $header .= "Host: api.pushover.net\r\n"; + $header .= "Content-Type: application/x-www-form-urlencoded\r\n"; + $header .= "Content-Length: " . strlen($content) . "\r\n"; + $header .= "\r\n"; + + return $header; + } + + protected function write(array $record) + { + foreach ($this->users as $user) { + $this->user = $user; + + parent::write($record); + $this->closeSocket(); + } + + $this->user = null; + } + + public function setHighPriorityLevel($value) + { + $this->highPriorityLevel = $value; + } + + public function setEmergencyLevel($value) + { + $this->emergencyLevel = $value; + } + + /** + * Use the formatted message? + * @param bool $value + */ + public function useFormattedMessage($value) + { + $this->useFormattedMessage = (boolean) $value; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RavenHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RavenHandler.php new file mode 100644 index 0000000..53a8b39 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RavenHandler.php @@ -0,0 +1,232 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\LineFormatter; +use Monolog\Formatter\FormatterInterface; +use Monolog\Logger; +use Raven_Client; + +/** + * Handler to send messages to a Sentry (https://github.com/getsentry/sentry) server + * using raven-php (https://github.com/getsentry/raven-php) + * + * @author Marc Abramowitz + */ +class RavenHandler extends AbstractProcessingHandler +{ + /** + * Translates Monolog log levels to Raven log levels. + */ + private $logLevels = array( + Logger::DEBUG => Raven_Client::DEBUG, + Logger::INFO => Raven_Client::INFO, + Logger::NOTICE => Raven_Client::INFO, + Logger::WARNING => Raven_Client::WARNING, + Logger::ERROR => Raven_Client::ERROR, + Logger::CRITICAL => Raven_Client::FATAL, + Logger::ALERT => Raven_Client::FATAL, + Logger::EMERGENCY => Raven_Client::FATAL, + ); + + /** + * @var string should represent the current version of the calling + * software. Can be any string (git commit, version number) + */ + private $release; + + /** + * @var Raven_Client the client object that sends the message to the server + */ + protected $ravenClient; + + /** + * @var LineFormatter The formatter to use for the logs generated via handleBatch() + */ + protected $batchFormatter; + + /** + * @param Raven_Client $ravenClient + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct(Raven_Client $ravenClient, $level = Logger::DEBUG, $bubble = true) + { + parent::__construct($level, $bubble); + + $this->ravenClient = $ravenClient; + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + $level = $this->level; + + // filter records based on their level + $records = array_filter($records, function ($record) use ($level) { + return $record['level'] >= $level; + }); + + if (!$records) { + return; + } + + // the record with the highest severity is the "main" one + $record = array_reduce($records, function ($highest, $record) { + if ($record['level'] > $highest['level']) { + return $record; + } + + return $highest; + }); + + // the other ones are added as a context item + $logs = array(); + foreach ($records as $r) { + $logs[] = $this->processRecord($r); + } + + if ($logs) { + $record['context']['logs'] = (string) $this->getBatchFormatter()->formatBatch($logs); + } + + $this->handle($record); + } + + /** + * Sets the formatter for the logs generated by handleBatch(). + * + * @param FormatterInterface $formatter + */ + public function setBatchFormatter(FormatterInterface $formatter) + { + $this->batchFormatter = $formatter; + } + + /** + * Gets the formatter for the logs generated by handleBatch(). + * + * @return FormatterInterface + */ + public function getBatchFormatter() + { + if (!$this->batchFormatter) { + $this->batchFormatter = $this->getDefaultBatchFormatter(); + } + + return $this->batchFormatter; + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + $previousUserContext = false; + $options = array(); + $options['level'] = $this->logLevels[$record['level']]; + $options['tags'] = array(); + if (!empty($record['extra']['tags'])) { + $options['tags'] = array_merge($options['tags'], $record['extra']['tags']); + unset($record['extra']['tags']); + } + if (!empty($record['context']['tags'])) { + $options['tags'] = array_merge($options['tags'], $record['context']['tags']); + unset($record['context']['tags']); + } + if (!empty($record['context']['fingerprint'])) { + $options['fingerprint'] = $record['context']['fingerprint']; + unset($record['context']['fingerprint']); + } + if (!empty($record['context']['logger'])) { + $options['logger'] = $record['context']['logger']; + unset($record['context']['logger']); + } else { + $options['logger'] = $record['channel']; + } + foreach ($this->getExtraParameters() as $key) { + foreach (array('extra', 'context') as $source) { + if (!empty($record[$source][$key])) { + $options[$key] = $record[$source][$key]; + unset($record[$source][$key]); + } + } + } + if (!empty($record['context'])) { + $options['extra']['context'] = $record['context']; + if (!empty($record['context']['user'])) { + $previousUserContext = $this->ravenClient->context->user; + $this->ravenClient->user_context($record['context']['user']); + unset($options['extra']['context']['user']); + } + } + if (!empty($record['extra'])) { + $options['extra']['extra'] = $record['extra']; + } + + if (!empty($this->release) && !isset($options['release'])) { + $options['release'] = $this->release; + } + + if (isset($record['context']['exception']) && ($record['context']['exception'] instanceof \Exception || (PHP_VERSION_ID >= 70000 && $record['context']['exception'] instanceof \Throwable))) { + $options['extra']['message'] = $record['formatted']; + $this->ravenClient->captureException($record['context']['exception'], $options); + } else { + $this->ravenClient->captureMessage($record['formatted'], array(), $options); + } + + if ($previousUserContext !== false) { + $this->ravenClient->user_context($previousUserContext); + } + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new LineFormatter('[%channel%] %message%'); + } + + /** + * Gets the default formatter for the logs generated by handleBatch(). + * + * @return FormatterInterface + */ + protected function getDefaultBatchFormatter() + { + return new LineFormatter(); + } + + /** + * Gets extra parameters supported by Raven that can be found in "extra" and "context" + * + * @return array + */ + protected function getExtraParameters() + { + return array('checksum', 'release', 'event_id'); + } + + /** + * @param string $value + * @return self + */ + public function setRelease($value) + { + $this->release = $value; + + return $this; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RedisHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RedisHandler.php new file mode 100644 index 0000000..590f996 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RedisHandler.php @@ -0,0 +1,97 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\LineFormatter; +use Monolog\Logger; + +/** + * Logs to a Redis key using rpush + * + * usage example: + * + * $log = new Logger('application'); + * $redis = new RedisHandler(new Predis\Client("tcp://localhost:6379"), "logs", "prod"); + * $log->pushHandler($redis); + * + * @author Thomas Tourlourat + */ +class RedisHandler extends AbstractProcessingHandler +{ + private $redisClient; + private $redisKey; + protected $capSize; + + /** + * @param \Predis\Client|\Redis $redis The redis instance + * @param string $key The key name to push records to + * @param int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + * @param int $capSize Number of entries to limit list size to + */ + public function __construct($redis, $key, $level = Logger::DEBUG, $bubble = true, $capSize = false) + { + if (!(($redis instanceof \Predis\Client) || ($redis instanceof \Redis))) { + throw new \InvalidArgumentException('Predis\Client or Redis instance required'); + } + + $this->redisClient = $redis; + $this->redisKey = $key; + $this->capSize = $capSize; + + parent::__construct($level, $bubble); + } + + /** + * {@inheritDoc} + */ + protected function write(array $record) + { + if ($this->capSize) { + $this->writeCapped($record); + } else { + $this->redisClient->rpush($this->redisKey, $record["formatted"]); + } + } + + /** + * Write and cap the collection + * Writes the record to the redis list and caps its + * + * @param array $record associative record array + * @return void + */ + protected function writeCapped(array $record) + { + if ($this->redisClient instanceof \Redis) { + $this->redisClient->multi() + ->rpush($this->redisKey, $record["formatted"]) + ->ltrim($this->redisKey, -$this->capSize, -1) + ->exec(); + } else { + $redisKey = $this->redisKey; + $capSize = $this->capSize; + $this->redisClient->transaction(function ($tx) use ($record, $redisKey, $capSize) { + $tx->rpush($redisKey, $record["formatted"]); + $tx->ltrim($redisKey, -$capSize, -1); + }); + } + } + + /** + * {@inheritDoc} + */ + protected function getDefaultFormatter() + { + return new LineFormatter(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RollbarHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RollbarHandler.php new file mode 100644 index 0000000..6c8a3e3 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RollbarHandler.php @@ -0,0 +1,132 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use RollbarNotifier; +use Exception; +use Monolog\Logger; + +/** + * Sends errors to Rollbar + * + * If the context data contains a `payload` key, that is used as an array + * of payload options to RollbarNotifier's report_message/report_exception methods. + * + * Rollbar's context info will contain the context + extra keys from the log record + * merged, and then on top of that a few keys: + * + * - level (rollbar level name) + * - monolog_level (monolog level name, raw level, as rollbar only has 5 but monolog 8) + * - channel + * - datetime (unix timestamp) + * + * @author Paul Statezny + */ +class RollbarHandler extends AbstractProcessingHandler +{ + /** + * Rollbar notifier + * + * @var RollbarNotifier + */ + protected $rollbarNotifier; + + protected $levelMap = array( + Logger::DEBUG => 'debug', + Logger::INFO => 'info', + Logger::NOTICE => 'info', + Logger::WARNING => 'warning', + Logger::ERROR => 'error', + Logger::CRITICAL => 'critical', + Logger::ALERT => 'critical', + Logger::EMERGENCY => 'critical', + ); + + /** + * Records whether any log records have been added since the last flush of the rollbar notifier + * + * @var bool + */ + private $hasRecords = false; + + protected $initialized = false; + + /** + * @param RollbarNotifier $rollbarNotifier RollbarNotifier object constructed with valid token + * @param int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct(RollbarNotifier $rollbarNotifier, $level = Logger::ERROR, $bubble = true) + { + $this->rollbarNotifier = $rollbarNotifier; + + parent::__construct($level, $bubble); + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + if (!$this->initialized) { + // __destructor() doesn't get called on Fatal errors + register_shutdown_function(array($this, 'close')); + $this->initialized = true; + } + + $context = $record['context']; + $payload = array(); + if (isset($context['payload'])) { + $payload = $context['payload']; + unset($context['payload']); + } + $context = array_merge($context, $record['extra'], array( + 'level' => $this->levelMap[$record['level']], + 'monolog_level' => $record['level_name'], + 'channel' => $record['channel'], + 'datetime' => $record['datetime']->format('U'), + )); + + if (isset($context['exception']) && $context['exception'] instanceof Exception) { + $payload['level'] = $context['level']; + $exception = $context['exception']; + unset($context['exception']); + + $this->rollbarNotifier->report_exception($exception, $context, $payload); + } else { + $this->rollbarNotifier->report_message( + $record['message'], + $context['level'], + $context, + $payload + ); + } + + $this->hasRecords = true; + } + + public function flush() + { + if ($this->hasRecords) { + $this->rollbarNotifier->flush(); + $this->hasRecords = false; + } + } + + /** + * {@inheritdoc} + */ + public function close() + { + $this->flush(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RotatingFileHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RotatingFileHandler.php new file mode 100644 index 0000000..3b60b3d --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/RotatingFileHandler.php @@ -0,0 +1,178 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Stores logs to files that are rotated every day and a limited number of files are kept. + * + * This rotation is only intended to be used as a workaround. Using logrotate to + * handle the rotation is strongly encouraged when you can use it. + * + * @author Christophe Coevoet + * @author Jordi Boggiano + */ +class RotatingFileHandler extends StreamHandler +{ + const FILE_PER_DAY = 'Y-m-d'; + const FILE_PER_MONTH = 'Y-m'; + const FILE_PER_YEAR = 'Y'; + + protected $filename; + protected $maxFiles; + protected $mustRotate; + protected $nextRotation; + protected $filenameFormat; + protected $dateFormat; + + /** + * @param string $filename + * @param int $maxFiles The maximal amount of files to keep (0 means unlimited) + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + * @param int|null $filePermission Optional file permissions (default (0644) are only for owner read/write) + * @param Boolean $useLocking Try to lock log file before doing any writes + */ + public function __construct($filename, $maxFiles = 0, $level = Logger::DEBUG, $bubble = true, $filePermission = null, $useLocking = false) + { + $this->filename = $filename; + $this->maxFiles = (int) $maxFiles; + $this->nextRotation = new \DateTime('tomorrow'); + $this->filenameFormat = '{filename}-{date}'; + $this->dateFormat = 'Y-m-d'; + + parent::__construct($this->getTimedFilename(), $level, $bubble, $filePermission, $useLocking); + } + + /** + * {@inheritdoc} + */ + public function close() + { + parent::close(); + + if (true === $this->mustRotate) { + $this->rotate(); + } + } + + public function setFilenameFormat($filenameFormat, $dateFormat) + { + if (!preg_match('{^Y(([/_.-]?m)([/_.-]?d)?)?$}', $dateFormat)) { + trigger_error( + 'Invalid date format - format must be one of '. + 'RotatingFileHandler::FILE_PER_DAY ("Y-m-d"), RotatingFileHandler::FILE_PER_MONTH ("Y-m") '. + 'or RotatingFileHandler::FILE_PER_YEAR ("Y"), or you can set one of the '. + 'date formats using slashes, underscores and/or dots instead of dashes.', + E_USER_DEPRECATED + ); + } + if (substr_count($filenameFormat, '{date}') === 0) { + trigger_error( + 'Invalid filename format - format should contain at least `{date}`, because otherwise rotating is impossible.', + E_USER_DEPRECATED + ); + } + $this->filenameFormat = $filenameFormat; + $this->dateFormat = $dateFormat; + $this->url = $this->getTimedFilename(); + $this->close(); + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + // on the first record written, if the log is new, we should rotate (once per day) + if (null === $this->mustRotate) { + $this->mustRotate = !file_exists($this->url); + } + + if ($this->nextRotation < $record['datetime']) { + $this->mustRotate = true; + $this->close(); + } + + parent::write($record); + } + + /** + * Rotates the files. + */ + protected function rotate() + { + // update filename + $this->url = $this->getTimedFilename(); + $this->nextRotation = new \DateTime('tomorrow'); + + // skip GC of old logs if files are unlimited + if (0 === $this->maxFiles) { + return; + } + + $logFiles = glob($this->getGlobPattern()); + if ($this->maxFiles >= count($logFiles)) { + // no files to remove + return; + } + + // Sorting the files by name to remove the older ones + usort($logFiles, function ($a, $b) { + return strcmp($b, $a); + }); + + foreach (array_slice($logFiles, $this->maxFiles) as $file) { + if (is_writable($file)) { + // suppress errors here as unlink() might fail if two processes + // are cleaning up/rotating at the same time + set_error_handler(function ($errno, $errstr, $errfile, $errline) {}); + unlink($file); + restore_error_handler(); + } + } + + $this->mustRotate = false; + } + + protected function getTimedFilename() + { + $fileInfo = pathinfo($this->filename); + $timedFilename = str_replace( + array('{filename}', '{date}'), + array($fileInfo['filename'], date($this->dateFormat)), + $fileInfo['dirname'] . '/' . $this->filenameFormat + ); + + if (!empty($fileInfo['extension'])) { + $timedFilename .= '.'.$fileInfo['extension']; + } + + return $timedFilename; + } + + protected function getGlobPattern() + { + $fileInfo = pathinfo($this->filename); + $glob = str_replace( + array('{filename}', '{date}'), + array($fileInfo['filename'], '*'), + $fileInfo['dirname'] . '/' . $this->filenameFormat + ); + if (!empty($fileInfo['extension'])) { + $glob .= '.'.$fileInfo['extension']; + } + + return $glob; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SamplingHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SamplingHandler.php new file mode 100644 index 0000000..9509ae3 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SamplingHandler.php @@ -0,0 +1,82 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +/** + * Sampling handler + * + * A sampled event stream can be useful for logging high frequency events in + * a production environment where you only need an idea of what is happening + * and are not concerned with capturing every occurrence. Since the decision to + * handle or not handle a particular event is determined randomly, the + * resulting sampled log is not guaranteed to contain 1/N of the events that + * occurred in the application, but based on the Law of large numbers, it will + * tend to be close to this ratio with a large number of attempts. + * + * @author Bryan Davis + * @author Kunal Mehta + */ +class SamplingHandler extends AbstractHandler +{ + /** + * @var callable|HandlerInterface $handler + */ + protected $handler; + + /** + * @var int $factor + */ + protected $factor; + + /** + * @param callable|HandlerInterface $handler Handler or factory callable($record, $fingersCrossedHandler). + * @param int $factor Sample factor + */ + public function __construct($handler, $factor) + { + parent::__construct(); + $this->handler = $handler; + $this->factor = $factor; + + if (!$this->handler instanceof HandlerInterface && !is_callable($this->handler)) { + throw new \RuntimeException("The given handler (".json_encode($this->handler).") is not a callable nor a Monolog\Handler\HandlerInterface object"); + } + } + + public function isHandling(array $record) + { + return $this->handler->isHandling($record); + } + + public function handle(array $record) + { + if ($this->isHandling($record) && mt_rand(1, $this->factor) === 1) { + // The same logic as in FingersCrossedHandler + if (!$this->handler instanceof HandlerInterface) { + $this->handler = call_user_func($this->handler, $record, $this); + if (!$this->handler instanceof HandlerInterface) { + throw new \RuntimeException("The factory callable should return a HandlerInterface"); + } + } + + if ($this->processors) { + foreach ($this->processors as $processor) { + $record = call_user_func($processor, $record); + } + } + + $this->handler->handle($record); + } + + return false === $this->bubble; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php new file mode 100644 index 0000000..38bc838 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php @@ -0,0 +1,294 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler\Slack; + +use Monolog\Logger; +use Monolog\Formatter\NormalizerFormatter; +use Monolog\Formatter\FormatterInterface; + +/** + * Slack record utility helping to log to Slack webhooks or API. + * + * @author Greg Kedzierski + * @author Haralan Dobrev + * @see https://api.slack.com/incoming-webhooks + * @see https://api.slack.com/docs/message-attachments + */ +class SlackRecord +{ + const COLOR_DANGER = 'danger'; + + const COLOR_WARNING = 'warning'; + + const COLOR_GOOD = 'good'; + + const COLOR_DEFAULT = '#e3e4e6'; + + /** + * Slack channel (encoded ID or name) + * @var string|null + */ + private $channel; + + /** + * Name of a bot + * @var string|null + */ + private $username; + + /** + * User icon e.g. 'ghost', 'http://example.com/user.png' + * @var string + */ + private $userIcon; + + /** + * Whether the message should be added to Slack as attachment (plain text otherwise) + * @var bool + */ + private $useAttachment; + + /** + * Whether the the context/extra messages added to Slack as attachments are in a short style + * @var bool + */ + private $useShortAttachment; + + /** + * Whether the attachment should include context and extra data + * @var bool + */ + private $includeContextAndExtra; + + /** + * Dot separated list of fields to exclude from slack message. E.g. ['context.field1', 'extra.field2'] + * @var array + */ + private $excludeFields; + + /** + * @var FormatterInterface + */ + private $formatter; + + /** + * @var NormalizerFormatter + */ + private $normalizerFormatter; + + public function __construct($channel = null, $username = null, $useAttachment = true, $userIcon = null, $useShortAttachment = false, $includeContextAndExtra = false, array $excludeFields = array(), FormatterInterface $formatter = null) + { + $this->channel = $channel; + $this->username = $username; + $this->userIcon = trim($userIcon, ':'); + $this->useAttachment = $useAttachment; + $this->useShortAttachment = $useShortAttachment; + $this->includeContextAndExtra = $includeContextAndExtra; + $this->excludeFields = $excludeFields; + $this->formatter = $formatter; + + if ($this->includeContextAndExtra) { + $this->normalizerFormatter = new NormalizerFormatter(); + } + } + + public function getSlackData(array $record) + { + $dataArray = array(); + $record = $this->excludeFields($record); + + if ($this->username) { + $dataArray['username'] = $this->username; + } + + if ($this->channel) { + $dataArray['channel'] = $this->channel; + } + + if ($this->formatter && !$this->useAttachment) { + $message = $this->formatter->format($record); + } else { + $message = $record['message']; + } + + if ($this->useAttachment) { + $attachment = array( + 'fallback' => $message, + 'text' => $message, + 'color' => $this->getAttachmentColor($record['level']), + 'fields' => array(), + 'mrkdwn_in' => array('fields'), + 'ts' => $record['datetime']->getTimestamp() + ); + + if ($this->useShortAttachment) { + $attachment['title'] = $record['level_name']; + } else { + $attachment['title'] = 'Message'; + $attachment['fields'][] = $this->generateAttachmentField('Level', $record['level_name']); + } + + + if ($this->includeContextAndExtra) { + foreach (array('extra', 'context') as $key) { + if (empty($record[$key])) { + continue; + } + + if ($this->useShortAttachment) { + $attachment['fields'][] = $this->generateAttachmentField( + ucfirst($key), + $record[$key] + ); + } else { + // Add all extra fields as individual fields in attachment + $attachment['fields'] = array_merge( + $attachment['fields'], + $this->generateAttachmentFields($record[$key]) + ); + } + } + } + + $dataArray['attachments'] = array($attachment); + } else { + $dataArray['text'] = $message; + } + + if ($this->userIcon) { + if (filter_var($this->userIcon, FILTER_VALIDATE_URL)) { + $dataArray['icon_url'] = $this->userIcon; + } else { + $dataArray['icon_emoji'] = ":{$this->userIcon}:"; + } + } + + return $dataArray; + } + + /** + * Returned a Slack message attachment color associated with + * provided level. + * + * @param int $level + * @return string + */ + public function getAttachmentColor($level) + { + switch (true) { + case $level >= Logger::ERROR: + return self::COLOR_DANGER; + case $level >= Logger::WARNING: + return self::COLOR_WARNING; + case $level >= Logger::INFO: + return self::COLOR_GOOD; + default: + return self::COLOR_DEFAULT; + } + } + + /** + * Stringifies an array of key/value pairs to be used in attachment fields + * + * @param array $fields + * + * @return string + */ + public function stringify($fields) + { + $normalized = $this->normalizerFormatter->format($fields); + $prettyPrintFlag = defined('JSON_PRETTY_PRINT') ? JSON_PRETTY_PRINT : 128; + + $hasSecondDimension = count(array_filter($normalized, 'is_array')); + $hasNonNumericKeys = !count(array_filter(array_keys($normalized), 'is_numeric')); + + return $hasSecondDimension || $hasNonNumericKeys + ? json_encode($normalized, $prettyPrintFlag) + : json_encode($normalized); + } + + /** + * Sets the formatter + * + * @param FormatterInterface $formatter + */ + public function setFormatter(FormatterInterface $formatter) + { + $this->formatter = $formatter; + } + + /** + * Generates attachment field + * + * @param string $title + * @param string|array $value\ + * + * @return array + */ + private function generateAttachmentField($title, $value) + { + $value = is_array($value) + ? sprintf('```%s```', $this->stringify($value)) + : $value; + + return array( + 'title' => $title, + 'value' => $value, + 'short' => false + ); + } + + /** + * Generates a collection of attachment fields from array + * + * @param array $data + * + * @return array + */ + private function generateAttachmentFields(array $data) + { + $fields = array(); + foreach ($data as $key => $value) { + $fields[] = $this->generateAttachmentField($key, $value); + } + + return $fields; + } + + /** + * Get a copy of record with fields excluded according to $this->excludeFields + * + * @param array $record + * + * @return array + */ + private function excludeFields(array $record) + { + foreach ($this->excludeFields as $field) { + $keys = explode('.', $field); + $node = &$record; + $lastKey = end($keys); + foreach ($keys as $key) { + if (!isset($node[$key])) { + break; + } + if ($lastKey === $key) { + unset($node[$key]); + break; + } + $node = &$node[$key]; + } + } + + return $record; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackHandler.php new file mode 100644 index 0000000..3ac4d83 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackHandler.php @@ -0,0 +1,215 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\FormatterInterface; +use Monolog\Logger; +use Monolog\Handler\Slack\SlackRecord; + +/** + * Sends notifications through Slack API + * + * @author Greg Kedzierski + * @see https://api.slack.com/ + */ +class SlackHandler extends SocketHandler +{ + /** + * Slack API token + * @var string + */ + private $token; + + /** + * Instance of the SlackRecord util class preparing data for Slack API. + * @var SlackRecord + */ + private $slackRecord; + + /** + * @param string $token Slack API token + * @param string $channel Slack channel (encoded ID or name) + * @param string|null $username Name of a bot + * @param bool $useAttachment Whether the message should be added to Slack as attachment (plain text otherwise) + * @param string|null $iconEmoji The emoji name to use (or null) + * @param int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + * @param bool $useShortAttachment Whether the the context/extra messages added to Slack as attachments are in a short style + * @param bool $includeContextAndExtra Whether the attachment should include context and extra data + * @param array $excludeFields Dot separated list of fields to exclude from slack message. E.g. ['context.field1', 'extra.field2'] + * @throws MissingExtensionException If no OpenSSL PHP extension configured + */ + public function __construct($token, $channel, $username = null, $useAttachment = true, $iconEmoji = null, $level = Logger::CRITICAL, $bubble = true, $useShortAttachment = false, $includeContextAndExtra = false, array $excludeFields = array()) + { + if (!extension_loaded('openssl')) { + throw new MissingExtensionException('The OpenSSL PHP extension is required to use the SlackHandler'); + } + + parent::__construct('ssl://slack.com:443', $level, $bubble); + + $this->slackRecord = new SlackRecord( + $channel, + $username, + $useAttachment, + $iconEmoji, + $useShortAttachment, + $includeContextAndExtra, + $excludeFields, + $this->formatter + ); + + $this->token = $token; + } + + public function getSlackRecord() + { + return $this->slackRecord; + } + + /** + * {@inheritdoc} + * + * @param array $record + * @return string + */ + protected function generateDataStream($record) + { + $content = $this->buildContent($record); + + return $this->buildHeader($content) . $content; + } + + /** + * Builds the body of API call + * + * @param array $record + * @return string + */ + private function buildContent($record) + { + $dataArray = $this->prepareContentData($record); + + return http_build_query($dataArray); + } + + /** + * Prepares content data + * + * @param array $record + * @return array + */ + protected function prepareContentData($record) + { + $dataArray = $this->slackRecord->getSlackData($record); + $dataArray['token'] = $this->token; + + if (!empty($dataArray['attachments'])) { + $dataArray['attachments'] = json_encode($dataArray['attachments']); + } + + return $dataArray; + } + + /** + * Builds the header of the API Call + * + * @param string $content + * @return string + */ + private function buildHeader($content) + { + $header = "POST /api/chat.postMessage HTTP/1.1\r\n"; + $header .= "Host: slack.com\r\n"; + $header .= "Content-Type: application/x-www-form-urlencoded\r\n"; + $header .= "Content-Length: " . strlen($content) . "\r\n"; + $header .= "\r\n"; + + return $header; + } + + /** + * {@inheritdoc} + * + * @param array $record + */ + protected function write(array $record) + { + parent::write($record); + $this->finalizeWrite(); + } + + /** + * Finalizes the request by reading some bytes and then closing the socket + * + * If we do not read some but close the socket too early, slack sometimes + * drops the request entirely. + */ + protected function finalizeWrite() + { + $res = $this->getResource(); + if (is_resource($res)) { + @fread($res, 2048); + } + $this->closeSocket(); + } + + /** + * Returned a Slack message attachment color associated with + * provided level. + * + * @param int $level + * @return string + * @deprecated Use underlying SlackRecord instead + */ + protected function getAttachmentColor($level) + { + trigger_error( + 'SlackHandler::getAttachmentColor() is deprecated. Use underlying SlackRecord instead.', + E_USER_DEPRECATED + ); + + return $this->slackRecord->getAttachmentColor($level); + } + + /** + * Stringifies an array of key/value pairs to be used in attachment fields + * + * @param array $fields + * @return string + * @deprecated Use underlying SlackRecord instead + */ + protected function stringify($fields) + { + trigger_error( + 'SlackHandler::stringify() is deprecated. Use underlying SlackRecord instead.', + E_USER_DEPRECATED + ); + + return $this->slackRecord->stringify($fields); + } + + public function setFormatter(FormatterInterface $formatter) + { + parent::setFormatter($formatter); + $this->slackRecord->setFormatter($formatter); + + return $this; + } + + public function getFormatter() + { + $formatter = parent::getFormatter(); + $this->slackRecord->setFormatter($formatter); + + return $formatter; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackWebhookHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackWebhookHandler.php new file mode 100644 index 0000000..9a1bbb4 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackWebhookHandler.php @@ -0,0 +1,115 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\FormatterInterface; +use Monolog\Logger; +use Monolog\Handler\Slack\SlackRecord; + +/** + * Sends notifications through Slack Webhooks + * + * @author Haralan Dobrev + * @see https://api.slack.com/incoming-webhooks + */ +class SlackWebhookHandler extends AbstractProcessingHandler +{ + /** + * Slack Webhook token + * @var string + */ + private $webhookUrl; + + /** + * Instance of the SlackRecord util class preparing data for Slack API. + * @var SlackRecord + */ + private $slackRecord; + + /** + * @param string $webhookUrl Slack Webhook URL + * @param string|null $channel Slack channel (encoded ID or name) + * @param string|null $username Name of a bot + * @param bool $useAttachment Whether the message should be added to Slack as attachment (plain text otherwise) + * @param string|null $iconEmoji The emoji name to use (or null) + * @param bool $useShortAttachment Whether the the context/extra messages added to Slack as attachments are in a short style + * @param bool $includeContextAndExtra Whether the attachment should include context and extra data + * @param int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + * @param array $excludeFields Dot separated list of fields to exclude from slack message. E.g. ['context.field1', 'extra.field2'] + */ + public function __construct($webhookUrl, $channel = null, $username = null, $useAttachment = true, $iconEmoji = null, $useShortAttachment = false, $includeContextAndExtra = false, $level = Logger::CRITICAL, $bubble = true, array $excludeFields = array()) + { + parent::__construct($level, $bubble); + + $this->webhookUrl = $webhookUrl; + + $this->slackRecord = new SlackRecord( + $channel, + $username, + $useAttachment, + $iconEmoji, + $useShortAttachment, + $includeContextAndExtra, + $excludeFields, + $this->formatter + ); + } + + public function getSlackRecord() + { + return $this->slackRecord; + } + + /** + * {@inheritdoc} + * + * @param array $record + */ + protected function write(array $record) + { + $postData = $this->slackRecord->getSlackData($record); + $postString = json_encode($postData); + + $ch = curl_init(); + $options = array( + CURLOPT_URL => $this->webhookUrl, + CURLOPT_POST => true, + CURLOPT_RETURNTRANSFER => true, + CURLOPT_HTTPHEADER => array('Content-type: application/json'), + CURLOPT_POSTFIELDS => $postString + ); + if (defined('CURLOPT_SAFE_UPLOAD')) { + $options[CURLOPT_SAFE_UPLOAD] = true; + } + + curl_setopt_array($ch, $options); + + Curl\Util::execute($ch); + } + + public function setFormatter(FormatterInterface $formatter) + { + parent::setFormatter($formatter); + $this->slackRecord->setFormatter($formatter); + + return $this; + } + + public function getFormatter() + { + $formatter = parent::getFormatter(); + $this->slackRecord->setFormatter($formatter); + + return $formatter; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackbotHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackbotHandler.php new file mode 100644 index 0000000..baead52 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SlackbotHandler.php @@ -0,0 +1,80 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Sends notifications through Slack's Slackbot + * + * @author Haralan Dobrev + * @see https://slack.com/apps/A0F81R8ET-slackbot + */ +class SlackbotHandler extends AbstractProcessingHandler +{ + /** + * The slug of the Slack team + * @var string + */ + private $slackTeam; + + /** + * Slackbot token + * @var string + */ + private $token; + + /** + * Slack channel name + * @var string + */ + private $channel; + + /** + * @param string $slackTeam Slack team slug + * @param string $token Slackbot token + * @param string $channel Slack channel (encoded ID or name) + * @param int $level The minimum logging level at which this handler will be triggered + * @param bool $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($slackTeam, $token, $channel, $level = Logger::CRITICAL, $bubble = true) + { + parent::__construct($level, $bubble); + + $this->slackTeam = $slackTeam; + $this->token = $token; + $this->channel = $channel; + } + + /** + * {@inheritdoc} + * + * @param array $record + */ + protected function write(array $record) + { + $slackbotUrl = sprintf( + 'https://%s.slack.com/services/hooks/slackbot?token=%s&channel=%s', + $this->slackTeam, + $this->token, + $this->channel + ); + + $ch = curl_init(); + curl_setopt($ch, CURLOPT_URL, $slackbotUrl); + curl_setopt($ch, CURLOPT_POST, true); + curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); + curl_setopt($ch, CURLOPT_POSTFIELDS, $record['message']); + + Curl\Util::execute($ch); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SocketHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SocketHandler.php new file mode 100644 index 0000000..7a61bf4 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SocketHandler.php @@ -0,0 +1,346 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Stores to any socket - uses fsockopen() or pfsockopen(). + * + * @author Pablo de Leon Belloc + * @see http://php.net/manual/en/function.fsockopen.php + */ +class SocketHandler extends AbstractProcessingHandler +{ + private $connectionString; + private $connectionTimeout; + private $resource; + private $timeout = 0; + private $writingTimeout = 10; + private $lastSentBytes = null; + private $persistent = false; + private $errno; + private $errstr; + private $lastWritingAt; + + /** + * @param string $connectionString Socket connection string + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct($connectionString, $level = Logger::DEBUG, $bubble = true) + { + parent::__construct($level, $bubble); + $this->connectionString = $connectionString; + $this->connectionTimeout = (float) ini_get('default_socket_timeout'); + } + + /** + * Connect (if necessary) and write to the socket + * + * @param array $record + * + * @throws \UnexpectedValueException + * @throws \RuntimeException + */ + protected function write(array $record) + { + $this->connectIfNotConnected(); + $data = $this->generateDataStream($record); + $this->writeToSocket($data); + } + + /** + * We will not close a PersistentSocket instance so it can be reused in other requests. + */ + public function close() + { + if (!$this->isPersistent()) { + $this->closeSocket(); + } + } + + /** + * Close socket, if open + */ + public function closeSocket() + { + if (is_resource($this->resource)) { + fclose($this->resource); + $this->resource = null; + } + } + + /** + * Set socket connection to nbe persistent. It only has effect before the connection is initiated. + * + * @param bool $persistent + */ + public function setPersistent($persistent) + { + $this->persistent = (boolean) $persistent; + } + + /** + * Set connection timeout. Only has effect before we connect. + * + * @param float $seconds + * + * @see http://php.net/manual/en/function.fsockopen.php + */ + public function setConnectionTimeout($seconds) + { + $this->validateTimeout($seconds); + $this->connectionTimeout = (float) $seconds; + } + + /** + * Set write timeout. Only has effect before we connect. + * + * @param float $seconds + * + * @see http://php.net/manual/en/function.stream-set-timeout.php + */ + public function setTimeout($seconds) + { + $this->validateTimeout($seconds); + $this->timeout = (float) $seconds; + } + + /** + * Set writing timeout. Only has effect during connection in the writing cycle. + * + * @param float $seconds 0 for no timeout + */ + public function setWritingTimeout($seconds) + { + $this->validateTimeout($seconds); + $this->writingTimeout = (float) $seconds; + } + + /** + * Get current connection string + * + * @return string + */ + public function getConnectionString() + { + return $this->connectionString; + } + + /** + * Get persistent setting + * + * @return bool + */ + public function isPersistent() + { + return $this->persistent; + } + + /** + * Get current connection timeout setting + * + * @return float + */ + public function getConnectionTimeout() + { + return $this->connectionTimeout; + } + + /** + * Get current in-transfer timeout + * + * @return float + */ + public function getTimeout() + { + return $this->timeout; + } + + /** + * Get current local writing timeout + * + * @return float + */ + public function getWritingTimeout() + { + return $this->writingTimeout; + } + + /** + * Check to see if the socket is currently available. + * + * UDP might appear to be connected but might fail when writing. See http://php.net/fsockopen for details. + * + * @return bool + */ + public function isConnected() + { + return is_resource($this->resource) + && !feof($this->resource); // on TCP - other party can close connection. + } + + /** + * Wrapper to allow mocking + */ + protected function pfsockopen() + { + return @pfsockopen($this->connectionString, -1, $this->errno, $this->errstr, $this->connectionTimeout); + } + + /** + * Wrapper to allow mocking + */ + protected function fsockopen() + { + return @fsockopen($this->connectionString, -1, $this->errno, $this->errstr, $this->connectionTimeout); + } + + /** + * Wrapper to allow mocking + * + * @see http://php.net/manual/en/function.stream-set-timeout.php + */ + protected function streamSetTimeout() + { + $seconds = floor($this->timeout); + $microseconds = round(($this->timeout - $seconds) * 1e6); + + return stream_set_timeout($this->resource, $seconds, $microseconds); + } + + /** + * Wrapper to allow mocking + */ + protected function fwrite($data) + { + return @fwrite($this->resource, $data); + } + + /** + * Wrapper to allow mocking + */ + protected function streamGetMetadata() + { + return stream_get_meta_data($this->resource); + } + + private function validateTimeout($value) + { + $ok = filter_var($value, FILTER_VALIDATE_FLOAT); + if ($ok === false || $value < 0) { + throw new \InvalidArgumentException("Timeout must be 0 or a positive float (got $value)"); + } + } + + private function connectIfNotConnected() + { + if ($this->isConnected()) { + return; + } + $this->connect(); + } + + protected function generateDataStream($record) + { + return (string) $record['formatted']; + } + + /** + * @return resource|null + */ + protected function getResource() + { + return $this->resource; + } + + private function connect() + { + $this->createSocketResource(); + $this->setSocketTimeout(); + } + + private function createSocketResource() + { + if ($this->isPersistent()) { + $resource = $this->pfsockopen(); + } else { + $resource = $this->fsockopen(); + } + if (!$resource) { + throw new \UnexpectedValueException("Failed connecting to $this->connectionString ($this->errno: $this->errstr)"); + } + $this->resource = $resource; + } + + private function setSocketTimeout() + { + if (!$this->streamSetTimeout()) { + throw new \UnexpectedValueException("Failed setting timeout with stream_set_timeout()"); + } + } + + private function writeToSocket($data) + { + $length = strlen($data); + $sent = 0; + $this->lastSentBytes = $sent; + while ($this->isConnected() && $sent < $length) { + if (0 == $sent) { + $chunk = $this->fwrite($data); + } else { + $chunk = $this->fwrite(substr($data, $sent)); + } + if ($chunk === false) { + throw new \RuntimeException("Could not write to socket"); + } + $sent += $chunk; + $socketInfo = $this->streamGetMetadata(); + if ($socketInfo['timed_out']) { + throw new \RuntimeException("Write timed-out"); + } + + if ($this->writingIsTimedOut($sent)) { + throw new \RuntimeException("Write timed-out, no data sent for `{$this->writingTimeout}` seconds, probably we got disconnected (sent $sent of $length)"); + } + } + if (!$this->isConnected() && $sent < $length) { + throw new \RuntimeException("End-of-file reached, probably we got disconnected (sent $sent of $length)"); + } + } + + private function writingIsTimedOut($sent) + { + $writingTimeout = (int) floor($this->writingTimeout); + if (0 === $writingTimeout) { + return false; + } + + if ($sent !== $this->lastSentBytes) { + $this->lastWritingAt = time(); + $this->lastSentBytes = $sent; + + return false; + } else { + usleep(100); + } + + if ((time() - $this->lastWritingAt) >= $writingTimeout) { + $this->closeSocket(); + + return true; + } + + return false; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/StreamHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/StreamHandler.php new file mode 100644 index 0000000..09a1573 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/StreamHandler.php @@ -0,0 +1,176 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Stores to any stream resource + * + * Can be used to store into php://stderr, remote and local files, etc. + * + * @author Jordi Boggiano + */ +class StreamHandler extends AbstractProcessingHandler +{ + protected $stream; + protected $url; + private $errorMessage; + protected $filePermission; + protected $useLocking; + private $dirCreated; + + /** + * @param resource|string $stream + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + * @param int|null $filePermission Optional file permissions (default (0644) are only for owner read/write) + * @param Boolean $useLocking Try to lock log file before doing any writes + * + * @throws \Exception If a missing directory is not buildable + * @throws \InvalidArgumentException If stream is not a resource or string + */ + public function __construct($stream, $level = Logger::DEBUG, $bubble = true, $filePermission = null, $useLocking = false) + { + parent::__construct($level, $bubble); + if (is_resource($stream)) { + $this->stream = $stream; + } elseif (is_string($stream)) { + $this->url = $stream; + } else { + throw new \InvalidArgumentException('A stream must either be a resource or a string.'); + } + + $this->filePermission = $filePermission; + $this->useLocking = $useLocking; + } + + /** + * {@inheritdoc} + */ + public function close() + { + if ($this->url && is_resource($this->stream)) { + fclose($this->stream); + } + $this->stream = null; + } + + /** + * Return the currently active stream if it is open + * + * @return resource|null + */ + public function getStream() + { + return $this->stream; + } + + /** + * Return the stream URL if it was configured with a URL and not an active resource + * + * @return string|null + */ + public function getUrl() + { + return $this->url; + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + if (!is_resource($this->stream)) { + if (null === $this->url || '' === $this->url) { + throw new \LogicException('Missing stream url, the stream can not be opened. This may be caused by a premature call to close().'); + } + $this->createDir(); + $this->errorMessage = null; + set_error_handler(array($this, 'customErrorHandler')); + $this->stream = fopen($this->url, 'a'); + if ($this->filePermission !== null) { + @chmod($this->url, $this->filePermission); + } + restore_error_handler(); + if (!is_resource($this->stream)) { + $this->stream = null; + throw new \UnexpectedValueException(sprintf('The stream or file "%s" could not be opened: '.$this->errorMessage, $this->url)); + } + } + + if ($this->useLocking) { + // ignoring errors here, there's not much we can do about them + flock($this->stream, LOCK_EX); + } + + $this->streamWrite($this->stream, $record); + + if ($this->useLocking) { + flock($this->stream, LOCK_UN); + } + } + + /** + * Write to stream + * @param resource $stream + * @param array $record + */ + protected function streamWrite($stream, array $record) + { + fwrite($stream, (string) $record['formatted']); + } + + private function customErrorHandler($code, $msg) + { + $this->errorMessage = preg_replace('{^(fopen|mkdir)\(.*?\): }', '', $msg); + } + + /** + * @param string $stream + * + * @return null|string + */ + private function getDirFromStream($stream) + { + $pos = strpos($stream, '://'); + if ($pos === false) { + return dirname($stream); + } + + if ('file://' === substr($stream, 0, 7)) { + return dirname(substr($stream, 7)); + } + + return; + } + + private function createDir() + { + // Do not try to create dir if it has already been tried. + if ($this->dirCreated) { + return; + } + + $dir = $this->getDirFromStream($this->url); + if (null !== $dir && !is_dir($dir)) { + $this->errorMessage = null; + set_error_handler(array($this, 'customErrorHandler')); + $status = mkdir($dir, 0777, true); + restore_error_handler(); + if (false === $status) { + throw new \UnexpectedValueException(sprintf('There is no existing directory at "%s" and its not buildable: '.$this->errorMessage, $dir)); + } + } + $this->dirCreated = true; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SwiftMailerHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SwiftMailerHandler.php new file mode 100644 index 0000000..72f44a5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SwiftMailerHandler.php @@ -0,0 +1,99 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Formatter\LineFormatter; +use Swift; + +/** + * SwiftMailerHandler uses Swift_Mailer to send the emails + * + * @author Gyula Sallai + */ +class SwiftMailerHandler extends MailHandler +{ + protected $mailer; + private $messageTemplate; + + /** + * @param \Swift_Mailer $mailer The mailer to use + * @param callable|\Swift_Message $message An example message for real messages, only the body will be replaced + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + */ + public function __construct(\Swift_Mailer $mailer, $message, $level = Logger::ERROR, $bubble = true) + { + parent::__construct($level, $bubble); + + $this->mailer = $mailer; + $this->messageTemplate = $message; + } + + /** + * {@inheritdoc} + */ + protected function send($content, array $records) + { + $this->mailer->send($this->buildMessage($content, $records)); + } + + /** + * Creates instance of Swift_Message to be sent + * + * @param string $content formatted email body to be sent + * @param array $records Log records that formed the content + * @return \Swift_Message + */ + protected function buildMessage($content, array $records) + { + $message = null; + if ($this->messageTemplate instanceof \Swift_Message) { + $message = clone $this->messageTemplate; + $message->generateId(); + } elseif (is_callable($this->messageTemplate)) { + $message = call_user_func($this->messageTemplate, $content, $records); + } + + if (!$message instanceof \Swift_Message) { + throw new \InvalidArgumentException('Could not resolve message as instance of Swift_Message or a callable returning it'); + } + + if ($records) { + $subjectFormatter = new LineFormatter($message->getSubject()); + $message->setSubject($subjectFormatter->format($this->getHighestRecord($records))); + } + + $message->setBody($content); + if (version_compare(Swift::VERSION, '6.0.0', '>=')) { + $message->setDate(new \DateTimeImmutable()); + } else { + $message->setDate(time()); + } + + return $message; + } + + /** + * BC getter, to be removed in 2.0 + */ + public function __get($name) + { + if ($name === 'message') { + trigger_error('SwiftMailerHandler->message is deprecated, use ->buildMessage() instead to retrieve the message', E_USER_DEPRECATED); + + return $this->buildMessage(null, array()); + } + + throw new \InvalidArgumentException('Invalid property '.$name); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogHandler.php new file mode 100644 index 0000000..376bc3b --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogHandler.php @@ -0,0 +1,67 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; + +/** + * Logs to syslog service. + * + * usage example: + * + * $log = new Logger('application'); + * $syslog = new SyslogHandler('myfacility', 'local6'); + * $formatter = new LineFormatter("%channel%.%level_name%: %message% %extra%"); + * $syslog->setFormatter($formatter); + * $log->pushHandler($syslog); + * + * @author Sven Paulus + */ +class SyslogHandler extends AbstractSyslogHandler +{ + protected $ident; + protected $logopts; + + /** + * @param string $ident + * @param mixed $facility + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + * @param int $logopts Option flags for the openlog() call, defaults to LOG_PID + */ + public function __construct($ident, $facility = LOG_USER, $level = Logger::DEBUG, $bubble = true, $logopts = LOG_PID) + { + parent::__construct($facility, $level, $bubble); + + $this->ident = $ident; + $this->logopts = $logopts; + } + + /** + * {@inheritdoc} + */ + public function close() + { + closelog(); + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + if (!openlog($this->ident, $this->logopts, $this->facility)) { + throw new \LogicException('Can\'t open syslog for ident "'.$this->ident.'" and facility "'.$this->facility.'"'); + } + syslog($this->logLevels[$record['level']], (string) $record['formatted']); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogUdp/UdpSocket.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogUdp/UdpSocket.php new file mode 100644 index 0000000..3bff085 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogUdp/UdpSocket.php @@ -0,0 +1,56 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler\SyslogUdp; + +class UdpSocket +{ + const DATAGRAM_MAX_LENGTH = 65023; + + protected $ip; + protected $port; + protected $socket; + + public function __construct($ip, $port = 514) + { + $this->ip = $ip; + $this->port = $port; + $this->socket = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP); + } + + public function write($line, $header = "") + { + $this->send($this->assembleMessage($line, $header)); + } + + public function close() + { + if (is_resource($this->socket)) { + socket_close($this->socket); + $this->socket = null; + } + } + + protected function send($chunk) + { + if (!is_resource($this->socket)) { + throw new \LogicException('The UdpSocket to '.$this->ip.':'.$this->port.' has been closed and can not be written to anymore'); + } + socket_sendto($this->socket, $chunk, strlen($chunk), $flags = 0, $this->ip, $this->port); + } + + protected function assembleMessage($line, $header) + { + $chunkSize = self::DATAGRAM_MAX_LENGTH - strlen($header); + + return $header . substr($line, 0, $chunkSize); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogUdpHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogUdpHandler.php new file mode 100644 index 0000000..4718711 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/SyslogUdpHandler.php @@ -0,0 +1,103 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Logger; +use Monolog\Handler\SyslogUdp\UdpSocket; + +/** + * A Handler for logging to a remote syslogd server. + * + * @author Jesper Skovgaard Nielsen + */ +class SyslogUdpHandler extends AbstractSyslogHandler +{ + protected $socket; + protected $ident; + + /** + * @param string $host + * @param int $port + * @param mixed $facility + * @param int $level The minimum logging level at which this handler will be triggered + * @param Boolean $bubble Whether the messages that are handled can bubble up the stack or not + * @param string $ident Program name or tag for each log message. + */ + public function __construct($host, $port = 514, $facility = LOG_USER, $level = Logger::DEBUG, $bubble = true, $ident = 'php') + { + parent::__construct($facility, $level, $bubble); + + $this->ident = $ident; + + $this->socket = new UdpSocket($host, $port ?: 514); + } + + protected function write(array $record) + { + $lines = $this->splitMessageIntoLines($record['formatted']); + + $header = $this->makeCommonSyslogHeader($this->logLevels[$record['level']]); + + foreach ($lines as $line) { + $this->socket->write($line, $header); + } + } + + public function close() + { + $this->socket->close(); + } + + private function splitMessageIntoLines($message) + { + if (is_array($message)) { + $message = implode("\n", $message); + } + + return preg_split('/$\R?^/m', $message, -1, PREG_SPLIT_NO_EMPTY); + } + + /** + * Make common syslog header (see rfc5424) + */ + protected function makeCommonSyslogHeader($severity) + { + $priority = $severity + $this->facility; + + if (!$pid = getmypid()) { + $pid = '-'; + } + + if (!$hostname = gethostname()) { + $hostname = '-'; + } + + return "<$priority>1 " . + $this->getDateTime() . " " . + $hostname . " " . + $this->ident . " " . + $pid . " - - "; + } + + protected function getDateTime() + { + return date(\DateTime::RFC3339); + } + + /** + * Inject your own socket, mainly used for testing + */ + public function setSocket($socket) + { + $this->socket = $socket; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/TestHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/TestHandler.php new file mode 100644 index 0000000..e39cfc6 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/TestHandler.php @@ -0,0 +1,154 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +/** + * Used for testing purposes. + * + * It records all records and gives you access to them for verification. + * + * @author Jordi Boggiano + * + * @method bool hasEmergency($record) + * @method bool hasAlert($record) + * @method bool hasCritical($record) + * @method bool hasError($record) + * @method bool hasWarning($record) + * @method bool hasNotice($record) + * @method bool hasInfo($record) + * @method bool hasDebug($record) + * + * @method bool hasEmergencyRecords() + * @method bool hasAlertRecords() + * @method bool hasCriticalRecords() + * @method bool hasErrorRecords() + * @method bool hasWarningRecords() + * @method bool hasNoticeRecords() + * @method bool hasInfoRecords() + * @method bool hasDebugRecords() + * + * @method bool hasEmergencyThatContains($message) + * @method bool hasAlertThatContains($message) + * @method bool hasCriticalThatContains($message) + * @method bool hasErrorThatContains($message) + * @method bool hasWarningThatContains($message) + * @method bool hasNoticeThatContains($message) + * @method bool hasInfoThatContains($message) + * @method bool hasDebugThatContains($message) + * + * @method bool hasEmergencyThatMatches($message) + * @method bool hasAlertThatMatches($message) + * @method bool hasCriticalThatMatches($message) + * @method bool hasErrorThatMatches($message) + * @method bool hasWarningThatMatches($message) + * @method bool hasNoticeThatMatches($message) + * @method bool hasInfoThatMatches($message) + * @method bool hasDebugThatMatches($message) + * + * @method bool hasEmergencyThatPasses($message) + * @method bool hasAlertThatPasses($message) + * @method bool hasCriticalThatPasses($message) + * @method bool hasErrorThatPasses($message) + * @method bool hasWarningThatPasses($message) + * @method bool hasNoticeThatPasses($message) + * @method bool hasInfoThatPasses($message) + * @method bool hasDebugThatPasses($message) + */ +class TestHandler extends AbstractProcessingHandler +{ + protected $records = array(); + protected $recordsByLevel = array(); + + public function getRecords() + { + return $this->records; + } + + public function clear() + { + $this->records = array(); + $this->recordsByLevel = array(); + } + + public function hasRecords($level) + { + return isset($this->recordsByLevel[$level]); + } + + public function hasRecord($record, $level) + { + if (is_array($record)) { + $record = $record['message']; + } + + return $this->hasRecordThatPasses(function ($rec) use ($record) { + return $rec['message'] === $record; + }, $level); + } + + public function hasRecordThatContains($message, $level) + { + return $this->hasRecordThatPasses(function ($rec) use ($message) { + return strpos($rec['message'], $message) !== false; + }, $level); + } + + public function hasRecordThatMatches($regex, $level) + { + return $this->hasRecordThatPasses(function ($rec) use ($regex) { + return preg_match($regex, $rec['message']) > 0; + }, $level); + } + + public function hasRecordThatPasses($predicate, $level) + { + if (!is_callable($predicate)) { + throw new \InvalidArgumentException("Expected a callable for hasRecordThatSucceeds"); + } + + if (!isset($this->recordsByLevel[$level])) { + return false; + } + + foreach ($this->recordsByLevel[$level] as $i => $rec) { + if (call_user_func($predicate, $rec, $i)) { + return true; + } + } + + return false; + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + $this->recordsByLevel[$record['level']][] = $record; + $this->records[] = $record; + } + + public function __call($method, $args) + { + if (preg_match('/(.*)(Debug|Info|Notice|Warning|Error|Critical|Alert|Emergency)(.*)/', $method, $matches) > 0) { + $genericMethod = $matches[1] . ('Records' !== $matches[3] ? 'Record' : '') . $matches[3]; + $level = constant('Monolog\Logger::' . strtoupper($matches[2])); + if (method_exists($this, $genericMethod)) { + $args[] = $level; + + return call_user_func_array(array($this, $genericMethod), $args); + } + } + + throw new \BadMethodCallException('Call to undefined method ' . get_class($this) . '::' . $method . '()'); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/WhatFailureGroupHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/WhatFailureGroupHandler.php new file mode 100644 index 0000000..2732ba3 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/WhatFailureGroupHandler.php @@ -0,0 +1,61 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +/** + * Forwards records to multiple handlers suppressing failures of each handler + * and continuing through to give every handler a chance to succeed. + * + * @author Craig D'Amelio + */ +class WhatFailureGroupHandler extends GroupHandler +{ + /** + * {@inheritdoc} + */ + public function handle(array $record) + { + if ($this->processors) { + foreach ($this->processors as $processor) { + $record = call_user_func($processor, $record); + } + } + + foreach ($this->handlers as $handler) { + try { + $handler->handle($record); + } catch (\Exception $e) { + // What failure? + } catch (\Throwable $e) { + // What failure? + } + } + + return false === $this->bubble; + } + + /** + * {@inheritdoc} + */ + public function handleBatch(array $records) + { + foreach ($this->handlers as $handler) { + try { + $handler->handleBatch($records); + } catch (\Exception $e) { + // What failure? + } catch (\Throwable $e) { + // What failure? + } + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ZendMonitorHandler.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ZendMonitorHandler.php new file mode 100644 index 0000000..f22cf21 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Handler/ZendMonitorHandler.php @@ -0,0 +1,95 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Handler; + +use Monolog\Formatter\NormalizerFormatter; +use Monolog\Logger; + +/** + * Handler sending logs to Zend Monitor + * + * @author Christian Bergau + */ +class ZendMonitorHandler extends AbstractProcessingHandler +{ + /** + * Monolog level / ZendMonitor Custom Event priority map + * + * @var array + */ + protected $levelMap = array( + Logger::DEBUG => 1, + Logger::INFO => 2, + Logger::NOTICE => 3, + Logger::WARNING => 4, + Logger::ERROR => 5, + Logger::CRITICAL => 6, + Logger::ALERT => 7, + Logger::EMERGENCY => 0, + ); + + /** + * Construct + * + * @param int $level + * @param bool $bubble + * @throws MissingExtensionException + */ + public function __construct($level = Logger::DEBUG, $bubble = true) + { + if (!function_exists('zend_monitor_custom_event')) { + throw new MissingExtensionException('You must have Zend Server installed in order to use this handler'); + } + parent::__construct($level, $bubble); + } + + /** + * {@inheritdoc} + */ + protected function write(array $record) + { + $this->writeZendMonitorCustomEvent( + $this->levelMap[$record['level']], + $record['message'], + $record['formatted'] + ); + } + + /** + * Write a record to Zend Monitor + * + * @param int $level + * @param string $message + * @param array $formatted + */ + protected function writeZendMonitorCustomEvent($level, $message, $formatted) + { + zend_monitor_custom_event($level, $message, $formatted); + } + + /** + * {@inheritdoc} + */ + public function getDefaultFormatter() + { + return new NormalizerFormatter(); + } + + /** + * Get the level map + * + * @return array + */ + public function getLevelMap() + { + return $this->levelMap; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Logger.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Logger.php new file mode 100644 index 0000000..49d00af --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Logger.php @@ -0,0 +1,700 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog; + +use Monolog\Handler\HandlerInterface; +use Monolog\Handler\StreamHandler; +use Psr\Log\LoggerInterface; +use Psr\Log\InvalidArgumentException; + +/** + * Monolog log channel + * + * It contains a stack of Handlers and a stack of Processors, + * and uses them to store records that are added to it. + * + * @author Jordi Boggiano + */ +class Logger implements LoggerInterface +{ + /** + * Detailed debug information + */ + const DEBUG = 100; + + /** + * Interesting events + * + * Examples: User logs in, SQL logs. + */ + const INFO = 200; + + /** + * Uncommon events + */ + const NOTICE = 250; + + /** + * Exceptional occurrences that are not errors + * + * Examples: Use of deprecated APIs, poor use of an API, + * undesirable things that are not necessarily wrong. + */ + const WARNING = 300; + + /** + * Runtime errors + */ + const ERROR = 400; + + /** + * Critical conditions + * + * Example: Application component unavailable, unexpected exception. + */ + const CRITICAL = 500; + + /** + * Action must be taken immediately + * + * Example: Entire website down, database unavailable, etc. + * This should trigger the SMS alerts and wake you up. + */ + const ALERT = 550; + + /** + * Urgent alert. + */ + const EMERGENCY = 600; + + /** + * Monolog API version + * + * This is only bumped when API breaks are done and should + * follow the major version of the library + * + * @var int + */ + const API = 1; + + /** + * Logging levels from syslog protocol defined in RFC 5424 + * + * @var array $levels Logging levels + */ + protected static $levels = array( + self::DEBUG => 'DEBUG', + self::INFO => 'INFO', + self::NOTICE => 'NOTICE', + self::WARNING => 'WARNING', + self::ERROR => 'ERROR', + self::CRITICAL => 'CRITICAL', + self::ALERT => 'ALERT', + self::EMERGENCY => 'EMERGENCY', + ); + + /** + * @var \DateTimeZone + */ + protected static $timezone; + + /** + * @var string + */ + protected $name; + + /** + * The handler stack + * + * @var HandlerInterface[] + */ + protected $handlers; + + /** + * Processors that will process all log records + * + * To process records of a single handler instead, add the processor on that specific handler + * + * @var callable[] + */ + protected $processors; + + /** + * @var bool + */ + protected $microsecondTimestamps = true; + + /** + * @param string $name The logging channel + * @param HandlerInterface[] $handlers Optional stack of handlers, the first one in the array is called first, etc. + * @param callable[] $processors Optional array of processors + */ + public function __construct($name, array $handlers = array(), array $processors = array()) + { + $this->name = $name; + $this->handlers = $handlers; + $this->processors = $processors; + } + + /** + * @return string + */ + public function getName() + { + return $this->name; + } + + /** + * Return a new cloned instance with the name changed + * + * @return static + */ + public function withName($name) + { + $new = clone $this; + $new->name = $name; + + return $new; + } + + /** + * Pushes a handler on to the stack. + * + * @param HandlerInterface $handler + * @return $this + */ + public function pushHandler(HandlerInterface $handler) + { + array_unshift($this->handlers, $handler); + + return $this; + } + + /** + * Pops a handler from the stack + * + * @return HandlerInterface + */ + public function popHandler() + { + if (!$this->handlers) { + throw new \LogicException('You tried to pop from an empty handler stack.'); + } + + return array_shift($this->handlers); + } + + /** + * Set handlers, replacing all existing ones. + * + * If a map is passed, keys will be ignored. + * + * @param HandlerInterface[] $handlers + * @return $this + */ + public function setHandlers(array $handlers) + { + $this->handlers = array(); + foreach (array_reverse($handlers) as $handler) { + $this->pushHandler($handler); + } + + return $this; + } + + /** + * @return HandlerInterface[] + */ + public function getHandlers() + { + return $this->handlers; + } + + /** + * Adds a processor on to the stack. + * + * @param callable $callback + * @return $this + */ + public function pushProcessor($callback) + { + if (!is_callable($callback)) { + throw new \InvalidArgumentException('Processors must be valid callables (callback or object with an __invoke method), '.var_export($callback, true).' given'); + } + array_unshift($this->processors, $callback); + + return $this; + } + + /** + * Removes the processor on top of the stack and returns it. + * + * @return callable + */ + public function popProcessor() + { + if (!$this->processors) { + throw new \LogicException('You tried to pop from an empty processor stack.'); + } + + return array_shift($this->processors); + } + + /** + * @return callable[] + */ + public function getProcessors() + { + return $this->processors; + } + + /** + * Control the use of microsecond resolution timestamps in the 'datetime' + * member of new records. + * + * Generating microsecond resolution timestamps by calling + * microtime(true), formatting the result via sprintf() and then parsing + * the resulting string via \DateTime::createFromFormat() can incur + * a measurable runtime overhead vs simple usage of DateTime to capture + * a second resolution timestamp in systems which generate a large number + * of log events. + * + * @param bool $micro True to use microtime() to create timestamps + */ + public function useMicrosecondTimestamps($micro) + { + $this->microsecondTimestamps = (bool) $micro; + } + + /** + * Adds a log record. + * + * @param int $level The logging level + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addRecord($level, $message, array $context = array()) + { + if (!$this->handlers) { + $this->pushHandler(new StreamHandler('php://stderr', static::DEBUG)); + } + + $levelName = static::getLevelName($level); + + // check if any handler will handle this message so we can return early and save cycles + $handlerKey = null; + reset($this->handlers); + while ($handler = current($this->handlers)) { + if ($handler->isHandling(array('level' => $level))) { + $handlerKey = key($this->handlers); + break; + } + + next($this->handlers); + } + + if (null === $handlerKey) { + return false; + } + + if (!static::$timezone) { + static::$timezone = new \DateTimeZone(date_default_timezone_get() ?: 'UTC'); + } + + // php7.1+ always has microseconds enabled, so we do not need this hack + if ($this->microsecondTimestamps && PHP_VERSION_ID < 70100) { + $ts = \DateTime::createFromFormat('U.u', sprintf('%.6F', microtime(true)), static::$timezone); + } else { + $ts = new \DateTime(null, static::$timezone); + } + $ts->setTimezone(static::$timezone); + + $record = array( + 'message' => (string) $message, + 'context' => $context, + 'level' => $level, + 'level_name' => $levelName, + 'channel' => $this->name, + 'datetime' => $ts, + 'extra' => array(), + ); + + foreach ($this->processors as $processor) { + $record = call_user_func($processor, $record); + } + + while ($handler = current($this->handlers)) { + if (true === $handler->handle($record)) { + break; + } + + next($this->handlers); + } + + return true; + } + + /** + * Adds a log record at the DEBUG level. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addDebug($message, array $context = array()) + { + return $this->addRecord(static::DEBUG, $message, $context); + } + + /** + * Adds a log record at the INFO level. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addInfo($message, array $context = array()) + { + return $this->addRecord(static::INFO, $message, $context); + } + + /** + * Adds a log record at the NOTICE level. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addNotice($message, array $context = array()) + { + return $this->addRecord(static::NOTICE, $message, $context); + } + + /** + * Adds a log record at the WARNING level. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addWarning($message, array $context = array()) + { + return $this->addRecord(static::WARNING, $message, $context); + } + + /** + * Adds a log record at the ERROR level. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addError($message, array $context = array()) + { + return $this->addRecord(static::ERROR, $message, $context); + } + + /** + * Adds a log record at the CRITICAL level. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addCritical($message, array $context = array()) + { + return $this->addRecord(static::CRITICAL, $message, $context); + } + + /** + * Adds a log record at the ALERT level. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addAlert($message, array $context = array()) + { + return $this->addRecord(static::ALERT, $message, $context); + } + + /** + * Adds a log record at the EMERGENCY level. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function addEmergency($message, array $context = array()) + { + return $this->addRecord(static::EMERGENCY, $message, $context); + } + + /** + * Gets all supported logging levels. + * + * @return array Assoc array with human-readable level names => level codes. + */ + public static function getLevels() + { + return array_flip(static::$levels); + } + + /** + * Gets the name of the logging level. + * + * @param int $level + * @return string + */ + public static function getLevelName($level) + { + if (!isset(static::$levels[$level])) { + throw new InvalidArgumentException('Level "'.$level.'" is not defined, use one of: '.implode(', ', array_keys(static::$levels))); + } + + return static::$levels[$level]; + } + + /** + * Converts PSR-3 levels to Monolog ones if necessary + * + * @param string|int Level number (monolog) or name (PSR-3) + * @return int + */ + public static function toMonologLevel($level) + { + if (is_string($level) && defined(__CLASS__.'::'.strtoupper($level))) { + return constant(__CLASS__.'::'.strtoupper($level)); + } + + return $level; + } + + /** + * Checks whether the Logger has a handler that listens on the given level + * + * @param int $level + * @return Boolean + */ + public function isHandling($level) + { + $record = array( + 'level' => $level, + ); + + foreach ($this->handlers as $handler) { + if ($handler->isHandling($record)) { + return true; + } + } + + return false; + } + + /** + * Adds a log record at an arbitrary level. + * + * This method allows for compatibility with common interfaces. + * + * @param mixed $level The log level + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function log($level, $message, array $context = array()) + { + $level = static::toMonologLevel($level); + + return $this->addRecord($level, $message, $context); + } + + /** + * Adds a log record at the DEBUG level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function debug($message, array $context = array()) + { + return $this->addRecord(static::DEBUG, $message, $context); + } + + /** + * Adds a log record at the INFO level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function info($message, array $context = array()) + { + return $this->addRecord(static::INFO, $message, $context); + } + + /** + * Adds a log record at the NOTICE level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function notice($message, array $context = array()) + { + return $this->addRecord(static::NOTICE, $message, $context); + } + + /** + * Adds a log record at the WARNING level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function warn($message, array $context = array()) + { + return $this->addRecord(static::WARNING, $message, $context); + } + + /** + * Adds a log record at the WARNING level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function warning($message, array $context = array()) + { + return $this->addRecord(static::WARNING, $message, $context); + } + + /** + * Adds a log record at the ERROR level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function err($message, array $context = array()) + { + return $this->addRecord(static::ERROR, $message, $context); + } + + /** + * Adds a log record at the ERROR level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function error($message, array $context = array()) + { + return $this->addRecord(static::ERROR, $message, $context); + } + + /** + * Adds a log record at the CRITICAL level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function crit($message, array $context = array()) + { + return $this->addRecord(static::CRITICAL, $message, $context); + } + + /** + * Adds a log record at the CRITICAL level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function critical($message, array $context = array()) + { + return $this->addRecord(static::CRITICAL, $message, $context); + } + + /** + * Adds a log record at the ALERT level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function alert($message, array $context = array()) + { + return $this->addRecord(static::ALERT, $message, $context); + } + + /** + * Adds a log record at the EMERGENCY level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function emerg($message, array $context = array()) + { + return $this->addRecord(static::EMERGENCY, $message, $context); + } + + /** + * Adds a log record at the EMERGENCY level. + * + * This method allows for compatibility with common interfaces. + * + * @param string $message The log message + * @param array $context The log context + * @return Boolean Whether the record has been processed + */ + public function emergency($message, array $context = array()) + { + return $this->addRecord(static::EMERGENCY, $message, $context); + } + + /** + * Set the timezone to be used for the timestamp of log records. + * + * This is stored globally for all Logger instances + * + * @param \DateTimeZone $tz Timezone object + */ + public static function setTimezone(\DateTimeZone $tz) + { + self::$timezone = $tz; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/GitProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/GitProcessor.php new file mode 100644 index 0000000..1899400 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/GitProcessor.php @@ -0,0 +1,64 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +use Monolog\Logger; + +/** + * Injects Git branch and Git commit SHA in all records + * + * @author Nick Otter + * @author Jordi Boggiano + */ +class GitProcessor +{ + private $level; + private static $cache; + + public function __construct($level = Logger::DEBUG) + { + $this->level = Logger::toMonologLevel($level); + } + + /** + * @param array $record + * @return array + */ + public function __invoke(array $record) + { + // return if the level is not high enough + if ($record['level'] < $this->level) { + return $record; + } + + $record['extra']['git'] = self::getGitInfo(); + + return $record; + } + + private static function getGitInfo() + { + if (self::$cache) { + return self::$cache; + } + + $branches = `git branch -v --no-abbrev`; + if (preg_match('{^\* (.+?)\s+([a-f0-9]{40})(?:\s|$)}m', $branches, $matches)) { + return self::$cache = array( + 'branch' => $matches[1], + 'commit' => $matches[2], + ); + } + + return self::$cache = array(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/IntrospectionProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/IntrospectionProcessor.php new file mode 100644 index 0000000..2c07cae --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/IntrospectionProcessor.php @@ -0,0 +1,112 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +use Monolog\Logger; + +/** + * Injects line/file:class/function where the log message came from + * + * Warning: This only works if the handler processes the logs directly. + * If you put the processor on a handler that is behind a FingersCrossedHandler + * for example, the processor will only be called once the trigger level is reached, + * and all the log records will have the same file/line/.. data from the call that + * triggered the FingersCrossedHandler. + * + * @author Jordi Boggiano + */ +class IntrospectionProcessor +{ + private $level; + + private $skipClassesPartials; + + private $skipStackFramesCount; + + private $skipFunctions = array( + 'call_user_func', + 'call_user_func_array', + ); + + public function __construct($level = Logger::DEBUG, array $skipClassesPartials = array(), $skipStackFramesCount = 0) + { + $this->level = Logger::toMonologLevel($level); + $this->skipClassesPartials = array_merge(array('Monolog\\'), $skipClassesPartials); + $this->skipStackFramesCount = $skipStackFramesCount; + } + + /** + * @param array $record + * @return array + */ + public function __invoke(array $record) + { + // return if the level is not high enough + if ($record['level'] < $this->level) { + return $record; + } + + /* + * http://php.net/manual/en/function.debug-backtrace.php + * As of 5.3.6, DEBUG_BACKTRACE_IGNORE_ARGS option was added. + * Any version less than 5.3.6 must use the DEBUG_BACKTRACE_IGNORE_ARGS constant value '2'. + */ + $trace = debug_backtrace((PHP_VERSION_ID < 50306) ? 2 : DEBUG_BACKTRACE_IGNORE_ARGS); + + // skip first since it's always the current method + array_shift($trace); + // the call_user_func call is also skipped + array_shift($trace); + + $i = 0; + + while ($this->isTraceClassOrSkippedFunction($trace, $i)) { + if (isset($trace[$i]['class'])) { + foreach ($this->skipClassesPartials as $part) { + if (strpos($trace[$i]['class'], $part) !== false) { + $i++; + continue 2; + } + } + } elseif (in_array($trace[$i]['function'], $this->skipFunctions)) { + $i++; + continue; + } + + break; + } + + $i += $this->skipStackFramesCount; + + // we should have the call source now + $record['extra'] = array_merge( + $record['extra'], + array( + 'file' => isset($trace[$i - 1]['file']) ? $trace[$i - 1]['file'] : null, + 'line' => isset($trace[$i - 1]['line']) ? $trace[$i - 1]['line'] : null, + 'class' => isset($trace[$i]['class']) ? $trace[$i]['class'] : null, + 'function' => isset($trace[$i]['function']) ? $trace[$i]['function'] : null, + ) + ); + + return $record; + } + + private function isTraceClassOrSkippedFunction(array $trace, $index) + { + if (!isset($trace[$index])) { + return false; + } + + return isset($trace[$index]['class']) || in_array($trace[$index]['function'], $this->skipFunctions); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryPeakUsageProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryPeakUsageProcessor.php new file mode 100644 index 0000000..0543e92 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryPeakUsageProcessor.php @@ -0,0 +1,35 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +/** + * Injects memory_get_peak_usage in all records + * + * @see Monolog\Processor\MemoryProcessor::__construct() for options + * @author Rob Jensen + */ +class MemoryPeakUsageProcessor extends MemoryProcessor +{ + /** + * @param array $record + * @return array + */ + public function __invoke(array $record) + { + $bytes = memory_get_peak_usage($this->realUsage); + $formatted = $this->formatBytes($bytes); + + $record['extra']['memory_peak_usage'] = $formatted; + + return $record; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryProcessor.php new file mode 100644 index 0000000..85f9dc5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryProcessor.php @@ -0,0 +1,63 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +/** + * Some methods that are common for all memory processors + * + * @author Rob Jensen + */ +abstract class MemoryProcessor +{ + /** + * @var bool If true, get the real size of memory allocated from system. Else, only the memory used by emalloc() is reported. + */ + protected $realUsage; + + /** + * @var bool If true, then format memory size to human readable string (MB, KB, B depending on size) + */ + protected $useFormatting; + + /** + * @param bool $realUsage Set this to true to get the real size of memory allocated from system. + * @param bool $useFormatting If true, then format memory size to human readable string (MB, KB, B depending on size) + */ + public function __construct($realUsage = true, $useFormatting = true) + { + $this->realUsage = (boolean) $realUsage; + $this->useFormatting = (boolean) $useFormatting; + } + + /** + * Formats bytes into a human readable string if $this->useFormatting is true, otherwise return $bytes as is + * + * @param int $bytes + * @return string|int Formatted string if $this->useFormatting is true, otherwise return $bytes as is + */ + protected function formatBytes($bytes) + { + $bytes = (int) $bytes; + + if (!$this->useFormatting) { + return $bytes; + } + + if ($bytes > 1024 * 1024) { + return round($bytes / 1024 / 1024, 2).' MB'; + } elseif ($bytes > 1024) { + return round($bytes / 1024, 2).' KB'; + } + + return $bytes . ' B'; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryUsageProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryUsageProcessor.php new file mode 100644 index 0000000..2783d65 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MemoryUsageProcessor.php @@ -0,0 +1,35 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +/** + * Injects memory_get_usage in all records + * + * @see Monolog\Processor\MemoryProcessor::__construct() for options + * @author Rob Jensen + */ +class MemoryUsageProcessor extends MemoryProcessor +{ + /** + * @param array $record + * @return array + */ + public function __invoke(array $record) + { + $bytes = memory_get_usage($this->realUsage); + $formatted = $this->formatBytes($bytes); + + $record['extra']['memory_usage'] = $formatted; + + return $record; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MercurialProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MercurialProcessor.php new file mode 100644 index 0000000..7c07a7e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/MercurialProcessor.php @@ -0,0 +1,63 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +use Monolog\Logger; + +/** + * Injects Hg branch and Hg revision number in all records + * + * @author Jonathan A. Schweder + */ +class MercurialProcessor +{ + private $level; + private static $cache; + + public function __construct($level = Logger::DEBUG) + { + $this->level = Logger::toMonologLevel($level); + } + + /** + * @param array $record + * @return array + */ + public function __invoke(array $record) + { + // return if the level is not high enough + if ($record['level'] < $this->level) { + return $record; + } + + $record['extra']['hg'] = self::getMercurialInfo(); + + return $record; + } + + private static function getMercurialInfo() + { + if (self::$cache) { + return self::$cache; + } + + $result = explode(' ', trim(`hg id -nb`)); + if (count($result) >= 3) { + return self::$cache = array( + 'branch' => $result[1], + 'revision' => $result[2], + ); + } + + return self::$cache = array(); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/ProcessIdProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/ProcessIdProcessor.php new file mode 100644 index 0000000..9d3f559 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/ProcessIdProcessor.php @@ -0,0 +1,31 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +/** + * Adds value of getmypid into records + * + * @author Andreas Hörnicke + */ +class ProcessIdProcessor +{ + /** + * @param array $record + * @return array + */ + public function __invoke(array $record) + { + $record['extra']['process_id'] = getmypid(); + + return $record; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/PsrLogMessageProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/PsrLogMessageProcessor.php new file mode 100644 index 0000000..c2686ce --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/PsrLogMessageProcessor.php @@ -0,0 +1,48 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +/** + * Processes a record's message according to PSR-3 rules + * + * It replaces {foo} with the value from $context['foo'] + * + * @author Jordi Boggiano + */ +class PsrLogMessageProcessor +{ + /** + * @param array $record + * @return array + */ + public function __invoke(array $record) + { + if (false === strpos($record['message'], '{')) { + return $record; + } + + $replacements = array(); + foreach ($record['context'] as $key => $val) { + if (is_null($val) || is_scalar($val) || (is_object($val) && method_exists($val, "__toString"))) { + $replacements['{'.$key.'}'] = $val; + } elseif (is_object($val)) { + $replacements['{'.$key.'}'] = '[object '.get_class($val).']'; + } else { + $replacements['{'.$key.'}'] = '['.gettype($val).']'; + } + } + + $record['message'] = strtr($record['message'], $replacements); + + return $record; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/TagProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/TagProcessor.php new file mode 100644 index 0000000..7e2df2a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/TagProcessor.php @@ -0,0 +1,44 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +/** + * Adds a tags array into record + * + * @author Martijn Riemers + */ +class TagProcessor +{ + private $tags; + + public function __construct(array $tags = array()) + { + $this->setTags($tags); + } + + public function addTags(array $tags = array()) + { + $this->tags = array_merge($this->tags, $tags); + } + + public function setTags(array $tags = array()) + { + $this->tags = $tags; + } + + public function __invoke(array $record) + { + $record['extra']['tags'] = $this->tags; + + return $record; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/UidProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/UidProcessor.php new file mode 100644 index 0000000..812707c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/UidProcessor.php @@ -0,0 +1,46 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +/** + * Adds a unique identifier into records + * + * @author Simon Mönch + */ +class UidProcessor +{ + private $uid; + + public function __construct($length = 7) + { + if (!is_int($length) || $length > 32 || $length < 1) { + throw new \InvalidArgumentException('The uid length must be an integer between 1 and 32'); + } + + $this->uid = substr(hash('md5', uniqid('', true)), 0, $length); + } + + public function __invoke(array $record) + { + $record['extra']['uid'] = $this->uid; + + return $record; + } + + /** + * @return string + */ + public function getUid() + { + return $this->uid; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/WebProcessor.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/WebProcessor.php new file mode 100644 index 0000000..ea1d897 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Processor/WebProcessor.php @@ -0,0 +1,113 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog\Processor; + +/** + * Injects url/method and remote IP of the current web request in all records + * + * @author Jordi Boggiano + */ +class WebProcessor +{ + /** + * @var array|\ArrayAccess + */ + protected $serverData; + + /** + * Default fields + * + * Array is structured as [key in record.extra => key in $serverData] + * + * @var array + */ + protected $extraFields = array( + 'url' => 'REQUEST_URI', + 'ip' => 'REMOTE_ADDR', + 'http_method' => 'REQUEST_METHOD', + 'server' => 'SERVER_NAME', + 'referrer' => 'HTTP_REFERER', + ); + + /** + * @param array|\ArrayAccess $serverData Array or object w/ ArrayAccess that provides access to the $_SERVER data + * @param array|null $extraFields Field names and the related key inside $serverData to be added. If not provided it defaults to: url, ip, http_method, server, referrer + */ + public function __construct($serverData = null, array $extraFields = null) + { + if (null === $serverData) { + $this->serverData = &$_SERVER; + } elseif (is_array($serverData) || $serverData instanceof \ArrayAccess) { + $this->serverData = $serverData; + } else { + throw new \UnexpectedValueException('$serverData must be an array or object implementing ArrayAccess.'); + } + + if (null !== $extraFields) { + if (isset($extraFields[0])) { + foreach (array_keys($this->extraFields) as $fieldName) { + if (!in_array($fieldName, $extraFields)) { + unset($this->extraFields[$fieldName]); + } + } + } else { + $this->extraFields = $extraFields; + } + } + } + + /** + * @param array $record + * @return array + */ + public function __invoke(array $record) + { + // skip processing if for some reason request data + // is not present (CLI or wonky SAPIs) + if (!isset($this->serverData['REQUEST_URI'])) { + return $record; + } + + $record['extra'] = $this->appendExtraFields($record['extra']); + + return $record; + } + + /** + * @param string $extraName + * @param string $serverName + * @return $this + */ + public function addExtraField($extraName, $serverName) + { + $this->extraFields[$extraName] = $serverName; + + return $this; + } + + /** + * @param array $extra + * @return array + */ + private function appendExtraFields(array $extra) + { + foreach ($this->extraFields as $extraName => $serverName) { + $extra[$extraName] = isset($this->serverData[$serverName]) ? $this->serverData[$serverName] : null; + } + + if (isset($this->serverData['UNIQUE_ID'])) { + $extra['unique_id'] = $this->serverData['UNIQUE_ID']; + } + + return $extra; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Registry.php b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Registry.php new file mode 100644 index 0000000..159b751 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/monolog/monolog/src/Monolog/Registry.php @@ -0,0 +1,134 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Monolog; + +use InvalidArgumentException; + +/** + * Monolog log registry + * + * Allows to get `Logger` instances in the global scope + * via static method calls on this class. + * + * + * $application = new Monolog\Logger('application'); + * $api = new Monolog\Logger('api'); + * + * Monolog\Registry::addLogger($application); + * Monolog\Registry::addLogger($api); + * + * function testLogger() + * { + * Monolog\Registry::api()->addError('Sent to $api Logger instance'); + * Monolog\Registry::application()->addError('Sent to $application Logger instance'); + * } + * + * + * @author Tomas Tatarko + */ +class Registry +{ + /** + * List of all loggers in the registry (by named indexes) + * + * @var Logger[] + */ + private static $loggers = array(); + + /** + * Adds new logging channel to the registry + * + * @param Logger $logger Instance of the logging channel + * @param string|null $name Name of the logging channel ($logger->getName() by default) + * @param bool $overwrite Overwrite instance in the registry if the given name already exists? + * @throws \InvalidArgumentException If $overwrite set to false and named Logger instance already exists + */ + public static function addLogger(Logger $logger, $name = null, $overwrite = false) + { + $name = $name ?: $logger->getName(); + + if (isset(self::$loggers[$name]) && !$overwrite) { + throw new InvalidArgumentException('Logger with the given name already exists'); + } + + self::$loggers[$name] = $logger; + } + + /** + * Checks if such logging channel exists by name or instance + * + * @param string|Logger $logger Name or logger instance + */ + public static function hasLogger($logger) + { + if ($logger instanceof Logger) { + $index = array_search($logger, self::$loggers, true); + + return false !== $index; + } else { + return isset(self::$loggers[$logger]); + } + } + + /** + * Removes instance from registry by name or instance + * + * @param string|Logger $logger Name or logger instance + */ + public static function removeLogger($logger) + { + if ($logger instanceof Logger) { + if (false !== ($idx = array_search($logger, self::$loggers, true))) { + unset(self::$loggers[$idx]); + } + } else { + unset(self::$loggers[$logger]); + } + } + + /** + * Clears the registry + */ + public static function clear() + { + self::$loggers = array(); + } + + /** + * Gets Logger instance from the registry + * + * @param string $name Name of the requested Logger instance + * @throws \InvalidArgumentException If named Logger instance is not in the registry + * @return Logger Requested instance of Logger + */ + public static function getInstance($name) + { + if (!isset(self::$loggers[$name])) { + throw new InvalidArgumentException(sprintf('Requested "%s" logger instance is not in the registry', $name)); + } + + return self::$loggers[$name]; + } + + /** + * Gets Logger instance from the registry via static method call + * + * @param string $name Name of the requested Logger instance + * @param array $arguments Arguments passed to static method call + * @throws \InvalidArgumentException If named Logger instance is not in the registry + * @return Logger Requested instance of Logger + */ + public static function __callStatic($name, $arguments) + { + return self::getInstance($name); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/AUTHORS b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/AUTHORS new file mode 100644 index 0000000..a08b309 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/AUTHORS @@ -0,0 +1,6 @@ +phpseclib Lead Developer: TerraFrost (Jim Wigginton) + +phpseclib Developers: monnerat (Patrick Monnerat) + bantu (Andreas Fischer) + petrich (Hans-Jürgen Petrich) + GrahamCampbell (Graham Campbell) diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/LICENSE new file mode 100644 index 0000000..a8ec8eb --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/LICENSE @@ -0,0 +1,21 @@ +Copyright 2007-2016 TerraFrost and other contributors +http://phpseclib.sourceforge.net/ + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/README.md b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/README.md new file mode 100644 index 0000000..94402be --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/README.md @@ -0,0 +1,74 @@ +# phpseclib - PHP Secure Communications Library + +[![Build Status](https://travis-ci.org/phpseclib/phpseclib.svg?branch=2.0)](https://travis-ci.org/phpseclib/phpseclib) + +MIT-licensed pure-PHP implementations of an arbitrary-precision integer +arithmetic library, fully PKCS#1 (v2.1) compliant RSA, DES, 3DES, RC4, Rijndael, +AES, Blowfish, Twofish, SSH-1, SSH-2, SFTP, and X.509 + +* [Browse Git](https://github.com/phpseclib/phpseclib) +* [Code Coverage Report](https://coverage.phpseclib.org/2.0/latest/) + +## Documentation + +* [Documentation / Manual](http://phpseclib.sourceforge.net/) +* [API Documentation](https://api.phpseclib.org/2.0/) (generated by Sami) + +## Branches + +### master + +* Development Branch +* Unstable API +* Do not use in production + +### 2.0 + +* Modernized version of 1.0 +* Minimum PHP version: 5.3.3 +* PSR-4 autoloading with namespace rooted at `\phpseclib` +* Install via Composer: `composer require phpseclib/phpseclib ~2.0` + +### 1.0 + +* Long term support (LTS) release +* PHP4 compatible +* Composer compatible (PSR-0 autoloading) +* Install using Composer: `composer require phpseclib/phpseclib ~1.0` +* Install using PEAR: See [phpseclib PEAR Channel Documentation](http://phpseclib.sourceforge.net/pear.htm) +* [Download 1.0.10 as ZIP](http://sourceforge.net/projects/phpseclib/files/phpseclib1.0.10.zip/download) + +## Support + +Need Support? + +* [Checkout Questions and Answers on Stack Overflow](http://stackoverflow.com/questions/tagged/phpseclib) +* [Create a Support Ticket on GitHub](https://github.com/phpseclib/phpseclib/issues/new) +* [Browse the Support Forum](http://www.frostjedi.com/phpbb/viewforum.php?f=46) (no longer in use) + +## Contributing + +1. Fork the Project + +2. Ensure you have Composer installed (see [Composer Download Instructions](https://getcomposer.org/download/)) + +3. Install Development Dependencies + + ``` sh + composer install + ``` + +4. Create a Feature Branch + +5. (Recommended) Run the Test Suite + + ``` sh + vendor/bin/phpunit + ``` +6. (Recommended) Check whether your code conforms to our Coding Standards by running + + ``` sh + vendor/bin/phing -f build/build.xml sniff + ``` + +7. Send us a Pull Request diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/composer.json b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/composer.json new file mode 100644 index 0000000..b4e8a1c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/composer.json @@ -0,0 +1,76 @@ +{ + "name": "phpseclib/phpseclib", + "type": "library", + "description": "PHP Secure Communications Library - Pure-PHP implementations of RSA, AES, SSH2, SFTP, X.509 etc.", + "keywords": [ + "security", + "crypto", + "cryptography", + "encryption", + "signature", + "signing", + "rsa", + "aes", + "blowfish", + "twofish", + "ssh", + "sftp", + "x509", + "x.509", + "asn1", + "asn.1", + "BigInteger" + ], + "homepage": "http://phpseclib.sourceforge.net", + "license": "MIT", + "authors": [ + { + "name": "Jim Wigginton", + "email": "terrafrost@php.net", + "role": "Lead Developer" + }, + { + "name": "Patrick Monnerat", + "email": "pm@datasphere.ch", + "role": "Developer" + }, + { + "name": "Andreas Fischer", + "email": "bantu@phpbb.com", + "role": "Developer" + }, + { + "name": "Hans-Jürgen Petrich", + "email": "petrich@tronic-media.com", + "role": "Developer" + }, + { + "name": "Graham Campbell", + "email": "graham@alt-three.com", + "role": "Developer" + } + ], + "require": { + "php": ">=5.3.3" + }, + "require-dev": { + "phing/phing": "~2.7", + "phpunit/phpunit": "^4.8.35|^5.7|^6.0", + "sami/sami": "~2.0", + "squizlabs/php_codesniffer": "~2.0" + }, + "suggest": { + "ext-libsodium": "SSH2/SFTP can make use of some algorithms provided by the libsodium-php extension.", + "ext-openssl": "Install the OpenSSL extension in order to speed up a wide variety of cryptographic operations.", + "ext-mcrypt": "Install the Mcrypt extension in order to speed up a few other cryptographic operations.", + "ext-gmp": "Install the GMP (GNU Multiple Precision) extension in order to speed up arbitrary precision integer arithmetic operations." + }, + "autoload": { + "files": [ + "phpseclib/bootstrap.php" + ], + "psr-4": { + "phpseclib\\": "phpseclib/" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/AES.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/AES.php new file mode 100644 index 0000000..7d8cb8b --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/AES.php @@ -0,0 +1,126 @@ + + * setKey('abcdefghijklmnop'); + * + * $size = 10 * 1024; + * $plaintext = ''; + * for ($i = 0; $i < $size; $i++) { + * $plaintext.= 'a'; + * } + * + * echo $aes->decrypt($aes->encrypt($plaintext)); + * ?> + * + * + * @category Crypt + * @package AES + * @author Jim Wigginton + * @copyright 2008 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP implementation of AES. + * + * @package AES + * @author Jim Wigginton + * @access public + */ +class AES extends Rijndael +{ + /** + * Dummy function + * + * Since \phpseclib\Crypt\AES extends \phpseclib\Crypt\Rijndael, this function is, technically, available, but it doesn't do anything. + * + * @see \phpseclib\Crypt\Rijndael::setBlockLength() + * @access public + * @param int $length + */ + function setBlockLength($length) + { + return; + } + + /** + * Sets the key length + * + * Valid key lengths are 128, 192, and 256. If the length is less than 128, it will be rounded up to + * 128. If the length is greater than 128 and invalid, it will be rounded down to the closest valid amount. + * + * @see \phpseclib\Crypt\Rijndael:setKeyLength() + * @access public + * @param int $length + */ + function setKeyLength($length) + { + switch ($length) { + case 160: + $length = 192; + break; + case 224: + $length = 256; + } + parent::setKeyLength($length); + } + + /** + * Sets the key. + * + * Rijndael supports five different key lengths, AES only supports three. + * + * @see \phpseclib\Crypt\Rijndael:setKey() + * @see setKeyLength() + * @access public + * @param string $key + */ + function setKey($key) + { + parent::setKey($key); + + if (!$this->explicit_key_length) { + $length = strlen($key); + switch (true) { + case $length <= 16: + $this->key_length = 16; + break; + case $length <= 24: + $this->key_length = 24; + break; + default: + $this->key_length = 32; + } + $this->_setEngine(); + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Base.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Base.php new file mode 100644 index 0000000..54a8997 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Base.php @@ -0,0 +1,2598 @@ + + * @author Hans-Juergen Petrich + * @copyright 2007 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Base Class for all \phpseclib\Crypt\* cipher classes + * + * @package Base + * @author Jim Wigginton + * @author Hans-Juergen Petrich + */ +abstract class Base +{ + /**#@+ + * @access public + * @see \phpseclib\Crypt\Base::encrypt() + * @see \phpseclib\Crypt\Base::decrypt() + */ + /** + * Encrypt / decrypt using the Counter mode. + * + * Set to -1 since that's what Crypt/Random.php uses to index the CTR mode. + * + * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Counter_.28CTR.29 + */ + const MODE_CTR = -1; + /** + * Encrypt / decrypt using the Electronic Code Book mode. + * + * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Electronic_codebook_.28ECB.29 + */ + const MODE_ECB = 1; + /** + * Encrypt / decrypt using the Code Book Chaining mode. + * + * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Cipher-block_chaining_.28CBC.29 + */ + const MODE_CBC = 2; + /** + * Encrypt / decrypt using the Cipher Feedback mode. + * + * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Cipher_feedback_.28CFB.29 + */ + const MODE_CFB = 3; + /** + * Encrypt / decrypt using the Output Feedback mode. + * + * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Output_feedback_.28OFB.29 + */ + const MODE_OFB = 4; + /** + * Encrypt / decrypt using streaming mode. + */ + const MODE_STREAM = 5; + /**#@-*/ + + /** + * Whirlpool available flag + * + * @see \phpseclib\Crypt\Base::_hashInlineCryptFunction() + * @var bool + * @access private + */ + static $WHIRLPOOL_AVAILABLE; + + /**#@+ + * @access private + * @see \phpseclib\Crypt\Base::__construct() + */ + /** + * Base value for the internal implementation $engine switch + */ + const ENGINE_INTERNAL = 1; + /** + * Base value for the mcrypt implementation $engine switch + */ + const ENGINE_MCRYPT = 2; + /** + * Base value for the mcrypt implementation $engine switch + */ + const ENGINE_OPENSSL = 3; + /**#@-*/ + + /** + * The Encryption Mode + * + * @see self::__construct() + * @var int + * @access private + */ + var $mode; + + /** + * The Block Length of the block cipher + * + * @var int + * @access private + */ + var $block_size = 16; + + /** + * The Key + * + * @see self::setKey() + * @var string + * @access private + */ + var $key = "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"; + + /** + * The Initialization Vector + * + * @see self::setIV() + * @var string + * @access private + */ + var $iv; + + /** + * A "sliding" Initialization Vector + * + * @see self::enableContinuousBuffer() + * @see self::_clearBuffers() + * @var string + * @access private + */ + var $encryptIV; + + /** + * A "sliding" Initialization Vector + * + * @see self::enableContinuousBuffer() + * @see self::_clearBuffers() + * @var string + * @access private + */ + var $decryptIV; + + /** + * Continuous Buffer status + * + * @see self::enableContinuousBuffer() + * @var bool + * @access private + */ + var $continuousBuffer = false; + + /** + * Encryption buffer for CTR, OFB and CFB modes + * + * @see self::encrypt() + * @see self::_clearBuffers() + * @var array + * @access private + */ + var $enbuffer; + + /** + * Decryption buffer for CTR, OFB and CFB modes + * + * @see self::decrypt() + * @see self::_clearBuffers() + * @var array + * @access private + */ + var $debuffer; + + /** + * mcrypt resource for encryption + * + * The mcrypt resource can be recreated every time something needs to be created or it can be created just once. + * Since mcrypt operates in continuous mode, by default, it'll need to be recreated when in non-continuous mode. + * + * @see self::encrypt() + * @var resource + * @access private + */ + var $enmcrypt; + + /** + * mcrypt resource for decryption + * + * The mcrypt resource can be recreated every time something needs to be created or it can be created just once. + * Since mcrypt operates in continuous mode, by default, it'll need to be recreated when in non-continuous mode. + * + * @see self::decrypt() + * @var resource + * @access private + */ + var $demcrypt; + + /** + * Does the enmcrypt resource need to be (re)initialized? + * + * @see \phpseclib\Crypt\Twofish::setKey() + * @see \phpseclib\Crypt\Twofish::setIV() + * @var bool + * @access private + */ + var $enchanged = true; + + /** + * Does the demcrypt resource need to be (re)initialized? + * + * @see \phpseclib\Crypt\Twofish::setKey() + * @see \phpseclib\Crypt\Twofish::setIV() + * @var bool + * @access private + */ + var $dechanged = true; + + /** + * mcrypt resource for CFB mode + * + * mcrypt's CFB mode, in (and only in) buffered context, + * is broken, so phpseclib implements the CFB mode by it self, + * even when the mcrypt php extension is available. + * + * In order to do the CFB-mode work (fast) phpseclib + * use a separate ECB-mode mcrypt resource. + * + * @link http://phpseclib.sourceforge.net/cfb-demo.phps + * @see self::encrypt() + * @see self::decrypt() + * @see self::_setupMcrypt() + * @var resource + * @access private + */ + var $ecb; + + /** + * Optimizing value while CFB-encrypting + * + * Only relevant if $continuousBuffer enabled + * and $engine == self::ENGINE_MCRYPT + * + * It's faster to re-init $enmcrypt if + * $buffer bytes > $cfb_init_len than + * using the $ecb resource furthermore. + * + * This value depends of the chosen cipher + * and the time it would be needed for it's + * initialization [by mcrypt_generic_init()] + * which, typically, depends on the complexity + * on its internaly Key-expanding algorithm. + * + * @see self::encrypt() + * @var int + * @access private + */ + var $cfb_init_len = 600; + + /** + * Does internal cipher state need to be (re)initialized? + * + * @see self::setKey() + * @see self::setIV() + * @see self::disableContinuousBuffer() + * @var bool + * @access private + */ + var $changed = true; + + /** + * Padding status + * + * @see self::enablePadding() + * @var bool + * @access private + */ + var $padding = true; + + /** + * Is the mode one that is paddable? + * + * @see self::__construct() + * @var bool + * @access private + */ + var $paddable = false; + + /** + * Holds which crypt engine internaly should be use, + * which will be determined automatically on __construct() + * + * Currently available $engines are: + * - self::ENGINE_OPENSSL (very fast, php-extension: openssl, extension_loaded('openssl') required) + * - self::ENGINE_MCRYPT (fast, php-extension: mcrypt, extension_loaded('mcrypt') required) + * - self::ENGINE_INTERNAL (slower, pure php-engine, no php-extension required) + * + * @see self::_setEngine() + * @see self::encrypt() + * @see self::decrypt() + * @var int + * @access private + */ + var $engine; + + /** + * Holds the preferred crypt engine + * + * @see self::_setEngine() + * @see self::setPreferredEngine() + * @var int + * @access private + */ + var $preferredEngine; + + /** + * The mcrypt specific name of the cipher + * + * Only used if $engine == self::ENGINE_MCRYPT + * + * @link http://www.php.net/mcrypt_module_open + * @link http://www.php.net/mcrypt_list_algorithms + * @see self::_setupMcrypt() + * @var string + * @access private + */ + var $cipher_name_mcrypt; + + /** + * The openssl specific name of the cipher + * + * Only used if $engine == self::ENGINE_OPENSSL + * + * @link http://www.php.net/openssl-get-cipher-methods + * @var string + * @access private + */ + var $cipher_name_openssl; + + /** + * The openssl specific name of the cipher in ECB mode + * + * If OpenSSL does not support the mode we're trying to use (CTR) + * it can still be emulated with ECB mode. + * + * @link http://www.php.net/openssl-get-cipher-methods + * @var string + * @access private + */ + var $cipher_name_openssl_ecb; + + /** + * The default salt used by setPassword() + * + * @see self::setPassword() + * @var string + * @access private + */ + var $password_default_salt = 'phpseclib/salt'; + + /** + * The name of the performance-optimized callback function + * + * Used by encrypt() / decrypt() + * only if $engine == self::ENGINE_INTERNAL + * + * @see self::encrypt() + * @see self::decrypt() + * @see self::_setupInlineCrypt() + * @see self::$use_inline_crypt + * @var Callback + * @access private + */ + var $inline_crypt; + + /** + * Holds whether performance-optimized $inline_crypt() can/should be used. + * + * @see self::encrypt() + * @see self::decrypt() + * @see self::inline_crypt + * @var mixed + * @access private + */ + var $use_inline_crypt; + + /** + * If OpenSSL can be used in ECB but not in CTR we can emulate CTR + * + * @see self::_openssl_ctr_process() + * @var bool + * @access private + */ + var $openssl_emulate_ctr = false; + + /** + * Determines what options are passed to openssl_encrypt/decrypt + * + * @see self::isValidEngine() + * @var mixed + * @access private + */ + var $openssl_options; + + /** + * Has the key length explicitly been set or should it be derived from the key, itself? + * + * @see self::setKeyLength() + * @var bool + * @access private + */ + var $explicit_key_length = false; + + /** + * Don't truncate / null pad key + * + * @see self::_clearBuffers() + * @var bool + * @access private + */ + var $skip_key_adjustment = false; + + /** + * Default Constructor. + * + * Determines whether or not the mcrypt extension should be used. + * + * $mode could be: + * + * - self::MODE_ECB + * + * - self::MODE_CBC + * + * - self::MODE_CTR + * + * - self::MODE_CFB + * + * - self::MODE_OFB + * + * If not explicitly set, self::MODE_CBC will be used. + * + * @param int $mode + * @access public + */ + function __construct($mode = self::MODE_CBC) + { + // $mode dependent settings + switch ($mode) { + case self::MODE_ECB: + $this->paddable = true; + $this->mode = self::MODE_ECB; + break; + case self::MODE_CTR: + case self::MODE_CFB: + case self::MODE_OFB: + case self::MODE_STREAM: + $this->mode = $mode; + break; + case self::MODE_CBC: + default: + $this->paddable = true; + $this->mode = self::MODE_CBC; + } + + $this->_setEngine(); + + // Determining whether inline crypting can be used by the cipher + if ($this->use_inline_crypt !== false) { + $this->use_inline_crypt = version_compare(PHP_VERSION, '5.3.0') >= 0 || function_exists('create_function'); + } + } + + /** + * Sets the initialization vector. (optional) + * + * SetIV is not required when self::MODE_ECB (or ie for AES: \phpseclib\Crypt\AES::MODE_ECB) is being used. If not explicitly set, it'll be assumed + * to be all zero's. + * + * @access public + * @param string $iv + * @internal Can be overwritten by a sub class, but does not have to be + */ + function setIV($iv) + { + if ($this->mode == self::MODE_ECB) { + return; + } + + $this->iv = $iv; + $this->changed = true; + } + + /** + * Sets the key length. + * + * Keys with explicitly set lengths need to be treated accordingly + * + * @access public + * @param int $length + */ + function setKeyLength($length) + { + $this->explicit_key_length = true; + $this->changed = true; + $this->_setEngine(); + } + + /** + * Returns the current key length in bits + * + * @access public + * @return int + */ + function getKeyLength() + { + return $this->key_length << 3; + } + + /** + * Returns the current block length in bits + * + * @access public + * @return int + */ + function getBlockLength() + { + return $this->block_size << 3; + } + + /** + * Sets the key. + * + * The min/max length(s) of the key depends on the cipher which is used. + * If the key not fits the length(s) of the cipher it will paded with null bytes + * up to the closest valid key length. If the key is more than max length, + * we trim the excess bits. + * + * If the key is not explicitly set, it'll be assumed to be all null bytes. + * + * @access public + * @param string $key + * @internal Could, but not must, extend by the child Crypt_* class + */ + function setKey($key) + { + if (!$this->explicit_key_length) { + $this->setKeyLength(strlen($key) << 3); + $this->explicit_key_length = false; + } + + $this->key = $key; + $this->changed = true; + $this->_setEngine(); + } + + /** + * Sets the password. + * + * Depending on what $method is set to, setPassword()'s (optional) parameters are as follows: + * {@link http://en.wikipedia.org/wiki/PBKDF2 pbkdf2} or pbkdf1: + * $hash, $salt, $count, $dkLen + * + * Where $hash (default = sha1) currently supports the following hashes: see: Crypt/Hash.php + * + * @see Crypt/Hash.php + * @param string $password + * @param string $method + * @return bool + * @access public + * @internal Could, but not must, extend by the child Crypt_* class + */ + function setPassword($password, $method = 'pbkdf2') + { + $key = ''; + + switch ($method) { + default: // 'pbkdf2' or 'pbkdf1' + $func_args = func_get_args(); + + // Hash function + $hash = isset($func_args[2]) ? $func_args[2] : 'sha1'; + + // WPA and WPA2 use the SSID as the salt + $salt = isset($func_args[3]) ? $func_args[3] : $this->password_default_salt; + + // RFC2898#section-4.2 uses 1,000 iterations by default + // WPA and WPA2 use 4,096. + $count = isset($func_args[4]) ? $func_args[4] : 1000; + + // Keylength + if (isset($func_args[5])) { + $dkLen = $func_args[5]; + } else { + $dkLen = $method == 'pbkdf1' ? 2 * $this->key_length : $this->key_length; + } + + switch (true) { + case $method == 'pbkdf1': + $hashObj = new Hash(); + $hashObj->setHash($hash); + if ($dkLen > $hashObj->getLength()) { + user_error('Derived key too long'); + return false; + } + $t = $password . $salt; + for ($i = 0; $i < $count; ++$i) { + $t = $hashObj->hash($t); + } + $key = substr($t, 0, $dkLen); + + $this->setKey(substr($key, 0, $dkLen >> 1)); + $this->setIV(substr($key, $dkLen >> 1)); + + return true; + // Determining if php[>=5.5.0]'s hash_pbkdf2() function avail- and useable + case !function_exists('hash_pbkdf2'): + case !function_exists('hash_algos'): + case !in_array($hash, hash_algos()): + $i = 1; + while (strlen($key) < $dkLen) { + $hmac = new Hash(); + $hmac->setHash($hash); + $hmac->setKey($password); + $f = $u = $hmac->hash($salt . pack('N', $i++)); + for ($j = 2; $j <= $count; ++$j) { + $u = $hmac->hash($u); + $f^= $u; + } + $key.= $f; + } + $key = substr($key, 0, $dkLen); + break; + default: + $key = hash_pbkdf2($hash, $password, $salt, $count, $dkLen, true); + } + } + + $this->setKey($key); + + return true; + } + + /** + * Encrypts a message. + * + * $plaintext will be padded with additional bytes such that it's length is a multiple of the block size. Other cipher + * implementations may or may not pad in the same manner. Other common approaches to padding and the reasons why it's + * necessary are discussed in the following + * URL: + * + * {@link http://www.di-mgt.com.au/cryptopad.html http://www.di-mgt.com.au/cryptopad.html} + * + * An alternative to padding is to, separately, send the length of the file. This is what SSH, in fact, does. + * strlen($plaintext) will still need to be a multiple of the block size, however, arbitrary values can be added to make it that + * length. + * + * @see self::decrypt() + * @access public + * @param string $plaintext + * @return string $ciphertext + * @internal Could, but not must, extend by the child Crypt_* class + */ + function encrypt($plaintext) + { + if ($this->paddable) { + $plaintext = $this->_pad($plaintext); + } + + if ($this->engine === self::ENGINE_OPENSSL) { + if ($this->changed) { + $this->_clearBuffers(); + $this->changed = false; + } + switch ($this->mode) { + case self::MODE_STREAM: + return openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, $this->openssl_options); + case self::MODE_ECB: + $result = openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, $this->openssl_options); + return !defined('OPENSSL_RAW_DATA') ? substr($result, 0, -$this->block_size) : $result; + case self::MODE_CBC: + $result = openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, $this->openssl_options, $this->encryptIV); + if (!defined('OPENSSL_RAW_DATA')) { + $result = substr($result, 0, -$this->block_size); + } + if ($this->continuousBuffer) { + $this->encryptIV = substr($result, -$this->block_size); + } + return $result; + case self::MODE_CTR: + return $this->_openssl_ctr_process($plaintext, $this->encryptIV, $this->enbuffer); + case self::MODE_CFB: + // cfb loosely routines inspired by openssl's: + // {@link http://cvs.openssl.org/fileview?f=openssl/crypto/modes/cfb128.c&v=1.3.2.2.2.1} + $ciphertext = ''; + if ($this->continuousBuffer) { + $iv = &$this->encryptIV; + $pos = &$this->enbuffer['pos']; + } else { + $iv = $this->encryptIV; + $pos = 0; + } + $len = strlen($plaintext); + $i = 0; + if ($pos) { + $orig_pos = $pos; + $max = $this->block_size - $pos; + if ($len >= $max) { + $i = $max; + $len-= $max; + $pos = 0; + } else { + $i = $len; + $pos+= $len; + $len = 0; + } + // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $blocksize + $ciphertext = substr($iv, $orig_pos) ^ $plaintext; + $iv = substr_replace($iv, $ciphertext, $orig_pos, $i); + $plaintext = substr($plaintext, $i); + } + + $overflow = $len % $this->block_size; + + if ($overflow) { + $ciphertext.= openssl_encrypt(substr($plaintext, 0, -$overflow) . str_repeat("\0", $this->block_size), $this->cipher_name_openssl, $this->key, $this->openssl_options, $iv); + $iv = $this->_string_pop($ciphertext, $this->block_size); + + $size = $len - $overflow; + $block = $iv ^ substr($plaintext, -$overflow); + $iv = substr_replace($iv, $block, 0, $overflow); + $ciphertext.= $block; + $pos = $overflow; + } elseif ($len) { + $ciphertext = openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, $this->openssl_options, $iv); + $iv = substr($ciphertext, -$this->block_size); + } + + return $ciphertext; + case self::MODE_OFB: + return $this->_openssl_ofb_process($plaintext, $this->encryptIV, $this->enbuffer); + } + } + + if ($this->engine === self::ENGINE_MCRYPT) { + if ($this->changed) { + $this->_setupMcrypt(); + $this->changed = false; + } + if ($this->enchanged) { + @mcrypt_generic_init($this->enmcrypt, $this->key, $this->encryptIV); + $this->enchanged = false; + } + + // re: {@link http://phpseclib.sourceforge.net/cfb-demo.phps} + // using mcrypt's default handing of CFB the above would output two different things. using phpseclib's + // rewritten CFB implementation the above outputs the same thing twice. + if ($this->mode == self::MODE_CFB && $this->continuousBuffer) { + $block_size = $this->block_size; + $iv = &$this->encryptIV; + $pos = &$this->enbuffer['pos']; + $len = strlen($plaintext); + $ciphertext = ''; + $i = 0; + if ($pos) { + $orig_pos = $pos; + $max = $block_size - $pos; + if ($len >= $max) { + $i = $max; + $len-= $max; + $pos = 0; + } else { + $i = $len; + $pos+= $len; + $len = 0; + } + $ciphertext = substr($iv, $orig_pos) ^ $plaintext; + $iv = substr_replace($iv, $ciphertext, $orig_pos, $i); + $this->enbuffer['enmcrypt_init'] = true; + } + if ($len >= $block_size) { + if ($this->enbuffer['enmcrypt_init'] === false || $len > $this->cfb_init_len) { + if ($this->enbuffer['enmcrypt_init'] === true) { + @mcrypt_generic_init($this->enmcrypt, $this->key, $iv); + $this->enbuffer['enmcrypt_init'] = false; + } + $ciphertext.= @mcrypt_generic($this->enmcrypt, substr($plaintext, $i, $len - $len % $block_size)); + $iv = substr($ciphertext, -$block_size); + $len%= $block_size; + } else { + while ($len >= $block_size) { + $iv = @mcrypt_generic($this->ecb, $iv) ^ substr($plaintext, $i, $block_size); + $ciphertext.= $iv; + $len-= $block_size; + $i+= $block_size; + } + } + } + + if ($len) { + $iv = @mcrypt_generic($this->ecb, $iv); + $block = $iv ^ substr($plaintext, -$len); + $iv = substr_replace($iv, $block, 0, $len); + $ciphertext.= $block; + $pos = $len; + } + + return $ciphertext; + } + + $ciphertext = @mcrypt_generic($this->enmcrypt, $plaintext); + + if (!$this->continuousBuffer) { + @mcrypt_generic_init($this->enmcrypt, $this->key, $this->encryptIV); + } + + return $ciphertext; + } + + if ($this->changed) { + $this->_setup(); + $this->changed = false; + } + if ($this->use_inline_crypt) { + $inline = $this->inline_crypt; + return $inline('encrypt', $this, $plaintext); + } + + $buffer = &$this->enbuffer; + $block_size = $this->block_size; + $ciphertext = ''; + switch ($this->mode) { + case self::MODE_ECB: + for ($i = 0; $i < strlen($plaintext); $i+=$block_size) { + $ciphertext.= $this->_encryptBlock(substr($plaintext, $i, $block_size)); + } + break; + case self::MODE_CBC: + $xor = $this->encryptIV; + for ($i = 0; $i < strlen($plaintext); $i+=$block_size) { + $block = substr($plaintext, $i, $block_size); + $block = $this->_encryptBlock($block ^ $xor); + $xor = $block; + $ciphertext.= $block; + } + if ($this->continuousBuffer) { + $this->encryptIV = $xor; + } + break; + case self::MODE_CTR: + $xor = $this->encryptIV; + if (strlen($buffer['ciphertext'])) { + for ($i = 0; $i < strlen($plaintext); $i+=$block_size) { + $block = substr($plaintext, $i, $block_size); + if (strlen($block) > strlen($buffer['ciphertext'])) { + $buffer['ciphertext'].= $this->_encryptBlock($xor); + } + $this->_increment_str($xor); + $key = $this->_string_shift($buffer['ciphertext'], $block_size); + $ciphertext.= $block ^ $key; + } + } else { + for ($i = 0; $i < strlen($plaintext); $i+=$block_size) { + $block = substr($plaintext, $i, $block_size); + $key = $this->_encryptBlock($xor); + $this->_increment_str($xor); + $ciphertext.= $block ^ $key; + } + } + if ($this->continuousBuffer) { + $this->encryptIV = $xor; + if ($start = strlen($plaintext) % $block_size) { + $buffer['ciphertext'] = substr($key, $start) . $buffer['ciphertext']; + } + } + break; + case self::MODE_CFB: + // cfb loosely routines inspired by openssl's: + // {@link http://cvs.openssl.org/fileview?f=openssl/crypto/modes/cfb128.c&v=1.3.2.2.2.1} + if ($this->continuousBuffer) { + $iv = &$this->encryptIV; + $pos = &$buffer['pos']; + } else { + $iv = $this->encryptIV; + $pos = 0; + } + $len = strlen($plaintext); + $i = 0; + if ($pos) { + $orig_pos = $pos; + $max = $block_size - $pos; + if ($len >= $max) { + $i = $max; + $len-= $max; + $pos = 0; + } else { + $i = $len; + $pos+= $len; + $len = 0; + } + // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $blocksize + $ciphertext = substr($iv, $orig_pos) ^ $plaintext; + $iv = substr_replace($iv, $ciphertext, $orig_pos, $i); + } + while ($len >= $block_size) { + $iv = $this->_encryptBlock($iv) ^ substr($plaintext, $i, $block_size); + $ciphertext.= $iv; + $len-= $block_size; + $i+= $block_size; + } + if ($len) { + $iv = $this->_encryptBlock($iv); + $block = $iv ^ substr($plaintext, $i); + $iv = substr_replace($iv, $block, 0, $len); + $ciphertext.= $block; + $pos = $len; + } + break; + case self::MODE_OFB: + $xor = $this->encryptIV; + if (strlen($buffer['xor'])) { + for ($i = 0; $i < strlen($plaintext); $i+=$block_size) { + $block = substr($plaintext, $i, $block_size); + if (strlen($block) > strlen($buffer['xor'])) { + $xor = $this->_encryptBlock($xor); + $buffer['xor'].= $xor; + } + $key = $this->_string_shift($buffer['xor'], $block_size); + $ciphertext.= $block ^ $key; + } + } else { + for ($i = 0; $i < strlen($plaintext); $i+=$block_size) { + $xor = $this->_encryptBlock($xor); + $ciphertext.= substr($plaintext, $i, $block_size) ^ $xor; + } + $key = $xor; + } + if ($this->continuousBuffer) { + $this->encryptIV = $xor; + if ($start = strlen($plaintext) % $block_size) { + $buffer['xor'] = substr($key, $start) . $buffer['xor']; + } + } + break; + case self::MODE_STREAM: + $ciphertext = $this->_encryptBlock($plaintext); + break; + } + + return $ciphertext; + } + + /** + * Decrypts a message. + * + * If strlen($ciphertext) is not a multiple of the block size, null bytes will be added to the end of the string until + * it is. + * + * @see self::encrypt() + * @access public + * @param string $ciphertext + * @return string $plaintext + * @internal Could, but not must, extend by the child Crypt_* class + */ + function decrypt($ciphertext) + { + if ($this->paddable) { + // we pad with chr(0) since that's what mcrypt_generic does. to quote from {@link http://www.php.net/function.mcrypt-generic}: + // "The data is padded with "\0" to make sure the length of the data is n * blocksize." + $ciphertext = str_pad($ciphertext, strlen($ciphertext) + ($this->block_size - strlen($ciphertext) % $this->block_size) % $this->block_size, chr(0)); + } + + if ($this->engine === self::ENGINE_OPENSSL) { + if ($this->changed) { + $this->_clearBuffers(); + $this->changed = false; + } + switch ($this->mode) { + case self::MODE_STREAM: + $plaintext = openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, $this->openssl_options); + break; + case self::MODE_ECB: + if (!defined('OPENSSL_RAW_DATA')) { + $ciphertext.= openssl_encrypt('', $this->cipher_name_openssl_ecb, $this->key, true); + } + $plaintext = openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, $this->openssl_options); + break; + case self::MODE_CBC: + if (!defined('OPENSSL_RAW_DATA')) { + $padding = str_repeat(chr($this->block_size), $this->block_size) ^ substr($ciphertext, -$this->block_size); + $ciphertext.= substr(openssl_encrypt($padding, $this->cipher_name_openssl_ecb, $this->key, true), 0, $this->block_size); + $offset = 2 * $this->block_size; + } else { + $offset = $this->block_size; + } + $plaintext = openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, $this->openssl_options, $this->decryptIV); + if ($this->continuousBuffer) { + $this->decryptIV = substr($ciphertext, -$offset, $this->block_size); + } + break; + case self::MODE_CTR: + $plaintext = $this->_openssl_ctr_process($ciphertext, $this->decryptIV, $this->debuffer); + break; + case self::MODE_CFB: + // cfb loosely routines inspired by openssl's: + // {@link http://cvs.openssl.org/fileview?f=openssl/crypto/modes/cfb128.c&v=1.3.2.2.2.1} + $plaintext = ''; + if ($this->continuousBuffer) { + $iv = &$this->decryptIV; + $pos = &$this->buffer['pos']; + } else { + $iv = $this->decryptIV; + $pos = 0; + } + $len = strlen($ciphertext); + $i = 0; + if ($pos) { + $orig_pos = $pos; + $max = $this->block_size - $pos; + if ($len >= $max) { + $i = $max; + $len-= $max; + $pos = 0; + } else { + $i = $len; + $pos+= $len; + $len = 0; + } + // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $this->blocksize + $plaintext = substr($iv, $orig_pos) ^ $ciphertext; + $iv = substr_replace($iv, substr($ciphertext, 0, $i), $orig_pos, $i); + $ciphertext = substr($ciphertext, $i); + } + $overflow = $len % $this->block_size; + if ($overflow) { + $plaintext.= openssl_decrypt(substr($ciphertext, 0, -$overflow), $this->cipher_name_openssl, $this->key, $this->openssl_options, $iv); + if ($len - $overflow) { + $iv = substr($ciphertext, -$overflow - $this->block_size, -$overflow); + } + $iv = openssl_encrypt(str_repeat("\0", $this->block_size), $this->cipher_name_openssl, $this->key, $this->openssl_options, $iv); + $plaintext.= $iv ^ substr($ciphertext, -$overflow); + $iv = substr_replace($iv, substr($ciphertext, -$overflow), 0, $overflow); + $pos = $overflow; + } elseif ($len) { + $plaintext.= openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, $this->openssl_options, $iv); + $iv = substr($ciphertext, -$this->block_size); + } + break; + case self::MODE_OFB: + $plaintext = $this->_openssl_ofb_process($ciphertext, $this->decryptIV, $this->debuffer); + } + + return $this->paddable ? $this->_unpad($plaintext) : $plaintext; + } + + if ($this->engine === self::ENGINE_MCRYPT) { + $block_size = $this->block_size; + if ($this->changed) { + $this->_setupMcrypt(); + $this->changed = false; + } + if ($this->dechanged) { + @mcrypt_generic_init($this->demcrypt, $this->key, $this->decryptIV); + $this->dechanged = false; + } + + if ($this->mode == self::MODE_CFB && $this->continuousBuffer) { + $iv = &$this->decryptIV; + $pos = &$this->debuffer['pos']; + $len = strlen($ciphertext); + $plaintext = ''; + $i = 0; + if ($pos) { + $orig_pos = $pos; + $max = $block_size - $pos; + if ($len >= $max) { + $i = $max; + $len-= $max; + $pos = 0; + } else { + $i = $len; + $pos+= $len; + $len = 0; + } + // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $blocksize + $plaintext = substr($iv, $orig_pos) ^ $ciphertext; + $iv = substr_replace($iv, substr($ciphertext, 0, $i), $orig_pos, $i); + } + if ($len >= $block_size) { + $cb = substr($ciphertext, $i, $len - $len % $block_size); + $plaintext.= @mcrypt_generic($this->ecb, $iv . $cb) ^ $cb; + $iv = substr($cb, -$block_size); + $len%= $block_size; + } + if ($len) { + $iv = @mcrypt_generic($this->ecb, $iv); + $plaintext.= $iv ^ substr($ciphertext, -$len); + $iv = substr_replace($iv, substr($ciphertext, -$len), 0, $len); + $pos = $len; + } + + return $plaintext; + } + + $plaintext = @mdecrypt_generic($this->demcrypt, $ciphertext); + + if (!$this->continuousBuffer) { + @mcrypt_generic_init($this->demcrypt, $this->key, $this->decryptIV); + } + + return $this->paddable ? $this->_unpad($plaintext) : $plaintext; + } + + if ($this->changed) { + $this->_setup(); + $this->changed = false; + } + if ($this->use_inline_crypt) { + $inline = $this->inline_crypt; + return $inline('decrypt', $this, $ciphertext); + } + + $block_size = $this->block_size; + + $buffer = &$this->debuffer; + $plaintext = ''; + switch ($this->mode) { + case self::MODE_ECB: + for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) { + $plaintext.= $this->_decryptBlock(substr($ciphertext, $i, $block_size)); + } + break; + case self::MODE_CBC: + $xor = $this->decryptIV; + for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) { + $block = substr($ciphertext, $i, $block_size); + $plaintext.= $this->_decryptBlock($block) ^ $xor; + $xor = $block; + } + if ($this->continuousBuffer) { + $this->decryptIV = $xor; + } + break; + case self::MODE_CTR: + $xor = $this->decryptIV; + if (strlen($buffer['ciphertext'])) { + for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) { + $block = substr($ciphertext, $i, $block_size); + if (strlen($block) > strlen($buffer['ciphertext'])) { + $buffer['ciphertext'].= $this->_encryptBlock($xor); + $this->_increment_str($xor); + } + $key = $this->_string_shift($buffer['ciphertext'], $block_size); + $plaintext.= $block ^ $key; + } + } else { + for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) { + $block = substr($ciphertext, $i, $block_size); + $key = $this->_encryptBlock($xor); + $this->_increment_str($xor); + $plaintext.= $block ^ $key; + } + } + if ($this->continuousBuffer) { + $this->decryptIV = $xor; + if ($start = strlen($ciphertext) % $block_size) { + $buffer['ciphertext'] = substr($key, $start) . $buffer['ciphertext']; + } + } + break; + case self::MODE_CFB: + if ($this->continuousBuffer) { + $iv = &$this->decryptIV; + $pos = &$buffer['pos']; + } else { + $iv = $this->decryptIV; + $pos = 0; + } + $len = strlen($ciphertext); + $i = 0; + if ($pos) { + $orig_pos = $pos; + $max = $block_size - $pos; + if ($len >= $max) { + $i = $max; + $len-= $max; + $pos = 0; + } else { + $i = $len; + $pos+= $len; + $len = 0; + } + // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $blocksize + $plaintext = substr($iv, $orig_pos) ^ $ciphertext; + $iv = substr_replace($iv, substr($ciphertext, 0, $i), $orig_pos, $i); + } + while ($len >= $block_size) { + $iv = $this->_encryptBlock($iv); + $cb = substr($ciphertext, $i, $block_size); + $plaintext.= $iv ^ $cb; + $iv = $cb; + $len-= $block_size; + $i+= $block_size; + } + if ($len) { + $iv = $this->_encryptBlock($iv); + $plaintext.= $iv ^ substr($ciphertext, $i); + $iv = substr_replace($iv, substr($ciphertext, $i), 0, $len); + $pos = $len; + } + break; + case self::MODE_OFB: + $xor = $this->decryptIV; + if (strlen($buffer['xor'])) { + for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) { + $block = substr($ciphertext, $i, $block_size); + if (strlen($block) > strlen($buffer['xor'])) { + $xor = $this->_encryptBlock($xor); + $buffer['xor'].= $xor; + } + $key = $this->_string_shift($buffer['xor'], $block_size); + $plaintext.= $block ^ $key; + } + } else { + for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) { + $xor = $this->_encryptBlock($xor); + $plaintext.= substr($ciphertext, $i, $block_size) ^ $xor; + } + $key = $xor; + } + if ($this->continuousBuffer) { + $this->decryptIV = $xor; + if ($start = strlen($ciphertext) % $block_size) { + $buffer['xor'] = substr($key, $start) . $buffer['xor']; + } + } + break; + case self::MODE_STREAM: + $plaintext = $this->_decryptBlock($ciphertext); + break; + } + return $this->paddable ? $this->_unpad($plaintext) : $plaintext; + } + + /** + * OpenSSL CTR Processor + * + * PHP's OpenSSL bindings do not operate in continuous mode so we'll wrap around it. Since the keystream + * for CTR is the same for both encrypting and decrypting this function is re-used by both Base::encrypt() + * and Base::decrypt(). Also, OpenSSL doesn't implement CTR for all of it's symmetric ciphers so this + * function will emulate CTR with ECB when necessary. + * + * @see self::encrypt() + * @see self::decrypt() + * @param string $plaintext + * @param string $encryptIV + * @param array $buffer + * @return string + * @access private + */ + function _openssl_ctr_process($plaintext, &$encryptIV, &$buffer) + { + $ciphertext = ''; + + $block_size = $this->block_size; + $key = $this->key; + + if ($this->openssl_emulate_ctr) { + $xor = $encryptIV; + if (strlen($buffer['ciphertext'])) { + for ($i = 0; $i < strlen($plaintext); $i+=$block_size) { + $block = substr($plaintext, $i, $block_size); + if (strlen($block) > strlen($buffer['ciphertext'])) { + $result = openssl_encrypt($xor, $this->cipher_name_openssl_ecb, $key, $this->openssl_options); + $result = !defined('OPENSSL_RAW_DATA') ? substr($result, 0, -$this->block_size) : $result; + $buffer['ciphertext'].= $result; + } + $this->_increment_str($xor); + $otp = $this->_string_shift($buffer['ciphertext'], $block_size); + $ciphertext.= $block ^ $otp; + } + } else { + for ($i = 0; $i < strlen($plaintext); $i+=$block_size) { + $block = substr($plaintext, $i, $block_size); + $otp = openssl_encrypt($xor, $this->cipher_name_openssl_ecb, $key, $this->openssl_options); + $otp = !defined('OPENSSL_RAW_DATA') ? substr($otp, 0, -$this->block_size) : $otp; + $this->_increment_str($xor); + $ciphertext.= $block ^ $otp; + } + } + if ($this->continuousBuffer) { + $encryptIV = $xor; + if ($start = strlen($plaintext) % $block_size) { + $buffer['ciphertext'] = substr($key, $start) . $buffer['ciphertext']; + } + } + + return $ciphertext; + } + + if (strlen($buffer['ciphertext'])) { + $ciphertext = $plaintext ^ $this->_string_shift($buffer['ciphertext'], strlen($plaintext)); + $plaintext = substr($plaintext, strlen($ciphertext)); + + if (!strlen($plaintext)) { + return $ciphertext; + } + } + + $overflow = strlen($plaintext) % $block_size; + if ($overflow) { + $plaintext2 = $this->_string_pop($plaintext, $overflow); // ie. trim $plaintext to a multiple of $block_size and put rest of $plaintext in $plaintext2 + $encrypted = openssl_encrypt($plaintext . str_repeat("\0", $block_size), $this->cipher_name_openssl, $key, $this->openssl_options, $encryptIV); + $temp = $this->_string_pop($encrypted, $block_size); + $ciphertext.= $encrypted . ($plaintext2 ^ $temp); + if ($this->continuousBuffer) { + $buffer['ciphertext'] = substr($temp, $overflow); + $encryptIV = $temp; + } + } elseif (!strlen($buffer['ciphertext'])) { + $ciphertext.= openssl_encrypt($plaintext . str_repeat("\0", $block_size), $this->cipher_name_openssl, $key, $this->openssl_options, $encryptIV); + $temp = $this->_string_pop($ciphertext, $block_size); + if ($this->continuousBuffer) { + $encryptIV = $temp; + } + } + if ($this->continuousBuffer) { + if (!defined('OPENSSL_RAW_DATA')) { + $encryptIV.= openssl_encrypt('', $this->cipher_name_openssl_ecb, $key, $this->openssl_options); + } + $encryptIV = openssl_decrypt($encryptIV, $this->cipher_name_openssl_ecb, $key, $this->openssl_options); + if ($overflow) { + $this->_increment_str($encryptIV); + } + } + + return $ciphertext; + } + + /** + * OpenSSL OFB Processor + * + * PHP's OpenSSL bindings do not operate in continuous mode so we'll wrap around it. Since the keystream + * for OFB is the same for both encrypting and decrypting this function is re-used by both Base::encrypt() + * and Base::decrypt(). + * + * @see self::encrypt() + * @see self::decrypt() + * @param string $plaintext + * @param string $encryptIV + * @param array $buffer + * @return string + * @access private + */ + function _openssl_ofb_process($plaintext, &$encryptIV, &$buffer) + { + if (strlen($buffer['xor'])) { + $ciphertext = $plaintext ^ $buffer['xor']; + $buffer['xor'] = substr($buffer['xor'], strlen($ciphertext)); + $plaintext = substr($plaintext, strlen($ciphertext)); + } else { + $ciphertext = ''; + } + + $block_size = $this->block_size; + + $len = strlen($plaintext); + $key = $this->key; + $overflow = $len % $block_size; + + if (strlen($plaintext)) { + if ($overflow) { + $ciphertext.= openssl_encrypt(substr($plaintext, 0, -$overflow) . str_repeat("\0", $block_size), $this->cipher_name_openssl, $key, $this->openssl_options, $encryptIV); + $xor = $this->_string_pop($ciphertext, $block_size); + if ($this->continuousBuffer) { + $encryptIV = $xor; + } + $ciphertext.= $this->_string_shift($xor, $overflow) ^ substr($plaintext, -$overflow); + if ($this->continuousBuffer) { + $buffer['xor'] = $xor; + } + } else { + $ciphertext = openssl_encrypt($plaintext, $this->cipher_name_openssl, $key, $this->openssl_options, $encryptIV); + if ($this->continuousBuffer) { + $encryptIV = substr($ciphertext, -$block_size) ^ substr($plaintext, -$block_size); + } + } + } + + return $ciphertext; + } + + /** + * phpseclib <-> OpenSSL Mode Mapper + * + * May need to be overwritten by classes extending this one in some cases + * + * @return int + * @access private + */ + function _openssl_translate_mode() + { + switch ($this->mode) { + case self::MODE_ECB: + return 'ecb'; + case self::MODE_CBC: + return 'cbc'; + case self::MODE_CTR: + return 'ctr'; + case self::MODE_CFB: + return 'cfb'; + case self::MODE_OFB: + return 'ofb'; + } + } + + /** + * Pad "packets". + * + * Block ciphers working by encrypting between their specified [$this->]block_size at a time + * If you ever need to encrypt or decrypt something that isn't of the proper length, it becomes necessary to + * pad the input so that it is of the proper length. + * + * Padding is enabled by default. Sometimes, however, it is undesirable to pad strings. Such is the case in SSH, + * where "packets" are padded with random bytes before being encrypted. Unpad these packets and you risk stripping + * away characters that shouldn't be stripped away. (SSH knows how many bytes are added because the length is + * transmitted separately) + * + * @see self::disablePadding() + * @access public + */ + function enablePadding() + { + $this->padding = true; + } + + /** + * Do not pad packets. + * + * @see self::enablePadding() + * @access public + */ + function disablePadding() + { + $this->padding = false; + } + + /** + * Treat consecutive "packets" as if they are a continuous buffer. + * + * Say you have a 32-byte plaintext $plaintext. Using the default behavior, the two following code snippets + * will yield different outputs: + * + * + * echo $rijndael->encrypt(substr($plaintext, 0, 16)); + * echo $rijndael->encrypt(substr($plaintext, 16, 16)); + * + * + * echo $rijndael->encrypt($plaintext); + * + * + * The solution is to enable the continuous buffer. Although this will resolve the above discrepancy, it creates + * another, as demonstrated with the following: + * + * + * $rijndael->encrypt(substr($plaintext, 0, 16)); + * echo $rijndael->decrypt($rijndael->encrypt(substr($plaintext, 16, 16))); + * + * + * echo $rijndael->decrypt($rijndael->encrypt(substr($plaintext, 16, 16))); + * + * + * With the continuous buffer disabled, these would yield the same output. With it enabled, they yield different + * outputs. The reason is due to the fact that the initialization vector's change after every encryption / + * decryption round when the continuous buffer is enabled. When it's disabled, they remain constant. + * + * Put another way, when the continuous buffer is enabled, the state of the \phpseclib\Crypt\*() object changes after each + * encryption / decryption round, whereas otherwise, it'd remain constant. For this reason, it's recommended that + * continuous buffers not be used. They do offer better security and are, in fact, sometimes required (SSH uses them), + * however, they are also less intuitive and more likely to cause you problems. + * + * @see self::disableContinuousBuffer() + * @access public + * @internal Could, but not must, extend by the child Crypt_* class + */ + function enableContinuousBuffer() + { + if ($this->mode == self::MODE_ECB) { + return; + } + + $this->continuousBuffer = true; + + $this->_setEngine(); + } + + /** + * Treat consecutive packets as if they are a discontinuous buffer. + * + * The default behavior. + * + * @see self::enableContinuousBuffer() + * @access public + * @internal Could, but not must, extend by the child Crypt_* class + */ + function disableContinuousBuffer() + { + if ($this->mode == self::MODE_ECB) { + return; + } + if (!$this->continuousBuffer) { + return; + } + + $this->continuousBuffer = false; + $this->changed = true; + + $this->_setEngine(); + } + + /** + * Test for engine validity + * + * @see self::__construct() + * @param int $engine + * @access public + * @return bool + */ + function isValidEngine($engine) + { + switch ($engine) { + case self::ENGINE_OPENSSL: + if ($this->mode == self::MODE_STREAM && $this->continuousBuffer) { + return false; + } + $this->openssl_emulate_ctr = false; + $result = $this->cipher_name_openssl && + extension_loaded('openssl') && + // PHP 5.3.0 - 5.3.2 did not let you set IV's + version_compare(PHP_VERSION, '5.3.3', '>='); + if (!$result) { + return false; + } + + // prior to PHP 5.4.0 OPENSSL_RAW_DATA and OPENSSL_ZERO_PADDING were not defined. instead of expecting an integer + // $options openssl_encrypt expected a boolean $raw_data. + if (!defined('OPENSSL_RAW_DATA')) { + $this->openssl_options = true; + } else { + $this->openssl_options = OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING; + } + + $methods = openssl_get_cipher_methods(); + if (in_array($this->cipher_name_openssl, $methods)) { + return true; + } + // not all of openssl's symmetric cipher's support ctr. for those + // that don't we'll emulate it + switch ($this->mode) { + case self::MODE_CTR: + if (in_array($this->cipher_name_openssl_ecb, $methods)) { + $this->openssl_emulate_ctr = true; + return true; + } + } + return false; + case self::ENGINE_MCRYPT: + return $this->cipher_name_mcrypt && + extension_loaded('mcrypt') && + in_array($this->cipher_name_mcrypt, @mcrypt_list_algorithms()); + case self::ENGINE_INTERNAL: + return true; + } + + return false; + } + + /** + * Sets the preferred crypt engine + * + * Currently, $engine could be: + * + * - \phpseclib\Crypt\Base::ENGINE_OPENSSL [very fast] + * + * - \phpseclib\Crypt\Base::ENGINE_MCRYPT [fast] + * + * - \phpseclib\Crypt\Base::ENGINE_INTERNAL [slow] + * + * If the preferred crypt engine is not available the fastest available one will be used + * + * @see self::__construct() + * @param int $engine + * @access public + */ + function setPreferredEngine($engine) + { + switch ($engine) { + //case self::ENGINE_OPENSSL; + case self::ENGINE_MCRYPT: + case self::ENGINE_INTERNAL: + $this->preferredEngine = $engine; + break; + default: + $this->preferredEngine = self::ENGINE_OPENSSL; + } + + $this->_setEngine(); + } + + /** + * Returns the engine currently being utilized + * + * @see self::_setEngine() + * @access public + */ + function getEngine() + { + return $this->engine; + } + + /** + * Sets the engine as appropriate + * + * @see self::__construct() + * @access private + */ + function _setEngine() + { + $this->engine = null; + + $candidateEngines = array( + $this->preferredEngine, + self::ENGINE_OPENSSL, + self::ENGINE_MCRYPT + ); + foreach ($candidateEngines as $engine) { + if ($this->isValidEngine($engine)) { + $this->engine = $engine; + break; + } + } + if (!$this->engine) { + $this->engine = self::ENGINE_INTERNAL; + } + + if ($this->engine != self::ENGINE_MCRYPT && $this->enmcrypt) { + // Closing the current mcrypt resource(s). _mcryptSetup() will, if needed, + // (re)open them with the module named in $this->cipher_name_mcrypt + @mcrypt_module_close($this->enmcrypt); + @mcrypt_module_close($this->demcrypt); + $this->enmcrypt = null; + $this->demcrypt = null; + + if ($this->ecb) { + @mcrypt_module_close($this->ecb); + $this->ecb = null; + } + } + + $this->changed = true; + } + + /** + * Encrypts a block + * + * Note: Must be extended by the child \phpseclib\Crypt\* class + * + * @access private + * @param string $in + * @return string + */ + abstract function _encryptBlock($in); + + /** + * Decrypts a block + * + * Note: Must be extended by the child \phpseclib\Crypt\* class + * + * @access private + * @param string $in + * @return string + */ + abstract function _decryptBlock($in); + + /** + * Setup the key (expansion) + * + * Only used if $engine == self::ENGINE_INTERNAL + * + * Note: Must extend by the child \phpseclib\Crypt\* class + * + * @see self::_setup() + * @access private + */ + abstract function _setupKey(); + + /** + * Setup the self::ENGINE_INTERNAL $engine + * + * (re)init, if necessary, the internal cipher $engine and flush all $buffers + * Used (only) if $engine == self::ENGINE_INTERNAL + * + * _setup() will be called each time if $changed === true + * typically this happens when using one or more of following public methods: + * + * - setKey() + * + * - setIV() + * + * - disableContinuousBuffer() + * + * - First run of encrypt() / decrypt() with no init-settings + * + * @see self::setKey() + * @see self::setIV() + * @see self::disableContinuousBuffer() + * @access private + * @internal _setup() is always called before en/decryption. + * @internal Could, but not must, extend by the child Crypt_* class + */ + function _setup() + { + $this->_clearBuffers(); + $this->_setupKey(); + + if ($this->use_inline_crypt) { + $this->_setupInlineCrypt(); + } + } + + /** + * Setup the self::ENGINE_MCRYPT $engine + * + * (re)init, if necessary, the (ext)mcrypt resources and flush all $buffers + * Used (only) if $engine = self::ENGINE_MCRYPT + * + * _setupMcrypt() will be called each time if $changed === true + * typically this happens when using one or more of following public methods: + * + * - setKey() + * + * - setIV() + * + * - disableContinuousBuffer() + * + * - First run of encrypt() / decrypt() + * + * @see self::setKey() + * @see self::setIV() + * @see self::disableContinuousBuffer() + * @access private + * @internal Could, but not must, extend by the child Crypt_* class + */ + function _setupMcrypt() + { + $this->_clearBuffers(); + $this->enchanged = $this->dechanged = true; + + if (!isset($this->enmcrypt)) { + static $mcrypt_modes = array( + self::MODE_CTR => 'ctr', + self::MODE_ECB => MCRYPT_MODE_ECB, + self::MODE_CBC => MCRYPT_MODE_CBC, + self::MODE_CFB => 'ncfb', + self::MODE_OFB => MCRYPT_MODE_NOFB, + self::MODE_STREAM => MCRYPT_MODE_STREAM, + ); + + $this->demcrypt = @mcrypt_module_open($this->cipher_name_mcrypt, '', $mcrypt_modes[$this->mode], ''); + $this->enmcrypt = @mcrypt_module_open($this->cipher_name_mcrypt, '', $mcrypt_modes[$this->mode], ''); + + // we need the $ecb mcrypt resource (only) in MODE_CFB with enableContinuousBuffer() + // to workaround mcrypt's broken ncfb implementation in buffered mode + // see: {@link http://phpseclib.sourceforge.net/cfb-demo.phps} + if ($this->mode == self::MODE_CFB) { + $this->ecb = @mcrypt_module_open($this->cipher_name_mcrypt, '', MCRYPT_MODE_ECB, ''); + } + } // else should mcrypt_generic_deinit be called? + + if ($this->mode == self::MODE_CFB) { + @mcrypt_generic_init($this->ecb, $this->key, str_repeat("\0", $this->block_size)); + } + } + + /** + * Pads a string + * + * Pads a string using the RSA PKCS padding standards so that its length is a multiple of the blocksize. + * $this->block_size - (strlen($text) % $this->block_size) bytes are added, each of which is equal to + * chr($this->block_size - (strlen($text) % $this->block_size) + * + * If padding is disabled and $text is not a multiple of the blocksize, the string will be padded regardless + * and padding will, hence forth, be enabled. + * + * @see self::_unpad() + * @param string $text + * @access private + * @return string + */ + function _pad($text) + { + $length = strlen($text); + + if (!$this->padding) { + if ($length % $this->block_size == 0) { + return $text; + } else { + user_error("The plaintext's length ($length) is not a multiple of the block size ({$this->block_size})"); + $this->padding = true; + } + } + + $pad = $this->block_size - ($length % $this->block_size); + + return str_pad($text, $length + $pad, chr($pad)); + } + + /** + * Unpads a string. + * + * If padding is enabled and the reported padding length is invalid the encryption key will be assumed to be wrong + * and false will be returned. + * + * @see self::_pad() + * @param string $text + * @access private + * @return string + */ + function _unpad($text) + { + if (!$this->padding) { + return $text; + } + + $length = ord($text[strlen($text) - 1]); + + if (!$length || $length > $this->block_size) { + return false; + } + + return substr($text, 0, -$length); + } + + /** + * Clears internal buffers + * + * Clearing/resetting the internal buffers is done everytime + * after disableContinuousBuffer() or on cipher $engine (re)init + * ie after setKey() or setIV() + * + * @access public + * @internal Could, but not must, extend by the child Crypt_* class + */ + function _clearBuffers() + { + $this->enbuffer = $this->debuffer = array('ciphertext' => '', 'xor' => '', 'pos' => 0, 'enmcrypt_init' => true); + + // mcrypt's handling of invalid's $iv: + // $this->encryptIV = $this->decryptIV = strlen($this->iv) == $this->block_size ? $this->iv : str_repeat("\0", $this->block_size); + $this->encryptIV = $this->decryptIV = str_pad(substr($this->iv, 0, $this->block_size), $this->block_size, "\0"); + + if (!$this->skip_key_adjustment) { + $this->key = str_pad(substr($this->key, 0, $this->key_length), $this->key_length, "\0"); + } + } + + /** + * String Shift + * + * Inspired by array_shift + * + * @param string $string + * @param int $index + * @access private + * @return string + */ + function _string_shift(&$string, $index = 1) + { + $substr = substr($string, 0, $index); + $string = substr($string, $index); + return $substr; + } + + /** + * String Pop + * + * Inspired by array_pop + * + * @param string $string + * @param int $index + * @access private + * @return string + */ + function _string_pop(&$string, $index = 1) + { + $substr = substr($string, -$index); + $string = substr($string, 0, -$index); + return $substr; + } + + /** + * Increment the current string + * + * @see self::decrypt() + * @see self::encrypt() + * @param string $var + * @access private + */ + function _increment_str(&$var) + { + for ($i = 4; $i <= strlen($var); $i+= 4) { + $temp = substr($var, -$i, 4); + switch ($temp) { + case "\xFF\xFF\xFF\xFF": + $var = substr_replace($var, "\x00\x00\x00\x00", -$i, 4); + break; + case "\x7F\xFF\xFF\xFF": + $var = substr_replace($var, "\x80\x00\x00\x00", -$i, 4); + return; + default: + $temp = unpack('Nnum', $temp); + $var = substr_replace($var, pack('N', $temp['num'] + 1), -$i, 4); + return; + } + } + + $remainder = strlen($var) % 4; + + if ($remainder == 0) { + return; + } + + $temp = unpack('Nnum', str_pad(substr($var, 0, $remainder), 4, "\0", STR_PAD_LEFT)); + $temp = substr(pack('N', $temp['num'] + 1), -$remainder); + $var = substr_replace($var, $temp, 0, $remainder); + } + + /** + * Setup the performance-optimized function for de/encrypt() + * + * Stores the created (or existing) callback function-name + * in $this->inline_crypt + * + * Internally for phpseclib developers: + * + * _setupInlineCrypt() would be called only if: + * + * - $engine == self::ENGINE_INTERNAL and + * + * - $use_inline_crypt === true + * + * - each time on _setup(), after(!) _setupKey() + * + * + * This ensures that _setupInlineCrypt() has always a + * full ready2go initializated internal cipher $engine state + * where, for example, the keys allready expanded, + * keys/block_size calculated and such. + * + * It is, each time if called, the responsibility of _setupInlineCrypt(): + * + * - to set $this->inline_crypt to a valid and fully working callback function + * as a (faster) replacement for encrypt() / decrypt() + * + * - NOT to create unlimited callback functions (for memory reasons!) + * no matter how often _setupInlineCrypt() would be called. At some + * point of amount they must be generic re-useable. + * + * - the code of _setupInlineCrypt() it self, + * and the generated callback code, + * must be, in following order: + * - 100% safe + * - 100% compatible to encrypt()/decrypt() + * - using only php5+ features/lang-constructs/php-extensions if + * compatibility (down to php4) or fallback is provided + * - readable/maintainable/understandable/commented and... not-cryptic-styled-code :-) + * - >= 10% faster than encrypt()/decrypt() [which is, by the way, + * the reason for the existence of _setupInlineCrypt() :-)] + * - memory-nice + * - short (as good as possible) + * + * Note: - _setupInlineCrypt() is using _createInlineCryptFunction() to create the full callback function code. + * - In case of using inline crypting, _setupInlineCrypt() must extend by the child \phpseclib\Crypt\* class. + * - The following variable names are reserved: + * - $_* (all variable names prefixed with an underscore) + * - $self (object reference to it self. Do not use $this, but $self instead) + * - $in (the content of $in has to en/decrypt by the generated code) + * - The callback function should not use the 'return' statement, but en/decrypt'ing the content of $in only + * + * + * @see self::_setup() + * @see self::_createInlineCryptFunction() + * @see self::encrypt() + * @see self::decrypt() + * @access private + * @internal If a Crypt_* class providing inline crypting it must extend _setupInlineCrypt() + */ + function _setupInlineCrypt() + { + // If, for any reason, an extending \phpseclib\Crypt\Base() \phpseclib\Crypt\* class + // not using inline crypting then it must be ensured that: $this->use_inline_crypt = false + // ie in the class var declaration of $use_inline_crypt in general for the \phpseclib\Crypt\* class, + // in the constructor at object instance-time + // or, if it's runtime-specific, at runtime + + $this->use_inline_crypt = false; + } + + /** + * Creates the performance-optimized function for en/decrypt() + * + * Internally for phpseclib developers: + * + * _createInlineCryptFunction(): + * + * - merge the $cipher_code [setup'ed by _setupInlineCrypt()] + * with the current [$this->]mode of operation code + * + * - create the $inline function, which called by encrypt() / decrypt() + * as its replacement to speed up the en/decryption operations. + * + * - return the name of the created $inline callback function + * + * - used to speed up en/decryption + * + * + * + * The main reason why can speed up things [up to 50%] this way are: + * + * - using variables more effective then regular. + * (ie no use of expensive arrays but integers $k_0, $k_1 ... + * or even, for example, the pure $key[] values hardcoded) + * + * - avoiding 1000's of function calls of ie _encryptBlock() + * but inlining the crypt operations. + * in the mode of operation for() loop. + * + * - full loop unroll the (sometimes key-dependent) rounds + * avoiding this way ++$i counters and runtime-if's etc... + * + * The basic code architectur of the generated $inline en/decrypt() + * lambda function, in pseudo php, is: + * + * + * +----------------------------------------------------------------------------------------------+ + * | callback $inline = create_function: | + * | lambda_function_0001_crypt_ECB($action, $text) | + * | { | + * | INSERT PHP CODE OF: | + * | $cipher_code['init_crypt']; // general init code. | + * | // ie: $sbox'es declarations used for | + * | // encrypt and decrypt'ing. | + * | | + * | switch ($action) { | + * | case 'encrypt': | + * | INSERT PHP CODE OF: | + * | $cipher_code['init_encrypt']; // encrypt sepcific init code. | + * | ie: specified $key or $box | + * | declarations for encrypt'ing. | + * | | + * | foreach ($ciphertext) { | + * | $in = $block_size of $ciphertext; | + * | | + * | INSERT PHP CODE OF: | + * | $cipher_code['encrypt_block']; // encrypt's (string) $in, which is always: | + * | // strlen($in) == $this->block_size | + * | // here comes the cipher algorithm in action | + * | // for encryption. | + * | // $cipher_code['encrypt_block'] has to | + * | // encrypt the content of the $in variable | + * | | + * | $plaintext .= $in; | + * | } | + * | return $plaintext; | + * | | + * | case 'decrypt': | + * | INSERT PHP CODE OF: | + * | $cipher_code['init_decrypt']; // decrypt sepcific init code | + * | ie: specified $key or $box | + * | declarations for decrypt'ing. | + * | foreach ($plaintext) { | + * | $in = $block_size of $plaintext; | + * | | + * | INSERT PHP CODE OF: | + * | $cipher_code['decrypt_block']; // decrypt's (string) $in, which is always | + * | // strlen($in) == $this->block_size | + * | // here comes the cipher algorithm in action | + * | // for decryption. | + * | // $cipher_code['decrypt_block'] has to | + * | // decrypt the content of the $in variable | + * | $ciphertext .= $in; | + * | } | + * | return $ciphertext; | + * | } | + * | } | + * +----------------------------------------------------------------------------------------------+ + * + * + * See also the \phpseclib\Crypt\*::_setupInlineCrypt()'s for + * productive inline $cipher_code's how they works. + * + * Structure of: + * + * $cipher_code = array( + * 'init_crypt' => (string) '', // optional + * 'init_encrypt' => (string) '', // optional + * 'init_decrypt' => (string) '', // optional + * 'encrypt_block' => (string) '', // required + * 'decrypt_block' => (string) '' // required + * ); + * + * + * @see self::_setupInlineCrypt() + * @see self::encrypt() + * @see self::decrypt() + * @param array $cipher_code + * @access private + * @return string (the name of the created callback function) + */ + function _createInlineCryptFunction($cipher_code) + { + $block_size = $this->block_size; + + // optional + $init_crypt = isset($cipher_code['init_crypt']) ? $cipher_code['init_crypt'] : ''; + $init_encrypt = isset($cipher_code['init_encrypt']) ? $cipher_code['init_encrypt'] : ''; + $init_decrypt = isset($cipher_code['init_decrypt']) ? $cipher_code['init_decrypt'] : ''; + // required + $encrypt_block = $cipher_code['encrypt_block']; + $decrypt_block = $cipher_code['decrypt_block']; + + // Generating mode of operation inline code, + // merged with the $cipher_code algorithm + // for encrypt- and decryption. + switch ($this->mode) { + case self::MODE_ECB: + $encrypt = $init_encrypt . ' + $_ciphertext = ""; + $_plaintext_len = strlen($_text); + + for ($_i = 0; $_i < $_plaintext_len; $_i+= '.$block_size.') { + $in = substr($_text, $_i, '.$block_size.'); + '.$encrypt_block.' + $_ciphertext.= $in; + } + + return $_ciphertext; + '; + + $decrypt = $init_decrypt . ' + $_plaintext = ""; + $_text = str_pad($_text, strlen($_text) + ('.$block_size.' - strlen($_text) % '.$block_size.') % '.$block_size.', chr(0)); + $_ciphertext_len = strlen($_text); + + for ($_i = 0; $_i < $_ciphertext_len; $_i+= '.$block_size.') { + $in = substr($_text, $_i, '.$block_size.'); + '.$decrypt_block.' + $_plaintext.= $in; + } + + return $self->_unpad($_plaintext); + '; + break; + case self::MODE_CTR: + $encrypt = $init_encrypt . ' + $_ciphertext = ""; + $_plaintext_len = strlen($_text); + $_xor = $self->encryptIV; + $_buffer = &$self->enbuffer; + if (strlen($_buffer["ciphertext"])) { + for ($_i = 0; $_i < $_plaintext_len; $_i+= '.$block_size.') { + $_block = substr($_text, $_i, '.$block_size.'); + if (strlen($_block) > strlen($_buffer["ciphertext"])) { + $in = $_xor; + '.$encrypt_block.' + $self->_increment_str($_xor); + $_buffer["ciphertext"].= $in; + } + $_key = $self->_string_shift($_buffer["ciphertext"], '.$block_size.'); + $_ciphertext.= $_block ^ $_key; + } + } else { + for ($_i = 0; $_i < $_plaintext_len; $_i+= '.$block_size.') { + $_block = substr($_text, $_i, '.$block_size.'); + $in = $_xor; + '.$encrypt_block.' + $self->_increment_str($_xor); + $_key = $in; + $_ciphertext.= $_block ^ $_key; + } + } + if ($self->continuousBuffer) { + $self->encryptIV = $_xor; + if ($_start = $_plaintext_len % '.$block_size.') { + $_buffer["ciphertext"] = substr($_key, $_start) . $_buffer["ciphertext"]; + } + } + + return $_ciphertext; + '; + + $decrypt = $init_encrypt . ' + $_plaintext = ""; + $_ciphertext_len = strlen($_text); + $_xor = $self->decryptIV; + $_buffer = &$self->debuffer; + + if (strlen($_buffer["ciphertext"])) { + for ($_i = 0; $_i < $_ciphertext_len; $_i+= '.$block_size.') { + $_block = substr($_text, $_i, '.$block_size.'); + if (strlen($_block) > strlen($_buffer["ciphertext"])) { + $in = $_xor; + '.$encrypt_block.' + $self->_increment_str($_xor); + $_buffer["ciphertext"].= $in; + } + $_key = $self->_string_shift($_buffer["ciphertext"], '.$block_size.'); + $_plaintext.= $_block ^ $_key; + } + } else { + for ($_i = 0; $_i < $_ciphertext_len; $_i+= '.$block_size.') { + $_block = substr($_text, $_i, '.$block_size.'); + $in = $_xor; + '.$encrypt_block.' + $self->_increment_str($_xor); + $_key = $in; + $_plaintext.= $_block ^ $_key; + } + } + if ($self->continuousBuffer) { + $self->decryptIV = $_xor; + if ($_start = $_ciphertext_len % '.$block_size.') { + $_buffer["ciphertext"] = substr($_key, $_start) . $_buffer["ciphertext"]; + } + } + + return $_plaintext; + '; + break; + case self::MODE_CFB: + $encrypt = $init_encrypt . ' + $_ciphertext = ""; + $_buffer = &$self->enbuffer; + + if ($self->continuousBuffer) { + $_iv = &$self->encryptIV; + $_pos = &$_buffer["pos"]; + } else { + $_iv = $self->encryptIV; + $_pos = 0; + } + $_len = strlen($_text); + $_i = 0; + if ($_pos) { + $_orig_pos = $_pos; + $_max = '.$block_size.' - $_pos; + if ($_len >= $_max) { + $_i = $_max; + $_len-= $_max; + $_pos = 0; + } else { + $_i = $_len; + $_pos+= $_len; + $_len = 0; + } + $_ciphertext = substr($_iv, $_orig_pos) ^ $_text; + $_iv = substr_replace($_iv, $_ciphertext, $_orig_pos, $_i); + } + while ($_len >= '.$block_size.') { + $in = $_iv; + '.$encrypt_block.'; + $_iv = $in ^ substr($_text, $_i, '.$block_size.'); + $_ciphertext.= $_iv; + $_len-= '.$block_size.'; + $_i+= '.$block_size.'; + } + if ($_len) { + $in = $_iv; + '.$encrypt_block.' + $_iv = $in; + $_block = $_iv ^ substr($_text, $_i); + $_iv = substr_replace($_iv, $_block, 0, $_len); + $_ciphertext.= $_block; + $_pos = $_len; + } + return $_ciphertext; + '; + + $decrypt = $init_encrypt . ' + $_plaintext = ""; + $_buffer = &$self->debuffer; + + if ($self->continuousBuffer) { + $_iv = &$self->decryptIV; + $_pos = &$_buffer["pos"]; + } else { + $_iv = $self->decryptIV; + $_pos = 0; + } + $_len = strlen($_text); + $_i = 0; + if ($_pos) { + $_orig_pos = $_pos; + $_max = '.$block_size.' - $_pos; + if ($_len >= $_max) { + $_i = $_max; + $_len-= $_max; + $_pos = 0; + } else { + $_i = $_len; + $_pos+= $_len; + $_len = 0; + } + $_plaintext = substr($_iv, $_orig_pos) ^ $_text; + $_iv = substr_replace($_iv, substr($_text, 0, $_i), $_orig_pos, $_i); + } + while ($_len >= '.$block_size.') { + $in = $_iv; + '.$encrypt_block.' + $_iv = $in; + $cb = substr($_text, $_i, '.$block_size.'); + $_plaintext.= $_iv ^ $cb; + $_iv = $cb; + $_len-= '.$block_size.'; + $_i+= '.$block_size.'; + } + if ($_len) { + $in = $_iv; + '.$encrypt_block.' + $_iv = $in; + $_plaintext.= $_iv ^ substr($_text, $_i); + $_iv = substr_replace($_iv, substr($_text, $_i), 0, $_len); + $_pos = $_len; + } + + return $_plaintext; + '; + break; + case self::MODE_OFB: + $encrypt = $init_encrypt . ' + $_ciphertext = ""; + $_plaintext_len = strlen($_text); + $_xor = $self->encryptIV; + $_buffer = &$self->enbuffer; + + if (strlen($_buffer["xor"])) { + for ($_i = 0; $_i < $_plaintext_len; $_i+= '.$block_size.') { + $_block = substr($_text, $_i, '.$block_size.'); + if (strlen($_block) > strlen($_buffer["xor"])) { + $in = $_xor; + '.$encrypt_block.' + $_xor = $in; + $_buffer["xor"].= $_xor; + } + $_key = $self->_string_shift($_buffer["xor"], '.$block_size.'); + $_ciphertext.= $_block ^ $_key; + } + } else { + for ($_i = 0; $_i < $_plaintext_len; $_i+= '.$block_size.') { + $in = $_xor; + '.$encrypt_block.' + $_xor = $in; + $_ciphertext.= substr($_text, $_i, '.$block_size.') ^ $_xor; + } + $_key = $_xor; + } + if ($self->continuousBuffer) { + $self->encryptIV = $_xor; + if ($_start = $_plaintext_len % '.$block_size.') { + $_buffer["xor"] = substr($_key, $_start) . $_buffer["xor"]; + } + } + return $_ciphertext; + '; + + $decrypt = $init_encrypt . ' + $_plaintext = ""; + $_ciphertext_len = strlen($_text); + $_xor = $self->decryptIV; + $_buffer = &$self->debuffer; + + if (strlen($_buffer["xor"])) { + for ($_i = 0; $_i < $_ciphertext_len; $_i+= '.$block_size.') { + $_block = substr($_text, $_i, '.$block_size.'); + if (strlen($_block) > strlen($_buffer["xor"])) { + $in = $_xor; + '.$encrypt_block.' + $_xor = $in; + $_buffer["xor"].= $_xor; + } + $_key = $self->_string_shift($_buffer["xor"], '.$block_size.'); + $_plaintext.= $_block ^ $_key; + } + } else { + for ($_i = 0; $_i < $_ciphertext_len; $_i+= '.$block_size.') { + $in = $_xor; + '.$encrypt_block.' + $_xor = $in; + $_plaintext.= substr($_text, $_i, '.$block_size.') ^ $_xor; + } + $_key = $_xor; + } + if ($self->continuousBuffer) { + $self->decryptIV = $_xor; + if ($_start = $_ciphertext_len % '.$block_size.') { + $_buffer["xor"] = substr($_key, $_start) . $_buffer["xor"]; + } + } + return $_plaintext; + '; + break; + case self::MODE_STREAM: + $encrypt = $init_encrypt . ' + $_ciphertext = ""; + '.$encrypt_block.' + return $_ciphertext; + '; + $decrypt = $init_decrypt . ' + $_plaintext = ""; + '.$decrypt_block.' + return $_plaintext; + '; + break; + // case self::MODE_CBC: + default: + $encrypt = $init_encrypt . ' + $_ciphertext = ""; + $_plaintext_len = strlen($_text); + + $in = $self->encryptIV; + + for ($_i = 0; $_i < $_plaintext_len; $_i+= '.$block_size.') { + $in = substr($_text, $_i, '.$block_size.') ^ $in; + '.$encrypt_block.' + $_ciphertext.= $in; + } + + if ($self->continuousBuffer) { + $self->encryptIV = $in; + } + + return $_ciphertext; + '; + + $decrypt = $init_decrypt . ' + $_plaintext = ""; + $_text = str_pad($_text, strlen($_text) + ('.$block_size.' - strlen($_text) % '.$block_size.') % '.$block_size.', chr(0)); + $_ciphertext_len = strlen($_text); + + $_iv = $self->decryptIV; + + for ($_i = 0; $_i < $_ciphertext_len; $_i+= '.$block_size.') { + $in = $_block = substr($_text, $_i, '.$block_size.'); + '.$decrypt_block.' + $_plaintext.= $in ^ $_iv; + $_iv = $_block; + } + + if ($self->continuousBuffer) { + $self->decryptIV = $_iv; + } + + return $self->_unpad($_plaintext); + '; + break; + } + + // Create the $inline function and return its name as string. Ready to run! + if (version_compare(PHP_VERSION, '5.3.0') >= 0) { + eval('$func = function ($_action, &$self, $_text) { ' . $init_crypt . 'if ($_action == "encrypt") { ' . $encrypt . ' } else { ' . $decrypt . ' } };'); + return $func; + } + + return create_function('$_action, &$self, $_text', $init_crypt . 'if ($_action == "encrypt") { ' . $encrypt . ' } else { ' . $decrypt . ' }'); + } + + /** + * Holds the lambda_functions table (classwide) + * + * Each name of the lambda function, created from + * _setupInlineCrypt() && _createInlineCryptFunction() + * is stored, classwide (!), here for reusing. + * + * The string-based index of $function is a classwide + * unique value representing, at least, the $mode of + * operation (or more... depends of the optimizing level) + * for which $mode the lambda function was created. + * + * @access private + * @return array &$functions + */ + function &_getLambdaFunctions() + { + static $functions = array(); + return $functions; + } + + /** + * Generates a digest from $bytes + * + * @see self::_setupInlineCrypt() + * @access private + * @param $bytes + * @return string + */ + function _hashInlineCryptFunction($bytes) + { + if (!isset(self::$WHIRLPOOL_AVAILABLE)) { + self::$WHIRLPOOL_AVAILABLE = extension_loaded('hash') && in_array('whirlpool', hash_algos()); + } + + $result = ''; + $hash = $bytes; + + switch (true) { + case self::$WHIRLPOOL_AVAILABLE: + foreach (str_split($bytes, 64) as $t) { + $hash = hash('whirlpool', $hash, true); + $result .= $t ^ $hash; + } + return $result . hash('whirlpool', $hash, true); + default: + $len = strlen($bytes); + for ($i = 0; $i < $len; $i+=20) { + $t = substr($bytes, $i, 20); + $hash = pack('H*', sha1($hash)); + $result .= $t ^ $hash; + } + return $result . pack('H*', sha1($hash)); + } + } + + /** + * Convert float to int + * + * On ARM CPUs converting floats to ints doesn't always work + * + * @access private + * @param string $x + * @return int + */ + function safe_intval($x) + { + switch (true) { + case is_int($x): + // PHP 5.3, per http://php.net/releases/5_3_0.php, introduced "more consistent float rounding" + case (php_uname('m') & "\xDF\xDF\xDF") != 'ARM': + return $x; + } + return (fmod($x, 0x80000000) & 0x7FFFFFFF) | + ((fmod(floor($x / 0x80000000), 2) & 1) << 31); + } + + /** + * eval()'able string for in-line float to int + * + * @access private + * @return string + */ + function safe_intval_inline() + { + switch (true) { + case defined('PHP_INT_SIZE') && PHP_INT_SIZE == 8: + case (php_uname('m') & "\xDF\xDF\xDF") != 'ARM': + return '%s'; + break; + default: + $safeint = '(is_int($temp = %s) ? $temp : (fmod($temp, 0x80000000) & 0x7FFFFFFF) | '; + return $safeint . '((fmod(floor($temp / 0x80000000), 2) & 1) << 31))'; + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Blowfish.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Blowfish.php new file mode 100644 index 0000000..74cc49d --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Blowfish.php @@ -0,0 +1,571 @@ + + * setKey('12345678901234567890123456789012'); + * + * $plaintext = str_repeat('a', 1024); + * + * echo $blowfish->decrypt($blowfish->encrypt($plaintext)); + * ?> + * + * + * @category Crypt + * @package Blowfish + * @author Jim Wigginton + * @author Hans-Juergen Petrich + * @copyright 2007 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP implementation of Blowfish. + * + * @package Blowfish + * @author Jim Wigginton + * @author Hans-Juergen Petrich + * @access public + */ +class Blowfish extends Base +{ + /** + * Block Length of the cipher + * + * @see \phpseclib\Crypt\Base::block_size + * @var int + * @access private + */ + var $block_size = 8; + + /** + * The mcrypt specific name of the cipher + * + * @see \phpseclib\Crypt\Base::cipher_name_mcrypt + * @var string + * @access private + */ + var $cipher_name_mcrypt = 'blowfish'; + + /** + * Optimizing value while CFB-encrypting + * + * @see \phpseclib\Crypt\Base::cfb_init_len + * @var int + * @access private + */ + var $cfb_init_len = 500; + + /** + * The fixed subkeys boxes ($sbox0 - $sbox3) with 256 entries each + * + * S-Box 0 + * + * @access private + * @var array + */ + var $sbox0 = array( + 0xd1310ba6, 0x98dfb5ac, 0x2ffd72db, 0xd01adfb7, 0xb8e1afed, 0x6a267e96, 0xba7c9045, 0xf12c7f99, + 0x24a19947, 0xb3916cf7, 0x0801f2e2, 0x858efc16, 0x636920d8, 0x71574e69, 0xa458fea3, 0xf4933d7e, + 0x0d95748f, 0x728eb658, 0x718bcd58, 0x82154aee, 0x7b54a41d, 0xc25a59b5, 0x9c30d539, 0x2af26013, + 0xc5d1b023, 0x286085f0, 0xca417918, 0xb8db38ef, 0x8e79dcb0, 0x603a180e, 0x6c9e0e8b, 0xb01e8a3e, + 0xd71577c1, 0xbd314b27, 0x78af2fda, 0x55605c60, 0xe65525f3, 0xaa55ab94, 0x57489862, 0x63e81440, + 0x55ca396a, 0x2aab10b6, 0xb4cc5c34, 0x1141e8ce, 0xa15486af, 0x7c72e993, 0xb3ee1411, 0x636fbc2a, + 0x2ba9c55d, 0x741831f6, 0xce5c3e16, 0x9b87931e, 0xafd6ba33, 0x6c24cf5c, 0x7a325381, 0x28958677, + 0x3b8f4898, 0x6b4bb9af, 0xc4bfe81b, 0x66282193, 0x61d809cc, 0xfb21a991, 0x487cac60, 0x5dec8032, + 0xef845d5d, 0xe98575b1, 0xdc262302, 0xeb651b88, 0x23893e81, 0xd396acc5, 0x0f6d6ff3, 0x83f44239, + 0x2e0b4482, 0xa4842004, 0x69c8f04a, 0x9e1f9b5e, 0x21c66842, 0xf6e96c9a, 0x670c9c61, 0xabd388f0, + 0x6a51a0d2, 0xd8542f68, 0x960fa728, 0xab5133a3, 0x6eef0b6c, 0x137a3be4, 0xba3bf050, 0x7efb2a98, + 0xa1f1651d, 0x39af0176, 0x66ca593e, 0x82430e88, 0x8cee8619, 0x456f9fb4, 0x7d84a5c3, 0x3b8b5ebe, + 0xe06f75d8, 0x85c12073, 0x401a449f, 0x56c16aa6, 0x4ed3aa62, 0x363f7706, 0x1bfedf72, 0x429b023d, + 0x37d0d724, 0xd00a1248, 0xdb0fead3, 0x49f1c09b, 0x075372c9, 0x80991b7b, 0x25d479d8, 0xf6e8def7, + 0xe3fe501a, 0xb6794c3b, 0x976ce0bd, 0x04c006ba, 0xc1a94fb6, 0x409f60c4, 0x5e5c9ec2, 0x196a2463, + 0x68fb6faf, 0x3e6c53b5, 0x1339b2eb, 0x3b52ec6f, 0x6dfc511f, 0x9b30952c, 0xcc814544, 0xaf5ebd09, + 0xbee3d004, 0xde334afd, 0x660f2807, 0x192e4bb3, 0xc0cba857, 0x45c8740f, 0xd20b5f39, 0xb9d3fbdb, + 0x5579c0bd, 0x1a60320a, 0xd6a100c6, 0x402c7279, 0x679f25fe, 0xfb1fa3cc, 0x8ea5e9f8, 0xdb3222f8, + 0x3c7516df, 0xfd616b15, 0x2f501ec8, 0xad0552ab, 0x323db5fa, 0xfd238760, 0x53317b48, 0x3e00df82, + 0x9e5c57bb, 0xca6f8ca0, 0x1a87562e, 0xdf1769db, 0xd542a8f6, 0x287effc3, 0xac6732c6, 0x8c4f5573, + 0x695b27b0, 0xbbca58c8, 0xe1ffa35d, 0xb8f011a0, 0x10fa3d98, 0xfd2183b8, 0x4afcb56c, 0x2dd1d35b, + 0x9a53e479, 0xb6f84565, 0xd28e49bc, 0x4bfb9790, 0xe1ddf2da, 0xa4cb7e33, 0x62fb1341, 0xcee4c6e8, + 0xef20cada, 0x36774c01, 0xd07e9efe, 0x2bf11fb4, 0x95dbda4d, 0xae909198, 0xeaad8e71, 0x6b93d5a0, + 0xd08ed1d0, 0xafc725e0, 0x8e3c5b2f, 0x8e7594b7, 0x8ff6e2fb, 0xf2122b64, 0x8888b812, 0x900df01c, + 0x4fad5ea0, 0x688fc31c, 0xd1cff191, 0xb3a8c1ad, 0x2f2f2218, 0xbe0e1777, 0xea752dfe, 0x8b021fa1, + 0xe5a0cc0f, 0xb56f74e8, 0x18acf3d6, 0xce89e299, 0xb4a84fe0, 0xfd13e0b7, 0x7cc43b81, 0xd2ada8d9, + 0x165fa266, 0x80957705, 0x93cc7314, 0x211a1477, 0xe6ad2065, 0x77b5fa86, 0xc75442f5, 0xfb9d35cf, + 0xebcdaf0c, 0x7b3e89a0, 0xd6411bd3, 0xae1e7e49, 0x00250e2d, 0x2071b35e, 0x226800bb, 0x57b8e0af, + 0x2464369b, 0xf009b91e, 0x5563911d, 0x59dfa6aa, 0x78c14389, 0xd95a537f, 0x207d5ba2, 0x02e5b9c5, + 0x83260376, 0x6295cfa9, 0x11c81968, 0x4e734a41, 0xb3472dca, 0x7b14a94a, 0x1b510052, 0x9a532915, + 0xd60f573f, 0xbc9bc6e4, 0x2b60a476, 0x81e67400, 0x08ba6fb5, 0x571be91f, 0xf296ec6b, 0x2a0dd915, + 0xb6636521, 0xe7b9f9b6, 0xff34052e, 0xc5855664, 0x53b02d5d, 0xa99f8fa1, 0x08ba4799, 0x6e85076a + ); + + /** + * S-Box 1 + * + * @access private + * @var array + */ + var $sbox1 = array( + 0x4b7a70e9, 0xb5b32944, 0xdb75092e, 0xc4192623, 0xad6ea6b0, 0x49a7df7d, 0x9cee60b8, 0x8fedb266, + 0xecaa8c71, 0x699a17ff, 0x5664526c, 0xc2b19ee1, 0x193602a5, 0x75094c29, 0xa0591340, 0xe4183a3e, + 0x3f54989a, 0x5b429d65, 0x6b8fe4d6, 0x99f73fd6, 0xa1d29c07, 0xefe830f5, 0x4d2d38e6, 0xf0255dc1, + 0x4cdd2086, 0x8470eb26, 0x6382e9c6, 0x021ecc5e, 0x09686b3f, 0x3ebaefc9, 0x3c971814, 0x6b6a70a1, + 0x687f3584, 0x52a0e286, 0xb79c5305, 0xaa500737, 0x3e07841c, 0x7fdeae5c, 0x8e7d44ec, 0x5716f2b8, + 0xb03ada37, 0xf0500c0d, 0xf01c1f04, 0x0200b3ff, 0xae0cf51a, 0x3cb574b2, 0x25837a58, 0xdc0921bd, + 0xd19113f9, 0x7ca92ff6, 0x94324773, 0x22f54701, 0x3ae5e581, 0x37c2dadc, 0xc8b57634, 0x9af3dda7, + 0xa9446146, 0x0fd0030e, 0xecc8c73e, 0xa4751e41, 0xe238cd99, 0x3bea0e2f, 0x3280bba1, 0x183eb331, + 0x4e548b38, 0x4f6db908, 0x6f420d03, 0xf60a04bf, 0x2cb81290, 0x24977c79, 0x5679b072, 0xbcaf89af, + 0xde9a771f, 0xd9930810, 0xb38bae12, 0xdccf3f2e, 0x5512721f, 0x2e6b7124, 0x501adde6, 0x9f84cd87, + 0x7a584718, 0x7408da17, 0xbc9f9abc, 0xe94b7d8c, 0xec7aec3a, 0xdb851dfa, 0x63094366, 0xc464c3d2, + 0xef1c1847, 0x3215d908, 0xdd433b37, 0x24c2ba16, 0x12a14d43, 0x2a65c451, 0x50940002, 0x133ae4dd, + 0x71dff89e, 0x10314e55, 0x81ac77d6, 0x5f11199b, 0x043556f1, 0xd7a3c76b, 0x3c11183b, 0x5924a509, + 0xf28fe6ed, 0x97f1fbfa, 0x9ebabf2c, 0x1e153c6e, 0x86e34570, 0xeae96fb1, 0x860e5e0a, 0x5a3e2ab3, + 0x771fe71c, 0x4e3d06fa, 0x2965dcb9, 0x99e71d0f, 0x803e89d6, 0x5266c825, 0x2e4cc978, 0x9c10b36a, + 0xc6150eba, 0x94e2ea78, 0xa5fc3c53, 0x1e0a2df4, 0xf2f74ea7, 0x361d2b3d, 0x1939260f, 0x19c27960, + 0x5223a708, 0xf71312b6, 0xebadfe6e, 0xeac31f66, 0xe3bc4595, 0xa67bc883, 0xb17f37d1, 0x018cff28, + 0xc332ddef, 0xbe6c5aa5, 0x65582185, 0x68ab9802, 0xeecea50f, 0xdb2f953b, 0x2aef7dad, 0x5b6e2f84, + 0x1521b628, 0x29076170, 0xecdd4775, 0x619f1510, 0x13cca830, 0xeb61bd96, 0x0334fe1e, 0xaa0363cf, + 0xb5735c90, 0x4c70a239, 0xd59e9e0b, 0xcbaade14, 0xeecc86bc, 0x60622ca7, 0x9cab5cab, 0xb2f3846e, + 0x648b1eaf, 0x19bdf0ca, 0xa02369b9, 0x655abb50, 0x40685a32, 0x3c2ab4b3, 0x319ee9d5, 0xc021b8f7, + 0x9b540b19, 0x875fa099, 0x95f7997e, 0x623d7da8, 0xf837889a, 0x97e32d77, 0x11ed935f, 0x16681281, + 0x0e358829, 0xc7e61fd6, 0x96dedfa1, 0x7858ba99, 0x57f584a5, 0x1b227263, 0x9b83c3ff, 0x1ac24696, + 0xcdb30aeb, 0x532e3054, 0x8fd948e4, 0x6dbc3128, 0x58ebf2ef, 0x34c6ffea, 0xfe28ed61, 0xee7c3c73, + 0x5d4a14d9, 0xe864b7e3, 0x42105d14, 0x203e13e0, 0x45eee2b6, 0xa3aaabea, 0xdb6c4f15, 0xfacb4fd0, + 0xc742f442, 0xef6abbb5, 0x654f3b1d, 0x41cd2105, 0xd81e799e, 0x86854dc7, 0xe44b476a, 0x3d816250, + 0xcf62a1f2, 0x5b8d2646, 0xfc8883a0, 0xc1c7b6a3, 0x7f1524c3, 0x69cb7492, 0x47848a0b, 0x5692b285, + 0x095bbf00, 0xad19489d, 0x1462b174, 0x23820e00, 0x58428d2a, 0x0c55f5ea, 0x1dadf43e, 0x233f7061, + 0x3372f092, 0x8d937e41, 0xd65fecf1, 0x6c223bdb, 0x7cde3759, 0xcbee7460, 0x4085f2a7, 0xce77326e, + 0xa6078084, 0x19f8509e, 0xe8efd855, 0x61d99735, 0xa969a7aa, 0xc50c06c2, 0x5a04abfc, 0x800bcadc, + 0x9e447a2e, 0xc3453484, 0xfdd56705, 0x0e1e9ec9, 0xdb73dbd3, 0x105588cd, 0x675fda79, 0xe3674340, + 0xc5c43465, 0x713e38d8, 0x3d28f89e, 0xf16dff20, 0x153e21e7, 0x8fb03d4a, 0xe6e39f2b, 0xdb83adf7 + ); + + /** + * S-Box 2 + * + * @access private + * @var array + */ + var $sbox2 = array( + 0xe93d5a68, 0x948140f7, 0xf64c261c, 0x94692934, 0x411520f7, 0x7602d4f7, 0xbcf46b2e, 0xd4a20068, + 0xd4082471, 0x3320f46a, 0x43b7d4b7, 0x500061af, 0x1e39f62e, 0x97244546, 0x14214f74, 0xbf8b8840, + 0x4d95fc1d, 0x96b591af, 0x70f4ddd3, 0x66a02f45, 0xbfbc09ec, 0x03bd9785, 0x7fac6dd0, 0x31cb8504, + 0x96eb27b3, 0x55fd3941, 0xda2547e6, 0xabca0a9a, 0x28507825, 0x530429f4, 0x0a2c86da, 0xe9b66dfb, + 0x68dc1462, 0xd7486900, 0x680ec0a4, 0x27a18dee, 0x4f3ffea2, 0xe887ad8c, 0xb58ce006, 0x7af4d6b6, + 0xaace1e7c, 0xd3375fec, 0xce78a399, 0x406b2a42, 0x20fe9e35, 0xd9f385b9, 0xee39d7ab, 0x3b124e8b, + 0x1dc9faf7, 0x4b6d1856, 0x26a36631, 0xeae397b2, 0x3a6efa74, 0xdd5b4332, 0x6841e7f7, 0xca7820fb, + 0xfb0af54e, 0xd8feb397, 0x454056ac, 0xba489527, 0x55533a3a, 0x20838d87, 0xfe6ba9b7, 0xd096954b, + 0x55a867bc, 0xa1159a58, 0xcca92963, 0x99e1db33, 0xa62a4a56, 0x3f3125f9, 0x5ef47e1c, 0x9029317c, + 0xfdf8e802, 0x04272f70, 0x80bb155c, 0x05282ce3, 0x95c11548, 0xe4c66d22, 0x48c1133f, 0xc70f86dc, + 0x07f9c9ee, 0x41041f0f, 0x404779a4, 0x5d886e17, 0x325f51eb, 0xd59bc0d1, 0xf2bcc18f, 0x41113564, + 0x257b7834, 0x602a9c60, 0xdff8e8a3, 0x1f636c1b, 0x0e12b4c2, 0x02e1329e, 0xaf664fd1, 0xcad18115, + 0x6b2395e0, 0x333e92e1, 0x3b240b62, 0xeebeb922, 0x85b2a20e, 0xe6ba0d99, 0xde720c8c, 0x2da2f728, + 0xd0127845, 0x95b794fd, 0x647d0862, 0xe7ccf5f0, 0x5449a36f, 0x877d48fa, 0xc39dfd27, 0xf33e8d1e, + 0x0a476341, 0x992eff74, 0x3a6f6eab, 0xf4f8fd37, 0xa812dc60, 0xa1ebddf8, 0x991be14c, 0xdb6e6b0d, + 0xc67b5510, 0x6d672c37, 0x2765d43b, 0xdcd0e804, 0xf1290dc7, 0xcc00ffa3, 0xb5390f92, 0x690fed0b, + 0x667b9ffb, 0xcedb7d9c, 0xa091cf0b, 0xd9155ea3, 0xbb132f88, 0x515bad24, 0x7b9479bf, 0x763bd6eb, + 0x37392eb3, 0xcc115979, 0x8026e297, 0xf42e312d, 0x6842ada7, 0xc66a2b3b, 0x12754ccc, 0x782ef11c, + 0x6a124237, 0xb79251e7, 0x06a1bbe6, 0x4bfb6350, 0x1a6b1018, 0x11caedfa, 0x3d25bdd8, 0xe2e1c3c9, + 0x44421659, 0x0a121386, 0xd90cec6e, 0xd5abea2a, 0x64af674e, 0xda86a85f, 0xbebfe988, 0x64e4c3fe, + 0x9dbc8057, 0xf0f7c086, 0x60787bf8, 0x6003604d, 0xd1fd8346, 0xf6381fb0, 0x7745ae04, 0xd736fccc, + 0x83426b33, 0xf01eab71, 0xb0804187, 0x3c005e5f, 0x77a057be, 0xbde8ae24, 0x55464299, 0xbf582e61, + 0x4e58f48f, 0xf2ddfda2, 0xf474ef38, 0x8789bdc2, 0x5366f9c3, 0xc8b38e74, 0xb475f255, 0x46fcd9b9, + 0x7aeb2661, 0x8b1ddf84, 0x846a0e79, 0x915f95e2, 0x466e598e, 0x20b45770, 0x8cd55591, 0xc902de4c, + 0xb90bace1, 0xbb8205d0, 0x11a86248, 0x7574a99e, 0xb77f19b6, 0xe0a9dc09, 0x662d09a1, 0xc4324633, + 0xe85a1f02, 0x09f0be8c, 0x4a99a025, 0x1d6efe10, 0x1ab93d1d, 0x0ba5a4df, 0xa186f20f, 0x2868f169, + 0xdcb7da83, 0x573906fe, 0xa1e2ce9b, 0x4fcd7f52, 0x50115e01, 0xa70683fa, 0xa002b5c4, 0x0de6d027, + 0x9af88c27, 0x773f8641, 0xc3604c06, 0x61a806b5, 0xf0177a28, 0xc0f586e0, 0x006058aa, 0x30dc7d62, + 0x11e69ed7, 0x2338ea63, 0x53c2dd94, 0xc2c21634, 0xbbcbee56, 0x90bcb6de, 0xebfc7da1, 0xce591d76, + 0x6f05e409, 0x4b7c0188, 0x39720a3d, 0x7c927c24, 0x86e3725f, 0x724d9db9, 0x1ac15bb4, 0xd39eb8fc, + 0xed545578, 0x08fca5b5, 0xd83d7cd3, 0x4dad0fc4, 0x1e50ef5e, 0xb161e6f8, 0xa28514d9, 0x6c51133c, + 0x6fd5c7e7, 0x56e14ec4, 0x362abfce, 0xddc6c837, 0xd79a3234, 0x92638212, 0x670efa8e, 0x406000e0 + ); + + /** + * S-Box 3 + * + * @access private + * @var array + */ + var $sbox3 = array( + 0x3a39ce37, 0xd3faf5cf, 0xabc27737, 0x5ac52d1b, 0x5cb0679e, 0x4fa33742, 0xd3822740, 0x99bc9bbe, + 0xd5118e9d, 0xbf0f7315, 0xd62d1c7e, 0xc700c47b, 0xb78c1b6b, 0x21a19045, 0xb26eb1be, 0x6a366eb4, + 0x5748ab2f, 0xbc946e79, 0xc6a376d2, 0x6549c2c8, 0x530ff8ee, 0x468dde7d, 0xd5730a1d, 0x4cd04dc6, + 0x2939bbdb, 0xa9ba4650, 0xac9526e8, 0xbe5ee304, 0xa1fad5f0, 0x6a2d519a, 0x63ef8ce2, 0x9a86ee22, + 0xc089c2b8, 0x43242ef6, 0xa51e03aa, 0x9cf2d0a4, 0x83c061ba, 0x9be96a4d, 0x8fe51550, 0xba645bd6, + 0x2826a2f9, 0xa73a3ae1, 0x4ba99586, 0xef5562e9, 0xc72fefd3, 0xf752f7da, 0x3f046f69, 0x77fa0a59, + 0x80e4a915, 0x87b08601, 0x9b09e6ad, 0x3b3ee593, 0xe990fd5a, 0x9e34d797, 0x2cf0b7d9, 0x022b8b51, + 0x96d5ac3a, 0x017da67d, 0xd1cf3ed6, 0x7c7d2d28, 0x1f9f25cf, 0xadf2b89b, 0x5ad6b472, 0x5a88f54c, + 0xe029ac71, 0xe019a5e6, 0x47b0acfd, 0xed93fa9b, 0xe8d3c48d, 0x283b57cc, 0xf8d56629, 0x79132e28, + 0x785f0191, 0xed756055, 0xf7960e44, 0xe3d35e8c, 0x15056dd4, 0x88f46dba, 0x03a16125, 0x0564f0bd, + 0xc3eb9e15, 0x3c9057a2, 0x97271aec, 0xa93a072a, 0x1b3f6d9b, 0x1e6321f5, 0xf59c66fb, 0x26dcf319, + 0x7533d928, 0xb155fdf5, 0x03563482, 0x8aba3cbb, 0x28517711, 0xc20ad9f8, 0xabcc5167, 0xccad925f, + 0x4de81751, 0x3830dc8e, 0x379d5862, 0x9320f991, 0xea7a90c2, 0xfb3e7bce, 0x5121ce64, 0x774fbe32, + 0xa8b6e37e, 0xc3293d46, 0x48de5369, 0x6413e680, 0xa2ae0810, 0xdd6db224, 0x69852dfd, 0x09072166, + 0xb39a460a, 0x6445c0dd, 0x586cdecf, 0x1c20c8ae, 0x5bbef7dd, 0x1b588d40, 0xccd2017f, 0x6bb4e3bb, + 0xdda26a7e, 0x3a59ff45, 0x3e350a44, 0xbcb4cdd5, 0x72eacea8, 0xfa6484bb, 0x8d6612ae, 0xbf3c6f47, + 0xd29be463, 0x542f5d9e, 0xaec2771b, 0xf64e6370, 0x740e0d8d, 0xe75b1357, 0xf8721671, 0xaf537d5d, + 0x4040cb08, 0x4eb4e2cc, 0x34d2466a, 0x0115af84, 0xe1b00428, 0x95983a1d, 0x06b89fb4, 0xce6ea048, + 0x6f3f3b82, 0x3520ab82, 0x011a1d4b, 0x277227f8, 0x611560b1, 0xe7933fdc, 0xbb3a792b, 0x344525bd, + 0xa08839e1, 0x51ce794b, 0x2f32c9b7, 0xa01fbac9, 0xe01cc87e, 0xbcc7d1f6, 0xcf0111c3, 0xa1e8aac7, + 0x1a908749, 0xd44fbd9a, 0xd0dadecb, 0xd50ada38, 0x0339c32a, 0xc6913667, 0x8df9317c, 0xe0b12b4f, + 0xf79e59b7, 0x43f5bb3a, 0xf2d519ff, 0x27d9459c, 0xbf97222c, 0x15e6fc2a, 0x0f91fc71, 0x9b941525, + 0xfae59361, 0xceb69ceb, 0xc2a86459, 0x12baa8d1, 0xb6c1075e, 0xe3056a0c, 0x10d25065, 0xcb03a442, + 0xe0ec6e0e, 0x1698db3b, 0x4c98a0be, 0x3278e964, 0x9f1f9532, 0xe0d392df, 0xd3a0342b, 0x8971f21e, + 0x1b0a7441, 0x4ba3348c, 0xc5be7120, 0xc37632d8, 0xdf359f8d, 0x9b992f2e, 0xe60b6f47, 0x0fe3f11d, + 0xe54cda54, 0x1edad891, 0xce6279cf, 0xcd3e7e6f, 0x1618b166, 0xfd2c1d05, 0x848fd2c5, 0xf6fb2299, + 0xf523f357, 0xa6327623, 0x93a83531, 0x56cccd02, 0xacf08162, 0x5a75ebb5, 0x6e163697, 0x88d273cc, + 0xde966292, 0x81b949d0, 0x4c50901b, 0x71c65614, 0xe6c6c7bd, 0x327a140a, 0x45e1d006, 0xc3f27b9a, + 0xc9aa53fd, 0x62a80f00, 0xbb25bfe2, 0x35bdd2f6, 0x71126905, 0xb2040222, 0xb6cbcf7c, 0xcd769c2b, + 0x53113ec0, 0x1640e3d3, 0x38abbd60, 0x2547adf0, 0xba38209c, 0xf746ce76, 0x77afa1c5, 0x20756060, + 0x85cbfe4e, 0x8ae88dd8, 0x7aaaf9b0, 0x4cf9aa7e, 0x1948c25c, 0x02fb8a8c, 0x01c36ae4, 0xd6ebe1f9, + 0x90d4f869, 0xa65cdea0, 0x3f09252d, 0xc208e69f, 0xb74e6132, 0xce77e25b, 0x578fdfe3, 0x3ac372e6 + ); + + /** + * P-Array consists of 18 32-bit subkeys + * + * @var array + * @access private + */ + var $parray = array( + 0x243f6a88, 0x85a308d3, 0x13198a2e, 0x03707344, 0xa4093822, 0x299f31d0, + 0x082efa98, 0xec4e6c89, 0x452821e6, 0x38d01377, 0xbe5466cf, 0x34e90c6c, + 0xc0ac29b7, 0xc97c50dd, 0x3f84d5b5, 0xb5470917, 0x9216d5d9, 0x8979fb1b + ); + + /** + * The BCTX-working Array + * + * Holds the expanded key [p] and the key-depended s-boxes [sb] + * + * @var array + * @access private + */ + var $bctx; + + /** + * Holds the last used key + * + * @var array + * @access private + */ + var $kl; + + /** + * The Key Length (in bytes) + * + * @see \phpseclib\Crypt\Base::setKeyLength() + * @var int + * @access private + * @internal The max value is 256 / 8 = 32, the min value is 128 / 8 = 16. Exists in conjunction with $Nk + * because the encryption / decryption / key schedule creation requires this number and not $key_length. We could + * derive this from $key_length or vice versa, but that'd mean we'd have to do multiple shift operations, so in lieu + * of that, we'll just precompute it once. + */ + var $key_length = 16; + + /** + * Sets the key length. + * + * Key lengths can be between 32 and 448 bits. + * + * @access public + * @param int $length + */ + function setKeyLength($length) + { + if ($length < 32) { + $this->key_length = 4; + } elseif ($length > 448) { + $this->key_length = 56; + } else { + $this->key_length = $length >> 3; + } + + parent::setKeyLength($length); + } + + /** + * Test for engine validity + * + * This is mainly just a wrapper to set things up for \phpseclib\Crypt\Base::isValidEngine() + * + * @see \phpseclib\Crypt\Base::isValidEngine() + * @param int $engine + * @access public + * @return bool + */ + function isValidEngine($engine) + { + if ($engine == self::ENGINE_OPENSSL) { + if (version_compare(PHP_VERSION, '5.3.7') < 0 && $this->key_length != 16) { + return false; + } + if ($this->key_length < 16) { + return false; + } + $this->cipher_name_openssl_ecb = 'bf-ecb'; + $this->cipher_name_openssl = 'bf-' . $this->_openssl_translate_mode(); + } + + return parent::isValidEngine($engine); + } + + /** + * Setup the key (expansion) + * + * @see \phpseclib\Crypt\Base::_setupKey() + * @access private + */ + function _setupKey() + { + if (isset($this->kl['key']) && $this->key === $this->kl['key']) { + // already expanded + return; + } + $this->kl = array('key' => $this->key); + + /* key-expanding p[] and S-Box building sb[] */ + $this->bctx = array( + 'p' => array(), + 'sb' => array( + $this->sbox0, + $this->sbox1, + $this->sbox2, + $this->sbox3 + ) + ); + + // unpack binary string in unsigned chars + $key = array_values(unpack('C*', $this->key)); + $keyl = count($key); + for ($j = 0, $i = 0; $i < 18; ++$i) { + // xor P1 with the first 32-bits of the key, xor P2 with the second 32-bits ... + for ($data = 0, $k = 0; $k < 4; ++$k) { + $data = ($data << 8) | $key[$j]; + if (++$j >= $keyl) { + $j = 0; + } + } + $this->bctx['p'][] = $this->parray[$i] ^ $data; + } + + // encrypt the zero-string, replace P1 and P2 with the encrypted data, + // encrypt P3 and P4 with the new P1 and P2, do it with all P-array and subkeys + $data = "\0\0\0\0\0\0\0\0"; + for ($i = 0; $i < 18; $i += 2) { + list($l, $r) = array_values(unpack('N*', $data = $this->_encryptBlock($data))); + $this->bctx['p'][$i ] = $l; + $this->bctx['p'][$i + 1] = $r; + } + for ($i = 0; $i < 4; ++$i) { + for ($j = 0; $j < 256; $j += 2) { + list($l, $r) = array_values(unpack('N*', $data = $this->_encryptBlock($data))); + $this->bctx['sb'][$i][$j ] = $l; + $this->bctx['sb'][$i][$j + 1] = $r; + } + } + } + + /** + * Encrypts a block + * + * @access private + * @param string $in + * @return string + */ + function _encryptBlock($in) + { + $p = $this->bctx["p"]; + // extract($this->bctx["sb"], EXTR_PREFIX_ALL, "sb"); // slower + $sb_0 = $this->bctx["sb"][0]; + $sb_1 = $this->bctx["sb"][1]; + $sb_2 = $this->bctx["sb"][2]; + $sb_3 = $this->bctx["sb"][3]; + + $in = unpack("N*", $in); + $l = $in[1]; + $r = $in[2]; + + for ($i = 0; $i < 16; $i+= 2) { + $l^= $p[$i]; + $r^= $this->safe_intval(($this->safe_intval($sb_0[$l >> 24 & 0xff] + $sb_1[$l >> 16 & 0xff]) ^ + $sb_2[$l >> 8 & 0xff]) + + $sb_3[$l & 0xff]); + + $r^= $p[$i + 1]; + $l^= $this->safe_intval(($this->safe_intval($sb_0[$r >> 24 & 0xff] + $sb_1[$r >> 16 & 0xff]) ^ + $sb_2[$r >> 8 & 0xff]) + + $sb_3[$r & 0xff]); + } + return pack("N*", $r ^ $p[17], $l ^ $p[16]); + } + + /** + * Decrypts a block + * + * @access private + * @param string $in + * @return string + */ + function _decryptBlock($in) + { + $p = $this->bctx["p"]; + $sb_0 = $this->bctx["sb"][0]; + $sb_1 = $this->bctx["sb"][1]; + $sb_2 = $this->bctx["sb"][2]; + $sb_3 = $this->bctx["sb"][3]; + + $in = unpack("N*", $in); + $l = $in[1]; + $r = $in[2]; + + for ($i = 17; $i > 2; $i-= 2) { + $l^= $p[$i]; + $r^= $this->safe_intval(($this->safe_intval($sb_0[$l >> 24 & 0xff] + $sb_1[$l >> 16 & 0xff]) ^ + $sb_2[$l >> 8 & 0xff]) + + $sb_3[$l & 0xff]); + + $r^= $p[$i - 1]; + $l^= $this->safe_intval(($this->safe_intval($sb_0[$r >> 24 & 0xff] + $sb_1[$r >> 16 & 0xff]) ^ + $sb_2[$r >> 8 & 0xff]) + + $sb_3[$r & 0xff]); + } + return pack("N*", $r ^ $p[0], $l ^ $p[1]); + } + + /** + * Setup the performance-optimized function for de/encrypt() + * + * @see \phpseclib\Crypt\Base::_setupInlineCrypt() + * @access private + */ + function _setupInlineCrypt() + { + $lambda_functions =& self::_getLambdaFunctions(); + + // We create max. 10 hi-optimized code for memory reason. Means: For each $key one ultra fast inline-crypt function. + // (Currently, for Blowfish, one generated $lambda_function cost on php5.5@32bit ~100kb unfreeable mem and ~180kb on php5.5@64bit) + // After that, we'll still create very fast optimized code but not the hi-ultimative code, for each $mode one. + $gen_hi_opt_code = (bool)(count($lambda_functions) < 10); + + // Generation of a unique hash for our generated code + $code_hash = "Crypt_Blowfish, {$this->mode}"; + if ($gen_hi_opt_code) { + $code_hash = str_pad($code_hash, 32) . $this->_hashInlineCryptFunction($this->key); + } + + $safeint = $this->safe_intval_inline(); + + if (!isset($lambda_functions[$code_hash])) { + switch (true) { + case $gen_hi_opt_code: + $p = $this->bctx['p']; + $init_crypt = ' + static $sb_0, $sb_1, $sb_2, $sb_3; + if (!$sb_0) { + $sb_0 = $self->bctx["sb"][0]; + $sb_1 = $self->bctx["sb"][1]; + $sb_2 = $self->bctx["sb"][2]; + $sb_3 = $self->bctx["sb"][3]; + } + '; + break; + default: + $p = array(); + for ($i = 0; $i < 18; ++$i) { + $p[] = '$p_' . $i; + } + $init_crypt = ' + list($sb_0, $sb_1, $sb_2, $sb_3) = $self->bctx["sb"]; + list(' . implode(',', $p) . ') = $self->bctx["p"]; + + '; + } + + // Generating encrypt code: + $encrypt_block = ' + $in = unpack("N*", $in); + $l = $in[1]; + $r = $in[2]; + '; + for ($i = 0; $i < 16; $i+= 2) { + $encrypt_block.= ' + $l^= ' . $p[$i] . '; + $r^= ' . sprintf($safeint, '(' . sprintf($safeint, '$sb_0[$l >> 24 & 0xff] + $sb_1[$l >> 16 & 0xff]') . ' ^ + $sb_2[$l >> 8 & 0xff]) + + $sb_3[$l & 0xff]') . '; + + $r^= ' . $p[$i + 1] . '; + $l^= ' . sprintf($safeint, '(' . sprintf($safeint, '$sb_0[$r >> 24 & 0xff] + $sb_1[$r >> 16 & 0xff]') . ' ^ + $sb_2[$r >> 8 & 0xff]) + + $sb_3[$r & 0xff]') . '; + '; + } + $encrypt_block.= ' + $in = pack("N*", + $r ^ ' . $p[17] . ', + $l ^ ' . $p[16] . ' + ); + '; + + // Generating decrypt code: + $decrypt_block = ' + $in = unpack("N*", $in); + $l = $in[1]; + $r = $in[2]; + '; + + for ($i = 17; $i > 2; $i-= 2) { + $decrypt_block.= ' + $l^= ' . $p[$i] . '; + $r^= ' . sprintf($safeint, '(' . sprintf($safeint, '$sb_0[$l >> 24 & 0xff] + $sb_1[$l >> 16 & 0xff]') . ' ^ + $sb_2[$l >> 8 & 0xff]) + + $sb_3[$l & 0xff]') . '; + + $r^= ' . $p[$i - 1] . '; + $l^= ' . sprintf($safeint, '(' . sprintf($safeint, '$sb_0[$r >> 24 & 0xff] + $sb_1[$r >> 16 & 0xff]') . ' ^ + $sb_2[$r >> 8 & 0xff]) + + $sb_3[$r & 0xff]') . '; + '; + } + + $decrypt_block.= ' + $in = pack("N*", + $r ^ ' . $p[0] . ', + $l ^ ' . $p[1] . ' + ); + '; + + $lambda_functions[$code_hash] = $this->_createInlineCryptFunction( + array( + 'init_crypt' => $init_crypt, + 'init_encrypt' => '', + 'init_decrypt' => '', + 'encrypt_block' => $encrypt_block, + 'decrypt_block' => $decrypt_block + ) + ); + } + $this->inline_crypt = $lambda_functions[$code_hash]; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/DES.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/DES.php new file mode 100644 index 0000000..9a8225f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/DES.php @@ -0,0 +1,1443 @@ + + * setKey('abcdefgh'); + * + * $size = 10 * 1024; + * $plaintext = ''; + * for ($i = 0; $i < $size; $i++) { + * $plaintext.= 'a'; + * } + * + * echo $des->decrypt($des->encrypt($plaintext)); + * ?> + * + * + * @category Crypt + * @package DES + * @author Jim Wigginton + * @copyright 2007 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP implementation of DES. + * + * @package DES + * @author Jim Wigginton + * @access public + */ +class DES extends Base +{ + /**#@+ + * @access private + * @see \phpseclib\Crypt\DES::_setupKey() + * @see \phpseclib\Crypt\DES::_processBlock() + */ + /** + * Contains $keys[self::ENCRYPT] + */ + const ENCRYPT = 0; + /** + * Contains $keys[self::DECRYPT] + */ + const DECRYPT = 1; + /**#@-*/ + + /** + * Block Length of the cipher + * + * @see \phpseclib\Crypt\Base::block_size + * @var int + * @access private + */ + var $block_size = 8; + + /** + * Key Length (in bytes) + * + * @see \phpseclib\Crypt\Base::setKeyLength() + * @var int + * @access private + */ + var $key_length = 8; + + /** + * The mcrypt specific name of the cipher + * + * @see \phpseclib\Crypt\Base::cipher_name_mcrypt + * @var string + * @access private + */ + var $cipher_name_mcrypt = 'des'; + + /** + * The OpenSSL names of the cipher / modes + * + * @see \phpseclib\Crypt\Base::openssl_mode_names + * @var array + * @access private + */ + var $openssl_mode_names = array( + self::MODE_ECB => 'des-ecb', + self::MODE_CBC => 'des-cbc', + self::MODE_CFB => 'des-cfb', + self::MODE_OFB => 'des-ofb' + // self::MODE_CTR is undefined for DES + ); + + /** + * Optimizing value while CFB-encrypting + * + * @see \phpseclib\Crypt\Base::cfb_init_len + * @var int + * @access private + */ + var $cfb_init_len = 500; + + /** + * Switch for DES/3DES encryption + * + * Used only if $engine == self::ENGINE_INTERNAL + * + * @see self::_setupKey() + * @see self::_processBlock() + * @var int + * @access private + */ + var $des_rounds = 1; + + /** + * max possible size of $key + * + * @see self::setKey() + * @var string + * @access private + */ + var $key_length_max = 8; + + /** + * The Key Schedule + * + * @see self::_setupKey() + * @var array + * @access private + */ + var $keys; + + /** + * Shuffle table. + * + * For each byte value index, the entry holds an 8-byte string + * with each byte containing all bits in the same state as the + * corresponding bit in the index value. + * + * @see self::_processBlock() + * @see self::_setupKey() + * @var array + * @access private + */ + var $shuffle = array( + "\x00\x00\x00\x00\x00\x00\x00\x00", "\x00\x00\x00\x00\x00\x00\x00\xFF", + "\x00\x00\x00\x00\x00\x00\xFF\x00", "\x00\x00\x00\x00\x00\x00\xFF\xFF", + "\x00\x00\x00\x00\x00\xFF\x00\x00", "\x00\x00\x00\x00\x00\xFF\x00\xFF", + "\x00\x00\x00\x00\x00\xFF\xFF\x00", "\x00\x00\x00\x00\x00\xFF\xFF\xFF", + "\x00\x00\x00\x00\xFF\x00\x00\x00", "\x00\x00\x00\x00\xFF\x00\x00\xFF", + "\x00\x00\x00\x00\xFF\x00\xFF\x00", "\x00\x00\x00\x00\xFF\x00\xFF\xFF", + "\x00\x00\x00\x00\xFF\xFF\x00\x00", "\x00\x00\x00\x00\xFF\xFF\x00\xFF", + "\x00\x00\x00\x00\xFF\xFF\xFF\x00", "\x00\x00\x00\x00\xFF\xFF\xFF\xFF", + "\x00\x00\x00\xFF\x00\x00\x00\x00", "\x00\x00\x00\xFF\x00\x00\x00\xFF", + "\x00\x00\x00\xFF\x00\x00\xFF\x00", "\x00\x00\x00\xFF\x00\x00\xFF\xFF", + "\x00\x00\x00\xFF\x00\xFF\x00\x00", "\x00\x00\x00\xFF\x00\xFF\x00\xFF", + "\x00\x00\x00\xFF\x00\xFF\xFF\x00", "\x00\x00\x00\xFF\x00\xFF\xFF\xFF", + "\x00\x00\x00\xFF\xFF\x00\x00\x00", "\x00\x00\x00\xFF\xFF\x00\x00\xFF", + "\x00\x00\x00\xFF\xFF\x00\xFF\x00", "\x00\x00\x00\xFF\xFF\x00\xFF\xFF", + "\x00\x00\x00\xFF\xFF\xFF\x00\x00", "\x00\x00\x00\xFF\xFF\xFF\x00\xFF", + "\x00\x00\x00\xFF\xFF\xFF\xFF\x00", "\x00\x00\x00\xFF\xFF\xFF\xFF\xFF", + "\x00\x00\xFF\x00\x00\x00\x00\x00", "\x00\x00\xFF\x00\x00\x00\x00\xFF", + "\x00\x00\xFF\x00\x00\x00\xFF\x00", "\x00\x00\xFF\x00\x00\x00\xFF\xFF", + "\x00\x00\xFF\x00\x00\xFF\x00\x00", "\x00\x00\xFF\x00\x00\xFF\x00\xFF", + "\x00\x00\xFF\x00\x00\xFF\xFF\x00", "\x00\x00\xFF\x00\x00\xFF\xFF\xFF", + "\x00\x00\xFF\x00\xFF\x00\x00\x00", "\x00\x00\xFF\x00\xFF\x00\x00\xFF", + "\x00\x00\xFF\x00\xFF\x00\xFF\x00", "\x00\x00\xFF\x00\xFF\x00\xFF\xFF", + "\x00\x00\xFF\x00\xFF\xFF\x00\x00", "\x00\x00\xFF\x00\xFF\xFF\x00\xFF", + "\x00\x00\xFF\x00\xFF\xFF\xFF\x00", "\x00\x00\xFF\x00\xFF\xFF\xFF\xFF", + "\x00\x00\xFF\xFF\x00\x00\x00\x00", "\x00\x00\xFF\xFF\x00\x00\x00\xFF", + "\x00\x00\xFF\xFF\x00\x00\xFF\x00", "\x00\x00\xFF\xFF\x00\x00\xFF\xFF", + "\x00\x00\xFF\xFF\x00\xFF\x00\x00", "\x00\x00\xFF\xFF\x00\xFF\x00\xFF", + "\x00\x00\xFF\xFF\x00\xFF\xFF\x00", "\x00\x00\xFF\xFF\x00\xFF\xFF\xFF", + "\x00\x00\xFF\xFF\xFF\x00\x00\x00", "\x00\x00\xFF\xFF\xFF\x00\x00\xFF", + "\x00\x00\xFF\xFF\xFF\x00\xFF\x00", "\x00\x00\xFF\xFF\xFF\x00\xFF\xFF", + "\x00\x00\xFF\xFF\xFF\xFF\x00\x00", "\x00\x00\xFF\xFF\xFF\xFF\x00\xFF", + "\x00\x00\xFF\xFF\xFF\xFF\xFF\x00", "\x00\x00\xFF\xFF\xFF\xFF\xFF\xFF", + "\x00\xFF\x00\x00\x00\x00\x00\x00", "\x00\xFF\x00\x00\x00\x00\x00\xFF", + "\x00\xFF\x00\x00\x00\x00\xFF\x00", "\x00\xFF\x00\x00\x00\x00\xFF\xFF", + "\x00\xFF\x00\x00\x00\xFF\x00\x00", "\x00\xFF\x00\x00\x00\xFF\x00\xFF", + "\x00\xFF\x00\x00\x00\xFF\xFF\x00", "\x00\xFF\x00\x00\x00\xFF\xFF\xFF", + "\x00\xFF\x00\x00\xFF\x00\x00\x00", "\x00\xFF\x00\x00\xFF\x00\x00\xFF", + "\x00\xFF\x00\x00\xFF\x00\xFF\x00", "\x00\xFF\x00\x00\xFF\x00\xFF\xFF", + "\x00\xFF\x00\x00\xFF\xFF\x00\x00", "\x00\xFF\x00\x00\xFF\xFF\x00\xFF", + "\x00\xFF\x00\x00\xFF\xFF\xFF\x00", "\x00\xFF\x00\x00\xFF\xFF\xFF\xFF", + "\x00\xFF\x00\xFF\x00\x00\x00\x00", "\x00\xFF\x00\xFF\x00\x00\x00\xFF", + "\x00\xFF\x00\xFF\x00\x00\xFF\x00", "\x00\xFF\x00\xFF\x00\x00\xFF\xFF", + "\x00\xFF\x00\xFF\x00\xFF\x00\x00", "\x00\xFF\x00\xFF\x00\xFF\x00\xFF", + "\x00\xFF\x00\xFF\x00\xFF\xFF\x00", "\x00\xFF\x00\xFF\x00\xFF\xFF\xFF", + "\x00\xFF\x00\xFF\xFF\x00\x00\x00", "\x00\xFF\x00\xFF\xFF\x00\x00\xFF", + "\x00\xFF\x00\xFF\xFF\x00\xFF\x00", "\x00\xFF\x00\xFF\xFF\x00\xFF\xFF", + "\x00\xFF\x00\xFF\xFF\xFF\x00\x00", "\x00\xFF\x00\xFF\xFF\xFF\x00\xFF", + "\x00\xFF\x00\xFF\xFF\xFF\xFF\x00", "\x00\xFF\x00\xFF\xFF\xFF\xFF\xFF", + "\x00\xFF\xFF\x00\x00\x00\x00\x00", "\x00\xFF\xFF\x00\x00\x00\x00\xFF", + "\x00\xFF\xFF\x00\x00\x00\xFF\x00", "\x00\xFF\xFF\x00\x00\x00\xFF\xFF", + "\x00\xFF\xFF\x00\x00\xFF\x00\x00", "\x00\xFF\xFF\x00\x00\xFF\x00\xFF", + "\x00\xFF\xFF\x00\x00\xFF\xFF\x00", "\x00\xFF\xFF\x00\x00\xFF\xFF\xFF", + "\x00\xFF\xFF\x00\xFF\x00\x00\x00", "\x00\xFF\xFF\x00\xFF\x00\x00\xFF", + "\x00\xFF\xFF\x00\xFF\x00\xFF\x00", "\x00\xFF\xFF\x00\xFF\x00\xFF\xFF", + "\x00\xFF\xFF\x00\xFF\xFF\x00\x00", "\x00\xFF\xFF\x00\xFF\xFF\x00\xFF", + "\x00\xFF\xFF\x00\xFF\xFF\xFF\x00", "\x00\xFF\xFF\x00\xFF\xFF\xFF\xFF", + "\x00\xFF\xFF\xFF\x00\x00\x00\x00", "\x00\xFF\xFF\xFF\x00\x00\x00\xFF", + "\x00\xFF\xFF\xFF\x00\x00\xFF\x00", "\x00\xFF\xFF\xFF\x00\x00\xFF\xFF", + "\x00\xFF\xFF\xFF\x00\xFF\x00\x00", "\x00\xFF\xFF\xFF\x00\xFF\x00\xFF", + "\x00\xFF\xFF\xFF\x00\xFF\xFF\x00", "\x00\xFF\xFF\xFF\x00\xFF\xFF\xFF", + "\x00\xFF\xFF\xFF\xFF\x00\x00\x00", "\x00\xFF\xFF\xFF\xFF\x00\x00\xFF", + "\x00\xFF\xFF\xFF\xFF\x00\xFF\x00", "\x00\xFF\xFF\xFF\xFF\x00\xFF\xFF", + "\x00\xFF\xFF\xFF\xFF\xFF\x00\x00", "\x00\xFF\xFF\xFF\xFF\xFF\x00\xFF", + "\x00\xFF\xFF\xFF\xFF\xFF\xFF\x00", "\x00\xFF\xFF\xFF\xFF\xFF\xFF\xFF", + "\xFF\x00\x00\x00\x00\x00\x00\x00", "\xFF\x00\x00\x00\x00\x00\x00\xFF", + "\xFF\x00\x00\x00\x00\x00\xFF\x00", "\xFF\x00\x00\x00\x00\x00\xFF\xFF", + "\xFF\x00\x00\x00\x00\xFF\x00\x00", "\xFF\x00\x00\x00\x00\xFF\x00\xFF", + "\xFF\x00\x00\x00\x00\xFF\xFF\x00", "\xFF\x00\x00\x00\x00\xFF\xFF\xFF", + "\xFF\x00\x00\x00\xFF\x00\x00\x00", "\xFF\x00\x00\x00\xFF\x00\x00\xFF", + "\xFF\x00\x00\x00\xFF\x00\xFF\x00", "\xFF\x00\x00\x00\xFF\x00\xFF\xFF", + "\xFF\x00\x00\x00\xFF\xFF\x00\x00", "\xFF\x00\x00\x00\xFF\xFF\x00\xFF", + "\xFF\x00\x00\x00\xFF\xFF\xFF\x00", "\xFF\x00\x00\x00\xFF\xFF\xFF\xFF", + "\xFF\x00\x00\xFF\x00\x00\x00\x00", "\xFF\x00\x00\xFF\x00\x00\x00\xFF", + "\xFF\x00\x00\xFF\x00\x00\xFF\x00", "\xFF\x00\x00\xFF\x00\x00\xFF\xFF", + "\xFF\x00\x00\xFF\x00\xFF\x00\x00", "\xFF\x00\x00\xFF\x00\xFF\x00\xFF", + "\xFF\x00\x00\xFF\x00\xFF\xFF\x00", "\xFF\x00\x00\xFF\x00\xFF\xFF\xFF", + "\xFF\x00\x00\xFF\xFF\x00\x00\x00", "\xFF\x00\x00\xFF\xFF\x00\x00\xFF", + "\xFF\x00\x00\xFF\xFF\x00\xFF\x00", "\xFF\x00\x00\xFF\xFF\x00\xFF\xFF", + "\xFF\x00\x00\xFF\xFF\xFF\x00\x00", "\xFF\x00\x00\xFF\xFF\xFF\x00\xFF", + "\xFF\x00\x00\xFF\xFF\xFF\xFF\x00", "\xFF\x00\x00\xFF\xFF\xFF\xFF\xFF", + "\xFF\x00\xFF\x00\x00\x00\x00\x00", "\xFF\x00\xFF\x00\x00\x00\x00\xFF", + "\xFF\x00\xFF\x00\x00\x00\xFF\x00", "\xFF\x00\xFF\x00\x00\x00\xFF\xFF", + "\xFF\x00\xFF\x00\x00\xFF\x00\x00", "\xFF\x00\xFF\x00\x00\xFF\x00\xFF", + "\xFF\x00\xFF\x00\x00\xFF\xFF\x00", "\xFF\x00\xFF\x00\x00\xFF\xFF\xFF", + "\xFF\x00\xFF\x00\xFF\x00\x00\x00", "\xFF\x00\xFF\x00\xFF\x00\x00\xFF", + "\xFF\x00\xFF\x00\xFF\x00\xFF\x00", "\xFF\x00\xFF\x00\xFF\x00\xFF\xFF", + "\xFF\x00\xFF\x00\xFF\xFF\x00\x00", "\xFF\x00\xFF\x00\xFF\xFF\x00\xFF", + "\xFF\x00\xFF\x00\xFF\xFF\xFF\x00", "\xFF\x00\xFF\x00\xFF\xFF\xFF\xFF", + "\xFF\x00\xFF\xFF\x00\x00\x00\x00", "\xFF\x00\xFF\xFF\x00\x00\x00\xFF", + "\xFF\x00\xFF\xFF\x00\x00\xFF\x00", "\xFF\x00\xFF\xFF\x00\x00\xFF\xFF", + "\xFF\x00\xFF\xFF\x00\xFF\x00\x00", "\xFF\x00\xFF\xFF\x00\xFF\x00\xFF", + "\xFF\x00\xFF\xFF\x00\xFF\xFF\x00", "\xFF\x00\xFF\xFF\x00\xFF\xFF\xFF", + "\xFF\x00\xFF\xFF\xFF\x00\x00\x00", "\xFF\x00\xFF\xFF\xFF\x00\x00\xFF", + "\xFF\x00\xFF\xFF\xFF\x00\xFF\x00", "\xFF\x00\xFF\xFF\xFF\x00\xFF\xFF", + "\xFF\x00\xFF\xFF\xFF\xFF\x00\x00", "\xFF\x00\xFF\xFF\xFF\xFF\x00\xFF", + "\xFF\x00\xFF\xFF\xFF\xFF\xFF\x00", "\xFF\x00\xFF\xFF\xFF\xFF\xFF\xFF", + "\xFF\xFF\x00\x00\x00\x00\x00\x00", "\xFF\xFF\x00\x00\x00\x00\x00\xFF", + "\xFF\xFF\x00\x00\x00\x00\xFF\x00", "\xFF\xFF\x00\x00\x00\x00\xFF\xFF", + "\xFF\xFF\x00\x00\x00\xFF\x00\x00", "\xFF\xFF\x00\x00\x00\xFF\x00\xFF", + "\xFF\xFF\x00\x00\x00\xFF\xFF\x00", "\xFF\xFF\x00\x00\x00\xFF\xFF\xFF", + "\xFF\xFF\x00\x00\xFF\x00\x00\x00", "\xFF\xFF\x00\x00\xFF\x00\x00\xFF", + "\xFF\xFF\x00\x00\xFF\x00\xFF\x00", "\xFF\xFF\x00\x00\xFF\x00\xFF\xFF", + "\xFF\xFF\x00\x00\xFF\xFF\x00\x00", "\xFF\xFF\x00\x00\xFF\xFF\x00\xFF", + "\xFF\xFF\x00\x00\xFF\xFF\xFF\x00", "\xFF\xFF\x00\x00\xFF\xFF\xFF\xFF", + "\xFF\xFF\x00\xFF\x00\x00\x00\x00", "\xFF\xFF\x00\xFF\x00\x00\x00\xFF", + "\xFF\xFF\x00\xFF\x00\x00\xFF\x00", "\xFF\xFF\x00\xFF\x00\x00\xFF\xFF", + "\xFF\xFF\x00\xFF\x00\xFF\x00\x00", "\xFF\xFF\x00\xFF\x00\xFF\x00\xFF", + "\xFF\xFF\x00\xFF\x00\xFF\xFF\x00", "\xFF\xFF\x00\xFF\x00\xFF\xFF\xFF", + "\xFF\xFF\x00\xFF\xFF\x00\x00\x00", "\xFF\xFF\x00\xFF\xFF\x00\x00\xFF", + "\xFF\xFF\x00\xFF\xFF\x00\xFF\x00", "\xFF\xFF\x00\xFF\xFF\x00\xFF\xFF", + "\xFF\xFF\x00\xFF\xFF\xFF\x00\x00", "\xFF\xFF\x00\xFF\xFF\xFF\x00\xFF", + "\xFF\xFF\x00\xFF\xFF\xFF\xFF\x00", "\xFF\xFF\x00\xFF\xFF\xFF\xFF\xFF", + "\xFF\xFF\xFF\x00\x00\x00\x00\x00", "\xFF\xFF\xFF\x00\x00\x00\x00\xFF", + "\xFF\xFF\xFF\x00\x00\x00\xFF\x00", "\xFF\xFF\xFF\x00\x00\x00\xFF\xFF", + "\xFF\xFF\xFF\x00\x00\xFF\x00\x00", "\xFF\xFF\xFF\x00\x00\xFF\x00\xFF", + "\xFF\xFF\xFF\x00\x00\xFF\xFF\x00", "\xFF\xFF\xFF\x00\x00\xFF\xFF\xFF", + "\xFF\xFF\xFF\x00\xFF\x00\x00\x00", "\xFF\xFF\xFF\x00\xFF\x00\x00\xFF", + "\xFF\xFF\xFF\x00\xFF\x00\xFF\x00", "\xFF\xFF\xFF\x00\xFF\x00\xFF\xFF", + "\xFF\xFF\xFF\x00\xFF\xFF\x00\x00", "\xFF\xFF\xFF\x00\xFF\xFF\x00\xFF", + "\xFF\xFF\xFF\x00\xFF\xFF\xFF\x00", "\xFF\xFF\xFF\x00\xFF\xFF\xFF\xFF", + "\xFF\xFF\xFF\xFF\x00\x00\x00\x00", "\xFF\xFF\xFF\xFF\x00\x00\x00\xFF", + "\xFF\xFF\xFF\xFF\x00\x00\xFF\x00", "\xFF\xFF\xFF\xFF\x00\x00\xFF\xFF", + "\xFF\xFF\xFF\xFF\x00\xFF\x00\x00", "\xFF\xFF\xFF\xFF\x00\xFF\x00\xFF", + "\xFF\xFF\xFF\xFF\x00\xFF\xFF\x00", "\xFF\xFF\xFF\xFF\x00\xFF\xFF\xFF", + "\xFF\xFF\xFF\xFF\xFF\x00\x00\x00", "\xFF\xFF\xFF\xFF\xFF\x00\x00\xFF", + "\xFF\xFF\xFF\xFF\xFF\x00\xFF\x00", "\xFF\xFF\xFF\xFF\xFF\x00\xFF\xFF", + "\xFF\xFF\xFF\xFF\xFF\xFF\x00\x00", "\xFF\xFF\xFF\xFF\xFF\xFF\x00\xFF", + "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\x00", "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF" + ); + + /** + * IP mapping helper table. + * + * Indexing this table with each source byte performs the initial bit permutation. + * + * @var array + * @access private + */ + var $ipmap = array( + 0x00, 0x10, 0x01, 0x11, 0x20, 0x30, 0x21, 0x31, + 0x02, 0x12, 0x03, 0x13, 0x22, 0x32, 0x23, 0x33, + 0x40, 0x50, 0x41, 0x51, 0x60, 0x70, 0x61, 0x71, + 0x42, 0x52, 0x43, 0x53, 0x62, 0x72, 0x63, 0x73, + 0x04, 0x14, 0x05, 0x15, 0x24, 0x34, 0x25, 0x35, + 0x06, 0x16, 0x07, 0x17, 0x26, 0x36, 0x27, 0x37, + 0x44, 0x54, 0x45, 0x55, 0x64, 0x74, 0x65, 0x75, + 0x46, 0x56, 0x47, 0x57, 0x66, 0x76, 0x67, 0x77, + 0x80, 0x90, 0x81, 0x91, 0xA0, 0xB0, 0xA1, 0xB1, + 0x82, 0x92, 0x83, 0x93, 0xA2, 0xB2, 0xA3, 0xB3, + 0xC0, 0xD0, 0xC1, 0xD1, 0xE0, 0xF0, 0xE1, 0xF1, + 0xC2, 0xD2, 0xC3, 0xD3, 0xE2, 0xF2, 0xE3, 0xF3, + 0x84, 0x94, 0x85, 0x95, 0xA4, 0xB4, 0xA5, 0xB5, + 0x86, 0x96, 0x87, 0x97, 0xA6, 0xB6, 0xA7, 0xB7, + 0xC4, 0xD4, 0xC5, 0xD5, 0xE4, 0xF4, 0xE5, 0xF5, + 0xC6, 0xD6, 0xC7, 0xD7, 0xE6, 0xF6, 0xE7, 0xF7, + 0x08, 0x18, 0x09, 0x19, 0x28, 0x38, 0x29, 0x39, + 0x0A, 0x1A, 0x0B, 0x1B, 0x2A, 0x3A, 0x2B, 0x3B, + 0x48, 0x58, 0x49, 0x59, 0x68, 0x78, 0x69, 0x79, + 0x4A, 0x5A, 0x4B, 0x5B, 0x6A, 0x7A, 0x6B, 0x7B, + 0x0C, 0x1C, 0x0D, 0x1D, 0x2C, 0x3C, 0x2D, 0x3D, + 0x0E, 0x1E, 0x0F, 0x1F, 0x2E, 0x3E, 0x2F, 0x3F, + 0x4C, 0x5C, 0x4D, 0x5D, 0x6C, 0x7C, 0x6D, 0x7D, + 0x4E, 0x5E, 0x4F, 0x5F, 0x6E, 0x7E, 0x6F, 0x7F, + 0x88, 0x98, 0x89, 0x99, 0xA8, 0xB8, 0xA9, 0xB9, + 0x8A, 0x9A, 0x8B, 0x9B, 0xAA, 0xBA, 0xAB, 0xBB, + 0xC8, 0xD8, 0xC9, 0xD9, 0xE8, 0xF8, 0xE9, 0xF9, + 0xCA, 0xDA, 0xCB, 0xDB, 0xEA, 0xFA, 0xEB, 0xFB, + 0x8C, 0x9C, 0x8D, 0x9D, 0xAC, 0xBC, 0xAD, 0xBD, + 0x8E, 0x9E, 0x8F, 0x9F, 0xAE, 0xBE, 0xAF, 0xBF, + 0xCC, 0xDC, 0xCD, 0xDD, 0xEC, 0xFC, 0xED, 0xFD, + 0xCE, 0xDE, 0xCF, 0xDF, 0xEE, 0xFE, 0xEF, 0xFF + ); + + /** + * Inverse IP mapping helper table. + * Indexing this table with a byte value reverses the bit order. + * + * @var array + * @access private + */ + var $invipmap = array( + 0x00, 0x80, 0x40, 0xC0, 0x20, 0xA0, 0x60, 0xE0, + 0x10, 0x90, 0x50, 0xD0, 0x30, 0xB0, 0x70, 0xF0, + 0x08, 0x88, 0x48, 0xC8, 0x28, 0xA8, 0x68, 0xE8, + 0x18, 0x98, 0x58, 0xD8, 0x38, 0xB8, 0x78, 0xF8, + 0x04, 0x84, 0x44, 0xC4, 0x24, 0xA4, 0x64, 0xE4, + 0x14, 0x94, 0x54, 0xD4, 0x34, 0xB4, 0x74, 0xF4, + 0x0C, 0x8C, 0x4C, 0xCC, 0x2C, 0xAC, 0x6C, 0xEC, + 0x1C, 0x9C, 0x5C, 0xDC, 0x3C, 0xBC, 0x7C, 0xFC, + 0x02, 0x82, 0x42, 0xC2, 0x22, 0xA2, 0x62, 0xE2, + 0x12, 0x92, 0x52, 0xD2, 0x32, 0xB2, 0x72, 0xF2, + 0x0A, 0x8A, 0x4A, 0xCA, 0x2A, 0xAA, 0x6A, 0xEA, + 0x1A, 0x9A, 0x5A, 0xDA, 0x3A, 0xBA, 0x7A, 0xFA, + 0x06, 0x86, 0x46, 0xC6, 0x26, 0xA6, 0x66, 0xE6, + 0x16, 0x96, 0x56, 0xD6, 0x36, 0xB6, 0x76, 0xF6, + 0x0E, 0x8E, 0x4E, 0xCE, 0x2E, 0xAE, 0x6E, 0xEE, + 0x1E, 0x9E, 0x5E, 0xDE, 0x3E, 0xBE, 0x7E, 0xFE, + 0x01, 0x81, 0x41, 0xC1, 0x21, 0xA1, 0x61, 0xE1, + 0x11, 0x91, 0x51, 0xD1, 0x31, 0xB1, 0x71, 0xF1, + 0x09, 0x89, 0x49, 0xC9, 0x29, 0xA9, 0x69, 0xE9, + 0x19, 0x99, 0x59, 0xD9, 0x39, 0xB9, 0x79, 0xF9, + 0x05, 0x85, 0x45, 0xC5, 0x25, 0xA5, 0x65, 0xE5, + 0x15, 0x95, 0x55, 0xD5, 0x35, 0xB5, 0x75, 0xF5, + 0x0D, 0x8D, 0x4D, 0xCD, 0x2D, 0xAD, 0x6D, 0xED, + 0x1D, 0x9D, 0x5D, 0xDD, 0x3D, 0xBD, 0x7D, 0xFD, + 0x03, 0x83, 0x43, 0xC3, 0x23, 0xA3, 0x63, 0xE3, + 0x13, 0x93, 0x53, 0xD3, 0x33, 0xB3, 0x73, 0xF3, + 0x0B, 0x8B, 0x4B, 0xCB, 0x2B, 0xAB, 0x6B, 0xEB, + 0x1B, 0x9B, 0x5B, 0xDB, 0x3B, 0xBB, 0x7B, 0xFB, + 0x07, 0x87, 0x47, 0xC7, 0x27, 0xA7, 0x67, 0xE7, + 0x17, 0x97, 0x57, 0xD7, 0x37, 0xB7, 0x77, 0xF7, + 0x0F, 0x8F, 0x4F, 0xCF, 0x2F, 0xAF, 0x6F, 0xEF, + 0x1F, 0x9F, 0x5F, 0xDF, 0x3F, 0xBF, 0x7F, 0xFF + ); + + /** + * Pre-permuted S-box1 + * + * Each box ($sbox1-$sbox8) has been vectorized, then each value pre-permuted using the + * P table: concatenation can then be replaced by exclusive ORs. + * + * @var array + * @access private + */ + var $sbox1 = array( + 0x00808200, 0x00000000, 0x00008000, 0x00808202, + 0x00808002, 0x00008202, 0x00000002, 0x00008000, + 0x00000200, 0x00808200, 0x00808202, 0x00000200, + 0x00800202, 0x00808002, 0x00800000, 0x00000002, + 0x00000202, 0x00800200, 0x00800200, 0x00008200, + 0x00008200, 0x00808000, 0x00808000, 0x00800202, + 0x00008002, 0x00800002, 0x00800002, 0x00008002, + 0x00000000, 0x00000202, 0x00008202, 0x00800000, + 0x00008000, 0x00808202, 0x00000002, 0x00808000, + 0x00808200, 0x00800000, 0x00800000, 0x00000200, + 0x00808002, 0x00008000, 0x00008200, 0x00800002, + 0x00000200, 0x00000002, 0x00800202, 0x00008202, + 0x00808202, 0x00008002, 0x00808000, 0x00800202, + 0x00800002, 0x00000202, 0x00008202, 0x00808200, + 0x00000202, 0x00800200, 0x00800200, 0x00000000, + 0x00008002, 0x00008200, 0x00000000, 0x00808002 + ); + + /** + * Pre-permuted S-box2 + * + * @var array + * @access private + */ + var $sbox2 = array( + 0x40084010, 0x40004000, 0x00004000, 0x00084010, + 0x00080000, 0x00000010, 0x40080010, 0x40004010, + 0x40000010, 0x40084010, 0x40084000, 0x40000000, + 0x40004000, 0x00080000, 0x00000010, 0x40080010, + 0x00084000, 0x00080010, 0x40004010, 0x00000000, + 0x40000000, 0x00004000, 0x00084010, 0x40080000, + 0x00080010, 0x40000010, 0x00000000, 0x00084000, + 0x00004010, 0x40084000, 0x40080000, 0x00004010, + 0x00000000, 0x00084010, 0x40080010, 0x00080000, + 0x40004010, 0x40080000, 0x40084000, 0x00004000, + 0x40080000, 0x40004000, 0x00000010, 0x40084010, + 0x00084010, 0x00000010, 0x00004000, 0x40000000, + 0x00004010, 0x40084000, 0x00080000, 0x40000010, + 0x00080010, 0x40004010, 0x40000010, 0x00080010, + 0x00084000, 0x00000000, 0x40004000, 0x00004010, + 0x40000000, 0x40080010, 0x40084010, 0x00084000 + ); + + /** + * Pre-permuted S-box3 + * + * @var array + * @access private + */ + var $sbox3 = array( + 0x00000104, 0x04010100, 0x00000000, 0x04010004, + 0x04000100, 0x00000000, 0x00010104, 0x04000100, + 0x00010004, 0x04000004, 0x04000004, 0x00010000, + 0x04010104, 0x00010004, 0x04010000, 0x00000104, + 0x04000000, 0x00000004, 0x04010100, 0x00000100, + 0x00010100, 0x04010000, 0x04010004, 0x00010104, + 0x04000104, 0x00010100, 0x00010000, 0x04000104, + 0x00000004, 0x04010104, 0x00000100, 0x04000000, + 0x04010100, 0x04000000, 0x00010004, 0x00000104, + 0x00010000, 0x04010100, 0x04000100, 0x00000000, + 0x00000100, 0x00010004, 0x04010104, 0x04000100, + 0x04000004, 0x00000100, 0x00000000, 0x04010004, + 0x04000104, 0x00010000, 0x04000000, 0x04010104, + 0x00000004, 0x00010104, 0x00010100, 0x04000004, + 0x04010000, 0x04000104, 0x00000104, 0x04010000, + 0x00010104, 0x00000004, 0x04010004, 0x00010100 + ); + + /** + * Pre-permuted S-box4 + * + * @var array + * @access private + */ + var $sbox4 = array( + 0x80401000, 0x80001040, 0x80001040, 0x00000040, + 0x00401040, 0x80400040, 0x80400000, 0x80001000, + 0x00000000, 0x00401000, 0x00401000, 0x80401040, + 0x80000040, 0x00000000, 0x00400040, 0x80400000, + 0x80000000, 0x00001000, 0x00400000, 0x80401000, + 0x00000040, 0x00400000, 0x80001000, 0x00001040, + 0x80400040, 0x80000000, 0x00001040, 0x00400040, + 0x00001000, 0x00401040, 0x80401040, 0x80000040, + 0x00400040, 0x80400000, 0x00401000, 0x80401040, + 0x80000040, 0x00000000, 0x00000000, 0x00401000, + 0x00001040, 0x00400040, 0x80400040, 0x80000000, + 0x80401000, 0x80001040, 0x80001040, 0x00000040, + 0x80401040, 0x80000040, 0x80000000, 0x00001000, + 0x80400000, 0x80001000, 0x00401040, 0x80400040, + 0x80001000, 0x00001040, 0x00400000, 0x80401000, + 0x00000040, 0x00400000, 0x00001000, 0x00401040 + ); + + /** + * Pre-permuted S-box5 + * + * @var array + * @access private + */ + var $sbox5 = array( + 0x00000080, 0x01040080, 0x01040000, 0x21000080, + 0x00040000, 0x00000080, 0x20000000, 0x01040000, + 0x20040080, 0x00040000, 0x01000080, 0x20040080, + 0x21000080, 0x21040000, 0x00040080, 0x20000000, + 0x01000000, 0x20040000, 0x20040000, 0x00000000, + 0x20000080, 0x21040080, 0x21040080, 0x01000080, + 0x21040000, 0x20000080, 0x00000000, 0x21000000, + 0x01040080, 0x01000000, 0x21000000, 0x00040080, + 0x00040000, 0x21000080, 0x00000080, 0x01000000, + 0x20000000, 0x01040000, 0x21000080, 0x20040080, + 0x01000080, 0x20000000, 0x21040000, 0x01040080, + 0x20040080, 0x00000080, 0x01000000, 0x21040000, + 0x21040080, 0x00040080, 0x21000000, 0x21040080, + 0x01040000, 0x00000000, 0x20040000, 0x21000000, + 0x00040080, 0x01000080, 0x20000080, 0x00040000, + 0x00000000, 0x20040000, 0x01040080, 0x20000080 + ); + + /** + * Pre-permuted S-box6 + * + * @var array + * @access private + */ + var $sbox6 = array( + 0x10000008, 0x10200000, 0x00002000, 0x10202008, + 0x10200000, 0x00000008, 0x10202008, 0x00200000, + 0x10002000, 0x00202008, 0x00200000, 0x10000008, + 0x00200008, 0x10002000, 0x10000000, 0x00002008, + 0x00000000, 0x00200008, 0x10002008, 0x00002000, + 0x00202000, 0x10002008, 0x00000008, 0x10200008, + 0x10200008, 0x00000000, 0x00202008, 0x10202000, + 0x00002008, 0x00202000, 0x10202000, 0x10000000, + 0x10002000, 0x00000008, 0x10200008, 0x00202000, + 0x10202008, 0x00200000, 0x00002008, 0x10000008, + 0x00200000, 0x10002000, 0x10000000, 0x00002008, + 0x10000008, 0x10202008, 0x00202000, 0x10200000, + 0x00202008, 0x10202000, 0x00000000, 0x10200008, + 0x00000008, 0x00002000, 0x10200000, 0x00202008, + 0x00002000, 0x00200008, 0x10002008, 0x00000000, + 0x10202000, 0x10000000, 0x00200008, 0x10002008 + ); + + /** + * Pre-permuted S-box7 + * + * @var array + * @access private + */ + var $sbox7 = array( + 0x00100000, 0x02100001, 0x02000401, 0x00000000, + 0x00000400, 0x02000401, 0x00100401, 0x02100400, + 0x02100401, 0x00100000, 0x00000000, 0x02000001, + 0x00000001, 0x02000000, 0x02100001, 0x00000401, + 0x02000400, 0x00100401, 0x00100001, 0x02000400, + 0x02000001, 0x02100000, 0x02100400, 0x00100001, + 0x02100000, 0x00000400, 0x00000401, 0x02100401, + 0x00100400, 0x00000001, 0x02000000, 0x00100400, + 0x02000000, 0x00100400, 0x00100000, 0x02000401, + 0x02000401, 0x02100001, 0x02100001, 0x00000001, + 0x00100001, 0x02000000, 0x02000400, 0x00100000, + 0x02100400, 0x00000401, 0x00100401, 0x02100400, + 0x00000401, 0x02000001, 0x02100401, 0x02100000, + 0x00100400, 0x00000000, 0x00000001, 0x02100401, + 0x00000000, 0x00100401, 0x02100000, 0x00000400, + 0x02000001, 0x02000400, 0x00000400, 0x00100001 + ); + + /** + * Pre-permuted S-box8 + * + * @var array + * @access private + */ + var $sbox8 = array( + 0x08000820, 0x00000800, 0x00020000, 0x08020820, + 0x08000000, 0x08000820, 0x00000020, 0x08000000, + 0x00020020, 0x08020000, 0x08020820, 0x00020800, + 0x08020800, 0x00020820, 0x00000800, 0x00000020, + 0x08020000, 0x08000020, 0x08000800, 0x00000820, + 0x00020800, 0x00020020, 0x08020020, 0x08020800, + 0x00000820, 0x00000000, 0x00000000, 0x08020020, + 0x08000020, 0x08000800, 0x00020820, 0x00020000, + 0x00020820, 0x00020000, 0x08020800, 0x00000800, + 0x00000020, 0x08020020, 0x00000800, 0x00020820, + 0x08000800, 0x00000020, 0x08000020, 0x08020000, + 0x08020020, 0x08000000, 0x00020000, 0x08000820, + 0x00000000, 0x08020820, 0x00020020, 0x08000020, + 0x08020000, 0x08000800, 0x08000820, 0x00000000, + 0x08020820, 0x00020800, 0x00020800, 0x00000820, + 0x00000820, 0x00020020, 0x08000000, 0x08020800 + ); + + /** + * Test for engine validity + * + * This is mainly just a wrapper to set things up for \phpseclib\Crypt\Base::isValidEngine() + * + * @see \phpseclib\Crypt\Base::isValidEngine() + * @param int $engine + * @access public + * @return bool + */ + function isValidEngine($engine) + { + if ($this->key_length_max == 8) { + if ($engine == self::ENGINE_OPENSSL) { + $this->cipher_name_openssl_ecb = 'des-ecb'; + $this->cipher_name_openssl = 'des-' . $this->_openssl_translate_mode(); + } + } + + return parent::isValidEngine($engine); + } + + /** + * Sets the key. + * + * Keys can be of any length. DES, itself, uses 64-bit keys (eg. strlen($key) == 8), however, we + * only use the first eight, if $key has more then eight characters in it, and pad $key with the + * null byte if it is less then eight characters long. + * + * DES also requires that every eighth bit be a parity bit, however, we'll ignore that. + * + * If the key is not explicitly set, it'll be assumed to be all zero's. + * + * @see \phpseclib\Crypt\Base::setKey() + * @access public + * @param string $key + */ + function setKey($key) + { + // We check/cut here only up to max length of the key. + // Key padding to the proper length will be done in _setupKey() + if (strlen($key) > $this->key_length_max) { + $key = substr($key, 0, $this->key_length_max); + } + + // Sets the key + parent::setKey($key); + } + + /** + * Encrypts a block + * + * @see \phpseclib\Crypt\Base::_encryptBlock() + * @see \phpseclib\Crypt\Base::encrypt() + * @see self::encrypt() + * @access private + * @param string $in + * @return string + */ + function _encryptBlock($in) + { + return $this->_processBlock($in, self::ENCRYPT); + } + + /** + * Decrypts a block + * + * @see \phpseclib\Crypt\Base::_decryptBlock() + * @see \phpseclib\Crypt\Base::decrypt() + * @see self::decrypt() + * @access private + * @param string $in + * @return string + */ + function _decryptBlock($in) + { + return $this->_processBlock($in, self::DECRYPT); + } + + /** + * Encrypts or decrypts a 64-bit block + * + * $mode should be either self::ENCRYPT or self::DECRYPT. See + * {@link http://en.wikipedia.org/wiki/Image:Feistel.png Feistel.png} to get a general + * idea of what this function does. + * + * @see self::_encryptBlock() + * @see self::_decryptBlock() + * @access private + * @param string $block + * @param int $mode + * @return string + */ + function _processBlock($block, $mode) + { + static $sbox1, $sbox2, $sbox3, $sbox4, $sbox5, $sbox6, $sbox7, $sbox8, $shuffleip, $shuffleinvip; + if (!$sbox1) { + $sbox1 = array_map("intval", $this->sbox1); + $sbox2 = array_map("intval", $this->sbox2); + $sbox3 = array_map("intval", $this->sbox3); + $sbox4 = array_map("intval", $this->sbox4); + $sbox5 = array_map("intval", $this->sbox5); + $sbox6 = array_map("intval", $this->sbox6); + $sbox7 = array_map("intval", $this->sbox7); + $sbox8 = array_map("intval", $this->sbox8); + /* Merge $shuffle with $[inv]ipmap */ + for ($i = 0; $i < 256; ++$i) { + $shuffleip[] = $this->shuffle[$this->ipmap[$i]]; + $shuffleinvip[] = $this->shuffle[$this->invipmap[$i]]; + } + } + + $keys = $this->keys[$mode]; + $ki = -1; + + // Do the initial IP permutation. + $t = unpack('Nl/Nr', $block); + list($l, $r) = array($t['l'], $t['r']); + $block = ($shuffleip[ $r & 0xFF] & "\x80\x80\x80\x80\x80\x80\x80\x80") | + ($shuffleip[($r >> 8) & 0xFF] & "\x40\x40\x40\x40\x40\x40\x40\x40") | + ($shuffleip[($r >> 16) & 0xFF] & "\x20\x20\x20\x20\x20\x20\x20\x20") | + ($shuffleip[($r >> 24) & 0xFF] & "\x10\x10\x10\x10\x10\x10\x10\x10") | + ($shuffleip[ $l & 0xFF] & "\x08\x08\x08\x08\x08\x08\x08\x08") | + ($shuffleip[($l >> 8) & 0xFF] & "\x04\x04\x04\x04\x04\x04\x04\x04") | + ($shuffleip[($l >> 16) & 0xFF] & "\x02\x02\x02\x02\x02\x02\x02\x02") | + ($shuffleip[($l >> 24) & 0xFF] & "\x01\x01\x01\x01\x01\x01\x01\x01"); + + // Extract L0 and R0. + $t = unpack('Nl/Nr', $block); + list($l, $r) = array($t['l'], $t['r']); + + for ($des_round = 0; $des_round < $this->des_rounds; ++$des_round) { + // Perform the 16 steps. + for ($i = 0; $i < 16; $i++) { + // start of "the Feistel (F) function" - see the following URL: + // http://en.wikipedia.org/wiki/Image:Data_Encryption_Standard_InfoBox_Diagram.png + // Merge key schedule. + $b1 = (($r >> 3) & 0x1FFFFFFF) ^ ($r << 29) ^ $keys[++$ki]; + $b2 = (($r >> 31) & 0x00000001) ^ ($r << 1) ^ $keys[++$ki]; + + // S-box indexing. + $t = $sbox1[($b1 >> 24) & 0x3F] ^ $sbox2[($b2 >> 24) & 0x3F] ^ + $sbox3[($b1 >> 16) & 0x3F] ^ $sbox4[($b2 >> 16) & 0x3F] ^ + $sbox5[($b1 >> 8) & 0x3F] ^ $sbox6[($b2 >> 8) & 0x3F] ^ + $sbox7[ $b1 & 0x3F] ^ $sbox8[ $b2 & 0x3F] ^ $l; + // end of "the Feistel (F) function" + + $l = $r; + $r = $t; + } + + // Last step should not permute L & R. + $t = $l; + $l = $r; + $r = $t; + } + + // Perform the inverse IP permutation. + return ($shuffleinvip[($r >> 24) & 0xFF] & "\x80\x80\x80\x80\x80\x80\x80\x80") | + ($shuffleinvip[($l >> 24) & 0xFF] & "\x40\x40\x40\x40\x40\x40\x40\x40") | + ($shuffleinvip[($r >> 16) & 0xFF] & "\x20\x20\x20\x20\x20\x20\x20\x20") | + ($shuffleinvip[($l >> 16) & 0xFF] & "\x10\x10\x10\x10\x10\x10\x10\x10") | + ($shuffleinvip[($r >> 8) & 0xFF] & "\x08\x08\x08\x08\x08\x08\x08\x08") | + ($shuffleinvip[($l >> 8) & 0xFF] & "\x04\x04\x04\x04\x04\x04\x04\x04") | + ($shuffleinvip[ $r & 0xFF] & "\x02\x02\x02\x02\x02\x02\x02\x02") | + ($shuffleinvip[ $l & 0xFF] & "\x01\x01\x01\x01\x01\x01\x01\x01"); + } + + /** + * Creates the key schedule + * + * @see \phpseclib\Crypt\Base::_setupKey() + * @access private + */ + function _setupKey() + { + if (isset($this->kl['key']) && $this->key === $this->kl['key'] && $this->des_rounds === $this->kl['des_rounds']) { + // already expanded + return; + } + $this->kl = array('key' => $this->key, 'des_rounds' => $this->des_rounds); + + static $shifts = array( // number of key bits shifted per round + 1, 1, 2, 2, 2, 2, 2, 2, 1, 2, 2, 2, 2, 2, 2, 1 + ); + + static $pc1map = array( + 0x00, 0x00, 0x08, 0x08, 0x04, 0x04, 0x0C, 0x0C, + 0x02, 0x02, 0x0A, 0x0A, 0x06, 0x06, 0x0E, 0x0E, + 0x10, 0x10, 0x18, 0x18, 0x14, 0x14, 0x1C, 0x1C, + 0x12, 0x12, 0x1A, 0x1A, 0x16, 0x16, 0x1E, 0x1E, + 0x20, 0x20, 0x28, 0x28, 0x24, 0x24, 0x2C, 0x2C, + 0x22, 0x22, 0x2A, 0x2A, 0x26, 0x26, 0x2E, 0x2E, + 0x30, 0x30, 0x38, 0x38, 0x34, 0x34, 0x3C, 0x3C, + 0x32, 0x32, 0x3A, 0x3A, 0x36, 0x36, 0x3E, 0x3E, + 0x40, 0x40, 0x48, 0x48, 0x44, 0x44, 0x4C, 0x4C, + 0x42, 0x42, 0x4A, 0x4A, 0x46, 0x46, 0x4E, 0x4E, + 0x50, 0x50, 0x58, 0x58, 0x54, 0x54, 0x5C, 0x5C, + 0x52, 0x52, 0x5A, 0x5A, 0x56, 0x56, 0x5E, 0x5E, + 0x60, 0x60, 0x68, 0x68, 0x64, 0x64, 0x6C, 0x6C, + 0x62, 0x62, 0x6A, 0x6A, 0x66, 0x66, 0x6E, 0x6E, + 0x70, 0x70, 0x78, 0x78, 0x74, 0x74, 0x7C, 0x7C, + 0x72, 0x72, 0x7A, 0x7A, 0x76, 0x76, 0x7E, 0x7E, + 0x80, 0x80, 0x88, 0x88, 0x84, 0x84, 0x8C, 0x8C, + 0x82, 0x82, 0x8A, 0x8A, 0x86, 0x86, 0x8E, 0x8E, + 0x90, 0x90, 0x98, 0x98, 0x94, 0x94, 0x9C, 0x9C, + 0x92, 0x92, 0x9A, 0x9A, 0x96, 0x96, 0x9E, 0x9E, + 0xA0, 0xA0, 0xA8, 0xA8, 0xA4, 0xA4, 0xAC, 0xAC, + 0xA2, 0xA2, 0xAA, 0xAA, 0xA6, 0xA6, 0xAE, 0xAE, + 0xB0, 0xB0, 0xB8, 0xB8, 0xB4, 0xB4, 0xBC, 0xBC, + 0xB2, 0xB2, 0xBA, 0xBA, 0xB6, 0xB6, 0xBE, 0xBE, + 0xC0, 0xC0, 0xC8, 0xC8, 0xC4, 0xC4, 0xCC, 0xCC, + 0xC2, 0xC2, 0xCA, 0xCA, 0xC6, 0xC6, 0xCE, 0xCE, + 0xD0, 0xD0, 0xD8, 0xD8, 0xD4, 0xD4, 0xDC, 0xDC, + 0xD2, 0xD2, 0xDA, 0xDA, 0xD6, 0xD6, 0xDE, 0xDE, + 0xE0, 0xE0, 0xE8, 0xE8, 0xE4, 0xE4, 0xEC, 0xEC, + 0xE2, 0xE2, 0xEA, 0xEA, 0xE6, 0xE6, 0xEE, 0xEE, + 0xF0, 0xF0, 0xF8, 0xF8, 0xF4, 0xF4, 0xFC, 0xFC, + 0xF2, 0xF2, 0xFA, 0xFA, 0xF6, 0xF6, 0xFE, 0xFE + ); + + // Mapping tables for the PC-2 transformation. + static $pc2mapc1 = array( + 0x00000000, 0x00000400, 0x00200000, 0x00200400, + 0x00000001, 0x00000401, 0x00200001, 0x00200401, + 0x02000000, 0x02000400, 0x02200000, 0x02200400, + 0x02000001, 0x02000401, 0x02200001, 0x02200401 + ); + static $pc2mapc2 = array( + 0x00000000, 0x00000800, 0x08000000, 0x08000800, + 0x00010000, 0x00010800, 0x08010000, 0x08010800, + 0x00000000, 0x00000800, 0x08000000, 0x08000800, + 0x00010000, 0x00010800, 0x08010000, 0x08010800, + 0x00000100, 0x00000900, 0x08000100, 0x08000900, + 0x00010100, 0x00010900, 0x08010100, 0x08010900, + 0x00000100, 0x00000900, 0x08000100, 0x08000900, + 0x00010100, 0x00010900, 0x08010100, 0x08010900, + 0x00000010, 0x00000810, 0x08000010, 0x08000810, + 0x00010010, 0x00010810, 0x08010010, 0x08010810, + 0x00000010, 0x00000810, 0x08000010, 0x08000810, + 0x00010010, 0x00010810, 0x08010010, 0x08010810, + 0x00000110, 0x00000910, 0x08000110, 0x08000910, + 0x00010110, 0x00010910, 0x08010110, 0x08010910, + 0x00000110, 0x00000910, 0x08000110, 0x08000910, + 0x00010110, 0x00010910, 0x08010110, 0x08010910, + 0x00040000, 0x00040800, 0x08040000, 0x08040800, + 0x00050000, 0x00050800, 0x08050000, 0x08050800, + 0x00040000, 0x00040800, 0x08040000, 0x08040800, + 0x00050000, 0x00050800, 0x08050000, 0x08050800, + 0x00040100, 0x00040900, 0x08040100, 0x08040900, + 0x00050100, 0x00050900, 0x08050100, 0x08050900, + 0x00040100, 0x00040900, 0x08040100, 0x08040900, + 0x00050100, 0x00050900, 0x08050100, 0x08050900, + 0x00040010, 0x00040810, 0x08040010, 0x08040810, + 0x00050010, 0x00050810, 0x08050010, 0x08050810, + 0x00040010, 0x00040810, 0x08040010, 0x08040810, + 0x00050010, 0x00050810, 0x08050010, 0x08050810, + 0x00040110, 0x00040910, 0x08040110, 0x08040910, + 0x00050110, 0x00050910, 0x08050110, 0x08050910, + 0x00040110, 0x00040910, 0x08040110, 0x08040910, + 0x00050110, 0x00050910, 0x08050110, 0x08050910, + 0x01000000, 0x01000800, 0x09000000, 0x09000800, + 0x01010000, 0x01010800, 0x09010000, 0x09010800, + 0x01000000, 0x01000800, 0x09000000, 0x09000800, + 0x01010000, 0x01010800, 0x09010000, 0x09010800, + 0x01000100, 0x01000900, 0x09000100, 0x09000900, + 0x01010100, 0x01010900, 0x09010100, 0x09010900, + 0x01000100, 0x01000900, 0x09000100, 0x09000900, + 0x01010100, 0x01010900, 0x09010100, 0x09010900, + 0x01000010, 0x01000810, 0x09000010, 0x09000810, + 0x01010010, 0x01010810, 0x09010010, 0x09010810, + 0x01000010, 0x01000810, 0x09000010, 0x09000810, + 0x01010010, 0x01010810, 0x09010010, 0x09010810, + 0x01000110, 0x01000910, 0x09000110, 0x09000910, + 0x01010110, 0x01010910, 0x09010110, 0x09010910, + 0x01000110, 0x01000910, 0x09000110, 0x09000910, + 0x01010110, 0x01010910, 0x09010110, 0x09010910, + 0x01040000, 0x01040800, 0x09040000, 0x09040800, + 0x01050000, 0x01050800, 0x09050000, 0x09050800, + 0x01040000, 0x01040800, 0x09040000, 0x09040800, + 0x01050000, 0x01050800, 0x09050000, 0x09050800, + 0x01040100, 0x01040900, 0x09040100, 0x09040900, + 0x01050100, 0x01050900, 0x09050100, 0x09050900, + 0x01040100, 0x01040900, 0x09040100, 0x09040900, + 0x01050100, 0x01050900, 0x09050100, 0x09050900, + 0x01040010, 0x01040810, 0x09040010, 0x09040810, + 0x01050010, 0x01050810, 0x09050010, 0x09050810, + 0x01040010, 0x01040810, 0x09040010, 0x09040810, + 0x01050010, 0x01050810, 0x09050010, 0x09050810, + 0x01040110, 0x01040910, 0x09040110, 0x09040910, + 0x01050110, 0x01050910, 0x09050110, 0x09050910, + 0x01040110, 0x01040910, 0x09040110, 0x09040910, + 0x01050110, 0x01050910, 0x09050110, 0x09050910 + ); + static $pc2mapc3 = array( + 0x00000000, 0x00000004, 0x00001000, 0x00001004, + 0x00000000, 0x00000004, 0x00001000, 0x00001004, + 0x10000000, 0x10000004, 0x10001000, 0x10001004, + 0x10000000, 0x10000004, 0x10001000, 0x10001004, + 0x00000020, 0x00000024, 0x00001020, 0x00001024, + 0x00000020, 0x00000024, 0x00001020, 0x00001024, + 0x10000020, 0x10000024, 0x10001020, 0x10001024, + 0x10000020, 0x10000024, 0x10001020, 0x10001024, + 0x00080000, 0x00080004, 0x00081000, 0x00081004, + 0x00080000, 0x00080004, 0x00081000, 0x00081004, + 0x10080000, 0x10080004, 0x10081000, 0x10081004, + 0x10080000, 0x10080004, 0x10081000, 0x10081004, + 0x00080020, 0x00080024, 0x00081020, 0x00081024, + 0x00080020, 0x00080024, 0x00081020, 0x00081024, + 0x10080020, 0x10080024, 0x10081020, 0x10081024, + 0x10080020, 0x10080024, 0x10081020, 0x10081024, + 0x20000000, 0x20000004, 0x20001000, 0x20001004, + 0x20000000, 0x20000004, 0x20001000, 0x20001004, + 0x30000000, 0x30000004, 0x30001000, 0x30001004, + 0x30000000, 0x30000004, 0x30001000, 0x30001004, + 0x20000020, 0x20000024, 0x20001020, 0x20001024, + 0x20000020, 0x20000024, 0x20001020, 0x20001024, + 0x30000020, 0x30000024, 0x30001020, 0x30001024, + 0x30000020, 0x30000024, 0x30001020, 0x30001024, + 0x20080000, 0x20080004, 0x20081000, 0x20081004, + 0x20080000, 0x20080004, 0x20081000, 0x20081004, + 0x30080000, 0x30080004, 0x30081000, 0x30081004, + 0x30080000, 0x30080004, 0x30081000, 0x30081004, + 0x20080020, 0x20080024, 0x20081020, 0x20081024, + 0x20080020, 0x20080024, 0x20081020, 0x20081024, + 0x30080020, 0x30080024, 0x30081020, 0x30081024, + 0x30080020, 0x30080024, 0x30081020, 0x30081024, + 0x00000002, 0x00000006, 0x00001002, 0x00001006, + 0x00000002, 0x00000006, 0x00001002, 0x00001006, + 0x10000002, 0x10000006, 0x10001002, 0x10001006, + 0x10000002, 0x10000006, 0x10001002, 0x10001006, + 0x00000022, 0x00000026, 0x00001022, 0x00001026, + 0x00000022, 0x00000026, 0x00001022, 0x00001026, + 0x10000022, 0x10000026, 0x10001022, 0x10001026, + 0x10000022, 0x10000026, 0x10001022, 0x10001026, + 0x00080002, 0x00080006, 0x00081002, 0x00081006, + 0x00080002, 0x00080006, 0x00081002, 0x00081006, + 0x10080002, 0x10080006, 0x10081002, 0x10081006, + 0x10080002, 0x10080006, 0x10081002, 0x10081006, + 0x00080022, 0x00080026, 0x00081022, 0x00081026, + 0x00080022, 0x00080026, 0x00081022, 0x00081026, + 0x10080022, 0x10080026, 0x10081022, 0x10081026, + 0x10080022, 0x10080026, 0x10081022, 0x10081026, + 0x20000002, 0x20000006, 0x20001002, 0x20001006, + 0x20000002, 0x20000006, 0x20001002, 0x20001006, + 0x30000002, 0x30000006, 0x30001002, 0x30001006, + 0x30000002, 0x30000006, 0x30001002, 0x30001006, + 0x20000022, 0x20000026, 0x20001022, 0x20001026, + 0x20000022, 0x20000026, 0x20001022, 0x20001026, + 0x30000022, 0x30000026, 0x30001022, 0x30001026, + 0x30000022, 0x30000026, 0x30001022, 0x30001026, + 0x20080002, 0x20080006, 0x20081002, 0x20081006, + 0x20080002, 0x20080006, 0x20081002, 0x20081006, + 0x30080002, 0x30080006, 0x30081002, 0x30081006, + 0x30080002, 0x30080006, 0x30081002, 0x30081006, + 0x20080022, 0x20080026, 0x20081022, 0x20081026, + 0x20080022, 0x20080026, 0x20081022, 0x20081026, + 0x30080022, 0x30080026, 0x30081022, 0x30081026, + 0x30080022, 0x30080026, 0x30081022, 0x30081026 + ); + static $pc2mapc4 = array( + 0x00000000, 0x00100000, 0x00000008, 0x00100008, + 0x00000200, 0x00100200, 0x00000208, 0x00100208, + 0x00000000, 0x00100000, 0x00000008, 0x00100008, + 0x00000200, 0x00100200, 0x00000208, 0x00100208, + 0x04000000, 0x04100000, 0x04000008, 0x04100008, + 0x04000200, 0x04100200, 0x04000208, 0x04100208, + 0x04000000, 0x04100000, 0x04000008, 0x04100008, + 0x04000200, 0x04100200, 0x04000208, 0x04100208, + 0x00002000, 0x00102000, 0x00002008, 0x00102008, + 0x00002200, 0x00102200, 0x00002208, 0x00102208, + 0x00002000, 0x00102000, 0x00002008, 0x00102008, + 0x00002200, 0x00102200, 0x00002208, 0x00102208, + 0x04002000, 0x04102000, 0x04002008, 0x04102008, + 0x04002200, 0x04102200, 0x04002208, 0x04102208, + 0x04002000, 0x04102000, 0x04002008, 0x04102008, + 0x04002200, 0x04102200, 0x04002208, 0x04102208, + 0x00000000, 0x00100000, 0x00000008, 0x00100008, + 0x00000200, 0x00100200, 0x00000208, 0x00100208, + 0x00000000, 0x00100000, 0x00000008, 0x00100008, + 0x00000200, 0x00100200, 0x00000208, 0x00100208, + 0x04000000, 0x04100000, 0x04000008, 0x04100008, + 0x04000200, 0x04100200, 0x04000208, 0x04100208, + 0x04000000, 0x04100000, 0x04000008, 0x04100008, + 0x04000200, 0x04100200, 0x04000208, 0x04100208, + 0x00002000, 0x00102000, 0x00002008, 0x00102008, + 0x00002200, 0x00102200, 0x00002208, 0x00102208, + 0x00002000, 0x00102000, 0x00002008, 0x00102008, + 0x00002200, 0x00102200, 0x00002208, 0x00102208, + 0x04002000, 0x04102000, 0x04002008, 0x04102008, + 0x04002200, 0x04102200, 0x04002208, 0x04102208, + 0x04002000, 0x04102000, 0x04002008, 0x04102008, + 0x04002200, 0x04102200, 0x04002208, 0x04102208, + 0x00020000, 0x00120000, 0x00020008, 0x00120008, + 0x00020200, 0x00120200, 0x00020208, 0x00120208, + 0x00020000, 0x00120000, 0x00020008, 0x00120008, + 0x00020200, 0x00120200, 0x00020208, 0x00120208, + 0x04020000, 0x04120000, 0x04020008, 0x04120008, + 0x04020200, 0x04120200, 0x04020208, 0x04120208, + 0x04020000, 0x04120000, 0x04020008, 0x04120008, + 0x04020200, 0x04120200, 0x04020208, 0x04120208, + 0x00022000, 0x00122000, 0x00022008, 0x00122008, + 0x00022200, 0x00122200, 0x00022208, 0x00122208, + 0x00022000, 0x00122000, 0x00022008, 0x00122008, + 0x00022200, 0x00122200, 0x00022208, 0x00122208, + 0x04022000, 0x04122000, 0x04022008, 0x04122008, + 0x04022200, 0x04122200, 0x04022208, 0x04122208, + 0x04022000, 0x04122000, 0x04022008, 0x04122008, + 0x04022200, 0x04122200, 0x04022208, 0x04122208, + 0x00020000, 0x00120000, 0x00020008, 0x00120008, + 0x00020200, 0x00120200, 0x00020208, 0x00120208, + 0x00020000, 0x00120000, 0x00020008, 0x00120008, + 0x00020200, 0x00120200, 0x00020208, 0x00120208, + 0x04020000, 0x04120000, 0x04020008, 0x04120008, + 0x04020200, 0x04120200, 0x04020208, 0x04120208, + 0x04020000, 0x04120000, 0x04020008, 0x04120008, + 0x04020200, 0x04120200, 0x04020208, 0x04120208, + 0x00022000, 0x00122000, 0x00022008, 0x00122008, + 0x00022200, 0x00122200, 0x00022208, 0x00122208, + 0x00022000, 0x00122000, 0x00022008, 0x00122008, + 0x00022200, 0x00122200, 0x00022208, 0x00122208, + 0x04022000, 0x04122000, 0x04022008, 0x04122008, + 0x04022200, 0x04122200, 0x04022208, 0x04122208, + 0x04022000, 0x04122000, 0x04022008, 0x04122008, + 0x04022200, 0x04122200, 0x04022208, 0x04122208 + ); + static $pc2mapd1 = array( + 0x00000000, 0x00000001, 0x08000000, 0x08000001, + 0x00200000, 0x00200001, 0x08200000, 0x08200001, + 0x00000002, 0x00000003, 0x08000002, 0x08000003, + 0x00200002, 0x00200003, 0x08200002, 0x08200003 + ); + static $pc2mapd2 = array( + 0x00000000, 0x00100000, 0x00000800, 0x00100800, + 0x00000000, 0x00100000, 0x00000800, 0x00100800, + 0x04000000, 0x04100000, 0x04000800, 0x04100800, + 0x04000000, 0x04100000, 0x04000800, 0x04100800, + 0x00000004, 0x00100004, 0x00000804, 0x00100804, + 0x00000004, 0x00100004, 0x00000804, 0x00100804, + 0x04000004, 0x04100004, 0x04000804, 0x04100804, + 0x04000004, 0x04100004, 0x04000804, 0x04100804, + 0x00000000, 0x00100000, 0x00000800, 0x00100800, + 0x00000000, 0x00100000, 0x00000800, 0x00100800, + 0x04000000, 0x04100000, 0x04000800, 0x04100800, + 0x04000000, 0x04100000, 0x04000800, 0x04100800, + 0x00000004, 0x00100004, 0x00000804, 0x00100804, + 0x00000004, 0x00100004, 0x00000804, 0x00100804, + 0x04000004, 0x04100004, 0x04000804, 0x04100804, + 0x04000004, 0x04100004, 0x04000804, 0x04100804, + 0x00000200, 0x00100200, 0x00000A00, 0x00100A00, + 0x00000200, 0x00100200, 0x00000A00, 0x00100A00, + 0x04000200, 0x04100200, 0x04000A00, 0x04100A00, + 0x04000200, 0x04100200, 0x04000A00, 0x04100A00, + 0x00000204, 0x00100204, 0x00000A04, 0x00100A04, + 0x00000204, 0x00100204, 0x00000A04, 0x00100A04, + 0x04000204, 0x04100204, 0x04000A04, 0x04100A04, + 0x04000204, 0x04100204, 0x04000A04, 0x04100A04, + 0x00000200, 0x00100200, 0x00000A00, 0x00100A00, + 0x00000200, 0x00100200, 0x00000A00, 0x00100A00, + 0x04000200, 0x04100200, 0x04000A00, 0x04100A00, + 0x04000200, 0x04100200, 0x04000A00, 0x04100A00, + 0x00000204, 0x00100204, 0x00000A04, 0x00100A04, + 0x00000204, 0x00100204, 0x00000A04, 0x00100A04, + 0x04000204, 0x04100204, 0x04000A04, 0x04100A04, + 0x04000204, 0x04100204, 0x04000A04, 0x04100A04, + 0x00020000, 0x00120000, 0x00020800, 0x00120800, + 0x00020000, 0x00120000, 0x00020800, 0x00120800, + 0x04020000, 0x04120000, 0x04020800, 0x04120800, + 0x04020000, 0x04120000, 0x04020800, 0x04120800, + 0x00020004, 0x00120004, 0x00020804, 0x00120804, + 0x00020004, 0x00120004, 0x00020804, 0x00120804, + 0x04020004, 0x04120004, 0x04020804, 0x04120804, + 0x04020004, 0x04120004, 0x04020804, 0x04120804, + 0x00020000, 0x00120000, 0x00020800, 0x00120800, + 0x00020000, 0x00120000, 0x00020800, 0x00120800, + 0x04020000, 0x04120000, 0x04020800, 0x04120800, + 0x04020000, 0x04120000, 0x04020800, 0x04120800, + 0x00020004, 0x00120004, 0x00020804, 0x00120804, + 0x00020004, 0x00120004, 0x00020804, 0x00120804, + 0x04020004, 0x04120004, 0x04020804, 0x04120804, + 0x04020004, 0x04120004, 0x04020804, 0x04120804, + 0x00020200, 0x00120200, 0x00020A00, 0x00120A00, + 0x00020200, 0x00120200, 0x00020A00, 0x00120A00, + 0x04020200, 0x04120200, 0x04020A00, 0x04120A00, + 0x04020200, 0x04120200, 0x04020A00, 0x04120A00, + 0x00020204, 0x00120204, 0x00020A04, 0x00120A04, + 0x00020204, 0x00120204, 0x00020A04, 0x00120A04, + 0x04020204, 0x04120204, 0x04020A04, 0x04120A04, + 0x04020204, 0x04120204, 0x04020A04, 0x04120A04, + 0x00020200, 0x00120200, 0x00020A00, 0x00120A00, + 0x00020200, 0x00120200, 0x00020A00, 0x00120A00, + 0x04020200, 0x04120200, 0x04020A00, 0x04120A00, + 0x04020200, 0x04120200, 0x04020A00, 0x04120A00, + 0x00020204, 0x00120204, 0x00020A04, 0x00120A04, + 0x00020204, 0x00120204, 0x00020A04, 0x00120A04, + 0x04020204, 0x04120204, 0x04020A04, 0x04120A04, + 0x04020204, 0x04120204, 0x04020A04, 0x04120A04 + ); + static $pc2mapd3 = array( + 0x00000000, 0x00010000, 0x02000000, 0x02010000, + 0x00000020, 0x00010020, 0x02000020, 0x02010020, + 0x00040000, 0x00050000, 0x02040000, 0x02050000, + 0x00040020, 0x00050020, 0x02040020, 0x02050020, + 0x00002000, 0x00012000, 0x02002000, 0x02012000, + 0x00002020, 0x00012020, 0x02002020, 0x02012020, + 0x00042000, 0x00052000, 0x02042000, 0x02052000, + 0x00042020, 0x00052020, 0x02042020, 0x02052020, + 0x00000000, 0x00010000, 0x02000000, 0x02010000, + 0x00000020, 0x00010020, 0x02000020, 0x02010020, + 0x00040000, 0x00050000, 0x02040000, 0x02050000, + 0x00040020, 0x00050020, 0x02040020, 0x02050020, + 0x00002000, 0x00012000, 0x02002000, 0x02012000, + 0x00002020, 0x00012020, 0x02002020, 0x02012020, + 0x00042000, 0x00052000, 0x02042000, 0x02052000, + 0x00042020, 0x00052020, 0x02042020, 0x02052020, + 0x00000010, 0x00010010, 0x02000010, 0x02010010, + 0x00000030, 0x00010030, 0x02000030, 0x02010030, + 0x00040010, 0x00050010, 0x02040010, 0x02050010, + 0x00040030, 0x00050030, 0x02040030, 0x02050030, + 0x00002010, 0x00012010, 0x02002010, 0x02012010, + 0x00002030, 0x00012030, 0x02002030, 0x02012030, + 0x00042010, 0x00052010, 0x02042010, 0x02052010, + 0x00042030, 0x00052030, 0x02042030, 0x02052030, + 0x00000010, 0x00010010, 0x02000010, 0x02010010, + 0x00000030, 0x00010030, 0x02000030, 0x02010030, + 0x00040010, 0x00050010, 0x02040010, 0x02050010, + 0x00040030, 0x00050030, 0x02040030, 0x02050030, + 0x00002010, 0x00012010, 0x02002010, 0x02012010, + 0x00002030, 0x00012030, 0x02002030, 0x02012030, + 0x00042010, 0x00052010, 0x02042010, 0x02052010, + 0x00042030, 0x00052030, 0x02042030, 0x02052030, + 0x20000000, 0x20010000, 0x22000000, 0x22010000, + 0x20000020, 0x20010020, 0x22000020, 0x22010020, + 0x20040000, 0x20050000, 0x22040000, 0x22050000, + 0x20040020, 0x20050020, 0x22040020, 0x22050020, + 0x20002000, 0x20012000, 0x22002000, 0x22012000, + 0x20002020, 0x20012020, 0x22002020, 0x22012020, + 0x20042000, 0x20052000, 0x22042000, 0x22052000, + 0x20042020, 0x20052020, 0x22042020, 0x22052020, + 0x20000000, 0x20010000, 0x22000000, 0x22010000, + 0x20000020, 0x20010020, 0x22000020, 0x22010020, + 0x20040000, 0x20050000, 0x22040000, 0x22050000, + 0x20040020, 0x20050020, 0x22040020, 0x22050020, + 0x20002000, 0x20012000, 0x22002000, 0x22012000, + 0x20002020, 0x20012020, 0x22002020, 0x22012020, + 0x20042000, 0x20052000, 0x22042000, 0x22052000, + 0x20042020, 0x20052020, 0x22042020, 0x22052020, + 0x20000010, 0x20010010, 0x22000010, 0x22010010, + 0x20000030, 0x20010030, 0x22000030, 0x22010030, + 0x20040010, 0x20050010, 0x22040010, 0x22050010, + 0x20040030, 0x20050030, 0x22040030, 0x22050030, + 0x20002010, 0x20012010, 0x22002010, 0x22012010, + 0x20002030, 0x20012030, 0x22002030, 0x22012030, + 0x20042010, 0x20052010, 0x22042010, 0x22052010, + 0x20042030, 0x20052030, 0x22042030, 0x22052030, + 0x20000010, 0x20010010, 0x22000010, 0x22010010, + 0x20000030, 0x20010030, 0x22000030, 0x22010030, + 0x20040010, 0x20050010, 0x22040010, 0x22050010, + 0x20040030, 0x20050030, 0x22040030, 0x22050030, + 0x20002010, 0x20012010, 0x22002010, 0x22012010, + 0x20002030, 0x20012030, 0x22002030, 0x22012030, + 0x20042010, 0x20052010, 0x22042010, 0x22052010, + 0x20042030, 0x20052030, 0x22042030, 0x22052030 + ); + static $pc2mapd4 = array( + 0x00000000, 0x00000400, 0x01000000, 0x01000400, + 0x00000000, 0x00000400, 0x01000000, 0x01000400, + 0x00000100, 0x00000500, 0x01000100, 0x01000500, + 0x00000100, 0x00000500, 0x01000100, 0x01000500, + 0x10000000, 0x10000400, 0x11000000, 0x11000400, + 0x10000000, 0x10000400, 0x11000000, 0x11000400, + 0x10000100, 0x10000500, 0x11000100, 0x11000500, + 0x10000100, 0x10000500, 0x11000100, 0x11000500, + 0x00080000, 0x00080400, 0x01080000, 0x01080400, + 0x00080000, 0x00080400, 0x01080000, 0x01080400, + 0x00080100, 0x00080500, 0x01080100, 0x01080500, + 0x00080100, 0x00080500, 0x01080100, 0x01080500, + 0x10080000, 0x10080400, 0x11080000, 0x11080400, + 0x10080000, 0x10080400, 0x11080000, 0x11080400, + 0x10080100, 0x10080500, 0x11080100, 0x11080500, + 0x10080100, 0x10080500, 0x11080100, 0x11080500, + 0x00000008, 0x00000408, 0x01000008, 0x01000408, + 0x00000008, 0x00000408, 0x01000008, 0x01000408, + 0x00000108, 0x00000508, 0x01000108, 0x01000508, + 0x00000108, 0x00000508, 0x01000108, 0x01000508, + 0x10000008, 0x10000408, 0x11000008, 0x11000408, + 0x10000008, 0x10000408, 0x11000008, 0x11000408, + 0x10000108, 0x10000508, 0x11000108, 0x11000508, + 0x10000108, 0x10000508, 0x11000108, 0x11000508, + 0x00080008, 0x00080408, 0x01080008, 0x01080408, + 0x00080008, 0x00080408, 0x01080008, 0x01080408, + 0x00080108, 0x00080508, 0x01080108, 0x01080508, + 0x00080108, 0x00080508, 0x01080108, 0x01080508, + 0x10080008, 0x10080408, 0x11080008, 0x11080408, + 0x10080008, 0x10080408, 0x11080008, 0x11080408, + 0x10080108, 0x10080508, 0x11080108, 0x11080508, + 0x10080108, 0x10080508, 0x11080108, 0x11080508, + 0x00001000, 0x00001400, 0x01001000, 0x01001400, + 0x00001000, 0x00001400, 0x01001000, 0x01001400, + 0x00001100, 0x00001500, 0x01001100, 0x01001500, + 0x00001100, 0x00001500, 0x01001100, 0x01001500, + 0x10001000, 0x10001400, 0x11001000, 0x11001400, + 0x10001000, 0x10001400, 0x11001000, 0x11001400, + 0x10001100, 0x10001500, 0x11001100, 0x11001500, + 0x10001100, 0x10001500, 0x11001100, 0x11001500, + 0x00081000, 0x00081400, 0x01081000, 0x01081400, + 0x00081000, 0x00081400, 0x01081000, 0x01081400, + 0x00081100, 0x00081500, 0x01081100, 0x01081500, + 0x00081100, 0x00081500, 0x01081100, 0x01081500, + 0x10081000, 0x10081400, 0x11081000, 0x11081400, + 0x10081000, 0x10081400, 0x11081000, 0x11081400, + 0x10081100, 0x10081500, 0x11081100, 0x11081500, + 0x10081100, 0x10081500, 0x11081100, 0x11081500, + 0x00001008, 0x00001408, 0x01001008, 0x01001408, + 0x00001008, 0x00001408, 0x01001008, 0x01001408, + 0x00001108, 0x00001508, 0x01001108, 0x01001508, + 0x00001108, 0x00001508, 0x01001108, 0x01001508, + 0x10001008, 0x10001408, 0x11001008, 0x11001408, + 0x10001008, 0x10001408, 0x11001008, 0x11001408, + 0x10001108, 0x10001508, 0x11001108, 0x11001508, + 0x10001108, 0x10001508, 0x11001108, 0x11001508, + 0x00081008, 0x00081408, 0x01081008, 0x01081408, + 0x00081008, 0x00081408, 0x01081008, 0x01081408, + 0x00081108, 0x00081508, 0x01081108, 0x01081508, + 0x00081108, 0x00081508, 0x01081108, 0x01081508, + 0x10081008, 0x10081408, 0x11081008, 0x11081408, + 0x10081008, 0x10081408, 0x11081008, 0x11081408, + 0x10081108, 0x10081508, 0x11081108, 0x11081508, + 0x10081108, 0x10081508, 0x11081108, 0x11081508 + ); + + $keys = array(); + for ($des_round = 0; $des_round < $this->des_rounds; ++$des_round) { + // pad the key and remove extra characters as appropriate. + $key = str_pad(substr($this->key, $des_round * 8, 8), 8, "\0"); + + // Perform the PC/1 transformation and compute C and D. + $t = unpack('Nl/Nr', $key); + list($l, $r) = array($t['l'], $t['r']); + $key = ($this->shuffle[$pc1map[ $r & 0xFF]] & "\x80\x80\x80\x80\x80\x80\x80\x00") | + ($this->shuffle[$pc1map[($r >> 8) & 0xFF]] & "\x40\x40\x40\x40\x40\x40\x40\x00") | + ($this->shuffle[$pc1map[($r >> 16) & 0xFF]] & "\x20\x20\x20\x20\x20\x20\x20\x00") | + ($this->shuffle[$pc1map[($r >> 24) & 0xFF]] & "\x10\x10\x10\x10\x10\x10\x10\x00") | + ($this->shuffle[$pc1map[ $l & 0xFF]] & "\x08\x08\x08\x08\x08\x08\x08\x00") | + ($this->shuffle[$pc1map[($l >> 8) & 0xFF]] & "\x04\x04\x04\x04\x04\x04\x04\x00") | + ($this->shuffle[$pc1map[($l >> 16) & 0xFF]] & "\x02\x02\x02\x02\x02\x02\x02\x00") | + ($this->shuffle[$pc1map[($l >> 24) & 0xFF]] & "\x01\x01\x01\x01\x01\x01\x01\x00"); + $key = unpack('Nc/Nd', $key); + $c = ( $key['c'] >> 4) & 0x0FFFFFFF; + $d = (($key['d'] >> 4) & 0x0FFFFFF0) | ($key['c'] & 0x0F); + + $keys[$des_round] = array( + self::ENCRYPT => array(), + self::DECRYPT => array_fill(0, 32, 0) + ); + for ($i = 0, $ki = 31; $i < 16; ++$i, $ki-= 2) { + $c <<= $shifts[$i]; + $c = ($c | ($c >> 28)) & 0x0FFFFFFF; + $d <<= $shifts[$i]; + $d = ($d | ($d >> 28)) & 0x0FFFFFFF; + + // Perform the PC-2 transformation. + $cp = $pc2mapc1[ $c >> 24 ] | $pc2mapc2[($c >> 16) & 0xFF] | + $pc2mapc3[($c >> 8) & 0xFF] | $pc2mapc4[ $c & 0xFF]; + $dp = $pc2mapd1[ $d >> 24 ] | $pc2mapd2[($d >> 16) & 0xFF] | + $pc2mapd3[($d >> 8) & 0xFF] | $pc2mapd4[ $d & 0xFF]; + + // Reorder: odd bytes/even bytes. Push the result in key schedule. + $val1 = ( $cp & 0xFF000000) | (($cp << 8) & 0x00FF0000) | + (($dp >> 16) & 0x0000FF00) | (($dp >> 8) & 0x000000FF); + $val2 = (($cp << 8) & 0xFF000000) | (($cp << 16) & 0x00FF0000) | + (($dp >> 8) & 0x0000FF00) | ( $dp & 0x000000FF); + $keys[$des_round][self::ENCRYPT][ ] = $val1; + $keys[$des_round][self::DECRYPT][$ki - 1] = $val1; + $keys[$des_round][self::ENCRYPT][ ] = $val2; + $keys[$des_round][self::DECRYPT][$ki ] = $val2; + } + } + + switch ($this->des_rounds) { + case 3: // 3DES keys + $this->keys = array( + self::ENCRYPT => array_merge( + $keys[0][self::ENCRYPT], + $keys[1][self::DECRYPT], + $keys[2][self::ENCRYPT] + ), + self::DECRYPT => array_merge( + $keys[2][self::DECRYPT], + $keys[1][self::ENCRYPT], + $keys[0][self::DECRYPT] + ) + ); + break; + // case 1: // DES keys + default: + $this->keys = array( + self::ENCRYPT => $keys[0][self::ENCRYPT], + self::DECRYPT => $keys[0][self::DECRYPT] + ); + } + } + + /** + * Setup the performance-optimized function for de/encrypt() + * + * @see \phpseclib\Crypt\Base::_setupInlineCrypt() + * @access private + */ + function _setupInlineCrypt() + { + $lambda_functions =& self::_getLambdaFunctions(); + + // Engine configuration for: + // - DES ($des_rounds == 1) or + // - 3DES ($des_rounds == 3) + $des_rounds = $this->des_rounds; + + // We create max. 10 hi-optimized code for memory reason. Means: For each $key one ultra fast inline-crypt function. + // (Currently, for DES, one generated $lambda_function cost on php5.5@32bit ~135kb unfreeable mem and ~230kb on php5.5@64bit) + // (Currently, for TripleDES, one generated $lambda_function cost on php5.5@32bit ~240kb unfreeable mem and ~340kb on php5.5@64bit) + // After that, we'll still create very fast optimized code but not the hi-ultimative code, for each $mode one + $gen_hi_opt_code = (bool)( count($lambda_functions) < 10 ); + + // Generation of a unique hash for our generated code + $code_hash = "Crypt_DES, $des_rounds, {$this->mode}"; + if ($gen_hi_opt_code) { + // For hi-optimized code, we create for each combination of + // $mode, $des_rounds and $this->key its own encrypt/decrypt function. + // After max 10 hi-optimized functions, we create generic + // (still very fast.. but not ultra) functions for each $mode/$des_rounds + // Currently 2 * 5 generic functions will be then max. possible. + $code_hash = str_pad($code_hash, 32) . $this->_hashInlineCryptFunction($this->key); + } + + // Is there a re-usable $lambda_functions in there? If not, we have to create it. + if (!isset($lambda_functions[$code_hash])) { + // Init code for both, encrypt and decrypt. + $init_crypt = 'static $sbox1, $sbox2, $sbox3, $sbox4, $sbox5, $sbox6, $sbox7, $sbox8, $shuffleip, $shuffleinvip; + if (!$sbox1) { + $sbox1 = array_map("intval", $self->sbox1); + $sbox2 = array_map("intval", $self->sbox2); + $sbox3 = array_map("intval", $self->sbox3); + $sbox4 = array_map("intval", $self->sbox4); + $sbox5 = array_map("intval", $self->sbox5); + $sbox6 = array_map("intval", $self->sbox6); + $sbox7 = array_map("intval", $self->sbox7); + $sbox8 = array_map("intval", $self->sbox8);' + /* Merge $shuffle with $[inv]ipmap */ . ' + for ($i = 0; $i < 256; ++$i) { + $shuffleip[] = $self->shuffle[$self->ipmap[$i]]; + $shuffleinvip[] = $self->shuffle[$self->invipmap[$i]]; + } + } + '; + + switch (true) { + case $gen_hi_opt_code: + // In Hi-optimized code mode, we use our [3]DES key schedule as hardcoded integers. + // No futher initialisation of the $keys schedule is necessary. + // That is the extra performance boost. + $k = array( + self::ENCRYPT => $this->keys[self::ENCRYPT], + self::DECRYPT => $this->keys[self::DECRYPT] + ); + $init_encrypt = ''; + $init_decrypt = ''; + break; + default: + // In generic optimized code mode, we have to use, as the best compromise [currently], + // our key schedule as $ke/$kd arrays. (with hardcoded indexes...) + $k = array( + self::ENCRYPT => array(), + self::DECRYPT => array() + ); + for ($i = 0, $c = count($this->keys[self::ENCRYPT]); $i < $c; ++$i) { + $k[self::ENCRYPT][$i] = '$ke[' . $i . ']'; + $k[self::DECRYPT][$i] = '$kd[' . $i . ']'; + } + $init_encrypt = '$ke = $self->keys[$self::ENCRYPT];'; + $init_decrypt = '$kd = $self->keys[$self::DECRYPT];'; + break; + } + + // Creating code for en- and decryption. + $crypt_block = array(); + foreach (array(self::ENCRYPT, self::DECRYPT) as $c) { + /* Do the initial IP permutation. */ + $crypt_block[$c] = ' + $in = unpack("N*", $in); + $l = $in[1]; + $r = $in[2]; + $in = unpack("N*", + ($shuffleip[ $r & 0xFF] & "\x80\x80\x80\x80\x80\x80\x80\x80") | + ($shuffleip[($r >> 8) & 0xFF] & "\x40\x40\x40\x40\x40\x40\x40\x40") | + ($shuffleip[($r >> 16) & 0xFF] & "\x20\x20\x20\x20\x20\x20\x20\x20") | + ($shuffleip[($r >> 24) & 0xFF] & "\x10\x10\x10\x10\x10\x10\x10\x10") | + ($shuffleip[ $l & 0xFF] & "\x08\x08\x08\x08\x08\x08\x08\x08") | + ($shuffleip[($l >> 8) & 0xFF] & "\x04\x04\x04\x04\x04\x04\x04\x04") | + ($shuffleip[($l >> 16) & 0xFF] & "\x02\x02\x02\x02\x02\x02\x02\x02") | + ($shuffleip[($l >> 24) & 0xFF] & "\x01\x01\x01\x01\x01\x01\x01\x01") + ); + ' . /* Extract L0 and R0 */ ' + $l = $in[1]; + $r = $in[2]; + '; + + $l = '$l'; + $r = '$r'; + + // Perform DES or 3DES. + for ($ki = -1, $des_round = 0; $des_round < $des_rounds; ++$des_round) { + // Perform the 16 steps. + for ($i = 0; $i < 16; ++$i) { + // start of "the Feistel (F) function" - see the following URL: + // http://en.wikipedia.org/wiki/Image:Data_Encryption_Standard_InfoBox_Diagram.png + // Merge key schedule. + $crypt_block[$c].= ' + $b1 = ((' . $r . ' >> 3) & 0x1FFFFFFF) ^ (' . $r . ' << 29) ^ ' . $k[$c][++$ki] . '; + $b2 = ((' . $r . ' >> 31) & 0x00000001) ^ (' . $r . ' << 1) ^ ' . $k[$c][++$ki] . ';' . + /* S-box indexing. */ + $l . ' = $sbox1[($b1 >> 24) & 0x3F] ^ $sbox2[($b2 >> 24) & 0x3F] ^ + $sbox3[($b1 >> 16) & 0x3F] ^ $sbox4[($b2 >> 16) & 0x3F] ^ + $sbox5[($b1 >> 8) & 0x3F] ^ $sbox6[($b2 >> 8) & 0x3F] ^ + $sbox7[ $b1 & 0x3F] ^ $sbox8[ $b2 & 0x3F] ^ ' . $l . '; + '; + // end of "the Feistel (F) function" + + // swap L & R + list($l, $r) = array($r, $l); + } + list($l, $r) = array($r, $l); + } + + // Perform the inverse IP permutation. + $crypt_block[$c].= '$in = + ($shuffleinvip[($l >> 24) & 0xFF] & "\x80\x80\x80\x80\x80\x80\x80\x80") | + ($shuffleinvip[($r >> 24) & 0xFF] & "\x40\x40\x40\x40\x40\x40\x40\x40") | + ($shuffleinvip[($l >> 16) & 0xFF] & "\x20\x20\x20\x20\x20\x20\x20\x20") | + ($shuffleinvip[($r >> 16) & 0xFF] & "\x10\x10\x10\x10\x10\x10\x10\x10") | + ($shuffleinvip[($l >> 8) & 0xFF] & "\x08\x08\x08\x08\x08\x08\x08\x08") | + ($shuffleinvip[($r >> 8) & 0xFF] & "\x04\x04\x04\x04\x04\x04\x04\x04") | + ($shuffleinvip[ $l & 0xFF] & "\x02\x02\x02\x02\x02\x02\x02\x02") | + ($shuffleinvip[ $r & 0xFF] & "\x01\x01\x01\x01\x01\x01\x01\x01"); + '; + } + + // Creates the inline-crypt function + $lambda_functions[$code_hash] = $this->_createInlineCryptFunction( + array( + 'init_crypt' => $init_crypt, + 'init_encrypt' => $init_encrypt, + 'init_decrypt' => $init_decrypt, + 'encrypt_block' => $crypt_block[self::ENCRYPT], + 'decrypt_block' => $crypt_block[self::DECRYPT] + ) + ); + } + + // Set the inline-crypt function as callback in: $this->inline_crypt + $this->inline_crypt = $lambda_functions[$code_hash]; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Hash.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Hash.php new file mode 100644 index 0000000..6ae0132 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Hash.php @@ -0,0 +1,829 @@ + + * setKey('abcdefg'); + * + * echo base64_encode($hash->hash('abcdefg')); + * ?> + * + * + * @category Crypt + * @package Hash + * @author Jim Wigginton + * @copyright 2007 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +use phpseclib\Math\BigInteger; + +/** + * Pure-PHP implementations of keyed-hash message authentication codes (HMACs) and various cryptographic hashing functions. + * + * @package Hash + * @author Jim Wigginton + * @access public + */ +class Hash +{ + /**#@+ + * @access private + * @see \phpseclib\Crypt\Hash::__construct() + */ + /** + * Toggles the internal implementation + */ + const MODE_INTERNAL = 1; + /** + * Toggles the mhash() implementation, which has been deprecated on PHP 5.3.0+. + */ + const MODE_MHASH = 2; + /** + * Toggles the hash() implementation, which works on PHP 5.1.2+. + */ + const MODE_HASH = 3; + /**#@-*/ + + /** + * Hash Parameter + * + * @see self::setHash() + * @var int + * @access private + */ + var $hashParam; + + /** + * Byte-length of compression blocks / key (Internal HMAC) + * + * @see self::setAlgorithm() + * @var int + * @access private + */ + var $b; + + /** + * Byte-length of hash output (Internal HMAC) + * + * @see self::setHash() + * @var int + * @access private + */ + var $l = false; + + /** + * Hash Algorithm + * + * @see self::setHash() + * @var string + * @access private + */ + var $hash; + + /** + * Key + * + * @see self::setKey() + * @var string + * @access private + */ + var $key = false; + + /** + * Outer XOR (Internal HMAC) + * + * @see self::setKey() + * @var string + * @access private + */ + var $opad; + + /** + * Inner XOR (Internal HMAC) + * + * @see self::setKey() + * @var string + * @access private + */ + var $ipad; + + /** + * Default Constructor. + * + * @param string $hash + * @return \phpseclib\Crypt\Hash + * @access public + */ + function __construct($hash = 'sha1') + { + if (!defined('CRYPT_HASH_MODE')) { + switch (true) { + case extension_loaded('hash'): + define('CRYPT_HASH_MODE', self::MODE_HASH); + break; + case extension_loaded('mhash'): + define('CRYPT_HASH_MODE', self::MODE_MHASH); + break; + default: + define('CRYPT_HASH_MODE', self::MODE_INTERNAL); + } + } + + $this->setHash($hash); + } + + /** + * Sets the key for HMACs + * + * Keys can be of any length. + * + * @access public + * @param string $key + */ + function setKey($key = false) + { + $this->key = $key; + } + + /** + * Gets the hash function. + * + * As set by the constructor or by the setHash() method. + * + * @access public + * @return string + */ + function getHash() + { + return $this->hashParam; + } + + /** + * Sets the hash function. + * + * @access public + * @param string $hash + */ + function setHash($hash) + { + $this->hashParam = $hash = strtolower($hash); + switch ($hash) { + case 'md5-96': + case 'sha1-96': + case 'sha256-96': + case 'sha512-96': + $hash = substr($hash, 0, -3); + $this->l = 12; // 96 / 8 = 12 + break; + case 'md2': + case 'md5': + $this->l = 16; + break; + case 'sha1': + $this->l = 20; + break; + case 'sha256': + $this->l = 32; + break; + case 'sha384': + $this->l = 48; + break; + case 'sha512': + $this->l = 64; + } + + switch ($hash) { + case 'md2': + $mode = CRYPT_HASH_MODE == self::MODE_HASH && in_array('md2', hash_algos()) ? + self::MODE_HASH : self::MODE_INTERNAL; + break; + case 'sha384': + case 'sha512': + $mode = CRYPT_HASH_MODE == self::MODE_MHASH ? self::MODE_INTERNAL : CRYPT_HASH_MODE; + break; + default: + $mode = CRYPT_HASH_MODE; + } + + switch ($mode) { + case self::MODE_MHASH: + switch ($hash) { + case 'md5': + $this->hash = MHASH_MD5; + break; + case 'sha256': + $this->hash = MHASH_SHA256; + break; + case 'sha1': + default: + $this->hash = MHASH_SHA1; + } + return; + case self::MODE_HASH: + switch ($hash) { + case 'md5': + $this->hash = 'md5'; + return; + case 'md2': + case 'sha256': + case 'sha384': + case 'sha512': + $this->hash = $hash; + return; + case 'sha1': + default: + $this->hash = 'sha1'; + } + return; + } + + switch ($hash) { + case 'md2': + $this->b = 16; + $this->hash = array($this, '_md2'); + break; + case 'md5': + $this->b = 64; + $this->hash = array($this, '_md5'); + break; + case 'sha256': + $this->b = 64; + $this->hash = array($this, '_sha256'); + break; + case 'sha384': + case 'sha512': + $this->b = 128; + $this->hash = array($this, '_sha512'); + break; + case 'sha1': + default: + $this->b = 64; + $this->hash = array($this, '_sha1'); + } + + $this->ipad = str_repeat(chr(0x36), $this->b); + $this->opad = str_repeat(chr(0x5C), $this->b); + } + + /** + * Compute the HMAC. + * + * @access public + * @param string $text + * @return string + */ + function hash($text) + { + $mode = is_array($this->hash) ? self::MODE_INTERNAL : CRYPT_HASH_MODE; + + if (!empty($this->key) || is_string($this->key)) { + switch ($mode) { + case self::MODE_MHASH: + $output = mhash($this->hash, $text, $this->key); + break; + case self::MODE_HASH: + $output = hash_hmac($this->hash, $text, $this->key, true); + break; + case self::MODE_INTERNAL: + /* "Applications that use keys longer than B bytes will first hash the key using H and then use the + resultant L byte string as the actual key to HMAC." + + -- http://tools.ietf.org/html/rfc2104#section-2 */ + $key = strlen($this->key) > $this->b ? call_user_func($this->hash, $this->key) : $this->key; + + $key = str_pad($key, $this->b, chr(0)); // step 1 + $temp = $this->ipad ^ $key; // step 2 + $temp .= $text; // step 3 + $temp = call_user_func($this->hash, $temp); // step 4 + $output = $this->opad ^ $key; // step 5 + $output.= $temp; // step 6 + $output = call_user_func($this->hash, $output); // step 7 + } + } else { + switch ($mode) { + case self::MODE_MHASH: + $output = mhash($this->hash, $text); + break; + case self::MODE_HASH: + $output = hash($this->hash, $text, true); + break; + case self::MODE_INTERNAL: + $output = call_user_func($this->hash, $text); + } + } + + return substr($output, 0, $this->l); + } + + /** + * Returns the hash length (in bytes) + * + * @access public + * @return int + */ + function getLength() + { + return $this->l; + } + + /** + * Wrapper for MD5 + * + * @access private + * @param string $m + */ + function _md5($m) + { + return pack('H*', md5($m)); + } + + /** + * Wrapper for SHA1 + * + * @access private + * @param string $m + */ + function _sha1($m) + { + return pack('H*', sha1($m)); + } + + /** + * Pure-PHP implementation of MD2 + * + * See {@link http://tools.ietf.org/html/rfc1319 RFC1319}. + * + * @access private + * @param string $m + */ + function _md2($m) + { + static $s = array( + 41, 46, 67, 201, 162, 216, 124, 1, 61, 54, 84, 161, 236, 240, 6, + 19, 98, 167, 5, 243, 192, 199, 115, 140, 152, 147, 43, 217, 188, + 76, 130, 202, 30, 155, 87, 60, 253, 212, 224, 22, 103, 66, 111, 24, + 138, 23, 229, 18, 190, 78, 196, 214, 218, 158, 222, 73, 160, 251, + 245, 142, 187, 47, 238, 122, 169, 104, 121, 145, 21, 178, 7, 63, + 148, 194, 16, 137, 11, 34, 95, 33, 128, 127, 93, 154, 90, 144, 50, + 39, 53, 62, 204, 231, 191, 247, 151, 3, 255, 25, 48, 179, 72, 165, + 181, 209, 215, 94, 146, 42, 172, 86, 170, 198, 79, 184, 56, 210, + 150, 164, 125, 182, 118, 252, 107, 226, 156, 116, 4, 241, 69, 157, + 112, 89, 100, 113, 135, 32, 134, 91, 207, 101, 230, 45, 168, 2, 27, + 96, 37, 173, 174, 176, 185, 246, 28, 70, 97, 105, 52, 64, 126, 15, + 85, 71, 163, 35, 221, 81, 175, 58, 195, 92, 249, 206, 186, 197, + 234, 38, 44, 83, 13, 110, 133, 40, 132, 9, 211, 223, 205, 244, 65, + 129, 77, 82, 106, 220, 55, 200, 108, 193, 171, 250, 36, 225, 123, + 8, 12, 189, 177, 74, 120, 136, 149, 139, 227, 99, 232, 109, 233, + 203, 213, 254, 59, 0, 29, 57, 242, 239, 183, 14, 102, 88, 208, 228, + 166, 119, 114, 248, 235, 117, 75, 10, 49, 68, 80, 180, 143, 237, + 31, 26, 219, 153, 141, 51, 159, 17, 131, 20 + ); + + // Step 1. Append Padding Bytes + $pad = 16 - (strlen($m) & 0xF); + $m.= str_repeat(chr($pad), $pad); + + $length = strlen($m); + + // Step 2. Append Checksum + $c = str_repeat(chr(0), 16); + $l = chr(0); + for ($i = 0; $i < $length; $i+= 16) { + for ($j = 0; $j < 16; $j++) { + // RFC1319 incorrectly states that C[j] should be set to S[c xor L] + //$c[$j] = chr($s[ord($m[$i + $j] ^ $l)]); + // per , however, C[j] should be set to S[c xor L] xor C[j] + $c[$j] = chr($s[ord($m[$i + $j] ^ $l)] ^ ord($c[$j])); + $l = $c[$j]; + } + } + $m.= $c; + + $length+= 16; + + // Step 3. Initialize MD Buffer + $x = str_repeat(chr(0), 48); + + // Step 4. Process Message in 16-Byte Blocks + for ($i = 0; $i < $length; $i+= 16) { + for ($j = 0; $j < 16; $j++) { + $x[$j + 16] = $m[$i + $j]; + $x[$j + 32] = $x[$j + 16] ^ $x[$j]; + } + $t = chr(0); + for ($j = 0; $j < 18; $j++) { + for ($k = 0; $k < 48; $k++) { + $x[$k] = $t = $x[$k] ^ chr($s[ord($t)]); + //$t = $x[$k] = $x[$k] ^ chr($s[ord($t)]); + } + $t = chr(ord($t) + $j); + } + } + + // Step 5. Output + return substr($x, 0, 16); + } + + /** + * Pure-PHP implementation of SHA256 + * + * See {@link http://en.wikipedia.org/wiki/SHA_hash_functions#SHA-256_.28a_SHA-2_variant.29_pseudocode SHA-256 (a SHA-2 variant) pseudocode - Wikipedia}. + * + * @access private + * @param string $m + */ + function _sha256($m) + { + if (extension_loaded('suhosin')) { + return pack('H*', sha256($m)); + } + + // Initialize variables + $hash = array( + 0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19 + ); + // Initialize table of round constants + // (first 32 bits of the fractional parts of the cube roots of the first 64 primes 2..311) + static $k = array( + 0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, + 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, + 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, + 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967, + 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, + 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070, + 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3, + 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2 + ); + + // Pre-processing + $length = strlen($m); + // to round to nearest 56 mod 64, we'll add 64 - (length + (64 - 56)) % 64 + $m.= str_repeat(chr(0), 64 - (($length + 8) & 0x3F)); + $m[$length] = chr(0x80); + // we don't support hashing strings 512MB long + $m.= pack('N2', 0, $length << 3); + + // Process the message in successive 512-bit chunks + $chunks = str_split($m, 64); + foreach ($chunks as $chunk) { + $w = array(); + for ($i = 0; $i < 16; $i++) { + extract(unpack('Ntemp', $this->_string_shift($chunk, 4))); + $w[] = $temp; + } + + // Extend the sixteen 32-bit words into sixty-four 32-bit words + for ($i = 16; $i < 64; $i++) { + // @codingStandardsIgnoreStart + $s0 = $this->_rightRotate($w[$i - 15], 7) ^ + $this->_rightRotate($w[$i - 15], 18) ^ + $this->_rightShift( $w[$i - 15], 3); + $s1 = $this->_rightRotate($w[$i - 2], 17) ^ + $this->_rightRotate($w[$i - 2], 19) ^ + $this->_rightShift( $w[$i - 2], 10); + // @codingStandardsIgnoreEnd + $w[$i] = $this->_add($w[$i - 16], $s0, $w[$i - 7], $s1); + } + + // Initialize hash value for this chunk + list($a, $b, $c, $d, $e, $f, $g, $h) = $hash; + + // Main loop + for ($i = 0; $i < 64; $i++) { + $s0 = $this->_rightRotate($a, 2) ^ + $this->_rightRotate($a, 13) ^ + $this->_rightRotate($a, 22); + $maj = ($a & $b) ^ + ($a & $c) ^ + ($b & $c); + $t2 = $this->_add($s0, $maj); + + $s1 = $this->_rightRotate($e, 6) ^ + $this->_rightRotate($e, 11) ^ + $this->_rightRotate($e, 25); + $ch = ($e & $f) ^ + ($this->_not($e) & $g); + $t1 = $this->_add($h, $s1, $ch, $k[$i], $w[$i]); + + $h = $g; + $g = $f; + $f = $e; + $e = $this->_add($d, $t1); + $d = $c; + $c = $b; + $b = $a; + $a = $this->_add($t1, $t2); + } + + // Add this chunk's hash to result so far + $hash = array( + $this->_add($hash[0], $a), + $this->_add($hash[1], $b), + $this->_add($hash[2], $c), + $this->_add($hash[3], $d), + $this->_add($hash[4], $e), + $this->_add($hash[5], $f), + $this->_add($hash[6], $g), + $this->_add($hash[7], $h) + ); + } + + // Produce the final hash value (big-endian) + return pack('N8', $hash[0], $hash[1], $hash[2], $hash[3], $hash[4], $hash[5], $hash[6], $hash[7]); + } + + /** + * Pure-PHP implementation of SHA384 and SHA512 + * + * @access private + * @param string $m + */ + function _sha512($m) + { + static $init384, $init512, $k; + + if (!isset($k)) { + // Initialize variables + $init384 = array( // initial values for SHA384 + 'cbbb9d5dc1059ed8', '629a292a367cd507', '9159015a3070dd17', '152fecd8f70e5939', + '67332667ffc00b31', '8eb44a8768581511', 'db0c2e0d64f98fa7', '47b5481dbefa4fa4' + ); + $init512 = array( // initial values for SHA512 + '6a09e667f3bcc908', 'bb67ae8584caa73b', '3c6ef372fe94f82b', 'a54ff53a5f1d36f1', + '510e527fade682d1', '9b05688c2b3e6c1f', '1f83d9abfb41bd6b', '5be0cd19137e2179' + ); + + for ($i = 0; $i < 8; $i++) { + $init384[$i] = new BigInteger($init384[$i], 16); + $init384[$i]->setPrecision(64); + $init512[$i] = new BigInteger($init512[$i], 16); + $init512[$i]->setPrecision(64); + } + + // Initialize table of round constants + // (first 64 bits of the fractional parts of the cube roots of the first 80 primes 2..409) + $k = array( + '428a2f98d728ae22', '7137449123ef65cd', 'b5c0fbcfec4d3b2f', 'e9b5dba58189dbbc', + '3956c25bf348b538', '59f111f1b605d019', '923f82a4af194f9b', 'ab1c5ed5da6d8118', + 'd807aa98a3030242', '12835b0145706fbe', '243185be4ee4b28c', '550c7dc3d5ffb4e2', + '72be5d74f27b896f', '80deb1fe3b1696b1', '9bdc06a725c71235', 'c19bf174cf692694', + 'e49b69c19ef14ad2', 'efbe4786384f25e3', '0fc19dc68b8cd5b5', '240ca1cc77ac9c65', + '2de92c6f592b0275', '4a7484aa6ea6e483', '5cb0a9dcbd41fbd4', '76f988da831153b5', + '983e5152ee66dfab', 'a831c66d2db43210', 'b00327c898fb213f', 'bf597fc7beef0ee4', + 'c6e00bf33da88fc2', 'd5a79147930aa725', '06ca6351e003826f', '142929670a0e6e70', + '27b70a8546d22ffc', '2e1b21385c26c926', '4d2c6dfc5ac42aed', '53380d139d95b3df', + '650a73548baf63de', '766a0abb3c77b2a8', '81c2c92e47edaee6', '92722c851482353b', + 'a2bfe8a14cf10364', 'a81a664bbc423001', 'c24b8b70d0f89791', 'c76c51a30654be30', + 'd192e819d6ef5218', 'd69906245565a910', 'f40e35855771202a', '106aa07032bbd1b8', + '19a4c116b8d2d0c8', '1e376c085141ab53', '2748774cdf8eeb99', '34b0bcb5e19b48a8', + '391c0cb3c5c95a63', '4ed8aa4ae3418acb', '5b9cca4f7763e373', '682e6ff3d6b2b8a3', + '748f82ee5defb2fc', '78a5636f43172f60', '84c87814a1f0ab72', '8cc702081a6439ec', + '90befffa23631e28', 'a4506cebde82bde9', 'bef9a3f7b2c67915', 'c67178f2e372532b', + 'ca273eceea26619c', 'd186b8c721c0c207', 'eada7dd6cde0eb1e', 'f57d4f7fee6ed178', + '06f067aa72176fba', '0a637dc5a2c898a6', '113f9804bef90dae', '1b710b35131c471b', + '28db77f523047d84', '32caab7b40c72493', '3c9ebe0a15c9bebc', '431d67c49c100d4c', + '4cc5d4becb3e42b6', '597f299cfc657e2a', '5fcb6fab3ad6faec', '6c44198c4a475817' + ); + + for ($i = 0; $i < 80; $i++) { + $k[$i] = new BigInteger($k[$i], 16); + } + } + + $hash = $this->l == 48 ? $init384 : $init512; + + // Pre-processing + $length = strlen($m); + // to round to nearest 112 mod 128, we'll add 128 - (length + (128 - 112)) % 128 + $m.= str_repeat(chr(0), 128 - (($length + 16) & 0x7F)); + $m[$length] = chr(0x80); + // we don't support hashing strings 512MB long + $m.= pack('N4', 0, 0, 0, $length << 3); + + // Process the message in successive 1024-bit chunks + $chunks = str_split($m, 128); + foreach ($chunks as $chunk) { + $w = array(); + for ($i = 0; $i < 16; $i++) { + $temp = new BigInteger($this->_string_shift($chunk, 8), 256); + $temp->setPrecision(64); + $w[] = $temp; + } + + // Extend the sixteen 32-bit words into eighty 32-bit words + for ($i = 16; $i < 80; $i++) { + $temp = array( + $w[$i - 15]->bitwise_rightRotate(1), + $w[$i - 15]->bitwise_rightRotate(8), + $w[$i - 15]->bitwise_rightShift(7) + ); + $s0 = $temp[0]->bitwise_xor($temp[1]); + $s0 = $s0->bitwise_xor($temp[2]); + $temp = array( + $w[$i - 2]->bitwise_rightRotate(19), + $w[$i - 2]->bitwise_rightRotate(61), + $w[$i - 2]->bitwise_rightShift(6) + ); + $s1 = $temp[0]->bitwise_xor($temp[1]); + $s1 = $s1->bitwise_xor($temp[2]); + $w[$i] = $w[$i - 16]->copy(); + $w[$i] = $w[$i]->add($s0); + $w[$i] = $w[$i]->add($w[$i - 7]); + $w[$i] = $w[$i]->add($s1); + } + + // Initialize hash value for this chunk + $a = $hash[0]->copy(); + $b = $hash[1]->copy(); + $c = $hash[2]->copy(); + $d = $hash[3]->copy(); + $e = $hash[4]->copy(); + $f = $hash[5]->copy(); + $g = $hash[6]->copy(); + $h = $hash[7]->copy(); + + // Main loop + for ($i = 0; $i < 80; $i++) { + $temp = array( + $a->bitwise_rightRotate(28), + $a->bitwise_rightRotate(34), + $a->bitwise_rightRotate(39) + ); + $s0 = $temp[0]->bitwise_xor($temp[1]); + $s0 = $s0->bitwise_xor($temp[2]); + $temp = array( + $a->bitwise_and($b), + $a->bitwise_and($c), + $b->bitwise_and($c) + ); + $maj = $temp[0]->bitwise_xor($temp[1]); + $maj = $maj->bitwise_xor($temp[2]); + $t2 = $s0->add($maj); + + $temp = array( + $e->bitwise_rightRotate(14), + $e->bitwise_rightRotate(18), + $e->bitwise_rightRotate(41) + ); + $s1 = $temp[0]->bitwise_xor($temp[1]); + $s1 = $s1->bitwise_xor($temp[2]); + $temp = array( + $e->bitwise_and($f), + $g->bitwise_and($e->bitwise_not()) + ); + $ch = $temp[0]->bitwise_xor($temp[1]); + $t1 = $h->add($s1); + $t1 = $t1->add($ch); + $t1 = $t1->add($k[$i]); + $t1 = $t1->add($w[$i]); + + $h = $g->copy(); + $g = $f->copy(); + $f = $e->copy(); + $e = $d->add($t1); + $d = $c->copy(); + $c = $b->copy(); + $b = $a->copy(); + $a = $t1->add($t2); + } + + // Add this chunk's hash to result so far + $hash = array( + $hash[0]->add($a), + $hash[1]->add($b), + $hash[2]->add($c), + $hash[3]->add($d), + $hash[4]->add($e), + $hash[5]->add($f), + $hash[6]->add($g), + $hash[7]->add($h) + ); + } + + // Produce the final hash value (big-endian) + // (\phpseclib\Crypt\Hash::hash() trims the output for hashes but not for HMACs. as such, we trim the output here) + $temp = $hash[0]->toBytes() . $hash[1]->toBytes() . $hash[2]->toBytes() . $hash[3]->toBytes() . + $hash[4]->toBytes() . $hash[5]->toBytes(); + if ($this->l != 48) { + $temp.= $hash[6]->toBytes() . $hash[7]->toBytes(); + } + + return $temp; + } + + /** + * Right Rotate + * + * @access private + * @param int $int + * @param int $amt + * @see self::_sha256() + * @return int + */ + function _rightRotate($int, $amt) + { + $invamt = 32 - $amt; + $mask = (1 << $invamt) - 1; + return (($int << $invamt) & 0xFFFFFFFF) | (($int >> $amt) & $mask); + } + + /** + * Right Shift + * + * @access private + * @param int $int + * @param int $amt + * @see self::_sha256() + * @return int + */ + function _rightShift($int, $amt) + { + $mask = (1 << (32 - $amt)) - 1; + return ($int >> $amt) & $mask; + } + + /** + * Not + * + * @access private + * @param int $int + * @see self::_sha256() + * @return int + */ + function _not($int) + { + return ~$int & 0xFFFFFFFF; + } + + /** + * Add + * + * _sha256() adds multiple unsigned 32-bit integers. Since PHP doesn't support unsigned integers and since the + * possibility of overflow exists, care has to be taken. BigInteger could be used but this should be faster. + * + * @param int $... + * @return int + * @see self::_sha256() + * @access private + */ + function _add() + { + static $mod; + if (!isset($mod)) { + $mod = pow(2, 32); + } + + $result = 0; + $arguments = func_get_args(); + foreach ($arguments as $argument) { + $result+= $argument < 0 ? ($argument & 0x7FFFFFFF) + 0x80000000 : $argument; + } + + if ((php_uname('m') & "\xDF\xDF\xDF") != 'ARM') { + return fmod($result, $mod); + } + + return (fmod($result, 0x80000000) & 0x7FFFFFFF) | + ((fmod(floor($result / 0x80000000), 2) & 1) << 31); + } + + /** + * String Shift + * + * Inspired by array_shift + * + * @param string $string + * @param int $index + * @return string + * @access private + */ + function _string_shift(&$string, $index = 1) + { + $substr = substr($string, 0, $index); + $string = substr($string, $index); + return $substr; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RC2.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RC2.php new file mode 100644 index 0000000..b2b9d48 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RC2.php @@ -0,0 +1,688 @@ + + * setKey('abcdefgh'); + * + * $plaintext = str_repeat('a', 1024); + * + * echo $rc2->decrypt($rc2->encrypt($plaintext)); + * ?> + * + * + * @category Crypt + * @package RC2 + * @author Patrick Monnerat + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP implementation of RC2. + * + * @package RC2 + * @access public + */ +class RC2 extends Base +{ + /** + * Block Length of the cipher + * + * @see \phpseclib\Crypt\Base::block_size + * @var int + * @access private + */ + var $block_size = 8; + + /** + * The Key + * + * @see \phpseclib\Crypt\Base::key + * @see self::setKey() + * @var string + * @access private + */ + var $key; + + /** + * The Original (unpadded) Key + * + * @see \phpseclib\Crypt\Base::key + * @see self::setKey() + * @see self::encrypt() + * @see self::decrypt() + * @var string + * @access private + */ + var $orig_key; + + /** + * Don't truncate / null pad key + * + * @see \phpseclib\Crypt\Base::_clearBuffers() + * @var bool + * @access private + */ + var $skip_key_adjustment = true; + + /** + * Key Length (in bytes) + * + * @see \phpseclib\Crypt\RC2::setKeyLength() + * @var int + * @access private + */ + var $key_length = 16; // = 128 bits + + /** + * The mcrypt specific name of the cipher + * + * @see \phpseclib\Crypt\Base::cipher_name_mcrypt + * @var string + * @access private + */ + var $cipher_name_mcrypt = 'rc2'; + + /** + * Optimizing value while CFB-encrypting + * + * @see \phpseclib\Crypt\Base::cfb_init_len + * @var int + * @access private + */ + var $cfb_init_len = 500; + + /** + * The key length in bits. + * + * @see self::setKeyLength() + * @see self::setKey() + * @var int + * @access private + * @internal Should be in range [1..1024]. + * @internal Changing this value after setting the key has no effect. + */ + var $default_key_length = 1024; + + /** + * The key length in bits. + * + * @see self::isValidEnine() + * @see self::setKey() + * @var int + * @access private + * @internal Should be in range [1..1024]. + */ + var $current_key_length; + + /** + * The Key Schedule + * + * @see self::_setupKey() + * @var array + * @access private + */ + var $keys; + + /** + * Key expansion randomization table. + * Twice the same 256-value sequence to save a modulus in key expansion. + * + * @see self::setKey() + * @var array + * @access private + */ + var $pitable = array( + 0xD9, 0x78, 0xF9, 0xC4, 0x19, 0xDD, 0xB5, 0xED, + 0x28, 0xE9, 0xFD, 0x79, 0x4A, 0xA0, 0xD8, 0x9D, + 0xC6, 0x7E, 0x37, 0x83, 0x2B, 0x76, 0x53, 0x8E, + 0x62, 0x4C, 0x64, 0x88, 0x44, 0x8B, 0xFB, 0xA2, + 0x17, 0x9A, 0x59, 0xF5, 0x87, 0xB3, 0x4F, 0x13, + 0x61, 0x45, 0x6D, 0x8D, 0x09, 0x81, 0x7D, 0x32, + 0xBD, 0x8F, 0x40, 0xEB, 0x86, 0xB7, 0x7B, 0x0B, + 0xF0, 0x95, 0x21, 0x22, 0x5C, 0x6B, 0x4E, 0x82, + 0x54, 0xD6, 0x65, 0x93, 0xCE, 0x60, 0xB2, 0x1C, + 0x73, 0x56, 0xC0, 0x14, 0xA7, 0x8C, 0xF1, 0xDC, + 0x12, 0x75, 0xCA, 0x1F, 0x3B, 0xBE, 0xE4, 0xD1, + 0x42, 0x3D, 0xD4, 0x30, 0xA3, 0x3C, 0xB6, 0x26, + 0x6F, 0xBF, 0x0E, 0xDA, 0x46, 0x69, 0x07, 0x57, + 0x27, 0xF2, 0x1D, 0x9B, 0xBC, 0x94, 0x43, 0x03, + 0xF8, 0x11, 0xC7, 0xF6, 0x90, 0xEF, 0x3E, 0xE7, + 0x06, 0xC3, 0xD5, 0x2F, 0xC8, 0x66, 0x1E, 0xD7, + 0x08, 0xE8, 0xEA, 0xDE, 0x80, 0x52, 0xEE, 0xF7, + 0x84, 0xAA, 0x72, 0xAC, 0x35, 0x4D, 0x6A, 0x2A, + 0x96, 0x1A, 0xD2, 0x71, 0x5A, 0x15, 0x49, 0x74, + 0x4B, 0x9F, 0xD0, 0x5E, 0x04, 0x18, 0xA4, 0xEC, + 0xC2, 0xE0, 0x41, 0x6E, 0x0F, 0x51, 0xCB, 0xCC, + 0x24, 0x91, 0xAF, 0x50, 0xA1, 0xF4, 0x70, 0x39, + 0x99, 0x7C, 0x3A, 0x85, 0x23, 0xB8, 0xB4, 0x7A, + 0xFC, 0x02, 0x36, 0x5B, 0x25, 0x55, 0x97, 0x31, + 0x2D, 0x5D, 0xFA, 0x98, 0xE3, 0x8A, 0x92, 0xAE, + 0x05, 0xDF, 0x29, 0x10, 0x67, 0x6C, 0xBA, 0xC9, + 0xD3, 0x00, 0xE6, 0xCF, 0xE1, 0x9E, 0xA8, 0x2C, + 0x63, 0x16, 0x01, 0x3F, 0x58, 0xE2, 0x89, 0xA9, + 0x0D, 0x38, 0x34, 0x1B, 0xAB, 0x33, 0xFF, 0xB0, + 0xBB, 0x48, 0x0C, 0x5F, 0xB9, 0xB1, 0xCD, 0x2E, + 0xC5, 0xF3, 0xDB, 0x47, 0xE5, 0xA5, 0x9C, 0x77, + 0x0A, 0xA6, 0x20, 0x68, 0xFE, 0x7F, 0xC1, 0xAD, + 0xD9, 0x78, 0xF9, 0xC4, 0x19, 0xDD, 0xB5, 0xED, + 0x28, 0xE9, 0xFD, 0x79, 0x4A, 0xA0, 0xD8, 0x9D, + 0xC6, 0x7E, 0x37, 0x83, 0x2B, 0x76, 0x53, 0x8E, + 0x62, 0x4C, 0x64, 0x88, 0x44, 0x8B, 0xFB, 0xA2, + 0x17, 0x9A, 0x59, 0xF5, 0x87, 0xB3, 0x4F, 0x13, + 0x61, 0x45, 0x6D, 0x8D, 0x09, 0x81, 0x7D, 0x32, + 0xBD, 0x8F, 0x40, 0xEB, 0x86, 0xB7, 0x7B, 0x0B, + 0xF0, 0x95, 0x21, 0x22, 0x5C, 0x6B, 0x4E, 0x82, + 0x54, 0xD6, 0x65, 0x93, 0xCE, 0x60, 0xB2, 0x1C, + 0x73, 0x56, 0xC0, 0x14, 0xA7, 0x8C, 0xF1, 0xDC, + 0x12, 0x75, 0xCA, 0x1F, 0x3B, 0xBE, 0xE4, 0xD1, + 0x42, 0x3D, 0xD4, 0x30, 0xA3, 0x3C, 0xB6, 0x26, + 0x6F, 0xBF, 0x0E, 0xDA, 0x46, 0x69, 0x07, 0x57, + 0x27, 0xF2, 0x1D, 0x9B, 0xBC, 0x94, 0x43, 0x03, + 0xF8, 0x11, 0xC7, 0xF6, 0x90, 0xEF, 0x3E, 0xE7, + 0x06, 0xC3, 0xD5, 0x2F, 0xC8, 0x66, 0x1E, 0xD7, + 0x08, 0xE8, 0xEA, 0xDE, 0x80, 0x52, 0xEE, 0xF7, + 0x84, 0xAA, 0x72, 0xAC, 0x35, 0x4D, 0x6A, 0x2A, + 0x96, 0x1A, 0xD2, 0x71, 0x5A, 0x15, 0x49, 0x74, + 0x4B, 0x9F, 0xD0, 0x5E, 0x04, 0x18, 0xA4, 0xEC, + 0xC2, 0xE0, 0x41, 0x6E, 0x0F, 0x51, 0xCB, 0xCC, + 0x24, 0x91, 0xAF, 0x50, 0xA1, 0xF4, 0x70, 0x39, + 0x99, 0x7C, 0x3A, 0x85, 0x23, 0xB8, 0xB4, 0x7A, + 0xFC, 0x02, 0x36, 0x5B, 0x25, 0x55, 0x97, 0x31, + 0x2D, 0x5D, 0xFA, 0x98, 0xE3, 0x8A, 0x92, 0xAE, + 0x05, 0xDF, 0x29, 0x10, 0x67, 0x6C, 0xBA, 0xC9, + 0xD3, 0x00, 0xE6, 0xCF, 0xE1, 0x9E, 0xA8, 0x2C, + 0x63, 0x16, 0x01, 0x3F, 0x58, 0xE2, 0x89, 0xA9, + 0x0D, 0x38, 0x34, 0x1B, 0xAB, 0x33, 0xFF, 0xB0, + 0xBB, 0x48, 0x0C, 0x5F, 0xB9, 0xB1, 0xCD, 0x2E, + 0xC5, 0xF3, 0xDB, 0x47, 0xE5, 0xA5, 0x9C, 0x77, + 0x0A, 0xA6, 0x20, 0x68, 0xFE, 0x7F, 0xC1, 0xAD + ); + + /** + * Inverse key expansion randomization table. + * + * @see self::setKey() + * @var array + * @access private + */ + var $invpitable = array( + 0xD1, 0xDA, 0xB9, 0x6F, 0x9C, 0xC8, 0x78, 0x66, + 0x80, 0x2C, 0xF8, 0x37, 0xEA, 0xE0, 0x62, 0xA4, + 0xCB, 0x71, 0x50, 0x27, 0x4B, 0x95, 0xD9, 0x20, + 0x9D, 0x04, 0x91, 0xE3, 0x47, 0x6A, 0x7E, 0x53, + 0xFA, 0x3A, 0x3B, 0xB4, 0xA8, 0xBC, 0x5F, 0x68, + 0x08, 0xCA, 0x8F, 0x14, 0xD7, 0xC0, 0xEF, 0x7B, + 0x5B, 0xBF, 0x2F, 0xE5, 0xE2, 0x8C, 0xBA, 0x12, + 0xE1, 0xAF, 0xB2, 0x54, 0x5D, 0x59, 0x76, 0xDB, + 0x32, 0xA2, 0x58, 0x6E, 0x1C, 0x29, 0x64, 0xF3, + 0xE9, 0x96, 0x0C, 0x98, 0x19, 0x8D, 0x3E, 0x26, + 0xAB, 0xA5, 0x85, 0x16, 0x40, 0xBD, 0x49, 0x67, + 0xDC, 0x22, 0x94, 0xBB, 0x3C, 0xC1, 0x9B, 0xEB, + 0x45, 0x28, 0x18, 0xD8, 0x1A, 0x42, 0x7D, 0xCC, + 0xFB, 0x65, 0x8E, 0x3D, 0xCD, 0x2A, 0xA3, 0x60, + 0xAE, 0x93, 0x8A, 0x48, 0x97, 0x51, 0x15, 0xF7, + 0x01, 0x0B, 0xB7, 0x36, 0xB1, 0x2E, 0x11, 0xFD, + 0x84, 0x2D, 0x3F, 0x13, 0x88, 0xB3, 0x34, 0x24, + 0x1B, 0xDE, 0xC5, 0x1D, 0x4D, 0x2B, 0x17, 0x31, + 0x74, 0xA9, 0xC6, 0x43, 0x6D, 0x39, 0x90, 0xBE, + 0xC3, 0xB0, 0x21, 0x6B, 0xF6, 0x0F, 0xD5, 0x99, + 0x0D, 0xAC, 0x1F, 0x5C, 0x9E, 0xF5, 0xF9, 0x4C, + 0xD6, 0xDF, 0x89, 0xE4, 0x8B, 0xFF, 0xC7, 0xAA, + 0xE7, 0xED, 0x46, 0x25, 0xB6, 0x06, 0x5E, 0x35, + 0xB5, 0xEC, 0xCE, 0xE8, 0x6C, 0x30, 0x55, 0x61, + 0x4A, 0xFE, 0xA0, 0x79, 0x03, 0xF0, 0x10, 0x72, + 0x7C, 0xCF, 0x52, 0xA6, 0xA7, 0xEE, 0x44, 0xD3, + 0x9A, 0x57, 0x92, 0xD0, 0x5A, 0x7A, 0x41, 0x7F, + 0x0E, 0x00, 0x63, 0xF2, 0x4F, 0x05, 0x83, 0xC9, + 0xA1, 0xD4, 0xDD, 0xC4, 0x56, 0xF4, 0xD2, 0x77, + 0x81, 0x09, 0x82, 0x33, 0x9F, 0x07, 0x86, 0x75, + 0x38, 0x4E, 0x69, 0xF1, 0xAD, 0x23, 0x73, 0x87, + 0x70, 0x02, 0xC2, 0x1E, 0xB8, 0x0A, 0xFC, 0xE6 + ); + + /** + * Test for engine validity + * + * This is mainly just a wrapper to set things up for \phpseclib\Crypt\Base::isValidEngine() + * + * @see \phpseclib\Crypt\Base::__construct() + * @param int $engine + * @access public + * @return bool + */ + function isValidEngine($engine) + { + switch ($engine) { + case self::ENGINE_OPENSSL: + if ($this->current_key_length != 128 || strlen($this->orig_key) < 16) { + return false; + } + $this->cipher_name_openssl_ecb = 'rc2-ecb'; + $this->cipher_name_openssl = 'rc2-' . $this->_openssl_translate_mode(); + } + + return parent::isValidEngine($engine); + } + + /** + * Sets the key length. + * + * Valid key lengths are 8 to 1024. + * Calling this function after setting the key has no effect until the next + * \phpseclib\Crypt\RC2::setKey() call. + * + * @access public + * @param int $length in bits + */ + function setKeyLength($length) + { + if ($length < 8) { + $this->default_key_length = 1; + } elseif ($length > 1024) { + $this->default_key_length = 128; + } else { + $this->default_key_length = $length; + } + $this->current_key_length = $this->default_key_length; + + parent::setKeyLength($length); + } + + /** + * Returns the current key length + * + * @access public + * @return int + */ + function getKeyLength() + { + return $this->current_key_length; + } + + /** + * Sets the key. + * + * Keys can be of any length. RC2, itself, uses 8 to 1024 bit keys (eg. + * strlen($key) <= 128), however, we only use the first 128 bytes if $key + * has more then 128 bytes in it, and set $key to a single null byte if + * it is empty. + * + * If the key is not explicitly set, it'll be assumed to be a single + * null byte. + * + * @see \phpseclib\Crypt\Base::setKey() + * @access public + * @param string $key + * @param int $t1 optional Effective key length in bits. + */ + function setKey($key, $t1 = 0) + { + $this->orig_key = $key; + + if ($t1 <= 0) { + $t1 = $this->default_key_length; + } elseif ($t1 > 1024) { + $t1 = 1024; + } + $this->current_key_length = $t1; + // Key byte count should be 1..128. + $key = strlen($key) ? substr($key, 0, 128) : "\x00"; + $t = strlen($key); + + // The mcrypt RC2 implementation only supports effective key length + // of 1024 bits. It is however possible to handle effective key + // lengths in range 1..1024 by expanding the key and applying + // inverse pitable mapping to the first byte before submitting it + // to mcrypt. + + // Key expansion. + $l = array_values(unpack('C*', $key)); + $t8 = ($t1 + 7) >> 3; + $tm = 0xFF >> (8 * $t8 - $t1); + + // Expand key. + $pitable = $this->pitable; + for ($i = $t; $i < 128; $i++) { + $l[$i] = $pitable[$l[$i - 1] + $l[$i - $t]]; + } + $i = 128 - $t8; + $l[$i] = $pitable[$l[$i] & $tm]; + while ($i--) { + $l[$i] = $pitable[$l[$i + 1] ^ $l[$i + $t8]]; + } + + // Prepare the key for mcrypt. + $l[0] = $this->invpitable[$l[0]]; + array_unshift($l, 'C*'); + + parent::setKey(call_user_func_array('pack', $l)); + } + + /** + * Encrypts a message. + * + * Mostly a wrapper for \phpseclib\Crypt\Base::encrypt, with some additional OpenSSL handling code + * + * @see self::decrypt() + * @access public + * @param string $plaintext + * @return string $ciphertext + */ + function encrypt($plaintext) + { + if ($this->engine == self::ENGINE_OPENSSL) { + $temp = $this->key; + $this->key = $this->orig_key; + $result = parent::encrypt($plaintext); + $this->key = $temp; + return $result; + } + + return parent::encrypt($plaintext); + } + + /** + * Decrypts a message. + * + * Mostly a wrapper for \phpseclib\Crypt\Base::decrypt, with some additional OpenSSL handling code + * + * @see self::encrypt() + * @access public + * @param string $ciphertext + * @return string $plaintext + */ + function decrypt($ciphertext) + { + if ($this->engine == self::ENGINE_OPENSSL) { + $temp = $this->key; + $this->key = $this->orig_key; + $result = parent::decrypt($ciphertext); + $this->key = $temp; + return $result; + } + + return parent::decrypt($ciphertext); + } + + /** + * Encrypts a block + * + * @see \phpseclib\Crypt\Base::_encryptBlock() + * @see \phpseclib\Crypt\Base::encrypt() + * @access private + * @param string $in + * @return string + */ + function _encryptBlock($in) + { + list($r0, $r1, $r2, $r3) = array_values(unpack('v*', $in)); + $keys = $this->keys; + $limit = 20; + $actions = array($limit => 44, 44 => 64); + $j = 0; + + for (;;) { + // Mixing round. + $r0 = (($r0 + $keys[$j++] + ((($r1 ^ $r2) & $r3) ^ $r1)) & 0xFFFF) << 1; + $r0 |= $r0 >> 16; + $r1 = (($r1 + $keys[$j++] + ((($r2 ^ $r3) & $r0) ^ $r2)) & 0xFFFF) << 2; + $r1 |= $r1 >> 16; + $r2 = (($r2 + $keys[$j++] + ((($r3 ^ $r0) & $r1) ^ $r3)) & 0xFFFF) << 3; + $r2 |= $r2 >> 16; + $r3 = (($r3 + $keys[$j++] + ((($r0 ^ $r1) & $r2) ^ $r0)) & 0xFFFF) << 5; + $r3 |= $r3 >> 16; + + if ($j === $limit) { + if ($limit === 64) { + break; + } + + // Mashing round. + $r0 += $keys[$r3 & 0x3F]; + $r1 += $keys[$r0 & 0x3F]; + $r2 += $keys[$r1 & 0x3F]; + $r3 += $keys[$r2 & 0x3F]; + $limit = $actions[$limit]; + } + } + + return pack('vvvv', $r0, $r1, $r2, $r3); + } + + /** + * Decrypts a block + * + * @see \phpseclib\Crypt\Base::_decryptBlock() + * @see \phpseclib\Crypt\Base::decrypt() + * @access private + * @param string $in + * @return string + */ + function _decryptBlock($in) + { + list($r0, $r1, $r2, $r3) = array_values(unpack('v*', $in)); + $keys = $this->keys; + $limit = 44; + $actions = array($limit => 20, 20 => 0); + $j = 64; + + for (;;) { + // R-mixing round. + $r3 = ($r3 | ($r3 << 16)) >> 5; + $r3 = ($r3 - $keys[--$j] - ((($r0 ^ $r1) & $r2) ^ $r0)) & 0xFFFF; + $r2 = ($r2 | ($r2 << 16)) >> 3; + $r2 = ($r2 - $keys[--$j] - ((($r3 ^ $r0) & $r1) ^ $r3)) & 0xFFFF; + $r1 = ($r1 | ($r1 << 16)) >> 2; + $r1 = ($r1 - $keys[--$j] - ((($r2 ^ $r3) & $r0) ^ $r2)) & 0xFFFF; + $r0 = ($r0 | ($r0 << 16)) >> 1; + $r0 = ($r0 - $keys[--$j] - ((($r1 ^ $r2) & $r3) ^ $r1)) & 0xFFFF; + + if ($j === $limit) { + if ($limit === 0) { + break; + } + + // R-mashing round. + $r3 = ($r3 - $keys[$r2 & 0x3F]) & 0xFFFF; + $r2 = ($r2 - $keys[$r1 & 0x3F]) & 0xFFFF; + $r1 = ($r1 - $keys[$r0 & 0x3F]) & 0xFFFF; + $r0 = ($r0 - $keys[$r3 & 0x3F]) & 0xFFFF; + $limit = $actions[$limit]; + } + } + + return pack('vvvv', $r0, $r1, $r2, $r3); + } + + /** + * Setup the \phpseclib\Crypt\Base::ENGINE_MCRYPT $engine + * + * @see \phpseclib\Crypt\Base::_setupMcrypt() + * @access private + */ + function _setupMcrypt() + { + if (!isset($this->key)) { + $this->setKey(''); + } + + parent::_setupMcrypt(); + } + + /** + * Creates the key schedule + * + * @see \phpseclib\Crypt\Base::_setupKey() + * @access private + */ + function _setupKey() + { + if (!isset($this->key)) { + $this->setKey(''); + } + + // Key has already been expanded in \phpseclib\Crypt\RC2::setKey(): + // Only the first value must be altered. + $l = unpack('Ca/Cb/v*', $this->key); + array_unshift($l, $this->pitable[$l['a']] | ($l['b'] << 8)); + unset($l['a']); + unset($l['b']); + $this->keys = $l; + } + + /** + * Setup the performance-optimized function for de/encrypt() + * + * @see \phpseclib\Crypt\Base::_setupInlineCrypt() + * @access private + */ + function _setupInlineCrypt() + { + $lambda_functions =& self::_getLambdaFunctions(); + + // The first 10 generated $lambda_functions will use the $keys hardcoded as integers + // for the mixing rounds, for better inline crypt performance [~20% faster]. + // But for memory reason we have to limit those ultra-optimized $lambda_functions to an amount of 10. + // (Currently, for Crypt_RC2, one generated $lambda_function cost on php5.5@32bit ~60kb unfreeable mem and ~100kb on php5.5@64bit) + $gen_hi_opt_code = (bool)(count($lambda_functions) < 10); + + // Generation of a unique hash for our generated code + $code_hash = "Crypt_RC2, {$this->mode}"; + if ($gen_hi_opt_code) { + $code_hash = str_pad($code_hash, 32) . $this->_hashInlineCryptFunction($this->key); + } + + // Is there a re-usable $lambda_functions in there? + // If not, we have to create it. + if (!isset($lambda_functions[$code_hash])) { + // Init code for both, encrypt and decrypt. + $init_crypt = '$keys = $self->keys;'; + + switch (true) { + case $gen_hi_opt_code: + $keys = $this->keys; + default: + $keys = array(); + foreach ($this->keys as $k => $v) { + $keys[$k] = '$keys[' . $k . ']'; + } + } + + // $in is the current 8 bytes block which has to be en/decrypt + $encrypt_block = $decrypt_block = ' + $in = unpack("v4", $in); + $r0 = $in[1]; + $r1 = $in[2]; + $r2 = $in[3]; + $r3 = $in[4]; + '; + + // Create code for encryption. + $limit = 20; + $actions = array($limit => 44, 44 => 64); + $j = 0; + + for (;;) { + // Mixing round. + $encrypt_block .= ' + $r0 = (($r0 + ' . $keys[$j++] . ' + + ((($r1 ^ $r2) & $r3) ^ $r1)) & 0xFFFF) << 1; + $r0 |= $r0 >> 16; + $r1 = (($r1 + ' . $keys[$j++] . ' + + ((($r2 ^ $r3) & $r0) ^ $r2)) & 0xFFFF) << 2; + $r1 |= $r1 >> 16; + $r2 = (($r2 + ' . $keys[$j++] . ' + + ((($r3 ^ $r0) & $r1) ^ $r3)) & 0xFFFF) << 3; + $r2 |= $r2 >> 16; + $r3 = (($r3 + ' . $keys[$j++] . ' + + ((($r0 ^ $r1) & $r2) ^ $r0)) & 0xFFFF) << 5; + $r3 |= $r3 >> 16;'; + + if ($j === $limit) { + if ($limit === 64) { + break; + } + + // Mashing round. + $encrypt_block .= ' + $r0 += $keys[$r3 & 0x3F]; + $r1 += $keys[$r0 & 0x3F]; + $r2 += $keys[$r1 & 0x3F]; + $r3 += $keys[$r2 & 0x3F];'; + $limit = $actions[$limit]; + } + } + + $encrypt_block .= '$in = pack("v4", $r0, $r1, $r2, $r3);'; + + // Create code for decryption. + $limit = 44; + $actions = array($limit => 20, 20 => 0); + $j = 64; + + for (;;) { + // R-mixing round. + $decrypt_block .= ' + $r3 = ($r3 | ($r3 << 16)) >> 5; + $r3 = ($r3 - ' . $keys[--$j] . ' - + ((($r0 ^ $r1) & $r2) ^ $r0)) & 0xFFFF; + $r2 = ($r2 | ($r2 << 16)) >> 3; + $r2 = ($r2 - ' . $keys[--$j] . ' - + ((($r3 ^ $r0) & $r1) ^ $r3)) & 0xFFFF; + $r1 = ($r1 | ($r1 << 16)) >> 2; + $r1 = ($r1 - ' . $keys[--$j] . ' - + ((($r2 ^ $r3) & $r0) ^ $r2)) & 0xFFFF; + $r0 = ($r0 | ($r0 << 16)) >> 1; + $r0 = ($r0 - ' . $keys[--$j] . ' - + ((($r1 ^ $r2) & $r3) ^ $r1)) & 0xFFFF;'; + + if ($j === $limit) { + if ($limit === 0) { + break; + } + + // R-mashing round. + $decrypt_block .= ' + $r3 = ($r3 - $keys[$r2 & 0x3F]) & 0xFFFF; + $r2 = ($r2 - $keys[$r1 & 0x3F]) & 0xFFFF; + $r1 = ($r1 - $keys[$r0 & 0x3F]) & 0xFFFF; + $r0 = ($r0 - $keys[$r3 & 0x3F]) & 0xFFFF;'; + $limit = $actions[$limit]; + } + } + + $decrypt_block .= '$in = pack("v4", $r0, $r1, $r2, $r3);'; + + // Creates the inline-crypt function + $lambda_functions[$code_hash] = $this->_createInlineCryptFunction( + array( + 'init_crypt' => $init_crypt, + 'encrypt_block' => $encrypt_block, + 'decrypt_block' => $decrypt_block + ) + ); + } + + // Set the inline-crypt function as callback in: $this->inline_crypt + $this->inline_crypt = $lambda_functions[$code_hash]; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RC4.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RC4.php new file mode 100644 index 0000000..25e4ff8 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RC4.php @@ -0,0 +1,342 @@ + + * setKey('abcdefgh'); + * + * $size = 10 * 1024; + * $plaintext = ''; + * for ($i = 0; $i < $size; $i++) { + * $plaintext.= 'a'; + * } + * + * echo $rc4->decrypt($rc4->encrypt($plaintext)); + * ?> + * + * + * @category Crypt + * @package RC4 + * @author Jim Wigginton + * @copyright 2007 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP implementation of RC4. + * + * @package RC4 + * @author Jim Wigginton + * @access public + */ +class RC4 extends Base +{ + /**#@+ + * @access private + * @see \phpseclib\Crypt\RC4::_crypt() + */ + const ENCRYPT = 0; + const DECRYPT = 1; + /**#@-*/ + + /** + * Block Length of the cipher + * + * RC4 is a stream cipher + * so we the block_size to 0 + * + * @see \phpseclib\Crypt\Base::block_size + * @var int + * @access private + */ + var $block_size = 0; + + /** + * Key Length (in bytes) + * + * @see \phpseclib\Crypt\RC4::setKeyLength() + * @var int + * @access private + */ + var $key_length = 128; // = 1024 bits + + /** + * The mcrypt specific name of the cipher + * + * @see \phpseclib\Crypt\Base::cipher_name_mcrypt + * @var string + * @access private + */ + var $cipher_name_mcrypt = 'arcfour'; + + /** + * Holds whether performance-optimized $inline_crypt() can/should be used. + * + * @see \phpseclib\Crypt\Base::inline_crypt + * @var mixed + * @access private + */ + var $use_inline_crypt = false; // currently not available + + /** + * The Key + * + * @see self::setKey() + * @var string + * @access private + */ + var $key; + + /** + * The Key Stream for decryption and encryption + * + * @see self::setKey() + * @var array + * @access private + */ + var $stream; + + /** + * Default Constructor. + * + * Determines whether or not the mcrypt extension should be used. + * + * @see \phpseclib\Crypt\Base::__construct() + * @return \phpseclib\Crypt\RC4 + * @access public + */ + function __construct() + { + parent::__construct(Base::MODE_STREAM); + } + + /** + * Test for engine validity + * + * This is mainly just a wrapper to set things up for \phpseclib\Crypt\Base::isValidEngine() + * + * @see \phpseclib\Crypt\Base::__construct() + * @param int $engine + * @access public + * @return bool + */ + function isValidEngine($engine) + { + if ($engine == Base::ENGINE_OPENSSL) { + if (version_compare(PHP_VERSION, '5.3.7') >= 0) { + $this->cipher_name_openssl = 'rc4-40'; + } else { + switch (strlen($this->key)) { + case 5: + $this->cipher_name_openssl = 'rc4-40'; + break; + case 8: + $this->cipher_name_openssl = 'rc4-64'; + break; + case 16: + $this->cipher_name_openssl = 'rc4'; + break; + default: + return false; + } + } + } + + return parent::isValidEngine($engine); + } + + /** + * Dummy function. + * + * Some protocols, such as WEP, prepend an "initialization vector" to the key, effectively creating a new key [1]. + * If you need to use an initialization vector in this manner, feel free to prepend it to the key, yourself, before + * calling setKey(). + * + * [1] WEP's initialization vectors (IV's) are used in a somewhat insecure way. Since, in that protocol, + * the IV's are relatively easy to predict, an attack described by + * {@link http://www.drizzle.com/~aboba/IEEE/rc4_ksaproc.pdf Scott Fluhrer, Itsik Mantin, and Adi Shamir} + * can be used to quickly guess at the rest of the key. The following links elaborate: + * + * {@link http://www.rsa.com/rsalabs/node.asp?id=2009 http://www.rsa.com/rsalabs/node.asp?id=2009} + * {@link http://en.wikipedia.org/wiki/Related_key_attack http://en.wikipedia.org/wiki/Related_key_attack} + * + * @param string $iv + * @see self::setKey() + * @access public + */ + function setIV($iv) + { + } + + /** + * Sets the key length + * + * Keys can be between 1 and 256 bytes long. + * + * @access public + * @param int $length + */ + function setKeyLength($length) + { + if ($length < 8) { + $this->key_length = 1; + } elseif ($length > 2048) { + $this->key_length = 256; + } else { + $this->key_length = $length >> 3; + } + + parent::setKeyLength($length); + } + + /** + * Encrypts a message. + * + * @see \phpseclib\Crypt\Base::decrypt() + * @see self::_crypt() + * @access public + * @param string $plaintext + * @return string $ciphertext + */ + function encrypt($plaintext) + { + if ($this->engine != Base::ENGINE_INTERNAL) { + return parent::encrypt($plaintext); + } + return $this->_crypt($plaintext, self::ENCRYPT); + } + + /** + * Decrypts a message. + * + * $this->decrypt($this->encrypt($plaintext)) == $this->encrypt($this->encrypt($plaintext)). + * At least if the continuous buffer is disabled. + * + * @see \phpseclib\Crypt\Base::encrypt() + * @see self::_crypt() + * @access public + * @param string $ciphertext + * @return string $plaintext + */ + function decrypt($ciphertext) + { + if ($this->engine != Base::ENGINE_INTERNAL) { + return parent::decrypt($ciphertext); + } + return $this->_crypt($ciphertext, self::DECRYPT); + } + + /** + * Encrypts a block + * + * @access private + * @param string $in + */ + function _encryptBlock($in) + { + // RC4 does not utilize this method + } + + /** + * Decrypts a block + * + * @access private + * @param string $in + */ + function _decryptBlock($in) + { + // RC4 does not utilize this method + } + + /** + * Setup the key (expansion) + * + * @see \phpseclib\Crypt\Base::_setupKey() + * @access private + */ + function _setupKey() + { + $key = $this->key; + $keyLength = strlen($key); + $keyStream = range(0, 255); + $j = 0; + for ($i = 0; $i < 256; $i++) { + $j = ($j + $keyStream[$i] + ord($key[$i % $keyLength])) & 255; + $temp = $keyStream[$i]; + $keyStream[$i] = $keyStream[$j]; + $keyStream[$j] = $temp; + } + + $this->stream = array(); + $this->stream[self::DECRYPT] = $this->stream[self::ENCRYPT] = array( + 0, // index $i + 0, // index $j + $keyStream + ); + } + + /** + * Encrypts or decrypts a message. + * + * @see self::encrypt() + * @see self::decrypt() + * @access private + * @param string $text + * @param int $mode + * @return string $text + */ + function _crypt($text, $mode) + { + if ($this->changed) { + $this->_setup(); + $this->changed = false; + } + + $stream = &$this->stream[$mode]; + if ($this->continuousBuffer) { + $i = &$stream[0]; + $j = &$stream[1]; + $keyStream = &$stream[2]; + } else { + $i = $stream[0]; + $j = $stream[1]; + $keyStream = $stream[2]; + } + + $len = strlen($text); + for ($k = 0; $k < $len; ++$k) { + $i = ($i + 1) & 255; + $ksi = $keyStream[$i]; + $j = ($j + $ksi) & 255; + $ksj = $keyStream[$j]; + + $keyStream[$i] = $ksj; + $keyStream[$j] = $ksi; + $text[$k] = $text[$k] ^ chr($keyStream[($ksj + $ksi) & 255]); + } + + return $text; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RSA.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RSA.php new file mode 100644 index 0000000..cd116b5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/RSA.php @@ -0,0 +1,3053 @@ + + * createKey()); + * + * $plaintext = 'terrafrost'; + * + * $rsa->loadKey($privatekey); + * $ciphertext = $rsa->encrypt($plaintext); + * + * $rsa->loadKey($publickey); + * echo $rsa->decrypt($ciphertext); + * ?> + * + * + * Here's an example of how to create signatures and verify signatures with this library: + * + * createKey()); + * + * $plaintext = 'terrafrost'; + * + * $rsa->loadKey($privatekey); + * $signature = $rsa->sign($plaintext); + * + * $rsa->loadKey($publickey); + * echo $rsa->verify($plaintext, $signature) ? 'verified' : 'unverified'; + * ?> + * + * + * @category Crypt + * @package RSA + * @author Jim Wigginton + * @copyright 2009 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +use phpseclib\Math\BigInteger; + +/** + * Pure-PHP PKCS#1 compliant implementation of RSA. + * + * @package RSA + * @author Jim Wigginton + * @access public + */ +class RSA +{ + /**#@+ + * @access public + * @see self::encrypt() + * @see self::decrypt() + */ + /** + * Use {@link http://en.wikipedia.org/wiki/Optimal_Asymmetric_Encryption_Padding Optimal Asymmetric Encryption Padding} + * (OAEP) for encryption / decryption. + * + * Uses sha1 by default. + * + * @see self::setHash() + * @see self::setMGFHash() + */ + const ENCRYPTION_OAEP = 1; + /** + * Use PKCS#1 padding. + * + * Although self::ENCRYPTION_OAEP offers more security, including PKCS#1 padding is necessary for purposes of backwards + * compatibility with protocols (like SSH-1) written before OAEP's introduction. + */ + const ENCRYPTION_PKCS1 = 2; + /** + * Do not use any padding + * + * Although this method is not recommended it can none-the-less sometimes be useful if you're trying to decrypt some legacy + * stuff, if you're trying to diagnose why an encrypted message isn't decrypting, etc. + */ + const ENCRYPTION_NONE = 3; + /**#@-*/ + + /**#@+ + * @access public + * @see self::sign() + * @see self::verify() + * @see self::setHash() + */ + /** + * Use the Probabilistic Signature Scheme for signing + * + * Uses sha1 by default. + * + * @see self::setSaltLength() + * @see self::setMGFHash() + */ + const SIGNATURE_PSS = 1; + /** + * Use the PKCS#1 scheme by default. + * + * Although self::SIGNATURE_PSS offers more security, including PKCS#1 signing is necessary for purposes of backwards + * compatibility with protocols (like SSH-2) written before PSS's introduction. + */ + const SIGNATURE_PKCS1 = 2; + /**#@-*/ + + /**#@+ + * @access private + * @see \phpseclib\Crypt\RSA::createKey() + */ + /** + * ASN1 Integer + */ + const ASN1_INTEGER = 2; + /** + * ASN1 Bit String + */ + const ASN1_BITSTRING = 3; + /** + * ASN1 Octet String + */ + const ASN1_OCTETSTRING = 4; + /** + * ASN1 Object Identifier + */ + const ASN1_OBJECT = 6; + /** + * ASN1 Sequence (with the constucted bit set) + */ + const ASN1_SEQUENCE = 48; + /**#@-*/ + + /**#@+ + * @access private + * @see \phpseclib\Crypt\RSA::__construct() + */ + /** + * To use the pure-PHP implementation + */ + const MODE_INTERNAL = 1; + /** + * To use the OpenSSL library + * + * (if enabled; otherwise, the internal implementation will be used) + */ + const MODE_OPENSSL = 2; + /**#@-*/ + + /**#@+ + * @access public + * @see \phpseclib\Crypt\RSA::createKey() + * @see \phpseclib\Crypt\RSA::setPrivateKeyFormat() + */ + /** + * PKCS#1 formatted private key + * + * Used by OpenSSH + */ + const PRIVATE_FORMAT_PKCS1 = 0; + /** + * PuTTY formatted private key + */ + const PRIVATE_FORMAT_PUTTY = 1; + /** + * XML formatted private key + */ + const PRIVATE_FORMAT_XML = 2; + /** + * PKCS#8 formatted private key + */ + const PRIVATE_FORMAT_PKCS8 = 8; + /**#@-*/ + + /**#@+ + * @access public + * @see \phpseclib\Crypt\RSA::createKey() + * @see \phpseclib\Crypt\RSA::setPublicKeyFormat() + */ + /** + * Raw public key + * + * An array containing two \phpseclib\Math\BigInteger objects. + * + * The exponent can be indexed with any of the following: + * + * 0, e, exponent, publicExponent + * + * The modulus can be indexed with any of the following: + * + * 1, n, modulo, modulus + */ + const PUBLIC_FORMAT_RAW = 3; + /** + * PKCS#1 formatted public key (raw) + * + * Used by File/X509.php + * + * Has the following header: + * + * -----BEGIN RSA PUBLIC KEY----- + * + * Analogous to ssh-keygen's pem format (as specified by -m) + */ + const PUBLIC_FORMAT_PKCS1 = 4; + const PUBLIC_FORMAT_PKCS1_RAW = 4; + /** + * XML formatted public key + */ + const PUBLIC_FORMAT_XML = 5; + /** + * OpenSSH formatted public key + * + * Place in $HOME/.ssh/authorized_keys + */ + const PUBLIC_FORMAT_OPENSSH = 6; + /** + * PKCS#1 formatted public key (encapsulated) + * + * Used by PHP's openssl_public_encrypt() and openssl's rsautl (when -pubin is set) + * + * Has the following header: + * + * -----BEGIN PUBLIC KEY----- + * + * Analogous to ssh-keygen's pkcs8 format (as specified by -m). Although PKCS8 + * is specific to private keys it's basically creating a DER-encoded wrapper + * for keys. This just extends that same concept to public keys (much like ssh-keygen) + */ + const PUBLIC_FORMAT_PKCS8 = 7; + /**#@-*/ + + /** + * Precomputed Zero + * + * @var \phpseclib\Math\BigInteger + * @access private + */ + var $zero; + + /** + * Precomputed One + * + * @var \phpseclib\Math\BigInteger + * @access private + */ + var $one; + + /** + * Private Key Format + * + * @var int + * @access private + */ + var $privateKeyFormat = self::PRIVATE_FORMAT_PKCS1; + + /** + * Public Key Format + * + * @var int + * @access public + */ + var $publicKeyFormat = self::PUBLIC_FORMAT_PKCS8; + + /** + * Modulus (ie. n) + * + * @var \phpseclib\Math\BigInteger + * @access private + */ + var $modulus; + + /** + * Modulus length + * + * @var \phpseclib\Math\BigInteger + * @access private + */ + var $k; + + /** + * Exponent (ie. e or d) + * + * @var \phpseclib\Math\BigInteger + * @access private + */ + var $exponent; + + /** + * Primes for Chinese Remainder Theorem (ie. p and q) + * + * @var array + * @access private + */ + var $primes; + + /** + * Exponents for Chinese Remainder Theorem (ie. dP and dQ) + * + * @var array + * @access private + */ + var $exponents; + + /** + * Coefficients for Chinese Remainder Theorem (ie. qInv) + * + * @var array + * @access private + */ + var $coefficients; + + /** + * Hash name + * + * @var string + * @access private + */ + var $hashName; + + /** + * Hash function + * + * @var \phpseclib\Crypt\Hash + * @access private + */ + var $hash; + + /** + * Length of hash function output + * + * @var int + * @access private + */ + var $hLen; + + /** + * Length of salt + * + * @var int + * @access private + */ + var $sLen; + + /** + * Hash function for the Mask Generation Function + * + * @var \phpseclib\Crypt\Hash + * @access private + */ + var $mgfHash; + + /** + * Length of MGF hash function output + * + * @var int + * @access private + */ + var $mgfHLen; + + /** + * Encryption mode + * + * @var int + * @access private + */ + var $encryptionMode = self::ENCRYPTION_OAEP; + + /** + * Signature mode + * + * @var int + * @access private + */ + var $signatureMode = self::SIGNATURE_PSS; + + /** + * Public Exponent + * + * @var mixed + * @access private + */ + var $publicExponent = false; + + /** + * Password + * + * @var string + * @access private + */ + var $password = false; + + /** + * Components + * + * For use with parsing XML formatted keys. PHP's XML Parser functions use utilized - instead of PHP's DOM functions - + * because PHP's XML Parser functions work on PHP4 whereas PHP's DOM functions - although surperior - don't. + * + * @see self::_start_element_handler() + * @var array + * @access private + */ + var $components = array(); + + /** + * Current String + * + * For use with parsing XML formatted keys. + * + * @see self::_character_handler() + * @see self::_stop_element_handler() + * @var mixed + * @access private + */ + var $current; + + /** + * OpenSSL configuration file name. + * + * Set to null to use system configuration file. + * @see self::createKey() + * @var mixed + * @Access public + */ + var $configFile; + + /** + * Public key comment field. + * + * @var string + * @access private + */ + var $comment = 'phpseclib-generated-key'; + + /** + * The constructor + * + * If you want to make use of the openssl extension, you'll need to set the mode manually, yourself. The reason + * \phpseclib\Crypt\RSA doesn't do it is because OpenSSL doesn't fail gracefully. openssl_pkey_new(), in particular, requires + * openssl.cnf be present somewhere and, unfortunately, the only real way to find out is too late. + * + * @return \phpseclib\Crypt\RSA + * @access public + */ + function __construct() + { + $this->configFile = dirname(__FILE__) . '/../openssl.cnf'; + + if (!defined('CRYPT_RSA_MODE')) { + switch (true) { + // Math/BigInteger's openssl requirements are a little less stringent than Crypt/RSA's. in particular, + // Math/BigInteger doesn't require an openssl.cfg file whereas Crypt/RSA does. so if Math/BigInteger + // can't use OpenSSL it can be pretty trivially assumed, then, that Crypt/RSA can't either. + case defined('MATH_BIGINTEGER_OPENSSL_DISABLE'): + define('CRYPT_RSA_MODE', self::MODE_INTERNAL); + break; + case extension_loaded('openssl') && file_exists($this->configFile): + // some versions of XAMPP have mismatched versions of OpenSSL which causes it not to work + ob_start(); + @phpinfo(); + $content = ob_get_contents(); + ob_end_clean(); + + preg_match_all('#OpenSSL (Header|Library) Version(.*)#im', $content, $matches); + + $versions = array(); + if (!empty($matches[1])) { + for ($i = 0; $i < count($matches[1]); $i++) { + $fullVersion = trim(str_replace('=>', '', strip_tags($matches[2][$i]))); + + // Remove letter part in OpenSSL version + if (!preg_match('/(\d+\.\d+\.\d+)/i', $fullVersion, $m)) { + $versions[$matches[1][$i]] = $fullVersion; + } else { + $versions[$matches[1][$i]] = $m[0]; + } + } + } + + // it doesn't appear that OpenSSL versions were reported upon until PHP 5.3+ + switch (true) { + case !isset($versions['Header']): + case !isset($versions['Library']): + case $versions['Header'] == $versions['Library']: + case version_compare($versions['Header'], '1.0.0') >= 0 && version_compare($versions['Library'], '1.0.0') >= 0: + define('CRYPT_RSA_MODE', self::MODE_OPENSSL); + break; + default: + define('CRYPT_RSA_MODE', self::MODE_INTERNAL); + define('MATH_BIGINTEGER_OPENSSL_DISABLE', true); + } + break; + default: + define('CRYPT_RSA_MODE', self::MODE_INTERNAL); + } + } + + $this->zero = new BigInteger(); + $this->one = new BigInteger(1); + + $this->hash = new Hash('sha1'); + $this->hLen = $this->hash->getLength(); + $this->hashName = 'sha1'; + $this->mgfHash = new Hash('sha1'); + $this->mgfHLen = $this->mgfHash->getLength(); + } + + /** + * Create public / private key pair + * + * Returns an array with the following three elements: + * - 'privatekey': The private key. + * - 'publickey': The public key. + * - 'partialkey': A partially computed key (if the execution time exceeded $timeout). + * Will need to be passed back to \phpseclib\Crypt\RSA::createKey() as the third parameter for further processing. + * + * @access public + * @param int $bits + * @param int $timeout + * @param array $p + */ + function createKey($bits = 1024, $timeout = false, $partial = array()) + { + if (!defined('CRYPT_RSA_EXPONENT')) { + // http://en.wikipedia.org/wiki/65537_%28number%29 + define('CRYPT_RSA_EXPONENT', '65537'); + } + // per , this number ought not result in primes smaller + // than 256 bits. as a consequence if the key you're trying to create is 1024 bits and you've set CRYPT_RSA_SMALLEST_PRIME + // to 384 bits then you're going to get a 384 bit prime and a 640 bit prime (384 + 1024 % 384). at least if + // CRYPT_RSA_MODE is set to self::MODE_INTERNAL. if CRYPT_RSA_MODE is set to self::MODE_OPENSSL then + // CRYPT_RSA_SMALLEST_PRIME is ignored (ie. multi-prime RSA support is more intended as a way to speed up RSA key + // generation when there's a chance neither gmp nor OpenSSL are installed) + if (!defined('CRYPT_RSA_SMALLEST_PRIME')) { + define('CRYPT_RSA_SMALLEST_PRIME', 4096); + } + + // OpenSSL uses 65537 as the exponent and requires RSA keys be 384 bits minimum + if (CRYPT_RSA_MODE == self::MODE_OPENSSL && $bits >= 384 && CRYPT_RSA_EXPONENT == 65537) { + $config = array(); + if (isset($this->configFile)) { + $config['config'] = $this->configFile; + } + $rsa = openssl_pkey_new(array('private_key_bits' => $bits) + $config); + openssl_pkey_export($rsa, $privatekey, null, $config); + $publickey = openssl_pkey_get_details($rsa); + $publickey = $publickey['key']; + + $privatekey = call_user_func_array(array($this, '_convertPrivateKey'), array_values($this->_parseKey($privatekey, self::PRIVATE_FORMAT_PKCS1))); + $publickey = call_user_func_array(array($this, '_convertPublicKey'), array_values($this->_parseKey($publickey, self::PUBLIC_FORMAT_PKCS1))); + + // clear the buffer of error strings stemming from a minimalistic openssl.cnf + while (openssl_error_string() !== false) { + } + + return array( + 'privatekey' => $privatekey, + 'publickey' => $publickey, + 'partialkey' => false + ); + } + + static $e; + if (!isset($e)) { + $e = new BigInteger(CRYPT_RSA_EXPONENT); + } + + extract($this->_generateMinMax($bits)); + $absoluteMin = $min; + $temp = $bits >> 1; // divide by two to see how many bits P and Q would be + if ($temp > CRYPT_RSA_SMALLEST_PRIME) { + $num_primes = floor($bits / CRYPT_RSA_SMALLEST_PRIME); + $temp = CRYPT_RSA_SMALLEST_PRIME; + } else { + $num_primes = 2; + } + extract($this->_generateMinMax($temp + $bits % $temp)); + $finalMax = $max; + extract($this->_generateMinMax($temp)); + + $generator = new BigInteger(); + + $n = $this->one->copy(); + if (!empty($partial)) { + extract(unserialize($partial)); + } else { + $exponents = $coefficients = $primes = array(); + $lcm = array( + 'top' => $this->one->copy(), + 'bottom' => false + ); + } + + $start = time(); + $i0 = count($primes) + 1; + + do { + for ($i = $i0; $i <= $num_primes; $i++) { + if ($timeout !== false) { + $timeout-= time() - $start; + $start = time(); + if ($timeout <= 0) { + return array( + 'privatekey' => '', + 'publickey' => '', + 'partialkey' => serialize(array( + 'primes' => $primes, + 'coefficients' => $coefficients, + 'lcm' => $lcm, + 'exponents' => $exponents + )) + ); + } + } + + if ($i == $num_primes) { + list($min, $temp) = $absoluteMin->divide($n); + if (!$temp->equals($this->zero)) { + $min = $min->add($this->one); // ie. ceil() + } + $primes[$i] = $generator->randomPrime($min, $finalMax, $timeout); + } else { + $primes[$i] = $generator->randomPrime($min, $max, $timeout); + } + + if ($primes[$i] === false) { // if we've reached the timeout + if (count($primes) > 1) { + $partialkey = ''; + } else { + array_pop($primes); + $partialkey = serialize(array( + 'primes' => $primes, + 'coefficients' => $coefficients, + 'lcm' => $lcm, + 'exponents' => $exponents + )); + } + + return array( + 'privatekey' => '', + 'publickey' => '', + 'partialkey' => $partialkey + ); + } + + // the first coefficient is calculated differently from the rest + // ie. instead of being $primes[1]->modInverse($primes[2]), it's $primes[2]->modInverse($primes[1]) + if ($i > 2) { + $coefficients[$i] = $n->modInverse($primes[$i]); + } + + $n = $n->multiply($primes[$i]); + + $temp = $primes[$i]->subtract($this->one); + + // textbook RSA implementations use Euler's totient function instead of the least common multiple. + // see http://en.wikipedia.org/wiki/Euler%27s_totient_function + $lcm['top'] = $lcm['top']->multiply($temp); + $lcm['bottom'] = $lcm['bottom'] === false ? $temp : $lcm['bottom']->gcd($temp); + + $exponents[$i] = $e->modInverse($temp); + } + + list($temp) = $lcm['top']->divide($lcm['bottom']); + $gcd = $temp->gcd($e); + $i0 = 1; + } while (!$gcd->equals($this->one)); + + $d = $e->modInverse($temp); + + $coefficients[2] = $primes[2]->modInverse($primes[1]); + + // from : + // RSAPrivateKey ::= SEQUENCE { + // version Version, + // modulus INTEGER, -- n + // publicExponent INTEGER, -- e + // privateExponent INTEGER, -- d + // prime1 INTEGER, -- p + // prime2 INTEGER, -- q + // exponent1 INTEGER, -- d mod (p-1) + // exponent2 INTEGER, -- d mod (q-1) + // coefficient INTEGER, -- (inverse of q) mod p + // otherPrimeInfos OtherPrimeInfos OPTIONAL + // } + + return array( + 'privatekey' => $this->_convertPrivateKey($n, $e, $d, $primes, $exponents, $coefficients), + 'publickey' => $this->_convertPublicKey($n, $e), + 'partialkey' => false + ); + } + + /** + * Convert a private key to the appropriate format. + * + * @access private + * @see self::setPrivateKeyFormat() + * @param string $RSAPrivateKey + * @return string + */ + function _convertPrivateKey($n, $e, $d, $primes, $exponents, $coefficients) + { + $signed = $this->privateKeyFormat != self::PRIVATE_FORMAT_XML; + $num_primes = count($primes); + $raw = array( + 'version' => $num_primes == 2 ? chr(0) : chr(1), // two-prime vs. multi + 'modulus' => $n->toBytes($signed), + 'publicExponent' => $e->toBytes($signed), + 'privateExponent' => $d->toBytes($signed), + 'prime1' => $primes[1]->toBytes($signed), + 'prime2' => $primes[2]->toBytes($signed), + 'exponent1' => $exponents[1]->toBytes($signed), + 'exponent2' => $exponents[2]->toBytes($signed), + 'coefficient' => $coefficients[2]->toBytes($signed) + ); + + // if the format in question does not support multi-prime rsa and multi-prime rsa was used, + // call _convertPublicKey() instead. + switch ($this->privateKeyFormat) { + case self::PRIVATE_FORMAT_XML: + if ($num_primes != 2) { + return false; + } + return "\r\n" . + ' ' . base64_encode($raw['modulus']) . "\r\n" . + ' ' . base64_encode($raw['publicExponent']) . "\r\n" . + '

    ' . base64_encode($raw['prime1']) . "

    \r\n" . + ' ' . base64_encode($raw['prime2']) . "\r\n" . + ' ' . base64_encode($raw['exponent1']) . "\r\n" . + ' ' . base64_encode($raw['exponent2']) . "\r\n" . + ' ' . base64_encode($raw['coefficient']) . "\r\n" . + ' ' . base64_encode($raw['privateExponent']) . "\r\n" . + '    '; + break; + case self::PRIVATE_FORMAT_PUTTY: + if ($num_primes != 2) { + return false; + } + $key = "PuTTY-User-Key-File-2: ssh-rsa\r\nEncryption: "; + $encryption = (!empty($this->password) || is_string($this->password)) ? 'aes256-cbc' : 'none'; + $key.= $encryption; + $key.= "\r\nComment: " . $this->comment . "\r\n"; + $public = pack( + 'Na*Na*Na*', + strlen('ssh-rsa'), + 'ssh-rsa', + strlen($raw['publicExponent']), + $raw['publicExponent'], + strlen($raw['modulus']), + $raw['modulus'] + ); + $source = pack( + 'Na*Na*Na*Na*', + strlen('ssh-rsa'), + 'ssh-rsa', + strlen($encryption), + $encryption, + strlen($this->comment), + $this->comment, + strlen($public), + $public + ); + $public = base64_encode($public); + $key.= "Public-Lines: " . ((strlen($public) + 63) >> 6) . "\r\n"; + $key.= chunk_split($public, 64); + $private = pack( + 'Na*Na*Na*Na*', + strlen($raw['privateExponent']), + $raw['privateExponent'], + strlen($raw['prime1']), + $raw['prime1'], + strlen($raw['prime2']), + $raw['prime2'], + strlen($raw['coefficient']), + $raw['coefficient'] + ); + if (empty($this->password) && !is_string($this->password)) { + $source.= pack('Na*', strlen($private), $private); + $hashkey = 'putty-private-key-file-mac-key'; + } else { + $private.= Random::string(16 - (strlen($private) & 15)); + $source.= pack('Na*', strlen($private), $private); + $sequence = 0; + $symkey = ''; + while (strlen($symkey) < 32) { + $temp = pack('Na*', $sequence++, $this->password); + $symkey.= pack('H*', sha1($temp)); + } + $symkey = substr($symkey, 0, 32); + $crypto = new AES(); + + $crypto->setKey($symkey); + $crypto->disablePadding(); + $private = $crypto->encrypt($private); + $hashkey = 'putty-private-key-file-mac-key' . $this->password; + } + + $private = base64_encode($private); + $key.= 'Private-Lines: ' . ((strlen($private) + 63) >> 6) . "\r\n"; + $key.= chunk_split($private, 64); + $hash = new Hash('sha1'); + $hash->setKey(pack('H*', sha1($hashkey))); + $key.= 'Private-MAC: ' . bin2hex($hash->hash($source)) . "\r\n"; + + return $key; + default: // eg. self::PRIVATE_FORMAT_PKCS1 + $components = array(); + foreach ($raw as $name => $value) { + $components[$name] = pack('Ca*a*', self::ASN1_INTEGER, $this->_encodeLength(strlen($value)), $value); + } + + $RSAPrivateKey = implode('', $components); + + if ($num_primes > 2) { + $OtherPrimeInfos = ''; + for ($i = 3; $i <= $num_primes; $i++) { + // OtherPrimeInfos ::= SEQUENCE SIZE(1..MAX) OF OtherPrimeInfo + // + // OtherPrimeInfo ::= SEQUENCE { + // prime INTEGER, -- ri + // exponent INTEGER, -- di + // coefficient INTEGER -- ti + // } + $OtherPrimeInfo = pack('Ca*a*', self::ASN1_INTEGER, $this->_encodeLength(strlen($primes[$i]->toBytes(true))), $primes[$i]->toBytes(true)); + $OtherPrimeInfo.= pack('Ca*a*', self::ASN1_INTEGER, $this->_encodeLength(strlen($exponents[$i]->toBytes(true))), $exponents[$i]->toBytes(true)); + $OtherPrimeInfo.= pack('Ca*a*', self::ASN1_INTEGER, $this->_encodeLength(strlen($coefficients[$i]->toBytes(true))), $coefficients[$i]->toBytes(true)); + $OtherPrimeInfos.= pack('Ca*a*', self::ASN1_SEQUENCE, $this->_encodeLength(strlen($OtherPrimeInfo)), $OtherPrimeInfo); + } + $RSAPrivateKey.= pack('Ca*a*', self::ASN1_SEQUENCE, $this->_encodeLength(strlen($OtherPrimeInfos)), $OtherPrimeInfos); + } + + $RSAPrivateKey = pack('Ca*a*', self::ASN1_SEQUENCE, $this->_encodeLength(strlen($RSAPrivateKey)), $RSAPrivateKey); + + if ($this->privateKeyFormat == self::PRIVATE_FORMAT_PKCS8) { + $rsaOID = pack('H*', '300d06092a864886f70d0101010500'); // hex version of MA0GCSqGSIb3DQEBAQUA + $RSAPrivateKey = pack( + 'Ca*a*Ca*a*', + self::ASN1_INTEGER, + "\01\00", + $rsaOID, + 4, + $this->_encodeLength(strlen($RSAPrivateKey)), + $RSAPrivateKey + ); + $RSAPrivateKey = pack('Ca*a*', self::ASN1_SEQUENCE, $this->_encodeLength(strlen($RSAPrivateKey)), $RSAPrivateKey); + if (!empty($this->password) || is_string($this->password)) { + $salt = Random::string(8); + $iterationCount = 2048; + + $crypto = new DES(); + $crypto->setPassword($this->password, 'pbkdf1', 'md5', $salt, $iterationCount); + $RSAPrivateKey = $crypto->encrypt($RSAPrivateKey); + + $parameters = pack( + 'Ca*a*Ca*N', + self::ASN1_OCTETSTRING, + $this->_encodeLength(strlen($salt)), + $salt, + self::ASN1_INTEGER, + $this->_encodeLength(4), + $iterationCount + ); + $pbeWithMD5AndDES_CBC = "\x2a\x86\x48\x86\xf7\x0d\x01\x05\x03"; + + $encryptionAlgorithm = pack( + 'Ca*a*Ca*a*', + self::ASN1_OBJECT, + $this->_encodeLength(strlen($pbeWithMD5AndDES_CBC)), + $pbeWithMD5AndDES_CBC, + self::ASN1_SEQUENCE, + $this->_encodeLength(strlen($parameters)), + $parameters + ); + + $RSAPrivateKey = pack( + 'Ca*a*Ca*a*', + self::ASN1_SEQUENCE, + $this->_encodeLength(strlen($encryptionAlgorithm)), + $encryptionAlgorithm, + self::ASN1_OCTETSTRING, + $this->_encodeLength(strlen($RSAPrivateKey)), + $RSAPrivateKey + ); + + $RSAPrivateKey = pack('Ca*a*', self::ASN1_SEQUENCE, $this->_encodeLength(strlen($RSAPrivateKey)), $RSAPrivateKey); + + $RSAPrivateKey = "-----BEGIN ENCRYPTED PRIVATE KEY-----\r\n" . + chunk_split(base64_encode($RSAPrivateKey), 64) . + '-----END ENCRYPTED PRIVATE KEY-----'; + } else { + $RSAPrivateKey = "-----BEGIN PRIVATE KEY-----\r\n" . + chunk_split(base64_encode($RSAPrivateKey), 64) . + '-----END PRIVATE KEY-----'; + } + return $RSAPrivateKey; + } + + if (!empty($this->password) || is_string($this->password)) { + $iv = Random::string(8); + $symkey = pack('H*', md5($this->password . $iv)); // symkey is short for symmetric key + $symkey.= substr(pack('H*', md5($symkey . $this->password . $iv)), 0, 8); + $des = new TripleDES(); + $des->setKey($symkey); + $des->setIV($iv); + $iv = strtoupper(bin2hex($iv)); + $RSAPrivateKey = "-----BEGIN RSA PRIVATE KEY-----\r\n" . + "Proc-Type: 4,ENCRYPTED\r\n" . + "DEK-Info: DES-EDE3-CBC,$iv\r\n" . + "\r\n" . + chunk_split(base64_encode($des->encrypt($RSAPrivateKey)), 64) . + '-----END RSA PRIVATE KEY-----'; + } else { + $RSAPrivateKey = "-----BEGIN RSA PRIVATE KEY-----\r\n" . + chunk_split(base64_encode($RSAPrivateKey), 64) . + '-----END RSA PRIVATE KEY-----'; + } + + return $RSAPrivateKey; + } + } + + /** + * Convert a public key to the appropriate format + * + * @access private + * @see self::setPublicKeyFormat() + * @param string $RSAPrivateKey + * @return string + */ + function _convertPublicKey($n, $e) + { + $signed = $this->publicKeyFormat != self::PUBLIC_FORMAT_XML; + + $modulus = $n->toBytes($signed); + $publicExponent = $e->toBytes($signed); + + switch ($this->publicKeyFormat) { + case self::PUBLIC_FORMAT_RAW: + return array('e' => $e->copy(), 'n' => $n->copy()); + case self::PUBLIC_FORMAT_XML: + return "\r\n" . + ' ' . base64_encode($modulus) . "\r\n" . + ' ' . base64_encode($publicExponent) . "\r\n" . + ''; + break; + case self::PUBLIC_FORMAT_OPENSSH: + // from : + // string "ssh-rsa" + // mpint e + // mpint n + $RSAPublicKey = pack('Na*Na*Na*', strlen('ssh-rsa'), 'ssh-rsa', strlen($publicExponent), $publicExponent, strlen($modulus), $modulus); + $RSAPublicKey = 'ssh-rsa ' . base64_encode($RSAPublicKey) . ' ' . $this->comment; + + return $RSAPublicKey; + default: // eg. self::PUBLIC_FORMAT_PKCS1_RAW or self::PUBLIC_FORMAT_PKCS1 + // from : + // RSAPublicKey ::= SEQUENCE { + // modulus INTEGER, -- n + // publicExponent INTEGER -- e + // } + $components = array( + 'modulus' => pack('Ca*a*', self::ASN1_INTEGER, $this->_encodeLength(strlen($modulus)), $modulus), + 'publicExponent' => pack('Ca*a*', self::ASN1_INTEGER, $this->_encodeLength(strlen($publicExponent)), $publicExponent) + ); + + $RSAPublicKey = pack( + 'Ca*a*a*', + self::ASN1_SEQUENCE, + $this->_encodeLength(strlen($components['modulus']) + strlen($components['publicExponent'])), + $components['modulus'], + $components['publicExponent'] + ); + + if ($this->publicKeyFormat == self::PUBLIC_FORMAT_PKCS1_RAW) { + $RSAPublicKey = "-----BEGIN RSA PUBLIC KEY-----\r\n" . + chunk_split(base64_encode($RSAPublicKey), 64) . + '-----END RSA PUBLIC KEY-----'; + } else { + // sequence(oid(1.2.840.113549.1.1.1), null)) = rsaEncryption. + $rsaOID = pack('H*', '300d06092a864886f70d0101010500'); // hex version of MA0GCSqGSIb3DQEBAQUA + $RSAPublicKey = chr(0) . $RSAPublicKey; + $RSAPublicKey = chr(3) . $this->_encodeLength(strlen($RSAPublicKey)) . $RSAPublicKey; + + $RSAPublicKey = pack( + 'Ca*a*', + self::ASN1_SEQUENCE, + $this->_encodeLength(strlen($rsaOID . $RSAPublicKey)), + $rsaOID . $RSAPublicKey + ); + + $RSAPublicKey = "-----BEGIN PUBLIC KEY-----\r\n" . + chunk_split(base64_encode($RSAPublicKey), 64) . + '-----END PUBLIC KEY-----'; + } + + return $RSAPublicKey; + } + } + + /** + * Break a public or private key down into its constituant components + * + * @access private + * @see self::_convertPublicKey() + * @see self::_convertPrivateKey() + * @param string $key + * @param int $type + * @return array + */ + function _parseKey($key, $type) + { + if ($type != self::PUBLIC_FORMAT_RAW && !is_string($key)) { + return false; + } + + switch ($type) { + case self::PUBLIC_FORMAT_RAW: + if (!is_array($key)) { + return false; + } + $components = array(); + switch (true) { + case isset($key['e']): + $components['publicExponent'] = $key['e']->copy(); + break; + case isset($key['exponent']): + $components['publicExponent'] = $key['exponent']->copy(); + break; + case isset($key['publicExponent']): + $components['publicExponent'] = $key['publicExponent']->copy(); + break; + case isset($key[0]): + $components['publicExponent'] = $key[0]->copy(); + } + switch (true) { + case isset($key['n']): + $components['modulus'] = $key['n']->copy(); + break; + case isset($key['modulo']): + $components['modulus'] = $key['modulo']->copy(); + break; + case isset($key['modulus']): + $components['modulus'] = $key['modulus']->copy(); + break; + case isset($key[1]): + $components['modulus'] = $key[1]->copy(); + } + return isset($components['modulus']) && isset($components['publicExponent']) ? $components : false; + case self::PRIVATE_FORMAT_PKCS1: + case self::PRIVATE_FORMAT_PKCS8: + case self::PUBLIC_FORMAT_PKCS1: + /* Although PKCS#1 proposes a format that public and private keys can use, encrypting them is + "outside the scope" of PKCS#1. PKCS#1 then refers you to PKCS#12 and PKCS#15 if you're wanting to + protect private keys, however, that's not what OpenSSL* does. OpenSSL protects private keys by adding + two new "fields" to the key - DEK-Info and Proc-Type. These fields are discussed here: + + http://tools.ietf.org/html/rfc1421#section-4.6.1.1 + http://tools.ietf.org/html/rfc1421#section-4.6.1.3 + + DES-EDE3-CBC as an algorithm, however, is not discussed anywhere, near as I can tell. + DES-CBC and DES-EDE are discussed in RFC1423, however, DES-EDE3-CBC isn't, nor is its key derivation + function. As is, the definitive authority on this encoding scheme isn't the IETF but rather OpenSSL's + own implementation. ie. the implementation *is* the standard and any bugs that may exist in that + implementation are part of the standard, as well. + + * OpenSSL is the de facto standard. It's utilized by OpenSSH and other projects */ + if (preg_match('#DEK-Info: (.+),(.+)#', $key, $matches)) { + $iv = pack('H*', trim($matches[2])); + $symkey = pack('H*', md5($this->password . substr($iv, 0, 8))); // symkey is short for symmetric key + $symkey.= pack('H*', md5($symkey . $this->password . substr($iv, 0, 8))); + // remove the Proc-Type / DEK-Info sections as they're no longer needed + $key = preg_replace('#^(?:Proc-Type|DEK-Info): .*#m', '', $key); + $ciphertext = $this->_extractBER($key); + if ($ciphertext === false) { + $ciphertext = $key; + } + switch ($matches[1]) { + case 'AES-256-CBC': + $crypto = new AES(); + break; + case 'AES-128-CBC': + $symkey = substr($symkey, 0, 16); + $crypto = new AES(); + break; + case 'DES-EDE3-CFB': + $crypto = new TripleDES(Base::MODE_CFB); + break; + case 'DES-EDE3-CBC': + $symkey = substr($symkey, 0, 24); + $crypto = new TripleDES(); + break; + case 'DES-CBC': + $crypto = new DES(); + break; + default: + return false; + } + $crypto->setKey($symkey); + $crypto->setIV($iv); + $decoded = $crypto->decrypt($ciphertext); + } else { + $decoded = $this->_extractBER($key); + } + + if ($decoded !== false) { + $key = $decoded; + } + + $components = array(); + + if (ord($this->_string_shift($key)) != self::ASN1_SEQUENCE) { + return false; + } + if ($this->_decodeLength($key) != strlen($key)) { + return false; + } + + $tag = ord($this->_string_shift($key)); + /* intended for keys for which OpenSSL's asn1parse returns the following: + + 0:d=0 hl=4 l= 631 cons: SEQUENCE + 4:d=1 hl=2 l= 1 prim: INTEGER :00 + 7:d=1 hl=2 l= 13 cons: SEQUENCE + 9:d=2 hl=2 l= 9 prim: OBJECT :rsaEncryption + 20:d=2 hl=2 l= 0 prim: NULL + 22:d=1 hl=4 l= 609 prim: OCTET STRING + + ie. PKCS8 keys*/ + + if ($tag == self::ASN1_INTEGER && substr($key, 0, 3) == "\x01\x00\x30") { + $this->_string_shift($key, 3); + $tag = self::ASN1_SEQUENCE; + } + + if ($tag == self::ASN1_SEQUENCE) { + $temp = $this->_string_shift($key, $this->_decodeLength($key)); + if (ord($this->_string_shift($temp)) != self::ASN1_OBJECT) { + return false; + } + $length = $this->_decodeLength($temp); + switch ($this->_string_shift($temp, $length)) { + case "\x2a\x86\x48\x86\xf7\x0d\x01\x01\x01": // rsaEncryption + break; + case "\x2a\x86\x48\x86\xf7\x0d\x01\x05\x03": // pbeWithMD5AndDES-CBC + /* + PBEParameter ::= SEQUENCE { + salt OCTET STRING (SIZE(8)), + iterationCount INTEGER } + */ + if (ord($this->_string_shift($temp)) != self::ASN1_SEQUENCE) { + return false; + } + if ($this->_decodeLength($temp) != strlen($temp)) { + return false; + } + $this->_string_shift($temp); // assume it's an octet string + $salt = $this->_string_shift($temp, $this->_decodeLength($temp)); + if (ord($this->_string_shift($temp)) != self::ASN1_INTEGER) { + return false; + } + $this->_decodeLength($temp); + list(, $iterationCount) = unpack('N', str_pad($temp, 4, chr(0), STR_PAD_LEFT)); + $this->_string_shift($key); // assume it's an octet string + $length = $this->_decodeLength($key); + if (strlen($key) != $length) { + return false; + } + + $crypto = new DES(); + $crypto->setPassword($this->password, 'pbkdf1', 'md5', $salt, $iterationCount); + $key = $crypto->decrypt($key); + if ($key === false) { + return false; + } + return $this->_parseKey($key, self::PRIVATE_FORMAT_PKCS1); + default: + return false; + } + /* intended for keys for which OpenSSL's asn1parse returns the following: + + 0:d=0 hl=4 l= 290 cons: SEQUENCE + 4:d=1 hl=2 l= 13 cons: SEQUENCE + 6:d=2 hl=2 l= 9 prim: OBJECT :rsaEncryption + 17:d=2 hl=2 l= 0 prim: NULL + 19:d=1 hl=4 l= 271 prim: BIT STRING */ + $tag = ord($this->_string_shift($key)); // skip over the BIT STRING / OCTET STRING tag + $this->_decodeLength($key); // skip over the BIT STRING / OCTET STRING length + // "The initial octet shall encode, as an unsigned binary integer wtih bit 1 as the least significant bit, the number of + // unused bits in the final subsequent octet. The number shall be in the range zero to seven." + // -- http://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf (section 8.6.2.2) + if ($tag == self::ASN1_BITSTRING) { + $this->_string_shift($key); + } + if (ord($this->_string_shift($key)) != self::ASN1_SEQUENCE) { + return false; + } + if ($this->_decodeLength($key) != strlen($key)) { + return false; + } + $tag = ord($this->_string_shift($key)); + } + if ($tag != self::ASN1_INTEGER) { + return false; + } + + $length = $this->_decodeLength($key); + $temp = $this->_string_shift($key, $length); + if (strlen($temp) != 1 || ord($temp) > 2) { + $components['modulus'] = new BigInteger($temp, 256); + $this->_string_shift($key); // skip over self::ASN1_INTEGER + $length = $this->_decodeLength($key); + $components[$type == self::PUBLIC_FORMAT_PKCS1 ? 'publicExponent' : 'privateExponent'] = new BigInteger($this->_string_shift($key, $length), 256); + + return $components; + } + if (ord($this->_string_shift($key)) != self::ASN1_INTEGER) { + return false; + } + $length = $this->_decodeLength($key); + $components['modulus'] = new BigInteger($this->_string_shift($key, $length), 256); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['publicExponent'] = new BigInteger($this->_string_shift($key, $length), 256); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['privateExponent'] = new BigInteger($this->_string_shift($key, $length), 256); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['primes'] = array(1 => new BigInteger($this->_string_shift($key, $length), 256)); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['primes'][] = new BigInteger($this->_string_shift($key, $length), 256); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['exponents'] = array(1 => new BigInteger($this->_string_shift($key, $length), 256)); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['exponents'][] = new BigInteger($this->_string_shift($key, $length), 256); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['coefficients'] = array(2 => new BigInteger($this->_string_shift($key, $length), 256)); + + if (!empty($key)) { + if (ord($this->_string_shift($key)) != self::ASN1_SEQUENCE) { + return false; + } + $this->_decodeLength($key); + while (!empty($key)) { + if (ord($this->_string_shift($key)) != self::ASN1_SEQUENCE) { + return false; + } + $this->_decodeLength($key); + $key = substr($key, 1); + $length = $this->_decodeLength($key); + $components['primes'][] = new BigInteger($this->_string_shift($key, $length), 256); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['exponents'][] = new BigInteger($this->_string_shift($key, $length), 256); + $this->_string_shift($key); + $length = $this->_decodeLength($key); + $components['coefficients'][] = new BigInteger($this->_string_shift($key, $length), 256); + } + } + + return $components; + case self::PUBLIC_FORMAT_OPENSSH: + $parts = explode(' ', $key, 3); + + $key = isset($parts[1]) ? base64_decode($parts[1]) : false; + if ($key === false) { + return false; + } + + $comment = isset($parts[2]) ? $parts[2] : false; + + $cleanup = substr($key, 0, 11) == "\0\0\0\7ssh-rsa"; + + if (strlen($key) <= 4) { + return false; + } + extract(unpack('Nlength', $this->_string_shift($key, 4))); + $publicExponent = new BigInteger($this->_string_shift($key, $length), -256); + if (strlen($key) <= 4) { + return false; + } + extract(unpack('Nlength', $this->_string_shift($key, 4))); + $modulus = new BigInteger($this->_string_shift($key, $length), -256); + + if ($cleanup && strlen($key)) { + if (strlen($key) <= 4) { + return false; + } + extract(unpack('Nlength', $this->_string_shift($key, 4))); + $realModulus = new BigInteger($this->_string_shift($key, $length), -256); + return strlen($key) ? false : array( + 'modulus' => $realModulus, + 'publicExponent' => $modulus, + 'comment' => $comment + ); + } else { + return strlen($key) ? false : array( + 'modulus' => $modulus, + 'publicExponent' => $publicExponent, + 'comment' => $comment + ); + } + // http://www.w3.org/TR/xmldsig-core/#sec-RSAKeyValue + // http://en.wikipedia.org/wiki/XML_Signature + case self::PRIVATE_FORMAT_XML: + case self::PUBLIC_FORMAT_XML: + $this->components = array(); + + $xml = xml_parser_create('UTF-8'); + xml_set_object($xml, $this); + xml_set_element_handler($xml, '_start_element_handler', '_stop_element_handler'); + xml_set_character_data_handler($xml, '_data_handler'); + // add to account for "dangling" tags like ... that are sometimes added + if (!xml_parse($xml, '' . $key . '')) { + return false; + } + + return isset($this->components['modulus']) && isset($this->components['publicExponent']) ? $this->components : false; + // from PuTTY's SSHPUBK.C + case self::PRIVATE_FORMAT_PUTTY: + $components = array(); + $key = preg_split('#\r\n|\r|\n#', $key); + $type = trim(preg_replace('#PuTTY-User-Key-File-2: (.+)#', '$1', $key[0])); + if ($type != 'ssh-rsa') { + return false; + } + $encryption = trim(preg_replace('#Encryption: (.+)#', '$1', $key[1])); + $comment = trim(preg_replace('#Comment: (.+)#', '$1', $key[2])); + + $publicLength = trim(preg_replace('#Public-Lines: (\d+)#', '$1', $key[3])); + $public = base64_decode(implode('', array_map('trim', array_slice($key, 4, $publicLength)))); + $public = substr($public, 11); + extract(unpack('Nlength', $this->_string_shift($public, 4))); + $components['publicExponent'] = new BigInteger($this->_string_shift($public, $length), -256); + extract(unpack('Nlength', $this->_string_shift($public, 4))); + $components['modulus'] = new BigInteger($this->_string_shift($public, $length), -256); + + $privateLength = trim(preg_replace('#Private-Lines: (\d+)#', '$1', $key[$publicLength + 4])); + $private = base64_decode(implode('', array_map('trim', array_slice($key, $publicLength + 5, $privateLength)))); + + switch ($encryption) { + case 'aes256-cbc': + $symkey = ''; + $sequence = 0; + while (strlen($symkey) < 32) { + $temp = pack('Na*', $sequence++, $this->password); + $symkey.= pack('H*', sha1($temp)); + } + $symkey = substr($symkey, 0, 32); + $crypto = new AES(); + } + + if ($encryption != 'none') { + $crypto->setKey($symkey); + $crypto->disablePadding(); + $private = $crypto->decrypt($private); + if ($private === false) { + return false; + } + } + + extract(unpack('Nlength', $this->_string_shift($private, 4))); + if (strlen($private) < $length) { + return false; + } + $components['privateExponent'] = new BigInteger($this->_string_shift($private, $length), -256); + extract(unpack('Nlength', $this->_string_shift($private, 4))); + if (strlen($private) < $length) { + return false; + } + $components['primes'] = array(1 => new BigInteger($this->_string_shift($private, $length), -256)); + extract(unpack('Nlength', $this->_string_shift($private, 4))); + if (strlen($private) < $length) { + return false; + } + $components['primes'][] = new BigInteger($this->_string_shift($private, $length), -256); + + $temp = $components['primes'][1]->subtract($this->one); + $components['exponents'] = array(1 => $components['publicExponent']->modInverse($temp)); + $temp = $components['primes'][2]->subtract($this->one); + $components['exponents'][] = $components['publicExponent']->modInverse($temp); + + extract(unpack('Nlength', $this->_string_shift($private, 4))); + if (strlen($private) < $length) { + return false; + } + $components['coefficients'] = array(2 => new BigInteger($this->_string_shift($private, $length), -256)); + + return $components; + } + } + + /** + * Returns the key size + * + * More specifically, this returns the size of the modulo in bits. + * + * @access public + * @return int + */ + function getSize() + { + return !isset($this->modulus) ? 0 : strlen($this->modulus->toBits()); + } + + /** + * Start Element Handler + * + * Called by xml_set_element_handler() + * + * @access private + * @param resource $parser + * @param string $name + * @param array $attribs + */ + function _start_element_handler($parser, $name, $attribs) + { + //$name = strtoupper($name); + switch ($name) { + case 'MODULUS': + $this->current = &$this->components['modulus']; + break; + case 'EXPONENT': + $this->current = &$this->components['publicExponent']; + break; + case 'P': + $this->current = &$this->components['primes'][1]; + break; + case 'Q': + $this->current = &$this->components['primes'][2]; + break; + case 'DP': + $this->current = &$this->components['exponents'][1]; + break; + case 'DQ': + $this->current = &$this->components['exponents'][2]; + break; + case 'INVERSEQ': + $this->current = &$this->components['coefficients'][2]; + break; + case 'D': + $this->current = &$this->components['privateExponent']; + } + $this->current = ''; + } + + /** + * Stop Element Handler + * + * Called by xml_set_element_handler() + * + * @access private + * @param resource $parser + * @param string $name + */ + function _stop_element_handler($parser, $name) + { + if (isset($this->current)) { + $this->current = new BigInteger(base64_decode($this->current), 256); + unset($this->current); + } + } + + /** + * Data Handler + * + * Called by xml_set_character_data_handler() + * + * @access private + * @param resource $parser + * @param string $data + */ + function _data_handler($parser, $data) + { + if (!isset($this->current) || is_object($this->current)) { + return; + } + $this->current.= trim($data); + } + + /** + * Loads a public or private key + * + * Returns true on success and false on failure (ie. an incorrect password was provided or the key was malformed) + * + * @access public + * @param string $key + * @param int $type optional + */ + function loadKey($key, $type = false) + { + if ($key instanceof RSA) { + $this->privateKeyFormat = $key->privateKeyFormat; + $this->publicKeyFormat = $key->publicKeyFormat; + $this->k = $key->k; + $this->hLen = $key->hLen; + $this->sLen = $key->sLen; + $this->mgfHLen = $key->mgfHLen; + $this->encryptionMode = $key->encryptionMode; + $this->signatureMode = $key->signatureMode; + $this->password = $key->password; + $this->configFile = $key->configFile; + $this->comment = $key->comment; + + if (is_object($key->hash)) { + $this->hash = new Hash($key->hash->getHash()); + } + if (is_object($key->mgfHash)) { + $this->mgfHash = new Hash($key->mgfHash->getHash()); + } + + if (is_object($key->modulus)) { + $this->modulus = $key->modulus->copy(); + } + if (is_object($key->exponent)) { + $this->exponent = $key->exponent->copy(); + } + if (is_object($key->publicExponent)) { + $this->publicExponent = $key->publicExponent->copy(); + } + + $this->primes = array(); + $this->exponents = array(); + $this->coefficients = array(); + + foreach ($this->primes as $prime) { + $this->primes[] = $prime->copy(); + } + foreach ($this->exponents as $exponent) { + $this->exponents[] = $exponent->copy(); + } + foreach ($this->coefficients as $coefficient) { + $this->coefficients[] = $coefficient->copy(); + } + + return true; + } + + if ($type === false) { + $types = array( + self::PUBLIC_FORMAT_RAW, + self::PRIVATE_FORMAT_PKCS1, + self::PRIVATE_FORMAT_XML, + self::PRIVATE_FORMAT_PUTTY, + self::PUBLIC_FORMAT_OPENSSH + ); + foreach ($types as $type) { + $components = $this->_parseKey($key, $type); + if ($components !== false) { + break; + } + } + } else { + $components = $this->_parseKey($key, $type); + } + + if ($components === false) { + $this->comment = null; + $this->modulus = null; + $this->k = null; + $this->exponent = null; + $this->primes = null; + $this->exponents = null; + $this->coefficients = null; + $this->publicExponent = null; + + return false; + } + + if (isset($components['comment']) && $components['comment'] !== false) { + $this->comment = $components['comment']; + } + $this->modulus = $components['modulus']; + $this->k = strlen($this->modulus->toBytes()); + $this->exponent = isset($components['privateExponent']) ? $components['privateExponent'] : $components['publicExponent']; + if (isset($components['primes'])) { + $this->primes = $components['primes']; + $this->exponents = $components['exponents']; + $this->coefficients = $components['coefficients']; + $this->publicExponent = $components['publicExponent']; + } else { + $this->primes = array(); + $this->exponents = array(); + $this->coefficients = array(); + $this->publicExponent = false; + } + + switch ($type) { + case self::PUBLIC_FORMAT_OPENSSH: + case self::PUBLIC_FORMAT_RAW: + $this->setPublicKey(); + break; + case self::PRIVATE_FORMAT_PKCS1: + switch (true) { + case strpos($key, '-BEGIN PUBLIC KEY-') !== false: + case strpos($key, '-BEGIN RSA PUBLIC KEY-') !== false: + $this->setPublicKey(); + } + } + + return true; + } + + /** + * Sets the password + * + * Private keys can be encrypted with a password. To unset the password, pass in the empty string or false. + * Or rather, pass in $password such that empty($password) && !is_string($password) is true. + * + * @see self::createKey() + * @see self::loadKey() + * @access public + * @param string $password + */ + function setPassword($password = false) + { + $this->password = $password; + } + + /** + * Defines the public key + * + * Some private key formats define the public exponent and some don't. Those that don't define it are problematic when + * used in certain contexts. For example, in SSH-2, RSA authentication works by sending the public key along with a + * message signed by the private key to the server. The SSH-2 server looks the public key up in an index of public keys + * and if it's present then proceeds to verify the signature. Problem is, if your private key doesn't include the public + * exponent this won't work unless you manually add the public exponent. phpseclib tries to guess if the key being used + * is the public key but in the event that it guesses incorrectly you might still want to explicitly set the key as being + * public. + * + * Do note that when a new key is loaded the index will be cleared. + * + * Returns true on success, false on failure + * + * @see self::getPublicKey() + * @access public + * @param string $key optional + * @param int $type optional + * @return bool + */ + function setPublicKey($key = false, $type = false) + { + // if a public key has already been loaded return false + if (!empty($this->publicExponent)) { + return false; + } + + if ($key === false && !empty($this->modulus)) { + $this->publicExponent = $this->exponent; + return true; + } + + if ($type === false) { + $types = array( + self::PUBLIC_FORMAT_RAW, + self::PUBLIC_FORMAT_PKCS1, + self::PUBLIC_FORMAT_XML, + self::PUBLIC_FORMAT_OPENSSH + ); + foreach ($types as $type) { + $components = $this->_parseKey($key, $type); + if ($components !== false) { + break; + } + } + } else { + $components = $this->_parseKey($key, $type); + } + + if ($components === false) { + return false; + } + + if (empty($this->modulus) || !$this->modulus->equals($components['modulus'])) { + $this->modulus = $components['modulus']; + $this->exponent = $this->publicExponent = $components['publicExponent']; + return true; + } + + $this->publicExponent = $components['publicExponent']; + + return true; + } + + /** + * Defines the private key + * + * If phpseclib guessed a private key was a public key and loaded it as such it might be desirable to force + * phpseclib to treat the key as a private key. This function will do that. + * + * Do note that when a new key is loaded the index will be cleared. + * + * Returns true on success, false on failure + * + * @see self::getPublicKey() + * @access public + * @param string $key optional + * @param int $type optional + * @return bool + */ + function setPrivateKey($key = false, $type = false) + { + if ($key === false && !empty($this->publicExponent)) { + $this->publicExponent = false; + return true; + } + + $rsa = new RSA(); + if (!$rsa->loadKey($key, $type)) { + return false; + } + $rsa->publicExponent = false; + + // don't overwrite the old key if the new key is invalid + $this->loadKey($rsa); + return true; + } + + /** + * Returns the public key + * + * The public key is only returned under two circumstances - if the private key had the public key embedded within it + * or if the public key was set via setPublicKey(). If the currently loaded key is supposed to be the public key this + * function won't return it since this library, for the most part, doesn't distinguish between public and private keys. + * + * @see self::getPublicKey() + * @access public + * @param string $key + * @param int $type optional + */ + function getPublicKey($type = self::PUBLIC_FORMAT_PKCS8) + { + if (empty($this->modulus) || empty($this->publicExponent)) { + return false; + } + + $oldFormat = $this->publicKeyFormat; + $this->publicKeyFormat = $type; + $temp = $this->_convertPublicKey($this->modulus, $this->publicExponent); + $this->publicKeyFormat = $oldFormat; + return $temp; + } + + /** + * Returns the public key's fingerprint + * + * The public key's fingerprint is returned, which is equivalent to running `ssh-keygen -lf rsa.pub`. If there is + * no public key currently loaded, false is returned. + * Example output (md5): "c1:b1:30:29:d7:b8:de:6c:97:77:10:d7:46:41:63:87" (as specified by RFC 4716) + * + * @access public + * @param string $algorithm The hashing algorithm to be used. Valid options are 'md5' and 'sha256'. False is returned + * for invalid values. + * @return mixed + */ + function getPublicKeyFingerprint($algorithm = 'md5') + { + if (empty($this->modulus) || empty($this->publicExponent)) { + return false; + } + + $modulus = $this->modulus->toBytes(true); + $publicExponent = $this->publicExponent->toBytes(true); + + $RSAPublicKey = pack('Na*Na*Na*', strlen('ssh-rsa'), 'ssh-rsa', strlen($publicExponent), $publicExponent, strlen($modulus), $modulus); + + switch ($algorithm) { + case 'sha256': + $hash = new Hash('sha256'); + $base = base64_encode($hash->hash($RSAPublicKey)); + return substr($base, 0, strlen($base) - 1); + case 'md5': + return substr(chunk_split(md5($RSAPublicKey), 2, ':'), 0, -1); + default: + return false; + } + } + + /** + * Returns the private key + * + * The private key is only returned if the currently loaded key contains the constituent prime numbers. + * + * @see self::getPublicKey() + * @access public + * @param string $key + * @param int $type optional + * @return mixed + */ + function getPrivateKey($type = self::PUBLIC_FORMAT_PKCS1) + { + if (empty($this->primes)) { + return false; + } + + $oldFormat = $this->privateKeyFormat; + $this->privateKeyFormat = $type; + $temp = $this->_convertPrivateKey($this->modulus, $this->publicExponent, $this->exponent, $this->primes, $this->exponents, $this->coefficients); + $this->privateKeyFormat = $oldFormat; + return $temp; + } + + /** + * Returns a minimalistic private key + * + * Returns the private key without the prime number constituants. Structurally identical to a public key that + * hasn't been set as the public key + * + * @see self::getPrivateKey() + * @access private + * @param string $key + * @param int $type optional + */ + function _getPrivatePublicKey($mode = self::PUBLIC_FORMAT_PKCS8) + { + if (empty($this->modulus) || empty($this->exponent)) { + return false; + } + + $oldFormat = $this->publicKeyFormat; + $this->publicKeyFormat = $mode; + $temp = $this->_convertPublicKey($this->modulus, $this->exponent); + $this->publicKeyFormat = $oldFormat; + return $temp; + } + + /** + * __toString() magic method + * + * @access public + * @return string + */ + function __toString() + { + $key = $this->getPrivateKey($this->privateKeyFormat); + if ($key !== false) { + return $key; + } + $key = $this->_getPrivatePublicKey($this->publicKeyFormat); + return $key !== false ? $key : ''; + } + + /** + * __clone() magic method + * + * @access public + * @return Crypt_RSA + */ + function __clone() + { + $key = new RSA(); + $key->loadKey($this); + return $key; + } + + /** + * Generates the smallest and largest numbers requiring $bits bits + * + * @access private + * @param int $bits + * @return array + */ + function _generateMinMax($bits) + { + $bytes = $bits >> 3; + $min = str_repeat(chr(0), $bytes); + $max = str_repeat(chr(0xFF), $bytes); + $msb = $bits & 7; + if ($msb) { + $min = chr(1 << ($msb - 1)) . $min; + $max = chr((1 << $msb) - 1) . $max; + } else { + $min[0] = chr(0x80); + } + + return array( + 'min' => new BigInteger($min, 256), + 'max' => new BigInteger($max, 256) + ); + } + + /** + * DER-decode the length + * + * DER supports lengths up to (2**8)**127, however, we'll only support lengths up to (2**8)**4. See + * {@link http://itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf#p=13 X.690 paragraph 8.1.3} for more information. + * + * @access private + * @param string $string + * @return int + */ + function _decodeLength(&$string) + { + $length = ord($this->_string_shift($string)); + if ($length & 0x80) { // definite length, long form + $length&= 0x7F; + $temp = $this->_string_shift($string, $length); + list(, $length) = unpack('N', substr(str_pad($temp, 4, chr(0), STR_PAD_LEFT), -4)); + } + return $length; + } + + /** + * DER-encode the length + * + * DER supports lengths up to (2**8)**127, however, we'll only support lengths up to (2**8)**4. See + * {@link http://itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf#p=13 X.690 paragraph 8.1.3} for more information. + * + * @access private + * @param int $length + * @return string + */ + function _encodeLength($length) + { + if ($length <= 0x7F) { + return chr($length); + } + + $temp = ltrim(pack('N', $length), chr(0)); + return pack('Ca*', 0x80 | strlen($temp), $temp); + } + + /** + * String Shift + * + * Inspired by array_shift + * + * @param string $string + * @param int $index + * @return string + * @access private + */ + function _string_shift(&$string, $index = 1) + { + $substr = substr($string, 0, $index); + $string = substr($string, $index); + return $substr; + } + + /** + * Determines the private key format + * + * @see self::createKey() + * @access public + * @param int $format + */ + function setPrivateKeyFormat($format) + { + $this->privateKeyFormat = $format; + } + + /** + * Determines the public key format + * + * @see self::createKey() + * @access public + * @param int $format + */ + function setPublicKeyFormat($format) + { + $this->publicKeyFormat = $format; + } + + /** + * Determines which hashing function should be used + * + * Used with signature production / verification and (if the encryption mode is self::ENCRYPTION_OAEP) encryption and + * decryption. If $hash isn't supported, sha1 is used. + * + * @access public + * @param string $hash + */ + function setHash($hash) + { + // \phpseclib\Crypt\Hash supports algorithms that PKCS#1 doesn't support. md5-96 and sha1-96, for example. + switch ($hash) { + case 'md2': + case 'md5': + case 'sha1': + case 'sha256': + case 'sha384': + case 'sha512': + $this->hash = new Hash($hash); + $this->hashName = $hash; + break; + default: + $this->hash = new Hash('sha1'); + $this->hashName = 'sha1'; + } + $this->hLen = $this->hash->getLength(); + } + + /** + * Determines which hashing function should be used for the mask generation function + * + * The mask generation function is used by self::ENCRYPTION_OAEP and self::SIGNATURE_PSS and although it's + * best if Hash and MGFHash are set to the same thing this is not a requirement. + * + * @access public + * @param string $hash + */ + function setMGFHash($hash) + { + // \phpseclib\Crypt\Hash supports algorithms that PKCS#1 doesn't support. md5-96 and sha1-96, for example. + switch ($hash) { + case 'md2': + case 'md5': + case 'sha1': + case 'sha256': + case 'sha384': + case 'sha512': + $this->mgfHash = new Hash($hash); + break; + default: + $this->mgfHash = new Hash('sha1'); + } + $this->mgfHLen = $this->mgfHash->getLength(); + } + + /** + * Determines the salt length + * + * To quote from {@link http://tools.ietf.org/html/rfc3447#page-38 RFC3447#page-38}: + * + * Typical salt lengths in octets are hLen (the length of the output + * of the hash function Hash) and 0. + * + * @access public + * @param int $format + */ + function setSaltLength($sLen) + { + $this->sLen = $sLen; + } + + /** + * Integer-to-Octet-String primitive + * + * See {@link http://tools.ietf.org/html/rfc3447#section-4.1 RFC3447#section-4.1}. + * + * @access private + * @param \phpseclib\Math\BigInteger $x + * @param int $xLen + * @return string + */ + function _i2osp($x, $xLen) + { + $x = $x->toBytes(); + if (strlen($x) > $xLen) { + user_error('Integer too large'); + return false; + } + return str_pad($x, $xLen, chr(0), STR_PAD_LEFT); + } + + /** + * Octet-String-to-Integer primitive + * + * See {@link http://tools.ietf.org/html/rfc3447#section-4.2 RFC3447#section-4.2}. + * + * @access private + * @param string $x + * @return \phpseclib\Math\BigInteger + */ + function _os2ip($x) + { + return new BigInteger($x, 256); + } + + /** + * Exponentiate with or without Chinese Remainder Theorem + * + * See {@link http://tools.ietf.org/html/rfc3447#section-5.1.1 RFC3447#section-5.1.2}. + * + * @access private + * @param \phpseclib\Math\BigInteger $x + * @return \phpseclib\Math\BigInteger + */ + function _exponentiate($x) + { + switch (true) { + case empty($this->primes): + case $this->primes[1]->equals($this->zero): + case empty($this->coefficients): + case $this->coefficients[2]->equals($this->zero): + case empty($this->exponents): + case $this->exponents[1]->equals($this->zero): + return $x->modPow($this->exponent, $this->modulus); + } + + $num_primes = count($this->primes); + + if (defined('CRYPT_RSA_DISABLE_BLINDING')) { + $m_i = array( + 1 => $x->modPow($this->exponents[1], $this->primes[1]), + 2 => $x->modPow($this->exponents[2], $this->primes[2]) + ); + $h = $m_i[1]->subtract($m_i[2]); + $h = $h->multiply($this->coefficients[2]); + list(, $h) = $h->divide($this->primes[1]); + $m = $m_i[2]->add($h->multiply($this->primes[2])); + + $r = $this->primes[1]; + for ($i = 3; $i <= $num_primes; $i++) { + $m_i = $x->modPow($this->exponents[$i], $this->primes[$i]); + + $r = $r->multiply($this->primes[$i - 1]); + + $h = $m_i->subtract($m); + $h = $h->multiply($this->coefficients[$i]); + list(, $h) = $h->divide($this->primes[$i]); + + $m = $m->add($r->multiply($h)); + } + } else { + $smallest = $this->primes[1]; + for ($i = 2; $i <= $num_primes; $i++) { + if ($smallest->compare($this->primes[$i]) > 0) { + $smallest = $this->primes[$i]; + } + } + + $one = new BigInteger(1); + + $r = $one->random($one, $smallest->subtract($one)); + + $m_i = array( + 1 => $this->_blind($x, $r, 1), + 2 => $this->_blind($x, $r, 2) + ); + $h = $m_i[1]->subtract($m_i[2]); + $h = $h->multiply($this->coefficients[2]); + list(, $h) = $h->divide($this->primes[1]); + $m = $m_i[2]->add($h->multiply($this->primes[2])); + + $r = $this->primes[1]; + for ($i = 3; $i <= $num_primes; $i++) { + $m_i = $this->_blind($x, $r, $i); + + $r = $r->multiply($this->primes[$i - 1]); + + $h = $m_i->subtract($m); + $h = $h->multiply($this->coefficients[$i]); + list(, $h) = $h->divide($this->primes[$i]); + + $m = $m->add($r->multiply($h)); + } + } + + return $m; + } + + /** + * Performs RSA Blinding + * + * Protects against timing attacks by employing RSA Blinding. + * Returns $x->modPow($this->exponents[$i], $this->primes[$i]) + * + * @access private + * @param \phpseclib\Math\BigInteger $x + * @param \phpseclib\Math\BigInteger $r + * @param int $i + * @return \phpseclib\Math\BigInteger + */ + function _blind($x, $r, $i) + { + $x = $x->multiply($r->modPow($this->publicExponent, $this->primes[$i])); + $x = $x->modPow($this->exponents[$i], $this->primes[$i]); + + $r = $r->modInverse($this->primes[$i]); + $x = $x->multiply($r); + list(, $x) = $x->divide($this->primes[$i]); + + return $x; + } + + /** + * Performs blinded RSA equality testing + * + * Protects against a particular type of timing attack described. + * + * See {@link http://codahale.com/a-lesson-in-timing-attacks/ A Lesson In Timing Attacks (or, Don't use MessageDigest.isEquals)} + * + * Thanks for the heads up singpolyma! + * + * @access private + * @param string $x + * @param string $y + * @return bool + */ + function _equals($x, $y) + { + if (strlen($x) != strlen($y)) { + return false; + } + + $result = 0; + for ($i = 0; $i < strlen($x); $i++) { + $result |= ord($x[$i]) ^ ord($y[$i]); + } + + return $result == 0; + } + + /** + * RSAEP + * + * See {@link http://tools.ietf.org/html/rfc3447#section-5.1.1 RFC3447#section-5.1.1}. + * + * @access private + * @param \phpseclib\Math\BigInteger $m + * @return \phpseclib\Math\BigInteger + */ + function _rsaep($m) + { + if ($m->compare($this->zero) < 0 || $m->compare($this->modulus) > 0) { + user_error('Message representative out of range'); + return false; + } + return $this->_exponentiate($m); + } + + /** + * RSADP + * + * See {@link http://tools.ietf.org/html/rfc3447#section-5.1.2 RFC3447#section-5.1.2}. + * + * @access private + * @param \phpseclib\Math\BigInteger $c + * @return \phpseclib\Math\BigInteger + */ + function _rsadp($c) + { + if ($c->compare($this->zero) < 0 || $c->compare($this->modulus) > 0) { + user_error('Ciphertext representative out of range'); + return false; + } + return $this->_exponentiate($c); + } + + /** + * RSASP1 + * + * See {@link http://tools.ietf.org/html/rfc3447#section-5.2.1 RFC3447#section-5.2.1}. + * + * @access private + * @param \phpseclib\Math\BigInteger $m + * @return \phpseclib\Math\BigInteger + */ + function _rsasp1($m) + { + if ($m->compare($this->zero) < 0 || $m->compare($this->modulus) > 0) { + user_error('Message representative out of range'); + return false; + } + return $this->_exponentiate($m); + } + + /** + * RSAVP1 + * + * See {@link http://tools.ietf.org/html/rfc3447#section-5.2.2 RFC3447#section-5.2.2}. + * + * @access private + * @param \phpseclib\Math\BigInteger $s + * @return \phpseclib\Math\BigInteger + */ + function _rsavp1($s) + { + if ($s->compare($this->zero) < 0 || $s->compare($this->modulus) > 0) { + user_error('Signature representative out of range'); + return false; + } + return $this->_exponentiate($s); + } + + /** + * MGF1 + * + * See {@link http://tools.ietf.org/html/rfc3447#appendix-B.2.1 RFC3447#appendix-B.2.1}. + * + * @access private + * @param string $mgfSeed + * @param int $mgfLen + * @return string + */ + function _mgf1($mgfSeed, $maskLen) + { + // if $maskLen would yield strings larger than 4GB, PKCS#1 suggests a "Mask too long" error be output. + + $t = ''; + $count = ceil($maskLen / $this->mgfHLen); + for ($i = 0; $i < $count; $i++) { + $c = pack('N', $i); + $t.= $this->mgfHash->hash($mgfSeed . $c); + } + + return substr($t, 0, $maskLen); + } + + /** + * RSAES-OAEP-ENCRYPT + * + * See {@link http://tools.ietf.org/html/rfc3447#section-7.1.1 RFC3447#section-7.1.1} and + * {http://en.wikipedia.org/wiki/Optimal_Asymmetric_Encryption_Padding OAES}. + * + * @access private + * @param string $m + * @param string $l + * @return string + */ + function _rsaes_oaep_encrypt($m, $l = '') + { + $mLen = strlen($m); + + // Length checking + + // if $l is larger than two million terrabytes and you're using sha1, PKCS#1 suggests a "Label too long" error + // be output. + + if ($mLen > $this->k - 2 * $this->hLen - 2) { + user_error('Message too long'); + return false; + } + + // EME-OAEP encoding + + $lHash = $this->hash->hash($l); + $ps = str_repeat(chr(0), $this->k - $mLen - 2 * $this->hLen - 2); + $db = $lHash . $ps . chr(1) . $m; + $seed = Random::string($this->hLen); + $dbMask = $this->_mgf1($seed, $this->k - $this->hLen - 1); + $maskedDB = $db ^ $dbMask; + $seedMask = $this->_mgf1($maskedDB, $this->hLen); + $maskedSeed = $seed ^ $seedMask; + $em = chr(0) . $maskedSeed . $maskedDB; + + // RSA encryption + + $m = $this->_os2ip($em); + $c = $this->_rsaep($m); + $c = $this->_i2osp($c, $this->k); + + // Output the ciphertext C + + return $c; + } + + /** + * RSAES-OAEP-DECRYPT + * + * See {@link http://tools.ietf.org/html/rfc3447#section-7.1.2 RFC3447#section-7.1.2}. The fact that the error + * messages aren't distinguishable from one another hinders debugging, but, to quote from RFC3447#section-7.1.2: + * + * Note. Care must be taken to ensure that an opponent cannot + * distinguish the different error conditions in Step 3.g, whether by + * error message or timing, or, more generally, learn partial + * information about the encoded message EM. Otherwise an opponent may + * be able to obtain useful information about the decryption of the + * ciphertext C, leading to a chosen-ciphertext attack such as the one + * observed by Manger [36]. + * + * As for $l... to quote from {@link http://tools.ietf.org/html/rfc3447#page-17 RFC3447#page-17}: + * + * Both the encryption and the decryption operations of RSAES-OAEP take + * the value of a label L as input. In this version of PKCS #1, L is + * the empty string; other uses of the label are outside the scope of + * this document. + * + * @access private + * @param string $c + * @param string $l + * @return string + */ + function _rsaes_oaep_decrypt($c, $l = '') + { + // Length checking + + // if $l is larger than two million terrabytes and you're using sha1, PKCS#1 suggests a "Label too long" error + // be output. + + if (strlen($c) != $this->k || $this->k < 2 * $this->hLen + 2) { + user_error('Decryption error'); + return false; + } + + // RSA decryption + + $c = $this->_os2ip($c); + $m = $this->_rsadp($c); + if ($m === false) { + user_error('Decryption error'); + return false; + } + $em = $this->_i2osp($m, $this->k); + + // EME-OAEP decoding + + $lHash = $this->hash->hash($l); + $y = ord($em[0]); + $maskedSeed = substr($em, 1, $this->hLen); + $maskedDB = substr($em, $this->hLen + 1); + $seedMask = $this->_mgf1($maskedDB, $this->hLen); + $seed = $maskedSeed ^ $seedMask; + $dbMask = $this->_mgf1($seed, $this->k - $this->hLen - 1); + $db = $maskedDB ^ $dbMask; + $lHash2 = substr($db, 0, $this->hLen); + $m = substr($db, $this->hLen); + if (!$this->_equals($lHash, $lHash2)) { + user_error('Decryption error'); + return false; + } + $m = ltrim($m, chr(0)); + if (ord($m[0]) != 1) { + user_error('Decryption error'); + return false; + } + + // Output the message M + + return substr($m, 1); + } + + /** + * Raw Encryption / Decryption + * + * Doesn't use padding and is not recommended. + * + * @access private + * @param string $m + * @return string + */ + function _raw_encrypt($m) + { + $temp = $this->_os2ip($m); + $temp = $this->_rsaep($temp); + return $this->_i2osp($temp, $this->k); + } + + /** + * RSAES-PKCS1-V1_5-ENCRYPT + * + * See {@link http://tools.ietf.org/html/rfc3447#section-7.2.1 RFC3447#section-7.2.1}. + * + * @access private + * @param string $m + * @return string + */ + function _rsaes_pkcs1_v1_5_encrypt($m) + { + $mLen = strlen($m); + + // Length checking + + if ($mLen > $this->k - 11) { + user_error('Message too long'); + return false; + } + + // EME-PKCS1-v1_5 encoding + + $psLen = $this->k - $mLen - 3; + $ps = ''; + while (strlen($ps) != $psLen) { + $temp = Random::string($psLen - strlen($ps)); + $temp = str_replace("\x00", '', $temp); + $ps.= $temp; + } + $type = 2; + // see the comments of _rsaes_pkcs1_v1_5_decrypt() to understand why this is being done + if (defined('CRYPT_RSA_PKCS15_COMPAT') && (!isset($this->publicExponent) || $this->exponent !== $this->publicExponent)) { + $type = 1; + // "The padding string PS shall consist of k-3-||D|| octets. ... for block type 01, they shall have value FF" + $ps = str_repeat("\xFF", $psLen); + } + $em = chr(0) . chr($type) . $ps . chr(0) . $m; + + // RSA encryption + $m = $this->_os2ip($em); + $c = $this->_rsaep($m); + $c = $this->_i2osp($c, $this->k); + + // Output the ciphertext C + + return $c; + } + + /** + * RSAES-PKCS1-V1_5-DECRYPT + * + * See {@link http://tools.ietf.org/html/rfc3447#section-7.2.2 RFC3447#section-7.2.2}. + * + * For compatibility purposes, this function departs slightly from the description given in RFC3447. + * The reason being that RFC2313#section-8.1 (PKCS#1 v1.5) states that ciphertext's encrypted by the + * private key should have the second byte set to either 0 or 1 and that ciphertext's encrypted by the + * public key should have the second byte set to 2. In RFC3447 (PKCS#1 v2.1), the second byte is supposed + * to be 2 regardless of which key is used. For compatibility purposes, we'll just check to make sure the + * second byte is 2 or less. If it is, we'll accept the decrypted string as valid. + * + * As a consequence of this, a private key encrypted ciphertext produced with \phpseclib\Crypt\RSA may not decrypt + * with a strictly PKCS#1 v1.5 compliant RSA implementation. Public key encrypted ciphertext's should but + * not private key encrypted ciphertext's. + * + * @access private + * @param string $c + * @return string + */ + function _rsaes_pkcs1_v1_5_decrypt($c) + { + // Length checking + + if (strlen($c) != $this->k) { // or if k < 11 + user_error('Decryption error'); + return false; + } + + // RSA decryption + + $c = $this->_os2ip($c); + $m = $this->_rsadp($c); + + if ($m === false) { + user_error('Decryption error'); + return false; + } + $em = $this->_i2osp($m, $this->k); + + // EME-PKCS1-v1_5 decoding + + if (ord($em[0]) != 0 || ord($em[1]) > 2) { + user_error('Decryption error'); + return false; + } + + $ps = substr($em, 2, strpos($em, chr(0), 2) - 2); + $m = substr($em, strlen($ps) + 3); + + if (strlen($ps) < 8) { + user_error('Decryption error'); + return false; + } + + // Output M + + return $m; + } + + /** + * EMSA-PSS-ENCODE + * + * See {@link http://tools.ietf.org/html/rfc3447#section-9.1.1 RFC3447#section-9.1.1}. + * + * @access private + * @param string $m + * @param int $emBits + */ + function _emsa_pss_encode($m, $emBits) + { + // if $m is larger than two million terrabytes and you're using sha1, PKCS#1 suggests a "Label too long" error + // be output. + + $emLen = ($emBits + 1) >> 3; // ie. ceil($emBits / 8) + $sLen = $this->sLen !== null ? $this->sLen : $this->hLen; + + $mHash = $this->hash->hash($m); + if ($emLen < $this->hLen + $sLen + 2) { + user_error('Encoding error'); + return false; + } + + $salt = Random::string($sLen); + $m2 = "\0\0\0\0\0\0\0\0" . $mHash . $salt; + $h = $this->hash->hash($m2); + $ps = str_repeat(chr(0), $emLen - $sLen - $this->hLen - 2); + $db = $ps . chr(1) . $salt; + $dbMask = $this->_mgf1($h, $emLen - $this->hLen - 1); + $maskedDB = $db ^ $dbMask; + $maskedDB[0] = ~chr(0xFF << ($emBits & 7)) & $maskedDB[0]; + $em = $maskedDB . $h . chr(0xBC); + + return $em; + } + + /** + * EMSA-PSS-VERIFY + * + * See {@link http://tools.ietf.org/html/rfc3447#section-9.1.2 RFC3447#section-9.1.2}. + * + * @access private + * @param string $m + * @param string $em + * @param int $emBits + * @return string + */ + function _emsa_pss_verify($m, $em, $emBits) + { + // if $m is larger than two million terrabytes and you're using sha1, PKCS#1 suggests a "Label too long" error + // be output. + + $emLen = ($emBits + 1) >> 3; // ie. ceil($emBits / 8); + $sLen = $this->sLen !== null ? $this->sLen : $this->hLen; + + $mHash = $this->hash->hash($m); + if ($emLen < $this->hLen + $sLen + 2) { + return false; + } + + if ($em[strlen($em) - 1] != chr(0xBC)) { + return false; + } + + $maskedDB = substr($em, 0, -$this->hLen - 1); + $h = substr($em, -$this->hLen - 1, $this->hLen); + $temp = chr(0xFF << ($emBits & 7)); + if ((~$maskedDB[0] & $temp) != $temp) { + return false; + } + $dbMask = $this->_mgf1($h, $emLen - $this->hLen - 1); + $db = $maskedDB ^ $dbMask; + $db[0] = ~chr(0xFF << ($emBits & 7)) & $db[0]; + $temp = $emLen - $this->hLen - $sLen - 2; + if (substr($db, 0, $temp) != str_repeat(chr(0), $temp) || ord($db[$temp]) != 1) { + return false; + } + $salt = substr($db, $temp + 1); // should be $sLen long + $m2 = "\0\0\0\0\0\0\0\0" . $mHash . $salt; + $h2 = $this->hash->hash($m2); + return $this->_equals($h, $h2); + } + + /** + * RSASSA-PSS-SIGN + * + * See {@link http://tools.ietf.org/html/rfc3447#section-8.1.1 RFC3447#section-8.1.1}. + * + * @access private + * @param string $m + * @return string + */ + function _rsassa_pss_sign($m) + { + // EMSA-PSS encoding + + $em = $this->_emsa_pss_encode($m, 8 * $this->k - 1); + + // RSA signature + + $m = $this->_os2ip($em); + $s = $this->_rsasp1($m); + $s = $this->_i2osp($s, $this->k); + + // Output the signature S + + return $s; + } + + /** + * RSASSA-PSS-VERIFY + * + * See {@link http://tools.ietf.org/html/rfc3447#section-8.1.2 RFC3447#section-8.1.2}. + * + * @access private + * @param string $m + * @param string $s + * @return string + */ + function _rsassa_pss_verify($m, $s) + { + // Length checking + + if (strlen($s) != $this->k) { + user_error('Invalid signature'); + return false; + } + + // RSA verification + + $modBits = 8 * $this->k; + + $s2 = $this->_os2ip($s); + $m2 = $this->_rsavp1($s2); + if ($m2 === false) { + user_error('Invalid signature'); + return false; + } + $em = $this->_i2osp($m2, $modBits >> 3); + if ($em === false) { + user_error('Invalid signature'); + return false; + } + + // EMSA-PSS verification + + return $this->_emsa_pss_verify($m, $em, $modBits - 1); + } + + /** + * EMSA-PKCS1-V1_5-ENCODE + * + * See {@link http://tools.ietf.org/html/rfc3447#section-9.2 RFC3447#section-9.2}. + * + * @access private + * @param string $m + * @param int $emLen + * @return string + */ + function _emsa_pkcs1_v1_5_encode($m, $emLen) + { + $h = $this->hash->hash($m); + if ($h === false) { + return false; + } + + // see http://tools.ietf.org/html/rfc3447#page-43 + switch ($this->hashName) { + case 'md2': + $t = pack('H*', '3020300c06082a864886f70d020205000410'); + break; + case 'md5': + $t = pack('H*', '3020300c06082a864886f70d020505000410'); + break; + case 'sha1': + $t = pack('H*', '3021300906052b0e03021a05000414'); + break; + case 'sha256': + $t = pack('H*', '3031300d060960864801650304020105000420'); + break; + case 'sha384': + $t = pack('H*', '3041300d060960864801650304020205000430'); + break; + case 'sha512': + $t = pack('H*', '3051300d060960864801650304020305000440'); + } + $t.= $h; + $tLen = strlen($t); + + if ($emLen < $tLen + 11) { + user_error('Intended encoded message length too short'); + return false; + } + + $ps = str_repeat(chr(0xFF), $emLen - $tLen - 3); + + $em = "\0\1$ps\0$t"; + + return $em; + } + + /** + * RSASSA-PKCS1-V1_5-SIGN + * + * See {@link http://tools.ietf.org/html/rfc3447#section-8.2.1 RFC3447#section-8.2.1}. + * + * @access private + * @param string $m + * @return string + */ + function _rsassa_pkcs1_v1_5_sign($m) + { + // EMSA-PKCS1-v1_5 encoding + + $em = $this->_emsa_pkcs1_v1_5_encode($m, $this->k); + if ($em === false) { + user_error('RSA modulus too short'); + return false; + } + + // RSA signature + + $m = $this->_os2ip($em); + $s = $this->_rsasp1($m); + $s = $this->_i2osp($s, $this->k); + + // Output the signature S + + return $s; + } + + /** + * RSASSA-PKCS1-V1_5-VERIFY + * + * See {@link http://tools.ietf.org/html/rfc3447#section-8.2.2 RFC3447#section-8.2.2}. + * + * @access private + * @param string $m + * @return string + */ + function _rsassa_pkcs1_v1_5_verify($m, $s) + { + // Length checking + + if (strlen($s) != $this->k) { + user_error('Invalid signature'); + return false; + } + + // RSA verification + + $s = $this->_os2ip($s); + $m2 = $this->_rsavp1($s); + if ($m2 === false) { + user_error('Invalid signature'); + return false; + } + $em = $this->_i2osp($m2, $this->k); + if ($em === false) { + user_error('Invalid signature'); + return false; + } + + // EMSA-PKCS1-v1_5 encoding + + $em2 = $this->_emsa_pkcs1_v1_5_encode($m, $this->k); + if ($em2 === false) { + user_error('RSA modulus too short'); + return false; + } + + // Compare + return $this->_equals($em, $em2); + } + + /** + * Set Encryption Mode + * + * Valid values include self::ENCRYPTION_OAEP and self::ENCRYPTION_PKCS1. + * + * @access public + * @param int $mode + */ + function setEncryptionMode($mode) + { + $this->encryptionMode = $mode; + } + + /** + * Set Signature Mode + * + * Valid values include self::SIGNATURE_PSS and self::SIGNATURE_PKCS1 + * + * @access public + * @param int $mode + */ + function setSignatureMode($mode) + { + $this->signatureMode = $mode; + } + + /** + * Set public key comment. + * + * @access public + * @param string $comment + */ + function setComment($comment) + { + $this->comment = $comment; + } + + /** + * Get public key comment. + * + * @access public + * @return string + */ + function getComment() + { + return $this->comment; + } + + /** + * Encryption + * + * Both self::ENCRYPTION_OAEP and self::ENCRYPTION_PKCS1 both place limits on how long $plaintext can be. + * If $plaintext exceeds those limits it will be broken up so that it does and the resultant ciphertext's will + * be concatenated together. + * + * @see self::decrypt() + * @access public + * @param string $plaintext + * @return string + */ + function encrypt($plaintext) + { + switch ($this->encryptionMode) { + case self::ENCRYPTION_NONE: + $plaintext = str_split($plaintext, $this->k); + $ciphertext = ''; + foreach ($plaintext as $m) { + $ciphertext.= $this->_raw_encrypt($m); + } + return $ciphertext; + case self::ENCRYPTION_PKCS1: + $length = $this->k - 11; + if ($length <= 0) { + return false; + } + + $plaintext = str_split($plaintext, $length); + $ciphertext = ''; + foreach ($plaintext as $m) { + $ciphertext.= $this->_rsaes_pkcs1_v1_5_encrypt($m); + } + return $ciphertext; + //case self::ENCRYPTION_OAEP: + default: + $length = $this->k - 2 * $this->hLen - 2; + if ($length <= 0) { + return false; + } + + $plaintext = str_split($plaintext, $length); + $ciphertext = ''; + foreach ($plaintext as $m) { + $ciphertext.= $this->_rsaes_oaep_encrypt($m); + } + return $ciphertext; + } + } + + /** + * Decryption + * + * @see self::encrypt() + * @access public + * @param string $plaintext + * @return string + */ + function decrypt($ciphertext) + { + if ($this->k <= 0) { + return false; + } + + $ciphertext = str_split($ciphertext, $this->k); + $ciphertext[count($ciphertext) - 1] = str_pad($ciphertext[count($ciphertext) - 1], $this->k, chr(0), STR_PAD_LEFT); + + $plaintext = ''; + + switch ($this->encryptionMode) { + case self::ENCRYPTION_NONE: + $decrypt = '_raw_encrypt'; + break; + case self::ENCRYPTION_PKCS1: + $decrypt = '_rsaes_pkcs1_v1_5_decrypt'; + break; + //case self::ENCRYPTION_OAEP: + default: + $decrypt = '_rsaes_oaep_decrypt'; + } + + foreach ($ciphertext as $c) { + $temp = $this->$decrypt($c); + if ($temp === false) { + return false; + } + $plaintext.= $temp; + } + + return $plaintext; + } + + /** + * Create a signature + * + * @see self::verify() + * @access public + * @param string $message + * @return string + */ + function sign($message) + { + if (empty($this->modulus) || empty($this->exponent)) { + return false; + } + + switch ($this->signatureMode) { + case self::SIGNATURE_PKCS1: + return $this->_rsassa_pkcs1_v1_5_sign($message); + //case self::SIGNATURE_PSS: + default: + return $this->_rsassa_pss_sign($message); + } + } + + /** + * Verifies a signature + * + * @see self::sign() + * @access public + * @param string $message + * @param string $signature + * @return bool + */ + function verify($message, $signature) + { + if (empty($this->modulus) || empty($this->exponent)) { + return false; + } + + switch ($this->signatureMode) { + case self::SIGNATURE_PKCS1: + return $this->_rsassa_pkcs1_v1_5_verify($message, $signature); + //case self::SIGNATURE_PSS: + default: + return $this->_rsassa_pss_verify($message, $signature); + } + } + + /** + * Extract raw BER from Base64 encoding + * + * @access private + * @param string $str + * @return string + */ + function _extractBER($str) + { + /* X.509 certs are assumed to be base64 encoded but sometimes they'll have additional things in them + * above and beyond the ceritificate. + * ie. some may have the following preceding the -----BEGIN CERTIFICATE----- line: + * + * Bag Attributes + * localKeyID: 01 00 00 00 + * subject=/O=organization/OU=org unit/CN=common name + * issuer=/O=organization/CN=common name + */ + $temp = preg_replace('#.*?^-+[^-]+-+[\r\n ]*$#ms', '', $str, 1); + // remove the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- stuff + $temp = preg_replace('#-+[^-]+-+#', '', $temp); + // remove new lines + $temp = str_replace(array("\r", "\n", ' '), '', $temp); + $temp = preg_match('#^[a-zA-Z\d/+]*={0,2}$#', $temp) ? base64_decode($temp) : false; + return $temp != false ? $temp : $str; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Random.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Random.php new file mode 100644 index 0000000..01e34cc --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Random.php @@ -0,0 +1,274 @@ + + * + * + * + * @category Crypt + * @package Random + * @author Jim Wigginton + * @copyright 2007 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP Random Number Generator + * + * @package Random + * @author Jim Wigginton + * @access public + */ +class Random +{ + /** + * Generate a random string. + * + * Although microoptimizations are generally discouraged as they impair readability this function is ripe with + * microoptimizations because this function has the potential of being called a huge number of times. + * eg. for RSA key generation. + * + * @param int $length + * @return string + */ + static function string($length) + { + if (!$length) { + return ''; + } + + if (version_compare(PHP_VERSION, '7.0.0', '>=')) { + try { + return \random_bytes($length); + } catch (\Throwable $e) { + // If a sufficient source of randomness is unavailable, random_bytes() will throw an + // object that implements the Throwable interface (Exception, TypeError, Error). + // We don't actually need to do anything here. The string() method should just continue + // as normal. Note, however, that if we don't have a sufficient source of randomness for + // random_bytes(), most of the other calls here will fail too, so we'll end up using + // the PHP implementation. + } + } + + if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') { + // method 1. prior to PHP 5.3 this would call rand() on windows hence the function_exists('class_alias') call. + // ie. class_alias is a function that was introduced in PHP 5.3 + if (extension_loaded('mcrypt') && function_exists('class_alias')) { + return @mcrypt_create_iv($length); + } + // method 2. openssl_random_pseudo_bytes was introduced in PHP 5.3.0 but prior to PHP 5.3.4 there was, + // to quote , "possible blocking behavior". as of 5.3.4 + // openssl_random_pseudo_bytes and mcrypt_create_iv do the exact same thing on Windows. ie. they both + // call php_win32_get_random_bytes(): + // + // https://github.com/php/php-src/blob/7014a0eb6d1611151a286c0ff4f2238f92c120d6/ext/openssl/openssl.c#L5008 + // https://github.com/php/php-src/blob/7014a0eb6d1611151a286c0ff4f2238f92c120d6/ext/mcrypt/mcrypt.c#L1392 + // + // php_win32_get_random_bytes() is defined thusly: + // + // https://github.com/php/php-src/blob/7014a0eb6d1611151a286c0ff4f2238f92c120d6/win32/winutil.c#L80 + // + // we're calling it, all the same, in the off chance that the mcrypt extension is not available + if (extension_loaded('openssl') && version_compare(PHP_VERSION, '5.3.4', '>=')) { + return openssl_random_pseudo_bytes($length); + } + } else { + // method 1. the fastest + if (extension_loaded('openssl')) { + return openssl_random_pseudo_bytes($length); + } + // method 2 + static $fp = true; + if ($fp === true) { + // warning's will be output unles the error suppression operator is used. errors such as + // "open_basedir restriction in effect", "Permission denied", "No such file or directory", etc. + $fp = @fopen('/dev/urandom', 'rb'); + } + if ($fp !== true && $fp !== false) { // surprisingly faster than !is_bool() or is_resource() + return fread($fp, $length); + } + // method 3. pretty much does the same thing as method 2 per the following url: + // https://github.com/php/php-src/blob/7014a0eb6d1611151a286c0ff4f2238f92c120d6/ext/mcrypt/mcrypt.c#L1391 + // surprisingly slower than method 2. maybe that's because mcrypt_create_iv does a bunch of error checking that we're + // not doing. regardless, this'll only be called if this PHP script couldn't open /dev/urandom due to open_basedir + // restrictions or some such + if (extension_loaded('mcrypt')) { + return @mcrypt_create_iv($length, MCRYPT_DEV_URANDOM); + } + } + // at this point we have no choice but to use a pure-PHP CSPRNG + + // cascade entropy across multiple PHP instances by fixing the session and collecting all + // environmental variables, including the previous session data and the current session + // data. + // + // mt_rand seeds itself by looking at the PID and the time, both of which are (relatively) + // easy to guess at. linux uses mouse clicks, keyboard timings, etc, as entropy sources, but + // PHP isn't low level to be able to use those as sources and on a web server there's not likely + // going to be a ton of keyboard or mouse action. web servers do have one thing that we can use + // however, a ton of people visiting the website. obviously you don't want to base your seeding + // soley on parameters a potential attacker sends but (1) not everything in $_SERVER is controlled + // by the user and (2) this isn't just looking at the data sent by the current user - it's based + // on the data sent by all users. one user requests the page and a hash of their info is saved. + // another user visits the page and the serialization of their data is utilized along with the + // server envirnment stuff and a hash of the previous http request data (which itself utilizes + // a hash of the session data before that). certainly an attacker should be assumed to have + // full control over his own http requests. he, however, is not going to have control over + // everyone's http requests. + static $crypto = false, $v; + if ($crypto === false) { + // save old session data + $old_session_id = session_id(); + $old_use_cookies = ini_get('session.use_cookies'); + $old_session_cache_limiter = session_cache_limiter(); + $_OLD_SESSION = isset($_SESSION) ? $_SESSION : false; + if ($old_session_id != '') { + session_write_close(); + } + + session_id(1); + ini_set('session.use_cookies', 0); + session_cache_limiter(''); + session_start(); + + $v = $seed = $_SESSION['seed'] = pack('H*', sha1( + (isset($_SERVER) ? phpseclib_safe_serialize($_SERVER) : '') . + (isset($_POST) ? phpseclib_safe_serialize($_POST) : '') . + (isset($_GET) ? phpseclib_safe_serialize($_GET) : '') . + (isset($_COOKIE) ? phpseclib_safe_serialize($_COOKIE) : '') . + phpseclib_safe_serialize($GLOBALS) . + phpseclib_safe_serialize($_SESSION) . + phpseclib_safe_serialize($_OLD_SESSION) + )); + if (!isset($_SESSION['count'])) { + $_SESSION['count'] = 0; + } + $_SESSION['count']++; + + session_write_close(); + + // restore old session data + if ($old_session_id != '') { + session_id($old_session_id); + session_start(); + ini_set('session.use_cookies', $old_use_cookies); + session_cache_limiter($old_session_cache_limiter); + } else { + if ($_OLD_SESSION !== false) { + $_SESSION = $_OLD_SESSION; + unset($_OLD_SESSION); + } else { + unset($_SESSION); + } + } + + // in SSH2 a shared secret and an exchange hash are generated through the key exchange process. + // the IV client to server is the hash of that "nonce" with the letter A and for the encryption key it's the letter C. + // if the hash doesn't produce enough a key or an IV that's long enough concat successive hashes of the + // original hash and the current hash. we'll be emulating that. for more info see the following URL: + // + // http://tools.ietf.org/html/rfc4253#section-7.2 + // + // see the is_string($crypto) part for an example of how to expand the keys + $key = pack('H*', sha1($seed . 'A')); + $iv = pack('H*', sha1($seed . 'C')); + + // ciphers are used as per the nist.gov link below. also, see this link: + // + // http://en.wikipedia.org/wiki/Cryptographically_secure_pseudorandom_number_generator#Designs_based_on_cryptographic_primitives + switch (true) { + case class_exists('\phpseclib\Crypt\AES'): + $crypto = new AES(Base::MODE_CTR); + break; + case class_exists('\phpseclib\Crypt\Twofish'): + $crypto = new Twofish(Base::MODE_CTR); + break; + case class_exists('\phpseclib\Crypt\Blowfish'): + $crypto = new Blowfish(Base::MODE_CTR); + break; + case class_exists('\phpseclib\Crypt\TripleDES'): + $crypto = new TripleDES(Base::MODE_CTR); + break; + case class_exists('\phpseclib\Crypt\DES'): + $crypto = new DES(Base::MODE_CTR); + break; + case class_exists('\phpseclib\Crypt\RC4'): + $crypto = new RC4(); + break; + default: + user_error(__CLASS__ . ' requires at least one symmetric cipher be loaded'); + return false; + } + + $crypto->setKey($key); + $crypto->setIV($iv); + $crypto->enableContinuousBuffer(); + } + + //return $crypto->encrypt(str_repeat("\0", $length)); + + // the following is based off of ANSI X9.31: + // + // http://csrc.nist.gov/groups/STM/cavp/documents/rng/931rngext.pdf + // + // OpenSSL uses that same standard for it's random numbers: + // + // http://www.opensource.apple.com/source/OpenSSL/OpenSSL-38/openssl/fips-1.0/rand/fips_rand.c + // (do a search for "ANS X9.31 A.2.4") + $result = ''; + while (strlen($result) < $length) { + $i = $crypto->encrypt(microtime()); // strlen(microtime()) == 21 + $r = $crypto->encrypt($i ^ $v); // strlen($v) == 20 + $v = $crypto->encrypt($r ^ $i); // strlen($r) == 20 + $result.= $r; + } + return substr($result, 0, $length); + } +} + +if (!function_exists('phpseclib_safe_serialize')) { + /** + * Safely serialize variables + * + * If a class has a private __sleep() method it'll give a fatal error on PHP 5.2 and earlier. + * PHP 5.3 will emit a warning. + * + * @param mixed $arr + * @access public + */ + function phpseclib_safe_serialize(&$arr) + { + if (is_object($arr)) { + return ''; + } + if (!is_array($arr)) { + return serialize($arr); + } + // prevent circular array recursion + if (isset($arr['__phpseclib_marker'])) { + return ''; + } + $safearr = array(); + $arr['__phpseclib_marker'] = true; + foreach (array_keys($arr) as $key) { + // do not recurse on the '__phpseclib_marker' key itself, for smaller memory usage + if ($key !== '__phpseclib_marker') { + $safearr[$key] = phpseclib_safe_serialize($arr[$key]); + } + } + unset($arr['__phpseclib_marker']); + return serialize($safearr); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Rijndael.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Rijndael.php new file mode 100644 index 0000000..3648a19 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Rijndael.php @@ -0,0 +1,936 @@ + + * setKey('abcdefghijklmnop'); + * + * $size = 10 * 1024; + * $plaintext = ''; + * for ($i = 0; $i < $size; $i++) { + * $plaintext.= 'a'; + * } + * + * echo $rijndael->decrypt($rijndael->encrypt($plaintext)); + * ?> + * + * + * @category Crypt + * @package Rijndael + * @author Jim Wigginton + * @copyright 2008 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP implementation of Rijndael. + * + * @package Rijndael + * @author Jim Wigginton + * @access public + */ +class Rijndael extends Base +{ + /** + * The mcrypt specific name of the cipher + * + * Mcrypt is useable for 128/192/256-bit $block_size/$key_length. For 160/224 not. + * \phpseclib\Crypt\Rijndael determines automatically whether mcrypt is useable + * or not for the current $block_size/$key_length. + * In case of, $cipher_name_mcrypt will be set dynamically at run time accordingly. + * + * @see \phpseclib\Crypt\Base::cipher_name_mcrypt + * @see \phpseclib\Crypt\Base::engine + * @see self::isValidEngine() + * @var string + * @access private + */ + var $cipher_name_mcrypt = 'rijndael-128'; + + /** + * The default salt used by setPassword() + * + * @see \phpseclib\Crypt\Base::password_default_salt + * @see \phpseclib\Crypt\Base::setPassword() + * @var string + * @access private + */ + var $password_default_salt = 'phpseclib'; + + /** + * The Key Schedule + * + * @see self::_setup() + * @var array + * @access private + */ + var $w; + + /** + * The Inverse Key Schedule + * + * @see self::_setup() + * @var array + * @access private + */ + var $dw; + + /** + * The Block Length divided by 32 + * + * @see self::setBlockLength() + * @var int + * @access private + * @internal The max value is 256 / 32 = 8, the min value is 128 / 32 = 4. Exists in conjunction with $block_size + * because the encryption / decryption / key schedule creation requires this number and not $block_size. We could + * derive this from $block_size or vice versa, but that'd mean we'd have to do multiple shift operations, so in lieu + * of that, we'll just precompute it once. + */ + var $Nb = 4; + + /** + * The Key Length (in bytes) + * + * @see self::setKeyLength() + * @var int + * @access private + * @internal The max value is 256 / 8 = 32, the min value is 128 / 8 = 16. Exists in conjunction with $Nk + * because the encryption / decryption / key schedule creation requires this number and not $key_length. We could + * derive this from $key_length or vice versa, but that'd mean we'd have to do multiple shift operations, so in lieu + * of that, we'll just precompute it once. + */ + var $key_length = 16; + + /** + * The Key Length divided by 32 + * + * @see self::setKeyLength() + * @var int + * @access private + * @internal The max value is 256 / 32 = 8, the min value is 128 / 32 = 4 + */ + var $Nk = 4; + + /** + * The Number of Rounds + * + * @var int + * @access private + * @internal The max value is 14, the min value is 10. + */ + var $Nr; + + /** + * Shift offsets + * + * @var array + * @access private + */ + var $c; + + /** + * Holds the last used key- and block_size information + * + * @var array + * @access private + */ + var $kl; + + /** + * Sets the key length. + * + * Valid key lengths are 128, 160, 192, 224, and 256. If the length is less than 128, it will be rounded up to + * 128. If the length is greater than 128 and invalid, it will be rounded down to the closest valid amount. + * + * Note: phpseclib extends Rijndael (and AES) for using 160- and 224-bit keys but they are officially not defined + * and the most (if not all) implementations are not able using 160/224-bit keys but round/pad them up to + * 192/256 bits as, for example, mcrypt will do. + * + * That said, if you want be compatible with other Rijndael and AES implementations, + * you should not setKeyLength(160) or setKeyLength(224). + * + * Additional: In case of 160- and 224-bit keys, phpseclib will/can, for that reason, not use + * the mcrypt php extension, even if available. + * This results then in slower encryption. + * + * @access public + * @param int $length + */ + function setKeyLength($length) + { + switch (true) { + case $length <= 128: + $this->key_length = 16; + break; + case $length <= 160: + $this->key_length = 20; + break; + case $length <= 192: + $this->key_length = 24; + break; + case $length <= 224: + $this->key_length = 28; + break; + default: + $this->key_length = 32; + } + + parent::setKeyLength($length); + } + + /** + * Sets the block length + * + * Valid block lengths are 128, 160, 192, 224, and 256. If the length is less than 128, it will be rounded up to + * 128. If the length is greater than 128 and invalid, it will be rounded down to the closest valid amount. + * + * @access public + * @param int $length + */ + function setBlockLength($length) + { + $length >>= 5; + if ($length > 8) { + $length = 8; + } elseif ($length < 4) { + $length = 4; + } + $this->Nb = $length; + $this->block_size = $length << 2; + $this->changed = true; + $this->_setEngine(); + } + + /** + * Test for engine validity + * + * This is mainly just a wrapper to set things up for \phpseclib\Crypt\Base::isValidEngine() + * + * @see \phpseclib\Crypt\Base::__construct() + * @param int $engine + * @access public + * @return bool + */ + function isValidEngine($engine) + { + switch ($engine) { + case self::ENGINE_OPENSSL: + if ($this->block_size != 16) { + return false; + } + $this->cipher_name_openssl_ecb = 'aes-' . ($this->key_length << 3) . '-ecb'; + $this->cipher_name_openssl = 'aes-' . ($this->key_length << 3) . '-' . $this->_openssl_translate_mode(); + break; + case self::ENGINE_MCRYPT: + $this->cipher_name_mcrypt = 'rijndael-' . ($this->block_size << 3); + if ($this->key_length % 8) { // is it a 160/224-bit key? + // mcrypt is not usable for them, only for 128/192/256-bit keys + return false; + } + } + + return parent::isValidEngine($engine); + } + + /** + * Encrypts a block + * + * @access private + * @param string $in + * @return string + */ + function _encryptBlock($in) + { + static $tables; + if (empty($tables)) { + $tables = &$this->_getTables(); + } + $t0 = $tables[0]; + $t1 = $tables[1]; + $t2 = $tables[2]; + $t3 = $tables[3]; + $sbox = $tables[4]; + + $state = array(); + $words = unpack('N*', $in); + + $c = $this->c; + $w = $this->w; + $Nb = $this->Nb; + $Nr = $this->Nr; + + // addRoundKey + $wc = $Nb - 1; + foreach ($words as $word) { + $state[] = $word ^ $w[++$wc]; + } + + // fips-197.pdf#page=19, "Figure 5. Pseudo Code for the Cipher", states that this loop has four components - + // subBytes, shiftRows, mixColumns, and addRoundKey. fips-197.pdf#page=30, "Implementation Suggestions Regarding + // Various Platforms" suggests that performs enhanced implementations are described in Rijndael-ammended.pdf. + // Rijndael-ammended.pdf#page=20, "Implementation aspects / 32-bit processor", discusses such an optimization. + // Unfortunately, the description given there is not quite correct. Per aes.spec.v316.pdf#page=19 [1], + // equation (7.4.7) is supposed to use addition instead of subtraction, so we'll do that here, as well. + + // [1] http://fp.gladman.plus.com/cryptography_technology/rijndael/aes.spec.v316.pdf + $temp = array(); + for ($round = 1; $round < $Nr; ++$round) { + $i = 0; // $c[0] == 0 + $j = $c[1]; + $k = $c[2]; + $l = $c[3]; + + while ($i < $Nb) { + $temp[$i] = $t0[$state[$i] >> 24 & 0x000000FF] ^ + $t1[$state[$j] >> 16 & 0x000000FF] ^ + $t2[$state[$k] >> 8 & 0x000000FF] ^ + $t3[$state[$l] & 0x000000FF] ^ + $w[++$wc]; + ++$i; + $j = ($j + 1) % $Nb; + $k = ($k + 1) % $Nb; + $l = ($l + 1) % $Nb; + } + $state = $temp; + } + + // subWord + for ($i = 0; $i < $Nb; ++$i) { + $state[$i] = $sbox[$state[$i] & 0x000000FF] | + ($sbox[$state[$i] >> 8 & 0x000000FF] << 8) | + ($sbox[$state[$i] >> 16 & 0x000000FF] << 16) | + ($sbox[$state[$i] >> 24 & 0x000000FF] << 24); + } + + // shiftRows + addRoundKey + $i = 0; // $c[0] == 0 + $j = $c[1]; + $k = $c[2]; + $l = $c[3]; + while ($i < $Nb) { + $temp[$i] = ($state[$i] & 0xFF000000) ^ + ($state[$j] & 0x00FF0000) ^ + ($state[$k] & 0x0000FF00) ^ + ($state[$l] & 0x000000FF) ^ + $w[$i]; + ++$i; + $j = ($j + 1) % $Nb; + $k = ($k + 1) % $Nb; + $l = ($l + 1) % $Nb; + } + + switch ($Nb) { + case 8: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3], $temp[4], $temp[5], $temp[6], $temp[7]); + case 7: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3], $temp[4], $temp[5], $temp[6]); + case 6: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3], $temp[4], $temp[5]); + case 5: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3], $temp[4]); + default: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3]); + } + } + + /** + * Decrypts a block + * + * @access private + * @param string $in + * @return string + */ + function _decryptBlock($in) + { + static $invtables; + if (empty($invtables)) { + $invtables = &$this->_getInvTables(); + } + $dt0 = $invtables[0]; + $dt1 = $invtables[1]; + $dt2 = $invtables[2]; + $dt3 = $invtables[3]; + $isbox = $invtables[4]; + + $state = array(); + $words = unpack('N*', $in); + + $c = $this->c; + $dw = $this->dw; + $Nb = $this->Nb; + $Nr = $this->Nr; + + // addRoundKey + $wc = $Nb - 1; + foreach ($words as $word) { + $state[] = $word ^ $dw[++$wc]; + } + + $temp = array(); + for ($round = $Nr - 1; $round > 0; --$round) { + $i = 0; // $c[0] == 0 + $j = $Nb - $c[1]; + $k = $Nb - $c[2]; + $l = $Nb - $c[3]; + + while ($i < $Nb) { + $temp[$i] = $dt0[$state[$i] >> 24 & 0x000000FF] ^ + $dt1[$state[$j] >> 16 & 0x000000FF] ^ + $dt2[$state[$k] >> 8 & 0x000000FF] ^ + $dt3[$state[$l] & 0x000000FF] ^ + $dw[++$wc]; + ++$i; + $j = ($j + 1) % $Nb; + $k = ($k + 1) % $Nb; + $l = ($l + 1) % $Nb; + } + $state = $temp; + } + + // invShiftRows + invSubWord + addRoundKey + $i = 0; // $c[0] == 0 + $j = $Nb - $c[1]; + $k = $Nb - $c[2]; + $l = $Nb - $c[3]; + + while ($i < $Nb) { + $word = ($state[$i] & 0xFF000000) | + ($state[$j] & 0x00FF0000) | + ($state[$k] & 0x0000FF00) | + ($state[$l] & 0x000000FF); + + $temp[$i] = $dw[$i] ^ ($isbox[$word & 0x000000FF] | + ($isbox[$word >> 8 & 0x000000FF] << 8) | + ($isbox[$word >> 16 & 0x000000FF] << 16) | + ($isbox[$word >> 24 & 0x000000FF] << 24)); + ++$i; + $j = ($j + 1) % $Nb; + $k = ($k + 1) % $Nb; + $l = ($l + 1) % $Nb; + } + + switch ($Nb) { + case 8: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3], $temp[4], $temp[5], $temp[6], $temp[7]); + case 7: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3], $temp[4], $temp[5], $temp[6]); + case 6: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3], $temp[4], $temp[5]); + case 5: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3], $temp[4]); + default: + return pack('N*', $temp[0], $temp[1], $temp[2], $temp[3]); + } + } + + /** + * Setup the key (expansion) + * + * @see \phpseclib\Crypt\Base::_setupKey() + * @access private + */ + function _setupKey() + { + // Each number in $rcon is equal to the previous number multiplied by two in Rijndael's finite field. + // See http://en.wikipedia.org/wiki/Finite_field_arithmetic#Multiplicative_inverse + static $rcon = array(0, + 0x01000000, 0x02000000, 0x04000000, 0x08000000, 0x10000000, + 0x20000000, 0x40000000, 0x80000000, 0x1B000000, 0x36000000, + 0x6C000000, 0xD8000000, 0xAB000000, 0x4D000000, 0x9A000000, + 0x2F000000, 0x5E000000, 0xBC000000, 0x63000000, 0xC6000000, + 0x97000000, 0x35000000, 0x6A000000, 0xD4000000, 0xB3000000, + 0x7D000000, 0xFA000000, 0xEF000000, 0xC5000000, 0x91000000 + ); + + if (isset($this->kl['key']) && $this->key === $this->kl['key'] && $this->key_length === $this->kl['key_length'] && $this->block_size === $this->kl['block_size']) { + // already expanded + return; + } + $this->kl = array('key' => $this->key, 'key_length' => $this->key_length, 'block_size' => $this->block_size); + + $this->Nk = $this->key_length >> 2; + // see Rijndael-ammended.pdf#page=44 + $this->Nr = max($this->Nk, $this->Nb) + 6; + + // shift offsets for Nb = 5, 7 are defined in Rijndael-ammended.pdf#page=44, + // "Table 8: Shift offsets in Shiftrow for the alternative block lengths" + // shift offsets for Nb = 4, 6, 8 are defined in Rijndael-ammended.pdf#page=14, + // "Table 2: Shift offsets for different block lengths" + switch ($this->Nb) { + case 4: + case 5: + case 6: + $this->c = array(0, 1, 2, 3); + break; + case 7: + $this->c = array(0, 1, 2, 4); + break; + case 8: + $this->c = array(0, 1, 3, 4); + } + + $w = array_values(unpack('N*words', $this->key)); + + $length = $this->Nb * ($this->Nr + 1); + for ($i = $this->Nk; $i < $length; $i++) { + $temp = $w[$i - 1]; + if ($i % $this->Nk == 0) { + // according to , "the size of an integer is platform-dependent". + // on a 32-bit machine, it's 32-bits, and on a 64-bit machine, it's 64-bits. on a 32-bit machine, + // 0xFFFFFFFF << 8 == 0xFFFFFF00, but on a 64-bit machine, it equals 0xFFFFFFFF00. as such, doing 'and' + // with 0xFFFFFFFF (or 0xFFFFFF00) on a 32-bit machine is unnecessary, but on a 64-bit machine, it is. + $temp = (($temp << 8) & 0xFFFFFF00) | (($temp >> 24) & 0x000000FF); // rotWord + $temp = $this->_subWord($temp) ^ $rcon[$i / $this->Nk]; + } elseif ($this->Nk > 6 && $i % $this->Nk == 4) { + $temp = $this->_subWord($temp); + } + $w[$i] = $w[$i - $this->Nk] ^ $temp; + } + + // convert the key schedule from a vector of $Nb * ($Nr + 1) length to a matrix with $Nr + 1 rows and $Nb columns + // and generate the inverse key schedule. more specifically, + // according to (section 5.3.3), + // "The key expansion for the Inverse Cipher is defined as follows: + // 1. Apply the Key Expansion. + // 2. Apply InvMixColumn to all Round Keys except the first and the last one." + // also, see fips-197.pdf#page=27, "5.3.5 Equivalent Inverse Cipher" + list($dt0, $dt1, $dt2, $dt3) = $this->_getInvTables(); + $temp = $this->w = $this->dw = array(); + for ($i = $row = $col = 0; $i < $length; $i++, $col++) { + if ($col == $this->Nb) { + if ($row == 0) { + $this->dw[0] = $this->w[0]; + } else { + // subWord + invMixColumn + invSubWord = invMixColumn + $j = 0; + while ($j < $this->Nb) { + $dw = $this->_subWord($this->w[$row][$j]); + $temp[$j] = $dt0[$dw >> 24 & 0x000000FF] ^ + $dt1[$dw >> 16 & 0x000000FF] ^ + $dt2[$dw >> 8 & 0x000000FF] ^ + $dt3[$dw & 0x000000FF]; + $j++; + } + $this->dw[$row] = $temp; + } + + $col = 0; + $row++; + } + $this->w[$row][$col] = $w[$i]; + } + + $this->dw[$row] = $this->w[$row]; + + // Converting to 1-dim key arrays (both ascending) + $this->dw = array_reverse($this->dw); + $w = array_pop($this->w); + $dw = array_pop($this->dw); + foreach ($this->w as $r => $wr) { + foreach ($wr as $c => $wc) { + $w[] = $wc; + $dw[] = $this->dw[$r][$c]; + } + } + $this->w = $w; + $this->dw = $dw; + } + + /** + * Performs S-Box substitutions + * + * @access private + * @param int $word + */ + function _subWord($word) + { + static $sbox; + if (empty($sbox)) { + list(, , , , $sbox) = $this->_getTables(); + } + + return $sbox[$word & 0x000000FF] | + ($sbox[$word >> 8 & 0x000000FF] << 8) | + ($sbox[$word >> 16 & 0x000000FF] << 16) | + ($sbox[$word >> 24 & 0x000000FF] << 24); + } + + /** + * Provides the mixColumns and sboxes tables + * + * @see self::_encryptBlock() + * @see self::_setupInlineCrypt() + * @see self::_subWord() + * @access private + * @return array &$tables + */ + function &_getTables() + { + static $tables; + if (empty($tables)) { + // according to (section 5.2.1), + // precomputed tables can be used in the mixColumns phase. in that example, they're assigned t0...t3, so + // those are the names we'll use. + $t3 = array_map('intval', array( + // with array_map('intval', ...) we ensure we have only int's and not + // some slower floats converted by php automatically on high values + 0x6363A5C6, 0x7C7C84F8, 0x777799EE, 0x7B7B8DF6, 0xF2F20DFF, 0x6B6BBDD6, 0x6F6FB1DE, 0xC5C55491, + 0x30305060, 0x01010302, 0x6767A9CE, 0x2B2B7D56, 0xFEFE19E7, 0xD7D762B5, 0xABABE64D, 0x76769AEC, + 0xCACA458F, 0x82829D1F, 0xC9C94089, 0x7D7D87FA, 0xFAFA15EF, 0x5959EBB2, 0x4747C98E, 0xF0F00BFB, + 0xADADEC41, 0xD4D467B3, 0xA2A2FD5F, 0xAFAFEA45, 0x9C9CBF23, 0xA4A4F753, 0x727296E4, 0xC0C05B9B, + 0xB7B7C275, 0xFDFD1CE1, 0x9393AE3D, 0x26266A4C, 0x36365A6C, 0x3F3F417E, 0xF7F702F5, 0xCCCC4F83, + 0x34345C68, 0xA5A5F451, 0xE5E534D1, 0xF1F108F9, 0x717193E2, 0xD8D873AB, 0x31315362, 0x15153F2A, + 0x04040C08, 0xC7C75295, 0x23236546, 0xC3C35E9D, 0x18182830, 0x9696A137, 0x05050F0A, 0x9A9AB52F, + 0x0707090E, 0x12123624, 0x80809B1B, 0xE2E23DDF, 0xEBEB26CD, 0x2727694E, 0xB2B2CD7F, 0x75759FEA, + 0x09091B12, 0x83839E1D, 0x2C2C7458, 0x1A1A2E34, 0x1B1B2D36, 0x6E6EB2DC, 0x5A5AEEB4, 0xA0A0FB5B, + 0x5252F6A4, 0x3B3B4D76, 0xD6D661B7, 0xB3B3CE7D, 0x29297B52, 0xE3E33EDD, 0x2F2F715E, 0x84849713, + 0x5353F5A6, 0xD1D168B9, 0x00000000, 0xEDED2CC1, 0x20206040, 0xFCFC1FE3, 0xB1B1C879, 0x5B5BEDB6, + 0x6A6ABED4, 0xCBCB468D, 0xBEBED967, 0x39394B72, 0x4A4ADE94, 0x4C4CD498, 0x5858E8B0, 0xCFCF4A85, + 0xD0D06BBB, 0xEFEF2AC5, 0xAAAAE54F, 0xFBFB16ED, 0x4343C586, 0x4D4DD79A, 0x33335566, 0x85859411, + 0x4545CF8A, 0xF9F910E9, 0x02020604, 0x7F7F81FE, 0x5050F0A0, 0x3C3C4478, 0x9F9FBA25, 0xA8A8E34B, + 0x5151F3A2, 0xA3A3FE5D, 0x4040C080, 0x8F8F8A05, 0x9292AD3F, 0x9D9DBC21, 0x38384870, 0xF5F504F1, + 0xBCBCDF63, 0xB6B6C177, 0xDADA75AF, 0x21216342, 0x10103020, 0xFFFF1AE5, 0xF3F30EFD, 0xD2D26DBF, + 0xCDCD4C81, 0x0C0C1418, 0x13133526, 0xECEC2FC3, 0x5F5FE1BE, 0x9797A235, 0x4444CC88, 0x1717392E, + 0xC4C45793, 0xA7A7F255, 0x7E7E82FC, 0x3D3D477A, 0x6464ACC8, 0x5D5DE7BA, 0x19192B32, 0x737395E6, + 0x6060A0C0, 0x81819819, 0x4F4FD19E, 0xDCDC7FA3, 0x22226644, 0x2A2A7E54, 0x9090AB3B, 0x8888830B, + 0x4646CA8C, 0xEEEE29C7, 0xB8B8D36B, 0x14143C28, 0xDEDE79A7, 0x5E5EE2BC, 0x0B0B1D16, 0xDBDB76AD, + 0xE0E03BDB, 0x32325664, 0x3A3A4E74, 0x0A0A1E14, 0x4949DB92, 0x06060A0C, 0x24246C48, 0x5C5CE4B8, + 0xC2C25D9F, 0xD3D36EBD, 0xACACEF43, 0x6262A6C4, 0x9191A839, 0x9595A431, 0xE4E437D3, 0x79798BF2, + 0xE7E732D5, 0xC8C8438B, 0x3737596E, 0x6D6DB7DA, 0x8D8D8C01, 0xD5D564B1, 0x4E4ED29C, 0xA9A9E049, + 0x6C6CB4D8, 0x5656FAAC, 0xF4F407F3, 0xEAEA25CF, 0x6565AFCA, 0x7A7A8EF4, 0xAEAEE947, 0x08081810, + 0xBABAD56F, 0x787888F0, 0x25256F4A, 0x2E2E725C, 0x1C1C2438, 0xA6A6F157, 0xB4B4C773, 0xC6C65197, + 0xE8E823CB, 0xDDDD7CA1, 0x74749CE8, 0x1F1F213E, 0x4B4BDD96, 0xBDBDDC61, 0x8B8B860D, 0x8A8A850F, + 0x707090E0, 0x3E3E427C, 0xB5B5C471, 0x6666AACC, 0x4848D890, 0x03030506, 0xF6F601F7, 0x0E0E121C, + 0x6161A3C2, 0x35355F6A, 0x5757F9AE, 0xB9B9D069, 0x86869117, 0xC1C15899, 0x1D1D273A, 0x9E9EB927, + 0xE1E138D9, 0xF8F813EB, 0x9898B32B, 0x11113322, 0x6969BBD2, 0xD9D970A9, 0x8E8E8907, 0x9494A733, + 0x9B9BB62D, 0x1E1E223C, 0x87879215, 0xE9E920C9, 0xCECE4987, 0x5555FFAA, 0x28287850, 0xDFDF7AA5, + 0x8C8C8F03, 0xA1A1F859, 0x89898009, 0x0D0D171A, 0xBFBFDA65, 0xE6E631D7, 0x4242C684, 0x6868B8D0, + 0x4141C382, 0x9999B029, 0x2D2D775A, 0x0F0F111E, 0xB0B0CB7B, 0x5454FCA8, 0xBBBBD66D, 0x16163A2C + )); + + foreach ($t3 as $t3i) { + $t0[] = (($t3i << 24) & 0xFF000000) | (($t3i >> 8) & 0x00FFFFFF); + $t1[] = (($t3i << 16) & 0xFFFF0000) | (($t3i >> 16) & 0x0000FFFF); + $t2[] = (($t3i << 8) & 0xFFFFFF00) | (($t3i >> 24) & 0x000000FF); + } + + $tables = array( + // The Precomputed mixColumns tables t0 - t3 + $t0, + $t1, + $t2, + $t3, + // The SubByte S-Box + array( + 0x63, 0x7C, 0x77, 0x7B, 0xF2, 0x6B, 0x6F, 0xC5, 0x30, 0x01, 0x67, 0x2B, 0xFE, 0xD7, 0xAB, 0x76, + 0xCA, 0x82, 0xC9, 0x7D, 0xFA, 0x59, 0x47, 0xF0, 0xAD, 0xD4, 0xA2, 0xAF, 0x9C, 0xA4, 0x72, 0xC0, + 0xB7, 0xFD, 0x93, 0x26, 0x36, 0x3F, 0xF7, 0xCC, 0x34, 0xA5, 0xE5, 0xF1, 0x71, 0xD8, 0x31, 0x15, + 0x04, 0xC7, 0x23, 0xC3, 0x18, 0x96, 0x05, 0x9A, 0x07, 0x12, 0x80, 0xE2, 0xEB, 0x27, 0xB2, 0x75, + 0x09, 0x83, 0x2C, 0x1A, 0x1B, 0x6E, 0x5A, 0xA0, 0x52, 0x3B, 0xD6, 0xB3, 0x29, 0xE3, 0x2F, 0x84, + 0x53, 0xD1, 0x00, 0xED, 0x20, 0xFC, 0xB1, 0x5B, 0x6A, 0xCB, 0xBE, 0x39, 0x4A, 0x4C, 0x58, 0xCF, + 0xD0, 0xEF, 0xAA, 0xFB, 0x43, 0x4D, 0x33, 0x85, 0x45, 0xF9, 0x02, 0x7F, 0x50, 0x3C, 0x9F, 0xA8, + 0x51, 0xA3, 0x40, 0x8F, 0x92, 0x9D, 0x38, 0xF5, 0xBC, 0xB6, 0xDA, 0x21, 0x10, 0xFF, 0xF3, 0xD2, + 0xCD, 0x0C, 0x13, 0xEC, 0x5F, 0x97, 0x44, 0x17, 0xC4, 0xA7, 0x7E, 0x3D, 0x64, 0x5D, 0x19, 0x73, + 0x60, 0x81, 0x4F, 0xDC, 0x22, 0x2A, 0x90, 0x88, 0x46, 0xEE, 0xB8, 0x14, 0xDE, 0x5E, 0x0B, 0xDB, + 0xE0, 0x32, 0x3A, 0x0A, 0x49, 0x06, 0x24, 0x5C, 0xC2, 0xD3, 0xAC, 0x62, 0x91, 0x95, 0xE4, 0x79, + 0xE7, 0xC8, 0x37, 0x6D, 0x8D, 0xD5, 0x4E, 0xA9, 0x6C, 0x56, 0xF4, 0xEA, 0x65, 0x7A, 0xAE, 0x08, + 0xBA, 0x78, 0x25, 0x2E, 0x1C, 0xA6, 0xB4, 0xC6, 0xE8, 0xDD, 0x74, 0x1F, 0x4B, 0xBD, 0x8B, 0x8A, + 0x70, 0x3E, 0xB5, 0x66, 0x48, 0x03, 0xF6, 0x0E, 0x61, 0x35, 0x57, 0xB9, 0x86, 0xC1, 0x1D, 0x9E, + 0xE1, 0xF8, 0x98, 0x11, 0x69, 0xD9, 0x8E, 0x94, 0x9B, 0x1E, 0x87, 0xE9, 0xCE, 0x55, 0x28, 0xDF, + 0x8C, 0xA1, 0x89, 0x0D, 0xBF, 0xE6, 0x42, 0x68, 0x41, 0x99, 0x2D, 0x0F, 0xB0, 0x54, 0xBB, 0x16 + ) + ); + } + return $tables; + } + + /** + * Provides the inverse mixColumns and inverse sboxes tables + * + * @see self::_decryptBlock() + * @see self::_setupInlineCrypt() + * @see self::_setupKey() + * @access private + * @return array &$tables + */ + function &_getInvTables() + { + static $tables; + if (empty($tables)) { + $dt3 = array_map('intval', array( + 0xF4A75051, 0x4165537E, 0x17A4C31A, 0x275E963A, 0xAB6BCB3B, 0x9D45F11F, 0xFA58ABAC, 0xE303934B, + 0x30FA5520, 0x766DF6AD, 0xCC769188, 0x024C25F5, 0xE5D7FC4F, 0x2ACBD7C5, 0x35448026, 0x62A38FB5, + 0xB15A49DE, 0xBA1B6725, 0xEA0E9845, 0xFEC0E15D, 0x2F7502C3, 0x4CF01281, 0x4697A38D, 0xD3F9C66B, + 0x8F5FE703, 0x929C9515, 0x6D7AEBBF, 0x5259DA95, 0xBE832DD4, 0x7421D358, 0xE0692949, 0xC9C8448E, + 0xC2896A75, 0x8E7978F4, 0x583E6B99, 0xB971DD27, 0xE14FB6BE, 0x88AD17F0, 0x20AC66C9, 0xCE3AB47D, + 0xDF4A1863, 0x1A3182E5, 0x51336097, 0x537F4562, 0x6477E0B1, 0x6BAE84BB, 0x81A01CFE, 0x082B94F9, + 0x48685870, 0x45FD198F, 0xDE6C8794, 0x7BF8B752, 0x73D323AB, 0x4B02E272, 0x1F8F57E3, 0x55AB2A66, + 0xEB2807B2, 0xB5C2032F, 0xC57B9A86, 0x3708A5D3, 0x2887F230, 0xBFA5B223, 0x036ABA02, 0x16825CED, + 0xCF1C2B8A, 0x79B492A7, 0x07F2F0F3, 0x69E2A14E, 0xDAF4CD65, 0x05BED506, 0x34621FD1, 0xA6FE8AC4, + 0x2E539D34, 0xF355A0A2, 0x8AE13205, 0xF6EB75A4, 0x83EC390B, 0x60EFAA40, 0x719F065E, 0x6E1051BD, + 0x218AF93E, 0xDD063D96, 0x3E05AEDD, 0xE6BD464D, 0x548DB591, 0xC45D0571, 0x06D46F04, 0x5015FF60, + 0x98FB2419, 0xBDE997D6, 0x4043CC89, 0xD99E7767, 0xE842BDB0, 0x898B8807, 0x195B38E7, 0xC8EEDB79, + 0x7C0A47A1, 0x420FE97C, 0x841EC9F8, 0x00000000, 0x80868309, 0x2BED4832, 0x1170AC1E, 0x5A724E6C, + 0x0EFFFBFD, 0x8538560F, 0xAED51E3D, 0x2D392736, 0x0FD9640A, 0x5CA62168, 0x5B54D19B, 0x362E3A24, + 0x0A67B10C, 0x57E70F93, 0xEE96D2B4, 0x9B919E1B, 0xC0C54F80, 0xDC20A261, 0x774B695A, 0x121A161C, + 0x93BA0AE2, 0xA02AE5C0, 0x22E0433C, 0x1B171D12, 0x090D0B0E, 0x8BC7ADF2, 0xB6A8B92D, 0x1EA9C814, + 0xF1198557, 0x75074CAF, 0x99DDBBEE, 0x7F60FDA3, 0x01269FF7, 0x72F5BC5C, 0x663BC544, 0xFB7E345B, + 0x4329768B, 0x23C6DCCB, 0xEDFC68B6, 0xE4F163B8, 0x31DCCAD7, 0x63851042, 0x97224013, 0xC6112084, + 0x4A247D85, 0xBB3DF8D2, 0xF93211AE, 0x29A16DC7, 0x9E2F4B1D, 0xB230F3DC, 0x8652EC0D, 0xC1E3D077, + 0xB3166C2B, 0x70B999A9, 0x9448FA11, 0xE9642247, 0xFC8CC4A8, 0xF03F1AA0, 0x7D2CD856, 0x3390EF22, + 0x494EC787, 0x38D1C1D9, 0xCAA2FE8C, 0xD40B3698, 0xF581CFA6, 0x7ADE28A5, 0xB78E26DA, 0xADBFA43F, + 0x3A9DE42C, 0x78920D50, 0x5FCC9B6A, 0x7E466254, 0x8D13C2F6, 0xD8B8E890, 0x39F75E2E, 0xC3AFF582, + 0x5D80BE9F, 0xD0937C69, 0xD52DA96F, 0x2512B3CF, 0xAC993BC8, 0x187DA710, 0x9C636EE8, 0x3BBB7BDB, + 0x267809CD, 0x5918F46E, 0x9AB701EC, 0x4F9AA883, 0x956E65E6, 0xFFE67EAA, 0xBCCF0821, 0x15E8E6EF, + 0xE79BD9BA, 0x6F36CE4A, 0x9F09D4EA, 0xB07CD629, 0xA4B2AF31, 0x3F23312A, 0xA59430C6, 0xA266C035, + 0x4EBC3774, 0x82CAA6FC, 0x90D0B0E0, 0xA7D81533, 0x04984AF1, 0xECDAF741, 0xCD500E7F, 0x91F62F17, + 0x4DD68D76, 0xEFB04D43, 0xAA4D54CC, 0x9604DFE4, 0xD1B5E39E, 0x6A881B4C, 0x2C1FB8C1, 0x65517F46, + 0x5EEA049D, 0x8C355D01, 0x877473FA, 0x0B412EFB, 0x671D5AB3, 0xDBD25292, 0x105633E9, 0xD647136D, + 0xD7618C9A, 0xA10C7A37, 0xF8148E59, 0x133C89EB, 0xA927EECE, 0x61C935B7, 0x1CE5EDE1, 0x47B13C7A, + 0xD2DF599C, 0xF2733F55, 0x14CE7918, 0xC737BF73, 0xF7CDEA53, 0xFDAA5B5F, 0x3D6F14DF, 0x44DB8678, + 0xAFF381CA, 0x68C43EB9, 0x24342C38, 0xA3405FC2, 0x1DC37216, 0xE2250CBC, 0x3C498B28, 0x0D9541FF, + 0xA8017139, 0x0CB3DE08, 0xB4E49CD8, 0x56C19064, 0xCB84617B, 0x32B670D5, 0x6C5C7448, 0xB85742D0 + )); + + foreach ($dt3 as $dt3i) { + $dt0[] = (($dt3i << 24) & 0xFF000000) | (($dt3i >> 8) & 0x00FFFFFF); + $dt1[] = (($dt3i << 16) & 0xFFFF0000) | (($dt3i >> 16) & 0x0000FFFF); + $dt2[] = (($dt3i << 8) & 0xFFFFFF00) | (($dt3i >> 24) & 0x000000FF); + }; + + $tables = array( + // The Precomputed inverse mixColumns tables dt0 - dt3 + $dt0, + $dt1, + $dt2, + $dt3, + // The inverse SubByte S-Box + array( + 0x52, 0x09, 0x6A, 0xD5, 0x30, 0x36, 0xA5, 0x38, 0xBF, 0x40, 0xA3, 0x9E, 0x81, 0xF3, 0xD7, 0xFB, + 0x7C, 0xE3, 0x39, 0x82, 0x9B, 0x2F, 0xFF, 0x87, 0x34, 0x8E, 0x43, 0x44, 0xC4, 0xDE, 0xE9, 0xCB, + 0x54, 0x7B, 0x94, 0x32, 0xA6, 0xC2, 0x23, 0x3D, 0xEE, 0x4C, 0x95, 0x0B, 0x42, 0xFA, 0xC3, 0x4E, + 0x08, 0x2E, 0xA1, 0x66, 0x28, 0xD9, 0x24, 0xB2, 0x76, 0x5B, 0xA2, 0x49, 0x6D, 0x8B, 0xD1, 0x25, + 0x72, 0xF8, 0xF6, 0x64, 0x86, 0x68, 0x98, 0x16, 0xD4, 0xA4, 0x5C, 0xCC, 0x5D, 0x65, 0xB6, 0x92, + 0x6C, 0x70, 0x48, 0x50, 0xFD, 0xED, 0xB9, 0xDA, 0x5E, 0x15, 0x46, 0x57, 0xA7, 0x8D, 0x9D, 0x84, + 0x90, 0xD8, 0xAB, 0x00, 0x8C, 0xBC, 0xD3, 0x0A, 0xF7, 0xE4, 0x58, 0x05, 0xB8, 0xB3, 0x45, 0x06, + 0xD0, 0x2C, 0x1E, 0x8F, 0xCA, 0x3F, 0x0F, 0x02, 0xC1, 0xAF, 0xBD, 0x03, 0x01, 0x13, 0x8A, 0x6B, + 0x3A, 0x91, 0x11, 0x41, 0x4F, 0x67, 0xDC, 0xEA, 0x97, 0xF2, 0xCF, 0xCE, 0xF0, 0xB4, 0xE6, 0x73, + 0x96, 0xAC, 0x74, 0x22, 0xE7, 0xAD, 0x35, 0x85, 0xE2, 0xF9, 0x37, 0xE8, 0x1C, 0x75, 0xDF, 0x6E, + 0x47, 0xF1, 0x1A, 0x71, 0x1D, 0x29, 0xC5, 0x89, 0x6F, 0xB7, 0x62, 0x0E, 0xAA, 0x18, 0xBE, 0x1B, + 0xFC, 0x56, 0x3E, 0x4B, 0xC6, 0xD2, 0x79, 0x20, 0x9A, 0xDB, 0xC0, 0xFE, 0x78, 0xCD, 0x5A, 0xF4, + 0x1F, 0xDD, 0xA8, 0x33, 0x88, 0x07, 0xC7, 0x31, 0xB1, 0x12, 0x10, 0x59, 0x27, 0x80, 0xEC, 0x5F, + 0x60, 0x51, 0x7F, 0xA9, 0x19, 0xB5, 0x4A, 0x0D, 0x2D, 0xE5, 0x7A, 0x9F, 0x93, 0xC9, 0x9C, 0xEF, + 0xA0, 0xE0, 0x3B, 0x4D, 0xAE, 0x2A, 0xF5, 0xB0, 0xC8, 0xEB, 0xBB, 0x3C, 0x83, 0x53, 0x99, 0x61, + 0x17, 0x2B, 0x04, 0x7E, 0xBA, 0x77, 0xD6, 0x26, 0xE1, 0x69, 0x14, 0x63, 0x55, 0x21, 0x0C, 0x7D + ) + ); + } + return $tables; + } + + /** + * Setup the performance-optimized function for de/encrypt() + * + * @see \phpseclib\Crypt\Base::_setupInlineCrypt() + * @access private + */ + function _setupInlineCrypt() + { + // Note: _setupInlineCrypt() will be called only if $this->changed === true + // So here we are'nt under the same heavy timing-stress as we are in _de/encryptBlock() or de/encrypt(). + // However...the here generated function- $code, stored as php callback in $this->inline_crypt, must work as fast as even possible. + + $lambda_functions =& self::_getLambdaFunctions(); + + // We create max. 10 hi-optimized code for memory reason. Means: For each $key one ultra fast inline-crypt function. + // (Currently, for Crypt_Rijndael/AES, one generated $lambda_function cost on php5.5@32bit ~80kb unfreeable mem and ~130kb on php5.5@64bit) + // After that, we'll still create very fast optimized code but not the hi-ultimative code, for each $mode one. + $gen_hi_opt_code = (bool)(count($lambda_functions) < 10); + + // Generation of a uniqe hash for our generated code + $code_hash = "Crypt_Rijndael, {$this->mode}, {$this->Nr}, {$this->Nb}"; + if ($gen_hi_opt_code) { + $code_hash = str_pad($code_hash, 32) . $this->_hashInlineCryptFunction($this->key); + } + + if (!isset($lambda_functions[$code_hash])) { + switch (true) { + case $gen_hi_opt_code: + // The hi-optimized $lambda_functions will use the key-words hardcoded for better performance. + $w = $this->w; + $dw = $this->dw; + $init_encrypt = ''; + $init_decrypt = ''; + break; + default: + for ($i = 0, $cw = count($this->w); $i < $cw; ++$i) { + $w[] = '$w[' . $i . ']'; + $dw[] = '$dw[' . $i . ']'; + } + $init_encrypt = '$w = $self->w;'; + $init_decrypt = '$dw = $self->dw;'; + } + + $Nr = $this->Nr; + $Nb = $this->Nb; + $c = $this->c; + + // Generating encrypt code: + $init_encrypt.= ' + static $tables; + if (empty($tables)) { + $tables = &$self->_getTables(); + } + $t0 = $tables[0]; + $t1 = $tables[1]; + $t2 = $tables[2]; + $t3 = $tables[3]; + $sbox = $tables[4]; + '; + + $s = 'e'; + $e = 's'; + $wc = $Nb - 1; + + // Preround: addRoundKey + $encrypt_block = '$in = unpack("N*", $in);'."\n"; + for ($i = 0; $i < $Nb; ++$i) { + $encrypt_block .= '$s'.$i.' = $in['.($i + 1).'] ^ '.$w[++$wc].";\n"; + } + + // Mainrounds: shiftRows + subWord + mixColumns + addRoundKey + for ($round = 1; $round < $Nr; ++$round) { + list($s, $e) = array($e, $s); + for ($i = 0; $i < $Nb; ++$i) { + $encrypt_block.= + '$'.$e.$i.' = + $t0[($'.$s.$i .' >> 24) & 0xff] ^ + $t1[($'.$s.(($i + $c[1]) % $Nb).' >> 16) & 0xff] ^ + $t2[($'.$s.(($i + $c[2]) % $Nb).' >> 8) & 0xff] ^ + $t3[ $'.$s.(($i + $c[3]) % $Nb).' & 0xff] ^ + '.$w[++$wc].";\n"; + } + } + + // Finalround: subWord + shiftRows + addRoundKey + for ($i = 0; $i < $Nb; ++$i) { + $encrypt_block.= + '$'.$e.$i.' = + $sbox[ $'.$e.$i.' & 0xff] | + ($sbox[($'.$e.$i.' >> 8) & 0xff] << 8) | + ($sbox[($'.$e.$i.' >> 16) & 0xff] << 16) | + ($sbox[($'.$e.$i.' >> 24) & 0xff] << 24);'."\n"; + } + $encrypt_block .= '$in = pack("N*"'."\n"; + for ($i = 0; $i < $Nb; ++$i) { + $encrypt_block.= ', + ($'.$e.$i .' & '.((int)0xFF000000).') ^ + ($'.$e.(($i + $c[1]) % $Nb).' & 0x00FF0000 ) ^ + ($'.$e.(($i + $c[2]) % $Nb).' & 0x0000FF00 ) ^ + ($'.$e.(($i + $c[3]) % $Nb).' & 0x000000FF ) ^ + '.$w[$i]."\n"; + } + $encrypt_block .= ');'; + + // Generating decrypt code: + $init_decrypt.= ' + static $invtables; + if (empty($invtables)) { + $invtables = &$self->_getInvTables(); + } + $dt0 = $invtables[0]; + $dt1 = $invtables[1]; + $dt2 = $invtables[2]; + $dt3 = $invtables[3]; + $isbox = $invtables[4]; + '; + + $s = 'e'; + $e = 's'; + $wc = $Nb - 1; + + // Preround: addRoundKey + $decrypt_block = '$in = unpack("N*", $in);'."\n"; + for ($i = 0; $i < $Nb; ++$i) { + $decrypt_block .= '$s'.$i.' = $in['.($i + 1).'] ^ '.$dw[++$wc].';'."\n"; + } + + // Mainrounds: shiftRows + subWord + mixColumns + addRoundKey + for ($round = 1; $round < $Nr; ++$round) { + list($s, $e) = array($e, $s); + for ($i = 0; $i < $Nb; ++$i) { + $decrypt_block.= + '$'.$e.$i.' = + $dt0[($'.$s.$i .' >> 24) & 0xff] ^ + $dt1[($'.$s.(($Nb + $i - $c[1]) % $Nb).' >> 16) & 0xff] ^ + $dt2[($'.$s.(($Nb + $i - $c[2]) % $Nb).' >> 8) & 0xff] ^ + $dt3[ $'.$s.(($Nb + $i - $c[3]) % $Nb).' & 0xff] ^ + '.$dw[++$wc].";\n"; + } + } + + // Finalround: subWord + shiftRows + addRoundKey + for ($i = 0; $i < $Nb; ++$i) { + $decrypt_block.= + '$'.$e.$i.' = + $isbox[ $'.$e.$i.' & 0xff] | + ($isbox[($'.$e.$i.' >> 8) & 0xff] << 8) | + ($isbox[($'.$e.$i.' >> 16) & 0xff] << 16) | + ($isbox[($'.$e.$i.' >> 24) & 0xff] << 24);'."\n"; + } + $decrypt_block .= '$in = pack("N*"'."\n"; + for ($i = 0; $i < $Nb; ++$i) { + $decrypt_block.= ', + ($'.$e.$i. ' & '.((int)0xFF000000).') ^ + ($'.$e.(($Nb + $i - $c[1]) % $Nb).' & 0x00FF0000 ) ^ + ($'.$e.(($Nb + $i - $c[2]) % $Nb).' & 0x0000FF00 ) ^ + ($'.$e.(($Nb + $i - $c[3]) % $Nb).' & 0x000000FF ) ^ + '.$dw[$i]."\n"; + } + $decrypt_block .= ');'; + + $lambda_functions[$code_hash] = $this->_createInlineCryptFunction( + array( + 'init_crypt' => '', + 'init_encrypt' => $init_encrypt, + 'init_decrypt' => $init_decrypt, + 'encrypt_block' => $encrypt_block, + 'decrypt_block' => $decrypt_block + ) + ); + } + $this->inline_crypt = $lambda_functions[$code_hash]; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/TripleDES.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/TripleDES.php new file mode 100644 index 0000000..a2c4166 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/TripleDES.php @@ -0,0 +1,460 @@ + + * setKey('abcdefghijklmnopqrstuvwx'); + * + * $size = 10 * 1024; + * $plaintext = ''; + * for ($i = 0; $i < $size; $i++) { + * $plaintext.= 'a'; + * } + * + * echo $des->decrypt($des->encrypt($plaintext)); + * ?> + * + * + * @category Crypt + * @package TripleDES + * @author Jim Wigginton + * @copyright 2007 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP implementation of Triple DES. + * + * @package TripleDES + * @author Jim Wigginton + * @access public + */ +class TripleDES extends DES +{ + /** + * Encrypt / decrypt using inner chaining + * + * Inner chaining is used by SSH-1 and is generally considered to be less secure then outer chaining (self::MODE_CBC3). + */ + const MODE_3CBC = -2; + + /** + * Encrypt / decrypt using outer chaining + * + * Outer chaining is used by SSH-2 and when the mode is set to \phpseclib\Crypt\Base::MODE_CBC. + */ + const MODE_CBC3 = Base::MODE_CBC; + + /** + * Key Length (in bytes) + * + * @see \phpseclib\Crypt\TripleDES::setKeyLength() + * @var int + * @access private + */ + var $key_length = 24; + + /** + * The default salt used by setPassword() + * + * @see \phpseclib\Crypt\Base::password_default_salt + * @see \phpseclib\Crypt\Base::setPassword() + * @var string + * @access private + */ + var $password_default_salt = 'phpseclib'; + + /** + * The mcrypt specific name of the cipher + * + * @see \phpseclib\Crypt\DES::cipher_name_mcrypt + * @see \phpseclib\Crypt\Base::cipher_name_mcrypt + * @var string + * @access private + */ + var $cipher_name_mcrypt = 'tripledes'; + + /** + * Optimizing value while CFB-encrypting + * + * @see \phpseclib\Crypt\Base::cfb_init_len + * @var int + * @access private + */ + var $cfb_init_len = 750; + + /** + * max possible size of $key + * + * @see self::setKey() + * @see \phpseclib\Crypt\DES::setKey() + * @var string + * @access private + */ + var $key_length_max = 24; + + /** + * Internal flag whether using self::MODE_3CBC or not + * + * @var bool + * @access private + */ + var $mode_3cbc; + + /** + * The \phpseclib\Crypt\DES objects + * + * Used only if $mode_3cbc === true + * + * @var array + * @access private + */ + var $des; + + /** + * Default Constructor. + * + * Determines whether or not the mcrypt extension should be used. + * + * $mode could be: + * + * - \phpseclib\Crypt\Base::MODE_ECB + * + * - \phpseclib\Crypt\Base::MODE_CBC + * + * - \phpseclib\Crypt\Base::MODE_CTR + * + * - \phpseclib\Crypt\Base::MODE_CFB + * + * - \phpseclib\Crypt\Base::MODE_OFB + * + * - \phpseclib\Crypt\TripleDES::MODE_3CBC + * + * If not explicitly set, \phpseclib\Crypt\Base::MODE_CBC will be used. + * + * @see \phpseclib\Crypt\DES::__construct() + * @see \phpseclib\Crypt\Base::__construct() + * @param int $mode + * @access public + */ + function __construct($mode = Base::MODE_CBC) + { + switch ($mode) { + // In case of self::MODE_3CBC, we init as CRYPT_DES_MODE_CBC + // and additional flag us internally as 3CBC + case self::MODE_3CBC: + parent::__construct(Base::MODE_CBC); + $this->mode_3cbc = true; + + // This three $des'es will do the 3CBC work (if $key > 64bits) + $this->des = array( + new DES(Base::MODE_CBC), + new DES(Base::MODE_CBC), + new DES(Base::MODE_CBC), + ); + + // we're going to be doing the padding, ourselves, so disable it in the \phpseclib\Crypt\DES objects + $this->des[0]->disablePadding(); + $this->des[1]->disablePadding(); + $this->des[2]->disablePadding(); + break; + // If not 3CBC, we init as usual + default: + parent::__construct($mode); + } + } + + /** + * Test for engine validity + * + * This is mainly just a wrapper to set things up for \phpseclib\Crypt\Base::isValidEngine() + * + * @see \phpseclib\Crypt\Base::__construct() + * @param int $engine + * @access public + * @return bool + */ + function isValidEngine($engine) + { + if ($engine == self::ENGINE_OPENSSL) { + $this->cipher_name_openssl_ecb = 'des-ede3'; + $mode = $this->_openssl_translate_mode(); + $this->cipher_name_openssl = $mode == 'ecb' ? 'des-ede3' : 'des-ede3-' . $mode; + } + + return parent::isValidEngine($engine); + } + + /** + * Sets the initialization vector. (optional) + * + * SetIV is not required when \phpseclib\Crypt\Base::MODE_ECB is being used. If not explicitly set, it'll be assumed + * to be all zero's. + * + * @see \phpseclib\Crypt\Base::setIV() + * @access public + * @param string $iv + */ + function setIV($iv) + { + parent::setIV($iv); + if ($this->mode_3cbc) { + $this->des[0]->setIV($iv); + $this->des[1]->setIV($iv); + $this->des[2]->setIV($iv); + } + } + + /** + * Sets the key length. + * + * Valid key lengths are 64, 128 and 192 + * + * @see \phpseclib\Crypt\Base:setKeyLength() + * @access public + * @param int $length + */ + function setKeyLength($length) + { + $length >>= 3; + switch (true) { + case $length <= 8: + $this->key_length = 8; + break; + case $length <= 16: + $this->key_length = 16; + break; + default: + $this->key_length = 24; + } + + parent::setKeyLength($length); + } + + /** + * Sets the key. + * + * Keys can be of any length. Triple DES, itself, can use 128-bit (eg. strlen($key) == 16) or + * 192-bit (eg. strlen($key) == 24) keys. This function pads and truncates $key as appropriate. + * + * DES also requires that every eighth bit be a parity bit, however, we'll ignore that. + * + * If the key is not explicitly set, it'll be assumed to be all null bytes. + * + * @access public + * @see \phpseclib\Crypt\DES::setKey() + * @see \phpseclib\Crypt\Base::setKey() + * @param string $key + */ + function setKey($key) + { + $length = $this->explicit_key_length ? $this->key_length : strlen($key); + if ($length > 8) { + $key = str_pad(substr($key, 0, 24), 24, chr(0)); + // if $key is between 64 and 128-bits, use the first 64-bits as the last, per this: + // http://php.net/function.mcrypt-encrypt#47973 + $key = $length <= 16 ? substr_replace($key, substr($key, 0, 8), 16) : substr($key, 0, 24); + } else { + $key = str_pad($key, 8, chr(0)); + } + parent::setKey($key); + + // And in case of self::MODE_3CBC: + // if key <= 64bits we not need the 3 $des to work, + // because we will then act as regular DES-CBC with just a <= 64bit key. + // So only if the key > 64bits (> 8 bytes) we will call setKey() for the 3 $des. + if ($this->mode_3cbc && $length > 8) { + $this->des[0]->setKey(substr($key, 0, 8)); + $this->des[1]->setKey(substr($key, 8, 8)); + $this->des[2]->setKey(substr($key, 16, 8)); + } + } + + /** + * Encrypts a message. + * + * @see \phpseclib\Crypt\Base::encrypt() + * @access public + * @param string $plaintext + * @return string $cipertext + */ + function encrypt($plaintext) + { + // parent::en/decrypt() is able to do all the work for all modes and keylengths, + // except for: self::MODE_3CBC (inner chaining CBC) with a key > 64bits + + // if the key is smaller then 8, do what we'd normally do + if ($this->mode_3cbc && strlen($this->key) > 8) { + return $this->des[2]->encrypt( + $this->des[1]->decrypt( + $this->des[0]->encrypt( + $this->_pad($plaintext) + ) + ) + ); + } + + return parent::encrypt($plaintext); + } + + /** + * Decrypts a message. + * + * @see \phpseclib\Crypt\Base::decrypt() + * @access public + * @param string $ciphertext + * @return string $plaintext + */ + function decrypt($ciphertext) + { + if ($this->mode_3cbc && strlen($this->key) > 8) { + return $this->_unpad( + $this->des[0]->decrypt( + $this->des[1]->encrypt( + $this->des[2]->decrypt( + str_pad($ciphertext, (strlen($ciphertext) + 7) & 0xFFFFFFF8, "\0") + ) + ) + ) + ); + } + + return parent::decrypt($ciphertext); + } + + /** + * Treat consecutive "packets" as if they are a continuous buffer. + * + * Say you have a 16-byte plaintext $plaintext. Using the default behavior, the two following code snippets + * will yield different outputs: + * + * + * echo $des->encrypt(substr($plaintext, 0, 8)); + * echo $des->encrypt(substr($plaintext, 8, 8)); + * + * + * echo $des->encrypt($plaintext); + * + * + * The solution is to enable the continuous buffer. Although this will resolve the above discrepancy, it creates + * another, as demonstrated with the following: + * + * + * $des->encrypt(substr($plaintext, 0, 8)); + * echo $des->decrypt($des->encrypt(substr($plaintext, 8, 8))); + * + * + * echo $des->decrypt($des->encrypt(substr($plaintext, 8, 8))); + * + * + * With the continuous buffer disabled, these would yield the same output. With it enabled, they yield different + * outputs. The reason is due to the fact that the initialization vector's change after every encryption / + * decryption round when the continuous buffer is enabled. When it's disabled, they remain constant. + * + * Put another way, when the continuous buffer is enabled, the state of the \phpseclib\Crypt\DES() object changes after each + * encryption / decryption round, whereas otherwise, it'd remain constant. For this reason, it's recommended that + * continuous buffers not be used. They do offer better security and are, in fact, sometimes required (SSH uses them), + * however, they are also less intuitive and more likely to cause you problems. + * + * @see \phpseclib\Crypt\Base::enableContinuousBuffer() + * @see self::disableContinuousBuffer() + * @access public + */ + function enableContinuousBuffer() + { + parent::enableContinuousBuffer(); + if ($this->mode_3cbc) { + $this->des[0]->enableContinuousBuffer(); + $this->des[1]->enableContinuousBuffer(); + $this->des[2]->enableContinuousBuffer(); + } + } + + /** + * Treat consecutive packets as if they are a discontinuous buffer. + * + * The default behavior. + * + * @see \phpseclib\Crypt\Base::disableContinuousBuffer() + * @see self::enableContinuousBuffer() + * @access public + */ + function disableContinuousBuffer() + { + parent::disableContinuousBuffer(); + if ($this->mode_3cbc) { + $this->des[0]->disableContinuousBuffer(); + $this->des[1]->disableContinuousBuffer(); + $this->des[2]->disableContinuousBuffer(); + } + } + + /** + * Creates the key schedule + * + * @see \phpseclib\Crypt\DES::_setupKey() + * @see \phpseclib\Crypt\Base::_setupKey() + * @access private + */ + function _setupKey() + { + switch (true) { + // if $key <= 64bits we configure our internal pure-php cipher engine + // to act as regular [1]DES, not as 3DES. mcrypt.so::tripledes does the same. + case strlen($this->key) <= 8: + $this->des_rounds = 1; + break; + + // otherwise, if $key > 64bits, we configure our engine to work as 3DES. + default: + $this->des_rounds = 3; + + // (only) if 3CBC is used we have, of course, to setup the $des[0-2] keys also separately. + if ($this->mode_3cbc) { + $this->des[0]->_setupKey(); + $this->des[1]->_setupKey(); + $this->des[2]->_setupKey(); + + // because $des[0-2] will, now, do all the work we can return here + // not need unnecessary stress parent::_setupKey() with our, now unused, $key. + return; + } + } + // setup our key + parent::_setupKey(); + } + + /** + * Sets the internal crypt engine + * + * @see \phpseclib\Crypt\Base::__construct() + * @see \phpseclib\Crypt\Base::setPreferredEngine() + * @param int $engine + * @access public + * @return int + */ + function setPreferredEngine($engine) + { + if ($this->mode_3cbc) { + $this->des[0]->setPreferredEngine($engine); + $this->des[1]->setPreferredEngine($engine); + $this->des[2]->setPreferredEngine($engine); + } + + return parent::setPreferredEngine($engine); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Twofish.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Twofish.php new file mode 100644 index 0000000..70980a2 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Crypt/Twofish.php @@ -0,0 +1,816 @@ + + * setKey('12345678901234567890123456789012'); + * + * $plaintext = str_repeat('a', 1024); + * + * echo $twofish->decrypt($twofish->encrypt($plaintext)); + * ?> + * + * + * @category Crypt + * @package Twofish + * @author Jim Wigginton + * @author Hans-Juergen Petrich + * @copyright 2007 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://phpseclib.sourceforge.net + */ + +namespace phpseclib\Crypt; + +/** + * Pure-PHP implementation of Twofish. + * + * @package Twofish + * @author Jim Wigginton + * @author Hans-Juergen Petrich + * @access public + */ +class Twofish extends Base +{ + /** + * The mcrypt specific name of the cipher + * + * @see \phpseclib\Crypt\Base::cipher_name_mcrypt + * @var string + * @access private + */ + var $cipher_name_mcrypt = 'twofish'; + + /** + * Optimizing value while CFB-encrypting + * + * @see \phpseclib\Crypt\Base::cfb_init_len + * @var int + * @access private + */ + var $cfb_init_len = 800; + + /** + * Q-Table + * + * @var array + * @access private + */ + var $q0 = array( + 0xA9, 0x67, 0xB3, 0xE8, 0x04, 0xFD, 0xA3, 0x76, + 0x9A, 0x92, 0x80, 0x78, 0xE4, 0xDD, 0xD1, 0x38, + 0x0D, 0xC6, 0x35, 0x98, 0x18, 0xF7, 0xEC, 0x6C, + 0x43, 0x75, 0x37, 0x26, 0xFA, 0x13, 0x94, 0x48, + 0xF2, 0xD0, 0x8B, 0x30, 0x84, 0x54, 0xDF, 0x23, + 0x19, 0x5B, 0x3D, 0x59, 0xF3, 0xAE, 0xA2, 0x82, + 0x63, 0x01, 0x83, 0x2E, 0xD9, 0x51, 0x9B, 0x7C, + 0xA6, 0xEB, 0xA5, 0xBE, 0x16, 0x0C, 0xE3, 0x61, + 0xC0, 0x8C, 0x3A, 0xF5, 0x73, 0x2C, 0x25, 0x0B, + 0xBB, 0x4E, 0x89, 0x6B, 0x53, 0x6A, 0xB4, 0xF1, + 0xE1, 0xE6, 0xBD, 0x45, 0xE2, 0xF4, 0xB6, 0x66, + 0xCC, 0x95, 0x03, 0x56, 0xD4, 0x1C, 0x1E, 0xD7, + 0xFB, 0xC3, 0x8E, 0xB5, 0xE9, 0xCF, 0xBF, 0xBA, + 0xEA, 0x77, 0x39, 0xAF, 0x33, 0xC9, 0x62, 0x71, + 0x81, 0x79, 0x09, 0xAD, 0x24, 0xCD, 0xF9, 0xD8, + 0xE5, 0xC5, 0xB9, 0x4D, 0x44, 0x08, 0x86, 0xE7, + 0xA1, 0x1D, 0xAA, 0xED, 0x06, 0x70, 0xB2, 0xD2, + 0x41, 0x7B, 0xA0, 0x11, 0x31, 0xC2, 0x27, 0x90, + 0x20, 0xF6, 0x60, 0xFF, 0x96, 0x5C, 0xB1, 0xAB, + 0x9E, 0x9C, 0x52, 0x1B, 0x5F, 0x93, 0x0A, 0xEF, + 0x91, 0x85, 0x49, 0xEE, 0x2D, 0x4F, 0x8F, 0x3B, + 0x47, 0x87, 0x6D, 0x46, 0xD6, 0x3E, 0x69, 0x64, + 0x2A, 0xCE, 0xCB, 0x2F, 0xFC, 0x97, 0x05, 0x7A, + 0xAC, 0x7F, 0xD5, 0x1A, 0x4B, 0x0E, 0xA7, 0x5A, + 0x28, 0x14, 0x3F, 0x29, 0x88, 0x3C, 0x4C, 0x02, + 0xB8, 0xDA, 0xB0, 0x17, 0x55, 0x1F, 0x8A, 0x7D, + 0x57, 0xC7, 0x8D, 0x74, 0xB7, 0xC4, 0x9F, 0x72, + 0x7E, 0x15, 0x22, 0x12, 0x58, 0x07, 0x99, 0x34, + 0x6E, 0x50, 0xDE, 0x68, 0x65, 0xBC, 0xDB, 0xF8, + 0xC8, 0xA8, 0x2B, 0x40, 0xDC, 0xFE, 0x32, 0xA4, + 0xCA, 0x10, 0x21, 0xF0, 0xD3, 0x5D, 0x0F, 0x00, + 0x6F, 0x9D, 0x36, 0x42, 0x4A, 0x5E, 0xC1, 0xE0 + ); + + /** + * Q-Table + * + * @var array + * @access private + */ + var $q1 = array( + 0x75, 0xF3, 0xC6, 0xF4, 0xDB, 0x7B, 0xFB, 0xC8, + 0x4A, 0xD3, 0xE6, 0x6B, 0x45, 0x7D, 0xE8, 0x4B, + 0xD6, 0x32, 0xD8, 0xFD, 0x37, 0x71, 0xF1, 0xE1, + 0x30, 0x0F, 0xF8, 0x1B, 0x87, 0xFA, 0x06, 0x3F, + 0x5E, 0xBA, 0xAE, 0x5B, 0x8A, 0x00, 0xBC, 0x9D, + 0x6D, 0xC1, 0xB1, 0x0E, 0x80, 0x5D, 0xD2, 0xD5, + 0xA0, 0x84, 0x07, 0x14, 0xB5, 0x90, 0x2C, 0xA3, + 0xB2, 0x73, 0x4C, 0x54, 0x92, 0x74, 0x36, 0x51, + 0x38, 0xB0, 0xBD, 0x5A, 0xFC, 0x60, 0x62, 0x96, + 0x6C, 0x42, 0xF7, 0x10, 0x7C, 0x28, 0x27, 0x8C, + 0x13, 0x95, 0x9C, 0xC7, 0x24, 0x46, 0x3B, 0x70, + 0xCA, 0xE3, 0x85, 0xCB, 0x11, 0xD0, 0x93, 0xB8, + 0xA6, 0x83, 0x20, 0xFF, 0x9F, 0x77, 0xC3, 0xCC, + 0x03, 0x6F, 0x08, 0xBF, 0x40, 0xE7, 0x2B, 0xE2, + 0x79, 0x0C, 0xAA, 0x82, 0x41, 0x3A, 0xEA, 0xB9, + 0xE4, 0x9A, 0xA4, 0x97, 0x7E, 0xDA, 0x7A, 0x17, + 0x66, 0x94, 0xA1, 0x1D, 0x3D, 0xF0, 0xDE, 0xB3, + 0x0B, 0x72, 0xA7, 0x1C, 0xEF, 0xD1, 0x53, 0x3E, + 0x8F, 0x33, 0x26, 0x5F, 0xEC, 0x76, 0x2A, 0x49, + 0x81, 0x88, 0xEE, 0x21, 0xC4, 0x1A, 0xEB, 0xD9, + 0xC5, 0x39, 0x99, 0xCD, 0xAD, 0x31, 0x8B, 0x01, + 0x18, 0x23, 0xDD, 0x1F, 0x4E, 0x2D, 0xF9, 0x48, + 0x4F, 0xF2, 0x65, 0x8E, 0x78, 0x5C, 0x58, 0x19, + 0x8D, 0xE5, 0x98, 0x57, 0x67, 0x7F, 0x05, 0x64, + 0xAF, 0x63, 0xB6, 0xFE, 0xF5, 0xB7, 0x3C, 0xA5, + 0xCE, 0xE9, 0x68, 0x44, 0xE0, 0x4D, 0x43, 0x69, + 0x29, 0x2E, 0xAC, 0x15, 0x59, 0xA8, 0x0A, 0x9E, + 0x6E, 0x47, 0xDF, 0x34, 0x35, 0x6A, 0xCF, 0xDC, + 0x22, 0xC9, 0xC0, 0x9B, 0x89, 0xD4, 0xED, 0xAB, + 0x12, 0xA2, 0x0D, 0x52, 0xBB, 0x02, 0x2F, 0xA9, + 0xD7, 0x61, 0x1E, 0xB4, 0x50, 0x04, 0xF6, 0xC2, + 0x16, 0x25, 0x86, 0x56, 0x55, 0x09, 0xBE, 0x91 + ); + + /** + * M-Table + * + * @var array + * @access private + */ + var $m0 = array( + 0xBCBC3275, 0xECEC21F3, 0x202043C6, 0xB3B3C9F4, 0xDADA03DB, 0x02028B7B, 0xE2E22BFB, 0x9E9EFAC8, + 0xC9C9EC4A, 0xD4D409D3, 0x18186BE6, 0x1E1E9F6B, 0x98980E45, 0xB2B2387D, 0xA6A6D2E8, 0x2626B74B, + 0x3C3C57D6, 0x93938A32, 0x8282EED8, 0x525298FD, 0x7B7BD437, 0xBBBB3771, 0x5B5B97F1, 0x474783E1, + 0x24243C30, 0x5151E20F, 0xBABAC6F8, 0x4A4AF31B, 0xBFBF4887, 0x0D0D70FA, 0xB0B0B306, 0x7575DE3F, + 0xD2D2FD5E, 0x7D7D20BA, 0x666631AE, 0x3A3AA35B, 0x59591C8A, 0x00000000, 0xCDCD93BC, 0x1A1AE09D, + 0xAEAE2C6D, 0x7F7FABC1, 0x2B2BC7B1, 0xBEBEB90E, 0xE0E0A080, 0x8A8A105D, 0x3B3B52D2, 0x6464BAD5, + 0xD8D888A0, 0xE7E7A584, 0x5F5FE807, 0x1B1B1114, 0x2C2CC2B5, 0xFCFCB490, 0x3131272C, 0x808065A3, + 0x73732AB2, 0x0C0C8173, 0x79795F4C, 0x6B6B4154, 0x4B4B0292, 0x53536974, 0x94948F36, 0x83831F51, + 0x2A2A3638, 0xC4C49CB0, 0x2222C8BD, 0xD5D5F85A, 0xBDBDC3FC, 0x48487860, 0xFFFFCE62, 0x4C4C0796, + 0x4141776C, 0xC7C7E642, 0xEBEB24F7, 0x1C1C1410, 0x5D5D637C, 0x36362228, 0x6767C027, 0xE9E9AF8C, + 0x4444F913, 0x1414EA95, 0xF5F5BB9C, 0xCFCF18C7, 0x3F3F2D24, 0xC0C0E346, 0x7272DB3B, 0x54546C70, + 0x29294CCA, 0xF0F035E3, 0x0808FE85, 0xC6C617CB, 0xF3F34F11, 0x8C8CE4D0, 0xA4A45993, 0xCACA96B8, + 0x68683BA6, 0xB8B84D83, 0x38382820, 0xE5E52EFF, 0xADAD569F, 0x0B0B8477, 0xC8C81DC3, 0x9999FFCC, + 0x5858ED03, 0x19199A6F, 0x0E0E0A08, 0x95957EBF, 0x70705040, 0xF7F730E7, 0x6E6ECF2B, 0x1F1F6EE2, + 0xB5B53D79, 0x09090F0C, 0x616134AA, 0x57571682, 0x9F9F0B41, 0x9D9D803A, 0x111164EA, 0x2525CDB9, + 0xAFAFDDE4, 0x4545089A, 0xDFDF8DA4, 0xA3A35C97, 0xEAEAD57E, 0x353558DA, 0xEDEDD07A, 0x4343FC17, + 0xF8F8CB66, 0xFBFBB194, 0x3737D3A1, 0xFAFA401D, 0xC2C2683D, 0xB4B4CCF0, 0x32325DDE, 0x9C9C71B3, + 0x5656E70B, 0xE3E3DA72, 0x878760A7, 0x15151B1C, 0xF9F93AEF, 0x6363BFD1, 0x3434A953, 0x9A9A853E, + 0xB1B1428F, 0x7C7CD133, 0x88889B26, 0x3D3DA65F, 0xA1A1D7EC, 0xE4E4DF76, 0x8181942A, 0x91910149, + 0x0F0FFB81, 0xEEEEAA88, 0x161661EE, 0xD7D77321, 0x9797F5C4, 0xA5A5A81A, 0xFEFE3FEB, 0x6D6DB5D9, + 0x7878AEC5, 0xC5C56D39, 0x1D1DE599, 0x7676A4CD, 0x3E3EDCAD, 0xCBCB6731, 0xB6B6478B, 0xEFEF5B01, + 0x12121E18, 0x6060C523, 0x6A6AB0DD, 0x4D4DF61F, 0xCECEE94E, 0xDEDE7C2D, 0x55559DF9, 0x7E7E5A48, + 0x2121B24F, 0x03037AF2, 0xA0A02665, 0x5E5E198E, 0x5A5A6678, 0x65654B5C, 0x62624E58, 0xFDFD4519, + 0x0606F48D, 0x404086E5, 0xF2F2BE98, 0x3333AC57, 0x17179067, 0x05058E7F, 0xE8E85E05, 0x4F4F7D64, + 0x89896AAF, 0x10109563, 0x74742FB6, 0x0A0A75FE, 0x5C5C92F5, 0x9B9B74B7, 0x2D2D333C, 0x3030D6A5, + 0x2E2E49CE, 0x494989E9, 0x46467268, 0x77775544, 0xA8A8D8E0, 0x9696044D, 0x2828BD43, 0xA9A92969, + 0xD9D97929, 0x8686912E, 0xD1D187AC, 0xF4F44A15, 0x8D8D1559, 0xD6D682A8, 0xB9B9BC0A, 0x42420D9E, + 0xF6F6C16E, 0x2F2FB847, 0xDDDD06DF, 0x23233934, 0xCCCC6235, 0xF1F1C46A, 0xC1C112CF, 0x8585EBDC, + 0x8F8F9E22, 0x7171A1C9, 0x9090F0C0, 0xAAAA539B, 0x0101F189, 0x8B8BE1D4, 0x4E4E8CED, 0x8E8E6FAB, + 0xABABA212, 0x6F6F3EA2, 0xE6E6540D, 0xDBDBF252, 0x92927BBB, 0xB7B7B602, 0x6969CA2F, 0x3939D9A9, + 0xD3D30CD7, 0xA7A72361, 0xA2A2AD1E, 0xC3C399B4, 0x6C6C4450, 0x07070504, 0x04047FF6, 0x272746C2, + 0xACACA716, 0xD0D07625, 0x50501386, 0xDCDCF756, 0x84841A55, 0xE1E15109, 0x7A7A25BE, 0x1313EF91 + ); + + /** + * M-Table + * + * @var array + * @access private + */ + var $m1 = array( + 0xA9D93939, 0x67901717, 0xB3719C9C, 0xE8D2A6A6, 0x04050707, 0xFD985252, 0xA3658080, 0x76DFE4E4, + 0x9A084545, 0x92024B4B, 0x80A0E0E0, 0x78665A5A, 0xE4DDAFAF, 0xDDB06A6A, 0xD1BF6363, 0x38362A2A, + 0x0D54E6E6, 0xC6432020, 0x3562CCCC, 0x98BEF2F2, 0x181E1212, 0xF724EBEB, 0xECD7A1A1, 0x6C774141, + 0x43BD2828, 0x7532BCBC, 0x37D47B7B, 0x269B8888, 0xFA700D0D, 0x13F94444, 0x94B1FBFB, 0x485A7E7E, + 0xF27A0303, 0xD0E48C8C, 0x8B47B6B6, 0x303C2424, 0x84A5E7E7, 0x54416B6B, 0xDF06DDDD, 0x23C56060, + 0x1945FDFD, 0x5BA33A3A, 0x3D68C2C2, 0x59158D8D, 0xF321ECEC, 0xAE316666, 0xA23E6F6F, 0x82165757, + 0x63951010, 0x015BEFEF, 0x834DB8B8, 0x2E918686, 0xD9B56D6D, 0x511F8383, 0x9B53AAAA, 0x7C635D5D, + 0xA63B6868, 0xEB3FFEFE, 0xA5D63030, 0xBE257A7A, 0x16A7ACAC, 0x0C0F0909, 0xE335F0F0, 0x6123A7A7, + 0xC0F09090, 0x8CAFE9E9, 0x3A809D9D, 0xF5925C5C, 0x73810C0C, 0x2C273131, 0x2576D0D0, 0x0BE75656, + 0xBB7B9292, 0x4EE9CECE, 0x89F10101, 0x6B9F1E1E, 0x53A93434, 0x6AC4F1F1, 0xB499C3C3, 0xF1975B5B, + 0xE1834747, 0xE66B1818, 0xBDC82222, 0x450E9898, 0xE26E1F1F, 0xF4C9B3B3, 0xB62F7474, 0x66CBF8F8, + 0xCCFF9999, 0x95EA1414, 0x03ED5858, 0x56F7DCDC, 0xD4E18B8B, 0x1C1B1515, 0x1EADA2A2, 0xD70CD3D3, + 0xFB2BE2E2, 0xC31DC8C8, 0x8E195E5E, 0xB5C22C2C, 0xE9894949, 0xCF12C1C1, 0xBF7E9595, 0xBA207D7D, + 0xEA641111, 0x77840B0B, 0x396DC5C5, 0xAF6A8989, 0x33D17C7C, 0xC9A17171, 0x62CEFFFF, 0x7137BBBB, + 0x81FB0F0F, 0x793DB5B5, 0x0951E1E1, 0xADDC3E3E, 0x242D3F3F, 0xCDA47676, 0xF99D5555, 0xD8EE8282, + 0xE5864040, 0xC5AE7878, 0xB9CD2525, 0x4D049696, 0x44557777, 0x080A0E0E, 0x86135050, 0xE730F7F7, + 0xA1D33737, 0x1D40FAFA, 0xAA346161, 0xED8C4E4E, 0x06B3B0B0, 0x706C5454, 0xB22A7373, 0xD2523B3B, + 0x410B9F9F, 0x7B8B0202, 0xA088D8D8, 0x114FF3F3, 0x3167CBCB, 0xC2462727, 0x27C06767, 0x90B4FCFC, + 0x20283838, 0xF67F0404, 0x60784848, 0xFF2EE5E5, 0x96074C4C, 0x5C4B6565, 0xB1C72B2B, 0xAB6F8E8E, + 0x9E0D4242, 0x9CBBF5F5, 0x52F2DBDB, 0x1BF34A4A, 0x5FA63D3D, 0x9359A4A4, 0x0ABCB9B9, 0xEF3AF9F9, + 0x91EF1313, 0x85FE0808, 0x49019191, 0xEE611616, 0x2D7CDEDE, 0x4FB22121, 0x8F42B1B1, 0x3BDB7272, + 0x47B82F2F, 0x8748BFBF, 0x6D2CAEAE, 0x46E3C0C0, 0xD6573C3C, 0x3E859A9A, 0x6929A9A9, 0x647D4F4F, + 0x2A948181, 0xCE492E2E, 0xCB17C6C6, 0x2FCA6969, 0xFCC3BDBD, 0x975CA3A3, 0x055EE8E8, 0x7AD0EDED, + 0xAC87D1D1, 0x7F8E0505, 0xD5BA6464, 0x1AA8A5A5, 0x4BB72626, 0x0EB9BEBE, 0xA7608787, 0x5AF8D5D5, + 0x28223636, 0x14111B1B, 0x3FDE7575, 0x2979D9D9, 0x88AAEEEE, 0x3C332D2D, 0x4C5F7979, 0x02B6B7B7, + 0xB896CACA, 0xDA583535, 0xB09CC4C4, 0x17FC4343, 0x551A8484, 0x1FF64D4D, 0x8A1C5959, 0x7D38B2B2, + 0x57AC3333, 0xC718CFCF, 0x8DF40606, 0x74695353, 0xB7749B9B, 0xC4F59797, 0x9F56ADAD, 0x72DAE3E3, + 0x7ED5EAEA, 0x154AF4F4, 0x229E8F8F, 0x12A2ABAB, 0x584E6262, 0x07E85F5F, 0x99E51D1D, 0x34392323, + 0x6EC1F6F6, 0x50446C6C, 0xDE5D3232, 0x68724646, 0x6526A0A0, 0xBC93CDCD, 0xDB03DADA, 0xF8C6BABA, + 0xC8FA9E9E, 0xA882D6D6, 0x2BCF6E6E, 0x40507070, 0xDCEB8585, 0xFE750A0A, 0x328A9393, 0xA48DDFDF, + 0xCA4C2929, 0x10141C1C, 0x2173D7D7, 0xF0CCB4B4, 0xD309D4D4, 0x5D108A8A, 0x0FE25151, 0x00000000, + 0x6F9A1919, 0x9DE01A1A, 0x368F9494, 0x42E6C7C7, 0x4AECC9C9, 0x5EFDD2D2, 0xC1AB7F7F, 0xE0D8A8A8 + ); + + /** + * M-Table + * + * @var array + * @access private + */ + var $m2 = array( + 0xBC75BC32, 0xECF3EC21, 0x20C62043, 0xB3F4B3C9, 0xDADBDA03, 0x027B028B, 0xE2FBE22B, 0x9EC89EFA, + 0xC94AC9EC, 0xD4D3D409, 0x18E6186B, 0x1E6B1E9F, 0x9845980E, 0xB27DB238, 0xA6E8A6D2, 0x264B26B7, + 0x3CD63C57, 0x9332938A, 0x82D882EE, 0x52FD5298, 0x7B377BD4, 0xBB71BB37, 0x5BF15B97, 0x47E14783, + 0x2430243C, 0x510F51E2, 0xBAF8BAC6, 0x4A1B4AF3, 0xBF87BF48, 0x0DFA0D70, 0xB006B0B3, 0x753F75DE, + 0xD25ED2FD, 0x7DBA7D20, 0x66AE6631, 0x3A5B3AA3, 0x598A591C, 0x00000000, 0xCDBCCD93, 0x1A9D1AE0, + 0xAE6DAE2C, 0x7FC17FAB, 0x2BB12BC7, 0xBE0EBEB9, 0xE080E0A0, 0x8A5D8A10, 0x3BD23B52, 0x64D564BA, + 0xD8A0D888, 0xE784E7A5, 0x5F075FE8, 0x1B141B11, 0x2CB52CC2, 0xFC90FCB4, 0x312C3127, 0x80A38065, + 0x73B2732A, 0x0C730C81, 0x794C795F, 0x6B546B41, 0x4B924B02, 0x53745369, 0x9436948F, 0x8351831F, + 0x2A382A36, 0xC4B0C49C, 0x22BD22C8, 0xD55AD5F8, 0xBDFCBDC3, 0x48604878, 0xFF62FFCE, 0x4C964C07, + 0x416C4177, 0xC742C7E6, 0xEBF7EB24, 0x1C101C14, 0x5D7C5D63, 0x36283622, 0x672767C0, 0xE98CE9AF, + 0x441344F9, 0x149514EA, 0xF59CF5BB, 0xCFC7CF18, 0x3F243F2D, 0xC046C0E3, 0x723B72DB, 0x5470546C, + 0x29CA294C, 0xF0E3F035, 0x088508FE, 0xC6CBC617, 0xF311F34F, 0x8CD08CE4, 0xA493A459, 0xCAB8CA96, + 0x68A6683B, 0xB883B84D, 0x38203828, 0xE5FFE52E, 0xAD9FAD56, 0x0B770B84, 0xC8C3C81D, 0x99CC99FF, + 0x580358ED, 0x196F199A, 0x0E080E0A, 0x95BF957E, 0x70407050, 0xF7E7F730, 0x6E2B6ECF, 0x1FE21F6E, + 0xB579B53D, 0x090C090F, 0x61AA6134, 0x57825716, 0x9F419F0B, 0x9D3A9D80, 0x11EA1164, 0x25B925CD, + 0xAFE4AFDD, 0x459A4508, 0xDFA4DF8D, 0xA397A35C, 0xEA7EEAD5, 0x35DA3558, 0xED7AEDD0, 0x431743FC, + 0xF866F8CB, 0xFB94FBB1, 0x37A137D3, 0xFA1DFA40, 0xC23DC268, 0xB4F0B4CC, 0x32DE325D, 0x9CB39C71, + 0x560B56E7, 0xE372E3DA, 0x87A78760, 0x151C151B, 0xF9EFF93A, 0x63D163BF, 0x345334A9, 0x9A3E9A85, + 0xB18FB142, 0x7C337CD1, 0x8826889B, 0x3D5F3DA6, 0xA1ECA1D7, 0xE476E4DF, 0x812A8194, 0x91499101, + 0x0F810FFB, 0xEE88EEAA, 0x16EE1661, 0xD721D773, 0x97C497F5, 0xA51AA5A8, 0xFEEBFE3F, 0x6DD96DB5, + 0x78C578AE, 0xC539C56D, 0x1D991DE5, 0x76CD76A4, 0x3EAD3EDC, 0xCB31CB67, 0xB68BB647, 0xEF01EF5B, + 0x1218121E, 0x602360C5, 0x6ADD6AB0, 0x4D1F4DF6, 0xCE4ECEE9, 0xDE2DDE7C, 0x55F9559D, 0x7E487E5A, + 0x214F21B2, 0x03F2037A, 0xA065A026, 0x5E8E5E19, 0x5A785A66, 0x655C654B, 0x6258624E, 0xFD19FD45, + 0x068D06F4, 0x40E54086, 0xF298F2BE, 0x335733AC, 0x17671790, 0x057F058E, 0xE805E85E, 0x4F644F7D, + 0x89AF896A, 0x10631095, 0x74B6742F, 0x0AFE0A75, 0x5CF55C92, 0x9BB79B74, 0x2D3C2D33, 0x30A530D6, + 0x2ECE2E49, 0x49E94989, 0x46684672, 0x77447755, 0xA8E0A8D8, 0x964D9604, 0x284328BD, 0xA969A929, + 0xD929D979, 0x862E8691, 0xD1ACD187, 0xF415F44A, 0x8D598D15, 0xD6A8D682, 0xB90AB9BC, 0x429E420D, + 0xF66EF6C1, 0x2F472FB8, 0xDDDFDD06, 0x23342339, 0xCC35CC62, 0xF16AF1C4, 0xC1CFC112, 0x85DC85EB, + 0x8F228F9E, 0x71C971A1, 0x90C090F0, 0xAA9BAA53, 0x018901F1, 0x8BD48BE1, 0x4EED4E8C, 0x8EAB8E6F, + 0xAB12ABA2, 0x6FA26F3E, 0xE60DE654, 0xDB52DBF2, 0x92BB927B, 0xB702B7B6, 0x692F69CA, 0x39A939D9, + 0xD3D7D30C, 0xA761A723, 0xA21EA2AD, 0xC3B4C399, 0x6C506C44, 0x07040705, 0x04F6047F, 0x27C22746, + 0xAC16ACA7, 0xD025D076, 0x50865013, 0xDC56DCF7, 0x8455841A, 0xE109E151, 0x7ABE7A25, 0x139113EF + ); + + /** + * M-Table + * + * @var array + * @access private + */ + var $m3 = array( + 0xD939A9D9, 0x90176790, 0x719CB371, 0xD2A6E8D2, 0x05070405, 0x9852FD98, 0x6580A365, 0xDFE476DF, + 0x08459A08, 0x024B9202, 0xA0E080A0, 0x665A7866, 0xDDAFE4DD, 0xB06ADDB0, 0xBF63D1BF, 0x362A3836, + 0x54E60D54, 0x4320C643, 0x62CC3562, 0xBEF298BE, 0x1E12181E, 0x24EBF724, 0xD7A1ECD7, 0x77416C77, + 0xBD2843BD, 0x32BC7532, 0xD47B37D4, 0x9B88269B, 0x700DFA70, 0xF94413F9, 0xB1FB94B1, 0x5A7E485A, + 0x7A03F27A, 0xE48CD0E4, 0x47B68B47, 0x3C24303C, 0xA5E784A5, 0x416B5441, 0x06DDDF06, 0xC56023C5, + 0x45FD1945, 0xA33A5BA3, 0x68C23D68, 0x158D5915, 0x21ECF321, 0x3166AE31, 0x3E6FA23E, 0x16578216, + 0x95106395, 0x5BEF015B, 0x4DB8834D, 0x91862E91, 0xB56DD9B5, 0x1F83511F, 0x53AA9B53, 0x635D7C63, + 0x3B68A63B, 0x3FFEEB3F, 0xD630A5D6, 0x257ABE25, 0xA7AC16A7, 0x0F090C0F, 0x35F0E335, 0x23A76123, + 0xF090C0F0, 0xAFE98CAF, 0x809D3A80, 0x925CF592, 0x810C7381, 0x27312C27, 0x76D02576, 0xE7560BE7, + 0x7B92BB7B, 0xE9CE4EE9, 0xF10189F1, 0x9F1E6B9F, 0xA93453A9, 0xC4F16AC4, 0x99C3B499, 0x975BF197, + 0x8347E183, 0x6B18E66B, 0xC822BDC8, 0x0E98450E, 0x6E1FE26E, 0xC9B3F4C9, 0x2F74B62F, 0xCBF866CB, + 0xFF99CCFF, 0xEA1495EA, 0xED5803ED, 0xF7DC56F7, 0xE18BD4E1, 0x1B151C1B, 0xADA21EAD, 0x0CD3D70C, + 0x2BE2FB2B, 0x1DC8C31D, 0x195E8E19, 0xC22CB5C2, 0x8949E989, 0x12C1CF12, 0x7E95BF7E, 0x207DBA20, + 0x6411EA64, 0x840B7784, 0x6DC5396D, 0x6A89AF6A, 0xD17C33D1, 0xA171C9A1, 0xCEFF62CE, 0x37BB7137, + 0xFB0F81FB, 0x3DB5793D, 0x51E10951, 0xDC3EADDC, 0x2D3F242D, 0xA476CDA4, 0x9D55F99D, 0xEE82D8EE, + 0x8640E586, 0xAE78C5AE, 0xCD25B9CD, 0x04964D04, 0x55774455, 0x0A0E080A, 0x13508613, 0x30F7E730, + 0xD337A1D3, 0x40FA1D40, 0x3461AA34, 0x8C4EED8C, 0xB3B006B3, 0x6C54706C, 0x2A73B22A, 0x523BD252, + 0x0B9F410B, 0x8B027B8B, 0x88D8A088, 0x4FF3114F, 0x67CB3167, 0x4627C246, 0xC06727C0, 0xB4FC90B4, + 0x28382028, 0x7F04F67F, 0x78486078, 0x2EE5FF2E, 0x074C9607, 0x4B655C4B, 0xC72BB1C7, 0x6F8EAB6F, + 0x0D429E0D, 0xBBF59CBB, 0xF2DB52F2, 0xF34A1BF3, 0xA63D5FA6, 0x59A49359, 0xBCB90ABC, 0x3AF9EF3A, + 0xEF1391EF, 0xFE0885FE, 0x01914901, 0x6116EE61, 0x7CDE2D7C, 0xB2214FB2, 0x42B18F42, 0xDB723BDB, + 0xB82F47B8, 0x48BF8748, 0x2CAE6D2C, 0xE3C046E3, 0x573CD657, 0x859A3E85, 0x29A96929, 0x7D4F647D, + 0x94812A94, 0x492ECE49, 0x17C6CB17, 0xCA692FCA, 0xC3BDFCC3, 0x5CA3975C, 0x5EE8055E, 0xD0ED7AD0, + 0x87D1AC87, 0x8E057F8E, 0xBA64D5BA, 0xA8A51AA8, 0xB7264BB7, 0xB9BE0EB9, 0x6087A760, 0xF8D55AF8, + 0x22362822, 0x111B1411, 0xDE753FDE, 0x79D92979, 0xAAEE88AA, 0x332D3C33, 0x5F794C5F, 0xB6B702B6, + 0x96CAB896, 0x5835DA58, 0x9CC4B09C, 0xFC4317FC, 0x1A84551A, 0xF64D1FF6, 0x1C598A1C, 0x38B27D38, + 0xAC3357AC, 0x18CFC718, 0xF4068DF4, 0x69537469, 0x749BB774, 0xF597C4F5, 0x56AD9F56, 0xDAE372DA, + 0xD5EA7ED5, 0x4AF4154A, 0x9E8F229E, 0xA2AB12A2, 0x4E62584E, 0xE85F07E8, 0xE51D99E5, 0x39233439, + 0xC1F66EC1, 0x446C5044, 0x5D32DE5D, 0x72466872, 0x26A06526, 0x93CDBC93, 0x03DADB03, 0xC6BAF8C6, + 0xFA9EC8FA, 0x82D6A882, 0xCF6E2BCF, 0x50704050, 0xEB85DCEB, 0x750AFE75, 0x8A93328A, 0x8DDFA48D, + 0x4C29CA4C, 0x141C1014, 0x73D72173, 0xCCB4F0CC, 0x09D4D309, 0x108A5D10, 0xE2510FE2, 0x00000000, + 0x9A196F9A, 0xE01A9DE0, 0x8F94368F, 0xE6C742E6, 0xECC94AEC, 0xFDD25EFD, 0xAB7FC1AB, 0xD8A8E0D8 + ); + + /** + * The Key Schedule Array + * + * @var array + * @access private + */ + var $K = array(); + + /** + * The Key depended S-Table 0 + * + * @var array + * @access private + */ + var $S0 = array(); + + /** + * The Key depended S-Table 1 + * + * @var array + * @access private + */ + var $S1 = array(); + + /** + * The Key depended S-Table 2 + * + * @var array + * @access private + */ + var $S2 = array(); + + /** + * The Key depended S-Table 3 + * + * @var array + * @access private + */ + var $S3 = array(); + + /** + * Holds the last used key + * + * @var array + * @access private + */ + var $kl; + + /** + * The Key Length (in bytes) + * + * @see Crypt_Twofish::setKeyLength() + * @var int + * @access private + */ + var $key_length = 16; + + /** + * Sets the key length. + * + * Valid key lengths are 128, 192 or 256 bits + * + * @access public + * @param int $length + */ + function setKeyLength($length) + { + switch (true) { + case $length <= 128: + $this->key_length = 16; + break; + case $length <= 192: + $this->key_length = 24; + break; + default: + $this->key_length = 32; + } + + parent::setKeyLength($length); + } + + /** + * Setup the key (expansion) + * + * @see \phpseclib\Crypt\Base::_setupKey() + * @access private + */ + function _setupKey() + { + if (isset($this->kl['key']) && $this->key === $this->kl['key']) { + // already expanded + return; + } + $this->kl = array('key' => $this->key); + + /* Key expanding and generating the key-depended s-boxes */ + $le_longs = unpack('V*', $this->key); + $key = unpack('C*', $this->key); + $m0 = $this->m0; + $m1 = $this->m1; + $m2 = $this->m2; + $m3 = $this->m3; + $q0 = $this->q0; + $q1 = $this->q1; + + $K = $S0 = $S1 = $S2 = $S3 = array(); + + switch (strlen($this->key)) { + case 16: + list($s7, $s6, $s5, $s4) = $this->_mdsrem($le_longs[1], $le_longs[2]); + list($s3, $s2, $s1, $s0) = $this->_mdsrem($le_longs[3], $le_longs[4]); + for ($i = 0, $j = 1; $i < 40; $i+= 2, $j+= 2) { + $A = $m0[$q0[$q0[$i] ^ $key[ 9]] ^ $key[1]] ^ + $m1[$q0[$q1[$i] ^ $key[10]] ^ $key[2]] ^ + $m2[$q1[$q0[$i] ^ $key[11]] ^ $key[3]] ^ + $m3[$q1[$q1[$i] ^ $key[12]] ^ $key[4]]; + $B = $m0[$q0[$q0[$j] ^ $key[13]] ^ $key[5]] ^ + $m1[$q0[$q1[$j] ^ $key[14]] ^ $key[6]] ^ + $m2[$q1[$q0[$j] ^ $key[15]] ^ $key[7]] ^ + $m3[$q1[$q1[$j] ^ $key[16]] ^ $key[8]]; + $B = ($B << 8) | ($B >> 24 & 0xff); + $A = $this->safe_intval($A + $B); + $K[] = $A; + $A = $this->safe_intval($A + $B); + $K[] = ($A << 9 | $A >> 23 & 0x1ff); + } + for ($i = 0; $i < 256; ++$i) { + $S0[$i] = $m0[$q0[$q0[$i] ^ $s4] ^ $s0]; + $S1[$i] = $m1[$q0[$q1[$i] ^ $s5] ^ $s1]; + $S2[$i] = $m2[$q1[$q0[$i] ^ $s6] ^ $s2]; + $S3[$i] = $m3[$q1[$q1[$i] ^ $s7] ^ $s3]; + } + break; + case 24: + list($sb, $sa, $s9, $s8) = $this->_mdsrem($le_longs[1], $le_longs[2]); + list($s7, $s6, $s5, $s4) = $this->_mdsrem($le_longs[3], $le_longs[4]); + list($s3, $s2, $s1, $s0) = $this->_mdsrem($le_longs[5], $le_longs[6]); + for ($i = 0, $j = 1; $i < 40; $i+= 2, $j+= 2) { + $A = $m0[$q0[$q0[$q1[$i] ^ $key[17]] ^ $key[ 9]] ^ $key[1]] ^ + $m1[$q0[$q1[$q1[$i] ^ $key[18]] ^ $key[10]] ^ $key[2]] ^ + $m2[$q1[$q0[$q0[$i] ^ $key[19]] ^ $key[11]] ^ $key[3]] ^ + $m3[$q1[$q1[$q0[$i] ^ $key[20]] ^ $key[12]] ^ $key[4]]; + $B = $m0[$q0[$q0[$q1[$j] ^ $key[21]] ^ $key[13]] ^ $key[5]] ^ + $m1[$q0[$q1[$q1[$j] ^ $key[22]] ^ $key[14]] ^ $key[6]] ^ + $m2[$q1[$q0[$q0[$j] ^ $key[23]] ^ $key[15]] ^ $key[7]] ^ + $m3[$q1[$q1[$q0[$j] ^ $key[24]] ^ $key[16]] ^ $key[8]]; + $B = ($B << 8) | ($B >> 24 & 0xff); + $A = $this->safe_intval($A + $B); + $K[] = $A; + $A = $this->safe_intval($A + $B); + $K[] = ($A << 9 | $A >> 23 & 0x1ff); + } + for ($i = 0; $i < 256; ++$i) { + $S0[$i] = $m0[$q0[$q0[$q1[$i] ^ $s8] ^ $s4] ^ $s0]; + $S1[$i] = $m1[$q0[$q1[$q1[$i] ^ $s9] ^ $s5] ^ $s1]; + $S2[$i] = $m2[$q1[$q0[$q0[$i] ^ $sa] ^ $s6] ^ $s2]; + $S3[$i] = $m3[$q1[$q1[$q0[$i] ^ $sb] ^ $s7] ^ $s3]; + } + break; + default: // 32 + list($sf, $se, $sd, $sc) = $this->_mdsrem($le_longs[1], $le_longs[2]); + list($sb, $sa, $s9, $s8) = $this->_mdsrem($le_longs[3], $le_longs[4]); + list($s7, $s6, $s5, $s4) = $this->_mdsrem($le_longs[5], $le_longs[6]); + list($s3, $s2, $s1, $s0) = $this->_mdsrem($le_longs[7], $le_longs[8]); + for ($i = 0, $j = 1; $i < 40; $i+= 2, $j+= 2) { + $A = $m0[$q0[$q0[$q1[$q1[$i] ^ $key[25]] ^ $key[17]] ^ $key[ 9]] ^ $key[1]] ^ + $m1[$q0[$q1[$q1[$q0[$i] ^ $key[26]] ^ $key[18]] ^ $key[10]] ^ $key[2]] ^ + $m2[$q1[$q0[$q0[$q0[$i] ^ $key[27]] ^ $key[19]] ^ $key[11]] ^ $key[3]] ^ + $m3[$q1[$q1[$q0[$q1[$i] ^ $key[28]] ^ $key[20]] ^ $key[12]] ^ $key[4]]; + $B = $m0[$q0[$q0[$q1[$q1[$j] ^ $key[29]] ^ $key[21]] ^ $key[13]] ^ $key[5]] ^ + $m1[$q0[$q1[$q1[$q0[$j] ^ $key[30]] ^ $key[22]] ^ $key[14]] ^ $key[6]] ^ + $m2[$q1[$q0[$q0[$q0[$j] ^ $key[31]] ^ $key[23]] ^ $key[15]] ^ $key[7]] ^ + $m3[$q1[$q1[$q0[$q1[$j] ^ $key[32]] ^ $key[24]] ^ $key[16]] ^ $key[8]]; + $B = ($B << 8) | ($B >> 24 & 0xff); + $A = $this->safe_intval($A + $B); + $K[] = $A; + $A = $this->safe_intval($A + $B); + $K[] = ($A << 9 | $A >> 23 & 0x1ff); + } + for ($i = 0; $i < 256; ++$i) { + $S0[$i] = $m0[$q0[$q0[$q1[$q1[$i] ^ $sc] ^ $s8] ^ $s4] ^ $s0]; + $S1[$i] = $m1[$q0[$q1[$q1[$q0[$i] ^ $sd] ^ $s9] ^ $s5] ^ $s1]; + $S2[$i] = $m2[$q1[$q0[$q0[$q0[$i] ^ $se] ^ $sa] ^ $s6] ^ $s2]; + $S3[$i] = $m3[$q1[$q1[$q0[$q1[$i] ^ $sf] ^ $sb] ^ $s7] ^ $s3]; + } + } + + $this->K = $K; + $this->S0 = $S0; + $this->S1 = $S1; + $this->S2 = $S2; + $this->S3 = $S3; + } + + /** + * _mdsrem function using by the twofish cipher algorithm + * + * @access private + * @param string $A + * @param string $B + * @return array + */ + function _mdsrem($A, $B) + { + // No gain by unrolling this loop. + for ($i = 0; $i < 8; ++$i) { + // Get most significant coefficient. + $t = 0xff & ($B >> 24); + + // Shift the others up. + $B = ($B << 8) | (0xff & ($A >> 24)); + $A<<= 8; + + $u = $t << 1; + + // Subtract the modular polynomial on overflow. + if ($t & 0x80) { + $u^= 0x14d; + } + + // Remove t * (a * x^2 + 1). + $B ^= $t ^ ($u << 16); + + // Form u = a*t + t/a = t*(a + 1/a). + $u^= 0x7fffffff & ($t >> 1); + + // Add the modular polynomial on underflow. + if ($t & 0x01) { + $u^= 0xa6 ; + } + + // Remove t * (a + 1/a) * (x^3 + x). + $B^= ($u << 24) | ($u << 8); + } + + return array( + 0xff & $B >> 24, + 0xff & $B >> 16, + 0xff & $B >> 8, + 0xff & $B); + } + + /** + * Encrypts a block + * + * @access private + * @param string $in + * @return string + */ + function _encryptBlock($in) + { + $S0 = $this->S0; + $S1 = $this->S1; + $S2 = $this->S2; + $S3 = $this->S3; + $K = $this->K; + + $in = unpack("V4", $in); + $R0 = $K[0] ^ $in[1]; + $R1 = $K[1] ^ $in[2]; + $R2 = $K[2] ^ $in[3]; + $R3 = $K[3] ^ $in[4]; + + $ki = 7; + while ($ki < 39) { + $t0 = $S0[ $R0 & 0xff] ^ + $S1[($R0 >> 8) & 0xff] ^ + $S2[($R0 >> 16) & 0xff] ^ + $S3[($R0 >> 24) & 0xff]; + $t1 = $S0[($R1 >> 24) & 0xff] ^ + $S1[ $R1 & 0xff] ^ + $S2[($R1 >> 8) & 0xff] ^ + $S3[($R1 >> 16) & 0xff]; + $R2^= $this->safe_intval($t0 + $t1 + $K[++$ki]); + $R2 = ($R2 >> 1 & 0x7fffffff) | ($R2 << 31); + $R3 = ((($R3 >> 31) & 1) | ($R3 << 1)) ^ $this->safe_intval($t0 + ($t1 << 1) + $K[++$ki]); + + $t0 = $S0[ $R2 & 0xff] ^ + $S1[($R2 >> 8) & 0xff] ^ + $S2[($R2 >> 16) & 0xff] ^ + $S3[($R2 >> 24) & 0xff]; + $t1 = $S0[($R3 >> 24) & 0xff] ^ + $S1[ $R3 & 0xff] ^ + $S2[($R3 >> 8) & 0xff] ^ + $S3[($R3 >> 16) & 0xff]; + $R0^= $this->safe_intval($t0 + $t1 + $K[++$ki]); + $R0 = ($R0 >> 1 & 0x7fffffff) | ($R0 << 31); + $R1 = ((($R1 >> 31) & 1) | ($R1 << 1)) ^ $this->safe_intval($t0 + ($t1 << 1) + $K[++$ki]); + } + + // @codingStandardsIgnoreStart + return pack("V4", $K[4] ^ $R2, + $K[5] ^ $R3, + $K[6] ^ $R0, + $K[7] ^ $R1); + // @codingStandardsIgnoreEnd + } + + /** + * Decrypts a block + * + * @access private + * @param string $in + * @return string + */ + function _decryptBlock($in) + { + $S0 = $this->S0; + $S1 = $this->S1; + $S2 = $this->S2; + $S3 = $this->S3; + $K = $this->K; + + $in = unpack("V4", $in); + $R0 = $K[4] ^ $in[1]; + $R1 = $K[5] ^ $in[2]; + $R2 = $K[6] ^ $in[3]; + $R3 = $K[7] ^ $in[4]; + + $ki = 40; + while ($ki > 8) { + $t0 = $S0[$R0 & 0xff] ^ + $S1[$R0 >> 8 & 0xff] ^ + $S2[$R0 >> 16 & 0xff] ^ + $S3[$R0 >> 24 & 0xff]; + $t1 = $S0[$R1 >> 24 & 0xff] ^ + $S1[$R1 & 0xff] ^ + $S2[$R1 >> 8 & 0xff] ^ + $S3[$R1 >> 16 & 0xff]; + $R3^= $this->safe_intval($t0 + ($t1 << 1) + $K[--$ki]); + $R3 = $R3 >> 1 & 0x7fffffff | $R3 << 31; + $R2 = ($R2 >> 31 & 0x1 | $R2 << 1) ^ $this->safe_intval($t0 + $t1 + $K[--$ki]); + + $t0 = $S0[$R2 & 0xff] ^ + $S1[$R2 >> 8 & 0xff] ^ + $S2[$R2 >> 16 & 0xff] ^ + $S3[$R2 >> 24 & 0xff]; + $t1 = $S0[$R3 >> 24 & 0xff] ^ + $S1[$R3 & 0xff] ^ + $S2[$R3 >> 8 & 0xff] ^ + $S3[$R3 >> 16 & 0xff]; + $R1^= $this->safe_intval($t0 + ($t1 << 1) + $K[--$ki]); + $R1 = $R1 >> 1 & 0x7fffffff | $R1 << 31; + $R0 = ($R0 >> 31 & 0x1 | $R0 << 1) ^ $this->safe_intval($t0 + $t1 + $K[--$ki]); + } + + // @codingStandardsIgnoreStart + return pack("V4", $K[0] ^ $R2, + $K[1] ^ $R3, + $K[2] ^ $R0, + $K[3] ^ $R1); + // @codingStandardsIgnoreEnd + } + + /** + * Setup the performance-optimized function for de/encrypt() + * + * @see \phpseclib\Crypt\Base::_setupInlineCrypt() + * @access private + */ + function _setupInlineCrypt() + { + $lambda_functions =& self::_getLambdaFunctions(); + + // Max. 10 Ultra-Hi-optimized inline-crypt functions. After that, we'll (still) create very fast code, but not the ultimate fast one. + // (Currently, for Crypt_Twofish, one generated $lambda_function cost on php5.5@32bit ~140kb unfreeable mem and ~240kb on php5.5@64bit) + $gen_hi_opt_code = (bool)(count($lambda_functions) < 10); + + // Generation of a unique hash for our generated code + $code_hash = "Crypt_Twofish, {$this->mode}"; + if ($gen_hi_opt_code) { + $code_hash = str_pad($code_hash, 32) . $this->_hashInlineCryptFunction($this->key); + } + + $safeint = $this->safe_intval_inline(); + + if (!isset($lambda_functions[$code_hash])) { + switch (true) { + case $gen_hi_opt_code: + $K = $this->K; + $init_crypt = ' + static $S0, $S1, $S2, $S3; + if (!$S0) { + for ($i = 0; $i < 256; ++$i) { + $S0[] = (int)$self->S0[$i]; + $S1[] = (int)$self->S1[$i]; + $S2[] = (int)$self->S2[$i]; + $S3[] = (int)$self->S3[$i]; + } + } + '; + break; + default: + $K = array(); + for ($i = 0; $i < 40; ++$i) { + $K[] = '$K_' . $i; + } + $init_crypt = ' + $S0 = $self->S0; + $S1 = $self->S1; + $S2 = $self->S2; + $S3 = $self->S3; + list(' . implode(',', $K) . ') = $self->K; + '; + } + + // Generating encrypt code: + $encrypt_block = ' + $in = unpack("V4", $in); + $R0 = '.$K[0].' ^ $in[1]; + $R1 = '.$K[1].' ^ $in[2]; + $R2 = '.$K[2].' ^ $in[3]; + $R3 = '.$K[3].' ^ $in[4]; + '; + for ($ki = 7, $i = 0; $i < 8; ++$i) { + $encrypt_block.= ' + $t0 = $S0[ $R0 & 0xff] ^ + $S1[($R0 >> 8) & 0xff] ^ + $S2[($R0 >> 16) & 0xff] ^ + $S3[($R0 >> 24) & 0xff]; + $t1 = $S0[($R1 >> 24) & 0xff] ^ + $S1[ $R1 & 0xff] ^ + $S2[($R1 >> 8) & 0xff] ^ + $S3[($R1 >> 16) & 0xff]; + $R2^= ' . sprintf($safeint, '$t0 + $t1 + ' . $K[++$ki]) . '; + $R2 = ($R2 >> 1 & 0x7fffffff) | ($R2 << 31); + $R3 = ((($R3 >> 31) & 1) | ($R3 << 1)) ^ ' . sprintf($safeint, '($t0 + ($t1 << 1) + ' . $K[++$ki] . ')') . '; + + $t0 = $S0[ $R2 & 0xff] ^ + $S1[($R2 >> 8) & 0xff] ^ + $S2[($R2 >> 16) & 0xff] ^ + $S3[($R2 >> 24) & 0xff]; + $t1 = $S0[($R3 >> 24) & 0xff] ^ + $S1[ $R3 & 0xff] ^ + $S2[($R3 >> 8) & 0xff] ^ + $S3[($R3 >> 16) & 0xff]; + $R0^= ' . sprintf($safeint, '($t0 + $t1 + ' . $K[++$ki] . ')') . '; + $R0 = ($R0 >> 1 & 0x7fffffff) | ($R0 << 31); + $R1 = ((($R1 >> 31) & 1) | ($R1 << 1)) ^ ' . sprintf($safeint, '($t0 + ($t1 << 1) + ' . $K[++$ki] . ')') . '; + '; + } + $encrypt_block.= ' + $in = pack("V4", ' . $K[4] . ' ^ $R2, + ' . $K[5] . ' ^ $R3, + ' . $K[6] . ' ^ $R0, + ' . $K[7] . ' ^ $R1); + '; + + // Generating decrypt code: + $decrypt_block = ' + $in = unpack("V4", $in); + $R0 = '.$K[4].' ^ $in[1]; + $R1 = '.$K[5].' ^ $in[2]; + $R2 = '.$K[6].' ^ $in[3]; + $R3 = '.$K[7].' ^ $in[4]; + '; + for ($ki = 40, $i = 0; $i < 8; ++$i) { + $decrypt_block.= ' + $t0 = $S0[$R0 & 0xff] ^ + $S1[$R0 >> 8 & 0xff] ^ + $S2[$R0 >> 16 & 0xff] ^ + $S3[$R0 >> 24 & 0xff]; + $t1 = $S0[$R1 >> 24 & 0xff] ^ + $S1[$R1 & 0xff] ^ + $S2[$R1 >> 8 & 0xff] ^ + $S3[$R1 >> 16 & 0xff]; + $R3^= ' . sprintf($safeint, '$t0 + ($t1 << 1) + ' . $K[--$ki]) . '; + $R3 = $R3 >> 1 & 0x7fffffff | $R3 << 31; + $R2 = ($R2 >> 31 & 0x1 | $R2 << 1) ^ ' . sprintf($safeint, '($t0 + $t1 + '.$K[--$ki] . ')') . '; + + $t0 = $S0[$R2 & 0xff] ^ + $S1[$R2 >> 8 & 0xff] ^ + $S2[$R2 >> 16 & 0xff] ^ + $S3[$R2 >> 24 & 0xff]; + $t1 = $S0[$R3 >> 24 & 0xff] ^ + $S1[$R3 & 0xff] ^ + $S2[$R3 >> 8 & 0xff] ^ + $S3[$R3 >> 16 & 0xff]; + $R1^= ' . sprintf($safeint, '$t0 + ($t1 << 1) + ' . $K[--$ki]) . '; + $R1 = $R1 >> 1 & 0x7fffffff | $R1 << 31; + $R0 = ($R0 >> 31 & 0x1 | $R0 << 1) ^ ' . sprintf($safeint, '($t0 + $t1 + '.$K[--$ki] . ')') . '; + '; + } + $decrypt_block.= ' + $in = pack("V4", ' . $K[0] . ' ^ $R2, + ' . $K[1] . ' ^ $R3, + ' . $K[2] . ' ^ $R0, + ' . $K[3] . ' ^ $R1); + '; + + $lambda_functions[$code_hash] = $this->_createInlineCryptFunction( + array( + 'init_crypt' => $init_crypt, + 'init_encrypt' => '', + 'init_decrypt' => '', + 'encrypt_block' => $encrypt_block, + 'decrypt_block' => $decrypt_block + ) + ); + } + $this->inline_crypt = $lambda_functions[$code_hash]; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Math/BigInteger.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Math/BigInteger.php new file mode 100644 index 0000000..2aa39a5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/Math/BigInteger.php @@ -0,0 +1,3763 @@ +> and << cannot be used, nor can the modulo operator %, + * which only supports integers. Although this fact will slow this library down, the fact that such a high + * base is being used should more than compensate. + * + * Numbers are stored in {@link http://en.wikipedia.org/wiki/Endianness little endian} format. ie. + * (new \phpseclib\Math\BigInteger(pow(2, 26)))->value = array(0, 1) + * + * Useful resources are as follows: + * + * - {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf Handbook of Applied Cryptography (HAC)} + * - {@link http://math.libtomcrypt.com/files/tommath.pdf Multi-Precision Math (MPM)} + * - Java's BigInteger classes. See /j2se/src/share/classes/java/math in jdk-1_5_0-src-jrl.zip + * + * Here's an example of how to use this library: + * + * add($b); + * + * echo $c->toString(); // outputs 5 + * ?> + * + * + * @category Math + * @package BigInteger + * @author Jim Wigginton + * @copyright 2006 Jim Wigginton + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @link http://pear.php.net/package/Math_BigInteger + */ + +namespace phpseclib\Math; + +use phpseclib\Crypt\Random; + +/** + * Pure-PHP arbitrary precision integer arithmetic library. Supports base-2, base-10, base-16, and base-256 + * numbers. + * + * @package BigInteger + * @author Jim Wigginton + * @access public + */ +class BigInteger +{ + /**#@+ + * Reduction constants + * + * @access private + * @see BigInteger::_reduce() + */ + /** + * @see BigInteger::_montgomery() + * @see BigInteger::_prepMontgomery() + */ + const MONTGOMERY = 0; + /** + * @see BigInteger::_barrett() + */ + const BARRETT = 1; + /** + * @see BigInteger::_mod2() + */ + const POWEROF2 = 2; + /** + * @see BigInteger::_remainder() + */ + const CLASSIC = 3; + /** + * @see BigInteger::__clone() + */ + const NONE = 4; + /**#@-*/ + + /**#@+ + * Array constants + * + * Rather than create a thousands and thousands of new BigInteger objects in repeated function calls to add() and + * multiply() or whatever, we'll just work directly on arrays, taking them in as parameters and returning them. + * + * @access private + */ + /** + * $result[self::VALUE] contains the value. + */ + const VALUE = 0; + /** + * $result[self::SIGN] contains the sign. + */ + const SIGN = 1; + /**#@-*/ + + /**#@+ + * @access private + * @see BigInteger::_montgomery() + * @see BigInteger::_barrett() + */ + /** + * Cache constants + * + * $cache[self::VARIABLE] tells us whether or not the cached data is still valid. + */ + const VARIABLE = 0; + /** + * $cache[self::DATA] contains the cached data. + */ + const DATA = 1; + /**#@-*/ + + /**#@+ + * Mode constants. + * + * @access private + * @see BigInteger::__construct() + */ + /** + * To use the pure-PHP implementation + */ + const MODE_INTERNAL = 1; + /** + * To use the BCMath library + * + * (if enabled; otherwise, the internal implementation will be used) + */ + const MODE_BCMATH = 2; + /** + * To use the GMP library + * + * (if present; otherwise, either the BCMath or the internal implementation will be used) + */ + const MODE_GMP = 3; + /**#@-*/ + + /** + * Karatsuba Cutoff + * + * At what point do we switch between Karatsuba multiplication and schoolbook long multiplication? + * + * @access private + */ + const KARATSUBA_CUTOFF = 25; + + /**#@+ + * Static properties used by the pure-PHP implementation. + * + * @see __construct() + */ + protected static $base; + protected static $baseFull; + protected static $maxDigit; + protected static $msb; + + /** + * $max10 in greatest $max10Len satisfying + * $max10 = 10**$max10Len <= 2**$base. + */ + protected static $max10; + + /** + * $max10Len in greatest $max10Len satisfying + * $max10 = 10**$max10Len <= 2**$base. + */ + protected static $max10Len; + protected static $maxDigit2; + /**#@-*/ + + /** + * Holds the BigInteger's value. + * + * @var array + * @access private + */ + var $value; + + /** + * Holds the BigInteger's magnitude. + * + * @var bool + * @access private + */ + var $is_negative = false; + + /** + * Precision + * + * @see self::setPrecision() + * @access private + */ + var $precision = -1; + + /** + * Precision Bitmask + * + * @see self::setPrecision() + * @access private + */ + var $bitmask = false; + + /** + * Mode independent value used for serialization. + * + * If the bcmath or gmp extensions are installed $this->value will be a non-serializable resource, hence the need for + * a variable that'll be serializable regardless of whether or not extensions are being used. Unlike $this->value, + * however, $this->hex is only calculated when $this->__sleep() is called. + * + * @see self::__sleep() + * @see self::__wakeup() + * @var string + * @access private + */ + var $hex; + + /** + * Converts base-2, base-10, base-16, and binary strings (base-256) to BigIntegers. + * + * If the second parameter - $base - is negative, then it will be assumed that the number's are encoded using + * two's compliment. The sole exception to this is -10, which is treated the same as 10 is. + * + * Here's an example: + * + * toString(); // outputs 50 + * ?> + * + * + * @param $x base-10 number or base-$base number if $base set. + * @param int $base + * @return \phpseclib\Math\BigInteger + * @access public + */ + function __construct($x = 0, $base = 10) + { + if (!defined('MATH_BIGINTEGER_MODE')) { + switch (true) { + case extension_loaded('gmp'): + define('MATH_BIGINTEGER_MODE', self::MODE_GMP); + break; + case extension_loaded('bcmath'): + define('MATH_BIGINTEGER_MODE', self::MODE_BCMATH); + break; + default: + define('MATH_BIGINTEGER_MODE', self::MODE_INTERNAL); + } + } + + if (extension_loaded('openssl') && !defined('MATH_BIGINTEGER_OPENSSL_DISABLE') && !defined('MATH_BIGINTEGER_OPENSSL_ENABLED')) { + // some versions of XAMPP have mismatched versions of OpenSSL which causes it not to work + ob_start(); + @phpinfo(); + $content = ob_get_contents(); + ob_end_clean(); + + preg_match_all('#OpenSSL (Header|Library) Version(.*)#im', $content, $matches); + + $versions = array(); + if (!empty($matches[1])) { + for ($i = 0; $i < count($matches[1]); $i++) { + $fullVersion = trim(str_replace('=>', '', strip_tags($matches[2][$i]))); + + // Remove letter part in OpenSSL version + if (!preg_match('/(\d+\.\d+\.\d+)/i', $fullVersion, $m)) { + $versions[$matches[1][$i]] = $fullVersion; + } else { + $versions[$matches[1][$i]] = $m[0]; + } + } + } + + // it doesn't appear that OpenSSL versions were reported upon until PHP 5.3+ + switch (true) { + case !isset($versions['Header']): + case !isset($versions['Library']): + case $versions['Header'] == $versions['Library']: + case version_compare($versions['Header'], '1.0.0') >= 0 && version_compare($versions['Library'], '1.0.0') >= 0: + define('MATH_BIGINTEGER_OPENSSL_ENABLED', true); + break; + default: + define('MATH_BIGINTEGER_OPENSSL_DISABLE', true); + } + } + + if (!defined('PHP_INT_SIZE')) { + define('PHP_INT_SIZE', 4); + } + + if (empty(self::$base) && MATH_BIGINTEGER_MODE == self::MODE_INTERNAL) { + switch (PHP_INT_SIZE) { + case 8: // use 64-bit integers if int size is 8 bytes + self::$base = 31; + self::$baseFull = 0x80000000; + self::$maxDigit = 0x7FFFFFFF; + self::$msb = 0x40000000; + self::$max10 = 1000000000; + self::$max10Len = 9; + self::$maxDigit2 = pow(2, 62); + break; + //case 4: // use 64-bit floats if int size is 4 bytes + default: + self::$base = 26; + self::$baseFull = 0x4000000; + self::$maxDigit = 0x3FFFFFF; + self::$msb = 0x2000000; + self::$max10 = 10000000; + self::$max10Len = 7; + self::$maxDigit2 = pow(2, 52); // pow() prevents truncation + } + } + + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + switch (true) { + case is_resource($x) && get_resource_type($x) == 'GMP integer': + // PHP 5.6 switched GMP from using resources to objects + case $x instanceof \GMP: + $this->value = $x; + return; + } + $this->value = gmp_init(0); + break; + case self::MODE_BCMATH: + $this->value = '0'; + break; + default: + $this->value = array(); + } + + // '0' counts as empty() but when the base is 256 '0' is equal to ord('0') or 48 + // '0' is the only value like this per http://php.net/empty + if (empty($x) && (abs($base) != 256 || $x !== '0')) { + return; + } + + switch ($base) { + case -256: + if (ord($x[0]) & 0x80) { + $x = ~$x; + $this->is_negative = true; + } + case 256: + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $this->value = function_exists('gmp_import') ? + gmp_import($x) : + gmp_init('0x' . bin2hex($x)); + if ($this->is_negative) { + $this->value = gmp_neg($this->value); + } + break; + case self::MODE_BCMATH: + // round $len to the nearest 4 (thanks, DavidMJ!) + $len = (strlen($x) + 3) & 0xFFFFFFFC; + + $x = str_pad($x, $len, chr(0), STR_PAD_LEFT); + + for ($i = 0; $i < $len; $i+= 4) { + $this->value = bcmul($this->value, '4294967296', 0); // 4294967296 == 2**32 + $this->value = bcadd($this->value, 0x1000000 * ord($x[$i]) + ((ord($x[$i + 1]) << 16) | (ord($x[$i + 2]) << 8) | ord($x[$i + 3])), 0); + } + + if ($this->is_negative) { + $this->value = '-' . $this->value; + } + + break; + // converts a base-2**8 (big endian / msb) number to base-2**26 (little endian / lsb) + default: + while (strlen($x)) { + $this->value[] = $this->_bytes2int($this->_base256_rshift($x, self::$base)); + } + } + + if ($this->is_negative) { + if (MATH_BIGINTEGER_MODE != self::MODE_INTERNAL) { + $this->is_negative = false; + } + $temp = $this->add(new static('-1')); + $this->value = $temp->value; + } + break; + case 16: + case -16: + if ($base > 0 && $x[0] == '-') { + $this->is_negative = true; + $x = substr($x, 1); + } + + $x = preg_replace('#^(?:0x)?([A-Fa-f0-9]*).*#', '$1', $x); + + $is_negative = false; + if ($base < 0 && hexdec($x[0]) >= 8) { + $this->is_negative = $is_negative = true; + $x = bin2hex(~pack('H*', $x)); + } + + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp = $this->is_negative ? '-0x' . $x : '0x' . $x; + $this->value = gmp_init($temp); + $this->is_negative = false; + break; + case self::MODE_BCMATH: + $x = (strlen($x) & 1) ? '0' . $x : $x; + $temp = new static(pack('H*', $x), 256); + $this->value = $this->is_negative ? '-' . $temp->value : $temp->value; + $this->is_negative = false; + break; + default: + $x = (strlen($x) & 1) ? '0' . $x : $x; + $temp = new static(pack('H*', $x), 256); + $this->value = $temp->value; + } + + if ($is_negative) { + $temp = $this->add(new static('-1')); + $this->value = $temp->value; + } + break; + case 10: + case -10: + // (?value = gmp_init($x); + break; + case self::MODE_BCMATH: + // explicitly casting $x to a string is necessary, here, since doing $x[0] on -1 yields different + // results then doing it on '-1' does (modInverse does $x[0]) + $this->value = $x === '-' ? '0' : (string) $x; + break; + default: + $temp = new static(); + + $multiplier = new static(); + $multiplier->value = array(self::$max10); + + if ($x[0] == '-') { + $this->is_negative = true; + $x = substr($x, 1); + } + + $x = str_pad($x, strlen($x) + ((self::$max10Len - 1) * strlen($x)) % self::$max10Len, 0, STR_PAD_LEFT); + while (strlen($x)) { + $temp = $temp->multiply($multiplier); + $temp = $temp->add(new static($this->_int2bytes(substr($x, 0, self::$max10Len)), 256)); + $x = substr($x, self::$max10Len); + } + + $this->value = $temp->value; + } + break; + case 2: // base-2 support originally implemented by Lluis Pamies - thanks! + case -2: + if ($base > 0 && $x[0] == '-') { + $this->is_negative = true; + $x = substr($x, 1); + } + + $x = preg_replace('#^([01]*).*#', '$1', $x); + $x = str_pad($x, strlen($x) + (3 * strlen($x)) % 4, 0, STR_PAD_LEFT); + + $str = '0x'; + while (strlen($x)) { + $part = substr($x, 0, 4); + $str.= dechex(bindec($part)); + $x = substr($x, 4); + } + + if ($this->is_negative) { + $str = '-' . $str; + } + + $temp = new static($str, 8 * $base); // ie. either -16 or +16 + $this->value = $temp->value; + $this->is_negative = $temp->is_negative; + + break; + default: + // base not supported, so we'll let $this == 0 + } + } + + /** + * Converts a BigInteger to a byte string (eg. base-256). + * + * Negative numbers are saved as positive numbers, unless $twos_compliment is set to true, at which point, they're + * saved as two's compliment. + * + * Here's an example: + * + * toBytes(); // outputs chr(65) + * ?> + * + * + * @param bool $twos_compliment + * @return string + * @access public + * @internal Converts a base-2**26 number to base-2**8 + */ + function toBytes($twos_compliment = false) + { + if ($twos_compliment) { + $comparison = $this->compare(new static()); + if ($comparison == 0) { + return $this->precision > 0 ? str_repeat(chr(0), ($this->precision + 1) >> 3) : ''; + } + + $temp = $comparison < 0 ? $this->add(new static(1)) : $this->copy(); + $bytes = $temp->toBytes(); + + if (empty($bytes)) { // eg. if the number we're trying to convert is -1 + $bytes = chr(0); + } + + if (ord($bytes[0]) & 0x80) { + $bytes = chr(0) . $bytes; + } + + return $comparison < 0 ? ~$bytes : $bytes; + } + + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + if (gmp_cmp($this->value, gmp_init(0)) == 0) { + return $this->precision > 0 ? str_repeat(chr(0), ($this->precision + 1) >> 3) : ''; + } + + if (function_exists('gmp_export')) { + $temp = gmp_export($this->value); + } else { + $temp = gmp_strval(gmp_abs($this->value), 16); + $temp = (strlen($temp) & 1) ? '0' . $temp : $temp; + $temp = pack('H*', $temp); + } + + return $this->precision > 0 ? + substr(str_pad($temp, $this->precision >> 3, chr(0), STR_PAD_LEFT), -($this->precision >> 3)) : + ltrim($temp, chr(0)); + case self::MODE_BCMATH: + if ($this->value === '0') { + return $this->precision > 0 ? str_repeat(chr(0), ($this->precision + 1) >> 3) : ''; + } + + $value = ''; + $current = $this->value; + + if ($current[0] == '-') { + $current = substr($current, 1); + } + + while (bccomp($current, '0', 0) > 0) { + $temp = bcmod($current, '16777216'); + $value = chr($temp >> 16) . chr($temp >> 8) . chr($temp) . $value; + $current = bcdiv($current, '16777216', 0); + } + + return $this->precision > 0 ? + substr(str_pad($value, $this->precision >> 3, chr(0), STR_PAD_LEFT), -($this->precision >> 3)) : + ltrim($value, chr(0)); + } + + if (!count($this->value)) { + return $this->precision > 0 ? str_repeat(chr(0), ($this->precision + 1) >> 3) : ''; + } + $result = $this->_int2bytes($this->value[count($this->value) - 1]); + + $temp = $this->copy(); + + for ($i = count($temp->value) - 2; $i >= 0; --$i) { + $temp->_base256_lshift($result, self::$base); + $result = $result | str_pad($temp->_int2bytes($temp->value[$i]), strlen($result), chr(0), STR_PAD_LEFT); + } + + return $this->precision > 0 ? + str_pad(substr($result, -(($this->precision + 7) >> 3)), ($this->precision + 7) >> 3, chr(0), STR_PAD_LEFT) : + $result; + } + + /** + * Converts a BigInteger to a hex string (eg. base-16)). + * + * Negative numbers are saved as positive numbers, unless $twos_compliment is set to true, at which point, they're + * saved as two's compliment. + * + * Here's an example: + * + * toHex(); // outputs '41' + * ?> + * + * + * @param bool $twos_compliment + * @return string + * @access public + * @internal Converts a base-2**26 number to base-2**8 + */ + function toHex($twos_compliment = false) + { + return bin2hex($this->toBytes($twos_compliment)); + } + + /** + * Converts a BigInteger to a bit string (eg. base-2). + * + * Negative numbers are saved as positive numbers, unless $twos_compliment is set to true, at which point, they're + * saved as two's compliment. + * + * Here's an example: + * + * toBits(); // outputs '1000001' + * ?> + * + * + * @param bool $twos_compliment + * @return string + * @access public + * @internal Converts a base-2**26 number to base-2**2 + */ + function toBits($twos_compliment = false) + { + $hex = $this->toHex($twos_compliment); + $bits = ''; + for ($i = strlen($hex) - 8, $start = strlen($hex) & 7; $i >= $start; $i-=8) { + $bits = str_pad(decbin(hexdec(substr($hex, $i, 8))), 32, '0', STR_PAD_LEFT) . $bits; + } + if ($start) { // hexdec('') == 0 + $bits = str_pad(decbin(hexdec(substr($hex, 0, $start))), 8, '0', STR_PAD_LEFT) . $bits; + } + $result = $this->precision > 0 ? substr($bits, -$this->precision) : ltrim($bits, '0'); + + if ($twos_compliment && $this->compare(new static()) > 0 && $this->precision <= 0) { + return '0' . $result; + } + + return $result; + } + + /** + * Converts a BigInteger to a base-10 number. + * + * Here's an example: + * + * toString(); // outputs 50 + * ?> + * + * + * @return string + * @access public + * @internal Converts a base-2**26 number to base-10**7 (which is pretty much base-10) + */ + function toString() + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + return gmp_strval($this->value); + case self::MODE_BCMATH: + if ($this->value === '0') { + return '0'; + } + + return ltrim($this->value, '0'); + } + + if (!count($this->value)) { + return '0'; + } + + $temp = $this->copy(); + $temp->is_negative = false; + + $divisor = new static(); + $divisor->value = array(self::$max10); + $result = ''; + while (count($temp->value)) { + list($temp, $mod) = $temp->divide($divisor); + $result = str_pad(isset($mod->value[0]) ? $mod->value[0] : '', self::$max10Len, '0', STR_PAD_LEFT) . $result; + } + $result = ltrim($result, '0'); + if (empty($result)) { + $result = '0'; + } + + if ($this->is_negative) { + $result = '-' . $result; + } + + return $result; + } + + /** + * Copy an object + * + * PHP5 passes objects by reference while PHP4 passes by value. As such, we need a function to guarantee + * that all objects are passed by value, when appropriate. More information can be found here: + * + * {@link http://php.net/language.oop5.basic#51624} + * + * @access public + * @see self::__clone() + * @return \phpseclib\Math\BigInteger + */ + function copy() + { + $temp = new static(); + $temp->value = $this->value; + $temp->is_negative = $this->is_negative; + $temp->precision = $this->precision; + $temp->bitmask = $this->bitmask; + return $temp; + } + + /** + * __toString() magic method + * + * Will be called, automatically, if you're supporting just PHP5. If you're supporting PHP4, you'll need to call + * toString(). + * + * @access public + * @internal Implemented per a suggestion by Techie-Michael - thanks! + */ + function __toString() + { + return $this->toString(); + } + + /** + * __clone() magic method + * + * Although you can call BigInteger::__toString() directly in PHP5, you cannot call BigInteger::__clone() directly + * in PHP5. You can in PHP4 since it's not a magic method, but in PHP5, you have to call it by using the PHP5 + * only syntax of $y = clone $x. As such, if you're trying to write an application that works on both PHP4 and + * PHP5, call BigInteger::copy(), instead. + * + * @access public + * @see self::copy() + * @return \phpseclib\Math\BigInteger + */ + function __clone() + { + return $this->copy(); + } + + /** + * __sleep() magic method + * + * Will be called, automatically, when serialize() is called on a BigInteger object. + * + * @see self::__wakeup() + * @access public + */ + function __sleep() + { + $this->hex = $this->toHex(true); + $vars = array('hex'); + if ($this->precision > 0) { + $vars[] = 'precision'; + } + return $vars; + } + + /** + * __wakeup() magic method + * + * Will be called, automatically, when unserialize() is called on a BigInteger object. + * + * @see self::__sleep() + * @access public + */ + function __wakeup() + { + $temp = new static($this->hex, -16); + $this->value = $temp->value; + $this->is_negative = $temp->is_negative; + if ($this->precision > 0) { + // recalculate $this->bitmask + $this->setPrecision($this->precision); + } + } + + /** + * __debugInfo() magic method + * + * Will be called, automatically, when print_r() or var_dump() are called + * + * @access public + */ + function __debugInfo() + { + $opts = array(); + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $engine = 'gmp'; + break; + case self::MODE_BCMATH: + $engine = 'bcmath'; + break; + case self::MODE_INTERNAL: + $engine = 'internal'; + $opts[] = PHP_INT_SIZE == 8 ? '64-bit' : '32-bit'; + } + if (MATH_BIGINTEGER_MODE != self::MODE_GMP && defined('MATH_BIGINTEGER_OPENSSL_ENABLED')) { + $opts[] = 'OpenSSL'; + } + if (!empty($opts)) { + $engine.= ' (' . implode($opts, ', ') . ')'; + } + return array( + 'value' => '0x' . $this->toHex(true), + 'engine' => $engine + ); + } + + /** + * Adds two BigIntegers. + * + * Here's an example: + * + * add($b); + * + * echo $c->toString(); // outputs 30 + * ?> + * + * + * @param \phpseclib\Math\BigInteger $y + * @return \phpseclib\Math\BigInteger + * @access public + * @internal Performs base-2**52 addition + */ + function add($y) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp = new static(); + $temp->value = gmp_add($this->value, $y->value); + + return $this->_normalize($temp); + case self::MODE_BCMATH: + $temp = new static(); + $temp->value = bcadd($this->value, $y->value, 0); + + return $this->_normalize($temp); + } + + $temp = $this->_add($this->value, $this->is_negative, $y->value, $y->is_negative); + + $result = new static(); + $result->value = $temp[self::VALUE]; + $result->is_negative = $temp[self::SIGN]; + + return $this->_normalize($result); + } + + /** + * Performs addition. + * + * @param array $x_value + * @param bool $x_negative + * @param array $y_value + * @param bool $y_negative + * @return array + * @access private + */ + function _add($x_value, $x_negative, $y_value, $y_negative) + { + $x_size = count($x_value); + $y_size = count($y_value); + + if ($x_size == 0) { + return array( + self::VALUE => $y_value, + self::SIGN => $y_negative + ); + } elseif ($y_size == 0) { + return array( + self::VALUE => $x_value, + self::SIGN => $x_negative + ); + } + + // subtract, if appropriate + if ($x_negative != $y_negative) { + if ($x_value == $y_value) { + return array( + self::VALUE => array(), + self::SIGN => false + ); + } + + $temp = $this->_subtract($x_value, false, $y_value, false); + $temp[self::SIGN] = $this->_compare($x_value, false, $y_value, false) > 0 ? + $x_negative : $y_negative; + + return $temp; + } + + if ($x_size < $y_size) { + $size = $x_size; + $value = $y_value; + } else { + $size = $y_size; + $value = $x_value; + } + + $value[count($value)] = 0; // just in case the carry adds an extra digit + + $carry = 0; + for ($i = 0, $j = 1; $j < $size; $i+=2, $j+=2) { + $sum = $x_value[$j] * self::$baseFull + $x_value[$i] + $y_value[$j] * self::$baseFull + $y_value[$i] + $carry; + $carry = $sum >= self::$maxDigit2; // eg. floor($sum / 2**52); only possible values (in any base) are 0 and 1 + $sum = $carry ? $sum - self::$maxDigit2 : $sum; + + $temp = self::$base === 26 ? intval($sum / 0x4000000) : ($sum >> 31); + + $value[$i] = (int) ($sum - self::$baseFull * $temp); // eg. a faster alternative to fmod($sum, 0x4000000) + $value[$j] = $temp; + } + + if ($j == $size) { // ie. if $y_size is odd + $sum = $x_value[$i] + $y_value[$i] + $carry; + $carry = $sum >= self::$baseFull; + $value[$i] = $carry ? $sum - self::$baseFull : $sum; + ++$i; // ie. let $i = $j since we've just done $value[$i] + } + + if ($carry) { + for (; $value[$i] == self::$maxDigit; ++$i) { + $value[$i] = 0; + } + ++$value[$i]; + } + + return array( + self::VALUE => $this->_trim($value), + self::SIGN => $x_negative + ); + } + + /** + * Subtracts two BigIntegers. + * + * Here's an example: + * + * subtract($b); + * + * echo $c->toString(); // outputs -10 + * ?> + * + * + * @param \phpseclib\Math\BigInteger $y + * @return \phpseclib\Math\BigInteger + * @access public + * @internal Performs base-2**52 subtraction + */ + function subtract($y) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp = new static(); + $temp->value = gmp_sub($this->value, $y->value); + + return $this->_normalize($temp); + case self::MODE_BCMATH: + $temp = new static(); + $temp->value = bcsub($this->value, $y->value, 0); + + return $this->_normalize($temp); + } + + $temp = $this->_subtract($this->value, $this->is_negative, $y->value, $y->is_negative); + + $result = new static(); + $result->value = $temp[self::VALUE]; + $result->is_negative = $temp[self::SIGN]; + + return $this->_normalize($result); + } + + /** + * Performs subtraction. + * + * @param array $x_value + * @param bool $x_negative + * @param array $y_value + * @param bool $y_negative + * @return array + * @access private + */ + function _subtract($x_value, $x_negative, $y_value, $y_negative) + { + $x_size = count($x_value); + $y_size = count($y_value); + + if ($x_size == 0) { + return array( + self::VALUE => $y_value, + self::SIGN => !$y_negative + ); + } elseif ($y_size == 0) { + return array( + self::VALUE => $x_value, + self::SIGN => $x_negative + ); + } + + // add, if appropriate (ie. -$x - +$y or +$x - -$y) + if ($x_negative != $y_negative) { + $temp = $this->_add($x_value, false, $y_value, false); + $temp[self::SIGN] = $x_negative; + + return $temp; + } + + $diff = $this->_compare($x_value, $x_negative, $y_value, $y_negative); + + if (!$diff) { + return array( + self::VALUE => array(), + self::SIGN => false + ); + } + + // switch $x and $y around, if appropriate. + if ((!$x_negative && $diff < 0) || ($x_negative && $diff > 0)) { + $temp = $x_value; + $x_value = $y_value; + $y_value = $temp; + + $x_negative = !$x_negative; + + $x_size = count($x_value); + $y_size = count($y_value); + } + + // at this point, $x_value should be at least as big as - if not bigger than - $y_value + + $carry = 0; + for ($i = 0, $j = 1; $j < $y_size; $i+=2, $j+=2) { + $sum = $x_value[$j] * self::$baseFull + $x_value[$i] - $y_value[$j] * self::$baseFull - $y_value[$i] - $carry; + $carry = $sum < 0; // eg. floor($sum / 2**52); only possible values (in any base) are 0 and 1 + $sum = $carry ? $sum + self::$maxDigit2 : $sum; + + $temp = self::$base === 26 ? intval($sum / 0x4000000) : ($sum >> 31); + + $x_value[$i] = (int) ($sum - self::$baseFull * $temp); + $x_value[$j] = $temp; + } + + if ($j == $y_size) { // ie. if $y_size is odd + $sum = $x_value[$i] - $y_value[$i] - $carry; + $carry = $sum < 0; + $x_value[$i] = $carry ? $sum + self::$baseFull : $sum; + ++$i; + } + + if ($carry) { + for (; !$x_value[$i]; ++$i) { + $x_value[$i] = self::$maxDigit; + } + --$x_value[$i]; + } + + return array( + self::VALUE => $this->_trim($x_value), + self::SIGN => $x_negative + ); + } + + /** + * Multiplies two BigIntegers + * + * Here's an example: + * + * multiply($b); + * + * echo $c->toString(); // outputs 200 + * ?> + * + * + * @param \phpseclib\Math\BigInteger $x + * @return \phpseclib\Math\BigInteger + * @access public + */ + function multiply($x) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp = new static(); + $temp->value = gmp_mul($this->value, $x->value); + + return $this->_normalize($temp); + case self::MODE_BCMATH: + $temp = new static(); + $temp->value = bcmul($this->value, $x->value, 0); + + return $this->_normalize($temp); + } + + $temp = $this->_multiply($this->value, $this->is_negative, $x->value, $x->is_negative); + + $product = new static(); + $product->value = $temp[self::VALUE]; + $product->is_negative = $temp[self::SIGN]; + + return $this->_normalize($product); + } + + /** + * Performs multiplication. + * + * @param array $x_value + * @param bool $x_negative + * @param array $y_value + * @param bool $y_negative + * @return array + * @access private + */ + function _multiply($x_value, $x_negative, $y_value, $y_negative) + { + //if ( $x_value == $y_value ) { + // return array( + // self::VALUE => $this->_square($x_value), + // self::SIGN => $x_sign != $y_value + // ); + //} + + $x_length = count($x_value); + $y_length = count($y_value); + + if (!$x_length || !$y_length) { // a 0 is being multiplied + return array( + self::VALUE => array(), + self::SIGN => false + ); + } + + return array( + self::VALUE => min($x_length, $y_length) < 2 * self::KARATSUBA_CUTOFF ? + $this->_trim($this->_regularMultiply($x_value, $y_value)) : + $this->_trim($this->_karatsuba($x_value, $y_value)), + self::SIGN => $x_negative != $y_negative + ); + } + + /** + * Performs long multiplication on two BigIntegers + * + * Modeled after 'multiply' in MutableBigInteger.java. + * + * @param array $x_value + * @param array $y_value + * @return array + * @access private + */ + function _regularMultiply($x_value, $y_value) + { + $x_length = count($x_value); + $y_length = count($y_value); + + if (!$x_length || !$y_length) { // a 0 is being multiplied + return array(); + } + + if ($x_length < $y_length) { + $temp = $x_value; + $x_value = $y_value; + $y_value = $temp; + + $x_length = count($x_value); + $y_length = count($y_value); + } + + $product_value = $this->_array_repeat(0, $x_length + $y_length); + + // the following for loop could be removed if the for loop following it + // (the one with nested for loops) initially set $i to 0, but + // doing so would also make the result in one set of unnecessary adds, + // since on the outermost loops first pass, $product->value[$k] is going + // to always be 0 + + $carry = 0; + + for ($j = 0; $j < $x_length; ++$j) { // ie. $i = 0 + $temp = $x_value[$j] * $y_value[0] + $carry; // $product_value[$k] == 0 + $carry = self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31); + $product_value[$j] = (int) ($temp - self::$baseFull * $carry); + } + + $product_value[$j] = $carry; + + // the above for loop is what the previous comment was talking about. the + // following for loop is the "one with nested for loops" + for ($i = 1; $i < $y_length; ++$i) { + $carry = 0; + + for ($j = 0, $k = $i; $j < $x_length; ++$j, ++$k) { + $temp = $product_value[$k] + $x_value[$j] * $y_value[$i] + $carry; + $carry = self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31); + $product_value[$k] = (int) ($temp - self::$baseFull * $carry); + } + + $product_value[$k] = $carry; + } + + return $product_value; + } + + /** + * Performs Karatsuba multiplication on two BigIntegers + * + * See {@link http://en.wikipedia.org/wiki/Karatsuba_algorithm Karatsuba algorithm} and + * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=120 MPM 5.2.3}. + * + * @param array $x_value + * @param array $y_value + * @return array + * @access private + */ + function _karatsuba($x_value, $y_value) + { + $m = min(count($x_value) >> 1, count($y_value) >> 1); + + if ($m < self::KARATSUBA_CUTOFF) { + return $this->_regularMultiply($x_value, $y_value); + } + + $x1 = array_slice($x_value, $m); + $x0 = array_slice($x_value, 0, $m); + $y1 = array_slice($y_value, $m); + $y0 = array_slice($y_value, 0, $m); + + $z2 = $this->_karatsuba($x1, $y1); + $z0 = $this->_karatsuba($x0, $y0); + + $z1 = $this->_add($x1, false, $x0, false); + $temp = $this->_add($y1, false, $y0, false); + $z1 = $this->_karatsuba($z1[self::VALUE], $temp[self::VALUE]); + $temp = $this->_add($z2, false, $z0, false); + $z1 = $this->_subtract($z1, false, $temp[self::VALUE], false); + + $z2 = array_merge(array_fill(0, 2 * $m, 0), $z2); + $z1[self::VALUE] = array_merge(array_fill(0, $m, 0), $z1[self::VALUE]); + + $xy = $this->_add($z2, false, $z1[self::VALUE], $z1[self::SIGN]); + $xy = $this->_add($xy[self::VALUE], $xy[self::SIGN], $z0, false); + + return $xy[self::VALUE]; + } + + /** + * Performs squaring + * + * @param array $x + * @return array + * @access private + */ + function _square($x = false) + { + return count($x) < 2 * self::KARATSUBA_CUTOFF ? + $this->_trim($this->_baseSquare($x)) : + $this->_trim($this->_karatsubaSquare($x)); + } + + /** + * Performs traditional squaring on two BigIntegers + * + * Squaring can be done faster than multiplying a number by itself can be. See + * {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=7 HAC 14.2.4} / + * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=141 MPM 5.3} for more information. + * + * @param array $value + * @return array + * @access private + */ + function _baseSquare($value) + { + if (empty($value)) { + return array(); + } + $square_value = $this->_array_repeat(0, 2 * count($value)); + + for ($i = 0, $max_index = count($value) - 1; $i <= $max_index; ++$i) { + $i2 = $i << 1; + + $temp = $square_value[$i2] + $value[$i] * $value[$i]; + $carry = self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31); + $square_value[$i2] = (int) ($temp - self::$baseFull * $carry); + + // note how we start from $i+1 instead of 0 as we do in multiplication. + for ($j = $i + 1, $k = $i2 + 1; $j <= $max_index; ++$j, ++$k) { + $temp = $square_value[$k] + 2 * $value[$j] * $value[$i] + $carry; + $carry = self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31); + $square_value[$k] = (int) ($temp - self::$baseFull * $carry); + } + + // the following line can yield values larger 2**15. at this point, PHP should switch + // over to floats. + $square_value[$i + $max_index + 1] = $carry; + } + + return $square_value; + } + + /** + * Performs Karatsuba "squaring" on two BigIntegers + * + * See {@link http://en.wikipedia.org/wiki/Karatsuba_algorithm Karatsuba algorithm} and + * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=151 MPM 5.3.4}. + * + * @param array $value + * @return array + * @access private + */ + function _karatsubaSquare($value) + { + $m = count($value) >> 1; + + if ($m < self::KARATSUBA_CUTOFF) { + return $this->_baseSquare($value); + } + + $x1 = array_slice($value, $m); + $x0 = array_slice($value, 0, $m); + + $z2 = $this->_karatsubaSquare($x1); + $z0 = $this->_karatsubaSquare($x0); + + $z1 = $this->_add($x1, false, $x0, false); + $z1 = $this->_karatsubaSquare($z1[self::VALUE]); + $temp = $this->_add($z2, false, $z0, false); + $z1 = $this->_subtract($z1, false, $temp[self::VALUE], false); + + $z2 = array_merge(array_fill(0, 2 * $m, 0), $z2); + $z1[self::VALUE] = array_merge(array_fill(0, $m, 0), $z1[self::VALUE]); + + $xx = $this->_add($z2, false, $z1[self::VALUE], $z1[self::SIGN]); + $xx = $this->_add($xx[self::VALUE], $xx[self::SIGN], $z0, false); + + return $xx[self::VALUE]; + } + + /** + * Divides two BigIntegers. + * + * Returns an array whose first element contains the quotient and whose second element contains the + * "common residue". If the remainder would be positive, the "common residue" and the remainder are the + * same. If the remainder would be negative, the "common residue" is equal to the sum of the remainder + * and the divisor (basically, the "common residue" is the first positive modulo). + * + * Here's an example: + * + * divide($b); + * + * echo $quotient->toString(); // outputs 0 + * echo "\r\n"; + * echo $remainder->toString(); // outputs 10 + * ?> + * + * + * @param \phpseclib\Math\BigInteger $y + * @return array + * @access public + * @internal This function is based off of {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=9 HAC 14.20}. + */ + function divide($y) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $quotient = new static(); + $remainder = new static(); + + list($quotient->value, $remainder->value) = gmp_div_qr($this->value, $y->value); + + if (gmp_sign($remainder->value) < 0) { + $remainder->value = gmp_add($remainder->value, gmp_abs($y->value)); + } + + return array($this->_normalize($quotient), $this->_normalize($remainder)); + case self::MODE_BCMATH: + $quotient = new static(); + $remainder = new static(); + + $quotient->value = bcdiv($this->value, $y->value, 0); + $remainder->value = bcmod($this->value, $y->value); + + if ($remainder->value[0] == '-') { + $remainder->value = bcadd($remainder->value, $y->value[0] == '-' ? substr($y->value, 1) : $y->value, 0); + } + + return array($this->_normalize($quotient), $this->_normalize($remainder)); + } + + if (count($y->value) == 1) { + list($q, $r) = $this->_divide_digit($this->value, $y->value[0]); + $quotient = new static(); + $remainder = new static(); + $quotient->value = $q; + $remainder->value = array($r); + $quotient->is_negative = $this->is_negative != $y->is_negative; + return array($this->_normalize($quotient), $this->_normalize($remainder)); + } + + static $zero; + if (!isset($zero)) { + $zero = new static(); + } + + $x = $this->copy(); + $y = $y->copy(); + + $x_sign = $x->is_negative; + $y_sign = $y->is_negative; + + $x->is_negative = $y->is_negative = false; + + $diff = $x->compare($y); + + if (!$diff) { + $temp = new static(); + $temp->value = array(1); + $temp->is_negative = $x_sign != $y_sign; + return array($this->_normalize($temp), $this->_normalize(new static())); + } + + if ($diff < 0) { + // if $x is negative, "add" $y. + if ($x_sign) { + $x = $y->subtract($x); + } + return array($this->_normalize(new static()), $this->_normalize($x)); + } + + // normalize $x and $y as described in HAC 14.23 / 14.24 + $msb = $y->value[count($y->value) - 1]; + for ($shift = 0; !($msb & self::$msb); ++$shift) { + $msb <<= 1; + } + $x->_lshift($shift); + $y->_lshift($shift); + $y_value = &$y->value; + + $x_max = count($x->value) - 1; + $y_max = count($y->value) - 1; + + $quotient = new static(); + $quotient_value = &$quotient->value; + $quotient_value = $this->_array_repeat(0, $x_max - $y_max + 1); + + static $temp, $lhs, $rhs; + if (!isset($temp)) { + $temp = new static(); + $lhs = new static(); + $rhs = new static(); + } + $temp_value = &$temp->value; + $rhs_value = &$rhs->value; + + // $temp = $y << ($x_max - $y_max-1) in base 2**26 + $temp_value = array_merge($this->_array_repeat(0, $x_max - $y_max), $y_value); + + while ($x->compare($temp) >= 0) { + // calculate the "common residue" + ++$quotient_value[$x_max - $y_max]; + $x = $x->subtract($temp); + $x_max = count($x->value) - 1; + } + + for ($i = $x_max; $i >= $y_max + 1; --$i) { + $x_value = &$x->value; + $x_window = array( + isset($x_value[$i]) ? $x_value[$i] : 0, + isset($x_value[$i - 1]) ? $x_value[$i - 1] : 0, + isset($x_value[$i - 2]) ? $x_value[$i - 2] : 0 + ); + $y_window = array( + $y_value[$y_max], + ($y_max > 0) ? $y_value[$y_max - 1] : 0 + ); + + $q_index = $i - $y_max - 1; + if ($x_window[0] == $y_window[0]) { + $quotient_value[$q_index] = self::$maxDigit; + } else { + $quotient_value[$q_index] = $this->_safe_divide( + $x_window[0] * self::$baseFull + $x_window[1], + $y_window[0] + ); + } + + $temp_value = array($y_window[1], $y_window[0]); + + $lhs->value = array($quotient_value[$q_index]); + $lhs = $lhs->multiply($temp); + + $rhs_value = array($x_window[2], $x_window[1], $x_window[0]); + + while ($lhs->compare($rhs) > 0) { + --$quotient_value[$q_index]; + + $lhs->value = array($quotient_value[$q_index]); + $lhs = $lhs->multiply($temp); + } + + $adjust = $this->_array_repeat(0, $q_index); + $temp_value = array($quotient_value[$q_index]); + $temp = $temp->multiply($y); + $temp_value = &$temp->value; + $temp_value = array_merge($adjust, $temp_value); + + $x = $x->subtract($temp); + + if ($x->compare($zero) < 0) { + $temp_value = array_merge($adjust, $y_value); + $x = $x->add($temp); + + --$quotient_value[$q_index]; + } + + $x_max = count($x_value) - 1; + } + + // unnormalize the remainder + $x->_rshift($shift); + + $quotient->is_negative = $x_sign != $y_sign; + + // calculate the "common residue", if appropriate + if ($x_sign) { + $y->_rshift($shift); + $x = $y->subtract($x); + } + + return array($this->_normalize($quotient), $this->_normalize($x)); + } + + /** + * Divides a BigInteger by a regular integer + * + * abc / x = a00 / x + b0 / x + c / x + * + * @param array $dividend + * @param array $divisor + * @return array + * @access private + */ + function _divide_digit($dividend, $divisor) + { + $carry = 0; + $result = array(); + + for ($i = count($dividend) - 1; $i >= 0; --$i) { + $temp = self::$baseFull * $carry + $dividend[$i]; + $result[$i] = $this->_safe_divide($temp, $divisor); + $carry = (int) ($temp - $divisor * $result[$i]); + } + + return array($result, $carry); + } + + /** + * Performs modular exponentiation. + * + * Here's an example: + * + * modPow($b, $c); + * + * echo $c->toString(); // outputs 10 + * ?> + * + * + * @param \phpseclib\Math\BigInteger $e + * @param \phpseclib\Math\BigInteger $n + * @return \phpseclib\Math\BigInteger + * @access public + * @internal The most naive approach to modular exponentiation has very unreasonable requirements, and + * and although the approach involving repeated squaring does vastly better, it, too, is impractical + * for our purposes. The reason being that division - by far the most complicated and time-consuming + * of the basic operations (eg. +,-,*,/) - occurs multiple times within it. + * + * Modular reductions resolve this issue. Although an individual modular reduction takes more time + * then an individual division, when performed in succession (with the same modulo), they're a lot faster. + * + * The two most commonly used modular reductions are Barrett and Montgomery reduction. Montgomery reduction, + * although faster, only works when the gcd of the modulo and of the base being used is 1. In RSA, when the + * base is a power of two, the modulo - a product of two primes - is always going to have a gcd of 1 (because + * the product of two odd numbers is odd), but what about when RSA isn't used? + * + * In contrast, Barrett reduction has no such constraint. As such, some bigint implementations perform a + * Barrett reduction after every operation in the modpow function. Others perform Barrett reductions when the + * modulo is even and Montgomery reductions when the modulo is odd. BigInteger.java's modPow method, however, + * uses a trick involving the Chinese Remainder Theorem to factor the even modulo into two numbers - one odd and + * the other, a power of two - and recombine them, later. This is the method that this modPow function uses. + * {@link http://islab.oregonstate.edu/papers/j34monex.pdf Montgomery Reduction with Even Modulus} elaborates. + */ + function modPow($e, $n) + { + $n = $this->bitmask !== false && $this->bitmask->compare($n) < 0 ? $this->bitmask : $n->abs(); + + if ($e->compare(new static()) < 0) { + $e = $e->abs(); + + $temp = $this->modInverse($n); + if ($temp === false) { + return false; + } + + return $this->_normalize($temp->modPow($e, $n)); + } + + if (MATH_BIGINTEGER_MODE == self::MODE_GMP) { + $temp = new static(); + $temp->value = gmp_powm($this->value, $e->value, $n->value); + + return $this->_normalize($temp); + } + + if ($this->compare(new static()) < 0 || $this->compare($n) > 0) { + list(, $temp) = $this->divide($n); + return $temp->modPow($e, $n); + } + + if (defined('MATH_BIGINTEGER_OPENSSL_ENABLED')) { + $components = array( + 'modulus' => $n->toBytes(true), + 'publicExponent' => $e->toBytes(true) + ); + + $components = array( + 'modulus' => pack('Ca*a*', 2, $this->_encodeASN1Length(strlen($components['modulus'])), $components['modulus']), + 'publicExponent' => pack('Ca*a*', 2, $this->_encodeASN1Length(strlen($components['publicExponent'])), $components['publicExponent']) + ); + + $RSAPublicKey = pack( + 'Ca*a*a*', + 48, + $this->_encodeASN1Length(strlen($components['modulus']) + strlen($components['publicExponent'])), + $components['modulus'], + $components['publicExponent'] + ); + + $rsaOID = pack('H*', '300d06092a864886f70d0101010500'); // hex version of MA0GCSqGSIb3DQEBAQUA + $RSAPublicKey = chr(0) . $RSAPublicKey; + $RSAPublicKey = chr(3) . $this->_encodeASN1Length(strlen($RSAPublicKey)) . $RSAPublicKey; + + $encapsulated = pack( + 'Ca*a*', + 48, + $this->_encodeASN1Length(strlen($rsaOID . $RSAPublicKey)), + $rsaOID . $RSAPublicKey + ); + + $RSAPublicKey = "-----BEGIN PUBLIC KEY-----\r\n" . + chunk_split(base64_encode($encapsulated)) . + '-----END PUBLIC KEY-----'; + + $plaintext = str_pad($this->toBytes(), strlen($n->toBytes(true)) - 1, "\0", STR_PAD_LEFT); + + if (openssl_public_encrypt($plaintext, $result, $RSAPublicKey, OPENSSL_NO_PADDING)) { + return new static($result, 256); + } + } + + if (MATH_BIGINTEGER_MODE == self::MODE_BCMATH) { + $temp = new static(); + $temp->value = bcpowmod($this->value, $e->value, $n->value, 0); + + return $this->_normalize($temp); + } + + if (empty($e->value)) { + $temp = new static(); + $temp->value = array(1); + return $this->_normalize($temp); + } + + if ($e->value == array(1)) { + list(, $temp) = $this->divide($n); + return $this->_normalize($temp); + } + + if ($e->value == array(2)) { + $temp = new static(); + $temp->value = $this->_square($this->value); + list(, $temp) = $temp->divide($n); + return $this->_normalize($temp); + } + + return $this->_normalize($this->_slidingWindow($e, $n, self::BARRETT)); + + // the following code, although not callable, can be run independently of the above code + // although the above code performed better in my benchmarks the following could might + // perform better under different circumstances. in lieu of deleting it it's just been + // made uncallable + + // is the modulo odd? + if ($n->value[0] & 1) { + return $this->_normalize($this->_slidingWindow($e, $n, self::MONTGOMERY)); + } + // if it's not, it's even + + // find the lowest set bit (eg. the max pow of 2 that divides $n) + for ($i = 0; $i < count($n->value); ++$i) { + if ($n->value[$i]) { + $temp = decbin($n->value[$i]); + $j = strlen($temp) - strrpos($temp, '1') - 1; + $j+= 26 * $i; + break; + } + } + // at this point, 2^$j * $n/(2^$j) == $n + + $mod1 = $n->copy(); + $mod1->_rshift($j); + $mod2 = new static(); + $mod2->value = array(1); + $mod2->_lshift($j); + + $part1 = ($mod1->value != array(1)) ? $this->_slidingWindow($e, $mod1, self::MONTGOMERY) : new static(); + $part2 = $this->_slidingWindow($e, $mod2, self::POWEROF2); + + $y1 = $mod2->modInverse($mod1); + $y2 = $mod1->modInverse($mod2); + + $result = $part1->multiply($mod2); + $result = $result->multiply($y1); + + $temp = $part2->multiply($mod1); + $temp = $temp->multiply($y2); + + $result = $result->add($temp); + list(, $result) = $result->divide($n); + + return $this->_normalize($result); + } + + /** + * Performs modular exponentiation. + * + * Alias for modPow(). + * + * @param \phpseclib\Math\BigInteger $e + * @param \phpseclib\Math\BigInteger $n + * @return \phpseclib\Math\BigInteger + * @access public + */ + function powMod($e, $n) + { + return $this->modPow($e, $n); + } + + /** + * Sliding Window k-ary Modular Exponentiation + * + * Based on {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=27 HAC 14.85} / + * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=210 MPM 7.7}. In a departure from those algorithims, + * however, this function performs a modular reduction after every multiplication and squaring operation. + * As such, this function has the same preconditions that the reductions being used do. + * + * @param \phpseclib\Math\BigInteger $e + * @param \phpseclib\Math\BigInteger $n + * @param int $mode + * @return \phpseclib\Math\BigInteger + * @access private + */ + function _slidingWindow($e, $n, $mode) + { + static $window_ranges = array(7, 25, 81, 241, 673, 1793); // from BigInteger.java's oddModPow function + //static $window_ranges = array(0, 7, 36, 140, 450, 1303, 3529); // from MPM 7.3.1 + + $e_value = $e->value; + $e_length = count($e_value) - 1; + $e_bits = decbin($e_value[$e_length]); + for ($i = $e_length - 1; $i >= 0; --$i) { + $e_bits.= str_pad(decbin($e_value[$i]), self::$base, '0', STR_PAD_LEFT); + } + + $e_length = strlen($e_bits); + + // calculate the appropriate window size. + // $window_size == 3 if $window_ranges is between 25 and 81, for example. + for ($i = 0, $window_size = 1; $i < count($window_ranges) && $e_length > $window_ranges[$i]; ++$window_size, ++$i) { + } + + $n_value = $n->value; + + // precompute $this^0 through $this^$window_size + $powers = array(); + $powers[1] = $this->_prepareReduce($this->value, $n_value, $mode); + $powers[2] = $this->_squareReduce($powers[1], $n_value, $mode); + + // we do every other number since substr($e_bits, $i, $j+1) (see below) is supposed to end + // in a 1. ie. it's supposed to be odd. + $temp = 1 << ($window_size - 1); + for ($i = 1; $i < $temp; ++$i) { + $i2 = $i << 1; + $powers[$i2 + 1] = $this->_multiplyReduce($powers[$i2 - 1], $powers[2], $n_value, $mode); + } + + $result = array(1); + $result = $this->_prepareReduce($result, $n_value, $mode); + + for ($i = 0; $i < $e_length;) { + if (!$e_bits[$i]) { + $result = $this->_squareReduce($result, $n_value, $mode); + ++$i; + } else { + for ($j = $window_size - 1; $j > 0; --$j) { + if (!empty($e_bits[$i + $j])) { + break; + } + } + + // eg. the length of substr($e_bits, $i, $j + 1) + for ($k = 0; $k <= $j; ++$k) { + $result = $this->_squareReduce($result, $n_value, $mode); + } + + $result = $this->_multiplyReduce($result, $powers[bindec(substr($e_bits, $i, $j + 1))], $n_value, $mode); + + $i += $j + 1; + } + } + + $temp = new static(); + $temp->value = $this->_reduce($result, $n_value, $mode); + + return $temp; + } + + /** + * Modular reduction + * + * For most $modes this will return the remainder. + * + * @see self::_slidingWindow() + * @access private + * @param array $x + * @param array $n + * @param int $mode + * @return array + */ + function _reduce($x, $n, $mode) + { + switch ($mode) { + case self::MONTGOMERY: + return $this->_montgomery($x, $n); + case self::BARRETT: + return $this->_barrett($x, $n); + case self::POWEROF2: + $lhs = new static(); + $lhs->value = $x; + $rhs = new static(); + $rhs->value = $n; + return $x->_mod2($n); + case self::CLASSIC: + $lhs = new static(); + $lhs->value = $x; + $rhs = new static(); + $rhs->value = $n; + list(, $temp) = $lhs->divide($rhs); + return $temp->value; + case self::NONE: + return $x; + default: + // an invalid $mode was provided + } + } + + /** + * Modular reduction preperation + * + * @see self::_slidingWindow() + * @access private + * @param array $x + * @param array $n + * @param int $mode + * @return array + */ + function _prepareReduce($x, $n, $mode) + { + if ($mode == self::MONTGOMERY) { + return $this->_prepMontgomery($x, $n); + } + return $this->_reduce($x, $n, $mode); + } + + /** + * Modular multiply + * + * @see self::_slidingWindow() + * @access private + * @param array $x + * @param array $y + * @param array $n + * @param int $mode + * @return array + */ + function _multiplyReduce($x, $y, $n, $mode) + { + if ($mode == self::MONTGOMERY) { + return $this->_montgomeryMultiply($x, $y, $n); + } + $temp = $this->_multiply($x, false, $y, false); + return $this->_reduce($temp[self::VALUE], $n, $mode); + } + + /** + * Modular square + * + * @see self::_slidingWindow() + * @access private + * @param array $x + * @param array $n + * @param int $mode + * @return array + */ + function _squareReduce($x, $n, $mode) + { + if ($mode == self::MONTGOMERY) { + return $this->_montgomeryMultiply($x, $x, $n); + } + return $this->_reduce($this->_square($x), $n, $mode); + } + + /** + * Modulos for Powers of Two + * + * Calculates $x%$n, where $n = 2**$e, for some $e. Since this is basically the same as doing $x & ($n-1), + * we'll just use this function as a wrapper for doing that. + * + * @see self::_slidingWindow() + * @access private + * @param \phpseclib\Math\BigInteger + * @return \phpseclib\Math\BigInteger + */ + function _mod2($n) + { + $temp = new static(); + $temp->value = array(1); + return $this->bitwise_and($n->subtract($temp)); + } + + /** + * Barrett Modular Reduction + * + * See {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=14 HAC 14.3.3} / + * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=165 MPM 6.2.5} for more information. Modified slightly, + * so as not to require negative numbers (initially, this script didn't support negative numbers). + * + * Employs "folding", as described at + * {@link http://www.cosic.esat.kuleuven.be/publications/thesis-149.pdf#page=66 thesis-149.pdf#page=66}. To quote from + * it, "the idea [behind folding] is to find a value x' such that x (mod m) = x' (mod m), with x' being smaller than x." + * + * Unfortunately, the "Barrett Reduction with Folding" algorithm described in thesis-149.pdf is not, as written, all that + * usable on account of (1) its not using reasonable radix points as discussed in + * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=162 MPM 6.2.2} and (2) the fact that, even with reasonable + * radix points, it only works when there are an even number of digits in the denominator. The reason for (2) is that + * (x >> 1) + (x >> 1) != x / 2 + x / 2. If x is even, they're the same, but if x is odd, they're not. See the in-line + * comments for details. + * + * @see self::_slidingWindow() + * @access private + * @param array $n + * @param array $m + * @return array + */ + function _barrett($n, $m) + { + static $cache = array( + self::VARIABLE => array(), + self::DATA => array() + ); + + $m_length = count($m); + + // if ($this->_compare($n, $this->_square($m)) >= 0) { + if (count($n) > 2 * $m_length) { + $lhs = new static(); + $rhs = new static(); + $lhs->value = $n; + $rhs->value = $m; + list(, $temp) = $lhs->divide($rhs); + return $temp->value; + } + + // if (m.length >> 1) + 2 <= m.length then m is too small and n can't be reduced + if ($m_length < 5) { + return $this->_regularBarrett($n, $m); + } + + // n = 2 * m.length + + if (($key = array_search($m, $cache[self::VARIABLE])) === false) { + $key = count($cache[self::VARIABLE]); + $cache[self::VARIABLE][] = $m; + + $lhs = new static(); + $lhs_value = &$lhs->value; + $lhs_value = $this->_array_repeat(0, $m_length + ($m_length >> 1)); + $lhs_value[] = 1; + $rhs = new static(); + $rhs->value = $m; + + list($u, $m1) = $lhs->divide($rhs); + $u = $u->value; + $m1 = $m1->value; + + $cache[self::DATA][] = array( + 'u' => $u, // m.length >> 1 (technically (m.length >> 1) + 1) + 'm1'=> $m1 // m.length + ); + } else { + extract($cache[self::DATA][$key]); + } + + $cutoff = $m_length + ($m_length >> 1); + $lsd = array_slice($n, 0, $cutoff); // m.length + (m.length >> 1) + $msd = array_slice($n, $cutoff); // m.length >> 1 + $lsd = $this->_trim($lsd); + $temp = $this->_multiply($msd, false, $m1, false); + $n = $this->_add($lsd, false, $temp[self::VALUE], false); // m.length + (m.length >> 1) + 1 + + if ($m_length & 1) { + return $this->_regularBarrett($n[self::VALUE], $m); + } + + // (m.length + (m.length >> 1) + 1) - (m.length - 1) == (m.length >> 1) + 2 + $temp = array_slice($n[self::VALUE], $m_length - 1); + // if even: ((m.length >> 1) + 2) + (m.length >> 1) == m.length + 2 + // if odd: ((m.length >> 1) + 2) + (m.length >> 1) == (m.length - 1) + 2 == m.length + 1 + $temp = $this->_multiply($temp, false, $u, false); + // if even: (m.length + 2) - ((m.length >> 1) + 1) = m.length - (m.length >> 1) + 1 + // if odd: (m.length + 1) - ((m.length >> 1) + 1) = m.length - (m.length >> 1) + $temp = array_slice($temp[self::VALUE], ($m_length >> 1) + 1); + // if even: (m.length - (m.length >> 1) + 1) + m.length = 2 * m.length - (m.length >> 1) + 1 + // if odd: (m.length - (m.length >> 1)) + m.length = 2 * m.length - (m.length >> 1) + $temp = $this->_multiply($temp, false, $m, false); + + // at this point, if m had an odd number of digits, we'd be subtracting a 2 * m.length - (m.length >> 1) digit + // number from a m.length + (m.length >> 1) + 1 digit number. ie. there'd be an extra digit and the while loop + // following this comment would loop a lot (hence our calling _regularBarrett() in that situation). + + $result = $this->_subtract($n[self::VALUE], false, $temp[self::VALUE], false); + + while ($this->_compare($result[self::VALUE], $result[self::SIGN], $m, false) >= 0) { + $result = $this->_subtract($result[self::VALUE], $result[self::SIGN], $m, false); + } + + return $result[self::VALUE]; + } + + /** + * (Regular) Barrett Modular Reduction + * + * For numbers with more than four digits BigInteger::_barrett() is faster. The difference between that and this + * is that this function does not fold the denominator into a smaller form. + * + * @see self::_slidingWindow() + * @access private + * @param array $x + * @param array $n + * @return array + */ + function _regularBarrett($x, $n) + { + static $cache = array( + self::VARIABLE => array(), + self::DATA => array() + ); + + $n_length = count($n); + + if (count($x) > 2 * $n_length) { + $lhs = new static(); + $rhs = new static(); + $lhs->value = $x; + $rhs->value = $n; + list(, $temp) = $lhs->divide($rhs); + return $temp->value; + } + + if (($key = array_search($n, $cache[self::VARIABLE])) === false) { + $key = count($cache[self::VARIABLE]); + $cache[self::VARIABLE][] = $n; + $lhs = new static(); + $lhs_value = &$lhs->value; + $lhs_value = $this->_array_repeat(0, 2 * $n_length); + $lhs_value[] = 1; + $rhs = new static(); + $rhs->value = $n; + list($temp, ) = $lhs->divide($rhs); // m.length + $cache[self::DATA][] = $temp->value; + } + + // 2 * m.length - (m.length - 1) = m.length + 1 + $temp = array_slice($x, $n_length - 1); + // (m.length + 1) + m.length = 2 * m.length + 1 + $temp = $this->_multiply($temp, false, $cache[self::DATA][$key], false); + // (2 * m.length + 1) - (m.length - 1) = m.length + 2 + $temp = array_slice($temp[self::VALUE], $n_length + 1); + + // m.length + 1 + $result = array_slice($x, 0, $n_length + 1); + // m.length + 1 + $temp = $this->_multiplyLower($temp, false, $n, false, $n_length + 1); + // $temp == array_slice($temp->_multiply($temp, false, $n, false)->value, 0, $n_length + 1) + + if ($this->_compare($result, false, $temp[self::VALUE], $temp[self::SIGN]) < 0) { + $corrector_value = $this->_array_repeat(0, $n_length + 1); + $corrector_value[count($corrector_value)] = 1; + $result = $this->_add($result, false, $corrector_value, false); + $result = $result[self::VALUE]; + } + + // at this point, we're subtracting a number with m.length + 1 digits from another number with m.length + 1 digits + $result = $this->_subtract($result, false, $temp[self::VALUE], $temp[self::SIGN]); + while ($this->_compare($result[self::VALUE], $result[self::SIGN], $n, false) > 0) { + $result = $this->_subtract($result[self::VALUE], $result[self::SIGN], $n, false); + } + + return $result[self::VALUE]; + } + + /** + * Performs long multiplication up to $stop digits + * + * If you're going to be doing array_slice($product->value, 0, $stop), some cycles can be saved. + * + * @see self::_regularBarrett() + * @param array $x_value + * @param bool $x_negative + * @param array $y_value + * @param bool $y_negative + * @param int $stop + * @return array + * @access private + */ + function _multiplyLower($x_value, $x_negative, $y_value, $y_negative, $stop) + { + $x_length = count($x_value); + $y_length = count($y_value); + + if (!$x_length || !$y_length) { // a 0 is being multiplied + return array( + self::VALUE => array(), + self::SIGN => false + ); + } + + if ($x_length < $y_length) { + $temp = $x_value; + $x_value = $y_value; + $y_value = $temp; + + $x_length = count($x_value); + $y_length = count($y_value); + } + + $product_value = $this->_array_repeat(0, $x_length + $y_length); + + // the following for loop could be removed if the for loop following it + // (the one with nested for loops) initially set $i to 0, but + // doing so would also make the result in one set of unnecessary adds, + // since on the outermost loops first pass, $product->value[$k] is going + // to always be 0 + + $carry = 0; + + for ($j = 0; $j < $x_length; ++$j) { // ie. $i = 0, $k = $i + $temp = $x_value[$j] * $y_value[0] + $carry; // $product_value[$k] == 0 + $carry = self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31); + $product_value[$j] = (int) ($temp - self::$baseFull * $carry); + } + + if ($j < $stop) { + $product_value[$j] = $carry; + } + + // the above for loop is what the previous comment was talking about. the + // following for loop is the "one with nested for loops" + + for ($i = 1; $i < $y_length; ++$i) { + $carry = 0; + + for ($j = 0, $k = $i; $j < $x_length && $k < $stop; ++$j, ++$k) { + $temp = $product_value[$k] + $x_value[$j] * $y_value[$i] + $carry; + $carry = self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31); + $product_value[$k] = (int) ($temp - self::$baseFull * $carry); + } + + if ($k < $stop) { + $product_value[$k] = $carry; + } + } + + return array( + self::VALUE => $this->_trim($product_value), + self::SIGN => $x_negative != $y_negative + ); + } + + /** + * Montgomery Modular Reduction + * + * ($x->_prepMontgomery($n))->_montgomery($n) yields $x % $n. + * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=170 MPM 6.3} provides insights on how this can be + * improved upon (basically, by using the comba method). gcd($n, 2) must be equal to one for this function + * to work correctly. + * + * @see self::_prepMontgomery() + * @see self::_slidingWindow() + * @access private + * @param array $x + * @param array $n + * @return array + */ + function _montgomery($x, $n) + { + static $cache = array( + self::VARIABLE => array(), + self::DATA => array() + ); + + if (($key = array_search($n, $cache[self::VARIABLE])) === false) { + $key = count($cache[self::VARIABLE]); + $cache[self::VARIABLE][] = $x; + $cache[self::DATA][] = $this->_modInverse67108864($n); + } + + $k = count($n); + + $result = array(self::VALUE => $x); + + for ($i = 0; $i < $k; ++$i) { + $temp = $result[self::VALUE][$i] * $cache[self::DATA][$key]; + $temp = $temp - self::$baseFull * (self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31)); + $temp = $this->_regularMultiply(array($temp), $n); + $temp = array_merge($this->_array_repeat(0, $i), $temp); + $result = $this->_add($result[self::VALUE], false, $temp, false); + } + + $result[self::VALUE] = array_slice($result[self::VALUE], $k); + + if ($this->_compare($result, false, $n, false) >= 0) { + $result = $this->_subtract($result[self::VALUE], false, $n, false); + } + + return $result[self::VALUE]; + } + + /** + * Montgomery Multiply + * + * Interleaves the montgomery reduction and long multiplication algorithms together as described in + * {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=13 HAC 14.36} + * + * @see self::_prepMontgomery() + * @see self::_montgomery() + * @access private + * @param array $x + * @param array $y + * @param array $m + * @return array + */ + function _montgomeryMultiply($x, $y, $m) + { + $temp = $this->_multiply($x, false, $y, false); + return $this->_montgomery($temp[self::VALUE], $m); + + // the following code, although not callable, can be run independently of the above code + // although the above code performed better in my benchmarks the following could might + // perform better under different circumstances. in lieu of deleting it it's just been + // made uncallable + + static $cache = array( + self::VARIABLE => array(), + self::DATA => array() + ); + + if (($key = array_search($m, $cache[self::VARIABLE])) === false) { + $key = count($cache[self::VARIABLE]); + $cache[self::VARIABLE][] = $m; + $cache[self::DATA][] = $this->_modInverse67108864($m); + } + + $n = max(count($x), count($y), count($m)); + $x = array_pad($x, $n, 0); + $y = array_pad($y, $n, 0); + $m = array_pad($m, $n, 0); + $a = array(self::VALUE => $this->_array_repeat(0, $n + 1)); + for ($i = 0; $i < $n; ++$i) { + $temp = $a[self::VALUE][0] + $x[$i] * $y[0]; + $temp = $temp - self::$baseFull * (self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31)); + $temp = $temp * $cache[self::DATA][$key]; + $temp = $temp - self::$baseFull * (self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31)); + $temp = $this->_add($this->_regularMultiply(array($x[$i]), $y), false, $this->_regularMultiply(array($temp), $m), false); + $a = $this->_add($a[self::VALUE], false, $temp[self::VALUE], false); + $a[self::VALUE] = array_slice($a[self::VALUE], 1); + } + if ($this->_compare($a[self::VALUE], false, $m, false) >= 0) { + $a = $this->_subtract($a[self::VALUE], false, $m, false); + } + return $a[self::VALUE]; + } + + /** + * Prepare a number for use in Montgomery Modular Reductions + * + * @see self::_montgomery() + * @see self::_slidingWindow() + * @access private + * @param array $x + * @param array $n + * @return array + */ + function _prepMontgomery($x, $n) + { + $lhs = new static(); + $lhs->value = array_merge($this->_array_repeat(0, count($n)), $x); + $rhs = new static(); + $rhs->value = $n; + + list(, $temp) = $lhs->divide($rhs); + return $temp->value; + } + + /** + * Modular Inverse of a number mod 2**26 (eg. 67108864) + * + * Based off of the bnpInvDigit function implemented and justified in the following URL: + * + * {@link http://www-cs-students.stanford.edu/~tjw/jsbn/jsbn.js} + * + * The following URL provides more info: + * + * {@link http://groups.google.com/group/sci.crypt/msg/7a137205c1be7d85} + * + * As for why we do all the bitmasking... strange things can happen when converting from floats to ints. For + * instance, on some computers, var_dump((int) -4294967297) yields int(-1) and on others, it yields + * int(-2147483648). To avoid problems stemming from this, we use bitmasks to guarantee that ints aren't + * auto-converted to floats. The outermost bitmask is present because without it, there's no guarantee that + * the "residue" returned would be the so-called "common residue". We use fmod, in the last step, because the + * maximum possible $x is 26 bits and the maximum $result is 16 bits. Thus, we have to be able to handle up to + * 40 bits, which only 64-bit floating points will support. + * + * Thanks to Pedro Gimeno Fortea for input! + * + * @see self::_montgomery() + * @access private + * @param array $x + * @return int + */ + function _modInverse67108864($x) // 2**26 == 67,108,864 + { + $x = -$x[0]; + $result = $x & 0x3; // x**-1 mod 2**2 + $result = ($result * (2 - $x * $result)) & 0xF; // x**-1 mod 2**4 + $result = ($result * (2 - ($x & 0xFF) * $result)) & 0xFF; // x**-1 mod 2**8 + $result = ($result * ((2 - ($x & 0xFFFF) * $result) & 0xFFFF)) & 0xFFFF; // x**-1 mod 2**16 + $result = fmod($result * (2 - fmod($x * $result, self::$baseFull)), self::$baseFull); // x**-1 mod 2**26 + return $result & self::$maxDigit; + } + + /** + * Calculates modular inverses. + * + * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. + * + * Here's an example: + * + * modInverse($b); + * echo $c->toString(); // outputs 4 + * + * echo "\r\n"; + * + * $d = $a->multiply($c); + * list(, $d) = $d->divide($b); + * echo $d; // outputs 1 (as per the definition of modular inverse) + * ?> + * + * + * @param \phpseclib\Math\BigInteger $n + * @return \phpseclib\Math\BigInteger|false + * @access public + * @internal See {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=21 HAC 14.64} for more information. + */ + function modInverse($n) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp = new static(); + $temp->value = gmp_invert($this->value, $n->value); + + return ($temp->value === false) ? false : $this->_normalize($temp); + } + + static $zero, $one; + if (!isset($zero)) { + $zero = new static(); + $one = new static(1); + } + + // $x mod -$n == $x mod $n. + $n = $n->abs(); + + if ($this->compare($zero) < 0) { + $temp = $this->abs(); + $temp = $temp->modInverse($n); + return $this->_normalize($n->subtract($temp)); + } + + extract($this->extendedGCD($n)); + + if (!$gcd->equals($one)) { + return false; + } + + $x = $x->compare($zero) < 0 ? $x->add($n) : $x; + + return $this->compare($zero) < 0 ? $this->_normalize($n->subtract($x)) : $this->_normalize($x); + } + + /** + * Calculates the greatest common divisor and Bezout's identity. + * + * Say you have 693 and 609. The GCD is 21. Bezout's identity states that there exist integers x and y such that + * 693*x + 609*y == 21. In point of fact, there are actually an infinite number of x and y combinations and which + * combination is returned is dependent upon which mode is in use. See + * {@link http://en.wikipedia.org/wiki/B%C3%A9zout%27s_identity Bezout's identity - Wikipedia} for more information. + * + * Here's an example: + * + * extendedGCD($b)); + * + * echo $gcd->toString() . "\r\n"; // outputs 21 + * echo $a->toString() * $x->toString() + $b->toString() * $y->toString(); // outputs 21 + * ?> + * + * + * @param \phpseclib\Math\BigInteger $n + * @return \phpseclib\Math\BigInteger + * @access public + * @internal Calculates the GCD using the binary xGCD algorithim described in + * {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=19 HAC 14.61}. As the text above 14.61 notes, + * the more traditional algorithim requires "relatively costly multiple-precision divisions". + */ + function extendedGCD($n) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + extract(gmp_gcdext($this->value, $n->value)); + + return array( + 'gcd' => $this->_normalize(new static($g)), + 'x' => $this->_normalize(new static($s)), + 'y' => $this->_normalize(new static($t)) + ); + case self::MODE_BCMATH: + // it might be faster to use the binary xGCD algorithim here, as well, but (1) that algorithim works + // best when the base is a power of 2 and (2) i don't think it'd make much difference, anyway. as is, + // the basic extended euclidean algorithim is what we're using. + + $u = $this->value; + $v = $n->value; + + $a = '1'; + $b = '0'; + $c = '0'; + $d = '1'; + + while (bccomp($v, '0', 0) != 0) { + $q = bcdiv($u, $v, 0); + + $temp = $u; + $u = $v; + $v = bcsub($temp, bcmul($v, $q, 0), 0); + + $temp = $a; + $a = $c; + $c = bcsub($temp, bcmul($a, $q, 0), 0); + + $temp = $b; + $b = $d; + $d = bcsub($temp, bcmul($b, $q, 0), 0); + } + + return array( + 'gcd' => $this->_normalize(new static($u)), + 'x' => $this->_normalize(new static($a)), + 'y' => $this->_normalize(new static($b)) + ); + } + + $y = $n->copy(); + $x = $this->copy(); + $g = new static(); + $g->value = array(1); + + while (!(($x->value[0] & 1)|| ($y->value[0] & 1))) { + $x->_rshift(1); + $y->_rshift(1); + $g->_lshift(1); + } + + $u = $x->copy(); + $v = $y->copy(); + + $a = new static(); + $b = new static(); + $c = new static(); + $d = new static(); + + $a->value = $d->value = $g->value = array(1); + $b->value = $c->value = array(); + + while (!empty($u->value)) { + while (!($u->value[0] & 1)) { + $u->_rshift(1); + if ((!empty($a->value) && ($a->value[0] & 1)) || (!empty($b->value) && ($b->value[0] & 1))) { + $a = $a->add($y); + $b = $b->subtract($x); + } + $a->_rshift(1); + $b->_rshift(1); + } + + while (!($v->value[0] & 1)) { + $v->_rshift(1); + if ((!empty($d->value) && ($d->value[0] & 1)) || (!empty($c->value) && ($c->value[0] & 1))) { + $c = $c->add($y); + $d = $d->subtract($x); + } + $c->_rshift(1); + $d->_rshift(1); + } + + if ($u->compare($v) >= 0) { + $u = $u->subtract($v); + $a = $a->subtract($c); + $b = $b->subtract($d); + } else { + $v = $v->subtract($u); + $c = $c->subtract($a); + $d = $d->subtract($b); + } + } + + return array( + 'gcd' => $this->_normalize($g->multiply($v)), + 'x' => $this->_normalize($c), + 'y' => $this->_normalize($d) + ); + } + + /** + * Calculates the greatest common divisor + * + * Say you have 693 and 609. The GCD is 21. + * + * Here's an example: + * + * extendedGCD($b); + * + * echo $gcd->toString() . "\r\n"; // outputs 21 + * ?> + * + * + * @param \phpseclib\Math\BigInteger $n + * @return \phpseclib\Math\BigInteger + * @access public + */ + function gcd($n) + { + extract($this->extendedGCD($n)); + return $gcd; + } + + /** + * Absolute value. + * + * @return \phpseclib\Math\BigInteger + * @access public + */ + function abs() + { + $temp = new static(); + + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp->value = gmp_abs($this->value); + break; + case self::MODE_BCMATH: + $temp->value = (bccomp($this->value, '0', 0) < 0) ? substr($this->value, 1) : $this->value; + break; + default: + $temp->value = $this->value; + } + + return $temp; + } + + /** + * Compares two numbers. + * + * Although one might think !$x->compare($y) means $x != $y, it, in fact, means the opposite. The reason for this is + * demonstrated thusly: + * + * $x > $y: $x->compare($y) > 0 + * $x < $y: $x->compare($y) < 0 + * $x == $y: $x->compare($y) == 0 + * + * Note how the same comparison operator is used. If you want to test for equality, use $x->equals($y). + * + * @param \phpseclib\Math\BigInteger $y + * @return int < 0 if $this is less than $y; > 0 if $this is greater than $y, and 0 if they are equal. + * @access public + * @see self::equals() + * @internal Could return $this->subtract($x), but that's not as fast as what we do do. + */ + function compare($y) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + return gmp_cmp($this->value, $y->value); + case self::MODE_BCMATH: + return bccomp($this->value, $y->value, 0); + } + + return $this->_compare($this->value, $this->is_negative, $y->value, $y->is_negative); + } + + /** + * Compares two numbers. + * + * @param array $x_value + * @param bool $x_negative + * @param array $y_value + * @param bool $y_negative + * @return int + * @see self::compare() + * @access private + */ + function _compare($x_value, $x_negative, $y_value, $y_negative) + { + if ($x_negative != $y_negative) { + return (!$x_negative && $y_negative) ? 1 : -1; + } + + $result = $x_negative ? -1 : 1; + + if (count($x_value) != count($y_value)) { + return (count($x_value) > count($y_value)) ? $result : -$result; + } + $size = max(count($x_value), count($y_value)); + + $x_value = array_pad($x_value, $size, 0); + $y_value = array_pad($y_value, $size, 0); + + for ($i = count($x_value) - 1; $i >= 0; --$i) { + if ($x_value[$i] != $y_value[$i]) { + return ($x_value[$i] > $y_value[$i]) ? $result : -$result; + } + } + + return 0; + } + + /** + * Tests the equality of two numbers. + * + * If you need to see if one number is greater than or less than another number, use BigInteger::compare() + * + * @param \phpseclib\Math\BigInteger $x + * @return bool + * @access public + * @see self::compare() + */ + function equals($x) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + return gmp_cmp($this->value, $x->value) == 0; + default: + return $this->value === $x->value && $this->is_negative == $x->is_negative; + } + } + + /** + * Set Precision + * + * Some bitwise operations give different results depending on the precision being used. Examples include left + * shift, not, and rotates. + * + * @param int $bits + * @access public + */ + function setPrecision($bits) + { + $this->precision = $bits; + if (MATH_BIGINTEGER_MODE != self::MODE_BCMATH) { + $this->bitmask = new static(chr((1 << ($bits & 0x7)) - 1) . str_repeat(chr(0xFF), $bits >> 3), 256); + } else { + $this->bitmask = new static(bcpow('2', $bits, 0)); + } + + $temp = $this->_normalize($this); + $this->value = $temp->value; + } + + /** + * Logical And + * + * @param \phpseclib\Math\BigInteger $x + * @access public + * @internal Implemented per a request by Lluis Pamies i Juarez + * @return \phpseclib\Math\BigInteger + */ + function bitwise_and($x) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp = new static(); + $temp->value = gmp_and($this->value, $x->value); + + return $this->_normalize($temp); + case self::MODE_BCMATH: + $left = $this->toBytes(); + $right = $x->toBytes(); + + $length = max(strlen($left), strlen($right)); + + $left = str_pad($left, $length, chr(0), STR_PAD_LEFT); + $right = str_pad($right, $length, chr(0), STR_PAD_LEFT); + + return $this->_normalize(new static($left & $right, 256)); + } + + $result = $this->copy(); + + $length = min(count($x->value), count($this->value)); + + $result->value = array_slice($result->value, 0, $length); + + for ($i = 0; $i < $length; ++$i) { + $result->value[$i]&= $x->value[$i]; + } + + return $this->_normalize($result); + } + + /** + * Logical Or + * + * @param \phpseclib\Math\BigInteger $x + * @access public + * @internal Implemented per a request by Lluis Pamies i Juarez + * @return \phpseclib\Math\BigInteger + */ + function bitwise_or($x) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp = new static(); + $temp->value = gmp_or($this->value, $x->value); + + return $this->_normalize($temp); + case self::MODE_BCMATH: + $left = $this->toBytes(); + $right = $x->toBytes(); + + $length = max(strlen($left), strlen($right)); + + $left = str_pad($left, $length, chr(0), STR_PAD_LEFT); + $right = str_pad($right, $length, chr(0), STR_PAD_LEFT); + + return $this->_normalize(new static($left | $right, 256)); + } + + $length = max(count($this->value), count($x->value)); + $result = $this->copy(); + $result->value = array_pad($result->value, $length, 0); + $x->value = array_pad($x->value, $length, 0); + + for ($i = 0; $i < $length; ++$i) { + $result->value[$i]|= $x->value[$i]; + } + + return $this->_normalize($result); + } + + /** + * Logical Exclusive-Or + * + * @param \phpseclib\Math\BigInteger $x + * @access public + * @internal Implemented per a request by Lluis Pamies i Juarez + * @return \phpseclib\Math\BigInteger + */ + function bitwise_xor($x) + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + $temp = new static(); + $temp->value = gmp_xor(gmp_abs($this->value), gmp_abs($x->value)); + return $this->_normalize($temp); + case self::MODE_BCMATH: + $left = $this->toBytes(); + $right = $x->toBytes(); + + $length = max(strlen($left), strlen($right)); + + $left = str_pad($left, $length, chr(0), STR_PAD_LEFT); + $right = str_pad($right, $length, chr(0), STR_PAD_LEFT); + + return $this->_normalize(new static($left ^ $right, 256)); + } + + $length = max(count($this->value), count($x->value)); + $result = $this->copy(); + $result->is_negative = false; + $result->value = array_pad($result->value, $length, 0); + $x->value = array_pad($x->value, $length, 0); + + for ($i = 0; $i < $length; ++$i) { + $result->value[$i]^= $x->value[$i]; + } + + return $this->_normalize($result); + } + + /** + * Logical Not + * + * @access public + * @internal Implemented per a request by Lluis Pamies i Juarez + * @return \phpseclib\Math\BigInteger + */ + function bitwise_not() + { + // calculuate "not" without regard to $this->precision + // (will always result in a smaller number. ie. ~1 isn't 1111 1110 - it's 0) + $temp = $this->toBytes(); + if ($temp == '') { + return $this->_normalize(new static()); + } + $pre_msb = decbin(ord($temp[0])); + $temp = ~$temp; + $msb = decbin(ord($temp[0])); + if (strlen($msb) == 8) { + $msb = substr($msb, strpos($msb, '0')); + } + $temp[0] = chr(bindec($msb)); + + // see if we need to add extra leading 1's + $current_bits = strlen($pre_msb) + 8 * strlen($temp) - 8; + $new_bits = $this->precision - $current_bits; + if ($new_bits <= 0) { + return $this->_normalize(new static($temp, 256)); + } + + // generate as many leading 1's as we need to. + $leading_ones = chr((1 << ($new_bits & 0x7)) - 1) . str_repeat(chr(0xFF), $new_bits >> 3); + $this->_base256_lshift($leading_ones, $current_bits); + + $temp = str_pad($temp, strlen($leading_ones), chr(0), STR_PAD_LEFT); + + return $this->_normalize(new static($leading_ones | $temp, 256)); + } + + /** + * Logical Right Shift + * + * Shifts BigInteger's by $shift bits, effectively dividing by 2**$shift. + * + * @param int $shift + * @return \phpseclib\Math\BigInteger + * @access public + * @internal The only version that yields any speed increases is the internal version. + */ + function bitwise_rightShift($shift) + { + $temp = new static(); + + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + static $two; + + if (!isset($two)) { + $two = gmp_init('2'); + } + + $temp->value = gmp_div_q($this->value, gmp_pow($two, $shift)); + + break; + case self::MODE_BCMATH: + $temp->value = bcdiv($this->value, bcpow('2', $shift, 0), 0); + + break; + default: // could just replace _lshift with this, but then all _lshift() calls would need to be rewritten + // and I don't want to do that... + $temp->value = $this->value; + $temp->_rshift($shift); + } + + return $this->_normalize($temp); + } + + /** + * Logical Left Shift + * + * Shifts BigInteger's by $shift bits, effectively multiplying by 2**$shift. + * + * @param int $shift + * @return \phpseclib\Math\BigInteger + * @access public + * @internal The only version that yields any speed increases is the internal version. + */ + function bitwise_leftShift($shift) + { + $temp = new static(); + + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + static $two; + + if (!isset($two)) { + $two = gmp_init('2'); + } + + $temp->value = gmp_mul($this->value, gmp_pow($two, $shift)); + + break; + case self::MODE_BCMATH: + $temp->value = bcmul($this->value, bcpow('2', $shift, 0), 0); + + break; + default: // could just replace _rshift with this, but then all _lshift() calls would need to be rewritten + // and I don't want to do that... + $temp->value = $this->value; + $temp->_lshift($shift); + } + + return $this->_normalize($temp); + } + + /** + * Logical Left Rotate + * + * Instead of the top x bits being dropped they're appended to the shifted bit string. + * + * @param int $shift + * @return \phpseclib\Math\BigInteger + * @access public + */ + function bitwise_leftRotate($shift) + { + $bits = $this->toBytes(); + + if ($this->precision > 0) { + $precision = $this->precision; + if (MATH_BIGINTEGER_MODE == self::MODE_BCMATH) { + $mask = $this->bitmask->subtract(new static(1)); + $mask = $mask->toBytes(); + } else { + $mask = $this->bitmask->toBytes(); + } + } else { + $temp = ord($bits[0]); + for ($i = 0; $temp >> $i; ++$i) { + } + $precision = 8 * strlen($bits) - 8 + $i; + $mask = chr((1 << ($precision & 0x7)) - 1) . str_repeat(chr(0xFF), $precision >> 3); + } + + if ($shift < 0) { + $shift+= $precision; + } + $shift%= $precision; + + if (!$shift) { + return $this->copy(); + } + + $left = $this->bitwise_leftShift($shift); + $left = $left->bitwise_and(new static($mask, 256)); + $right = $this->bitwise_rightShift($precision - $shift); + $result = MATH_BIGINTEGER_MODE != self::MODE_BCMATH ? $left->bitwise_or($right) : $left->add($right); + return $this->_normalize($result); + } + + /** + * Logical Right Rotate + * + * Instead of the bottom x bits being dropped they're prepended to the shifted bit string. + * + * @param int $shift + * @return \phpseclib\Math\BigInteger + * @access public + */ + function bitwise_rightRotate($shift) + { + return $this->bitwise_leftRotate(-$shift); + } + + /** + * Generates a random BigInteger + * + * Byte length is equal to $length. Uses \phpseclib\Crypt\Random if it's loaded and mt_rand if it's not. + * + * @param int $length + * @return \phpseclib\Math\BigInteger + * @access private + */ + function _random_number_helper($size) + { + if (class_exists('\phpseclib\Crypt\Random')) { + $random = Random::string($size); + } else { + $random = ''; + + if ($size & 1) { + $random.= chr(mt_rand(0, 255)); + } + + $blocks = $size >> 1; + for ($i = 0; $i < $blocks; ++$i) { + // mt_rand(-2147483648, 0x7FFFFFFF) always produces -2147483648 on some systems + $random.= pack('n', mt_rand(0, 0xFFFF)); + } + } + + return new static($random, 256); + } + + /** + * Generate a random number + * + * Returns a random number between $min and $max where $min and $max + * can be defined using one of the two methods: + * + * $min->random($max) + * $max->random($min) + * + * @param \phpseclib\Math\BigInteger $arg1 + * @param \phpseclib\Math\BigInteger $arg2 + * @return \phpseclib\Math\BigInteger + * @access public + * @internal The API for creating random numbers used to be $a->random($min, $max), where $a was a BigInteger object. + * That method is still supported for BC purposes. + */ + function random($arg1, $arg2 = false) + { + if ($arg1 === false) { + return false; + } + + if ($arg2 === false) { + $max = $arg1; + $min = $this; + } else { + $min = $arg1; + $max = $arg2; + } + + $compare = $max->compare($min); + + if (!$compare) { + return $this->_normalize($min); + } elseif ($compare < 0) { + // if $min is bigger then $max, swap $min and $max + $temp = $max; + $max = $min; + $min = $temp; + } + + static $one; + if (!isset($one)) { + $one = new static(1); + } + + $max = $max->subtract($min->subtract($one)); + $size = strlen(ltrim($max->toBytes(), chr(0))); + + /* + doing $random % $max doesn't work because some numbers will be more likely to occur than others. + eg. if $max is 140 and $random's max is 255 then that'd mean both $random = 5 and $random = 145 + would produce 5 whereas the only value of random that could produce 139 would be 139. ie. + not all numbers would be equally likely. some would be more likely than others. + + creating a whole new random number until you find one that is within the range doesn't work + because, for sufficiently small ranges, the likelihood that you'd get a number within that range + would be pretty small. eg. with $random's max being 255 and if your $max being 1 the probability + would be pretty high that $random would be greater than $max. + + phpseclib works around this using the technique described here: + + http://crypto.stackexchange.com/questions/5708/creating-a-small-number-from-a-cryptographically-secure-random-string + */ + $random_max = new static(chr(1) . str_repeat("\0", $size), 256); + $random = $this->_random_number_helper($size); + + list($max_multiple) = $random_max->divide($max); + $max_multiple = $max_multiple->multiply($max); + + while ($random->compare($max_multiple) >= 0) { + $random = $random->subtract($max_multiple); + $random_max = $random_max->subtract($max_multiple); + $random = $random->bitwise_leftShift(8); + $random = $random->add($this->_random_number_helper(1)); + $random_max = $random_max->bitwise_leftShift(8); + list($max_multiple) = $random_max->divide($max); + $max_multiple = $max_multiple->multiply($max); + } + list(, $random) = $random->divide($max); + + return $this->_normalize($random->add($min)); + } + + /** + * Generate a random prime number. + * + * If there's not a prime within the given range, false will be returned. + * If more than $timeout seconds have elapsed, give up and return false. + * + * @param \phpseclib\Math\BigInteger $arg1 + * @param \phpseclib\Math\BigInteger $arg2 + * @param int $timeout + * @return Math_BigInteger|false + * @access public + * @internal See {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap4.pdf#page=15 HAC 4.44}. + */ + function randomPrime($arg1, $arg2 = false, $timeout = false) + { + if ($arg1 === false) { + return false; + } + + if ($arg2 === false) { + $max = $arg1; + $min = $this; + } else { + $min = $arg1; + $max = $arg2; + } + + $compare = $max->compare($min); + + if (!$compare) { + return $min->isPrime() ? $min : false; + } elseif ($compare < 0) { + // if $min is bigger then $max, swap $min and $max + $temp = $max; + $max = $min; + $min = $temp; + } + + static $one, $two; + if (!isset($one)) { + $one = new static(1); + $two = new static(2); + } + + $start = time(); + + $x = $this->random($min, $max); + + // gmp_nextprime() requires PHP 5 >= 5.2.0 per . + if (MATH_BIGINTEGER_MODE == self::MODE_GMP && extension_loaded('gmp')) { + $p = new static(); + $p->value = gmp_nextprime($x->value); + + if ($p->compare($max) <= 0) { + return $p; + } + + if (!$min->equals($x)) { + $x = $x->subtract($one); + } + + return $x->randomPrime($min, $x); + } + + if ($x->equals($two)) { + return $x; + } + + $x->_make_odd(); + if ($x->compare($max) > 0) { + // if $x > $max then $max is even and if $min == $max then no prime number exists between the specified range + if ($min->equals($max)) { + return false; + } + $x = $min->copy(); + $x->_make_odd(); + } + + $initial_x = $x->copy(); + + while (true) { + if ($timeout !== false && time() - $start > $timeout) { + return false; + } + + if ($x->isPrime()) { + return $x; + } + + $x = $x->add($two); + + if ($x->compare($max) > 0) { + $x = $min->copy(); + if ($x->equals($two)) { + return $x; + } + $x->_make_odd(); + } + + if ($x->equals($initial_x)) { + return false; + } + } + } + + /** + * Make the current number odd + * + * If the current number is odd it'll be unchanged. If it's even, one will be added to it. + * + * @see self::randomPrime() + * @access private + */ + function _make_odd() + { + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + gmp_setbit($this->value, 0); + break; + case self::MODE_BCMATH: + if ($this->value[strlen($this->value) - 1] % 2 == 0) { + $this->value = bcadd($this->value, '1'); + } + break; + default: + $this->value[0] |= 1; + } + } + + /** + * Checks a numer to see if it's prime + * + * Assuming the $t parameter is not set, this function has an error rate of 2**-80. The main motivation for the + * $t parameter is distributability. BigInteger::randomPrime() can be distributed across multiple pageloads + * on a website instead of just one. + * + * @param \phpseclib\Math\BigInteger $t + * @return bool + * @access public + * @internal Uses the + * {@link http://en.wikipedia.org/wiki/Miller%E2%80%93Rabin_primality_test Miller-Rabin primality test}. See + * {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap4.pdf#page=8 HAC 4.24}. + */ + function isPrime($t = false) + { + $length = strlen($this->toBytes()); + + if (!$t) { + // see HAC 4.49 "Note (controlling the error probability)" + // @codingStandardsIgnoreStart + if ($length >= 163) { $t = 2; } // floor(1300 / 8) + else if ($length >= 106) { $t = 3; } // floor( 850 / 8) + else if ($length >= 81 ) { $t = 4; } // floor( 650 / 8) + else if ($length >= 68 ) { $t = 5; } // floor( 550 / 8) + else if ($length >= 56 ) { $t = 6; } // floor( 450 / 8) + else if ($length >= 50 ) { $t = 7; } // floor( 400 / 8) + else if ($length >= 43 ) { $t = 8; } // floor( 350 / 8) + else if ($length >= 37 ) { $t = 9; } // floor( 300 / 8) + else if ($length >= 31 ) { $t = 12; } // floor( 250 / 8) + else if ($length >= 25 ) { $t = 15; } // floor( 200 / 8) + else if ($length >= 18 ) { $t = 18; } // floor( 150 / 8) + else { $t = 27; } + // @codingStandardsIgnoreEnd + } + + // ie. gmp_testbit($this, 0) + // ie. isEven() or !isOdd() + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + return gmp_prob_prime($this->value, $t) != 0; + case self::MODE_BCMATH: + if ($this->value === '2') { + return true; + } + if ($this->value[strlen($this->value) - 1] % 2 == 0) { + return false; + } + break; + default: + if ($this->value == array(2)) { + return true; + } + if (~$this->value[0] & 1) { + return false; + } + } + + static $primes, $zero, $one, $two; + + if (!isset($primes)) { + $primes = array( + 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, + 61, 67, 71, 73, 79, 83, 89, 97, 101, 103, 107, 109, 113, 127, 131, 137, + 139, 149, 151, 157, 163, 167, 173, 179, 181, 191, 193, 197, 199, 211, 223, 227, + 229, 233, 239, 241, 251, 257, 263, 269, 271, 277, 281, 283, 293, 307, 311, 313, + 317, 331, 337, 347, 349, 353, 359, 367, 373, 379, 383, 389, 397, 401, 409, 419, + 421, 431, 433, 439, 443, 449, 457, 461, 463, 467, 479, 487, 491, 499, 503, 509, + 521, 523, 541, 547, 557, 563, 569, 571, 577, 587, 593, 599, 601, 607, 613, 617, + 619, 631, 641, 643, 647, 653, 659, 661, 673, 677, 683, 691, 701, 709, 719, 727, + 733, 739, 743, 751, 757, 761, 769, 773, 787, 797, 809, 811, 821, 823, 827, 829, + 839, 853, 857, 859, 863, 877, 881, 883, 887, 907, 911, 919, 929, 937, 941, 947, + 953, 967, 971, 977, 983, 991, 997 + ); + + if (MATH_BIGINTEGER_MODE != self::MODE_INTERNAL) { + for ($i = 0; $i < count($primes); ++$i) { + $primes[$i] = new static($primes[$i]); + } + } + + $zero = new static(); + $one = new static(1); + $two = new static(2); + } + + if ($this->equals($one)) { + return false; + } + + // see HAC 4.4.1 "Random search for probable primes" + if (MATH_BIGINTEGER_MODE != self::MODE_INTERNAL) { + foreach ($primes as $prime) { + list(, $r) = $this->divide($prime); + if ($r->equals($zero)) { + return $this->equals($prime); + } + } + } else { + $value = $this->value; + foreach ($primes as $prime) { + list(, $r) = $this->_divide_digit($value, $prime); + if (!$r) { + return count($value) == 1 && $value[0] == $prime; + } + } + } + + $n = $this->copy(); + $n_1 = $n->subtract($one); + $n_2 = $n->subtract($two); + + $r = $n_1->copy(); + $r_value = $r->value; + // ie. $s = gmp_scan1($n, 0) and $r = gmp_div_q($n, gmp_pow(gmp_init('2'), $s)); + if (MATH_BIGINTEGER_MODE == self::MODE_BCMATH) { + $s = 0; + // if $n was 1, $r would be 0 and this would be an infinite loop, hence our $this->equals($one) check earlier + while ($r->value[strlen($r->value) - 1] % 2 == 0) { + $r->value = bcdiv($r->value, '2', 0); + ++$s; + } + } else { + for ($i = 0, $r_length = count($r_value); $i < $r_length; ++$i) { + $temp = ~$r_value[$i] & 0xFFFFFF; + for ($j = 1; ($temp >> $j) & 1; ++$j) { + } + if ($j != 25) { + break; + } + } + $s = 26 * $i + $j; + $r->_rshift($s); + } + + for ($i = 0; $i < $t; ++$i) { + $a = $this->random($two, $n_2); + $y = $a->modPow($r, $n); + + if (!$y->equals($one) && !$y->equals($n_1)) { + for ($j = 1; $j < $s && !$y->equals($n_1); ++$j) { + $y = $y->modPow($two, $n); + if ($y->equals($one)) { + return false; + } + } + + if (!$y->equals($n_1)) { + return false; + } + } + } + return true; + } + + /** + * Logical Left Shift + * + * Shifts BigInteger's by $shift bits. + * + * @param int $shift + * @access private + */ + function _lshift($shift) + { + if ($shift == 0) { + return; + } + + $num_digits = (int) ($shift / self::$base); + $shift %= self::$base; + $shift = 1 << $shift; + + $carry = 0; + + for ($i = 0; $i < count($this->value); ++$i) { + $temp = $this->value[$i] * $shift + $carry; + $carry = self::$base === 26 ? intval($temp / 0x4000000) : ($temp >> 31); + $this->value[$i] = (int) ($temp - $carry * self::$baseFull); + } + + if ($carry) { + $this->value[count($this->value)] = $carry; + } + + while ($num_digits--) { + array_unshift($this->value, 0); + } + } + + /** + * Logical Right Shift + * + * Shifts BigInteger's by $shift bits. + * + * @param int $shift + * @access private + */ + function _rshift($shift) + { + if ($shift == 0) { + return; + } + + $num_digits = (int) ($shift / self::$base); + $shift %= self::$base; + $carry_shift = self::$base - $shift; + $carry_mask = (1 << $shift) - 1; + + if ($num_digits) { + $this->value = array_slice($this->value, $num_digits); + } + + $carry = 0; + + for ($i = count($this->value) - 1; $i >= 0; --$i) { + $temp = $this->value[$i] >> $shift | $carry; + $carry = ($this->value[$i] & $carry_mask) << $carry_shift; + $this->value[$i] = $temp; + } + + $this->value = $this->_trim($this->value); + } + + /** + * Normalize + * + * Removes leading zeros and truncates (if necessary) to maintain the appropriate precision + * + * @param \phpseclib\Math\BigInteger + * @return \phpseclib\Math\BigInteger + * @see self::_trim() + * @access private + */ + function _normalize($result) + { + $result->precision = $this->precision; + $result->bitmask = $this->bitmask; + + switch (MATH_BIGINTEGER_MODE) { + case self::MODE_GMP: + if ($this->bitmask !== false) { + $result->value = gmp_and($result->value, $result->bitmask->value); + } + + return $result; + case self::MODE_BCMATH: + if (!empty($result->bitmask->value)) { + $result->value = bcmod($result->value, $result->bitmask->value); + } + + return $result; + } + + $value = &$result->value; + + if (!count($value)) { + return $result; + } + + $value = $this->_trim($value); + + if (!empty($result->bitmask->value)) { + $length = min(count($value), count($this->bitmask->value)); + $value = array_slice($value, 0, $length); + + for ($i = 0; $i < $length; ++$i) { + $value[$i] = $value[$i] & $this->bitmask->value[$i]; + } + } + + return $result; + } + + /** + * Trim + * + * Removes leading zeros + * + * @param array $value + * @return \phpseclib\Math\BigInteger + * @access private + */ + function _trim($value) + { + for ($i = count($value) - 1; $i >= 0; --$i) { + if ($value[$i]) { + break; + } + unset($value[$i]); + } + + return $value; + } + + /** + * Array Repeat + * + * @param $input Array + * @param $multiplier mixed + * @return array + * @access private + */ + function _array_repeat($input, $multiplier) + { + return ($multiplier) ? array_fill(0, $multiplier, $input) : array(); + } + + /** + * Logical Left Shift + * + * Shifts binary strings $shift bits, essentially multiplying by 2**$shift. + * + * @param $x String + * @param $shift Integer + * @return string + * @access private + */ + function _base256_lshift(&$x, $shift) + { + if ($shift == 0) { + return; + } + + $num_bytes = $shift >> 3; // eg. floor($shift/8) + $shift &= 7; // eg. $shift % 8 + + $carry = 0; + for ($i = strlen($x) - 1; $i >= 0; --$i) { + $temp = ord($x[$i]) << $shift | $carry; + $x[$i] = chr($temp); + $carry = $temp >> 8; + } + $carry = ($carry != 0) ? chr($carry) : ''; + $x = $carry . $x . str_repeat(chr(0), $num_bytes); + } + + /** + * Logical Right Shift + * + * Shifts binary strings $shift bits, essentially dividing by 2**$shift and returning the remainder. + * + * @param $x String + * @param $shift Integer + * @return string + * @access private + */ + function _base256_rshift(&$x, $shift) + { + if ($shift == 0) { + $x = ltrim($x, chr(0)); + return ''; + } + + $num_bytes = $shift >> 3; // eg. floor($shift/8) + $shift &= 7; // eg. $shift % 8 + + $remainder = ''; + if ($num_bytes) { + $start = $num_bytes > strlen($x) ? -strlen($x) : -$num_bytes; + $remainder = substr($x, $start); + $x = substr($x, 0, -$num_bytes); + } + + $carry = 0; + $carry_shift = 8 - $shift; + for ($i = 0; $i < strlen($x); ++$i) { + $temp = (ord($x[$i]) >> $shift) | $carry; + $carry = (ord($x[$i]) << $carry_shift) & 0xFF; + $x[$i] = chr($temp); + } + $x = ltrim($x, chr(0)); + + $remainder = chr($carry >> $carry_shift) . $remainder; + + return ltrim($remainder, chr(0)); + } + + // one quirk about how the following functions are implemented is that PHP defines N to be an unsigned long + // at 32-bits, while java's longs are 64-bits. + + /** + * Converts 32-bit integers to bytes. + * + * @param int $x + * @return string + * @access private + */ + function _int2bytes($x) + { + return ltrim(pack('N', $x), chr(0)); + } + + /** + * Converts bytes to 32-bit integers + * + * @param string $x + * @return int + * @access private + */ + function _bytes2int($x) + { + $temp = unpack('Nint', str_pad($x, 4, chr(0), STR_PAD_LEFT)); + return $temp['int']; + } + + /** + * DER-encode an integer + * + * The ability to DER-encode integers is needed to create RSA public keys for use with OpenSSL + * + * @see self::modPow() + * @access private + * @param int $length + * @return string + */ + function _encodeASN1Length($length) + { + if ($length <= 0x7F) { + return chr($length); + } + + $temp = ltrim(pack('N', $length), chr(0)); + return pack('Ca*', 0x80 | strlen($temp), $temp); + } + + /** + * Single digit division + * + * Even if int64 is being used the division operator will return a float64 value + * if the dividend is not evenly divisible by the divisor. Since a float64 doesn't + * have the precision of int64 this is a problem so, when int64 is being used, + * we'll guarantee that the dividend is divisible by first subtracting the remainder. + * + * @access private + * @param int $x + * @param int $y + * @return int + */ + function _safe_divide($x, $y) + { + if (self::$base === 26) { + return (int) ($x / $y); + } + + // self::$base === 31 + return ($x - ($x % $y)) / $y; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/bootstrap.php b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/bootstrap.php new file mode 100644 index 0000000..0da0999 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/phpseclib/phpseclib/phpseclib/bootstrap.php @@ -0,0 +1,16 @@ +=5.3.0" + }, + "autoload": { + "psr-4": { + "Psr\\Cache\\": "src/" + } + }, + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/cache/src/CacheException.php b/Postman/Postman-Mail/google-api-client/vendor/psr/cache/src/CacheException.php new file mode 100644 index 0000000..e27f22f --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/cache/src/CacheException.php @@ -0,0 +1,10 @@ +=5.3.0" + }, + "autoload": { + "psr-4": { + "Psr\\Http\\Message\\": "src/" + } + }, + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/MessageInterface.php b/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/MessageInterface.php new file mode 100644 index 0000000..dd46e5e --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/MessageInterface.php @@ -0,0 +1,187 @@ +getHeaders() as $name => $values) { + * echo $name . ": " . implode(", ", $values); + * } + * + * // Emit headers iteratively: + * foreach ($message->getHeaders() as $name => $values) { + * foreach ($values as $value) { + * header(sprintf('%s: %s', $name, $value), false); + * } + * } + * + * While header names are not case-sensitive, getHeaders() will preserve the + * exact case in which headers were originally specified. + * + * @return string[][] Returns an associative array of the message's headers. Each + * key MUST be a header name, and each value MUST be an array of strings + * for that header. + */ + public function getHeaders(); + + /** + * Checks if a header exists by the given case-insensitive name. + * + * @param string $name Case-insensitive header field name. + * @return bool Returns true if any header names match the given header + * name using a case-insensitive string comparison. Returns false if + * no matching header name is found in the message. + */ + public function hasHeader($name); + + /** + * Retrieves a message header value by the given case-insensitive name. + * + * This method returns an array of all the header values of the given + * case-insensitive header name. + * + * If the header does not appear in the message, this method MUST return an + * empty array. + * + * @param string $name Case-insensitive header field name. + * @return string[] An array of string values as provided for the given + * header. If the header does not appear in the message, this method MUST + * return an empty array. + */ + public function getHeader($name); + + /** + * Retrieves a comma-separated string of the values for a single header. + * + * This method returns all of the header values of the given + * case-insensitive header name as a string concatenated together using + * a comma. + * + * NOTE: Not all header values may be appropriately represented using + * comma concatenation. For such headers, use getHeader() instead + * and supply your own delimiter when concatenating. + * + * If the header does not appear in the message, this method MUST return + * an empty string. + * + * @param string $name Case-insensitive header field name. + * @return string A string of values as provided for the given header + * concatenated together using a comma. If the header does not appear in + * the message, this method MUST return an empty string. + */ + public function getHeaderLine($name); + + /** + * Return an instance with the provided value replacing the specified header. + * + * While header names are case-insensitive, the casing of the header will + * be preserved by this function, and returned from getHeaders(). + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * new and/or updated header and value. + * + * @param string $name Case-insensitive header field name. + * @param string|string[] $value Header value(s). + * @return static + * @throws \InvalidArgumentException for invalid header names or values. + */ + public function withHeader($name, $value); + + /** + * Return an instance with the specified header appended with the given value. + * + * Existing values for the specified header will be maintained. The new + * value(s) will be appended to the existing list. If the header did not + * exist previously, it will be added. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * new header and/or value. + * + * @param string $name Case-insensitive header field name to add. + * @param string|string[] $value Header value(s). + * @return static + * @throws \InvalidArgumentException for invalid header names or values. + */ + public function withAddedHeader($name, $value); + + /** + * Return an instance without the specified header. + * + * Header resolution MUST be done without case-sensitivity. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that removes + * the named header. + * + * @param string $name Case-insensitive header field name to remove. + * @return static + */ + public function withoutHeader($name); + + /** + * Gets the body of the message. + * + * @return StreamInterface Returns the body as a stream. + */ + public function getBody(); + + /** + * Return an instance with the specified message body. + * + * The body MUST be a StreamInterface object. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return a new instance that has the + * new body stream. + * + * @param StreamInterface $body Body. + * @return static + * @throws \InvalidArgumentException When the body is not valid. + */ + public function withBody(StreamInterface $body); +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/RequestInterface.php b/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/RequestInterface.php new file mode 100644 index 0000000..a96d4fd --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/RequestInterface.php @@ -0,0 +1,129 @@ +getQuery()` + * or from the `QUERY_STRING` server param. + * + * @return array + */ + public function getQueryParams(); + + /** + * Return an instance with the specified query string arguments. + * + * These values SHOULD remain immutable over the course of the incoming + * request. They MAY be injected during instantiation, such as from PHP's + * $_GET superglobal, or MAY be derived from some other value such as the + * URI. In cases where the arguments are parsed from the URI, the data + * MUST be compatible with what PHP's parse_str() would return for + * purposes of how duplicate query parameters are handled, and how nested + * sets are handled. + * + * Setting query string arguments MUST NOT change the URI stored by the + * request, nor the values in the server params. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * updated query string arguments. + * + * @param array $query Array of query string arguments, typically from + * $_GET. + * @return static + */ + public function withQueryParams(array $query); + + /** + * Retrieve normalized file upload data. + * + * This method returns upload metadata in a normalized tree, with each leaf + * an instance of Psr\Http\Message\UploadedFileInterface. + * + * These values MAY be prepared from $_FILES or the message body during + * instantiation, or MAY be injected via withUploadedFiles(). + * + * @return array An array tree of UploadedFileInterface instances; an empty + * array MUST be returned if no data is present. + */ + public function getUploadedFiles(); + + /** + * Create a new instance with the specified uploaded files. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * updated body parameters. + * + * @param array $uploadedFiles An array tree of UploadedFileInterface instances. + * @return static + * @throws \InvalidArgumentException if an invalid structure is provided. + */ + public function withUploadedFiles(array $uploadedFiles); + + /** + * Retrieve any parameters provided in the request body. + * + * If the request Content-Type is either application/x-www-form-urlencoded + * or multipart/form-data, and the request method is POST, this method MUST + * return the contents of $_POST. + * + * Otherwise, this method may return any results of deserializing + * the request body content; as parsing returns structured content, the + * potential types MUST be arrays or objects only. A null value indicates + * the absence of body content. + * + * @return null|array|object The deserialized body parameters, if any. + * These will typically be an array or object. + */ + public function getParsedBody(); + + /** + * Return an instance with the specified body parameters. + * + * These MAY be injected during instantiation. + * + * If the request Content-Type is either application/x-www-form-urlencoded + * or multipart/form-data, and the request method is POST, use this method + * ONLY to inject the contents of $_POST. + * + * The data IS NOT REQUIRED to come from $_POST, but MUST be the results of + * deserializing the request body content. Deserialization/parsing returns + * structured data, and, as such, this method ONLY accepts arrays or objects, + * or a null value if nothing was available to parse. + * + * As an example, if content negotiation determines that the request data + * is a JSON payload, this method could be used to create a request + * instance with the deserialized parameters. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * updated body parameters. + * + * @param null|array|object $data The deserialized body data. This will + * typically be in an array or object. + * @return static + * @throws \InvalidArgumentException if an unsupported argument type is + * provided. + */ + public function withParsedBody($data); + + /** + * Retrieve attributes derived from the request. + * + * The request "attributes" may be used to allow injection of any + * parameters derived from the request: e.g., the results of path + * match operations; the results of decrypting cookies; the results of + * deserializing non-form-encoded message bodies; etc. Attributes + * will be application and request specific, and CAN be mutable. + * + * @return array Attributes derived from the request. + */ + public function getAttributes(); + + /** + * Retrieve a single derived request attribute. + * + * Retrieves a single derived request attribute as described in + * getAttributes(). If the attribute has not been previously set, returns + * the default value as provided. + * + * This method obviates the need for a hasAttribute() method, as it allows + * specifying a default value to return if the attribute is not found. + * + * @see getAttributes() + * @param string $name The attribute name. + * @param mixed $default Default value to return if the attribute does not exist. + * @return mixed + */ + public function getAttribute($name, $default = null); + + /** + * Return an instance with the specified derived request attribute. + * + * This method allows setting a single derived request attribute as + * described in getAttributes(). + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * updated attribute. + * + * @see getAttributes() + * @param string $name The attribute name. + * @param mixed $value The value of the attribute. + * @return static + */ + public function withAttribute($name, $value); + + /** + * Return an instance that removes the specified derived request attribute. + * + * This method allows removing a single derived request attribute as + * described in getAttributes(). + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that removes + * the attribute. + * + * @see getAttributes() + * @param string $name The attribute name. + * @return static + */ + public function withoutAttribute($name); +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/StreamInterface.php b/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/StreamInterface.php new file mode 100644 index 0000000..f68f391 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/http-message/src/StreamInterface.php @@ -0,0 +1,158 @@ + + * [user-info@]host[:port] + * + * + * If the port component is not set or is the standard port for the current + * scheme, it SHOULD NOT be included. + * + * @see https://tools.ietf.org/html/rfc3986#section-3.2 + * @return string The URI authority, in "[user-info@]host[:port]" format. + */ + public function getAuthority(); + + /** + * Retrieve the user information component of the URI. + * + * If no user information is present, this method MUST return an empty + * string. + * + * If a user is present in the URI, this will return that value; + * additionally, if the password is also present, it will be appended to the + * user value, with a colon (":") separating the values. + * + * The trailing "@" character is not part of the user information and MUST + * NOT be added. + * + * @return string The URI user information, in "username[:password]" format. + */ + public function getUserInfo(); + + /** + * Retrieve the host component of the URI. + * + * If no host is present, this method MUST return an empty string. + * + * The value returned MUST be normalized to lowercase, per RFC 3986 + * Section 3.2.2. + * + * @see http://tools.ietf.org/html/rfc3986#section-3.2.2 + * @return string The URI host. + */ + public function getHost(); + + /** + * Retrieve the port component of the URI. + * + * If a port is present, and it is non-standard for the current scheme, + * this method MUST return it as an integer. If the port is the standard port + * used with the current scheme, this method SHOULD return null. + * + * If no port is present, and no scheme is present, this method MUST return + * a null value. + * + * If no port is present, but a scheme is present, this method MAY return + * the standard port for that scheme, but SHOULD return null. + * + * @return null|int The URI port. + */ + public function getPort(); + + /** + * Retrieve the path component of the URI. + * + * The path can either be empty or absolute (starting with a slash) or + * rootless (not starting with a slash). Implementations MUST support all + * three syntaxes. + * + * Normally, the empty path "" and absolute path "/" are considered equal as + * defined in RFC 7230 Section 2.7.3. But this method MUST NOT automatically + * do this normalization because in contexts with a trimmed base path, e.g. + * the front controller, this difference becomes significant. It's the task + * of the user to handle both "" and "/". + * + * The value returned MUST be percent-encoded, but MUST NOT double-encode + * any characters. To determine what characters to encode, please refer to + * RFC 3986, Sections 2 and 3.3. + * + * As an example, if the value should include a slash ("/") not intended as + * delimiter between path segments, that value MUST be passed in encoded + * form (e.g., "%2F") to the instance. + * + * @see https://tools.ietf.org/html/rfc3986#section-2 + * @see https://tools.ietf.org/html/rfc3986#section-3.3 + * @return string The URI path. + */ + public function getPath(); + + /** + * Retrieve the query string of the URI. + * + * If no query string is present, this method MUST return an empty string. + * + * The leading "?" character is not part of the query and MUST NOT be + * added. + * + * The value returned MUST be percent-encoded, but MUST NOT double-encode + * any characters. To determine what characters to encode, please refer to + * RFC 3986, Sections 2 and 3.4. + * + * As an example, if a value in a key/value pair of the query string should + * include an ampersand ("&") not intended as a delimiter between values, + * that value MUST be passed in encoded form (e.g., "%26") to the instance. + * + * @see https://tools.ietf.org/html/rfc3986#section-2 + * @see https://tools.ietf.org/html/rfc3986#section-3.4 + * @return string The URI query string. + */ + public function getQuery(); + + /** + * Retrieve the fragment component of the URI. + * + * If no fragment is present, this method MUST return an empty string. + * + * The leading "#" character is not part of the fragment and MUST NOT be + * added. + * + * The value returned MUST be percent-encoded, but MUST NOT double-encode + * any characters. To determine what characters to encode, please refer to + * RFC 3986, Sections 2 and 3.5. + * + * @see https://tools.ietf.org/html/rfc3986#section-2 + * @see https://tools.ietf.org/html/rfc3986#section-3.5 + * @return string The URI fragment. + */ + public function getFragment(); + + /** + * Return an instance with the specified scheme. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified scheme. + * + * Implementations MUST support the schemes "http" and "https" case + * insensitively, and MAY accommodate other schemes if required. + * + * An empty scheme is equivalent to removing the scheme. + * + * @param string $scheme The scheme to use with the new instance. + * @return static A new instance with the specified scheme. + * @throws \InvalidArgumentException for invalid or unsupported schemes. + */ + public function withScheme($scheme); + + /** + * Return an instance with the specified user information. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified user information. + * + * Password is optional, but the user information MUST include the + * user; an empty string for the user is equivalent to removing user + * information. + * + * @param string $user The user name to use for authority. + * @param null|string $password The password associated with $user. + * @return static A new instance with the specified user information. + */ + public function withUserInfo($user, $password = null); + + /** + * Return an instance with the specified host. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified host. + * + * An empty host value is equivalent to removing the host. + * + * @param string $host The hostname to use with the new instance. + * @return static A new instance with the specified host. + * @throws \InvalidArgumentException for invalid hostnames. + */ + public function withHost($host); + + /** + * Return an instance with the specified port. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified port. + * + * Implementations MUST raise an exception for ports outside the + * established TCP and UDP port ranges. + * + * A null value provided for the port is equivalent to removing the port + * information. + * + * @param null|int $port The port to use with the new instance; a null value + * removes the port information. + * @return static A new instance with the specified port. + * @throws \InvalidArgumentException for invalid ports. + */ + public function withPort($port); + + /** + * Return an instance with the specified path. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified path. + * + * The path can either be empty or absolute (starting with a slash) or + * rootless (not starting with a slash). Implementations MUST support all + * three syntaxes. + * + * If the path is intended to be domain-relative rather than path relative then + * it must begin with a slash ("/"). Paths not starting with a slash ("/") + * are assumed to be relative to some base path known to the application or + * consumer. + * + * Users can provide both encoded and decoded path characters. + * Implementations ensure the correct encoding as outlined in getPath(). + * + * @param string $path The path to use with the new instance. + * @return static A new instance with the specified path. + * @throws \InvalidArgumentException for invalid paths. + */ + public function withPath($path); + + /** + * Return an instance with the specified query string. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified query string. + * + * Users can provide both encoded and decoded query characters. + * Implementations ensure the correct encoding as outlined in getQuery(). + * + * An empty query string value is equivalent to removing the query string. + * + * @param string $query The query string to use with the new instance. + * @return static A new instance with the specified query string. + * @throws \InvalidArgumentException for invalid query strings. + */ + public function withQuery($query); + + /** + * Return an instance with the specified URI fragment. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified URI fragment. + * + * Users can provide both encoded and decoded fragment characters. + * Implementations ensure the correct encoding as outlined in getFragment(). + * + * An empty fragment value is equivalent to removing the fragment. + * + * @param string $fragment The fragment to use with the new instance. + * @return static A new instance with the specified fragment. + */ + public function withFragment($fragment); + + /** + * Return the string representation as a URI reference. + * + * Depending on which components of the URI are present, the resulting + * string is either a full URI or relative reference according to RFC 3986, + * Section 4.1. The method concatenates the various components of the URI, + * using the appropriate delimiters: + * + * - If a scheme is present, it MUST be suffixed by ":". + * - If an authority is present, it MUST be prefixed by "//". + * - The path can be concatenated without delimiters. But there are two + * cases where the path has to be adjusted to make the URI reference + * valid as PHP does not allow to throw an exception in __toString(): + * - If the path is rootless and an authority is present, the path MUST + * be prefixed by "/". + * - If the path is starting with more than one "/" and no authority is + * present, the starting slashes MUST be reduced to one. + * - If a query is present, it MUST be prefixed by "?". + * - If a fragment is present, it MUST be prefixed by "#". + * + * @see http://tools.ietf.org/html/rfc3986#section-4.1 + * @return string + */ + public function __toString(); +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/log/LICENSE b/Postman/Postman-Mail/google-api-client/vendor/psr/log/LICENSE new file mode 100644 index 0000000..474c952 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/log/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2012 PHP Framework Interoperability Group + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/AbstractLogger.php b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/AbstractLogger.php new file mode 100644 index 0000000..90e721a --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/AbstractLogger.php @@ -0,0 +1,128 @@ +log(LogLevel::EMERGENCY, $message, $context); + } + + /** + * Action must be taken immediately. + * + * Example: Entire website down, database unavailable, etc. This should + * trigger the SMS alerts and wake you up. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function alert($message, array $context = array()) + { + $this->log(LogLevel::ALERT, $message, $context); + } + + /** + * Critical conditions. + * + * Example: Application component unavailable, unexpected exception. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function critical($message, array $context = array()) + { + $this->log(LogLevel::CRITICAL, $message, $context); + } + + /** + * Runtime errors that do not require immediate action but should typically + * be logged and monitored. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function error($message, array $context = array()) + { + $this->log(LogLevel::ERROR, $message, $context); + } + + /** + * Exceptional occurrences that are not errors. + * + * Example: Use of deprecated APIs, poor use of an API, undesirable things + * that are not necessarily wrong. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function warning($message, array $context = array()) + { + $this->log(LogLevel::WARNING, $message, $context); + } + + /** + * Normal but significant events. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function notice($message, array $context = array()) + { + $this->log(LogLevel::NOTICE, $message, $context); + } + + /** + * Interesting events. + * + * Example: User logs in, SQL logs. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function info($message, array $context = array()) + { + $this->log(LogLevel::INFO, $message, $context); + } + + /** + * Detailed debug information. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function debug($message, array $context = array()) + { + $this->log(LogLevel::DEBUG, $message, $context); + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/InvalidArgumentException.php b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/InvalidArgumentException.php new file mode 100644 index 0000000..67f852d --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/InvalidArgumentException.php @@ -0,0 +1,7 @@ +logger = $logger; + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/LoggerInterface.php b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/LoggerInterface.php new file mode 100644 index 0000000..5ea7243 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/LoggerInterface.php @@ -0,0 +1,123 @@ +log(LogLevel::EMERGENCY, $message, $context); + } + + /** + * Action must be taken immediately. + * + * Example: Entire website down, database unavailable, etc. This should + * trigger the SMS alerts and wake you up. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function alert($message, array $context = array()) + { + $this->log(LogLevel::ALERT, $message, $context); + } + + /** + * Critical conditions. + * + * Example: Application component unavailable, unexpected exception. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function critical($message, array $context = array()) + { + $this->log(LogLevel::CRITICAL, $message, $context); + } + + /** + * Runtime errors that do not require immediate action but should typically + * be logged and monitored. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function error($message, array $context = array()) + { + $this->log(LogLevel::ERROR, $message, $context); + } + + /** + * Exceptional occurrences that are not errors. + * + * Example: Use of deprecated APIs, poor use of an API, undesirable things + * that are not necessarily wrong. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function warning($message, array $context = array()) + { + $this->log(LogLevel::WARNING, $message, $context); + } + + /** + * Normal but significant events. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function notice($message, array $context = array()) + { + $this->log(LogLevel::NOTICE, $message, $context); + } + + /** + * Interesting events. + * + * Example: User logs in, SQL logs. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function info($message, array $context = array()) + { + $this->log(LogLevel::INFO, $message, $context); + } + + /** + * Detailed debug information. + * + * @param string $message + * @param array $context + * + * @return void + */ + public function debug($message, array $context = array()) + { + $this->log(LogLevel::DEBUG, $message, $context); + } + + /** + * Logs with an arbitrary level. + * + * @param mixed $level + * @param string $message + * @param array $context + * + * @return void + */ + abstract public function log($level, $message, array $context = array()); +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/NullLogger.php b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/NullLogger.php new file mode 100644 index 0000000..d8cd682 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/NullLogger.php @@ -0,0 +1,28 @@ +logger) { }` + * blocks. + */ +class NullLogger extends AbstractLogger +{ + /** + * Logs with an arbitrary level. + * + * @param mixed $level + * @param string $message + * @param array $context + * + * @return void + */ + public function log($level, $message, array $context = array()) + { + // noop + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/Test/LoggerInterfaceTest.php b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/Test/LoggerInterfaceTest.php new file mode 100644 index 0000000..a0391a5 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/log/Psr/Log/Test/LoggerInterfaceTest.php @@ -0,0 +1,140 @@ + ". + * + * Example ->error('Foo') would yield "error Foo". + * + * @return string[] + */ + abstract public function getLogs(); + + public function testImplements() + { + $this->assertInstanceOf('Psr\Log\LoggerInterface', $this->getLogger()); + } + + /** + * @dataProvider provideLevelsAndMessages + */ + public function testLogsAtAllLevels($level, $message) + { + $logger = $this->getLogger(); + $logger->{$level}($message, array('user' => 'Bob')); + $logger->log($level, $message, array('user' => 'Bob')); + + $expected = array( + $level.' message of level '.$level.' with context: Bob', + $level.' message of level '.$level.' with context: Bob', + ); + $this->assertEquals($expected, $this->getLogs()); + } + + public function provideLevelsAndMessages() + { + return array( + LogLevel::EMERGENCY => array(LogLevel::EMERGENCY, 'message of level emergency with context: {user}'), + LogLevel::ALERT => array(LogLevel::ALERT, 'message of level alert with context: {user}'), + LogLevel::CRITICAL => array(LogLevel::CRITICAL, 'message of level critical with context: {user}'), + LogLevel::ERROR => array(LogLevel::ERROR, 'message of level error with context: {user}'), + LogLevel::WARNING => array(LogLevel::WARNING, 'message of level warning with context: {user}'), + LogLevel::NOTICE => array(LogLevel::NOTICE, 'message of level notice with context: {user}'), + LogLevel::INFO => array(LogLevel::INFO, 'message of level info with context: {user}'), + LogLevel::DEBUG => array(LogLevel::DEBUG, 'message of level debug with context: {user}'), + ); + } + + /** + * @expectedException \Psr\Log\InvalidArgumentException + */ + public function testThrowsOnInvalidLevel() + { + $logger = $this->getLogger(); + $logger->log('invalid level', 'Foo'); + } + + public function testContextReplacement() + { + $logger = $this->getLogger(); + $logger->info('{Message {nothing} {user} {foo.bar} a}', array('user' => 'Bob', 'foo.bar' => 'Bar')); + + $expected = array('info {Message {nothing} Bob Bar a}'); + $this->assertEquals($expected, $this->getLogs()); + } + + public function testObjectCastToString() + { + if (method_exists($this, 'createPartialMock')) { + $dummy = $this->createPartialMock('Psr\Log\Test\DummyTest', array('__toString')); + } else { + $dummy = $this->getMock('Psr\Log\Test\DummyTest', array('__toString')); + } + $dummy->expects($this->once()) + ->method('__toString') + ->will($this->returnValue('DUMMY')); + + $this->getLogger()->warning($dummy); + + $expected = array('warning DUMMY'); + $this->assertEquals($expected, $this->getLogs()); + } + + public function testContextCanContainAnything() + { + $context = array( + 'bool' => true, + 'null' => null, + 'string' => 'Foo', + 'int' => 0, + 'float' => 0.5, + 'nested' => array('with object' => new DummyTest), + 'object' => new \DateTime, + 'resource' => fopen('php://memory', 'r'), + ); + + $this->getLogger()->warning('Crazy context data', $context); + + $expected = array('warning Crazy context data'); + $this->assertEquals($expected, $this->getLogs()); + } + + public function testContextExceptionKeyCanBeExceptionOrOtherValues() + { + $logger = $this->getLogger(); + $logger->warning('Random message', array('exception' => 'oops')); + $logger->critical('Uncaught Exception!', array('exception' => new \LogicException('Fail'))); + + $expected = array( + 'warning Random message', + 'critical Uncaught Exception!' + ); + $this->assertEquals($expected, $this->getLogs()); + } +} + +class DummyTest +{ + public function __toString() + { + } +} diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/log/README.md b/Postman/Postman-Mail/google-api-client/vendor/psr/log/README.md new file mode 100644 index 0000000..574bc1c --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/log/README.md @@ -0,0 +1,45 @@ +PSR Log +======= + +This repository holds all interfaces/classes/traits related to +[PSR-3](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-3-logger-interface.md). + +Note that this is not a logger of its own. It is merely an interface that +describes a logger. See the specification for more details. + +Usage +----- + +If you need a logger, you can use the interface like this: + +```php +logger = $logger; + } + + public function doSomething() + { + if ($this->logger) { + $this->logger->info('Doing work'); + } + + // do something useful + } +} +``` + +You can then pick one of the implementations of the interface to get a logger. + +If you want to implement the interface, you can require this package and +implement `Psr\Log\LoggerInterface` in your code. Please read the +[specification text](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-3-logger-interface.md) +for details. diff --git a/Postman/Postman-Mail/google-api-client/vendor/psr/log/composer.json b/Postman/Postman-Mail/google-api-client/vendor/psr/log/composer.json new file mode 100644 index 0000000..87934d7 --- /dev/null +++ b/Postman/Postman-Mail/google-api-client/vendor/psr/log/composer.json @@ -0,0 +1,26 @@ +{ + "name": "psr/log", + "description": "Common interface for logging libraries", + "keywords": ["psr", "psr-3", "log"], + "homepage": "https://github.com/php-fig/log", + "license": "MIT", + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "require": { + "php": ">=5.3.0" + }, + "autoload": { + "psr-4": { + "Psr\\Log\\": "Psr/Log/" + } + }, + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/LICENSE b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/LICENSE new file mode 100644 index 0000000..dfd048a --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/LICENSE @@ -0,0 +1,13 @@ +Copyright 2013 The Rocket Science Group, LLC. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill.php new file mode 100644 index 0000000..4d4e675 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill.php @@ -0,0 +1,161 @@ + "Postman_Mandrill_ValidationError", + "Invalid_Key" => "Postman_Mandrill_Invalid_Key", + "PaymentRequired" => "Postman_Mandrill_PaymentRequired", + "Unknown_Subaccount" => "Postman_Mandrill_Unknown_Subaccount", + "Unknown_Template" => "Postman_Mandrill_Unknown_Template", + "ServiceUnavailable" => "Postman_Mandrill_ServiceUnavailable", + "Unknown_Message" => "Postman_Mandrill_Unknown_Message", + "Invalid_Tag_Name" => "Postman_Mandrill_Invalid_Tag_Name", + "Invalid_Reject" => "Postman_Mandrill_Invalid_Reject", + "Unknown_Sender" => "Postman_Mandrill_Unknown_Sender", + "Unknown_Url" => "Postman_Mandrill_Unknown_Url", + "Unknown_TrackingDomain" => "Postman_Mandrill_Unknown_TrackingDomain", + "Invalid_Template" => "Postman_Mandrill_Invalid_Template", + "Unknown_Webhook" => "Postman_Mandrill_Unknown_Webhook", + "Unknown_InboundDomain" => "Postman_Mandrill_Unknown_InboundDomain", + "Unknown_InboundRoute" => "Postman_Mandrill_Unknown_InboundRoute", + "Unknown_Export" => "Postman_Mandrill_Unknown_Export", + "IP_ProvisionLimit" => "Postman_Mandrill_IP_ProvisionLimit", + "Unknown_Pool" => "Postman_Mandrill_Unknown_Pool", + "NoSendingHistory" => "Postman_Mandrill_NoSendingHistory", + "PoorReputation" => "Postman_Mandrill_PoorReputation", + "Unknown_IP" => "Postman_Mandrill_Unknown_IP", + "Invalid_EmptyDefaultPool" => "Postman_Mandrill_Invalid_EmptyDefaultPool", + "Invalid_DeleteDefaultPool" => "Postman_Mandrill_Invalid_DeleteDefaultPool", + "Invalid_DeleteNonEmptyPool" => "Postman_Mandrill_Invalid_DeleteNonEmptyPool", + "Invalid_CustomDNS" => "Postman_Mandrill_Invalid_CustomDNS", + "Invalid_CustomDNSPending" => "Postman_Mandrill_Invalid_CustomDNSPending", + "Metadata_FieldLimit" => "Postman_Mandrill_Metadata_FieldLimit", + "Unknown_MetadataField" => "Postman_Mandrill_Unknown_MetadataField" + ); + + public function __construct($apikey=null) { + if(!$apikey) $apikey = getenv('MANDRILL_APIKEY'); + if(!$apikey) $apikey = $this->readConfigs(); + if(!$apikey) throw new Postman_Mandrill_Error('You must provide a Mandrill API key'); + $this->apikey = $apikey; + + $this->ch = curl_init(); + curl_setopt($this->ch, CURLOPT_USERAGENT, 'Mandrill-PHP/1.0.55'); + curl_setopt($this->ch, CURLOPT_POST, true); + curl_setopt($this->ch, CURLOPT_FOLLOWLOCATION, true); + curl_setopt($this->ch, CURLOPT_HEADER, false); + curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, true); + curl_setopt($this->ch, CURLOPT_CONNECTTIMEOUT, 30); + curl_setopt($this->ch, CURLOPT_TIMEOUT, 600); + + $this->root = rtrim($this->root, '/') . '/'; + + $this->templates = new Postman_Mandrill_Templates($this); + $this->exports = new Postman_Mandrill_Exports($this); + $this->users = new Postman_Mandrill_Users($this); + $this->rejects = new Postman_Mandrill_Rejects($this); + $this->inbound = new Postman_Mandrill_Inbound($this); + $this->tags = new Postman_Mandrill_Tags($this); + $this->messages = new Postman_Mandrill_Messages($this); + $this->whitelists = new Postman_Mandrill_Whitelists($this); + $this->ips = new Postman_Mandrill_Ips($this); + $this->internal = new Postman_Mandrill_Internal($this); + $this->subaccounts = new Postman_Mandrill_Subaccounts($this); + $this->urls = new Postman_Mandrill_Urls($this); + $this->webhooks = new Postman_Mandrill_Webhooks($this); + $this->senders = new Postman_Mandrill_Senders($this); + $this->metadata = new Postman_Mandrill_Metadata($this); + } + + public function __destruct() { + curl_close($this->ch); + } + + public function call($url, $params) { + $params['key'] = $this->apikey; + $params = json_encode($params); + $ch = $this->ch; + + curl_setopt($ch, CURLOPT_URL, $this->root . $url . '.json'); + curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json')); + curl_setopt($ch, CURLOPT_POSTFIELDS, $params); + curl_setopt($ch, CURLOPT_VERBOSE, $this->debug); + + $start = microtime(true); + $this->log('Call to ' . $this->root . $url . '.json: ' . $params); + if($this->debug) { + $curl_buffer = fopen('php://memory', 'w+'); + curl_setopt($ch, CURLOPT_STDERR, $curl_buffer); + } + + $response_body = curl_exec($ch); + $info = curl_getinfo($ch); + $time = microtime(true) - $start; + if($this->debug) { + rewind($curl_buffer); + $this->log(stream_get_contents($curl_buffer)); + fclose($curl_buffer); + } + $this->log('Completed in ' . number_format($time * 1000, 2) . 'ms'); + $this->log('Got response: ' . $response_body); + + if(curl_error($ch)) { + throw new Postman_Mandrill_HttpError("API call to $url failed: " . curl_error($ch)); + } + $result = json_decode($response_body, true); + if($result === null) throw new Postman_Mandrill_Error('We were unable to decode the JSON response from the Mandrill API: ' . $response_body); + + if(floor($info['http_code'] / 100) >= 4) { + throw $this->castError($result); + } + + return $result; + } + + public function readConfigs() { + $paths = array('~/.mandrill.key', '/etc/mandrill.key'); + foreach($paths as $path) { + if(file_exists($path)) { + $apikey = trim(file_get_contents($path)); + if($apikey) return $apikey; + } + } + return false; + } + + public function castError($result) { + if($result['status'] !== 'error' || !$result['name']) throw new Postman_Mandrill_Error('We received an unexpected error: ' . json_encode($result)); + + $class = (isset(self::$error_map[$result['name']])) ? self::$error_map[$result['name']] : 'Postman_Mandrill_Error'; + return new $class($result['message'], $result['code']); + } + + public function log($msg) { + if($this->debug) error_log($msg); + } +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Exceptions.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Exceptions.php new file mode 100644 index 0000000..8df8411 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Exceptions.php @@ -0,0 +1,151 @@ +master = $master; + } + + /** + * Returns information about an export job. If the export job's state is 'complete', +the returned data will include a URL you can use to fetch the results. Every export +job produces a zip archive, but the format of the archive is distinct for each job +type. The api calls that initiate exports include more details about the output format +for that job type. + * @param string $id an export job identifier + * @return struct the information about the export + * - id string the unique identifier for this Export. Use this identifier when checking the export job's status + * - created_at string the date and time that the export job was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - type string the type of the export job - activity, reject, or whitelist + * - finished_at string the date and time that the export job was finished as a UTC string in YYYY-MM-DD HH:MM:SS format + * - state string the export job's state - waiting, working, complete, error, or expired. + * - result_url string the url for the export job's results, if the job is completed. + */ + public function info($id) { + $_params = array("id" => $id); + return $this->master->call('exports/info', $_params); + } + + /** + * Returns a list of your exports. + * @return array the account's exports + * - return[] struct the individual export info + * - id string the unique identifier for this Export. Use this identifier when checking the export job's status + * - created_at string the date and time that the export job was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - type string the type of the export job - activity, reject, or whitelist + * - finished_at string the date and time that the export job was finished as a UTC string in YYYY-MM-DD HH:MM:SS format + * - state string the export job's state - waiting, working, complete, error, or expired. + * - result_url string the url for the export job's results, if the job is completed. + */ + public function getList() { + $_params = array(); + return $this->master->call('exports/list', $_params); + } + + /** + * Begins an export of your rejection blacklist. The blacklist will be exported to a zip archive +containing a single file named rejects.csv that includes the following fields: email, +reason, detail, created_at, expires_at, last_event_at, expires_at. + * @param string $notify_email an optional email address to notify when the export job has finished. + * @return struct information about the rejects export job that was started + * - id string the unique identifier for this Export. Use this identifier when checking the export job's status + * - created_at string the date and time that the export job was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - type string the type of the export job + * - finished_at string the date and time that the export job was finished as a UTC string in YYYY-MM-DD HH:MM:SS format, or null for jobs that have not run + * - state string the export job's state + * - result_url string the url for the export job's results, if the job is complete + */ + public function rejects($notify_email=null) { + $_params = array("notify_email" => $notify_email); + return $this->master->call('exports/rejects', $_params); + } + + /** + * Begins an export of your rejection whitelist. The whitelist will be exported to a zip archive +containing a single file named whitelist.csv that includes the following fields: +email, detail, created_at. + * @param string $notify_email an optional email address to notify when the export job has finished. + * @return struct information about the whitelist export job that was started + * - id string the unique identifier for this Export. Use this identifier when checking the export job's status + * - created_at string the date and time that the export job was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - type string the type of the export job + * - finished_at string the date and time that the export job was finished as a UTC string in YYYY-MM-DD HH:MM:SS format, or null for jobs that have not run + * - state string the export job's state + * - result_url string the url for the export job's results, if the job is complete + */ + public function whitelist($notify_email=null) { + $_params = array("notify_email" => $notify_email); + return $this->master->call('exports/whitelist', $_params); + } + + /** + * Begins an export of your activity history. The activity will be exported to a zip archive +containing a single file named activity.csv in the same format as you would be able to export +from your account's activity view. It includes the following fields: Date, Email Address, +Sender, Subject, Status, Tags, Opens, Clicks, Bounce Detail. If you have configured any custom +metadata fields, they will be included in the exported data. + * @param string $notify_email an optional email address to notify when the export job has finished + * @param string $date_from start date as a UTC string in YYYY-MM-DD HH:MM:SS format + * @param string $date_to end date as a UTC string in YYYY-MM-DD HH:MM:SS format + * @param array $tags an array of tag names to narrow the export to; will match messages that contain ANY of the tags + * - tags[] string a tag name + * @param array $senders an array of senders to narrow the export to + * - senders[] string a sender address + * @param array $states an array of states to narrow the export to; messages with ANY of the states will be included + * - states[] string a message state + * @param array $api_keys an array of api keys to narrow the export to; messsagse sent with ANY of the keys will be included + * - api_keys[] string an API key associated with your account + * @return struct information about the activity export job that was started + * - id string the unique identifier for this Export. Use this identifier when checking the export job's status + * - created_at string the date and time that the export job was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - type string the type of the export job + * - finished_at string the date and time that the export job was finished as a UTC string in YYYY-MM-DD HH:MM:SS format, or null for jobs that have not run + * - state string the export job's state + * - result_url string the url for the export job's results, if the job is complete + */ + public function activity($notify_email=null, $date_from=null, $date_to=null, $tags=null, $senders=null, $states=null, $api_keys=null) { + $_params = array("notify_email" => $notify_email, "date_from" => $date_from, "date_to" => $date_to, "tags" => $tags, "senders" => $senders, "states" => $states, "api_keys" => $api_keys); + return $this->master->call('exports/activity', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Inbound.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Inbound.php new file mode 100644 index 0000000..eadacad --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Inbound.php @@ -0,0 +1,138 @@ +master = $master; + } + + /** + * List the domains that have been configured for inbound delivery + * @return array the inbound domains associated with the account + * - return[] struct the individual domain info + * - domain string the domain name that is accepting mail + * - created_at string the date and time that the inbound domain was added as a UTC string in YYYY-MM-DD HH:MM:SS format + * - valid_mx boolean true if this inbound domain has successfully set up an MX record to deliver mail to the Mandrill servers + */ + public function domains() { + $_params = array(); + return $this->master->call('inbound/domains', $_params); + } + + /** + * Add an inbound domain to your account + * @param string $domain a domain name + * @return struct information about the domain + * - domain string the domain name that is accepting mail + * - created_at string the date and time that the inbound domain was added as a UTC string in YYYY-MM-DD HH:MM:SS format + * - valid_mx boolean true if this inbound domain has successfully set up an MX record to deliver mail to the Mandrill servers + */ + public function addDomain($domain) { + $_params = array("domain" => $domain); + return $this->master->call('inbound/add-domain', $_params); + } + + /** + * Check the MX settings for an inbound domain. The domain must have already been added with the add-domain call + * @param string $domain an existing inbound domain + * @return struct information about the inbound domain + * - domain string the domain name that is accepting mail + * - created_at string the date and time that the inbound domain was added as a UTC string in YYYY-MM-DD HH:MM:SS format + * - valid_mx boolean true if this inbound domain has successfully set up an MX record to deliver mail to the Mandrill servers + */ + public function checkDomain($domain) { + $_params = array("domain" => $domain); + return $this->master->call('inbound/check-domain', $_params); + } + + /** + * Delete an inbound domain from the account. All mail will stop routing for this domain immediately. + * @param string $domain an existing inbound domain + * @return struct information about the deleted domain + * - domain string the domain name that is accepting mail + * - created_at string the date and time that the inbound domain was added as a UTC string in YYYY-MM-DD HH:MM:SS format + * - valid_mx boolean true if this inbound domain has successfully set up an MX record to deliver mail to the Mandrill servers + */ + public function deleteDomain($domain) { + $_params = array("domain" => $domain); + return $this->master->call('inbound/delete-domain', $_params); + } + + /** + * List the mailbox routes defined for an inbound domain + * @param string $domain the domain to check + * @return array the routes associated with the domain + * - return[] struct the individual mailbox route + * - id string the unique identifier of the route + * - pattern string the search pattern that the mailbox name should match + * - url string the webhook URL where inbound messages will be published + */ + public function routes($domain) { + $_params = array("domain" => $domain); + return $this->master->call('inbound/routes', $_params); + } + + /** + * Add a new mailbox route to an inbound domain + * @param string $domain an existing inbound domain + * @param string $pattern the search pattern that the mailbox name should match + * @param string $url the webhook URL where the inbound messages will be published + * @return struct the added mailbox route information + * - id string the unique identifier of the route + * - pattern string the search pattern that the mailbox name should match + * - url string the webhook URL where inbound messages will be published + */ + public function addRoute($domain, $pattern, $url) { + $_params = array("domain" => $domain, "pattern" => $pattern, "url" => $url); + return $this->master->call('inbound/add-route', $_params); + } + + /** + * Update the pattern or webhook of an existing inbound mailbox route. If null is provided for any fields, the values will remain unchanged. + * @param string $id the unique identifier of an existing mailbox route + * @param string $pattern the search pattern that the mailbox name should match + * @param string $url the webhook URL where the inbound messages will be published + * @return struct the updated mailbox route information + * - id string the unique identifier of the route + * - pattern string the search pattern that the mailbox name should match + * - url string the webhook URL where inbound messages will be published + */ + public function updateRoute($id, $pattern=null, $url=null) { + $_params = array("id" => $id, "pattern" => $pattern, "url" => $url); + return $this->master->call('inbound/update-route', $_params); + } + + /** + * Delete an existing inbound mailbox route + * @param string $id the unique identifier of an existing route + * @return struct the deleted mailbox route information + * - id string the unique identifier of the route + * - pattern string the search pattern that the mailbox name should match + * - url string the webhook URL where inbound messages will be published + */ + public function deleteRoute($id) { + $_params = array("id" => $id); + return $this->master->call('inbound/delete-route', $_params); + } + + /** + * Take a raw MIME document destined for a domain with inbound domains set up, and send it to the inbound hook exactly as if it had been sent over SMTP + * @param string $raw_message the full MIME document of an email message + * @param array|null $to optionally define the recipients to receive the message - otherwise we'll use the To, Cc, and Bcc headers provided in the document + * - to[] string the email address of the recipient + * @param string $mail_from the address specified in the MAIL FROM stage of the SMTP conversation. Required for the SPF check. + * @param string $helo the identification provided by the client mta in the MTA state of the SMTP conversation. Required for the SPF check. + * @param string $client_address the remote MTA's ip address. Optional; required for the SPF check. + * @return array an array of the information for each recipient in the message (usually one) that matched an inbound route + * - return[] struct the individual recipient information + * - email string the email address of the matching recipient + * - pattern string the mailbox route pattern that the recipient matched + * - url string the webhook URL that the message was posted to + */ + public function sendRaw($raw_message, $to=null, $mail_from=null, $helo=null, $client_address=null) { + $_params = array("raw_message" => $raw_message, "to" => $to, "mail_from" => $mail_from, "helo" => $helo, "client_address" => $client_address); + return $this->master->call('inbound/send-raw', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Internal.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Internal.php new file mode 100644 index 0000000..2f42de3 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Internal.php @@ -0,0 +1,10 @@ +master = $master; + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Ips.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Ips.php new file mode 100644 index 0000000..2369c6b --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Ips.php @@ -0,0 +1,279 @@ +master = $master; + } + + /** + * Lists your dedicated IPs. + * @return array an array of structs for each dedicated IP + * - return[] struct information about a single dedicated IP + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function getList() { + $_params = array(); + return $this->master->call('ips/list', $_params); + } + + /** + * Retrieves information about a single dedicated ip. + * @param string $ip a dedicated IP address + * @return struct Information about the dedicated ip + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function info($ip) { + $_params = array("ip" => $ip); + return $this->master->call('ips/info', $_params); + } + + /** + * Requests an additional dedicated IP for your account. Accounts may +have one outstanding request at any time, and provisioning requests +are processed within 24 hours. + * @param boolean $warmup whether to enable warmup mode for the ip + * @param string $pool the id of the pool to add the dedicated ip to, or null to use your account's default pool + * @return struct a description of the provisioning request that was created + * - requested_at string the date and time that the request was created as a UTC timestamp in YYYY-MM-DD HH:MM:SS format + */ + public function provision($warmup=false, $pool=null) { + $_params = array("warmup" => $warmup, "pool" => $pool); + return $this->master->call('ips/provision', $_params); + } + + /** + * Begins the warmup process for a dedicated IP. During the warmup process, +Mandrill will gradually increase the percentage of your mail that is sent over +the warming-up IP, over a period of roughly 30 days. The rest of your mail +will be sent over shared IPs or other dedicated IPs in the same pool. + * @param string $ip a dedicated ip address + * @return struct Information about the dedicated IP + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function startWarmup($ip) { + $_params = array("ip" => $ip); + return $this->master->call('ips/start-warmup', $_params); + } + + /** + * Cancels the warmup process for a dedicated IP. + * @param string $ip a dedicated ip address + * @return struct Information about the dedicated IP + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function cancelWarmup($ip) { + $_params = array("ip" => $ip); + return $this->master->call('ips/cancel-warmup', $_params); + } + + /** + * Moves a dedicated IP to a different pool. + * @param string $ip a dedicated ip address + * @param string $pool the name of the new pool to add the dedicated ip to + * @param boolean $create_pool whether to create the pool if it does not exist; if false and the pool does not exist, an Unknown_Pool will be thrown. + * @return struct Information about the updated state of the dedicated IP + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function setPool($ip, $pool, $create_pool=false) { + $_params = array("ip" => $ip, "pool" => $pool, "create_pool" => $create_pool); + return $this->master->call('ips/set-pool', $_params); + } + + /** + * Deletes a dedicated IP. This is permanent and cannot be undone. + * @param string $ip the dedicated ip to remove from your account + * @return struct a description of the ip that was removed from your account. + * - ip string the ip address + * - deleted string a boolean indicating whether the ip was successfully deleted + */ + public function delete($ip) { + $_params = array("ip" => $ip); + return $this->master->call('ips/delete', $_params); + } + + /** + * Lists your dedicated IP pools. + * @return array the dedicated IP pools for your account, up to a maximum of 1,000 + * - return[] struct information about each dedicated IP pool + * - name string this pool's name + * - created_at string the date and time that this pool was created as a UTC timestamp in YYYY-MM-DD HH:MM:SS format + * - ips array the dedicated IPs in this pool + * - ips[] struct information about each dedicated IP + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function listPools() { + $_params = array(); + return $this->master->call('ips/list-pools', $_params); + } + + /** + * Describes a single dedicated IP pool. + * @param string $pool a pool name + * @return struct Information about the dedicated ip pool + * - name string this pool's name + * - created_at string the date and time that this pool was created as a UTC timestamp in YYYY-MM-DD HH:MM:SS format + * - ips array the dedicated IPs in this pool + * - ips[] struct information about each dedicated IP + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function poolInfo($pool) { + $_params = array("pool" => $pool); + return $this->master->call('ips/pool-info', $_params); + } + + /** + * Creates a pool and returns it. If a pool already exists with this +name, no action will be performed. + * @param string $pool the name of a pool to create + * @return struct Information about the dedicated ip pool + * - name string this pool's name + * - created_at string the date and time that this pool was created as a UTC timestamp in YYYY-MM-DD HH:MM:SS format + * - ips array the dedicated IPs in this pool + * - ips[] struct information about each dedicated IP + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function createPool($pool) { + $_params = array("pool" => $pool); + return $this->master->call('ips/create-pool', $_params); + } + + /** + * Deletes a pool. A pool must be empty before you can delete it, and you cannot delete your default pool. + * @param string $pool the name of the pool to delete + * @return struct information about the status of the pool that was deleted + * - pool string the name of the pool + * - deleted boolean whether the pool was deleted + */ + public function deletePool($pool) { + $_params = array("pool" => $pool); + return $this->master->call('ips/delete-pool', $_params); + } + + /** + * Tests whether a domain name is valid for use as the custom reverse +DNS for a dedicated IP. + * @param string $ip a dedicated ip address + * @param string $domain the domain name to test + * @return struct validation results for the domain + * - valid string whether the domain name has a correctly-configured A record pointing to the ip address + * - error string if valid is false, this will contain details about why the domain's A record is incorrect + */ + public function checkCustomDns($ip, $domain) { + $_params = array("ip" => $ip, "domain" => $domain); + return $this->master->call('ips/check-custom-dns', $_params); + } + + /** + * Configures the custom DNS name for a dedicated IP. + * @param string $ip a dedicated ip address + * @param string $domain a domain name to set as the dedicated IP's custom dns name. + * @return struct information about the dedicated IP's new configuration + * - ip string the ip address + * - created_at string the date and time that the dedicated IP was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - pool string the name of the pool that this dedicated IP belongs to + * - domain string the domain name (reverse dns) of this dedicated IP + * - custom_dns struct information about the ip's custom dns, if it has been configured + * - enabled boolean a boolean indicating whether custom dns has been configured for this ip + * - valid boolean whether the ip's custom dns is currently valid + * - error string if the ip's custom dns is invalid, this will include details about the error + * - warmup struct information about the ip's warmup status + * - warming_up boolean whether the ip is currently in warmup mode + * - start_at string the start time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + * - end_at string the end date and time for the warmup process as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function setCustomDns($ip, $domain) { + $_params = array("ip" => $ip, "domain" => $domain); + return $this->master->call('ips/set-custom-dns', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Messages.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Messages.php new file mode 100644 index 0000000..a9f4e76 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Messages.php @@ -0,0 +1,410 @@ +master = $master; + } + + /** + * Send a new transactional message through Mandrill + * @param struct $message the information on the message to send + * - html string the full HTML content to be sent + * - text string optional full text content to be sent + * - subject string the message subject + * - from_email string the sender email address. + * - from_name string optional from name to be used + * - to array an array of recipient information. + * - to[] struct a single recipient's information. + * - email string the email address of the recipient + * - name string the optional display name to use for the recipient + * - type string the header type to use for the recipient, defaults to "to" if not provided + * - headers struct optional extra headers to add to the message (most headers are allowed) + * - important boolean whether or not this message is important, and should be delivered ahead of non-important messages + * - track_opens boolean whether or not to turn on open tracking for the message + * - track_clicks boolean whether or not to turn on click tracking for the message + * - auto_text boolean whether or not to automatically generate a text part for messages that are not given text + * - auto_html boolean whether or not to automatically generate an HTML part for messages that are not given HTML + * - inline_css boolean whether or not to automatically inline all CSS styles provided in the message HTML - only for HTML documents less than 256KB in size + * - url_strip_qs boolean whether or not to strip the query string from URLs when aggregating tracked URL data + * - preserve_recipients boolean whether or not to expose all recipients in to "To" header for each email + * - view_content_link boolean set to false to remove content logging for sensitive emails + * - bcc_address string an optional address to receive an exact copy of each recipient's email + * - tracking_domain string a custom domain to use for tracking opens and clicks instead of mandrillapp.com + * - signing_domain string a custom domain to use for SPF/DKIM signing instead of mandrill (for "via" or "on behalf of" in email clients) + * - return_path_domain string a custom domain to use for the messages's return-path + * - merge boolean whether to evaluate merge tags in the message. Will automatically be set to true if either merge_vars or global_merge_vars are provided. + * - merge_language string the merge tag language to use when evaluating merge tags, either mailchimp or handlebars + * - global_merge_vars array global merge variables to use for all recipients. You can override these per recipient. + * - global_merge_vars[] struct a single global merge variable + * - name string the global merge variable's name. Merge variable names are case-insensitive and may not start with _ + * - content mixed the global merge variable's content + * - merge_vars array per-recipient merge variables, which override global merge variables with the same name. + * - merge_vars[] struct per-recipient merge variables + * - rcpt string the email address of the recipient that the merge variables should apply to + * - vars array the recipient's merge variables + * - vars[] struct a single merge variable + * - name string the merge variable's name. Merge variable names are case-insensitive and may not start with _ + * - content mixed the merge variable's content + * - tags array an array of string to tag the message with. Stats are accumulated using tags, though we only store the first 100 we see, so this should not be unique or change frequently. Tags should be 50 characters or less. Any tags starting with an underscore are reserved for internal use and will cause errors. + * - tags[] string a single tag - must not start with an underscore + * - subaccount string the unique id of a subaccount for this message - must already exist or will fail with an error + * - google_analytics_domains array an array of strings indicating for which any matching URLs will automatically have Google Analytics parameters appended to their query string automatically. + * - google_analytics_campaign array|string optional string indicating the value to set for the utm_campaign tracking parameter. If this isn't provided the email's from address will be used instead. + * - metadata array metadata an associative array of user metadata. Mandrill will store this metadata and make it available for retrieval. In addition, you can select up to 10 metadata fields to index and make searchable using the Mandrill search api. + * - recipient_metadata array Per-recipient metadata that will override the global values specified in the metadata parameter. + * - recipient_metadata[] struct metadata for a single recipient + * - rcpt string the email address of the recipient that the metadata is associated with + * - values array an associated array containing the recipient's unique metadata. If a key exists in both the per-recipient metadata and the global metadata, the per-recipient metadata will be used. + * - attachments array an array of supported attachments to add to the message + * - attachments[] struct a single supported attachment + * - type string the MIME type of the attachment + * - name string the file name of the attachment + * - content string the content of the attachment as a base64-encoded string + * - images array an array of embedded images to add to the message + * - images[] struct a single embedded image + * - type string the MIME type of the image - must start with "image/" + * - name string the Content ID of the image - use to reference the image in your HTML content + * - content string the content of the image as a base64-encoded string + * @param boolean $async enable a background sending mode that is optimized for bulk sending. In async mode, messages/send will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Defaults to false for messages with no more than 10 recipients; messages with more than 10 recipients are always sent asynchronously, regardless of the value of async. + * @param string $ip_pool the name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead. + * @param string $send_at when this message should be sent as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. If you specify a time in the past, the message will be sent immediately. An additional fee applies for scheduled email, and this feature is only available to accounts with a positive balance. + * @return array of structs for each recipient containing the key "email" with the email address, and details of the message status for that recipient + * - return[] struct the sending results for a single recipient + * - email string the email address of the recipient + * - status string the sending status of the recipient - either "sent", "queued", "scheduled", "rejected", or "invalid" + * - reject_reason string the reason for the rejection if the recipient status is "rejected" - one of "hard-bounce", "soft-bounce", "spam", "unsub", "custom", "invalid-sender", "invalid", "test-mode-limit", or "rule" + * - _id string the message's unique id + */ + public function send($message, $async=false, $ip_pool=null, $send_at=null) { + $_params = array("message" => $message, "async" => $async, "ip_pool" => $ip_pool, "send_at" => $send_at); + return $this->master->call('messages/send', $_params); + } + + /** + * Send a new transactional message through Mandrill using a template + * @param string $template_name the immutable name or slug of a template that exists in the user's account. For backwards-compatibility, the template name may also be used but the immutable slug is preferred. + * @param array $template_content an array of template content to send. Each item in the array should be a struct with two keys - name: the name of the content block to set the content for, and content: the actual content to put into the block + * - template_content[] struct the injection of a single piece of content into a single editable region + * - name string the name of the mc:edit editable region to inject into + * - content string the content to inject + * @param struct $message the other information on the message to send - same as /messages/send, but without the html content + * - html string optional full HTML content to be sent if not in template + * - text string optional full text content to be sent + * - subject string the message subject + * - from_email string the sender email address. + * - from_name string optional from name to be used + * - to array an array of recipient information. + * - to[] struct a single recipient's information. + * - email string the email address of the recipient + * - name string the optional display name to use for the recipient + * - type string the header type to use for the recipient, defaults to "to" if not provided + * - headers struct optional extra headers to add to the message (most headers are allowed) + * - important boolean whether or not this message is important, and should be delivered ahead of non-important messages + * - track_opens boolean whether or not to turn on open tracking for the message + * - track_clicks boolean whether or not to turn on click tracking for the message + * - auto_text boolean whether or not to automatically generate a text part for messages that are not given text + * - auto_html boolean whether or not to automatically generate an HTML part for messages that are not given HTML + * - inline_css boolean whether or not to automatically inline all CSS styles provided in the message HTML - only for HTML documents less than 256KB in size + * - url_strip_qs boolean whether or not to strip the query string from URLs when aggregating tracked URL data + * - preserve_recipients boolean whether or not to expose all recipients in to "To" header for each email + * - view_content_link boolean set to false to remove content logging for sensitive emails + * - bcc_address string an optional address to receive an exact copy of each recipient's email + * - tracking_domain string a custom domain to use for tracking opens and clicks instead of mandrillapp.com + * - signing_domain string a custom domain to use for SPF/DKIM signing instead of mandrill (for "via" or "on behalf of" in email clients) + * - return_path_domain string a custom domain to use for the messages's return-path + * - merge boolean whether to evaluate merge tags in the message. Will automatically be set to true if either merge_vars or global_merge_vars are provided. + * - merge_language string the merge tag language to use when evaluating merge tags, either mailchimp or handlebars + * - global_merge_vars array global merge variables to use for all recipients. You can override these per recipient. + * - global_merge_vars[] struct a single global merge variable + * - name string the global merge variable's name. Merge variable names are case-insensitive and may not start with _ + * - content mixed the global merge variable's content + * - merge_vars array per-recipient merge variables, which override global merge variables with the same name. + * - merge_vars[] struct per-recipient merge variables + * - rcpt string the email address of the recipient that the merge variables should apply to + * - vars array the recipient's merge variables + * - vars[] struct a single merge variable + * - name string the merge variable's name. Merge variable names are case-insensitive and may not start with _ + * - content mixed the merge variable's content + * - tags array an array of string to tag the message with. Stats are accumulated using tags, though we only store the first 100 we see, so this should not be unique or change frequently. Tags should be 50 characters or less. Any tags starting with an underscore are reserved for internal use and will cause errors. + * - tags[] string a single tag - must not start with an underscore + * - subaccount string the unique id of a subaccount for this message - must already exist or will fail with an error + * - google_analytics_domains array an array of strings indicating for which any matching URLs will automatically have Google Analytics parameters appended to their query string automatically. + * - google_analytics_campaign array|string optional string indicating the value to set for the utm_campaign tracking parameter. If this isn't provided the email's from address will be used instead. + * - metadata array metadata an associative array of user metadata. Mandrill will store this metadata and make it available for retrieval. In addition, you can select up to 10 metadata fields to index and make searchable using the Mandrill search api. + * - recipient_metadata array Per-recipient metadata that will override the global values specified in the metadata parameter. + * - recipient_metadata[] struct metadata for a single recipient + * - rcpt string the email address of the recipient that the metadata is associated with + * - values array an associated array containing the recipient's unique metadata. If a key exists in both the per-recipient metadata and the global metadata, the per-recipient metadata will be used. + * - attachments array an array of supported attachments to add to the message + * - attachments[] struct a single supported attachment + * - type string the MIME type of the attachment + * - name string the file name of the attachment + * - content string the content of the attachment as a base64-encoded string + * - images array an array of embedded images to add to the message + * - images[] struct a single embedded image + * - type string the MIME type of the image - must start with "image/" + * - name string the Content ID of the image - use to reference the image in your HTML content + * - content string the content of the image as a base64-encoded string + * @param boolean $async enable a background sending mode that is optimized for bulk sending. In async mode, messages/send will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Defaults to false for messages with no more than 10 recipients; messages with more than 10 recipients are always sent asynchronously, regardless of the value of async. + * @param string $ip_pool the name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead. + * @param string $send_at when this message should be sent as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. If you specify a time in the past, the message will be sent immediately. An additional fee applies for scheduled email, and this feature is only available to accounts with a positive balance. + * @return array of structs for each recipient containing the key "email" with the email address, and details of the message status for that recipient + * - return[] struct the sending results for a single recipient + * - email string the email address of the recipient + * - status string the sending status of the recipient - either "sent", "queued", "rejected", or "invalid" + * - reject_reason string the reason for the rejection if the recipient status is "rejected" - one of "hard-bounce", "soft-bounce", "spam", "unsub", "custom", "invalid-sender", "invalid", "test-mode-limit", or "rule" + * - _id string the message's unique id + */ + public function sendTemplate($template_name, $template_content, $message, $async=false, $ip_pool=null, $send_at=null) { + $_params = array("template_name" => $template_name, "template_content" => $template_content, "message" => $message, "async" => $async, "ip_pool" => $ip_pool, "send_at" => $send_at); + return $this->master->call('messages/send-template', $_params); + } + + /** + * Search recently sent messages and optionally narrow by date range, tags, senders, and API keys. If no date range is specified, results within the last 7 days are returned. This method may be called up to 20 times per minute. If you need the data more often, you can use /messages/info.json to get the information for a single message, or webhooks to push activity to your own application for querying. + * @param string $query search terms to find matching messages + * @param string $date_from start date + * @param string $date_to end date + * @param array $tags an array of tag names to narrow the search to, will return messages that contain ANY of the tags + * @param array $senders an array of sender addresses to narrow the search to, will return messages sent by ANY of the senders + * @param array $api_keys an array of API keys to narrow the search to, will return messages sent by ANY of the keys + * @param integer $limit the maximum number of results to return, defaults to 100, 1000 is the maximum + * @return array of structs for each matching message + * - return[] struct the information for a single matching message + * - ts integer the Unix timestamp from when this message was sent + * - _id string the message's unique id + * - sender string the email address of the sender + * - template string the unique name of the template used, if any + * - subject string the message's subject line + * - email string the recipient email address + * - tags array list of tags on this message + * - tags[] string individual tag on this message + * - opens integer how many times has this message been opened + * - opens_detail array list of individual opens for the message + * - opens_detail[] struct information on an individual open + * - ts integer the unix timestamp from when the message was opened + * - ip string the IP address that generated the open + * - location string the approximate region and country that the opening IP is located + * - ua string the email client or browser data of the open + * - clicks integer how many times has a link been clicked in this message + * - clicks_detail array list of individual clicks for the message + * - clicks_detail[] struct information on an individual click + * - ts integer the unix timestamp from when the message was clicked + * - url string the URL that was clicked on + * - ip string the IP address that generated the click + * - location string the approximate region and country that the clicking IP is located + * - ua string the email client or browser data of the click + * - state string sending status of this message: sent, bounced, rejected + * - metadata struct any custom metadata provided when the message was sent + * - smtp_events array a log of up to 3 smtp events for the message + * - smtp_events[] struct information about a specific smtp event + * - ts integer the Unix timestamp when the event occured + * - type string the message's state as a result of this event + * - diag string the SMTP response from the recipient's server + */ + public function search($query='*', $date_from=null, $date_to=null, $tags=null, $senders=null, $api_keys=null, $limit=100) { + $_params = array("query" => $query, "date_from" => $date_from, "date_to" => $date_to, "tags" => $tags, "senders" => $senders, "api_keys" => $api_keys, "limit" => $limit); + return $this->master->call('messages/search', $_params); + } + + /** + * Search the content of recently sent messages and return the aggregated hourly stats for matching messages + * @param string $query the search terms to find matching messages for + * @param string $date_from start date + * @param string $date_to end date + * @param array $tags an array of tag names to narrow the search to, will return messages that contain ANY of the tags + * @param array $senders an array of sender addresses to narrow the search to, will return messages sent by ANY of the senders + * @return array the array of history information + * - return[] struct the stats for a single hour + * - time string the hour as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the number of emails that were sent during the hour + * - hard_bounces integer the number of emails that hard bounced during the hour + * - soft_bounces integer the number of emails that soft bounced during the hour + * - rejects integer the number of emails that were rejected during the hour + * - complaints integer the number of spam complaints received during the hour + * - unsubs integer the number of unsubscribes received during the hour + * - opens integer the number of emails opened during the hour + * - unique_opens integer the number of unique opens generated by messages sent during the hour + * - clicks integer the number of tracked URLs clicked during the hour + * - unique_clicks integer the number of unique clicks generated by messages sent during the hour + */ + public function searchTimeSeries($query='*', $date_from=null, $date_to=null, $tags=null, $senders=null) { + $_params = array("query" => $query, "date_from" => $date_from, "date_to" => $date_to, "tags" => $tags, "senders" => $senders); + return $this->master->call('messages/search-time-series', $_params); + } + + /** + * Get the information for a single recently sent message + * @param string $id the unique id of the message to get - passed as the "_id" field in webhooks, send calls, or search calls + * @return struct the information for the message + * - ts integer the Unix timestamp from when this message was sent + * - _id string the message's unique id + * - sender string the email address of the sender + * - template string the unique name of the template used, if any + * - subject string the message's subject line + * - email string the recipient email address + * - tags array list of tags on this message + * - tags[] string individual tag on this message + * - opens integer how many times has this message been opened + * - opens_detail array list of individual opens for the message + * - opens_detail[] struct information on an individual open + * - ts integer the unix timestamp from when the message was opened + * - ip string the IP address that generated the open + * - location string the approximate region and country that the opening IP is located + * - ua string the email client or browser data of the open + * - clicks integer how many times has a link been clicked in this message + * - clicks_detail array list of individual clicks for the message + * - clicks_detail[] struct information on an individual click + * - ts integer the unix timestamp from when the message was clicked + * - url string the URL that was clicked on + * - ip string the IP address that generated the click + * - location string the approximate region and country that the clicking IP is located + * - ua string the email client or browser data of the click + * - state string sending status of this message: sent, bounced, rejected + * - metadata struct any custom metadata provided when the message was sent + * - smtp_events array a log of up to 3 smtp events for the message + * - smtp_events[] struct information about a specific smtp event + * - ts integer the Unix timestamp when the event occured + * - type string the message's state as a result of this event + * - diag string the SMTP response from the recipient's server + */ + public function info($id) { + $_params = array("id" => $id); + return $this->master->call('messages/info', $_params); + } + + /** + * Get the full content of a recently sent message + * @param string $id the unique id of the message to get - passed as the "_id" field in webhooks, send calls, or search calls + * @return struct the content of the message + * - ts integer the Unix timestamp from when this message was sent + * - _id string the message's unique id + * - from_email string the email address of the sender + * - from_name string the alias of the sender (if any) + * - subject string the message's subject line + * - to struct the message recipient's information + * - email string the email address of the recipient + * - name string the alias of the recipient (if any) + * - tags array list of tags on this message + * - tags[] string individual tag on this message + * - headers struct the key-value pairs of the custom MIME headers for the message's main document + * - text string the text part of the message, if any + * - html string the HTML part of the message, if any + * - attachments array an array of any attachments that can be found in the message + * - attachments[] struct information about an individual attachment + * - name string the file name of the attachment + * - type string the MIME type of the attachment + * - content string the content of the attachment as a base64 encoded string + */ + public function content($id) { + $_params = array("id" => $id); + return $this->master->call('messages/content', $_params); + } + + /** + * Parse the full MIME document for an email message, returning the content of the message broken into its constituent pieces + * @param string $raw_message the full MIME document of an email message + * @return struct the parsed message + * - subject string the subject of the message + * - from_email string the email address of the sender + * - from_name string the alias of the sender (if any) + * - to array an array of any recipients in the message + * - to[] struct the information on a single recipient + * - email string the email address of the recipient + * - name string the alias of the recipient (if any) + * - headers struct the key-value pairs of the MIME headers for the message's main document + * - text string the text part of the message, if any + * - html string the HTML part of the message, if any + * - attachments array an array of any attachments that can be found in the message + * - attachments[] struct information about an individual attachment + * - name string the file name of the attachment + * - type string the MIME type of the attachment + * - binary boolean if this is set to true, the attachment is not pure-text, and the content will be base64 encoded + * - content string the content of the attachment as a text string or a base64 encoded string based on the attachment type + * - images array an array of any embedded images that can be found in the message + * - images[] struct information about an individual image + * - name string the Content-ID of the embedded image + * - type string the MIME type of the image + * - content string the content of the image as a base64 encoded string + */ + public function parse($raw_message) { + $_params = array("raw_message" => $raw_message); + return $this->master->call('messages/parse', $_params); + } + + /** + * Take a raw MIME document for a message, and send it exactly as if it were sent through Mandrill's SMTP servers + * @param string $raw_message the full MIME document of an email message + * @param string|null $from_email optionally define the sender address - otherwise we'll use the address found in the provided headers + * @param string|null $from_name optionally define the sender alias + * @param array|null $to optionally define the recipients to receive the message - otherwise we'll use the To, Cc, and Bcc headers provided in the document + * - to[] string the email address of the recipient + * @param boolean $async enable a background sending mode that is optimized for bulk sending. In async mode, messages/sendRaw will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Defaults to false for messages with no more than 10 recipients; messages with more than 10 recipients are always sent asynchronously, regardless of the value of async. + * @param string $ip_pool the name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead. + * @param string $send_at when this message should be sent as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. If you specify a time in the past, the message will be sent immediately. + * @param string $return_path_domain a custom domain to use for the messages's return-path + * @return array of structs for each recipient containing the key "email" with the email address, and details of the message status for that recipient + * - return[] struct the sending results for a single recipient + * - email string the email address of the recipient + * - status string the sending status of the recipient - either "sent", "queued", "scheduled", "rejected", or "invalid" + * - reject_reason string the reason for the rejection if the recipient status is "rejected" - one of "hard-bounce", "soft-bounce", "spam", "unsub", "custom", "invalid-sender", "invalid", "test-mode-limit", or "rule" + * - _id string the message's unique id + */ + public function sendRaw($raw_message, $from_email=null, $from_name=null, $to=null, $async=false, $ip_pool=null, $send_at=null, $return_path_domain=null) { + $_params = array("raw_message" => $raw_message, "from_email" => $from_email, "from_name" => $from_name, "to" => $to, "async" => $async, "ip_pool" => $ip_pool, "send_at" => $send_at, "return_path_domain" => $return_path_domain); + return $this->master->call('messages/send-raw', $_params); + } + + /** + * Queries your scheduled emails. + * @param string $to an optional recipient address to restrict results to + * @return array a list of up to 1000 scheduled emails + * - return[] struct a scheduled email + * - _id string the scheduled message id + * - created_at string the UTC timestamp when the message was created, in YYYY-MM-DD HH:MM:SS format + * - send_at string the UTC timestamp when the message will be sent, in YYYY-MM-DD HH:MM:SS format + * - from_email string the email's sender address + * - to string the email's recipient + * - subject string the email's subject + */ + public function listScheduled($to=null) { + $_params = array("to" => $to); + return $this->master->call('messages/list-scheduled', $_params); + } + + /** + * Cancels a scheduled email. + * @param string $id a scheduled email id, as returned by any of the messages/send calls or messages/list-scheduled + * @return struct information about the scheduled email that was cancelled. + * - _id string the scheduled message id + * - created_at string the UTC timestamp when the message was created, in YYYY-MM-DD HH:MM:SS format + * - send_at string the UTC timestamp when the message will be sent, in YYYY-MM-DD HH:MM:SS format + * - from_email string the email's sender address + * - to string the email's recipient + * - subject string the email's subject + */ + public function cancelScheduled($id) { + $_params = array("id" => $id); + return $this->master->call('messages/cancel-scheduled', $_params); + } + + /** + * Reschedules a scheduled email. + * @param string $id a scheduled email id, as returned by any of the messages/send calls or messages/list-scheduled + * @param string $send_at the new UTC timestamp when the message should sent. Mandrill can't time travel, so if you specify a time in past the message will be sent immediately + * @return struct information about the scheduled email that was rescheduled. + * - _id string the scheduled message id + * - created_at string the UTC timestamp when the message was created, in YYYY-MM-DD HH:MM:SS format + * - send_at string the UTC timestamp when the message will be sent, in YYYY-MM-DD HH:MM:SS format + * - from_email string the email's sender address + * - to string the email's recipient + * - subject string the email's subject + */ + public function reschedule($id, $send_at) { + $_params = array("id" => $id, "send_at" => $send_at); + return $this->master->call('messages/reschedule', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Metadata.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Metadata.php new file mode 100644 index 0000000..ca681e9 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Metadata.php @@ -0,0 +1,64 @@ +master = $master; + } + + /** + * Get the list of custom metadata fields indexed for the account. + * @return array the custom metadata fields for the account + * - return[] struct the individual custom metadata field info + * - name string the unique identifier of the metadata field to update + * - state string the current state of the metadata field, one of "active", "delete", or "index" + * - view_template string Mustache template to control how the metadata is rendered in your activity log + */ + public function getList() { + $_params = array(); + return $this->master->call('metadata/list', $_params); + } + + /** + * Add a new custom metadata field to be indexed for the account. + * @param string $name a unique identifier for the metadata field + * @param string $view_template optional Mustache template to control how the metadata is rendered in your activity log + * @return struct the information saved about the new metadata field + * - name string the unique identifier of the metadata field to update + * - state string the current state of the metadata field, one of "active", "delete", or "index" + * - view_template string Mustache template to control how the metadata is rendered in your activity log + */ + public function add($name, $view_template=null) { + $_params = array("name" => $name, "view_template" => $view_template); + return $this->master->call('metadata/add', $_params); + } + + /** + * Update an existing custom metadata field. + * @param string $name the unique identifier of the metadata field to update + * @param string $view_template optional Mustache template to control how the metadata is rendered in your activity log + * @return struct the information for the updated metadata field + * - name string the unique identifier of the metadata field to update + * - state string the current state of the metadata field, one of "active", "delete", or "index" + * - view_template string Mustache template to control how the metadata is rendered in your activity log + */ + public function update($name, $view_template) { + $_params = array("name" => $name, "view_template" => $view_template); + return $this->master->call('metadata/update', $_params); + } + + /** + * Delete an existing custom metadata field. Deletion isn't instataneous, and /metadata/list will continue to return the field until the asynchronous deletion process is complete. + * @param string $name the unique identifier of the metadata field to update + * @return struct the information for the deleted metadata field + * - name string the unique identifier of the metadata field to update + * - state string the current state of the metadata field, one of "active", "delete", or "index" + * - view_template string Mustache template to control how the metadata is rendered in your activity log + */ + public function delete($name) { + $_params = array("name" => $name); + return $this->master->call('metadata/delete', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Rejects.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Rejects.php new file mode 100644 index 0000000..1e75d2b --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Rejects.php @@ -0,0 +1,80 @@ +master = $master; + } + + /** + * Adds an email to your email rejection blacklist. Addresses that you +add manually will never expire and there is no reputation penalty +for removing them from your blacklist. Attempting to blacklist an +address that has been whitelisted will have no effect. + * @param string $email an email address to block + * @param string $comment an optional comment describing the rejection + * @param string $subaccount an optional unique identifier for the subaccount to limit the blacklist entry + * @return struct a status object containing the address and the result of the operation + * - email string the email address you provided + * - added boolean whether the operation succeeded + */ + public function add($email, $comment=null, $subaccount=null) { + $_params = array("email" => $email, "comment" => $comment, "subaccount" => $subaccount); + return $this->master->call('rejects/add', $_params); + } + + /** + * Retrieves your email rejection blacklist. You can provide an email +address to limit the results. Returns up to 1000 results. By default, +entries that have expired are excluded from the results; set +include_expired to true to include them. + * @param string $email an optional email address to search by + * @param boolean $include_expired whether to include rejections that have already expired. + * @param string $subaccount an optional unique identifier for the subaccount to limit the blacklist + * @return array Up to 1000 rejection entries + * - return[] struct the information for each rejection blacklist entry + * - email string the email that is blocked + * - reason string the type of event (hard-bounce, soft-bounce, spam, unsub, custom) that caused this rejection + * - detail string extended details about the event, such as the SMTP diagnostic for bounces or the comment for manually-created rejections + * - created_at string when the email was added to the blacklist + * - last_event_at string the timestamp of the most recent event that either created or renewed this rejection + * - expires_at string when the blacklist entry will expire (this may be in the past) + * - expired boolean whether the blacklist entry has expired + * - sender struct the sender that this blacklist entry applies to, or null if none. + * - address string the sender's email address + * - created_at string the date and time that the sender was first seen by Mandrill as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the total number of messages sent by this sender + * - hard_bounces integer the total number of hard bounces by messages by this sender + * - soft_bounces integer the total number of soft bounces by messages by this sender + * - rejects integer the total number of rejected messages by this sender + * - complaints integer the total number of spam complaints received for messages by this sender + * - unsubs integer the total number of unsubscribe requests received for messages by this sender + * - opens integer the total number of times messages by this sender have been opened + * - clicks integer the total number of times tracked URLs in messages by this sender have been clicked + * - unique_opens integer the number of unique opens for emails sent for this sender + * - unique_clicks integer the number of unique clicks for emails sent for this sender + * - subaccount string the subaccount that this blacklist entry applies to, or null if none. + */ + public function getList($email=null, $include_expired=false, $subaccount=null) { + $_params = array("email" => $email, "include_expired" => $include_expired, "subaccount" => $subaccount); + return $this->master->call('rejects/list', $_params); + } + + /** + * Deletes an email rejection. There is no limit to how many rejections +you can remove from your blacklist, but keep in mind that each deletion +has an affect on your reputation. + * @param string $email an email address + * @param string $subaccount an optional unique identifier for the subaccount to limit the blacklist deletion + * @return struct a status object containing the address and whether the deletion succeeded. + * - email string the email address that was removed from the blacklist + * - deleted boolean whether the address was deleted successfully. + * - subaccount string the subaccount blacklist that the address was removed from, if any + */ + public function delete($email, $subaccount=null) { + $_params = array("email" => $email, "subaccount" => $subaccount); + return $this->master->call('rejects/delete', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Senders.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Senders.php new file mode 100644 index 0000000..4a939ab --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Senders.php @@ -0,0 +1,218 @@ +master = $master; + } + + /** + * Return the senders that have tried to use this account. + * @return array an array of sender data, one for each sending addresses used by the account + * - return[] struct the information on each sending address in the account + * - address string the sender's email address + * - created_at string the date and time that the sender was first seen by Mandrill as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the total number of messages sent by this sender + * - hard_bounces integer the total number of hard bounces by messages by this sender + * - soft_bounces integer the total number of soft bounces by messages by this sender + * - rejects integer the total number of rejected messages by this sender + * - complaints integer the total number of spam complaints received for messages by this sender + * - unsubs integer the total number of unsubscribe requests received for messages by this sender + * - opens integer the total number of times messages by this sender have been opened + * - clicks integer the total number of times tracked URLs in messages by this sender have been clicked + * - unique_opens integer the number of unique opens for emails sent for this sender + * - unique_clicks integer the number of unique clicks for emails sent for this sender + */ + public function getList() { + $_params = array(); + return $this->master->call('senders/list', $_params); + } + + /** + * Returns the sender domains that have been added to this account. + * @return array an array of sender domain data, one for each sending domain used by the account + * - return[] struct the information on each sending domain for the account + * - domain string the sender domain name + * - created_at string the date and time that the sending domain was first seen as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_tested_at string when the domain's DNS settings were last tested as a UTC string in YYYY-MM-DD HH:MM:SS format + * - spf struct details about the domain's SPF record + * - valid boolean whether the domain's SPF record is valid for use with Mandrill + * - valid_after string when the domain's SPF record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the spf record, or null if the record is correct + * - dkim struct details about the domain's DKIM record + * - valid boolean whether the domain's DKIM record is valid for use with Mandrill + * - valid_after string when the domain's DKIM record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the DKIM record, or null if the record is correct + * - verified_at string if the domain has been verified, this indicates when that verification occurred as a UTC string in YYYY-MM-DD HH:MM:SS format + * - valid_signing boolean whether this domain can be used to authenticate mail, either for itself or as a custom signing domain. If this is false but spf and dkim are both valid, you will need to verify the domain before using it to authenticate mail + */ + public function domains() { + $_params = array(); + return $this->master->call('senders/domains', $_params); + } + + /** + * Adds a sender domain to your account. Sender domains are added automatically as you +send, but you can use this call to add them ahead of time. + * @param string $domain a domain name + * @return struct information about the domain + * - domain string the sender domain name + * - created_at string the date and time that the sending domain was first seen as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_tested_at string when the domain's DNS settings were last tested as a UTC string in YYYY-MM-DD HH:MM:SS format + * - spf struct details about the domain's SPF record + * - valid boolean whether the domain's SPF record is valid for use with Mandrill + * - valid_after string when the domain's SPF record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the spf record, or null if the record is correct + * - dkim struct details about the domain's DKIM record + * - valid boolean whether the domain's DKIM record is valid for use with Mandrill + * - valid_after string when the domain's DKIM record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the DKIM record, or null if the record is correct + * - verified_at string if the domain has been verified, this indicates when that verification occurred as a UTC string in YYYY-MM-DD HH:MM:SS format + * - valid_signing boolean whether this domain can be used to authenticate mail, either for itself or as a custom signing domain. If this is false but spf and dkim are both valid, you will need to verify the domain before using it to authenticate mail + */ + public function addDomain($domain) { + $_params = array("domain" => $domain); + return $this->master->call('senders/add-domain', $_params); + } + + /** + * Checks the SPF and DKIM settings for a domain. If you haven't already added this domain to your +account, it will be added automatically. + * @param string $domain a domain name + * @return struct information about the sender domain + * - domain string the sender domain name + * - created_at string the date and time that the sending domain was first seen as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_tested_at string when the domain's DNS settings were last tested as a UTC string in YYYY-MM-DD HH:MM:SS format + * - spf struct details about the domain's SPF record + * - valid boolean whether the domain's SPF record is valid for use with Mandrill + * - valid_after string when the domain's SPF record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the spf record, or null if the record is correct + * - dkim struct details about the domain's DKIM record + * - valid boolean whether the domain's DKIM record is valid for use with Mandrill + * - valid_after string when the domain's DKIM record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the DKIM record, or null if the record is correct + * - verified_at string if the domain has been verified, this indicates when that verification occurred as a UTC string in YYYY-MM-DD HH:MM:SS format + * - valid_signing boolean whether this domain can be used to authenticate mail, either for itself or as a custom signing domain. If this is false but spf and dkim are both valid, you will need to verify the domain before using it to authenticate mail + */ + public function checkDomain($domain) { + $_params = array("domain" => $domain); + return $this->master->call('senders/check-domain', $_params); + } + + /** + * Sends a verification email in order to verify ownership of a domain. +Domain verification is a required step to confirm ownership of a domain. Once a +domain has been verified in a Mandrill account, other accounts may not have their +messages signed by that domain unless they also verify the domain. This prevents +other Mandrill accounts from sending mail signed by your domain. + * @param string $domain a domain name at which you can receive email + * @param string $mailbox a mailbox at the domain where the verification email should be sent + * @return struct information about the verification that was sent + * - status string "sent" indicates that the verification has been sent, "already_verified" indicates that the domain has already been verified with your account + * - domain string the domain name you provided + * - email string the email address the verification email was sent to + */ + public function verifyDomain($domain, $mailbox) { + $_params = array("domain" => $domain, "mailbox" => $mailbox); + return $this->master->call('senders/verify-domain', $_params); + } + + /** + * Return more detailed information about a single sender, including aggregates of recent stats + * @param string $address the email address of the sender + * @return struct the detailed information on the sender + * - address string the sender's email address + * - created_at string the date and time that the sender was first seen by Mandrill as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the total number of messages sent by this sender + * - hard_bounces integer the total number of hard bounces by messages by this sender + * - soft_bounces integer the total number of soft bounces by messages by this sender + * - rejects integer the total number of rejected messages by this sender + * - complaints integer the total number of spam complaints received for messages by this sender + * - unsubs integer the total number of unsubscribe requests received for messages by this sender + * - opens integer the total number of times messages by this sender have been opened + * - clicks integer the total number of times tracked URLs in messages by this sender have been clicked + * - stats struct an aggregate summary of the sender's sending stats + * - today struct stats for this sender so far today + * - sent integer the number of emails sent for this sender so far today + * - hard_bounces integer the number of emails hard bounced for this sender so far today + * - soft_bounces integer the number of emails soft bounced for this sender so far today + * - rejects integer the number of emails rejected for sending this sender so far today + * - complaints integer the number of spam complaints for this sender so far today + * - unsubs integer the number of unsubscribes for this sender so far today + * - opens integer the number of times emails have been opened for this sender so far today + * - unique_opens integer the number of unique opens for emails sent for this sender so far today + * - clicks integer the number of URLs that have been clicked for this sender so far today + * - unique_clicks integer the number of unique clicks for emails sent for this sender so far today + * - last_7_days struct stats for this sender in the last 7 days + * - sent integer the number of emails sent for this sender in the last 7 days + * - hard_bounces integer the number of emails hard bounced for this sender in the last 7 days + * - soft_bounces integer the number of emails soft bounced for this sender in the last 7 days + * - rejects integer the number of emails rejected for sending this sender in the last 7 days + * - complaints integer the number of spam complaints for this sender in the last 7 days + * - unsubs integer the number of unsubscribes for this sender in the last 7 days + * - opens integer the number of times emails have been opened for this sender in the last 7 days + * - unique_opens integer the number of unique opens for emails sent for this sender in the last 7 days + * - clicks integer the number of URLs that have been clicked for this sender in the last 7 days + * - unique_clicks integer the number of unique clicks for emails sent for this sender in the last 7 days + * - last_30_days struct stats for this sender in the last 30 days + * - sent integer the number of emails sent for this sender in the last 30 days + * - hard_bounces integer the number of emails hard bounced for this sender in the last 30 days + * - soft_bounces integer the number of emails soft bounced for this sender in the last 30 days + * - rejects integer the number of emails rejected for sending this sender in the last 30 days + * - complaints integer the number of spam complaints for this sender in the last 30 days + * - unsubs integer the number of unsubscribes for this sender in the last 30 days + * - opens integer the number of times emails have been opened for this sender in the last 30 days + * - unique_opens integer the number of unique opens for emails sent for this sender in the last 30 days + * - clicks integer the number of URLs that have been clicked for this sender in the last 30 days + * - unique_clicks integer the number of unique clicks for emails sent for this sender in the last 30 days + * - last_60_days struct stats for this sender in the last 60 days + * - sent integer the number of emails sent for this sender in the last 60 days + * - hard_bounces integer the number of emails hard bounced for this sender in the last 60 days + * - soft_bounces integer the number of emails soft bounced for this sender in the last 60 days + * - rejects integer the number of emails rejected for sending this sender in the last 60 days + * - complaints integer the number of spam complaints for this sender in the last 60 days + * - unsubs integer the number of unsubscribes for this sender in the last 60 days + * - opens integer the number of times emails have been opened for this sender in the last 60 days + * - unique_opens integer the number of unique opens for emails sent for this sender in the last 60 days + * - clicks integer the number of URLs that have been clicked for this sender in the last 60 days + * - unique_clicks integer the number of unique clicks for emails sent for this sender in the last 60 days + * - last_90_days struct stats for this sender in the last 90 days + * - sent integer the number of emails sent for this sender in the last 90 days + * - hard_bounces integer the number of emails hard bounced for this sender in the last 90 days + * - soft_bounces integer the number of emails soft bounced for this sender in the last 90 days + * - rejects integer the number of emails rejected for sending this sender in the last 90 days + * - complaints integer the number of spam complaints for this sender in the last 90 days + * - unsubs integer the number of unsubscribes for this sender in the last 90 days + * - opens integer the number of times emails have been opened for this sender in the last 90 days + * - unique_opens integer the number of unique opens for emails sent for this sender in the last 90 days + * - clicks integer the number of URLs that have been clicked for this sender in the last 90 days + * - unique_clicks integer the number of unique clicks for emails sent for this sender in the last 90 days + */ + public function info($address) { + $_params = array("address" => $address); + return $this->master->call('senders/info', $_params); + } + + /** + * Return the recent history (hourly stats for the last 30 days) for a sender + * @param string $address the email address of the sender + * @return array the array of history information + * - return[] struct the stats for a single hour + * - time string the hour as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the number of emails that were sent during the hour + * - hard_bounces integer the number of emails that hard bounced during the hour + * - soft_bounces integer the number of emails that soft bounced during the hour + * - rejects integer the number of emails that were rejected during the hour + * - complaints integer the number of spam complaints received during the hour + * - opens integer the number of emails opened during the hour + * - unique_opens integer the number of unique opens generated by messages sent during the hour + * - clicks integer the number of tracked URLs clicked during the hour + * - unique_clicks integer the number of unique clicks generated by messages sent during the hour + */ + public function timeSeries($address) { + $_params = array("address" => $address); + return $this->master->call('senders/time-series', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Subaccounts.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Subaccounts.php new file mode 100644 index 0000000..783aff7 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Subaccounts.php @@ -0,0 +1,171 @@ +master = $master; + } + + /** + * Get the list of subaccounts defined for the account, optionally filtered by a prefix + * @param string $q an optional prefix to filter the subaccounts' ids and names + * @return array the subaccounts for the account, up to a maximum of 1,000 + * - return[] struct the individual subaccount info + * - id string a unique indentifier for the subaccount + * - name string an optional display name for the subaccount + * - custom_quota integer an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation + * - status string the current sending status of the subaccount, one of "active" or "paused" + * - reputation integer the subaccount's current reputation on a scale from 0 to 100 + * - created_at string the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - first_sent_at string the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format + * - sent_weekly integer the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC) + * - sent_monthly integer the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC) + * - sent_total integer the number of emails the subaccount has sent since it was created + */ + public function getList($q=null) { + $_params = array("q" => $q); + return $this->master->call('subaccounts/list', $_params); + } + + /** + * Add a new subaccount + * @param string $id a unique identifier for the subaccount to be used in sending calls + * @param string $name an optional display name to further identify the subaccount + * @param string $notes optional extra text to associate with the subaccount + * @param integer $custom_quota an optional manual hourly quota for the subaccount. If not specified, Mandrill will manage this based on reputation + * @return struct the information saved about the new subaccount + * - id string a unique indentifier for the subaccount + * - name string an optional display name for the subaccount + * - custom_quota integer an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation + * - status string the current sending status of the subaccount, one of "active" or "paused" + * - reputation integer the subaccount's current reputation on a scale from 0 to 100 + * - created_at string the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - first_sent_at string the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format + * - sent_weekly integer the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC) + * - sent_monthly integer the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC) + * - sent_total integer the number of emails the subaccount has sent since it was created + */ + public function add($id, $name=null, $notes=null, $custom_quota=null) { + $_params = array("id" => $id, "name" => $name, "notes" => $notes, "custom_quota" => $custom_quota); + return $this->master->call('subaccounts/add', $_params); + } + + /** + * Given the ID of an existing subaccount, return the data about it + * @param string $id the unique identifier of the subaccount to query + * @return struct the information about the subaccount + * - id string a unique indentifier for the subaccount + * - name string an optional display name for the subaccount + * - notes string optional extra text to associate with the subaccount + * - custom_quota integer an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation + * - status string the current sending status of the subaccount, one of "active" or "paused" + * - reputation integer the subaccount's current reputation on a scale from 0 to 100 + * - created_at string the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - first_sent_at string the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format + * - sent_weekly integer the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC) + * - sent_monthly integer the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC) + * - sent_total integer the number of emails the subaccount has sent since it was created + * - sent_hourly integer the number of emails the subaccount has sent in the last hour + * - hourly_quota integer the current hourly quota for the subaccount, either manual or reputation-based + * - last_30_days struct stats for this subaccount in the last 30 days + * - sent integer the number of emails sent for this subaccount in the last 30 days + * - hard_bounces integer the number of emails hard bounced for this subaccount in the last 30 days + * - soft_bounces integer the number of emails soft bounced for this subaccount in the last 30 days + * - rejects integer the number of emails rejected for sending this subaccount in the last 30 days + * - complaints integer the number of spam complaints for this subaccount in the last 30 days + * - unsubs integer the number of unsbuscribes for this subaccount in the last 30 days + * - opens integer the number of times emails have been opened for this subaccount in the last 30 days + * - unique_opens integer the number of unique opens for emails sent for this subaccount in the last 30 days + * - clicks integer the number of URLs that have been clicked for this subaccount in the last 30 days + * - unique_clicks integer the number of unique clicks for emails sent for this subaccount in the last 30 days + */ + public function info($id) { + $_params = array("id" => $id); + return $this->master->call('subaccounts/info', $_params); + } + + /** + * Update an existing subaccount + * @param string $id the unique identifier of the subaccount to update + * @param string $name an optional display name to further identify the subaccount + * @param string $notes optional extra text to associate with the subaccount + * @param integer $custom_quota an optional manual hourly quota for the subaccount. If not specified, Mandrill will manage this based on reputation + * @return struct the information for the updated subaccount + * - id string a unique indentifier for the subaccount + * - name string an optional display name for the subaccount + * - custom_quota integer an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation + * - status string the current sending status of the subaccount, one of "active" or "paused" + * - reputation integer the subaccount's current reputation on a scale from 0 to 100 + * - created_at string the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - first_sent_at string the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format + * - sent_weekly integer the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC) + * - sent_monthly integer the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC) + * - sent_total integer the number of emails the subaccount has sent since it was created + */ + public function update($id, $name=null, $notes=null, $custom_quota=null) { + $_params = array("id" => $id, "name" => $name, "notes" => $notes, "custom_quota" => $custom_quota); + return $this->master->call('subaccounts/update', $_params); + } + + /** + * Delete an existing subaccount. Any email related to the subaccount will be saved, but stats will be removed and any future sending calls to this subaccount will fail. + * @param string $id the unique identifier of the subaccount to delete + * @return struct the information for the deleted subaccount + * - id string a unique indentifier for the subaccount + * - name string an optional display name for the subaccount + * - custom_quota integer an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation + * - status string the current sending status of the subaccount, one of "active" or "paused" + * - reputation integer the subaccount's current reputation on a scale from 0 to 100 + * - created_at string the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - first_sent_at string the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format + * - sent_weekly integer the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC) + * - sent_monthly integer the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC) + * - sent_total integer the number of emails the subaccount has sent since it was created + */ + public function delete($id) { + $_params = array("id" => $id); + return $this->master->call('subaccounts/delete', $_params); + } + + /** + * Pause a subaccount's sending. Any future emails delivered to this subaccount will be queued for a maximum of 3 days until the subaccount is resumed. + * @param string $id the unique identifier of the subaccount to pause + * @return struct the information for the paused subaccount + * - id string a unique indentifier for the subaccount + * - name string an optional display name for the subaccount + * - custom_quota integer an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation + * - status string the current sending status of the subaccount, one of "active" or "paused" + * - reputation integer the subaccount's current reputation on a scale from 0 to 100 + * - created_at string the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - first_sent_at string the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format + * - sent_weekly integer the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC) + * - sent_monthly integer the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC) + * - sent_total integer the number of emails the subaccount has sent since it was created + */ + public function pause($id) { + $_params = array("id" => $id); + return $this->master->call('subaccounts/pause', $_params); + } + + /** + * Resume a paused subaccount's sending + * @param string $id the unique identifier of the subaccount to resume + * @return struct the information for the resumed subaccount + * - id string a unique indentifier for the subaccount + * - name string an optional display name for the subaccount + * - custom_quota integer an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation + * - status string the current sending status of the subaccount, one of "active" or "paused" + * - reputation integer the subaccount's current reputation on a scale from 0 to 100 + * - created_at string the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - first_sent_at string the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format + * - sent_weekly integer the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC) + * - sent_monthly integer the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC) + * - sent_total integer the number of emails the subaccount has sent since it was created + */ + public function resume($id) { + $_params = array("id" => $id); + return $this->master->call('subaccounts/resume', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Tags.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Tags.php new file mode 100644 index 0000000..055b793 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Tags.php @@ -0,0 +1,174 @@ +master = $master; + } + + /** + * Return all of the user-defined tag information + * @return array a list of user-defined tags + * - return[] struct a user-defined tag + * - tag string the actual tag as a string + * - reputation integer the tag's current reputation on a scale from 0 to 100. + * - sent integer the total number of messages sent with this tag + * - hard_bounces integer the total number of hard bounces by messages with this tag + * - soft_bounces integer the total number of soft bounces by messages with this tag + * - rejects integer the total number of rejected messages with this tag + * - complaints integer the total number of spam complaints received for messages with this tag + * - unsubs integer the total number of unsubscribe requests received for messages with this tag + * - opens integer the total number of times messages with this tag have been opened + * - clicks integer the total number of times tracked URLs in messages with this tag have been clicked + * - unique_opens integer the number of unique opens for emails sent with this tag + * - unique_clicks integer the number of unique clicks for emails sent with this tag + */ + public function getList() { + $_params = array(); + return $this->master->call('tags/list', $_params); + } + + /** + * Deletes a tag permanently. Deleting a tag removes the tag from any messages +that have been sent, and also deletes the tag's stats. There is no way to +undo this operation, so use it carefully. + * @param string $tag a tag name + * @return struct the tag that was deleted + * - tag string the actual tag as a string + * - reputation integer the tag's current reputation on a scale from 0 to 100. + * - sent integer the total number of messages sent with this tag + * - hard_bounces integer the total number of hard bounces by messages with this tag + * - soft_bounces integer the total number of soft bounces by messages with this tag + * - rejects integer the total number of rejected messages with this tag + * - complaints integer the total number of spam complaints received for messages with this tag + * - unsubs integer the total number of unsubscribe requests received for messages with this tag + * - opens integer the total number of times messages with this tag have been opened + * - clicks integer the total number of times tracked URLs in messages with this tag have been clicked + * - unique_opens integer the number of unique opens for emails sent with this tag + * - unique_clicks integer the number of unique clicks for emails sent with this tag + */ + public function delete($tag) { + $_params = array("tag" => $tag); + return $this->master->call('tags/delete', $_params); + } + + /** + * Return more detailed information about a single tag, including aggregates of recent stats + * @param string $tag an existing tag name + * @return struct the detailed information on the tag + * - tag string the actual tag as a string + * - sent integer the total number of messages sent with this tag + * - hard_bounces integer the total number of hard bounces by messages with this tag + * - soft_bounces integer the total number of soft bounces by messages with this tag + * - rejects integer the total number of rejected messages with this tag + * - complaints integer the total number of spam complaints received for messages with this tag + * - unsubs integer the total number of unsubscribe requests received for messages with this tag + * - opens integer the total number of times messages with this tag have been opened + * - clicks integer the total number of times tracked URLs in messages with this tag have been clicked + * - stats struct an aggregate summary of the tag's sending stats + * - today struct stats with this tag so far today + * - sent integer the number of emails sent with this tag so far today + * - hard_bounces integer the number of emails hard bounced with this tag so far today + * - soft_bounces integer the number of emails soft bounced with this tag so far today + * - rejects integer the number of emails rejected for sending this tag so far today + * - complaints integer the number of spam complaints with this tag so far today + * - unsubs integer the number of unsubscribes with this tag so far today + * - opens integer the number of times emails have been opened with this tag so far today + * - unique_opens integer the number of unique opens for emails sent with this tag so far today + * - clicks integer the number of URLs that have been clicked with this tag so far today + * - unique_clicks integer the number of unique clicks for emails sent with this tag so far today + * - last_7_days struct stats with this tag in the last 7 days + * - sent integer the number of emails sent with this tag in the last 7 days + * - hard_bounces integer the number of emails hard bounced with this tag in the last 7 days + * - soft_bounces integer the number of emails soft bounced with this tag in the last 7 days + * - rejects integer the number of emails rejected for sending this tag in the last 7 days + * - complaints integer the number of spam complaints with this tag in the last 7 days + * - unsubs integer the number of unsubscribes with this tag in the last 7 days + * - opens integer the number of times emails have been opened with this tag in the last 7 days + * - unique_opens integer the number of unique opens for emails sent with this tag in the last 7 days + * - clicks integer the number of URLs that have been clicked with this tag in the last 7 days + * - unique_clicks integer the number of unique clicks for emails sent with this tag in the last 7 days + * - last_30_days struct stats with this tag in the last 30 days + * - sent integer the number of emails sent with this tag in the last 30 days + * - hard_bounces integer the number of emails hard bounced with this tag in the last 30 days + * - soft_bounces integer the number of emails soft bounced with this tag in the last 30 days + * - rejects integer the number of emails rejected for sending this tag in the last 30 days + * - complaints integer the number of spam complaints with this tag in the last 30 days + * - unsubs integer the number of unsubscribes with this tag in the last 30 days + * - opens integer the number of times emails have been opened with this tag in the last 30 days + * - unique_opens integer the number of unique opens for emails sent with this tag in the last 30 days + * - clicks integer the number of URLs that have been clicked with this tag in the last 30 days + * - unique_clicks integer the number of unique clicks for emails sent with this tag in the last 30 days + * - last_60_days struct stats with this tag in the last 60 days + * - sent integer the number of emails sent with this tag in the last 60 days + * - hard_bounces integer the number of emails hard bounced with this tag in the last 60 days + * - soft_bounces integer the number of emails soft bounced with this tag in the last 60 days + * - rejects integer the number of emails rejected for sending this tag in the last 60 days + * - complaints integer the number of spam complaints with this tag in the last 60 days + * - unsubs integer the number of unsubscribes with this tag in the last 60 days + * - opens integer the number of times emails have been opened with this tag in the last 60 days + * - unique_opens integer the number of unique opens for emails sent with this tag in the last 60 days + * - clicks integer the number of URLs that have been clicked with this tag in the last 60 days + * - unique_clicks integer the number of unique clicks for emails sent with this tag in the last 60 days + * - last_90_days struct stats with this tag in the last 90 days + * - sent integer the number of emails sent with this tag in the last 90 days + * - hard_bounces integer the number of emails hard bounced with this tag in the last 90 days + * - soft_bounces integer the number of emails soft bounced with this tag in the last 90 days + * - rejects integer the number of emails rejected for sending this tag in the last 90 days + * - complaints integer the number of spam complaints with this tag in the last 90 days + * - unsubs integer the number of unsubscribes with this tag in the last 90 days + * - opens integer the number of times emails have been opened with this tag in the last 90 days + * - unique_opens integer the number of unique opens for emails sent with this tag in the last 90 days + * - clicks integer the number of URLs that have been clicked with this tag in the last 90 days + * - unique_clicks integer the number of unique clicks for emails sent with this tag in the last 90 days + */ + public function info($tag) { + $_params = array("tag" => $tag); + return $this->master->call('tags/info', $_params); + } + + /** + * Return the recent history (hourly stats for the last 30 days) for a tag + * @param string $tag an existing tag name + * @return array the array of history information + * - return[] struct the stats for a single hour + * - time string the hour as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the number of emails that were sent during the hour + * - hard_bounces integer the number of emails that hard bounced during the hour + * - soft_bounces integer the number of emails that soft bounced during the hour + * - rejects integer the number of emails that were rejected during the hour + * - complaints integer the number of spam complaints received during the hour + * - unsubs integer the number of unsubscribes received during the hour + * - opens integer the number of emails opened during the hour + * - unique_opens integer the number of unique opens generated by messages sent during the hour + * - clicks integer the number of tracked URLs clicked during the hour + * - unique_clicks integer the number of unique clicks generated by messages sent during the hour + */ + public function timeSeries($tag) { + $_params = array("tag" => $tag); + return $this->master->call('tags/time-series', $_params); + } + + /** + * Return the recent history (hourly stats for the last 30 days) for all tags + * @return array the array of history information + * - return[] struct the stats for a single hour + * - time string the hour as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the number of emails that were sent during the hour + * - hard_bounces integer the number of emails that hard bounced during the hour + * - soft_bounces integer the number of emails that soft bounced during the hour + * - rejects integer the number of emails that were rejected during the hour + * - complaints integer the number of spam complaints received during the hour + * - unsubs integer the number of unsubscribes received during the hour + * - opens integer the number of emails opened during the hour + * - unique_opens integer the number of unique opens generated by messages sent during the hour + * - clicks integer the number of tracked URLs clicked during the hour + * - unique_clicks integer the number of unique clicks generated by messages sent during the hour + */ + public function allTimeSeries() { + $_params = array(); + return $this->master->call('tags/all-time-series', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Templates.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Templates.php new file mode 100644 index 0000000..7895926 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Templates.php @@ -0,0 +1,235 @@ +master = $master; + } + + /** + * Add a new template + * @param string $name the name for the new template - must be unique + * @param string $from_email a default sending address for emails sent using this template + * @param string $from_name a default from name to be used + * @param string $subject a default subject line to be used + * @param string $code the HTML code for the template with mc:edit attributes for the editable elements + * @param string $text a default text part to be used when sending with this template + * @param boolean $publish set to false to add a draft template without publishing + * @param array $labels an optional array of up to 10 labels to use for filtering templates + * - labels[] string a single label + * @return struct the information saved about the new template + * - slug string the immutable unique code name of the template + * - name string the name of the template + * - labels array the list of labels applied to the template + * - labels[] string a single label + * - code string the full HTML code of the template, with mc:edit attributes marking the editable elements - draft version + * - subject string the subject line of the template, if provided - draft version + * - from_email string the default sender address for the template, if provided - draft version + * - from_name string the default sender from name for the template, if provided - draft version + * - text string the default text part of messages sent with the template, if provided - draft version + * - publish_name string the same as the template name - kept as a separate field for backwards compatibility + * - publish_code string the full HTML code of the template, with mc:edit attributes marking the editable elements that are available as published, if it has been published + * - publish_subject string the subject line of the template, if provided + * - publish_from_email string the default sender address for the template, if provided + * - publish_from_name string the default sender from name for the template, if provided + * - publish_text string the default text part of messages sent with the template, if provided + * - published_at string the date and time the template was last published as a UTC string in YYYY-MM-DD HH:MM:SS format, or null if it has not been published + * - created_at string the date and time the template was first created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - updated_at string the date and time the template was last modified as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function add($name, $from_email=null, $from_name=null, $subject=null, $code=null, $text=null, $publish=true, $labels=array()) { + $_params = array("name" => $name, "from_email" => $from_email, "from_name" => $from_name, "subject" => $subject, "code" => $code, "text" => $text, "publish" => $publish, "labels" => $labels); + return $this->master->call('templates/add', $_params); + } + + /** + * Get the information for an existing template + * @param string $name the immutable name of an existing template + * @return struct the requested template information + * - slug string the immutable unique code name of the template + * - name string the name of the template + * - labels array the list of labels applied to the template + * - labels[] string a single label + * - code string the full HTML code of the template, with mc:edit attributes marking the editable elements - draft version + * - subject string the subject line of the template, if provided - draft version + * - from_email string the default sender address for the template, if provided - draft version + * - from_name string the default sender from name for the template, if provided - draft version + * - text string the default text part of messages sent with the template, if provided - draft version + * - publish_name string the same as the template name - kept as a separate field for backwards compatibility + * - publish_code string the full HTML code of the template, with mc:edit attributes marking the editable elements that are available as published, if it has been published + * - publish_subject string the subject line of the template, if provided + * - publish_from_email string the default sender address for the template, if provided + * - publish_from_name string the default sender from name for the template, if provided + * - publish_text string the default text part of messages sent with the template, if provided + * - published_at string the date and time the template was last published as a UTC string in YYYY-MM-DD HH:MM:SS format, or null if it has not been published + * - created_at string the date and time the template was first created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - updated_at string the date and time the template was last modified as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function info($name) { + $_params = array("name" => $name); + return $this->master->call('templates/info', $_params); + } + + /** + * Update the code for an existing template. If null is provided for any fields, the values will remain unchanged. + * @param string $name the immutable name of an existing template + * @param string $from_email the new default sending address + * @param string $from_name the new default from name + * @param string $subject the new default subject line + * @param string $code the new code for the template + * @param string $text the new default text part to be used + * @param boolean $publish set to false to update the draft version of the template without publishing + * @param array $labels an optional array of up to 10 labels to use for filtering templates + * - labels[] string a single label + * @return struct the template that was updated + * - slug string the immutable unique code name of the template + * - name string the name of the template + * - labels array the list of labels applied to the template + * - labels[] string a single label + * - code string the full HTML code of the template, with mc:edit attributes marking the editable elements - draft version + * - subject string the subject line of the template, if provided - draft version + * - from_email string the default sender address for the template, if provided - draft version + * - from_name string the default sender from name for the template, if provided - draft version + * - text string the default text part of messages sent with the template, if provided - draft version + * - publish_name string the same as the template name - kept as a separate field for backwards compatibility + * - publish_code string the full HTML code of the template, with mc:edit attributes marking the editable elements that are available as published, if it has been published + * - publish_subject string the subject line of the template, if provided + * - publish_from_email string the default sender address for the template, if provided + * - publish_from_name string the default sender from name for the template, if provided + * - publish_text string the default text part of messages sent with the template, if provided + * - published_at string the date and time the template was last published as a UTC string in YYYY-MM-DD HH:MM:SS format, or null if it has not been published + * - created_at string the date and time the template was first created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - updated_at string the date and time the template was last modified as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function update($name, $from_email=null, $from_name=null, $subject=null, $code=null, $text=null, $publish=true, $labels=null) { + $_params = array("name" => $name, "from_email" => $from_email, "from_name" => $from_name, "subject" => $subject, "code" => $code, "text" => $text, "publish" => $publish, "labels" => $labels); + return $this->master->call('templates/update', $_params); + } + + /** + * Publish the content for the template. Any new messages sent using this template will start using the content that was previously in draft. + * @param string $name the immutable name of an existing template + * @return struct the template that was published + * - slug string the immutable unique code name of the template + * - name string the name of the template + * - labels array the list of labels applied to the template + * - labels[] string a single label + * - code string the full HTML code of the template, with mc:edit attributes marking the editable elements - draft version + * - subject string the subject line of the template, if provided - draft version + * - from_email string the default sender address for the template, if provided - draft version + * - from_name string the default sender from name for the template, if provided - draft version + * - text string the default text part of messages sent with the template, if provided - draft version + * - publish_name string the same as the template name - kept as a separate field for backwards compatibility + * - publish_code string the full HTML code of the template, with mc:edit attributes marking the editable elements that are available as published, if it has been published + * - publish_subject string the subject line of the template, if provided + * - publish_from_email string the default sender address for the template, if provided + * - publish_from_name string the default sender from name for the template, if provided + * - publish_text string the default text part of messages sent with the template, if provided + * - published_at string the date and time the template was last published as a UTC string in YYYY-MM-DD HH:MM:SS format, or null if it has not been published + * - created_at string the date and time the template was first created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - updated_at string the date and time the template was last modified as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function publish($name) { + $_params = array("name" => $name); + return $this->master->call('templates/publish', $_params); + } + + /** + * Delete a template + * @param string $name the immutable name of an existing template + * @return struct the template that was deleted + * - slug string the immutable unique code name of the template + * - name string the name of the template + * - labels array the list of labels applied to the template + * - labels[] string a single label + * - code string the full HTML code of the template, with mc:edit attributes marking the editable elements - draft version + * - subject string the subject line of the template, if provided - draft version + * - from_email string the default sender address for the template, if provided - draft version + * - from_name string the default sender from name for the template, if provided - draft version + * - text string the default text part of messages sent with the template, if provided - draft version + * - publish_name string the same as the template name - kept as a separate field for backwards compatibility + * - publish_code string the full HTML code of the template, with mc:edit attributes marking the editable elements that are available as published, if it has been published + * - publish_subject string the subject line of the template, if provided + * - publish_from_email string the default sender address for the template, if provided + * - publish_from_name string the default sender from name for the template, if provided + * - publish_text string the default text part of messages sent with the template, if provided + * - published_at string the date and time the template was last published as a UTC string in YYYY-MM-DD HH:MM:SS format, or null if it has not been published + * - created_at string the date and time the template was first created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - updated_at string the date and time the template was last modified as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function delete($name) { + $_params = array("name" => $name); + return $this->master->call('templates/delete', $_params); + } + + /** + * Return a list of all the templates available to this user + * @param string $label an optional label to filter the templates + * @return array an array of structs with information about each template + * - return[] struct the information on each template in the account + * - slug string the immutable unique code name of the template + * - name string the name of the template + * - labels array the list of labels applied to the template + * - labels[] string a single label + * - code string the full HTML code of the template, with mc:edit attributes marking the editable elements - draft version + * - subject string the subject line of the template, if provided - draft version + * - from_email string the default sender address for the template, if provided - draft version + * - from_name string the default sender from name for the template, if provided - draft version + * - text string the default text part of messages sent with the template, if provided - draft version + * - publish_name string the same as the template name - kept as a separate field for backwards compatibility + * - publish_code string the full HTML code of the template, with mc:edit attributes marking the editable elements that are available as published, if it has been published + * - publish_subject string the subject line of the template, if provided + * - publish_from_email string the default sender address for the template, if provided + * - publish_from_name string the default sender from name for the template, if provided + * - publish_text string the default text part of messages sent with the template, if provided + * - published_at string the date and time the template was last published as a UTC string in YYYY-MM-DD HH:MM:SS format, or null if it has not been published + * - created_at string the date and time the template was first created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - updated_at string the date and time the template was last modified as a UTC string in YYYY-MM-DD HH:MM:SS format + */ + public function getList($label=null) { + $_params = array("label" => $label); + return $this->master->call('templates/list', $_params); + } + + /** + * Return the recent history (hourly stats for the last 30 days) for a template + * @param string $name the name of an existing template + * @return array the array of history information + * - return[] struct the stats for a single hour + * - time string the hour as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the number of emails that were sent during the hour + * - hard_bounces integer the number of emails that hard bounced during the hour + * - soft_bounces integer the number of emails that soft bounced during the hour + * - rejects integer the number of emails that were rejected during the hour + * - complaints integer the number of spam complaints received during the hour + * - opens integer the number of emails opened during the hour + * - unique_opens integer the number of unique opens generated by messages sent during the hour + * - clicks integer the number of tracked URLs clicked during the hour + * - unique_clicks integer the number of unique clicks generated by messages sent during the hour + */ + public function timeSeries($name) { + $_params = array("name" => $name); + return $this->master->call('templates/time-series', $_params); + } + + /** + * Inject content and optionally merge fields into a template, returning the HTML that results + * @param string $template_name the immutable name of a template that exists in the user's account + * @param array $template_content an array of template content to render. Each item in the array should be a struct with two keys - name: the name of the content block to set the content for, and content: the actual content to put into the block + * - template_content[] struct the injection of a single piece of content into a single editable region + * - name string the name of the mc:edit editable region to inject into + * - content string the content to inject + * @param array $merge_vars optional merge variables to use for injecting merge field content. If this is not provided, no merge fields will be replaced. + * - merge_vars[] struct a single merge variable + * - name string the merge variable's name. Merge variable names are case-insensitive and may not start with _ + * - content string the merge variable's content + * @return struct the result of rendering the given template with the content and merge field values injected + * - html string the rendered HTML as a string + */ + public function render($template_name, $template_content, $merge_vars=null) { + $_params = array("template_name" => $template_name, "template_content" => $template_content, "merge_vars" => $merge_vars); + return $this->master->call('templates/render', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Urls.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Urls.php new file mode 100644 index 0000000..333eaeb --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Urls.php @@ -0,0 +1,108 @@ +master = $master; + } + + /** + * Get the 100 most clicked URLs + * @return array the 100 most clicked URLs and their stats + * - return[] struct the individual URL stats + * - url string the URL to be tracked + * - sent integer the number of emails that contained the URL + * - clicks integer the number of times the URL has been clicked from a tracked email + * - unique_clicks integer the number of unique emails that have generated clicks for this URL + */ + public function getList() { + $_params = array(); + return $this->master->call('urls/list', $_params); + } + + /** + * Return the 100 most clicked URLs that match the search query given + * @param string $q a search query + * @return array the 100 most clicked URLs matching the search query + * - return[] struct the URL matching the query + * - url string the URL to be tracked + * - sent integer the number of emails that contained the URL + * - clicks integer the number of times the URL has been clicked from a tracked email + * - unique_clicks integer the number of unique emails that have generated clicks for this URL + */ + public function search($q) { + $_params = array("q" => $q); + return $this->master->call('urls/search', $_params); + } + + /** + * Return the recent history (hourly stats for the last 30 days) for a url + * @param string $url an existing URL + * @return array the array of history information + * - return[] struct the information for a single hour + * - time string the hour as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the number of emails that were sent with the URL during the hour + * - clicks integer the number of times the URL was clicked during the hour + * - unique_clicks integer the number of unique clicks generated for emails sent with this URL during the hour + */ + public function timeSeries($url) { + $_params = array("url" => $url); + return $this->master->call('urls/time-series', $_params); + } + + /** + * Get the list of tracking domains set up for this account + * @return array the tracking domains and their status + * - return[] struct the individual tracking domain + * - domain string the tracking domain name + * - created_at string the date and time that the tracking domain was added as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_tested_at string when the domain's DNS settings were last tested as a UTC string in YYYY-MM-DD HH:MM:SS format + * - cname struct details about the domain's CNAME record + * - valid boolean whether the domain's CNAME record is valid for use with Mandrill + * - valid_after string when the domain's CNAME record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the CNAME record, or null if the record is correct + * - valid_tracking boolean whether this domain can be used as a tracking domain for email. + */ + public function trackingDomains() { + $_params = array(); + return $this->master->call('urls/tracking-domains', $_params); + } + + /** + * Add a tracking domain to your account + * @param string $domain a domain name + * @return struct information about the domain + * - domain string the tracking domain name + * - created_at string the date and time that the tracking domain was added as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_tested_at string when the domain's DNS settings were last tested as a UTC string in YYYY-MM-DD HH:MM:SS format + * - cname struct details about the domain's CNAME record + * - valid boolean whether the domain's CNAME record is valid for use with Mandrill + * - valid_after string when the domain's CNAME record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the CNAME record, or null if the record is correct + * - valid_tracking boolean whether this domain can be used as a tracking domain for email. + */ + public function addTrackingDomain($domain) { + $_params = array("domain" => $domain); + return $this->master->call('urls/add-tracking-domain', $_params); + } + + /** + * Checks the CNAME settings for a tracking domain. The domain must have been added already with the add-tracking-domain call + * @param string $domain an existing tracking domain name + * @return struct information about the tracking domain + * - domain string the tracking domain name + * - created_at string the date and time that the tracking domain was added as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_tested_at string when the domain's DNS settings were last tested as a UTC string in YYYY-MM-DD HH:MM:SS format + * - cname struct details about the domain's CNAME record + * - valid boolean whether the domain's CNAME record is valid for use with Mandrill + * - valid_after string when the domain's CNAME record will be considered valid for use with Mandrill as a UTC string in YYYY-MM-DD HH:MM:SS format. If set, this indicates that the record is valid now, but was previously invalid, and Mandrill will wait until the record's TTL elapses to start using it. + * - error string an error describing the CNAME record, or null if the record is correct + * - valid_tracking boolean whether this domain can be used as a tracking domain for email. + */ + public function checkTrackingDomain($domain) { + $_params = array("domain" => $domain); + return $this->master->call('urls/check-tracking-domain', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Users.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Users.php new file mode 100644 index 0000000..72679d1 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Users.php @@ -0,0 +1,132 @@ +master = $master; + } + + /** + * Return the information about the API-connected user + * @return struct the user information including username, key, reputation, quota, and historical sending stats + * - username string the username of the user (used for SMTP authentication) + * - created_at string the date and time that the user's Mandrill account was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - public_id string a unique, permanent identifier for this user + * - reputation integer the reputation of the user on a scale from 0 to 100, with 75 generally being a "good" reputation + * - hourly_quota integer the maximum number of emails Mandrill will deliver for this user each hour. Any emails beyond that will be accepted and queued for later delivery. Users with higher reputations will have higher hourly quotas + * - backlog integer the number of emails that are queued for delivery due to exceeding your monthly or hourly quotas + * - stats struct an aggregate summary of the account's sending stats + * - today struct stats for this user so far today + * - sent integer the number of emails sent for this user so far today + * - hard_bounces integer the number of emails hard bounced for this user so far today + * - soft_bounces integer the number of emails soft bounced for this user so far today + * - rejects integer the number of emails rejected for sending this user so far today + * - complaints integer the number of spam complaints for this user so far today + * - unsubs integer the number of unsubscribes for this user so far today + * - opens integer the number of times emails have been opened for this user so far today + * - unique_opens integer the number of unique opens for emails sent for this user so far today + * - clicks integer the number of URLs that have been clicked for this user so far today + * - unique_clicks integer the number of unique clicks for emails sent for this user so far today + * - last_7_days struct stats for this user in the last 7 days + * - sent integer the number of emails sent for this user in the last 7 days + * - hard_bounces integer the number of emails hard bounced for this user in the last 7 days + * - soft_bounces integer the number of emails soft bounced for this user in the last 7 days + * - rejects integer the number of emails rejected for sending this user in the last 7 days + * - complaints integer the number of spam complaints for this user in the last 7 days + * - unsubs integer the number of unsubscribes for this user in the last 7 days + * - opens integer the number of times emails have been opened for this user in the last 7 days + * - unique_opens integer the number of unique opens for emails sent for this user in the last 7 days + * - clicks integer the number of URLs that have been clicked for this user in the last 7 days + * - unique_clicks integer the number of unique clicks for emails sent for this user in the last 7 days + * - last_30_days struct stats for this user in the last 30 days + * - sent integer the number of emails sent for this user in the last 30 days + * - hard_bounces integer the number of emails hard bounced for this user in the last 30 days + * - soft_bounces integer the number of emails soft bounced for this user in the last 30 days + * - rejects integer the number of emails rejected for sending this user in the last 30 days + * - complaints integer the number of spam complaints for this user in the last 30 days + * - unsubs integer the number of unsubscribes for this user in the last 30 days + * - opens integer the number of times emails have been opened for this user in the last 30 days + * - unique_opens integer the number of unique opens for emails sent for this user in the last 30 days + * - clicks integer the number of URLs that have been clicked for this user in the last 30 days + * - unique_clicks integer the number of unique clicks for emails sent for this user in the last 30 days + * - last_60_days struct stats for this user in the last 60 days + * - sent integer the number of emails sent for this user in the last 60 days + * - hard_bounces integer the number of emails hard bounced for this user in the last 60 days + * - soft_bounces integer the number of emails soft bounced for this user in the last 60 days + * - rejects integer the number of emails rejected for sending this user in the last 60 days + * - complaints integer the number of spam complaints for this user in the last 60 days + * - unsubs integer the number of unsubscribes for this user in the last 60 days + * - opens integer the number of times emails have been opened for this user in the last 60 days + * - unique_opens integer the number of unique opens for emails sent for this user in the last 60 days + * - clicks integer the number of URLs that have been clicked for this user in the last 60 days + * - unique_clicks integer the number of unique clicks for emails sent for this user in the last 60 days + * - last_90_days struct stats for this user in the last 90 days + * - sent integer the number of emails sent for this user in the last 90 days + * - hard_bounces integer the number of emails hard bounced for this user in the last 90 days + * - soft_bounces integer the number of emails soft bounced for this user in the last 90 days + * - rejects integer the number of emails rejected for sending this user in the last 90 days + * - complaints integer the number of spam complaints for this user in the last 90 days + * - unsubs integer the number of unsubscribes for this user in the last 90 days + * - opens integer the number of times emails have been opened for this user in the last 90 days + * - unique_opens integer the number of unique opens for emails sent for this user in the last 90 days + * - clicks integer the number of URLs that have been clicked for this user in the last 90 days + * - unique_clicks integer the number of unique clicks for emails sent for this user in the last 90 days + * - all_time struct stats for the lifetime of the user's account + * - sent integer the number of emails sent in the lifetime of the user's account + * - hard_bounces integer the number of emails hard bounced in the lifetime of the user's account + * - soft_bounces integer the number of emails soft bounced in the lifetime of the user's account + * - rejects integer the number of emails rejected for sending this user so far today + * - complaints integer the number of spam complaints in the lifetime of the user's account + * - unsubs integer the number of unsubscribes in the lifetime of the user's account + * - opens integer the number of times emails have been opened in the lifetime of the user's account + * - unique_opens integer the number of unique opens for emails sent in the lifetime of the user's account + * - clicks integer the number of URLs that have been clicked in the lifetime of the user's account + * - unique_clicks integer the number of unique clicks for emails sent in the lifetime of the user's account + */ + public function info() { + $_params = array(); + return $this->master->call('users/info', $_params); + } + + /** + * Validate an API key and respond to a ping + * @return string the string "PONG!" + */ + public function ping() { + $_params = array(); + return $this->master->call('users/ping', $_params); + } + + /** + * Validate an API key and respond to a ping (anal JSON parser version) + * @return struct a struct with one key "PING" with a static value "PONG!" + */ + public function ping2() { + $_params = array(); + return $this->master->call('users/ping2', $_params); + } + + /** + * Return the senders that have tried to use this account, both verified and unverified + * @return array an array of sender data, one for each sending addresses used by the account + * - return[] struct the information on each sending address in the account + * - address string the sender's email address + * - created_at string the date and time that the sender was first seen by Mandrill as a UTC date string in YYYY-MM-DD HH:MM:SS format + * - sent integer the total number of messages sent by this sender + * - hard_bounces integer the total number of hard bounces by messages by this sender + * - soft_bounces integer the total number of soft bounces by messages by this sender + * - rejects integer the total number of rejected messages by this sender + * - complaints integer the total number of spam complaints received for messages by this sender + * - unsubs integer the total number of unsubscribe requests received for messages by this sender + * - opens integer the total number of times messages by this sender have been opened + * - clicks integer the total number of times tracked URLs in messages by this sender have been clicked + * - unique_opens integer the number of unique opens for emails sent for this sender + * - unique_clicks integer the number of unique clicks for emails sent for this sender + */ + public function senders() { + $_params = array(); + return $this->master->call('users/senders', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Webhooks.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Webhooks.php new file mode 100644 index 0000000..203ec08 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Webhooks.php @@ -0,0 +1,122 @@ +master = $master; + } + + /** + * Get the list of all webhooks defined on the account + * @return array the webhooks associated with the account + * - return[] struct the individual webhook info + * - id integer a unique integer indentifier for the webhook + * - url string The URL that the event data will be posted to + * - description string a description of the webhook + * - auth_key string the key used to requests for this webhook + * - events array The message events that will be posted to the hook + * - events[] string the individual message event (send, hard_bounce, soft_bounce, open, click, spam, unsub, or reject) + * - created_at string the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_sent_at string the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format + * - batches_sent integer the number of event batches that have ever been sent to this webhook + * - events_sent integer the total number of events that have ever been sent to this webhook + * - last_error string if we've ever gotten an error trying to post to this webhook, the last error that we've seen + */ + public function getList() { + $_params = array(); + return $this->master->call('webhooks/list', $_params); + } + + /** + * Add a new webhook + * @param string $url the URL to POST batches of events + * @param string $description an optional description of the webhook + * @param array $events an optional list of events that will be posted to the webhook + * - events[] string the individual event to listen for + * @return struct the information saved about the new webhook + * - id integer a unique integer indentifier for the webhook + * - url string The URL that the event data will be posted to + * - description string a description of the webhook + * - auth_key string the key used to requests for this webhook + * - events array The message events that will be posted to the hook + * - events[] string the individual message event (send, hard_bounce, soft_bounce, open, click, spam, unsub, or reject) + * - created_at string the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_sent_at string the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format + * - batches_sent integer the number of event batches that have ever been sent to this webhook + * - events_sent integer the total number of events that have ever been sent to this webhook + * - last_error string if we've ever gotten an error trying to post to this webhook, the last error that we've seen + */ + public function add($url, $description=null, $events=array()) { + $_params = array("url" => $url, "description" => $description, "events" => $events); + return $this->master->call('webhooks/add', $_params); + } + + /** + * Given the ID of an existing webhook, return the data about it + * @param integer $id the unique identifier of a webhook belonging to this account + * @return struct the information about the webhook + * - id integer a unique integer indentifier for the webhook + * - url string The URL that the event data will be posted to + * - description string a description of the webhook + * - auth_key string the key used to requests for this webhook + * - events array The message events that will be posted to the hook + * - events[] string the individual message event (send, hard_bounce, soft_bounce, open, click, spam, unsub, or reject) + * - created_at string the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_sent_at string the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format + * - batches_sent integer the number of event batches that have ever been sent to this webhook + * - events_sent integer the total number of events that have ever been sent to this webhook + * - last_error string if we've ever gotten an error trying to post to this webhook, the last error that we've seen + */ + public function info($id) { + $_params = array("id" => $id); + return $this->master->call('webhooks/info', $_params); + } + + /** + * Update an existing webhook + * @param integer $id the unique identifier of a webhook belonging to this account + * @param string $url the URL to POST batches of events + * @param string $description an optional description of the webhook + * @param array $events an optional list of events that will be posted to the webhook + * - events[] string the individual event to listen for + * @return struct the information for the updated webhook + * - id integer a unique integer indentifier for the webhook + * - url string The URL that the event data will be posted to + * - description string a description of the webhook + * - auth_key string the key used to requests for this webhook + * - events array The message events that will be posted to the hook + * - events[] string the individual message event (send, hard_bounce, soft_bounce, open, click, spam, unsub, or reject) + * - created_at string the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_sent_at string the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format + * - batches_sent integer the number of event batches that have ever been sent to this webhook + * - events_sent integer the total number of events that have ever been sent to this webhook + * - last_error string if we've ever gotten an error trying to post to this webhook, the last error that we've seen + */ + public function update($id, $url, $description=null, $events=array()) { + $_params = array("id" => $id, "url" => $url, "description" => $description, "events" => $events); + return $this->master->call('webhooks/update', $_params); + } + + /** + * Delete an existing webhook + * @param integer $id the unique identifier of a webhook belonging to this account + * @return struct the information for the deleted webhook + * - id integer a unique integer indentifier for the webhook + * - url string The URL that the event data will be posted to + * - description string a description of the webhook + * - auth_key string the key used to requests for this webhook + * - events array The message events that will be posted to the hook + * - events[] string the individual message event (send, hard_bounce, soft_bounce, open, click, spam, unsub, or reject) + * - created_at string the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format + * - last_sent_at string the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format + * - batches_sent integer the number of event batches that have ever been sent to this webhook + * - events_sent integer the total number of events that have ever been sent to this webhook + * - last_error string if we've ever gotten an error trying to post to this webhook, the last error that we've seen + */ + public function delete($id) { + $_params = array("id" => $id); + return $this->master->call('webhooks/delete', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Whitelists.php b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Whitelists.php new file mode 100644 index 0000000..fe73445 --- /dev/null +++ b/Postman/Postman-Mail/mailchimp-mandrill-api-php-da3adc10042e/src/Mandrill/Whitelists.php @@ -0,0 +1,52 @@ +master = $master; + } + + /** + * Adds an email to your email rejection whitelist. If the address is +currently on your blacklist, that blacklist entry will be removed +automatically. + * @param string $email an email address to add to the whitelist + * @param string $comment an optional description of why the email was whitelisted + * @return struct a status object containing the address and the result of the operation + * - email string the email address you provided + * - added boolean whether the operation succeeded + */ + public function add($email, $comment=null) { + $_params = array("email" => $email, "comment" => $comment); + return $this->master->call('whitelists/add', $_params); + } + + /** + * Retrieves your email rejection whitelist. You can provide an email +address or search prefix to limit the results. Returns up to 1000 results. + * @param string $email an optional email address or prefix to search by + * @return array up to 1000 whitelist entries + * - return[] struct the information for each whitelist entry + * - email string the email that is whitelisted + * - detail string a description of why the email was whitelisted + * - created_at string when the email was added to the whitelist + */ + public function getList($email=null) { + $_params = array("email" => $email); + return $this->master->call('whitelists/list', $_params); + } + + /** + * Removes an email address from the whitelist. + * @param string $email the email address to remove from the whitelist + * @return struct a status object containing the address and whether the deletion succeeded + * - email string the email address that was removed from the blacklist + * - deleted boolean whether the address was deleted successfully + */ + public function delete($email) { + $_params = array("email" => $email); + return $this->master->call('whitelists/delete', $_params); + } + +} + + diff --git a/Postman/Postman-Mail/mailgun/composer.json b/Postman/Postman-Mail/mailgun/composer.json new file mode 100644 index 0000000..4806c80 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/composer.json @@ -0,0 +1,7 @@ +{ + "require": { + "mailgun/mailgun-php": "^2.3", + "php-http/curl-client": "^1.7", + "guzzlehttp/psr7": "^1.4" + } +} diff --git a/Postman/Postman-Mail/mailgun/composer.lock b/Postman/Postman-Mail/mailgun/composer.lock new file mode 100644 index 0000000..a00eb9e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/composer.lock @@ -0,0 +1,801 @@ +{ + "_readme": [ + "This file locks the dependencies of your project to a known state", + "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file", + "This file is @generated automatically" + ], + "hash": "313ef327f6509ec8ad576598f4256808", + "content-hash": "262cbcab9c136c29b36e81b0562c427a", + "packages": [ + { + "name": "clue/stream-filter", + "version": "v1.4.0", + "source": { + "type": "git", + "url": "https://github.com/clue/php-stream-filter.git", + "reference": "d80fdee9b3a7e0d16fc330a22f41f3ad0eeb09d0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/clue/php-stream-filter/zipball/d80fdee9b3a7e0d16fc330a22f41f3ad0eeb09d0", + "reference": "d80fdee9b3a7e0d16fc330a22f41f3ad0eeb09d0", + "shasum": "" + }, + "require": { + "php": ">=5.3" + }, + "require-dev": { + "phpunit/phpunit": "^5.0 || ^4.8" + }, + "type": "library", + "autoload": { + "psr-4": { + "Clue\\StreamFilter\\": "src/" + }, + "files": [ + "src/functions.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Christian Lück", + "email": "christian@lueck.tv" + } + ], + "description": "A simple and modern approach to stream filtering in PHP", + "homepage": "https://github.com/clue/php-stream-filter", + "keywords": [ + "bucket brigade", + "callback", + "filter", + "php_user_filter", + "stream", + "stream_filter_append", + "stream_filter_register" + ], + "time": "2017-08-18 09:54:01" + }, + { + "name": "guzzlehttp/psr7", + "version": "1.4.2", + "source": { + "type": "git", + "url": "https://github.com/guzzle/psr7.git", + "reference": "f5b8a8512e2b58b0071a7280e39f14f72e05d87c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/psr7/zipball/f5b8a8512e2b58b0071a7280e39f14f72e05d87c", + "reference": "f5b8a8512e2b58b0071a7280e39f14f72e05d87c", + "shasum": "" + }, + "require": { + "php": ">=5.4.0", + "psr/http-message": "~1.0" + }, + "provide": { + "psr/http-message-implementation": "1.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\Psr7\\": "src/" + }, + "files": [ + "src/functions_include.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "Tobias Schultze", + "homepage": "https://github.com/Tobion" + } + ], + "description": "PSR-7 message implementation that also provides common utility methods", + "keywords": [ + "http", + "message", + "request", + "response", + "stream", + "uri", + "url" + ], + "time": "2017-03-20 17:10:46" + }, + { + "name": "mailgun/mailgun-php", + "version": "2.3.4", + "source": { + "type": "git", + "url": "https://github.com/mailgun/mailgun-php.git", + "reference": "f58c5914aefa16fa6ed2b5cf9ee84d40cbda1b3a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/mailgun/mailgun-php/zipball/f58c5914aefa16fa6ed2b5cf9ee84d40cbda1b3a", + "reference": "f58c5914aefa16fa6ed2b5cf9ee84d40cbda1b3a", + "shasum": "" + }, + "require": { + "php": "^5.5|^7.0", + "php-http/client-common": "^1.1", + "php-http/discovery": "^1.0", + "php-http/httplug": "^1.0", + "php-http/message": "^1.0", + "php-http/multipart-stream-builder": "^1.0", + "webmozart/assert": "^1.2" + }, + "require-dev": { + "guzzlehttp/psr7": "^1.4", + "php-http/guzzle6-adapter": "^1.0", + "phpunit/phpunit": "~4.8" + }, + "type": "library", + "autoload": { + "psr-0": { + "Mailgun": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Travis Swientek", + "email": "travis@mailgunhq.com" + } + ], + "description": "The Mailgun SDK provides methods for all API functions.", + "time": "2017-06-20 19:56:09" + }, + { + "name": "php-http/client-common", + "version": "1.7.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/client-common.git", + "reference": "9accb4a082eb06403747c0ffd444112eda41a0fd" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/client-common/zipball/9accb4a082eb06403747c0ffd444112eda41a0fd", + "reference": "9accb4a082eb06403747c0ffd444112eda41a0fd", + "shasum": "" + }, + "require": { + "php": "^5.4 || ^7.0", + "php-http/httplug": "^1.1", + "php-http/message": "^1.6", + "php-http/message-factory": "^1.0", + "symfony/options-resolver": "^2.6 || ^3.0 || ^4.0" + }, + "require-dev": { + "guzzlehttp/psr7": "^1.4", + "phpspec/phpspec": "^2.5 || ^3.4 || ^4.2" + }, + "suggest": { + "php-http/cache-plugin": "PSR-6 Cache plugin", + "php-http/logger-plugin": "PSR-3 Logger plugin", + "php-http/stopwatch-plugin": "Symfony Stopwatch plugin" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.7-dev" + } + }, + "autoload": { + "psr-4": { + "Http\\Client\\Common\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "Common HTTP Client implementations and tools for HTTPlug", + "homepage": "http://httplug.io", + "keywords": [ + "client", + "common", + "http", + "httplug" + ], + "time": "2017-11-30 11:06:59" + }, + { + "name": "php-http/curl-client", + "version": "v1.7.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/curl-client.git", + "reference": "0972ad0d7d37032a52077a5cbe27cf370f2007d8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/curl-client/zipball/0972ad0d7d37032a52077a5cbe27cf370f2007d8", + "reference": "0972ad0d7d37032a52077a5cbe27cf370f2007d8", + "shasum": "" + }, + "require": { + "ext-curl": "*", + "php": "^5.5 || ^7.0", + "php-http/discovery": "^1.0", + "php-http/httplug": "^1.0", + "php-http/message": "^1.2", + "php-http/message-factory": "^1.0.2" + }, + "provide": { + "php-http/async-client-implementation": "1.0", + "php-http/client-implementation": "1.0" + }, + "require-dev": { + "guzzlehttp/psr7": "^1.0", + "php-http/client-integration-tests": "^0.5.1", + "phpunit/phpunit": "^4.8.27", + "zendframework/zend-diactoros": "^1.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Http\\Client\\Curl\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Михаил Красильников", + "email": "m.krasilnikov@yandex.ru" + } + ], + "description": "cURL client for PHP-HTTP", + "homepage": "http://php-http.org", + "keywords": [ + "curl", + "http" + ], + "time": "2017-02-09 15:18:33" + }, + { + "name": "php-http/discovery", + "version": "1.3.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/discovery.git", + "reference": "7b50ab4d6c9fdaa1ed53ae310c955900af6e3372" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/discovery/zipball/7b50ab4d6c9fdaa1ed53ae310c955900af6e3372", + "reference": "7b50ab4d6c9fdaa1ed53ae310c955900af6e3372", + "shasum": "" + }, + "require": { + "php": "^5.5 || ^7.0" + }, + "require-dev": { + "henrikbjorn/phpspec-code-coverage": "^2.0.2", + "php-http/httplug": "^1.0", + "php-http/message-factory": "^1.0", + "phpspec/phpspec": "^2.4", + "puli/composer-plugin": "1.0.0-beta10" + }, + "suggest": { + "php-http/message": "Allow to use Guzzle, Diactoros or Slim Framework factories", + "puli/composer-plugin": "Sets up Puli which is recommended for Discovery to work. Check http://docs.php-http.org/en/latest/discovery.html for more details." + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.3-dev" + } + }, + "autoload": { + "psr-4": { + "Http\\Discovery\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "Finds installed HTTPlug implementations and PSR-7 message factories", + "homepage": "http://php-http.org", + "keywords": [ + "adapter", + "client", + "discovery", + "factory", + "http", + "message", + "psr7" + ], + "time": "2017-08-03 10:12:53" + }, + { + "name": "php-http/httplug", + "version": "v1.1.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/httplug.git", + "reference": "1c6381726c18579c4ca2ef1ec1498fdae8bdf018" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/httplug/zipball/1c6381726c18579c4ca2ef1ec1498fdae8bdf018", + "reference": "1c6381726c18579c4ca2ef1ec1498fdae8bdf018", + "shasum": "" + }, + "require": { + "php": ">=5.4", + "php-http/promise": "^1.0", + "psr/http-message": "^1.0" + }, + "require-dev": { + "henrikbjorn/phpspec-code-coverage": "^1.0", + "phpspec/phpspec": "^2.4" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.1-dev" + } + }, + "autoload": { + "psr-4": { + "Http\\Client\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Eric GELOEN", + "email": "geloen.eric@gmail.com" + }, + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "HTTPlug, the HTTP client abstraction for PHP", + "homepage": "http://httplug.io", + "keywords": [ + "client", + "http" + ], + "time": "2016-08-31 08:30:17" + }, + { + "name": "php-http/message", + "version": "1.6.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/message.git", + "reference": "2edd63bae5f52f79363c5f18904b05ce3a4b7253" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/message/zipball/2edd63bae5f52f79363c5f18904b05ce3a4b7253", + "reference": "2edd63bae5f52f79363c5f18904b05ce3a4b7253", + "shasum": "" + }, + "require": { + "clue/stream-filter": "^1.3", + "php": ">=5.4", + "php-http/message-factory": "^1.0.2", + "psr/http-message": "^1.0" + }, + "provide": { + "php-http/message-factory-implementation": "1.0" + }, + "require-dev": { + "akeneo/phpspec-skip-example-extension": "^1.0", + "coduo/phpspec-data-provider-extension": "^1.0", + "ext-zlib": "*", + "guzzlehttp/psr7": "^1.0", + "henrikbjorn/phpspec-code-coverage": "^1.0", + "phpspec/phpspec": "^2.4", + "slim/slim": "^3.0", + "zendframework/zend-diactoros": "^1.0" + }, + "suggest": { + "ext-zlib": "Used with compressor/decompressor streams", + "guzzlehttp/psr7": "Used with Guzzle PSR-7 Factories", + "slim/slim": "Used with Slim Framework PSR-7 implementation", + "zendframework/zend-diactoros": "Used with Diactoros Factories" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.6-dev" + } + }, + "autoload": { + "psr-4": { + "Http\\Message\\": "src/" + }, + "files": [ + "src/filters.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "HTTP Message related tools", + "homepage": "http://php-http.org", + "keywords": [ + "http", + "message", + "psr-7" + ], + "time": "2017-07-05 06:40:53" + }, + { + "name": "php-http/message-factory", + "version": "v1.0.2", + "source": { + "type": "git", + "url": "https://github.com/php-http/message-factory.git", + "reference": "a478cb11f66a6ac48d8954216cfed9aa06a501a1" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/message-factory/zipball/a478cb11f66a6ac48d8954216cfed9aa06a501a1", + "reference": "a478cb11f66a6ac48d8954216cfed9aa06a501a1", + "shasum": "" + }, + "require": { + "php": ">=5.4", + "psr/http-message": "^1.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0-dev" + } + }, + "autoload": { + "psr-4": { + "Http\\Message\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "Factory interfaces for PSR-7 HTTP Message", + "homepage": "http://php-http.org", + "keywords": [ + "factory", + "http", + "message", + "stream", + "uri" + ], + "time": "2015-12-19 14:08:53" + }, + { + "name": "php-http/multipart-stream-builder", + "version": "1.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/multipart-stream-builder.git", + "reference": "1fa3c623fc813a43b39494b2a1612174e36e0fb0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/multipart-stream-builder/zipball/1fa3c623fc813a43b39494b2a1612174e36e0fb0", + "reference": "1fa3c623fc813a43b39494b2a1612174e36e0fb0", + "shasum": "" + }, + "require": { + "php": "^5.5 || ^7.0", + "php-http/discovery": "^1.0", + "php-http/message-factory": "^1.0.2", + "psr/http-message": "^1.0" + }, + "require-dev": { + "php-http/message": "^1.5", + "phpunit/phpunit": "^4.8 || ^5.4", + "zendframework/zend-diactoros": "^1.3.5" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "0.3-dev" + } + }, + "autoload": { + "psr-4": { + "Http\\Message\\MultipartStream\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Tobias Nyholm", + "email": "tobias.nyholm@gmail.com" + } + ], + "description": "A builder class that help you create a multipart stream", + "homepage": "http://php-http.org", + "keywords": [ + "factory", + "http", + "message", + "multipart stream", + "stream" + ], + "time": "2017-05-21 17:45:25" + }, + { + "name": "php-http/promise", + "version": "v1.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/promise.git", + "reference": "dc494cdc9d7160b9a09bd5573272195242ce7980" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/promise/zipball/dc494cdc9d7160b9a09bd5573272195242ce7980", + "reference": "dc494cdc9d7160b9a09bd5573272195242ce7980", + "shasum": "" + }, + "require-dev": { + "henrikbjorn/phpspec-code-coverage": "^1.0", + "phpspec/phpspec": "^2.4" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.1-dev" + } + }, + "autoload": { + "psr-4": { + "Http\\Promise\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + }, + { + "name": "Joel Wurtz", + "email": "joel.wurtz@gmail.com" + } + ], + "description": "Promise used for asynchronous HTTP requests", + "homepage": "http://httplug.io", + "keywords": [ + "promise" + ], + "time": "2016-01-26 13:27:02" + }, + { + "name": "psr/http-message", + "version": "1.0.1", + "source": { + "type": "git", + "url": "https://github.com/php-fig/http-message.git", + "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/http-message/zipball/f6561bf28d520154e4b0ec72be95418abe6d9363", + "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Http\\Message\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Common interface for HTTP messages", + "homepage": "https://github.com/php-fig/http-message", + "keywords": [ + "http", + "http-message", + "psr", + "psr-7", + "request", + "response" + ], + "time": "2016-08-06 14:39:51" + }, + { + "name": "symfony/options-resolver", + "version": "v3.4.1", + "source": { + "type": "git", + "url": "https://github.com/symfony/options-resolver.git", + "reference": "08748edfe6982f4d878cc42b8325b19a276fb1cf" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/options-resolver/zipball/08748edfe6982f4d878cc42b8325b19a276fb1cf", + "reference": "08748edfe6982f4d878cc42b8325b19a276fb1cf", + "shasum": "" + }, + "require": { + "php": "^5.5.9|>=7.0.8" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "3.4-dev" + } + }, + "autoload": { + "psr-4": { + "Symfony\\Component\\OptionsResolver\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony OptionsResolver Component", + "homepage": "https://symfony.com", + "keywords": [ + "config", + "configuration", + "options" + ], + "time": "2017-11-05 16:10:10" + }, + { + "name": "webmozart/assert", + "version": "1.2.0", + "source": { + "type": "git", + "url": "https://github.com/webmozart/assert.git", + "reference": "2db61e59ff05fe5126d152bd0655c9ea113e550f" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/webmozart/assert/zipball/2db61e59ff05fe5126d152bd0655c9ea113e550f", + "reference": "2db61e59ff05fe5126d152bd0655c9ea113e550f", + "shasum": "" + }, + "require": { + "php": "^5.3.3 || ^7.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.6", + "sebastian/version": "^1.0.1" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.3-dev" + } + }, + "autoload": { + "psr-4": { + "Webmozart\\Assert\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Bernhard Schussek", + "email": "bschussek@gmail.com" + } + ], + "description": "Assertions to validate method input/output with nice error messages.", + "keywords": [ + "assert", + "check", + "validate" + ], + "time": "2016-11-23 20:04:58" + } + ], + "packages-dev": [], + "aliases": [], + "minimum-stability": "stable", + "stability-flags": [], + "prefer-stable": false, + "prefer-lowest": false, + "platform": [], + "platform-dev": [] +} diff --git a/Postman/Postman-Mail/mailgun/mailgun.php b/Postman/Postman-Mail/mailgun/mailgun.php new file mode 100644 index 0000000..a999c2c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/mailgun.php @@ -0,0 +1,2 @@ + Note: Legacy PHP versions (PHP < 5.4) do not support passing additional data +from the end signal handler if the stream is being closed. + +If your callback throws an `Exception`, then the filter process will be aborted. +In order to play nice with PHP's stream handling, the `Exception` will be +transformed to a PHP warning instead: + +```php +Filter\append($stream, function ($chunk) { + throw new \RuntimeException('Unexpected chunk'); +}); + +// raises an E_USER_WARNING with "Error invoking filter: Unexpected chunk" +fwrite($stream, 'hello'); +``` + +The optional `$read_write` parameter can be used to only invoke the `$callback` when either writing to the stream or only when reading from the stream: + +```php +Filter\append($stream, function ($chunk) { + // will be called each time you write to the stream + return $chunk; +}, STREAM_FILTER_WRITE); + +Filter\append($stream, function ($chunk) { + // will be called each time you read from the stream + return $chunk; +}, STREAM_FILTER_READ); +``` + +> Note that once a filter has been added to stream, the stream can no longer be passed to +> [`stream_select()`](http://php.net/manual/en/function.stream-select.php) +> (and family). +> +> > Warning: stream_select(): cannot cast a filtered stream on this system in {file} on line {line} +> +> This is due to limitations of PHP's stream filter support, as it can no longer reliably +> tell when the underlying stream resource is actually ready. +> As an alternative, consider calling `stream_select()` on the unfiltered stream and +> then pass the unfiltered data through the [`fun()`](#fun) function. + +### prepend() + +The `prepend($stream, $callback, $read_write = STREAM_FILTER_ALL)` function can be used to +prepend a filter callback to the given stream. + +Each stream can have a list of filters attached. +This function prepends a filter to the start of this list. + +This function returns a filter resource which can be passed to [`remove()`](#remove). +If the given filter can not be added, it throws an `Exception`. + +```php +$filter = Filter\prepend($stream, function ($chunk) { + // will be called each time you read or write a $chunk to/from the stream + return $chunk; +}); +``` + +Except for the position in the list of filters, this function behaves exactly +like the [`append()`](#append) function. +For more details about its behavior, see also the [`append()`](#append) function. + +### fun() + +The `fun($filter, $parameters = null)` function can be used to +create a filter function which uses the given built-in `$filter`. + +PHP comes with a useful set of [built-in filters](http://php.net/manual/en/filters.php). +Using `fun()` makes accessing these as easy as passing an input string to filter +and getting the filtered output string. + +```php +$fun = Filter\fun('string.rot13'); + +assert('grfg' === $fun('test')); +assert('test' === $fun($fun('test')); +``` + +Please note that not all filter functions may be available depending on installed +PHP extensions and the PHP version in use. +In particular, [HHVM](http://hhvm.com/) may not offer the same filter functions +or parameters as Zend PHP. +Accessing an unknown filter function will result in a `RuntimeException`: + +```php +Filter\fun('unknown'); // throws RuntimeException +``` + +Some filters may accept or require additional filter parameters – most +filters do not require filter parameters. +If given, the optional `$parameters` argument will be passed to the +underlying filter handler as-is. +In particular, note how *not passing* this parameter at all differs from +explicitly passing a `null` value (which many filters do not accept). +Please refer to the individual filter definition for more details. +For example, the `string.strip_tags` filter can be invoked like this: + +```php +$fun = Filter\fun('string.strip_tags', ''); + +$ret = $fun('h
    i    '); +assert('hi' === $ret); +``` + +Under the hood, this function allocates a temporary memory stream, so it's +recommended to clean up the filter function after use. +Also, some filter functions (in particular the +[zlib compression filters](http://php.net/manual/en/filters.compression.php)) +may use internal buffers and may emit a final data chunk on close. +The filter function can be closed by invoking without any arguments: + +```php +$fun = Filter\fun('zlib.deflate'); + +$ret = $fun('hello') . $fun('world') . $fun(); +assert('helloworld' === gzinflate($ret)); +``` + +The filter function must not be used anymore after it has been closed. +Doing so will result in a `RuntimeException`: + +```php +$fun = Filter\fun('string.rot13'); +$fun(); + +$fun('test'); // throws RuntimeException +``` + +> Note: If you're using the zlib compression filters, then you should be wary +about engine inconsistencies between different PHP versions and HHVM. +These inconsistencies exist in the underlying PHP engines and there's little we +can do about this in this library. +[Our test suite](tests/) contains several test cases that exhibit these issues. +If you feel some test case is missing or outdated, we're happy to accept PRs! :) + +### remove() + +The `remove($filter)` function can be used to +remove a filter previously added via [`append()`](#append) or [`prepend()`](#prepend). + +```php +$filter = Filter\append($stream, function () { + // … +}); +Filter\remove($filter); +``` + +## Install + +The recommended way to install this library is [through Composer](https://getcomposer.org). +[New to Composer?](https://getcomposer.org/doc/00-intro.md) + +This will install the latest supported version: + +```bash +$ composer require clue/stream-filter:^1.4 +``` + +See also the [CHANGELOG](CHANGELOG.md) for details about version upgrades. + +This project aims to run on any platform and thus does not require any PHP +extensions and supports running on legacy PHP 5.3 through current PHP 7+ and +HHVM. +It's *highly recommended to use PHP 7+* for this project. +Older PHP versions may suffer from a number of inconsistencies documented above. + +## Tests + +To run the test suite, you first need to clone this repo and then install all +dependencies [through Composer](http://getcomposer.org): + +```bash +$ composer install +``` + +To run the test suite, go to the project root and run: + +```bash +$ php vendor/bin/phpunit +``` + +## License + +MIT diff --git a/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/composer.json b/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/composer.json new file mode 100644 index 0000000..f871053 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/composer.json @@ -0,0 +1,23 @@ +{ + "name": "clue/stream-filter", + "description": "A simple and modern approach to stream filtering in PHP", + "keywords": ["stream", "callback", "filter", "php_user_filter", "stream_filter_append", "stream_filter_register", "bucket brigade"], + "homepage": "https://github.com/clue/php-stream-filter", + "license": "MIT", + "authors": [ + { + "name": "Christian Lück", + "email": "christian@lueck.tv" + } + ], + "require": { + "php": ">=5.3" + }, + "require-dev": { + "phpunit/phpunit": "^5.0 || ^4.8" + }, + "autoload": { + "psr-4": { "Clue\\StreamFilter\\": "src/" }, + "files": [ "src/functions.php" ] + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/examples/base64_decode.php b/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/examples/base64_decode.php new file mode 100644 index 0000000..2b49f10 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/examples/base64_decode.php @@ -0,0 +1,29 @@ + + + + + + ./tests/ + + + + + ./src/ + + + \ No newline at end of file diff --git a/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/src/CallbackFilter.php b/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/src/CallbackFilter.php new file mode 100644 index 0000000..710940b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/src/CallbackFilter.php @@ -0,0 +1,120 @@ +closed = false; + + if (!is_callable($this->params)) { + throw new InvalidArgumentException('No valid callback parameter given to stream_filter_(append|prepend)'); + } + $this->callback = $this->params; + + // callback supports end event if it accepts invocation without arguments + $ref = new ReflectionFunction($this->callback); + $this->supportsClose = ($ref->getNumberOfRequiredParameters() === 0); + + return true; + } + + public function onClose() + { + $this->closed = true; + + // callback supports closing and is not already closed + if ($this->supportsClose) { + $this->supportsClose = false; + // invoke without argument to signal end and discard resulting buffer + try { + call_user_func($this->callback); + } catch (Exception $ignored) { + // this might be called during engine shutdown, so it's not safe + // to raise any errors or exceptions here + // trigger_error('Error closing filter: ' . $ignored->getMessage(), E_USER_WARNING); + } + } + + $this->callback = null; + } + + public function filter($in, $out, &$consumed, $closing) + { + // concatenate whole buffer from input brigade + $data = ''; + while ($bucket = stream_bucket_make_writeable($in)) { + $consumed += $bucket->datalen; + $data .= $bucket->data; + } + + // skip processing callback that already ended + if ($this->closed) { + return PSFS_FEED_ME; + } + + // only invoke filter function if buffer is not empty + // this may skip flushing a closing filter + if ($data !== '') { + try { + $data = call_user_func($this->callback, $data); + } catch (Exception $e) { + // exception should mark filter as closed + $this->onClose(); + trigger_error('Error invoking filter: ' . $e->getMessage(), E_USER_WARNING); + + return PSFS_ERR_FATAL; + } + } + + // mark filter as closed after processing closing chunk + if ($closing) { + $this->closed = true; + + // callback supports closing and is not already closed + if ($this->supportsClose) { + $this->supportsClose = false; + + // invoke without argument to signal end and append resulting buffer + try { + $data .= call_user_func($this->callback); + } catch (Exception $e) { + trigger_error('Error ending filter: ' . $e->getMessage(), E_USER_WARNING); + + return PSFS_ERR_FATAL; + } + } + } + + if ($data !== '') { + // create a new bucket for writing the resulting buffer to the output brigade + // reusing an existing bucket turned out to be bugged in some environments (ancient PHP versions and HHVM) + $bucket = @stream_bucket_new($this->stream, $data); + + // legacy PHP versions (PHP < 5.4) do not support passing data from the event signal handler + // because closing the stream invalidates the stream and its stream bucket brigade before + // invoking the filter close handler. + if ($bucket !== false) { + stream_bucket_append($out, $bucket); + } + } + + return PSFS_PASS_ON; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/src/functions.php b/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/src/functions.php new file mode 100644 index 0000000..d1ca9dc --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/clue/stream-filter/src/functions.php @@ -0,0 +1,146 @@ + ''); + throw new RuntimeException('Unable to append filter: ' . $error['message']); + } + + return $ret; +} + +/** + * prepend a callback filter to the given stream + * + * @param resource $stream + * @param callable $callback + * @param int $read_write + * @return resource filter resource which can be used for `remove()` + * @throws Exception on error + * @uses stream_filter_prepend() + */ +function prepend($stream, $callback, $read_write = STREAM_FILTER_ALL) +{ + $ret = @stream_filter_prepend($stream, register(), $read_write, $callback); + + if ($ret === false) { + $error = error_get_last() + array('message' => ''); + throw new RuntimeException('Unable to prepend filter: ' . $error['message']); + } + + return $ret; +} + +/** + * Creates filter fun (function) which uses the given built-in $filter + * + * Some filters may accept or require additional filter parameters – most + * filters do not require filter parameters. + * If given, the optional `$parameters` argument will be passed to the + * underlying filter handler as-is. + * In particular, note how *not passing* this parameter at all differs from + * explicitly passing a `null` value (which many filters do not accept). + * Please refer to the individual filter definition for more details. + * + * @param string $filter built-in filter name. See stream_get_filters() or http://php.net/manual/en/filters.php + * @param mixed $parameters (optional) parameters to pass to the built-in filter as-is + * @return callable a filter callback which can be append()'ed or prepend()'ed + * @throws RuntimeException on error + * @link http://php.net/manual/en/filters.php + * @see stream_get_filters() + * @see append() + */ +function fun($filter, $parameters = null) +{ + $fp = fopen('php://memory', 'w'); + if (func_num_args() === 1) { + $filter = @stream_filter_append($fp, $filter, STREAM_FILTER_WRITE); + } else { + $filter = @stream_filter_append($fp, $filter, STREAM_FILTER_WRITE, $parameters); + } + + if ($filter === false) { + fclose($fp); + $error = error_get_last() + array('message' => ''); + throw new RuntimeException('Unable to access built-in filter: ' . $error['message']); + } + + // append filter function which buffers internally + $buffer = ''; + append($fp, function ($chunk) use (&$buffer) { + $buffer .= $chunk; + + // always return empty string in order to skip actually writing to stream resource + return ''; + }, STREAM_FILTER_WRITE); + + $closed = false; + + return function ($chunk = null) use ($fp, $filter, &$buffer, &$closed) { + if ($closed) { + throw new \RuntimeException('Unable to perform operation on closed stream'); + } + if ($chunk === null) { + $closed = true; + $buffer = ''; + fclose($fp); + return $buffer; + } + // initialize buffer and invoke filters by attempting to write to stream + $buffer = ''; + fwrite($fp, $chunk); + + // buffer now contains everything the filter function returned + return $buffer; + }; +} + +/** + * remove a callback filter from the given stream + * + * @param resource $filter + * @return boolean true on success or false on error + * @throws Exception on error + * @uses stream_filter_remove() + */ +function remove($filter) +{ + if (@stream_filter_remove($filter) === false) { + throw new RuntimeException('Unable to remove given filter'); + } +} + +/** + * registers the callback filter and returns the resulting filter name + * + * There should be little reason to call this function manually. + * + * @return string filter name + * @uses CallbackFilter + */ +function register() +{ + static $registered = null; + if ($registered === null) { + $registered = 'stream-callback'; + stream_filter_register($registered, __NAMESPACE__ . '\CallbackFilter'); + } + return $registered; +} diff --git a/Postman/Postman-Mail/mailgun/vendor/composer/ClassLoader.php b/Postman/Postman-Mail/mailgun/vendor/composer/ClassLoader.php new file mode 100644 index 0000000..ff6ecfb --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/composer/ClassLoader.php @@ -0,0 +1,413 @@ + + * Jordi Boggiano + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Composer\Autoload; + +/** + * ClassLoader implements a PSR-0, PSR-4 and classmap class loader. + * + * $loader = new \Composer\Autoload\ClassLoader(); + * + * // register classes with namespaces + * $loader->add('Symfony\Component', __DIR__.'/component'); + * $loader->add('Symfony', __DIR__.'/framework'); + * + * // activate the autoloader + * $loader->register(); + * + * // to enable searching the include path (eg. for PEAR packages) + * $loader->setUseIncludePath(true); + * + * In this example, if you try to use a class in the Symfony\Component + * namespace or one of its children (Symfony\Component\Console for instance), + * the autoloader will first look for the class under the component/ + * directory, and it will then fallback to the framework/ directory if not + * found before giving up. + * + * This class is loosely based on the Symfony UniversalClassLoader. + * + * @author Fabien Potencier + * @author Jordi Boggiano + * @see http://www.php-fig.org/psr/psr-0/ + * @see http://www.php-fig.org/psr/psr-4/ + */ +class ClassLoader +{ + // PSR-4 + private $prefixLengthsPsr4 = array(); + private $prefixDirsPsr4 = array(); + private $fallbackDirsPsr4 = array(); + + // PSR-0 + private $prefixesPsr0 = array(); + private $fallbackDirsPsr0 = array(); + + private $useIncludePath = false; + private $classMap = array(); + + private $classMapAuthoritative = false; + + public function getPrefixes() + { + if (!empty($this->prefixesPsr0)) { + return call_user_func_array('array_merge', $this->prefixesPsr0); + } + + return array(); + } + + public function getPrefixesPsr4() + { + return $this->prefixDirsPsr4; + } + + public function getFallbackDirs() + { + return $this->fallbackDirsPsr0; + } + + public function getFallbackDirsPsr4() + { + return $this->fallbackDirsPsr4; + } + + public function getClassMap() + { + return $this->classMap; + } + + /** + * @param array $classMap Class to filename map + */ + public function addClassMap(array $classMap) + { + if ($this->classMap) { + $this->classMap = array_merge($this->classMap, $classMap); + } else { + $this->classMap = $classMap; + } + } + + /** + * Registers a set of PSR-0 directories for a given prefix, either + * appending or prepending to the ones previously set for this prefix. + * + * @param string $prefix The prefix + * @param array|string $paths The PSR-0 root directories + * @param bool $prepend Whether to prepend the directories + */ + public function add($prefix, $paths, $prepend = false) + { + if (!$prefix) { + if ($prepend) { + $this->fallbackDirsPsr0 = array_merge( + (array) $paths, + $this->fallbackDirsPsr0 + ); + } else { + $this->fallbackDirsPsr0 = array_merge( + $this->fallbackDirsPsr0, + (array) $paths + ); + } + + return; + } + + $first = $prefix[0]; + if (!isset($this->prefixesPsr0[$first][$prefix])) { + $this->prefixesPsr0[$first][$prefix] = (array) $paths; + + return; + } + if ($prepend) { + $this->prefixesPsr0[$first][$prefix] = array_merge( + (array) $paths, + $this->prefixesPsr0[$first][$prefix] + ); + } else { + $this->prefixesPsr0[$first][$prefix] = array_merge( + $this->prefixesPsr0[$first][$prefix], + (array) $paths + ); + } + } + + /** + * Registers a set of PSR-4 directories for a given namespace, either + * appending or prepending to the ones previously set for this namespace. + * + * @param string $prefix The prefix/namespace, with trailing '\\' + * @param array|string $paths The PSR-4 base directories + * @param bool $prepend Whether to prepend the directories + * + * @throws \InvalidArgumentException + */ + public function addPsr4($prefix, $paths, $prepend = false) + { + if (!$prefix) { + // Register directories for the root namespace. + if ($prepend) { + $this->fallbackDirsPsr4 = array_merge( + (array) $paths, + $this->fallbackDirsPsr4 + ); + } else { + $this->fallbackDirsPsr4 = array_merge( + $this->fallbackDirsPsr4, + (array) $paths + ); + } + } elseif (!isset($this->prefixDirsPsr4[$prefix])) { + // Register directories for a new namespace. + $length = strlen($prefix); + if ('\\' !== $prefix[$length - 1]) { + throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); + } + $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; + $this->prefixDirsPsr4[$prefix] = (array) $paths; + } elseif ($prepend) { + // Prepend directories for an already registered namespace. + $this->prefixDirsPsr4[$prefix] = array_merge( + (array) $paths, + $this->prefixDirsPsr4[$prefix] + ); + } else { + // Append directories for an already registered namespace. + $this->prefixDirsPsr4[$prefix] = array_merge( + $this->prefixDirsPsr4[$prefix], + (array) $paths + ); + } + } + + /** + * Registers a set of PSR-0 directories for a given prefix, + * replacing any others previously set for this prefix. + * + * @param string $prefix The prefix + * @param array|string $paths The PSR-0 base directories + */ + public function set($prefix, $paths) + { + if (!$prefix) { + $this->fallbackDirsPsr0 = (array) $paths; + } else { + $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths; + } + } + + /** + * Registers a set of PSR-4 directories for a given namespace, + * replacing any others previously set for this namespace. + * + * @param string $prefix The prefix/namespace, with trailing '\\' + * @param array|string $paths The PSR-4 base directories + * + * @throws \InvalidArgumentException + */ + public function setPsr4($prefix, $paths) + { + if (!$prefix) { + $this->fallbackDirsPsr4 = (array) $paths; + } else { + $length = strlen($prefix); + if ('\\' !== $prefix[$length - 1]) { + throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); + } + $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; + $this->prefixDirsPsr4[$prefix] = (array) $paths; + } + } + + /** + * Turns on searching the include path for class files. + * + * @param bool $useIncludePath + */ + public function setUseIncludePath($useIncludePath) + { + $this->useIncludePath = $useIncludePath; + } + + /** + * Can be used to check if the autoloader uses the include path to check + * for classes. + * + * @return bool + */ + public function getUseIncludePath() + { + return $this->useIncludePath; + } + + /** + * Turns off searching the prefix and fallback directories for classes + * that have not been registered with the class map. + * + * @param bool $classMapAuthoritative + */ + public function setClassMapAuthoritative($classMapAuthoritative) + { + $this->classMapAuthoritative = $classMapAuthoritative; + } + + /** + * Should class lookup fail if not found in the current class map? + * + * @return bool + */ + public function isClassMapAuthoritative() + { + return $this->classMapAuthoritative; + } + + /** + * Registers this instance as an autoloader. + * + * @param bool $prepend Whether to prepend the autoloader or not + */ + public function register($prepend = false) + { + spl_autoload_register(array($this, 'loadClass'), true, $prepend); + } + + /** + * Unregisters this instance as an autoloader. + */ + public function unregister() + { + spl_autoload_unregister(array($this, 'loadClass')); + } + + /** + * Loads the given class or interface. + * + * @param string $class The name of the class + * @return bool|null True if loaded, null otherwise + */ + public function loadClass($class) + { + if ($file = $this->findFile($class)) { + includeFile($file); + + return true; + } + } + + /** + * Finds the path to the file where the class is defined. + * + * @param string $class The name of the class + * + * @return string|false The path if found, false otherwise + */ + public function findFile($class) + { + // work around for PHP 5.3.0 - 5.3.2 https://bugs.php.net/50731 + if ('\\' == $class[0]) { + $class = substr($class, 1); + } + + // class map lookup + if (isset($this->classMap[$class])) { + return $this->classMap[$class]; + } + if ($this->classMapAuthoritative) { + return false; + } + + $file = $this->findFileWithExtension($class, '.php'); + + // Search for Hack files if we are running on HHVM + if ($file === null && defined('HHVM_VERSION')) { + $file = $this->findFileWithExtension($class, '.hh'); + } + + if ($file === null) { + // Remember that this class does not exist. + return $this->classMap[$class] = false; + } + + return $file; + } + + private function findFileWithExtension($class, $ext) + { + // PSR-4 lookup + $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; + + $first = $class[0]; + if (isset($this->prefixLengthsPsr4[$first])) { + foreach ($this->prefixLengthsPsr4[$first] as $prefix => $length) { + if (0 === strpos($class, $prefix)) { + foreach ($this->prefixDirsPsr4[$prefix] as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $length))) { + return $file; + } + } + } + } + } + + // PSR-4 fallback dirs + foreach ($this->fallbackDirsPsr4 as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) { + return $file; + } + } + + // PSR-0 lookup + if (false !== $pos = strrpos($class, '\\')) { + // namespaced class name + $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1) + . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR); + } else { + // PEAR-like class name + $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext; + } + + if (isset($this->prefixesPsr0[$first])) { + foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) { + if (0 === strpos($class, $prefix)) { + foreach ($dirs as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { + return $file; + } + } + } + } + } + + // PSR-0 fallback dirs + foreach ($this->fallbackDirsPsr0 as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { + return $file; + } + } + + // PSR-0 include paths. + if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { + return $file; + } + } +} + +/** + * Scope isolated include. + * + * Prevents access to $this/self from included files. + */ +function includeFile($file) +{ + include $file; +} diff --git a/Postman/Postman-Mail/mailgun/vendor/composer/LICENSE b/Postman/Postman-Mail/mailgun/vendor/composer/LICENSE new file mode 100644 index 0000000..ee274f1 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/composer/LICENSE @@ -0,0 +1,433 @@ +Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: Composer +Upstream-Contact: Jordi Boggiano +Source: https://github.com/composer/composer + +Files: * +Copyright: 2016, Nils Adermann + 2016, Jordi Boggiano +License: Expat + +Files: res/cacert.pem +Copyright: 2015, Mozilla Foundation +License: MPL-2.0 + +Files: src/Composer/Util/RemoteFilesystem.php + src/Composer/Util/TlsHelper.php +Copyright: 2016, Nils Adermann + 2016, Jordi Boggiano + 2013, Evan Coury +License: Expat and BSD-2-Clause + +License: BSD-2-Clause + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + . + * Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + . + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + . + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +License: Expat + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to deal + in the Software without restriction, including without limitation the rights + to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + copies of the Software, and to permit persons to whom the Software is furnished + to do so, subject to the following conditions: + . + The above copyright notice and this permission notice shall be included in all + copies or substantial portions of the Software. + . + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + THE SOFTWARE. + +License: MPL-2.0 + 1. Definitions + -------------- + . + 1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + . + 1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + . + 1.3. "Contribution" + means Covered Software of a particular Contributor. + . + 1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + . + 1.5. "Incompatible With Secondary Licenses" + means + . + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + . + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + . + 1.6. "Executable Form" + means any form of the work other than Source Code Form. + . + 1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + . + 1.8. "License" + means this document. + . + 1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + . + 1.10. "Modifications" + means any of the following: + . + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + . + (b) any new file in Source Code Form that contains any Covered + Software. + . + 1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + . + 1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + . + 1.13. "Source Code Form" + means the form of the work preferred for making modifications. + . + 1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + . + 2. License Grants and Conditions + -------------------------------- + . + 2.1. Grants + . + Each Contributor hereby grants You a world-wide, royalty-free, + non-exclusive license: + . + (a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + . + (b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + . + 2.2. Effective Date + . + The licenses granted in Section 2.1 with respect to any Contribution + become effective for each Contribution on the date the Contributor first + distributes such Contribution. + . + 2.3. Limitations on Grant Scope + . + The licenses granted in this Section 2 are the only rights granted under + this License. No additional rights or licenses will be implied from the + distribution or licensing of Covered Software under this License. + Notwithstanding Section 2.1(b) above, no patent license is granted by a + Contributor: + . + (a) for any code that a Contributor has removed from Covered Software; + or + . + (b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + . + (c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + . + This License does not grant any rights in the trademarks, service marks, + or logos of any Contributor (except as may be necessary to comply with + the notice requirements in Section 3.4). + . + 2.4. Subsequent Licenses + . + No Contributor makes additional grants as a result of Your choice to + distribute the Covered Software under a subsequent version of this + License (see Section 10.2) or under the terms of a Secondary License (if + permitted under the terms of Section 3.3). + . + 2.5. Representation + . + Each Contributor represents that the Contributor believes its + Contributions are its original creation(s) or it has sufficient rights + to grant the rights to its Contributions conveyed by this License. + . + 2.6. Fair Use + . + This License is not intended to limit any rights You have under + applicable copyright doctrines of fair use, fair dealing, or other + equivalents. + . + 2.7. Conditions + . + Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted + in Section 2.1. + . + 3. Responsibilities + ------------------- + . + 3.1. Distribution of Source Form + . + All distribution of Covered Software in Source Code Form, including any + Modifications that You create or to which You contribute, must be under + the terms of this License. You must inform recipients that the Source + Code Form of the Covered Software is governed by the terms of this + License, and how they can obtain a copy of this License. You may not + attempt to alter or restrict the recipients' rights in the Source Code + Form. + . + 3.2. Distribution of Executable Form + . + If You distribute Covered Software in Executable Form then: + . + (a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + . + (b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + . + 3.3. Distribution of a Larger Work + . + You may create and distribute a Larger Work under terms of Your choice, + provided that You also comply with the requirements of this License for + the Covered Software. If the Larger Work is a combination of Covered + Software with a work governed by one or more Secondary Licenses, and the + Covered Software is not Incompatible With Secondary Licenses, this + License permits You to additionally distribute such Covered Software + under the terms of such Secondary License(s), so that the recipient of + the Larger Work may, at their option, further distribute the Covered + Software under the terms of either this License or such Secondary + License(s). + . + 3.4. Notices + . + You may not remove or alter the substance of any license notices + (including copyright notices, patent notices, disclaimers of warranty, + or limitations of liability) contained within the Source Code Form of + the Covered Software, except that You may alter any license notices to + the extent required to remedy known factual inaccuracies. + . + 3.5. Application of Additional Terms + . + You may choose to offer, and to charge a fee for, warranty, support, + indemnity or liability obligations to one or more recipients of Covered + Software. However, You may do so only on Your own behalf, and not on + behalf of any Contributor. You must make it absolutely clear that any + such warranty, support, indemnity, or liability obligation is offered by + You alone, and You hereby agree to indemnify every Contributor for any + liability incurred by such Contributor as a result of warranty, support, + indemnity or liability terms You offer. You may include additional + disclaimers of warranty and limitations of liability specific to any + jurisdiction. + . + 4. Inability to Comply Due to Statute or Regulation + --------------------------------------------------- + . + If it is impossible for You to comply with any of the terms of this + License with respect to some or all of the Covered Software due to + statute, judicial order, or regulation then You must: (a) comply with + the terms of this License to the maximum extent possible; and (b) + describe the limitations and the code they affect. Such description must + be placed in a text file included with all distributions of the Covered + Software under this License. Except to the extent prohibited by statute + or regulation, such description must be sufficiently detailed for a + recipient of ordinary skill to be able to understand it. + . + 5. Termination + -------------- + . + 5.1. The rights granted under this License will terminate automatically + if You fail to comply with any of its terms. However, if You become + compliant, then the rights granted under this License from a particular + Contributor are reinstated (a) provisionally, unless and until such + Contributor explicitly and finally terminates Your grants, and (b) on an + ongoing basis, if such Contributor fails to notify You of the + non-compliance by some reasonable means prior to 60 days after You have + come back into compliance. Moreover, Your grants from a particular + Contributor are reinstated on an ongoing basis if such Contributor + notifies You of the non-compliance by some reasonable means, this is the + first time You have received notice of non-compliance with this License + from such Contributor, and You become compliant prior to 30 days after + Your receipt of the notice. + . + 5.2. If You initiate litigation against any entity by asserting a patent + infringement claim (excluding declaratory judgment actions, + counter-claims, and cross-claims) alleging that a Contributor Version + directly or indirectly infringes any patent, then the rights granted to + You by any and all Contributors for the Covered Software under Section + 2.1 of this License shall terminate. + . + 5.3. In the event of termination under Sections 5.1 or 5.2 above, all + end user license agreements (excluding distributors and resellers) which + have been validly granted by You or Your distributors under this License + prior to termination shall survive termination. + . + ************************************************************************ + * * + * 6. Disclaimer of Warranty * + * ------------------------- * + * * + * Covered Software is provided under this License on an "as is" * + * basis, without warranty of any kind, either expressed, implied, or * + * statutory, including, without limitation, warranties that the * + * Covered Software is free of defects, merchantable, fit for a * + * particular purpose or non-infringing. The entire risk as to the * + * quality and performance of the Covered Software is with You. * + * Should any Covered Software prove defective in any respect, You * + * (not any Contributor) assume the cost of any necessary servicing, * + * repair, or correction. This disclaimer of warranty constitutes an * + * essential part of this License. No use of any Covered Software is * + * authorized under this License except under this disclaimer. * + * * + ************************************************************************ + . + ************************************************************************ + * * + * 7. Limitation of Liability * + * -------------------------- * + * * + * Under no circumstances and under no legal theory, whether tort * + * (including negligence), contract, or otherwise, shall any * + * Contributor, or anyone who distributes Covered Software as * + * permitted above, be liable to You for any direct, indirect, * + * special, incidental, or consequential damages of any character * + * including, without limitation, damages for lost profits, loss of * + * goodwill, work stoppage, computer failure or malfunction, or any * + * and all other commercial damages or losses, even if such party * + * shall have been informed of the possibility of such damages. This * + * limitation of liability shall not apply to liability for death or * + * personal injury resulting from such party's negligence to the * + * extent applicable law prohibits such limitation. Some * + * jurisdictions do not allow the exclusion or limitation of * + * incidental or consequential damages, so this exclusion and * + * limitation may not apply to You. * + * * + ************************************************************************ + . + 8. Litigation + ------------- + . + Any litigation relating to this License may be brought only in the + courts of a jurisdiction where the defendant maintains its principal + place of business and such litigation shall be governed by laws of that + jurisdiction, without reference to its conflict-of-law provisions. + Nothing in this Section shall prevent a party's ability to bring + cross-claims or counter-claims. + . + 9. Miscellaneous + ---------------- + . + This License represents the complete agreement concerning the subject + matter hereof. If any provision of this License is held to be + unenforceable, such provision shall be reformed only to the extent + necessary to make it enforceable. Any law or regulation which provides + that the language of a contract shall be construed against the drafter + shall not be used to construe this License against a Contributor. + . + 10. Versions of the License + --------------------------- + . + 10.1. New Versions + . + Mozilla Foundation is the license steward. Except as provided in Section + 10.3, no one other than the license steward has the right to modify or + publish new versions of this License. Each version will be given a + distinguishing version number. + . + 10.2. Effect of New Versions + . + You may distribute the Covered Software under the terms of the version + of the License under which You originally received the Covered Software, + or under the terms of any subsequent version published by the license + steward. + . + 10.3. Modified Versions + . + If you create software not governed by this License, and you want to + create a new license for such software, you may create and use a + modified version of this License if you rename the license and remove + any references to the name of the license steward (except to note that + such modified license differs from this License). + . + 10.4. Distributing Source Code Form that is Incompatible With Secondary + Licenses + . + If You choose to distribute Source Code Form that is Incompatible With + Secondary Licenses under the terms of this version of the License, the + notice described in Exhibit B of this License must be attached. + . + Exhibit A - Source Code Form License Notice + ------------------------------------------- + . + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at http://mozilla.org/MPL/2.0/. + . + If it is not possible or desirable to put the notice in a particular + file, then You may include the notice in a location (such as a LICENSE + file in a relevant directory) where a recipient would be likely to look + for such a notice. + . + You may add additional accurate notices of copyright ownership. + . + Exhibit B - "Incompatible With Secondary Licenses" Notice + --------------------------------------------------------- + . + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. diff --git a/Postman/Postman-Mail/mailgun/vendor/composer/autoload_classmap.php b/Postman/Postman-Mail/mailgun/vendor/composer/autoload_classmap.php new file mode 100644 index 0000000..7a91153 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/composer/autoload_classmap.php @@ -0,0 +1,9 @@ + $vendorDir . '/guzzlehttp/psr7/src/functions_include.php', + 'ddc0a4d7e61c0286f0f8593b1903e894' => $vendorDir . '/clue/stream-filter/src/functions.php', + '8cff32064859f4559445b89279f3199c' => $vendorDir . '/php-http/message/src/filters.php', +); diff --git a/Postman/Postman-Mail/mailgun/vendor/composer/autoload_namespaces.php b/Postman/Postman-Mail/mailgun/vendor/composer/autoload_namespaces.php new file mode 100644 index 0000000..a3af1a0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/composer/autoload_namespaces.php @@ -0,0 +1,10 @@ + array($vendorDir . '/mailgun/mailgun-php/src'), +); diff --git a/Postman/Postman-Mail/mailgun/vendor/composer/autoload_psr4.php b/Postman/Postman-Mail/mailgun/vendor/composer/autoload_psr4.php new file mode 100644 index 0000000..f81dce4 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/composer/autoload_psr4.php @@ -0,0 +1,21 @@ + array($vendorDir . '/webmozart/assert/src'), + 'Symfony\\Component\\OptionsResolver\\' => array($vendorDir . '/symfony/options-resolver'), + 'Psr\\Http\\Message\\' => array($vendorDir . '/psr/http-message/src'), + 'Http\\Promise\\' => array($vendorDir . '/php-http/promise/src'), + 'Http\\Message\\MultipartStream\\' => array($vendorDir . '/php-http/multipart-stream-builder/src'), + 'Http\\Message\\' => array($vendorDir . '/php-http/message-factory/src', $vendorDir . '/php-http/message/src'), + 'Http\\Discovery\\' => array($vendorDir . '/php-http/discovery/src'), + 'Http\\Client\\Curl\\' => array($vendorDir . '/php-http/curl-client/src'), + 'Http\\Client\\Common\\' => array($vendorDir . '/php-http/client-common/src'), + 'Http\\Client\\' => array($vendorDir . '/php-http/httplug/src'), + 'GuzzleHttp\\Psr7\\' => array($vendorDir . '/guzzlehttp/psr7/src'), + 'Clue\\StreamFilter\\' => array($vendorDir . '/clue/stream-filter/src'), +); diff --git a/Postman/Postman-Mail/mailgun/vendor/composer/autoload_real.php b/Postman/Postman-Mail/mailgun/vendor/composer/autoload_real.php new file mode 100644 index 0000000..2e43f61 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/composer/autoload_real.php @@ -0,0 +1,59 @@ + $path) { + $loader->set($namespace, $path); + } + + $map = require __DIR__ . '/autoload_psr4.php'; + foreach ($map as $namespace => $path) { + $loader->setPsr4($namespace, $path); + } + + $classMap = require __DIR__ . '/autoload_classmap.php'; + if ($classMap) { + $loader->addClassMap($classMap); + } + + $loader->register(true); + + $includeFiles = require __DIR__ . '/autoload_files.php'; + foreach ($includeFiles as $fileIdentifier => $file) { + composerRequire2e493976577e1ff95afbbd5ca63b2ef1($fileIdentifier, $file); + } + + return $loader; + } +} + +function composerRequire2e493976577e1ff95afbbd5ca63b2ef1($fileIdentifier, $file) +{ + if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) { + require $file; + + $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/composer/installed.json b/Postman/Postman-Mail/mailgun/vendor/composer/installed.json new file mode 100644 index 0000000..aee855c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/composer/installed.json @@ -0,0 +1,812 @@ +[ + { + "name": "php-http/discovery", + "version": "1.3.0", + "version_normalized": "1.3.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/discovery.git", + "reference": "7b50ab4d6c9fdaa1ed53ae310c955900af6e3372" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/discovery/zipball/7b50ab4d6c9fdaa1ed53ae310c955900af6e3372", + "reference": "7b50ab4d6c9fdaa1ed53ae310c955900af6e3372", + "shasum": "" + }, + "require": { + "php": "^5.5 || ^7.0" + }, + "require-dev": { + "henrikbjorn/phpspec-code-coverage": "^2.0.2", + "php-http/httplug": "^1.0", + "php-http/message-factory": "^1.0", + "phpspec/phpspec": "^2.4", + "puli/composer-plugin": "1.0.0-beta10" + }, + "suggest": { + "php-http/message": "Allow to use Guzzle, Diactoros or Slim Framework factories", + "puli/composer-plugin": "Sets up Puli which is recommended for Discovery to work. Check http://docs.php-http.org/en/latest/discovery.html for more details." + }, + "time": "2017-08-03 10:12:53", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.3-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Http\\Discovery\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "Finds installed HTTPlug implementations and PSR-7 message factories", + "homepage": "http://php-http.org", + "keywords": [ + "adapter", + "client", + "discovery", + "factory", + "http", + "message", + "psr7" + ] + }, + { + "name": "clue/stream-filter", + "version": "v1.4.0", + "version_normalized": "1.4.0.0", + "source": { + "type": "git", + "url": "https://github.com/clue/php-stream-filter.git", + "reference": "d80fdee9b3a7e0d16fc330a22f41f3ad0eeb09d0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/clue/php-stream-filter/zipball/d80fdee9b3a7e0d16fc330a22f41f3ad0eeb09d0", + "reference": "d80fdee9b3a7e0d16fc330a22f41f3ad0eeb09d0", + "shasum": "" + }, + "require": { + "php": ">=5.3" + }, + "require-dev": { + "phpunit/phpunit": "^5.0 || ^4.8" + }, + "time": "2017-08-18 09:54:01", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-4": { + "Clue\\StreamFilter\\": "src/" + }, + "files": [ + "src/functions.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Christian Lück", + "email": "christian@lueck.tv" + } + ], + "description": "A simple and modern approach to stream filtering in PHP", + "homepage": "https://github.com/clue/php-stream-filter", + "keywords": [ + "bucket brigade", + "callback", + "filter", + "php_user_filter", + "stream", + "stream_filter_append", + "stream_filter_register" + ] + }, + { + "name": "psr/http-message", + "version": "1.0.1", + "version_normalized": "1.0.1.0", + "source": { + "type": "git", + "url": "https://github.com/php-fig/http-message.git", + "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/http-message/zipball/f6561bf28d520154e4b0ec72be95418abe6d9363", + "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "time": "2016-08-06 14:39:51", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Psr\\Http\\Message\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "description": "Common interface for HTTP messages", + "homepage": "https://github.com/php-fig/http-message", + "keywords": [ + "http", + "http-message", + "psr", + "psr-7", + "request", + "response" + ] + }, + { + "name": "php-http/message-factory", + "version": "v1.0.2", + "version_normalized": "1.0.2.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/message-factory.git", + "reference": "a478cb11f66a6ac48d8954216cfed9aa06a501a1" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/message-factory/zipball/a478cb11f66a6ac48d8954216cfed9aa06a501a1", + "reference": "a478cb11f66a6ac48d8954216cfed9aa06a501a1", + "shasum": "" + }, + "require": { + "php": ">=5.4", + "psr/http-message": "^1.0" + }, + "time": "2015-12-19 14:08:53", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.0-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Http\\Message\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "Factory interfaces for PSR-7 HTTP Message", + "homepage": "http://php-http.org", + "keywords": [ + "factory", + "http", + "message", + "stream", + "uri" + ] + }, + { + "name": "php-http/message", + "version": "1.6.0", + "version_normalized": "1.6.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/message.git", + "reference": "2edd63bae5f52f79363c5f18904b05ce3a4b7253" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/message/zipball/2edd63bae5f52f79363c5f18904b05ce3a4b7253", + "reference": "2edd63bae5f52f79363c5f18904b05ce3a4b7253", + "shasum": "" + }, + "require": { + "clue/stream-filter": "^1.3", + "php": ">=5.4", + "php-http/message-factory": "^1.0.2", + "psr/http-message": "^1.0" + }, + "provide": { + "php-http/message-factory-implementation": "1.0" + }, + "require-dev": { + "akeneo/phpspec-skip-example-extension": "^1.0", + "coduo/phpspec-data-provider-extension": "^1.0", + "ext-zlib": "*", + "guzzlehttp/psr7": "^1.0", + "henrikbjorn/phpspec-code-coverage": "^1.0", + "phpspec/phpspec": "^2.4", + "slim/slim": "^3.0", + "zendframework/zend-diactoros": "^1.0" + }, + "suggest": { + "ext-zlib": "Used with compressor/decompressor streams", + "guzzlehttp/psr7": "Used with Guzzle PSR-7 Factories", + "slim/slim": "Used with Slim Framework PSR-7 implementation", + "zendframework/zend-diactoros": "Used with Diactoros Factories" + }, + "time": "2017-07-05 06:40:53", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.6-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Http\\Message\\": "src/" + }, + "files": [ + "src/filters.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "HTTP Message related tools", + "homepage": "http://php-http.org", + "keywords": [ + "http", + "message", + "psr-7" + ] + }, + { + "name": "php-http/promise", + "version": "v1.0.0", + "version_normalized": "1.0.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/promise.git", + "reference": "dc494cdc9d7160b9a09bd5573272195242ce7980" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/promise/zipball/dc494cdc9d7160b9a09bd5573272195242ce7980", + "reference": "dc494cdc9d7160b9a09bd5573272195242ce7980", + "shasum": "" + }, + "require-dev": { + "henrikbjorn/phpspec-code-coverage": "^1.0", + "phpspec/phpspec": "^2.4" + }, + "time": "2016-01-26 13:27:02", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.1-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Http\\Promise\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + }, + { + "name": "Joel Wurtz", + "email": "joel.wurtz@gmail.com" + } + ], + "description": "Promise used for asynchronous HTTP requests", + "homepage": "http://httplug.io", + "keywords": [ + "promise" + ] + }, + { + "name": "php-http/httplug", + "version": "v1.1.0", + "version_normalized": "1.1.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/httplug.git", + "reference": "1c6381726c18579c4ca2ef1ec1498fdae8bdf018" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/httplug/zipball/1c6381726c18579c4ca2ef1ec1498fdae8bdf018", + "reference": "1c6381726c18579c4ca2ef1ec1498fdae8bdf018", + "shasum": "" + }, + "require": { + "php": ">=5.4", + "php-http/promise": "^1.0", + "psr/http-message": "^1.0" + }, + "require-dev": { + "henrikbjorn/phpspec-code-coverage": "^1.0", + "phpspec/phpspec": "^2.4" + }, + "time": "2016-08-31 08:30:17", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.1-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Http\\Client\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Eric GELOEN", + "email": "geloen.eric@gmail.com" + }, + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "HTTPlug, the HTTP client abstraction for PHP", + "homepage": "http://httplug.io", + "keywords": [ + "client", + "http" + ] + }, + { + "name": "php-http/curl-client", + "version": "v1.7.0", + "version_normalized": "1.7.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/curl-client.git", + "reference": "0972ad0d7d37032a52077a5cbe27cf370f2007d8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/curl-client/zipball/0972ad0d7d37032a52077a5cbe27cf370f2007d8", + "reference": "0972ad0d7d37032a52077a5cbe27cf370f2007d8", + "shasum": "" + }, + "require": { + "ext-curl": "*", + "php": "^5.5 || ^7.0", + "php-http/discovery": "^1.0", + "php-http/httplug": "^1.0", + "php-http/message": "^1.2", + "php-http/message-factory": "^1.0.2" + }, + "provide": { + "php-http/async-client-implementation": "1.0", + "php-http/client-implementation": "1.0" + }, + "require-dev": { + "guzzlehttp/psr7": "^1.0", + "php-http/client-integration-tests": "^0.5.1", + "phpunit/phpunit": "^4.8.27", + "zendframework/zend-diactoros": "^1.0" + }, + "time": "2017-02-09 15:18:33", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-4": { + "Http\\Client\\Curl\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Михаил Красильников", + "email": "m.krasilnikov@yandex.ru" + } + ], + "description": "cURL client for PHP-HTTP", + "homepage": "http://php-http.org", + "keywords": [ + "curl", + "http" + ] + }, + { + "name": "webmozart/assert", + "version": "1.2.0", + "version_normalized": "1.2.0.0", + "source": { + "type": "git", + "url": "https://github.com/webmozart/assert.git", + "reference": "2db61e59ff05fe5126d152bd0655c9ea113e550f" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/webmozart/assert/zipball/2db61e59ff05fe5126d152bd0655c9ea113e550f", + "reference": "2db61e59ff05fe5126d152bd0655c9ea113e550f", + "shasum": "" + }, + "require": { + "php": "^5.3.3 || ^7.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.6", + "sebastian/version": "^1.0.1" + }, + "time": "2016-11-23 20:04:58", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.3-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Webmozart\\Assert\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Bernhard Schussek", + "email": "bschussek@gmail.com" + } + ], + "description": "Assertions to validate method input/output with nice error messages.", + "keywords": [ + "assert", + "check", + "validate" + ] + }, + { + "name": "symfony/options-resolver", + "version": "v3.4.1", + "version_normalized": "3.4.1.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/options-resolver.git", + "reference": "08748edfe6982f4d878cc42b8325b19a276fb1cf" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/options-resolver/zipball/08748edfe6982f4d878cc42b8325b19a276fb1cf", + "reference": "08748edfe6982f4d878cc42b8325b19a276fb1cf", + "shasum": "" + }, + "require": { + "php": "^5.5.9|>=7.0.8" + }, + "time": "2017-11-05 16:10:10", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "3.4-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Symfony\\Component\\OptionsResolver\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony OptionsResolver Component", + "homepage": "https://symfony.com", + "keywords": [ + "config", + "configuration", + "options" + ] + }, + { + "name": "php-http/client-common", + "version": "1.7.0", + "version_normalized": "1.7.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/client-common.git", + "reference": "9accb4a082eb06403747c0ffd444112eda41a0fd" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/client-common/zipball/9accb4a082eb06403747c0ffd444112eda41a0fd", + "reference": "9accb4a082eb06403747c0ffd444112eda41a0fd", + "shasum": "" + }, + "require": { + "php": "^5.4 || ^7.0", + "php-http/httplug": "^1.1", + "php-http/message": "^1.6", + "php-http/message-factory": "^1.0", + "symfony/options-resolver": "^2.6 || ^3.0 || ^4.0" + }, + "require-dev": { + "guzzlehttp/psr7": "^1.4", + "phpspec/phpspec": "^2.5 || ^3.4 || ^4.2" + }, + "suggest": { + "php-http/cache-plugin": "PSR-6 Cache plugin", + "php-http/logger-plugin": "PSR-3 Logger plugin", + "php-http/stopwatch-plugin": "Symfony Stopwatch plugin" + }, + "time": "2017-11-30 11:06:59", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.7-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Http\\Client\\Common\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "description": "Common HTTP Client implementations and tools for HTTPlug", + "homepage": "http://httplug.io", + "keywords": [ + "client", + "common", + "http", + "httplug" + ] + }, + { + "name": "php-http/multipart-stream-builder", + "version": "1.0.0", + "version_normalized": "1.0.0.0", + "source": { + "type": "git", + "url": "https://github.com/php-http/multipart-stream-builder.git", + "reference": "1fa3c623fc813a43b39494b2a1612174e36e0fb0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-http/multipart-stream-builder/zipball/1fa3c623fc813a43b39494b2a1612174e36e0fb0", + "reference": "1fa3c623fc813a43b39494b2a1612174e36e0fb0", + "shasum": "" + }, + "require": { + "php": "^5.5 || ^7.0", + "php-http/discovery": "^1.0", + "php-http/message-factory": "^1.0.2", + "psr/http-message": "^1.0" + }, + "require-dev": { + "php-http/message": "^1.5", + "phpunit/phpunit": "^4.8 || ^5.4", + "zendframework/zend-diactoros": "^1.3.5" + }, + "time": "2017-05-21 17:45:25", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "0.3-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "Http\\Message\\MultipartStream\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Tobias Nyholm", + "email": "tobias.nyholm@gmail.com" + } + ], + "description": "A builder class that help you create a multipart stream", + "homepage": "http://php-http.org", + "keywords": [ + "factory", + "http", + "message", + "multipart stream", + "stream" + ] + }, + { + "name": "mailgun/mailgun-php", + "version": "2.3.4", + "version_normalized": "2.3.4.0", + "source": { + "type": "git", + "url": "https://github.com/mailgun/mailgun-php.git", + "reference": "f58c5914aefa16fa6ed2b5cf9ee84d40cbda1b3a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/mailgun/mailgun-php/zipball/f58c5914aefa16fa6ed2b5cf9ee84d40cbda1b3a", + "reference": "f58c5914aefa16fa6ed2b5cf9ee84d40cbda1b3a", + "shasum": "" + }, + "require": { + "php": "^5.5|^7.0", + "php-http/client-common": "^1.1", + "php-http/discovery": "^1.0", + "php-http/httplug": "^1.0", + "php-http/message": "^1.0", + "php-http/multipart-stream-builder": "^1.0", + "webmozart/assert": "^1.2" + }, + "require-dev": { + "guzzlehttp/psr7": "^1.4", + "php-http/guzzle6-adapter": "^1.0", + "phpunit/phpunit": "~4.8" + }, + "time": "2017-06-20 19:56:09", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-0": { + "Mailgun": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Travis Swientek", + "email": "travis@mailgunhq.com" + } + ], + "description": "The Mailgun SDK provides methods for all API functions." + }, + { + "name": "guzzlehttp/psr7", + "version": "1.4.2", + "version_normalized": "1.4.2.0", + "source": { + "type": "git", + "url": "https://github.com/guzzle/psr7.git", + "reference": "f5b8a8512e2b58b0071a7280e39f14f72e05d87c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/guzzle/psr7/zipball/f5b8a8512e2b58b0071a7280e39f14f72e05d87c", + "reference": "f5b8a8512e2b58b0071a7280e39f14f72e05d87c", + "shasum": "" + }, + "require": { + "php": ">=5.4.0", + "psr/http-message": "~1.0" + }, + "provide": { + "psr/http-message-implementation": "1.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.0" + }, + "time": "2017-03-20 17:10:46", + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + }, + "installation-source": "dist", + "autoload": { + "psr-4": { + "GuzzleHttp\\Psr7\\": "src/" + }, + "files": [ + "src/functions_include.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "Tobias Schultze", + "homepage": "https://github.com/Tobion" + } + ], + "description": "PSR-7 message implementation that also provides common utility methods", + "keywords": [ + "http", + "message", + "request", + "response", + "stream", + "uri", + "url" + ] + } +] diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/CHANGELOG.md new file mode 100644 index 0000000..5c252b3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/CHANGELOG.md @@ -0,0 +1,110 @@ +# CHANGELOG + +## 1.4.2 - 2017-03-20 + +* Reverted BC break to `Uri::resolve` and `Uri::removeDotSegments` by removing + calls to `trigger_error` when deprecated methods are invoked. + +## 1.4.1 - 2017-02-27 + +* Reverted BC break by reintroducing behavior to automagically fix a URI with a + relative path and an authority by adding a leading slash to the path. It's only + deprecated now. +* Added triggering of silenced deprecation warnings. + +## 1.4.0 - 2017-02-21 + +* Fix `Stream::read` when length parameter <= 0. +* `copy_to_stream` reads bytes in chunks instead of `maxLen` into memory. +* Fix `ServerRequest::getUriFromGlobals` when `Host` header contains port. +* Ensure `ServerRequest::getUriFromGlobals` returns a URI in absolute form. +* Allow `parse_response` to parse a response without delimiting space and reason. +* Ensure each URI modification results in a valid URI according to PSR-7 discussions. + Invalid modifications will throw an exception instead of returning a wrong URI or + doing some magic. + - `(new Uri)->withPath('foo')->withHost('example.com')` will throw an exception + because the path of a URI with an authority must start with a slash "/" or be empty + - `(new Uri())->withScheme('http')` will return `'http://localhost'` +* Fix compatibility of URIs with `file` scheme and empty host. +* Added common URI utility methods based on RFC 3986 (see documentation in the readme): + - `Uri::isDefaultPort` + - `Uri::isAbsolute` + - `Uri::isNetworkPathReference` + - `Uri::isAbsolutePathReference` + - `Uri::isRelativePathReference` + - `Uri::isSameDocumentReference` + - `Uri::composeComponents` + - `UriNormalizer::normalize` + - `UriNormalizer::isEquivalent` + - `UriResolver::relativize` +* Deprecated `Uri::resolve` in favor of `UriResolver::resolve` +* Deprecated `Uri::removeDotSegments` in favor of `UriResolver::removeDotSegments` + +## 1.3.1 - 2016-06-25 + +* Fix `Uri::__toString` for network path references, e.g. `//example.org`. +* Fix missing lowercase normalization for host. +* Fix handling of URI components in case they are `'0'` in a lot of places, + e.g. as a user info password. +* Fix `Uri::withAddedHeader` to correctly merge headers with different case. +* Fix trimming of header values in `Uri::withAddedHeader`. Header values may + be surrounded by whitespace which should be ignored according to RFC 7230 + Section 3.2.4. This does not apply to header names. +* Fix `Uri::withAddedHeader` with an array of header values. +* Fix `Uri::resolve` when base path has no slash and handling of fragment. +* Fix handling of encoding in `Uri::with(out)QueryValue` so one can pass the + key/value both in encoded as well as decoded form to those methods. This is + consistent with withPath, withQuery etc. +* Fix `ServerRequest::withoutAttribute` when attribute value is null. + +## 1.3.0 - 2016-04-13 + +* Added remaining interfaces needed for full PSR7 compatibility + (ServerRequestInterface, UploadedFileInterface, etc.). +* Added support for stream_for from scalars. +* Can now extend Uri. +* Fixed a bug in validating request methods by making it more permissive. + +## 1.2.3 - 2016-02-18 + +* Fixed support in `GuzzleHttp\Psr7\CachingStream` for seeking forward on remote + streams, which can sometimes return fewer bytes than requested with `fread`. +* Fixed handling of gzipped responses with FNAME headers. + +## 1.2.2 - 2016-01-22 + +* Added support for URIs without any authority. +* Added support for HTTP 451 'Unavailable For Legal Reasons.' +* Added support for using '0' as a filename. +* Added support for including non-standard ports in Host headers. + +## 1.2.1 - 2015-11-02 + +* Now supporting negative offsets when seeking to SEEK_END. + +## 1.2.0 - 2015-08-15 + +* Body as `"0"` is now properly added to a response. +* Now allowing forward seeking in CachingStream. +* Now properly parsing HTTP requests that contain proxy targets in + `parse_request`. +* functions.php is now conditionally required. +* user-info is no longer dropped when resolving URIs. + +## 1.1.0 - 2015-06-24 + +* URIs can now be relative. +* `multipart/form-data` headers are now overridden case-insensitively. +* URI paths no longer encode the following characters because they are allowed + in URIs: "(", ")", "*", "!", "'" +* A port is no longer added to a URI when the scheme is missing and no port is + present. + +## 1.0.0 - 2015-05-19 + +Initial release. + +Currently unsupported: + +- `Psr\Http\Message\ServerRequestInterface` +- `Psr\Http\Message\UploadedFileInterface` diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/LICENSE b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/LICENSE new file mode 100644 index 0000000..581d95f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2015 Michael Dowling, https://github.com/mtdowling + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/README.md b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/README.md new file mode 100644 index 0000000..1649935 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/README.md @@ -0,0 +1,739 @@ +# PSR-7 Message Implementation + +This repository contains a full [PSR-7](http://www.php-fig.org/psr/psr-7/) +message implementation, several stream decorators, and some helpful +functionality like query string parsing. + + +[![Build Status](https://travis-ci.org/guzzle/psr7.svg?branch=master)](https://travis-ci.org/guzzle/psr7) + + +# Stream implementation + +This package comes with a number of stream implementations and stream +decorators. + + +## AppendStream + +`GuzzleHttp\Psr7\AppendStream` + +Reads from multiple streams, one after the other. + +```php +use GuzzleHttp\Psr7; + +$a = Psr7\stream_for('abc, '); +$b = Psr7\stream_for('123.'); +$composed = new Psr7\AppendStream([$a, $b]); + +$composed->addStream(Psr7\stream_for(' Above all listen to me')); + +echo $composed; // abc, 123. Above all listen to me. +``` + + +## BufferStream + +`GuzzleHttp\Psr7\BufferStream` + +Provides a buffer stream that can be written to fill a buffer, and read +from to remove bytes from the buffer. + +This stream returns a "hwm" metadata value that tells upstream consumers +what the configured high water mark of the stream is, or the maximum +preferred size of the buffer. + +```php +use GuzzleHttp\Psr7; + +// When more than 1024 bytes are in the buffer, it will begin returning +// false to writes. This is an indication that writers should slow down. +$buffer = new Psr7\BufferStream(1024); +``` + + +## CachingStream + +The CachingStream is used to allow seeking over previously read bytes on +non-seekable streams. This can be useful when transferring a non-seekable +entity body fails due to needing to rewind the stream (for example, resulting +from a redirect). Data that is read from the remote stream will be buffered in +a PHP temp stream so that previously read bytes are cached first in memory, +then on disk. + +```php +use GuzzleHttp\Psr7; + +$original = Psr7\stream_for(fopen('http://www.google.com', 'r')); +$stream = new Psr7\CachingStream($original); + +$stream->read(1024); +echo $stream->tell(); +// 1024 + +$stream->seek(0); +echo $stream->tell(); +// 0 +``` + + +## DroppingStream + +`GuzzleHttp\Psr7\DroppingStream` + +Stream decorator that begins dropping data once the size of the underlying +stream becomes too full. + +```php +use GuzzleHttp\Psr7; + +// Create an empty stream +$stream = Psr7\stream_for(); + +// Start dropping data when the stream has more than 10 bytes +$dropping = new Psr7\DroppingStream($stream, 10); + +$dropping->write('01234567890123456789'); +echo $stream; // 0123456789 +``` + + +## FnStream + +`GuzzleHttp\Psr7\FnStream` + +Compose stream implementations based on a hash of functions. + +Allows for easy testing and extension of a provided stream without needing +to create a concrete class for a simple extension point. + +```php + +use GuzzleHttp\Psr7; + +$stream = Psr7\stream_for('hi'); +$fnStream = Psr7\FnStream::decorate($stream, [ + 'rewind' => function () use ($stream) { + echo 'About to rewind - '; + $stream->rewind(); + echo 'rewound!'; + } +]); + +$fnStream->rewind(); +// Outputs: About to rewind - rewound! +``` + + +## InflateStream + +`GuzzleHttp\Psr7\InflateStream` + +Uses PHP's zlib.inflate filter to inflate deflate or gzipped content. + +This stream decorator skips the first 10 bytes of the given stream to remove +the gzip header, converts the provided stream to a PHP stream resource, +then appends the zlib.inflate filter. The stream is then converted back +to a Guzzle stream resource to be used as a Guzzle stream. + + +## LazyOpenStream + +`GuzzleHttp\Psr7\LazyOpenStream` + +Lazily reads or writes to a file that is opened only after an IO operation +take place on the stream. + +```php +use GuzzleHttp\Psr7; + +$stream = new Psr7\LazyOpenStream('/path/to/file', 'r'); +// The file has not yet been opened... + +echo $stream->read(10); +// The file is opened and read from only when needed. +``` + + +## LimitStream + +`GuzzleHttp\Psr7\LimitStream` + +LimitStream can be used to read a subset or slice of an existing stream object. +This can be useful for breaking a large file into smaller pieces to be sent in +chunks (e.g. Amazon S3's multipart upload API). + +```php +use GuzzleHttp\Psr7; + +$original = Psr7\stream_for(fopen('/tmp/test.txt', 'r+')); +echo $original->getSize(); +// >>> 1048576 + +// Limit the size of the body to 1024 bytes and start reading from byte 2048 +$stream = new Psr7\LimitStream($original, 1024, 2048); +echo $stream->getSize(); +// >>> 1024 +echo $stream->tell(); +// >>> 0 +``` + + +## MultipartStream + +`GuzzleHttp\Psr7\MultipartStream` + +Stream that when read returns bytes for a streaming multipart or +multipart/form-data stream. + + +## NoSeekStream + +`GuzzleHttp\Psr7\NoSeekStream` + +NoSeekStream wraps a stream and does not allow seeking. + +```php +use GuzzleHttp\Psr7; + +$original = Psr7\stream_for('foo'); +$noSeek = new Psr7\NoSeekStream($original); + +echo $noSeek->read(3); +// foo +var_export($noSeek->isSeekable()); +// false +$noSeek->seek(0); +var_export($noSeek->read(3)); +// NULL +``` + + +## PumpStream + +`GuzzleHttp\Psr7\PumpStream` + +Provides a read only stream that pumps data from a PHP callable. + +When invoking the provided callable, the PumpStream will pass the amount of +data requested to read to the callable. The callable can choose to ignore +this value and return fewer or more bytes than requested. Any extra data +returned by the provided callable is buffered internally until drained using +the read() function of the PumpStream. The provided callable MUST return +false when there is no more data to read. + + +## Implementing stream decorators + +Creating a stream decorator is very easy thanks to the +`GuzzleHttp\Psr7\StreamDecoratorTrait`. This trait provides methods that +implement `Psr\Http\Message\StreamInterface` by proxying to an underlying +stream. Just `use` the `StreamDecoratorTrait` and implement your custom +methods. + +For example, let's say we wanted to call a specific function each time the last +byte is read from a stream. This could be implemented by overriding the +`read()` method. + +```php +use Psr\Http\Message\StreamInterface; +use GuzzleHttp\Psr7\StreamDecoratorTrait; + +class EofCallbackStream implements StreamInterface +{ + use StreamDecoratorTrait; + + private $callback; + + public function __construct(StreamInterface $stream, callable $cb) + { + $this->stream = $stream; + $this->callback = $cb; + } + + public function read($length) + { + $result = $this->stream->read($length); + + // Invoke the callback when EOF is hit. + if ($this->eof()) { + call_user_func($this->callback); + } + + return $result; + } +} +``` + +This decorator could be added to any existing stream and used like so: + +```php +use GuzzleHttp\Psr7; + +$original = Psr7\stream_for('foo'); + +$eofStream = new EofCallbackStream($original, function () { + echo 'EOF!'; +}); + +$eofStream->read(2); +$eofStream->read(1); +// echoes "EOF!" +$eofStream->seek(0); +$eofStream->read(3); +// echoes "EOF!" +``` + + +## PHP StreamWrapper + +You can use the `GuzzleHttp\Psr7\StreamWrapper` class if you need to use a +PSR-7 stream as a PHP stream resource. + +Use the `GuzzleHttp\Psr7\StreamWrapper::getResource()` method to create a PHP +stream from a PSR-7 stream. + +```php +use GuzzleHttp\Psr7\StreamWrapper; + +$stream = GuzzleHttp\Psr7\stream_for('hello!'); +$resource = StreamWrapper::getResource($stream); +echo fread($resource, 6); // outputs hello! +``` + + +# Function API + +There are various functions available under the `GuzzleHttp\Psr7` namespace. + + +## `function str` + +`function str(MessageInterface $message)` + +Returns the string representation of an HTTP message. + +```php +$request = new GuzzleHttp\Psr7\Request('GET', 'http://example.com'); +echo GuzzleHttp\Psr7\str($request); +``` + + +## `function uri_for` + +`function uri_for($uri)` + +This function accepts a string or `Psr\Http\Message\UriInterface` and returns a +UriInterface for the given value. If the value is already a `UriInterface`, it +is returned as-is. + +```php +$uri = GuzzleHttp\Psr7\uri_for('http://example.com'); +assert($uri === GuzzleHttp\Psr7\uri_for($uri)); +``` + + +## `function stream_for` + +`function stream_for($resource = '', array $options = [])` + +Create a new stream based on the input type. + +Options is an associative array that can contain the following keys: + +* - metadata: Array of custom metadata. +* - size: Size of the stream. + +This method accepts the following `$resource` types: + +- `Psr\Http\Message\StreamInterface`: Returns the value as-is. +- `string`: Creates a stream object that uses the given string as the contents. +- `resource`: Creates a stream object that wraps the given PHP stream resource. +- `Iterator`: If the provided value implements `Iterator`, then a read-only + stream object will be created that wraps the given iterable. Each time the + stream is read from, data from the iterator will fill a buffer and will be + continuously called until the buffer is equal to the requested read size. + Subsequent read calls will first read from the buffer and then call `next` + on the underlying iterator until it is exhausted. +- `object` with `__toString()`: If the object has the `__toString()` method, + the object will be cast to a string and then a stream will be returned that + uses the string value. +- `NULL`: When `null` is passed, an empty stream object is returned. +- `callable` When a callable is passed, a read-only stream object will be + created that invokes the given callable. The callable is invoked with the + number of suggested bytes to read. The callable can return any number of + bytes, but MUST return `false` when there is no more data to return. The + stream object that wraps the callable will invoke the callable until the + number of requested bytes are available. Any additional bytes will be + buffered and used in subsequent reads. + +```php +$stream = GuzzleHttp\Psr7\stream_for('foo'); +$stream = GuzzleHttp\Psr7\stream_for(fopen('/path/to/file', 'r')); + +$generator function ($bytes) { + for ($i = 0; $i < $bytes; $i++) { + yield ' '; + } +} + +$stream = GuzzleHttp\Psr7\stream_for($generator(100)); +``` + + +## `function parse_header` + +`function parse_header($header)` + +Parse an array of header values containing ";" separated data into an array of +associative arrays representing the header key value pair data of the header. +When a parameter does not contain a value, but just contains a key, this +function will inject a key with a '' string value. + + +## `function normalize_header` + +`function normalize_header($header)` + +Converts an array of header values that may contain comma separated headers +into an array of headers with no comma separated values. + + +## `function modify_request` + +`function modify_request(RequestInterface $request, array $changes)` + +Clone and modify a request with the given changes. This method is useful for +reducing the number of clones needed to mutate a message. + +The changes can be one of: + +- method: (string) Changes the HTTP method. +- set_headers: (array) Sets the given headers. +- remove_headers: (array) Remove the given headers. +- body: (mixed) Sets the given body. +- uri: (UriInterface) Set the URI. +- query: (string) Set the query string value of the URI. +- version: (string) Set the protocol version. + + +## `function rewind_body` + +`function rewind_body(MessageInterface $message)` + +Attempts to rewind a message body and throws an exception on failure. The body +of the message will only be rewound if a call to `tell()` returns a value other +than `0`. + + +## `function try_fopen` + +`function try_fopen($filename, $mode)` + +Safely opens a PHP stream resource using a filename. + +When fopen fails, PHP normally raises a warning. This function adds an error +handler that checks for errors and throws an exception instead. + + +## `function copy_to_string` + +`function copy_to_string(StreamInterface $stream, $maxLen = -1)` + +Copy the contents of a stream into a string until the given number of bytes +have been read. + + +## `function copy_to_stream` + +`function copy_to_stream(StreamInterface $source, StreamInterface $dest, $maxLen = -1)` + +Copy the contents of a stream into another stream until the given number of +bytes have been read. + + +## `function hash` + +`function hash(StreamInterface $stream, $algo, $rawOutput = false)` + +Calculate a hash of a Stream. This method reads the entire stream to calculate +a rolling hash (based on PHP's hash_init functions). + + +## `function readline` + +`function readline(StreamInterface $stream, $maxLength = null)` + +Read a line from the stream up to the maximum allowed buffer length. + + +## `function parse_request` + +`function parse_request($message)` + +Parses a request message string into a request object. + + +## `function parse_response` + +`function parse_response($message)` + +Parses a response message string into a response object. + + +## `function parse_query` + +`function parse_query($str, $urlEncoding = true)` + +Parse a query string into an associative array. + +If multiple values are found for the same key, the value of that key value pair +will become an array. This function does not parse nested PHP style arrays into +an associative array (e.g., `foo[a]=1&foo[b]=2` will be parsed into +`['foo[a]' => '1', 'foo[b]' => '2']`). + + +## `function build_query` + +`function build_query(array $params, $encoding = PHP_QUERY_RFC3986)` + +Build a query string from an array of key value pairs. + +This function can use the return value of parse_query() to build a query string. +This function does not modify the provided keys when an array is encountered +(like http_build_query would). + + +## `function mimetype_from_filename` + +`function mimetype_from_filename($filename)` + +Determines the mimetype of a file by looking at its extension. + + +## `function mimetype_from_extension` + +`function mimetype_from_extension($extension)` + +Maps a file extensions to a mimetype. + + +# Additional URI Methods + +Aside from the standard `Psr\Http\Message\UriInterface` implementation in form of the `GuzzleHttp\Psr7\Uri` class, +this library also provides additional functionality when working with URIs as static methods. + +## URI Types + +An instance of `Psr\Http\Message\UriInterface` can either be an absolute URI or a relative reference. +An absolute URI has a scheme. A relative reference is used to express a URI relative to another URI, +the base URI. Relative references can be divided into several forms according to +[RFC 3986 Section 4.2](https://tools.ietf.org/html/rfc3986#section-4.2): + +- network-path references, e.g. `//example.com/path` +- absolute-path references, e.g. `/path` +- relative-path references, e.g. `subpath` + +The following methods can be used to identify the type of the URI. + +### `GuzzleHttp\Psr7\Uri::isAbsolute` + +`public static function isAbsolute(UriInterface $uri): bool` + +Whether the URI is absolute, i.e. it has a scheme. + +### `GuzzleHttp\Psr7\Uri::isNetworkPathReference` + +`public static function isNetworkPathReference(UriInterface $uri): bool` + +Whether the URI is a network-path reference. A relative reference that begins with two slash characters is +termed an network-path reference. + +### `GuzzleHttp\Psr7\Uri::isAbsolutePathReference` + +`public static function isAbsolutePathReference(UriInterface $uri): bool` + +Whether the URI is a absolute-path reference. A relative reference that begins with a single slash character is +termed an absolute-path reference. + +### `GuzzleHttp\Psr7\Uri::isRelativePathReference` + +`public static function isRelativePathReference(UriInterface $uri): bool` + +Whether the URI is a relative-path reference. A relative reference that does not begin with a slash character is +termed a relative-path reference. + +### `GuzzleHttp\Psr7\Uri::isSameDocumentReference` + +`public static function isSameDocumentReference(UriInterface $uri, UriInterface $base = null): bool` + +Whether the URI is a same-document reference. A same-document reference refers to a URI that is, aside from its +fragment component, identical to the base URI. When no base URI is given, only an empty URI reference +(apart from its fragment) is considered a same-document reference. + +## URI Components + +Additional methods to work with URI components. + +### `GuzzleHttp\Psr7\Uri::isDefaultPort` + +`public static function isDefaultPort(UriInterface $uri): bool` + +Whether the URI has the default port of the current scheme. `Psr\Http\Message\UriInterface::getPort` may return null +or the standard port. This method can be used independently of the implementation. + +### `GuzzleHttp\Psr7\Uri::composeComponents` + +`public static function composeComponents($scheme, $authority, $path, $query, $fragment): string` + +Composes a URI reference string from its various components according to +[RFC 3986 Section 5.3](https://tools.ietf.org/html/rfc3986#section-5.3). Usually this method does not need to be called +manually but instead is used indirectly via `Psr\Http\Message\UriInterface::__toString`. + +### `GuzzleHttp\Psr7\Uri::fromParts` + +`public static function fromParts(array $parts): UriInterface` + +Creates a URI from a hash of [`parse_url`](http://php.net/manual/en/function.parse-url.php) components. + + +### `GuzzleHttp\Psr7\Uri::withQueryValue` + +`public static function withQueryValue(UriInterface $uri, $key, $value): UriInterface` + +Creates a new URI with a specific query string value. Any existing query string values that exactly match the +provided key are removed and replaced with the given key value pair. A value of null will set the query string +key without a value, e.g. "key" instead of "key=value". + + +### `GuzzleHttp\Psr7\Uri::withoutQueryValue` + +`public static function withoutQueryValue(UriInterface $uri, $key): UriInterface` + +Creates a new URI with a specific query string value removed. Any existing query string values that exactly match the +provided key are removed. + +## Reference Resolution + +`GuzzleHttp\Psr7\UriResolver` provides methods to resolve a URI reference in the context of a base URI according +to [RFC 3986 Section 5](https://tools.ietf.org/html/rfc3986#section-5). This is for example also what web browsers +do when resolving a link in a website based on the current request URI. + +### `GuzzleHttp\Psr7\UriResolver::resolve` + +`public static function resolve(UriInterface $base, UriInterface $rel): UriInterface` + +Converts the relative URI into a new URI that is resolved against the base URI. + +### `GuzzleHttp\Psr7\UriResolver::removeDotSegments` + +`public static function removeDotSegments(string $path): string` + +Removes dot segments from a path and returns the new path according to +[RFC 3986 Section 5.2.4](https://tools.ietf.org/html/rfc3986#section-5.2.4). + +### `GuzzleHttp\Psr7\UriResolver::relativize` + +`public static function relativize(UriInterface $base, UriInterface $target): UriInterface` + +Returns the target URI as a relative reference from the base URI. This method is the counterpart to resolve(): + +```php +(string) $target === (string) UriResolver::resolve($base, UriResolver::relativize($base, $target)) +``` + +One use-case is to use the current request URI as base URI and then generate relative links in your documents +to reduce the document size or offer self-contained downloadable document archives. + +```php +$base = new Uri('http://example.com/a/b/'); +echo UriResolver::relativize($base, new Uri('http://example.com/a/b/c')); // prints 'c'. +echo UriResolver::relativize($base, new Uri('http://example.com/a/x/y')); // prints '../x/y'. +echo UriResolver::relativize($base, new Uri('http://example.com/a/b/?q')); // prints '?q'. +echo UriResolver::relativize($base, new Uri('http://example.org/a/b/')); // prints '//example.org/a/b/'. +``` + +## Normalization and Comparison + +`GuzzleHttp\Psr7\UriNormalizer` provides methods to normalize and compare URIs according to +[RFC 3986 Section 6](https://tools.ietf.org/html/rfc3986#section-6). + +### `GuzzleHttp\Psr7\UriNormalizer::normalize` + +`public static function normalize(UriInterface $uri, $flags = self::PRESERVING_NORMALIZATIONS): UriInterface` + +Returns a normalized URI. The scheme and host component are already normalized to lowercase per PSR-7 UriInterface. +This methods adds additional normalizations that can be configured with the `$flags` parameter which is a bitmask +of normalizations to apply. The following normalizations are available: + +- `UriNormalizer::PRESERVING_NORMALIZATIONS` + + Default normalizations which only include the ones that preserve semantics. + +- `UriNormalizer::CAPITALIZE_PERCENT_ENCODING` + + All letters within a percent-encoding triplet (e.g., "%3A") are case-insensitive, and should be capitalized. + + Example: `http://example.org/a%c2%b1b` → `http://example.org/a%C2%B1b` + +- `UriNormalizer::DECODE_UNRESERVED_CHARACTERS` + + Decodes percent-encoded octets of unreserved characters. For consistency, percent-encoded octets in the ranges of + ALPHA (%41–%5A and %61–%7A), DIGIT (%30–%39), hyphen (%2D), period (%2E), underscore (%5F), or tilde (%7E) should + not be created by URI producers and, when found in a URI, should be decoded to their corresponding unreserved + characters by URI normalizers. + + Example: `http://example.org/%7Eusern%61me/` → `http://example.org/~username/` + +- `UriNormalizer::CONVERT_EMPTY_PATH` + + Converts the empty path to "/" for http and https URIs. + + Example: `http://example.org` → `http://example.org/` + +- `UriNormalizer::REMOVE_DEFAULT_HOST` + + Removes the default host of the given URI scheme from the URI. Only the "file" scheme defines the default host + "localhost". All of `file:/myfile`, `file:///myfile`, and `file://localhost/myfile` are equivalent according to + RFC 3986. + + Example: `file://localhost/myfile` → `file:///myfile` + +- `UriNormalizer::REMOVE_DEFAULT_PORT` + + Removes the default port of the given URI scheme from the URI. + + Example: `http://example.org:80/` → `http://example.org/` + +- `UriNormalizer::REMOVE_DOT_SEGMENTS` + + Removes unnecessary dot-segments. Dot-segments in relative-path references are not removed as it would + change the semantics of the URI reference. + + Example: `http://example.org/../a/b/../c/./d.html` → `http://example.org/a/c/d.html` + +- `UriNormalizer::REMOVE_DUPLICATE_SLASHES` + + Paths which include two or more adjacent slashes are converted to one. Webservers usually ignore duplicate slashes + and treat those URIs equivalent. But in theory those URIs do not need to be equivalent. So this normalization + may change the semantics. Encoded slashes (%2F) are not removed. + + Example: `http://example.org//foo///bar.html` → `http://example.org/foo/bar.html` + +- `UriNormalizer::SORT_QUERY_PARAMETERS` + + Sort query parameters with their values in alphabetical order. However, the order of parameters in a URI may be + significant (this is not defined by the standard). So this normalization is not safe and may change the semantics + of the URI. + + Example: `?lang=en&article=fred` → `?article=fred&lang=en` + +### `GuzzleHttp\Psr7\UriNormalizer::isEquivalent` + +`public static function isEquivalent(UriInterface $uri1, UriInterface $uri2, $normalizations = self::PRESERVING_NORMALIZATIONS): bool` + +Whether two URIs can be considered equivalent. Both URIs are normalized automatically before comparison with the given +`$normalizations` bitmask. The method also accepts relative URI references and returns true when they are equivalent. +This of course assumes they will be resolved against the same base URI. If this is not the case, determination of +equivalence or difference of relative references does not mean anything. diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/composer.json b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/composer.json new file mode 100644 index 0000000..b1c5a90 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/composer.json @@ -0,0 +1,39 @@ +{ + "name": "guzzlehttp/psr7", + "type": "library", + "description": "PSR-7 message implementation that also provides common utility methods", + "keywords": ["request", "response", "message", "stream", "http", "uri", "url"], + "license": "MIT", + "authors": [ + { + "name": "Michael Dowling", + "email": "mtdowling@gmail.com", + "homepage": "https://github.com/mtdowling" + }, + { + "name": "Tobias Schultze", + "homepage": "https://github.com/Tobion" + } + ], + "require": { + "php": ">=5.4.0", + "psr/http-message": "~1.0" + }, + "require-dev": { + "phpunit/phpunit": "~4.0" + }, + "provide": { + "psr/http-message-implementation": "1.0" + }, + "autoload": { + "psr-4": { + "GuzzleHttp\\Psr7\\": "src/" + }, + "files": ["src/functions_include.php"] + }, + "extra": { + "branch-alias": { + "dev-master": "1.4-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/AppendStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/AppendStream.php new file mode 100644 index 0000000..23039fd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/AppendStream.php @@ -0,0 +1,233 @@ +addStream($stream); + } + } + + public function __toString() + { + try { + $this->rewind(); + return $this->getContents(); + } catch (\Exception $e) { + return ''; + } + } + + /** + * Add a stream to the AppendStream + * + * @param StreamInterface $stream Stream to append. Must be readable. + * + * @throws \InvalidArgumentException if the stream is not readable + */ + public function addStream(StreamInterface $stream) + { + if (!$stream->isReadable()) { + throw new \InvalidArgumentException('Each stream must be readable'); + } + + // The stream is only seekable if all streams are seekable + if (!$stream->isSeekable()) { + $this->seekable = false; + } + + $this->streams[] = $stream; + } + + public function getContents() + { + return copy_to_string($this); + } + + /** + * Closes each attached stream. + * + * {@inheritdoc} + */ + public function close() + { + $this->pos = $this->current = 0; + + foreach ($this->streams as $stream) { + $stream->close(); + } + + $this->streams = []; + } + + /** + * Detaches each attached stream + * + * {@inheritdoc} + */ + public function detach() + { + $this->close(); + $this->detached = true; + } + + public function tell() + { + return $this->pos; + } + + /** + * Tries to calculate the size by adding the size of each stream. + * + * If any of the streams do not return a valid number, then the size of the + * append stream cannot be determined and null is returned. + * + * {@inheritdoc} + */ + public function getSize() + { + $size = 0; + + foreach ($this->streams as $stream) { + $s = $stream->getSize(); + if ($s === null) { + return null; + } + $size += $s; + } + + return $size; + } + + public function eof() + { + return !$this->streams || + ($this->current >= count($this->streams) - 1 && + $this->streams[$this->current]->eof()); + } + + public function rewind() + { + $this->seek(0); + } + + /** + * Attempts to seek to the given position. Only supports SEEK_SET. + * + * {@inheritdoc} + */ + public function seek($offset, $whence = SEEK_SET) + { + if (!$this->seekable) { + throw new \RuntimeException('This AppendStream is not seekable'); + } elseif ($whence !== SEEK_SET) { + throw new \RuntimeException('The AppendStream can only seek with SEEK_SET'); + } + + $this->pos = $this->current = 0; + + // Rewind each stream + foreach ($this->streams as $i => $stream) { + try { + $stream->rewind(); + } catch (\Exception $e) { + throw new \RuntimeException('Unable to seek stream ' + . $i . ' of the AppendStream', 0, $e); + } + } + + // Seek to the actual position by reading from each stream + while ($this->pos < $offset && !$this->eof()) { + $result = $this->read(min(8096, $offset - $this->pos)); + if ($result === '') { + break; + } + } + } + + /** + * Reads from all of the appended streams until the length is met or EOF. + * + * {@inheritdoc} + */ + public function read($length) + { + $buffer = ''; + $total = count($this->streams) - 1; + $remaining = $length; + $progressToNext = false; + + while ($remaining > 0) { + + // Progress to the next stream if needed. + if ($progressToNext || $this->streams[$this->current]->eof()) { + $progressToNext = false; + if ($this->current === $total) { + break; + } + $this->current++; + } + + $result = $this->streams[$this->current]->read($remaining); + + // Using a loose comparison here to match on '', false, and null + if ($result == null) { + $progressToNext = true; + continue; + } + + $buffer .= $result; + $remaining = $length - strlen($buffer); + } + + $this->pos += strlen($buffer); + + return $buffer; + } + + public function isReadable() + { + return true; + } + + public function isWritable() + { + return false; + } + + public function isSeekable() + { + return $this->seekable; + } + + public function write($string) + { + throw new \RuntimeException('Cannot write to an AppendStream'); + } + + public function getMetadata($key = null) + { + return $key ? null : []; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/BufferStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/BufferStream.php new file mode 100644 index 0000000..af4d4c2 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/BufferStream.php @@ -0,0 +1,137 @@ +hwm = $hwm; + } + + public function __toString() + { + return $this->getContents(); + } + + public function getContents() + { + $buffer = $this->buffer; + $this->buffer = ''; + + return $buffer; + } + + public function close() + { + $this->buffer = ''; + } + + public function detach() + { + $this->close(); + } + + public function getSize() + { + return strlen($this->buffer); + } + + public function isReadable() + { + return true; + } + + public function isWritable() + { + return true; + } + + public function isSeekable() + { + return false; + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + throw new \RuntimeException('Cannot seek a BufferStream'); + } + + public function eof() + { + return strlen($this->buffer) === 0; + } + + public function tell() + { + throw new \RuntimeException('Cannot determine the position of a BufferStream'); + } + + /** + * Reads data from the buffer. + */ + public function read($length) + { + $currentLength = strlen($this->buffer); + + if ($length >= $currentLength) { + // No need to slice the buffer because we don't have enough data. + $result = $this->buffer; + $this->buffer = ''; + } else { + // Slice up the result to provide a subset of the buffer. + $result = substr($this->buffer, 0, $length); + $this->buffer = substr($this->buffer, $length); + } + + return $result; + } + + /** + * Writes data to the buffer. + */ + public function write($string) + { + $this->buffer .= $string; + + // TODO: What should happen here? + if (strlen($this->buffer) >= $this->hwm) { + return false; + } + + return strlen($string); + } + + public function getMetadata($key = null) + { + if ($key == 'hwm') { + return $this->hwm; + } + + return $key ? null : []; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/CachingStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/CachingStream.php new file mode 100644 index 0000000..ed68f08 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/CachingStream.php @@ -0,0 +1,138 @@ +remoteStream = $stream; + $this->stream = $target ?: new Stream(fopen('php://temp', 'r+')); + } + + public function getSize() + { + return max($this->stream->getSize(), $this->remoteStream->getSize()); + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + if ($whence == SEEK_SET) { + $byte = $offset; + } elseif ($whence == SEEK_CUR) { + $byte = $offset + $this->tell(); + } elseif ($whence == SEEK_END) { + $size = $this->remoteStream->getSize(); + if ($size === null) { + $size = $this->cacheEntireStream(); + } + $byte = $size + $offset; + } else { + throw new \InvalidArgumentException('Invalid whence'); + } + + $diff = $byte - $this->stream->getSize(); + + if ($diff > 0) { + // Read the remoteStream until we have read in at least the amount + // of bytes requested, or we reach the end of the file. + while ($diff > 0 && !$this->remoteStream->eof()) { + $this->read($diff); + $diff = $byte - $this->stream->getSize(); + } + } else { + // We can just do a normal seek since we've already seen this byte. + $this->stream->seek($byte); + } + } + + public function read($length) + { + // Perform a regular read on any previously read data from the buffer + $data = $this->stream->read($length); + $remaining = $length - strlen($data); + + // More data was requested so read from the remote stream + if ($remaining) { + // If data was written to the buffer in a position that would have + // been filled from the remote stream, then we must skip bytes on + // the remote stream to emulate overwriting bytes from that + // position. This mimics the behavior of other PHP stream wrappers. + $remoteData = $this->remoteStream->read( + $remaining + $this->skipReadBytes + ); + + if ($this->skipReadBytes) { + $len = strlen($remoteData); + $remoteData = substr($remoteData, $this->skipReadBytes); + $this->skipReadBytes = max(0, $this->skipReadBytes - $len); + } + + $data .= $remoteData; + $this->stream->write($remoteData); + } + + return $data; + } + + public function write($string) + { + // When appending to the end of the currently read stream, you'll want + // to skip bytes from being read from the remote stream to emulate + // other stream wrappers. Basically replacing bytes of data of a fixed + // length. + $overflow = (strlen($string) + $this->tell()) - $this->remoteStream->tell(); + if ($overflow > 0) { + $this->skipReadBytes += $overflow; + } + + return $this->stream->write($string); + } + + public function eof() + { + return $this->stream->eof() && $this->remoteStream->eof(); + } + + /** + * Close both the remote stream and buffer stream + */ + public function close() + { + $this->remoteStream->close() && $this->stream->close(); + } + + private function cacheEntireStream() + { + $target = new FnStream(['write' => 'strlen']); + copy_to_stream($this, $target); + + return $this->tell(); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/DroppingStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/DroppingStream.php new file mode 100644 index 0000000..8935c80 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/DroppingStream.php @@ -0,0 +1,42 @@ +stream = $stream; + $this->maxLength = $maxLength; + } + + public function write($string) + { + $diff = $this->maxLength - $this->stream->getSize(); + + // Begin returning 0 when the underlying stream is too large. + if ($diff <= 0) { + return 0; + } + + // Write the stream or a subset of the stream if needed. + if (strlen($string) < $diff) { + return $this->stream->write($string); + } + + return $this->stream->write(substr($string, 0, $diff)); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/FnStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/FnStream.php new file mode 100644 index 0000000..cc9b445 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/FnStream.php @@ -0,0 +1,149 @@ +methods = $methods; + + // Create the functions on the class + foreach ($methods as $name => $fn) { + $this->{'_fn_' . $name} = $fn; + } + } + + /** + * Lazily determine which methods are not implemented. + * @throws \BadMethodCallException + */ + public function __get($name) + { + throw new \BadMethodCallException(str_replace('_fn_', '', $name) + . '() is not implemented in the FnStream'); + } + + /** + * The close method is called on the underlying stream only if possible. + */ + public function __destruct() + { + if (isset($this->_fn_close)) { + call_user_func($this->_fn_close); + } + } + + /** + * Adds custom functionality to an underlying stream by intercepting + * specific method calls. + * + * @param StreamInterface $stream Stream to decorate + * @param array $methods Hash of method name to a closure + * + * @return FnStream + */ + public static function decorate(StreamInterface $stream, array $methods) + { + // If any of the required methods were not provided, then simply + // proxy to the decorated stream. + foreach (array_diff(self::$slots, array_keys($methods)) as $diff) { + $methods[$diff] = [$stream, $diff]; + } + + return new self($methods); + } + + public function __toString() + { + return call_user_func($this->_fn___toString); + } + + public function close() + { + return call_user_func($this->_fn_close); + } + + public function detach() + { + return call_user_func($this->_fn_detach); + } + + public function getSize() + { + return call_user_func($this->_fn_getSize); + } + + public function tell() + { + return call_user_func($this->_fn_tell); + } + + public function eof() + { + return call_user_func($this->_fn_eof); + } + + public function isSeekable() + { + return call_user_func($this->_fn_isSeekable); + } + + public function rewind() + { + call_user_func($this->_fn_rewind); + } + + public function seek($offset, $whence = SEEK_SET) + { + call_user_func($this->_fn_seek, $offset, $whence); + } + + public function isWritable() + { + return call_user_func($this->_fn_isWritable); + } + + public function write($string) + { + return call_user_func($this->_fn_write, $string); + } + + public function isReadable() + { + return call_user_func($this->_fn_isReadable); + } + + public function read($length) + { + return call_user_func($this->_fn_read, $length); + } + + public function getContents() + { + return call_user_func($this->_fn_getContents); + } + + public function getMetadata($key = null) + { + return call_user_func($this->_fn_getMetadata, $key); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/InflateStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/InflateStream.php new file mode 100644 index 0000000..0051d3f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/InflateStream.php @@ -0,0 +1,52 @@ +read(10); + $filenameHeaderLength = $this->getLengthOfPossibleFilenameHeader($stream, $header); + // Skip the header, that is 10 + length of filename + 1 (nil) bytes + $stream = new LimitStream($stream, -1, 10 + $filenameHeaderLength); + $resource = StreamWrapper::getResource($stream); + stream_filter_append($resource, 'zlib.inflate', STREAM_FILTER_READ); + $this->stream = new Stream($resource); + } + + /** + * @param StreamInterface $stream + * @param $header + * @return int + */ + private function getLengthOfPossibleFilenameHeader(StreamInterface $stream, $header) + { + $filename_header_length = 0; + + if (substr(bin2hex($header), 6, 2) === '08') { + // we have a filename, read until nil + $filename_header_length = 1; + while ($stream->read(1) !== chr(0)) { + $filename_header_length++; + } + } + + return $filename_header_length; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/LazyOpenStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/LazyOpenStream.php new file mode 100644 index 0000000..02cec3a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/LazyOpenStream.php @@ -0,0 +1,39 @@ +filename = $filename; + $this->mode = $mode; + } + + /** + * Creates the underlying stream lazily when required. + * + * @return StreamInterface + */ + protected function createStream() + { + return stream_for(try_fopen($this->filename, $this->mode)); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/LimitStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/LimitStream.php new file mode 100644 index 0000000..3c13d4f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/LimitStream.php @@ -0,0 +1,155 @@ +stream = $stream; + $this->setLimit($limit); + $this->setOffset($offset); + } + + public function eof() + { + // Always return true if the underlying stream is EOF + if ($this->stream->eof()) { + return true; + } + + // No limit and the underlying stream is not at EOF + if ($this->limit == -1) { + return false; + } + + return $this->stream->tell() >= $this->offset + $this->limit; + } + + /** + * Returns the size of the limited subset of data + * {@inheritdoc} + */ + public function getSize() + { + if (null === ($length = $this->stream->getSize())) { + return null; + } elseif ($this->limit == -1) { + return $length - $this->offset; + } else { + return min($this->limit, $length - $this->offset); + } + } + + /** + * Allow for a bounded seek on the read limited stream + * {@inheritdoc} + */ + public function seek($offset, $whence = SEEK_SET) + { + if ($whence !== SEEK_SET || $offset < 0) { + throw new \RuntimeException(sprintf( + 'Cannot seek to offset % with whence %s', + $offset, + $whence + )); + } + + $offset += $this->offset; + + if ($this->limit !== -1) { + if ($offset > $this->offset + $this->limit) { + $offset = $this->offset + $this->limit; + } + } + + $this->stream->seek($offset); + } + + /** + * Give a relative tell() + * {@inheritdoc} + */ + public function tell() + { + return $this->stream->tell() - $this->offset; + } + + /** + * Set the offset to start limiting from + * + * @param int $offset Offset to seek to and begin byte limiting from + * + * @throws \RuntimeException if the stream cannot be seeked. + */ + public function setOffset($offset) + { + $current = $this->stream->tell(); + + if ($current !== $offset) { + // If the stream cannot seek to the offset position, then read to it + if ($this->stream->isSeekable()) { + $this->stream->seek($offset); + } elseif ($current > $offset) { + throw new \RuntimeException("Could not seek to stream offset $offset"); + } else { + $this->stream->read($offset - $current); + } + } + + $this->offset = $offset; + } + + /** + * Set the limit of bytes that the decorator allows to be read from the + * stream. + * + * @param int $limit Number of bytes to allow to be read from the stream. + * Use -1 for no limit. + */ + public function setLimit($limit) + { + $this->limit = $limit; + } + + public function read($length) + { + if ($this->limit == -1) { + return $this->stream->read($length); + } + + // Check if the current position is less than the total allowed + // bytes + original offset + $remaining = ($this->offset + $this->limit) - $this->stream->tell(); + if ($remaining > 0) { + // Only return the amount of requested data, ensuring that the byte + // limit is not exceeded + return $this->stream->read(min($remaining, $length)); + } + + return ''; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/MessageTrait.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/MessageTrait.php new file mode 100644 index 0000000..1e4da64 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/MessageTrait.php @@ -0,0 +1,183 @@ + array of values */ + private $headers = []; + + /** @var array Map of lowercase header name => original name at registration */ + private $headerNames = []; + + /** @var string */ + private $protocol = '1.1'; + + /** @var StreamInterface */ + private $stream; + + public function getProtocolVersion() + { + return $this->protocol; + } + + public function withProtocolVersion($version) + { + if ($this->protocol === $version) { + return $this; + } + + $new = clone $this; + $new->protocol = $version; + return $new; + } + + public function getHeaders() + { + return $this->headers; + } + + public function hasHeader($header) + { + return isset($this->headerNames[strtolower($header)]); + } + + public function getHeader($header) + { + $header = strtolower($header); + + if (!isset($this->headerNames[$header])) { + return []; + } + + $header = $this->headerNames[$header]; + + return $this->headers[$header]; + } + + public function getHeaderLine($header) + { + return implode(', ', $this->getHeader($header)); + } + + public function withHeader($header, $value) + { + if (!is_array($value)) { + $value = [$value]; + } + + $value = $this->trimHeaderValues($value); + $normalized = strtolower($header); + + $new = clone $this; + if (isset($new->headerNames[$normalized])) { + unset($new->headers[$new->headerNames[$normalized]]); + } + $new->headerNames[$normalized] = $header; + $new->headers[$header] = $value; + + return $new; + } + + public function withAddedHeader($header, $value) + { + if (!is_array($value)) { + $value = [$value]; + } + + $value = $this->trimHeaderValues($value); + $normalized = strtolower($header); + + $new = clone $this; + if (isset($new->headerNames[$normalized])) { + $header = $this->headerNames[$normalized]; + $new->headers[$header] = array_merge($this->headers[$header], $value); + } else { + $new->headerNames[$normalized] = $header; + $new->headers[$header] = $value; + } + + return $new; + } + + public function withoutHeader($header) + { + $normalized = strtolower($header); + + if (!isset($this->headerNames[$normalized])) { + return $this; + } + + $header = $this->headerNames[$normalized]; + + $new = clone $this; + unset($new->headers[$header], $new->headerNames[$normalized]); + + return $new; + } + + public function getBody() + { + if (!$this->stream) { + $this->stream = stream_for(''); + } + + return $this->stream; + } + + public function withBody(StreamInterface $body) + { + if ($body === $this->stream) { + return $this; + } + + $new = clone $this; + $new->stream = $body; + return $new; + } + + private function setHeaders(array $headers) + { + $this->headerNames = $this->headers = []; + foreach ($headers as $header => $value) { + if (!is_array($value)) { + $value = [$value]; + } + + $value = $this->trimHeaderValues($value); + $normalized = strtolower($header); + if (isset($this->headerNames[$normalized])) { + $header = $this->headerNames[$normalized]; + $this->headers[$header] = array_merge($this->headers[$header], $value); + } else { + $this->headerNames[$normalized] = $header; + $this->headers[$header] = $value; + } + } + } + + /** + * Trims whitespace from the header values. + * + * Spaces and tabs ought to be excluded by parsers when extracting the field value from a header field. + * + * header-field = field-name ":" OWS field-value OWS + * OWS = *( SP / HTAB ) + * + * @param string[] $values Header values + * + * @return string[] Trimmed header values + * + * @see https://tools.ietf.org/html/rfc7230#section-3.2.4 + */ + private function trimHeaderValues(array $values) + { + return array_map(function ($value) { + return trim($value, " \t"); + }, $values); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/MultipartStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/MultipartStream.php new file mode 100644 index 0000000..c0fd584 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/MultipartStream.php @@ -0,0 +1,153 @@ +boundary = $boundary ?: sha1(uniqid('', true)); + $this->stream = $this->createStream($elements); + } + + /** + * Get the boundary + * + * @return string + */ + public function getBoundary() + { + return $this->boundary; + } + + public function isWritable() + { + return false; + } + + /** + * Get the headers needed before transferring the content of a POST file + */ + private function getHeaders(array $headers) + { + $str = ''; + foreach ($headers as $key => $value) { + $str .= "{$key}: {$value}\r\n"; + } + + return "--{$this->boundary}\r\n" . trim($str) . "\r\n\r\n"; + } + + /** + * Create the aggregate stream that will be used to upload the POST data + */ + protected function createStream(array $elements) + { + $stream = new AppendStream(); + + foreach ($elements as $element) { + $this->addElement($stream, $element); + } + + // Add the trailing boundary with CRLF + $stream->addStream(stream_for("--{$this->boundary}--\r\n")); + + return $stream; + } + + private function addElement(AppendStream $stream, array $element) + { + foreach (['contents', 'name'] as $key) { + if (!array_key_exists($key, $element)) { + throw new \InvalidArgumentException("A '{$key}' key is required"); + } + } + + $element['contents'] = stream_for($element['contents']); + + if (empty($element['filename'])) { + $uri = $element['contents']->getMetadata('uri'); + if (substr($uri, 0, 6) !== 'php://') { + $element['filename'] = $uri; + } + } + + list($body, $headers) = $this->createElement( + $element['name'], + $element['contents'], + isset($element['filename']) ? $element['filename'] : null, + isset($element['headers']) ? $element['headers'] : [] + ); + + $stream->addStream(stream_for($this->getHeaders($headers))); + $stream->addStream($body); + $stream->addStream(stream_for("\r\n")); + } + + /** + * @return array + */ + private function createElement($name, StreamInterface $stream, $filename, array $headers) + { + // Set a default content-disposition header if one was no provided + $disposition = $this->getHeader($headers, 'content-disposition'); + if (!$disposition) { + $headers['Content-Disposition'] = ($filename === '0' || $filename) + ? sprintf('form-data; name="%s"; filename="%s"', + $name, + basename($filename)) + : "form-data; name=\"{$name}\""; + } + + // Set a default content-length header if one was no provided + $length = $this->getHeader($headers, 'content-length'); + if (!$length) { + if ($length = $stream->getSize()) { + $headers['Content-Length'] = (string) $length; + } + } + + // Set a default Content-Type if one was not supplied + $type = $this->getHeader($headers, 'content-type'); + if (!$type && ($filename === '0' || $filename)) { + if ($type = mimetype_from_filename($filename)) { + $headers['Content-Type'] = $type; + } + } + + return [$stream, $headers]; + } + + private function getHeader(array $headers, $key) + { + $lowercaseHeader = strtolower($key); + foreach ($headers as $k => $v) { + if (strtolower($k) === $lowercaseHeader) { + return $v; + } + } + + return null; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/NoSeekStream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/NoSeekStream.php new file mode 100644 index 0000000..2332218 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/NoSeekStream.php @@ -0,0 +1,22 @@ +source = $source; + $this->size = isset($options['size']) ? $options['size'] : null; + $this->metadata = isset($options['metadata']) ? $options['metadata'] : []; + $this->buffer = new BufferStream(); + } + + public function __toString() + { + try { + return copy_to_string($this); + } catch (\Exception $e) { + return ''; + } + } + + public function close() + { + $this->detach(); + } + + public function detach() + { + $this->tellPos = false; + $this->source = null; + } + + public function getSize() + { + return $this->size; + } + + public function tell() + { + return $this->tellPos; + } + + public function eof() + { + return !$this->source; + } + + public function isSeekable() + { + return false; + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + throw new \RuntimeException('Cannot seek a PumpStream'); + } + + public function isWritable() + { + return false; + } + + public function write($string) + { + throw new \RuntimeException('Cannot write to a PumpStream'); + } + + public function isReadable() + { + return true; + } + + public function read($length) + { + $data = $this->buffer->read($length); + $readLen = strlen($data); + $this->tellPos += $readLen; + $remaining = $length - $readLen; + + if ($remaining) { + $this->pump($remaining); + $data .= $this->buffer->read($remaining); + $this->tellPos += strlen($data) - $readLen; + } + + return $data; + } + + public function getContents() + { + $result = ''; + while (!$this->eof()) { + $result .= $this->read(1000000); + } + + return $result; + } + + public function getMetadata($key = null) + { + if (!$key) { + return $this->metadata; + } + + return isset($this->metadata[$key]) ? $this->metadata[$key] : null; + } + + private function pump($length) + { + if ($this->source) { + do { + $data = call_user_func($this->source, $length); + if ($data === false || $data === null) { + $this->source = null; + return; + } + $this->buffer->write($data); + $length -= strlen($data); + } while ($length > 0); + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Request.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Request.php new file mode 100644 index 0000000..0828548 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Request.php @@ -0,0 +1,142 @@ +method = strtoupper($method); + $this->uri = $uri; + $this->setHeaders($headers); + $this->protocol = $version; + + if (!$this->hasHeader('Host')) { + $this->updateHostFromUri(); + } + + if ($body !== '' && $body !== null) { + $this->stream = stream_for($body); + } + } + + public function getRequestTarget() + { + if ($this->requestTarget !== null) { + return $this->requestTarget; + } + + $target = $this->uri->getPath(); + if ($target == '') { + $target = '/'; + } + if ($this->uri->getQuery() != '') { + $target .= '?' . $this->uri->getQuery(); + } + + return $target; + } + + public function withRequestTarget($requestTarget) + { + if (preg_match('#\s#', $requestTarget)) { + throw new InvalidArgumentException( + 'Invalid request target provided; cannot contain whitespace' + ); + } + + $new = clone $this; + $new->requestTarget = $requestTarget; + return $new; + } + + public function getMethod() + { + return $this->method; + } + + public function withMethod($method) + { + $new = clone $this; + $new->method = strtoupper($method); + return $new; + } + + public function getUri() + { + return $this->uri; + } + + public function withUri(UriInterface $uri, $preserveHost = false) + { + if ($uri === $this->uri) { + return $this; + } + + $new = clone $this; + $new->uri = $uri; + + if (!$preserveHost) { + $new->updateHostFromUri(); + } + + return $new; + } + + private function updateHostFromUri() + { + $host = $this->uri->getHost(); + + if ($host == '') { + return; + } + + if (($port = $this->uri->getPort()) !== null) { + $host .= ':' . $port; + } + + if (isset($this->headerNames['host'])) { + $header = $this->headerNames['host']; + } else { + $header = 'Host'; + $this->headerNames['host'] = 'Host'; + } + // Ensure Host is the first header. + // See: http://tools.ietf.org/html/rfc7230#section-5.4 + $this->headers = [$header => [$host]] + $this->headers; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Response.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Response.php new file mode 100644 index 0000000..2830c6c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Response.php @@ -0,0 +1,132 @@ + 'Continue', + 101 => 'Switching Protocols', + 102 => 'Processing', + 200 => 'OK', + 201 => 'Created', + 202 => 'Accepted', + 203 => 'Non-Authoritative Information', + 204 => 'No Content', + 205 => 'Reset Content', + 206 => 'Partial Content', + 207 => 'Multi-status', + 208 => 'Already Reported', + 300 => 'Multiple Choices', + 301 => 'Moved Permanently', + 302 => 'Found', + 303 => 'See Other', + 304 => 'Not Modified', + 305 => 'Use Proxy', + 306 => 'Switch Proxy', + 307 => 'Temporary Redirect', + 400 => 'Bad Request', + 401 => 'Unauthorized', + 402 => 'Payment Required', + 403 => 'Forbidden', + 404 => 'Not Found', + 405 => 'Method Not Allowed', + 406 => 'Not Acceptable', + 407 => 'Proxy Authentication Required', + 408 => 'Request Time-out', + 409 => 'Conflict', + 410 => 'Gone', + 411 => 'Length Required', + 412 => 'Precondition Failed', + 413 => 'Request Entity Too Large', + 414 => 'Request-URI Too Large', + 415 => 'Unsupported Media Type', + 416 => 'Requested range not satisfiable', + 417 => 'Expectation Failed', + 418 => 'I\'m a teapot', + 422 => 'Unprocessable Entity', + 423 => 'Locked', + 424 => 'Failed Dependency', + 425 => 'Unordered Collection', + 426 => 'Upgrade Required', + 428 => 'Precondition Required', + 429 => 'Too Many Requests', + 431 => 'Request Header Fields Too Large', + 451 => 'Unavailable For Legal Reasons', + 500 => 'Internal Server Error', + 501 => 'Not Implemented', + 502 => 'Bad Gateway', + 503 => 'Service Unavailable', + 504 => 'Gateway Time-out', + 505 => 'HTTP Version not supported', + 506 => 'Variant Also Negotiates', + 507 => 'Insufficient Storage', + 508 => 'Loop Detected', + 511 => 'Network Authentication Required', + ]; + + /** @var string */ + private $reasonPhrase = ''; + + /** @var int */ + private $statusCode = 200; + + /** + * @param int $status Status code + * @param array $headers Response headers + * @param string|null|resource|StreamInterface $body Response body + * @param string $version Protocol version + * @param string|null $reason Reason phrase (when empty a default will be used based on the status code) + */ + public function __construct( + $status = 200, + array $headers = [], + $body = null, + $version = '1.1', + $reason = null + ) { + $this->statusCode = (int) $status; + + if ($body !== '' && $body !== null) { + $this->stream = stream_for($body); + } + + $this->setHeaders($headers); + if ($reason == '' && isset(self::$phrases[$this->statusCode])) { + $this->reasonPhrase = self::$phrases[$this->statusCode]; + } else { + $this->reasonPhrase = (string) $reason; + } + + $this->protocol = $version; + } + + public function getStatusCode() + { + return $this->statusCode; + } + + public function getReasonPhrase() + { + return $this->reasonPhrase; + } + + public function withStatus($code, $reasonPhrase = '') + { + $new = clone $this; + $new->statusCode = (int) $code; + if ($reasonPhrase == '' && isset(self::$phrases[$new->statusCode])) { + $reasonPhrase = self::$phrases[$new->statusCode]; + } + $new->reasonPhrase = $reasonPhrase; + return $new; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/ServerRequest.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/ServerRequest.php new file mode 100644 index 0000000..575aab8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/ServerRequest.php @@ -0,0 +1,358 @@ +serverParams = $serverParams; + + parent::__construct($method, $uri, $headers, $body, $version); + } + + /** + * Return an UploadedFile instance array. + * + * @param array $files A array which respect $_FILES structure + * @throws InvalidArgumentException for unrecognized values + * @return array + */ + public static function normalizeFiles(array $files) + { + $normalized = []; + + foreach ($files as $key => $value) { + if ($value instanceof UploadedFileInterface) { + $normalized[$key] = $value; + } elseif (is_array($value) && isset($value['tmp_name'])) { + $normalized[$key] = self::createUploadedFileFromSpec($value); + } elseif (is_array($value)) { + $normalized[$key] = self::normalizeFiles($value); + continue; + } else { + throw new InvalidArgumentException('Invalid value in files specification'); + } + } + + return $normalized; + } + + /** + * Create and return an UploadedFile instance from a $_FILES specification. + * + * If the specification represents an array of values, this method will + * delegate to normalizeNestedFileSpec() and return that return value. + * + * @param array $value $_FILES struct + * @return array|UploadedFileInterface + */ + private static function createUploadedFileFromSpec(array $value) + { + if (is_array($value['tmp_name'])) { + return self::normalizeNestedFileSpec($value); + } + + return new UploadedFile( + $value['tmp_name'], + (int) $value['size'], + (int) $value['error'], + $value['name'], + $value['type'] + ); + } + + /** + * Normalize an array of file specifications. + * + * Loops through all nested files and returns a normalized array of + * UploadedFileInterface instances. + * + * @param array $files + * @return UploadedFileInterface[] + */ + private static function normalizeNestedFileSpec(array $files = []) + { + $normalizedFiles = []; + + foreach (array_keys($files['tmp_name']) as $key) { + $spec = [ + 'tmp_name' => $files['tmp_name'][$key], + 'size' => $files['size'][$key], + 'error' => $files['error'][$key], + 'name' => $files['name'][$key], + 'type' => $files['type'][$key], + ]; + $normalizedFiles[$key] = self::createUploadedFileFromSpec($spec); + } + + return $normalizedFiles; + } + + /** + * Return a ServerRequest populated with superglobals: + * $_GET + * $_POST + * $_COOKIE + * $_FILES + * $_SERVER + * + * @return ServerRequestInterface + */ + public static function fromGlobals() + { + $method = isset($_SERVER['REQUEST_METHOD']) ? $_SERVER['REQUEST_METHOD'] : 'GET'; + $headers = function_exists('getallheaders') ? getallheaders() : []; + $uri = self::getUriFromGlobals(); + $body = new LazyOpenStream('php://input', 'r+'); + $protocol = isset($_SERVER['SERVER_PROTOCOL']) ? str_replace('HTTP/', '', $_SERVER['SERVER_PROTOCOL']) : '1.1'; + + $serverRequest = new ServerRequest($method, $uri, $headers, $body, $protocol, $_SERVER); + + return $serverRequest + ->withCookieParams($_COOKIE) + ->withQueryParams($_GET) + ->withParsedBody($_POST) + ->withUploadedFiles(self::normalizeFiles($_FILES)); + } + + /** + * Get a Uri populated with values from $_SERVER. + * + * @return UriInterface + */ + public static function getUriFromGlobals() { + $uri = new Uri(''); + + $uri = $uri->withScheme(!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off' ? 'https' : 'http'); + + $hasPort = false; + if (isset($_SERVER['HTTP_HOST'])) { + $hostHeaderParts = explode(':', $_SERVER['HTTP_HOST']); + $uri = $uri->withHost($hostHeaderParts[0]); + if (isset($hostHeaderParts[1])) { + $hasPort = true; + $uri = $uri->withPort($hostHeaderParts[1]); + } + } elseif (isset($_SERVER['SERVER_NAME'])) { + $uri = $uri->withHost($_SERVER['SERVER_NAME']); + } elseif (isset($_SERVER['SERVER_ADDR'])) { + $uri = $uri->withHost($_SERVER['SERVER_ADDR']); + } + + if (!$hasPort && isset($_SERVER['SERVER_PORT'])) { + $uri = $uri->withPort($_SERVER['SERVER_PORT']); + } + + $hasQuery = false; + if (isset($_SERVER['REQUEST_URI'])) { + $requestUriParts = explode('?', $_SERVER['REQUEST_URI']); + $uri = $uri->withPath($requestUriParts[0]); + if (isset($requestUriParts[1])) { + $hasQuery = true; + $uri = $uri->withQuery($requestUriParts[1]); + } + } + + if (!$hasQuery && isset($_SERVER['QUERY_STRING'])) { + $uri = $uri->withQuery($_SERVER['QUERY_STRING']); + } + + return $uri; + } + + + /** + * {@inheritdoc} + */ + public function getServerParams() + { + return $this->serverParams; + } + + /** + * {@inheritdoc} + */ + public function getUploadedFiles() + { + return $this->uploadedFiles; + } + + /** + * {@inheritdoc} + */ + public function withUploadedFiles(array $uploadedFiles) + { + $new = clone $this; + $new->uploadedFiles = $uploadedFiles; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getCookieParams() + { + return $this->cookieParams; + } + + /** + * {@inheritdoc} + */ + public function withCookieParams(array $cookies) + { + $new = clone $this; + $new->cookieParams = $cookies; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getQueryParams() + { + return $this->queryParams; + } + + /** + * {@inheritdoc} + */ + public function withQueryParams(array $query) + { + $new = clone $this; + $new->queryParams = $query; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getParsedBody() + { + return $this->parsedBody; + } + + /** + * {@inheritdoc} + */ + public function withParsedBody($data) + { + $new = clone $this; + $new->parsedBody = $data; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getAttributes() + { + return $this->attributes; + } + + /** + * {@inheritdoc} + */ + public function getAttribute($attribute, $default = null) + { + if (false === array_key_exists($attribute, $this->attributes)) { + return $default; + } + + return $this->attributes[$attribute]; + } + + /** + * {@inheritdoc} + */ + public function withAttribute($attribute, $value) + { + $new = clone $this; + $new->attributes[$attribute] = $value; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function withoutAttribute($attribute) + { + if (false === array_key_exists($attribute, $this->attributes)) { + return $this; + } + + $new = clone $this; + unset($new->attributes[$attribute]); + + return $new; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Stream.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Stream.php new file mode 100644 index 0000000..e336628 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Stream.php @@ -0,0 +1,257 @@ + [ + 'r' => true, 'w+' => true, 'r+' => true, 'x+' => true, 'c+' => true, + 'rb' => true, 'w+b' => true, 'r+b' => true, 'x+b' => true, + 'c+b' => true, 'rt' => true, 'w+t' => true, 'r+t' => true, + 'x+t' => true, 'c+t' => true, 'a+' => true + ], + 'write' => [ + 'w' => true, 'w+' => true, 'rw' => true, 'r+' => true, 'x+' => true, + 'c+' => true, 'wb' => true, 'w+b' => true, 'r+b' => true, + 'x+b' => true, 'c+b' => true, 'w+t' => true, 'r+t' => true, + 'x+t' => true, 'c+t' => true, 'a' => true, 'a+' => true + ] + ]; + + /** + * This constructor accepts an associative array of options. + * + * - size: (int) If a read stream would otherwise have an indeterminate + * size, but the size is known due to foreknowledge, then you can + * provide that size, in bytes. + * - metadata: (array) Any additional metadata to return when the metadata + * of the stream is accessed. + * + * @param resource $stream Stream resource to wrap. + * @param array $options Associative array of options. + * + * @throws \InvalidArgumentException if the stream is not a stream resource + */ + public function __construct($stream, $options = []) + { + if (!is_resource($stream)) { + throw new \InvalidArgumentException('Stream must be a resource'); + } + + if (isset($options['size'])) { + $this->size = $options['size']; + } + + $this->customMetadata = isset($options['metadata']) + ? $options['metadata'] + : []; + + $this->stream = $stream; + $meta = stream_get_meta_data($this->stream); + $this->seekable = $meta['seekable']; + $this->readable = isset(self::$readWriteHash['read'][$meta['mode']]); + $this->writable = isset(self::$readWriteHash['write'][$meta['mode']]); + $this->uri = $this->getMetadata('uri'); + } + + public function __get($name) + { + if ($name == 'stream') { + throw new \RuntimeException('The stream is detached'); + } + + throw new \BadMethodCallException('No value for ' . $name); + } + + /** + * Closes the stream when the destructed + */ + public function __destruct() + { + $this->close(); + } + + public function __toString() + { + try { + $this->seek(0); + return (string) stream_get_contents($this->stream); + } catch (\Exception $e) { + return ''; + } + } + + public function getContents() + { + $contents = stream_get_contents($this->stream); + + if ($contents === false) { + throw new \RuntimeException('Unable to read stream contents'); + } + + return $contents; + } + + public function close() + { + if (isset($this->stream)) { + if (is_resource($this->stream)) { + fclose($this->stream); + } + $this->detach(); + } + } + + public function detach() + { + if (!isset($this->stream)) { + return null; + } + + $result = $this->stream; + unset($this->stream); + $this->size = $this->uri = null; + $this->readable = $this->writable = $this->seekable = false; + + return $result; + } + + public function getSize() + { + if ($this->size !== null) { + return $this->size; + } + + if (!isset($this->stream)) { + return null; + } + + // Clear the stat cache if the stream has a URI + if ($this->uri) { + clearstatcache(true, $this->uri); + } + + $stats = fstat($this->stream); + if (isset($stats['size'])) { + $this->size = $stats['size']; + return $this->size; + } + + return null; + } + + public function isReadable() + { + return $this->readable; + } + + public function isWritable() + { + return $this->writable; + } + + public function isSeekable() + { + return $this->seekable; + } + + public function eof() + { + return !$this->stream || feof($this->stream); + } + + public function tell() + { + $result = ftell($this->stream); + + if ($result === false) { + throw new \RuntimeException('Unable to determine stream position'); + } + + return $result; + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + if (!$this->seekable) { + throw new \RuntimeException('Stream is not seekable'); + } elseif (fseek($this->stream, $offset, $whence) === -1) { + throw new \RuntimeException('Unable to seek to stream position ' + . $offset . ' with whence ' . var_export($whence, true)); + } + } + + public function read($length) + { + if (!$this->readable) { + throw new \RuntimeException('Cannot read from non-readable stream'); + } + if ($length < 0) { + throw new \RuntimeException('Length parameter cannot be negative'); + } + + if (0 === $length) { + return ''; + } + + $string = fread($this->stream, $length); + if (false === $string) { + throw new \RuntimeException('Unable to read from stream'); + } + + return $string; + } + + public function write($string) + { + if (!$this->writable) { + throw new \RuntimeException('Cannot write to a non-writable stream'); + } + + // We can't know the size after writing anything + $this->size = null; + $result = fwrite($this->stream, $string); + + if ($result === false) { + throw new \RuntimeException('Unable to write to stream'); + } + + return $result; + } + + public function getMetadata($key = null) + { + if (!isset($this->stream)) { + return $key ? null : []; + } elseif (!$key) { + return $this->customMetadata + stream_get_meta_data($this->stream); + } elseif (isset($this->customMetadata[$key])) { + return $this->customMetadata[$key]; + } + + $meta = stream_get_meta_data($this->stream); + + return isset($meta[$key]) ? $meta[$key] : null; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/StreamDecoratorTrait.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/StreamDecoratorTrait.php new file mode 100644 index 0000000..daec6f5 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/StreamDecoratorTrait.php @@ -0,0 +1,149 @@ +stream = $stream; + } + + /** + * Magic method used to create a new stream if streams are not added in + * the constructor of a decorator (e.g., LazyOpenStream). + * + * @param string $name Name of the property (allows "stream" only). + * + * @return StreamInterface + */ + public function __get($name) + { + if ($name == 'stream') { + $this->stream = $this->createStream(); + return $this->stream; + } + + throw new \UnexpectedValueException("$name not found on class"); + } + + public function __toString() + { + try { + if ($this->isSeekable()) { + $this->seek(0); + } + return $this->getContents(); + } catch (\Exception $e) { + // Really, PHP? https://bugs.php.net/bug.php?id=53648 + trigger_error('StreamDecorator::__toString exception: ' + . (string) $e, E_USER_ERROR); + return ''; + } + } + + public function getContents() + { + return copy_to_string($this); + } + + /** + * Allow decorators to implement custom methods + * + * @param string $method Missing method name + * @param array $args Method arguments + * + * @return mixed + */ + public function __call($method, array $args) + { + $result = call_user_func_array([$this->stream, $method], $args); + + // Always return the wrapped object if the result is a return $this + return $result === $this->stream ? $this : $result; + } + + public function close() + { + $this->stream->close(); + } + + public function getMetadata($key = null) + { + return $this->stream->getMetadata($key); + } + + public function detach() + { + return $this->stream->detach(); + } + + public function getSize() + { + return $this->stream->getSize(); + } + + public function eof() + { + return $this->stream->eof(); + } + + public function tell() + { + return $this->stream->tell(); + } + + public function isReadable() + { + return $this->stream->isReadable(); + } + + public function isWritable() + { + return $this->stream->isWritable(); + } + + public function isSeekable() + { + return $this->stream->isSeekable(); + } + + public function rewind() + { + $this->seek(0); + } + + public function seek($offset, $whence = SEEK_SET) + { + $this->stream->seek($offset, $whence); + } + + public function read($length) + { + return $this->stream->read($length); + } + + public function write($string) + { + return $this->stream->write($string); + } + + /** + * Implement in subclasses to dynamically create streams when requested. + * + * @return StreamInterface + * @throws \BadMethodCallException + */ + protected function createStream() + { + throw new \BadMethodCallException('Not implemented'); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/StreamWrapper.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/StreamWrapper.php new file mode 100644 index 0000000..cf7b223 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/StreamWrapper.php @@ -0,0 +1,121 @@ +isReadable()) { + $mode = $stream->isWritable() ? 'r+' : 'r'; + } elseif ($stream->isWritable()) { + $mode = 'w'; + } else { + throw new \InvalidArgumentException('The stream must be readable, ' + . 'writable, or both.'); + } + + return fopen('guzzle://stream', $mode, null, stream_context_create([ + 'guzzle' => ['stream' => $stream] + ])); + } + + /** + * Registers the stream wrapper if needed + */ + public static function register() + { + if (!in_array('guzzle', stream_get_wrappers())) { + stream_wrapper_register('guzzle', __CLASS__); + } + } + + public function stream_open($path, $mode, $options, &$opened_path) + { + $options = stream_context_get_options($this->context); + + if (!isset($options['guzzle']['stream'])) { + return false; + } + + $this->mode = $mode; + $this->stream = $options['guzzle']['stream']; + + return true; + } + + public function stream_read($count) + { + return $this->stream->read($count); + } + + public function stream_write($data) + { + return (int) $this->stream->write($data); + } + + public function stream_tell() + { + return $this->stream->tell(); + } + + public function stream_eof() + { + return $this->stream->eof(); + } + + public function stream_seek($offset, $whence) + { + $this->stream->seek($offset, $whence); + + return true; + } + + public function stream_stat() + { + static $modeMap = [ + 'r' => 33060, + 'r+' => 33206, + 'w' => 33188 + ]; + + return [ + 'dev' => 0, + 'ino' => 0, + 'mode' => $modeMap[$this->mode], + 'nlink' => 0, + 'uid' => 0, + 'gid' => 0, + 'rdev' => 0, + 'size' => $this->stream->getSize() ?: 0, + 'atime' => 0, + 'mtime' => 0, + 'ctime' => 0, + 'blksize' => 0, + 'blocks' => 0 + ]; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UploadedFile.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UploadedFile.php new file mode 100644 index 0000000..e62bd5c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UploadedFile.php @@ -0,0 +1,316 @@ +setError($errorStatus); + $this->setSize($size); + $this->setClientFilename($clientFilename); + $this->setClientMediaType($clientMediaType); + + if ($this->isOk()) { + $this->setStreamOrFile($streamOrFile); + } + } + + /** + * Depending on the value set file or stream variable + * + * @param mixed $streamOrFile + * @throws InvalidArgumentException + */ + private function setStreamOrFile($streamOrFile) + { + if (is_string($streamOrFile)) { + $this->file = $streamOrFile; + } elseif (is_resource($streamOrFile)) { + $this->stream = new Stream($streamOrFile); + } elseif ($streamOrFile instanceof StreamInterface) { + $this->stream = $streamOrFile; + } else { + throw new InvalidArgumentException( + 'Invalid stream or file provided for UploadedFile' + ); + } + } + + /** + * @param int $error + * @throws InvalidArgumentException + */ + private function setError($error) + { + if (false === is_int($error)) { + throw new InvalidArgumentException( + 'Upload file error status must be an integer' + ); + } + + if (false === in_array($error, UploadedFile::$errors)) { + throw new InvalidArgumentException( + 'Invalid error status for UploadedFile' + ); + } + + $this->error = $error; + } + + /** + * @param int $size + * @throws InvalidArgumentException + */ + private function setSize($size) + { + if (false === is_int($size)) { + throw new InvalidArgumentException( + 'Upload file size must be an integer' + ); + } + + $this->size = $size; + } + + /** + * @param mixed $param + * @return boolean + */ + private function isStringOrNull($param) + { + return in_array(gettype($param), ['string', 'NULL']); + } + + /** + * @param mixed $param + * @return boolean + */ + private function isStringNotEmpty($param) + { + return is_string($param) && false === empty($param); + } + + /** + * @param string|null $clientFilename + * @throws InvalidArgumentException + */ + private function setClientFilename($clientFilename) + { + if (false === $this->isStringOrNull($clientFilename)) { + throw new InvalidArgumentException( + 'Upload file client filename must be a string or null' + ); + } + + $this->clientFilename = $clientFilename; + } + + /** + * @param string|null $clientMediaType + * @throws InvalidArgumentException + */ + private function setClientMediaType($clientMediaType) + { + if (false === $this->isStringOrNull($clientMediaType)) { + throw new InvalidArgumentException( + 'Upload file client media type must be a string or null' + ); + } + + $this->clientMediaType = $clientMediaType; + } + + /** + * Return true if there is no upload error + * + * @return boolean + */ + private function isOk() + { + return $this->error === UPLOAD_ERR_OK; + } + + /** + * @return boolean + */ + public function isMoved() + { + return $this->moved; + } + + /** + * @throws RuntimeException if is moved or not ok + */ + private function validateActive() + { + if (false === $this->isOk()) { + throw new RuntimeException('Cannot retrieve stream due to upload error'); + } + + if ($this->isMoved()) { + throw new RuntimeException('Cannot retrieve stream after it has already been moved'); + } + } + + /** + * {@inheritdoc} + * @throws RuntimeException if the upload was not successful. + */ + public function getStream() + { + $this->validateActive(); + + if ($this->stream instanceof StreamInterface) { + return $this->stream; + } + + return new LazyOpenStream($this->file, 'r+'); + } + + /** + * {@inheritdoc} + * + * @see http://php.net/is_uploaded_file + * @see http://php.net/move_uploaded_file + * @param string $targetPath Path to which to move the uploaded file. + * @throws RuntimeException if the upload was not successful. + * @throws InvalidArgumentException if the $path specified is invalid. + * @throws RuntimeException on any error during the move operation, or on + * the second or subsequent call to the method. + */ + public function moveTo($targetPath) + { + $this->validateActive(); + + if (false === $this->isStringNotEmpty($targetPath)) { + throw new InvalidArgumentException( + 'Invalid path provided for move operation; must be a non-empty string' + ); + } + + if ($this->file) { + $this->moved = php_sapi_name() == 'cli' + ? rename($this->file, $targetPath) + : move_uploaded_file($this->file, $targetPath); + } else { + copy_to_stream( + $this->getStream(), + new LazyOpenStream($targetPath, 'w') + ); + + $this->moved = true; + } + + if (false === $this->moved) { + throw new RuntimeException( + sprintf('Uploaded file could not be moved to %s', $targetPath) + ); + } + } + + /** + * {@inheritdoc} + * + * @return int|null The file size in bytes or null if unknown. + */ + public function getSize() + { + return $this->size; + } + + /** + * {@inheritdoc} + * + * @see http://php.net/manual/en/features.file-upload.errors.php + * @return int One of PHP's UPLOAD_ERR_XXX constants. + */ + public function getError() + { + return $this->error; + } + + /** + * {@inheritdoc} + * + * @return string|null The filename sent by the client or null if none + * was provided. + */ + public function getClientFilename() + { + return $this->clientFilename; + } + + /** + * {@inheritdoc} + */ + public function getClientMediaType() + { + return $this->clientMediaType; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Uri.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Uri.php new file mode 100644 index 0000000..f46c1db --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/Uri.php @@ -0,0 +1,702 @@ + 80, + 'https' => 443, + 'ftp' => 21, + 'gopher' => 70, + 'nntp' => 119, + 'news' => 119, + 'telnet' => 23, + 'tn3270' => 23, + 'imap' => 143, + 'pop' => 110, + 'ldap' => 389, + ]; + + private static $charUnreserved = 'a-zA-Z0-9_\-\.~'; + private static $charSubDelims = '!\$&\'\(\)\*\+,;='; + private static $replaceQuery = ['=' => '%3D', '&' => '%26']; + + /** @var string Uri scheme. */ + private $scheme = ''; + + /** @var string Uri user info. */ + private $userInfo = ''; + + /** @var string Uri host. */ + private $host = ''; + + /** @var int|null Uri port. */ + private $port; + + /** @var string Uri path. */ + private $path = ''; + + /** @var string Uri query string. */ + private $query = ''; + + /** @var string Uri fragment. */ + private $fragment = ''; + + /** + * @param string $uri URI to parse + */ + public function __construct($uri = '') + { + // weak type check to also accept null until we can add scalar type hints + if ($uri != '') { + $parts = parse_url($uri); + if ($parts === false) { + throw new \InvalidArgumentException("Unable to parse URI: $uri"); + } + $this->applyParts($parts); + } + } + + public function __toString() + { + return self::composeComponents( + $this->scheme, + $this->getAuthority(), + $this->path, + $this->query, + $this->fragment + ); + } + + /** + * Composes a URI reference string from its various components. + * + * Usually this method does not need to be called manually but instead is used indirectly via + * `Psr\Http\Message\UriInterface::__toString`. + * + * PSR-7 UriInterface treats an empty component the same as a missing component as + * getQuery(), getFragment() etc. always return a string. This explains the slight + * difference to RFC 3986 Section 5.3. + * + * Another adjustment is that the authority separator is added even when the authority is missing/empty + * for the "file" scheme. This is because PHP stream functions like `file_get_contents` only work with + * `file:///myfile` but not with `file:/myfile` although they are equivalent according to RFC 3986. But + * `file:///` is the more common syntax for the file scheme anyway (Chrome for example redirects to + * that format). + * + * @param string $scheme + * @param string $authority + * @param string $path + * @param string $query + * @param string $fragment + * + * @return string + * + * @link https://tools.ietf.org/html/rfc3986#section-5.3 + */ + public static function composeComponents($scheme, $authority, $path, $query, $fragment) + { + $uri = ''; + + // weak type checks to also accept null until we can add scalar type hints + if ($scheme != '') { + $uri .= $scheme . ':'; + } + + if ($authority != ''|| $scheme === 'file') { + $uri .= '//' . $authority; + } + + $uri .= $path; + + if ($query != '') { + $uri .= '?' . $query; + } + + if ($fragment != '') { + $uri .= '#' . $fragment; + } + + return $uri; + } + + /** + * Whether the URI has the default port of the current scheme. + * + * `Psr\Http\Message\UriInterface::getPort` may return null or the standard port. This method can be used + * independently of the implementation. + * + * @param UriInterface $uri + * + * @return bool + */ + public static function isDefaultPort(UriInterface $uri) + { + return $uri->getPort() === null + || (isset(self::$defaultPorts[$uri->getScheme()]) && $uri->getPort() === self::$defaultPorts[$uri->getScheme()]); + } + + /** + * Whether the URI is absolute, i.e. it has a scheme. + * + * An instance of UriInterface can either be an absolute URI or a relative reference. This method returns true + * if it is the former. An absolute URI has a scheme. A relative reference is used to express a URI relative + * to another URI, the base URI. Relative references can be divided into several forms: + * - network-path references, e.g. '//example.com/path' + * - absolute-path references, e.g. '/path' + * - relative-path references, e.g. 'subpath' + * + * @param UriInterface $uri + * + * @return bool + * @see Uri::isNetworkPathReference + * @see Uri::isAbsolutePathReference + * @see Uri::isRelativePathReference + * @link https://tools.ietf.org/html/rfc3986#section-4 + */ + public static function isAbsolute(UriInterface $uri) + { + return $uri->getScheme() !== ''; + } + + /** + * Whether the URI is a network-path reference. + * + * A relative reference that begins with two slash characters is termed an network-path reference. + * + * @param UriInterface $uri + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public static function isNetworkPathReference(UriInterface $uri) + { + return $uri->getScheme() === '' && $uri->getAuthority() !== ''; + } + + /** + * Whether the URI is a absolute-path reference. + * + * A relative reference that begins with a single slash character is termed an absolute-path reference. + * + * @param UriInterface $uri + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public static function isAbsolutePathReference(UriInterface $uri) + { + return $uri->getScheme() === '' + && $uri->getAuthority() === '' + && isset($uri->getPath()[0]) + && $uri->getPath()[0] === '/'; + } + + /** + * Whether the URI is a relative-path reference. + * + * A relative reference that does not begin with a slash character is termed a relative-path reference. + * + * @param UriInterface $uri + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public static function isRelativePathReference(UriInterface $uri) + { + return $uri->getScheme() === '' + && $uri->getAuthority() === '' + && (!isset($uri->getPath()[0]) || $uri->getPath()[0] !== '/'); + } + + /** + * Whether the URI is a same-document reference. + * + * A same-document reference refers to a URI that is, aside from its fragment + * component, identical to the base URI. When no base URI is given, only an empty + * URI reference (apart from its fragment) is considered a same-document reference. + * + * @param UriInterface $uri The URI to check + * @param UriInterface|null $base An optional base URI to compare against + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.4 + */ + public static function isSameDocumentReference(UriInterface $uri, UriInterface $base = null) + { + if ($base !== null) { + $uri = UriResolver::resolve($base, $uri); + + return ($uri->getScheme() === $base->getScheme()) + && ($uri->getAuthority() === $base->getAuthority()) + && ($uri->getPath() === $base->getPath()) + && ($uri->getQuery() === $base->getQuery()); + } + + return $uri->getScheme() === '' && $uri->getAuthority() === '' && $uri->getPath() === '' && $uri->getQuery() === ''; + } + + /** + * Removes dot segments from a path and returns the new path. + * + * @param string $path + * + * @return string + * + * @deprecated since version 1.4. Use UriResolver::removeDotSegments instead. + * @see UriResolver::removeDotSegments + */ + public static function removeDotSegments($path) + { + return UriResolver::removeDotSegments($path); + } + + /** + * Converts the relative URI into a new URI that is resolved against the base URI. + * + * @param UriInterface $base Base URI + * @param string|UriInterface $rel Relative URI + * + * @return UriInterface + * + * @deprecated since version 1.4. Use UriResolver::resolve instead. + * @see UriResolver::resolve + */ + public static function resolve(UriInterface $base, $rel) + { + if (!($rel instanceof UriInterface)) { + $rel = new self($rel); + } + + return UriResolver::resolve($base, $rel); + } + + /** + * Creates a new URI with a specific query string value removed. + * + * Any existing query string values that exactly match the provided key are + * removed. + * + * @param UriInterface $uri URI to use as a base. + * @param string $key Query string key to remove. + * + * @return UriInterface + */ + public static function withoutQueryValue(UriInterface $uri, $key) + { + $current = $uri->getQuery(); + if ($current === '') { + return $uri; + } + + $decodedKey = rawurldecode($key); + $result = array_filter(explode('&', $current), function ($part) use ($decodedKey) { + return rawurldecode(explode('=', $part)[0]) !== $decodedKey; + }); + + return $uri->withQuery(implode('&', $result)); + } + + /** + * Creates a new URI with a specific query string value. + * + * Any existing query string values that exactly match the provided key are + * removed and replaced with the given key value pair. + * + * A value of null will set the query string key without a value, e.g. "key" + * instead of "key=value". + * + * @param UriInterface $uri URI to use as a base. + * @param string $key Key to set. + * @param string|null $value Value to set + * + * @return UriInterface + */ + public static function withQueryValue(UriInterface $uri, $key, $value) + { + $current = $uri->getQuery(); + + if ($current === '') { + $result = []; + } else { + $decodedKey = rawurldecode($key); + $result = array_filter(explode('&', $current), function ($part) use ($decodedKey) { + return rawurldecode(explode('=', $part)[0]) !== $decodedKey; + }); + } + + // Query string separators ("=", "&") within the key or value need to be encoded + // (while preventing double-encoding) before setting the query string. All other + // chars that need percent-encoding will be encoded by withQuery(). + $key = strtr($key, self::$replaceQuery); + + if ($value !== null) { + $result[] = $key . '=' . strtr($value, self::$replaceQuery); + } else { + $result[] = $key; + } + + return $uri->withQuery(implode('&', $result)); + } + + /** + * Creates a URI from a hash of `parse_url` components. + * + * @param array $parts + * + * @return UriInterface + * @link http://php.net/manual/en/function.parse-url.php + * + * @throws \InvalidArgumentException If the components do not form a valid URI. + */ + public static function fromParts(array $parts) + { + $uri = new self(); + $uri->applyParts($parts); + $uri->validateState(); + + return $uri; + } + + public function getScheme() + { + return $this->scheme; + } + + public function getAuthority() + { + $authority = $this->host; + if ($this->userInfo !== '') { + $authority = $this->userInfo . '@' . $authority; + } + + if ($this->port !== null) { + $authority .= ':' . $this->port; + } + + return $authority; + } + + public function getUserInfo() + { + return $this->userInfo; + } + + public function getHost() + { + return $this->host; + } + + public function getPort() + { + return $this->port; + } + + public function getPath() + { + return $this->path; + } + + public function getQuery() + { + return $this->query; + } + + public function getFragment() + { + return $this->fragment; + } + + public function withScheme($scheme) + { + $scheme = $this->filterScheme($scheme); + + if ($this->scheme === $scheme) { + return $this; + } + + $new = clone $this; + $new->scheme = $scheme; + $new->removeDefaultPort(); + $new->validateState(); + + return $new; + } + + public function withUserInfo($user, $password = null) + { + $info = $user; + if ($password != '') { + $info .= ':' . $password; + } + + if ($this->userInfo === $info) { + return $this; + } + + $new = clone $this; + $new->userInfo = $info; + $new->validateState(); + + return $new; + } + + public function withHost($host) + { + $host = $this->filterHost($host); + + if ($this->host === $host) { + return $this; + } + + $new = clone $this; + $new->host = $host; + $new->validateState(); + + return $new; + } + + public function withPort($port) + { + $port = $this->filterPort($port); + + if ($this->port === $port) { + return $this; + } + + $new = clone $this; + $new->port = $port; + $new->removeDefaultPort(); + $new->validateState(); + + return $new; + } + + public function withPath($path) + { + $path = $this->filterPath($path); + + if ($this->path === $path) { + return $this; + } + + $new = clone $this; + $new->path = $path; + $new->validateState(); + + return $new; + } + + public function withQuery($query) + { + $query = $this->filterQueryAndFragment($query); + + if ($this->query === $query) { + return $this; + } + + $new = clone $this; + $new->query = $query; + + return $new; + } + + public function withFragment($fragment) + { + $fragment = $this->filterQueryAndFragment($fragment); + + if ($this->fragment === $fragment) { + return $this; + } + + $new = clone $this; + $new->fragment = $fragment; + + return $new; + } + + /** + * Apply parse_url parts to a URI. + * + * @param array $parts Array of parse_url parts to apply. + */ + private function applyParts(array $parts) + { + $this->scheme = isset($parts['scheme']) + ? $this->filterScheme($parts['scheme']) + : ''; + $this->userInfo = isset($parts['user']) ? $parts['user'] : ''; + $this->host = isset($parts['host']) + ? $this->filterHost($parts['host']) + : ''; + $this->port = isset($parts['port']) + ? $this->filterPort($parts['port']) + : null; + $this->path = isset($parts['path']) + ? $this->filterPath($parts['path']) + : ''; + $this->query = isset($parts['query']) + ? $this->filterQueryAndFragment($parts['query']) + : ''; + $this->fragment = isset($parts['fragment']) + ? $this->filterQueryAndFragment($parts['fragment']) + : ''; + if (isset($parts['pass'])) { + $this->userInfo .= ':' . $parts['pass']; + } + + $this->removeDefaultPort(); + } + + /** + * @param string $scheme + * + * @return string + * + * @throws \InvalidArgumentException If the scheme is invalid. + */ + private function filterScheme($scheme) + { + if (!is_string($scheme)) { + throw new \InvalidArgumentException('Scheme must be a string'); + } + + return strtolower($scheme); + } + + /** + * @param string $host + * + * @return string + * + * @throws \InvalidArgumentException If the host is invalid. + */ + private function filterHost($host) + { + if (!is_string($host)) { + throw new \InvalidArgumentException('Host must be a string'); + } + + return strtolower($host); + } + + /** + * @param int|null $port + * + * @return int|null + * + * @throws \InvalidArgumentException If the port is invalid. + */ + private function filterPort($port) + { + if ($port === null) { + return null; + } + + $port = (int) $port; + if (1 > $port || 0xffff < $port) { + throw new \InvalidArgumentException( + sprintf('Invalid port: %d. Must be between 1 and 65535', $port) + ); + } + + return $port; + } + + private function removeDefaultPort() + { + if ($this->port !== null && self::isDefaultPort($this)) { + $this->port = null; + } + } + + /** + * Filters the path of a URI + * + * @param string $path + * + * @return string + * + * @throws \InvalidArgumentException If the path is invalid. + */ + private function filterPath($path) + { + if (!is_string($path)) { + throw new \InvalidArgumentException('Path must be a string'); + } + + return preg_replace_callback( + '/(?:[^' . self::$charUnreserved . self::$charSubDelims . '%:@\/]++|%(?![A-Fa-f0-9]{2}))/', + [$this, 'rawurlencodeMatchZero'], + $path + ); + } + + /** + * Filters the query string or fragment of a URI. + * + * @param string $str + * + * @return string + * + * @throws \InvalidArgumentException If the query or fragment is invalid. + */ + private function filterQueryAndFragment($str) + { + if (!is_string($str)) { + throw new \InvalidArgumentException('Query and fragment must be a string'); + } + + return preg_replace_callback( + '/(?:[^' . self::$charUnreserved . self::$charSubDelims . '%:@\/\?]++|%(?![A-Fa-f0-9]{2}))/', + [$this, 'rawurlencodeMatchZero'], + $str + ); + } + + private function rawurlencodeMatchZero(array $match) + { + return rawurlencode($match[0]); + } + + private function validateState() + { + if ($this->host === '' && ($this->scheme === 'http' || $this->scheme === 'https')) { + $this->host = self::HTTP_DEFAULT_HOST; + } + + if ($this->getAuthority() === '') { + if (0 === strpos($this->path, '//')) { + throw new \InvalidArgumentException('The path of a URI without an authority must not start with two slashes "//"'); + } + if ($this->scheme === '' && false !== strpos(explode('/', $this->path, 2)[0], ':')) { + throw new \InvalidArgumentException('A relative URI must not have a path beginning with a segment containing a colon'); + } + } elseif (isset($this->path[0]) && $this->path[0] !== '/') { + @trigger_error( + 'The path of a URI with an authority must start with a slash "/" or be empty. Automagically fixing the URI ' . + 'by adding a leading slash to the path is deprecated since version 1.4 and will throw an exception instead.', + E_USER_DEPRECATED + ); + $this->path = '/'. $this->path; + //throw new \InvalidArgumentException('The path of a URI with an authority must start with a slash "/" or be empty'); + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UriNormalizer.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UriNormalizer.php new file mode 100644 index 0000000..384c29e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UriNormalizer.php @@ -0,0 +1,216 @@ +getPath() === '' && + ($uri->getScheme() === 'http' || $uri->getScheme() === 'https') + ) { + $uri = $uri->withPath('/'); + } + + if ($flags & self::REMOVE_DEFAULT_HOST && $uri->getScheme() === 'file' && $uri->getHost() === 'localhost') { + $uri = $uri->withHost(''); + } + + if ($flags & self::REMOVE_DEFAULT_PORT && $uri->getPort() !== null && Uri::isDefaultPort($uri)) { + $uri = $uri->withPort(null); + } + + if ($flags & self::REMOVE_DOT_SEGMENTS && !Uri::isRelativePathReference($uri)) { + $uri = $uri->withPath(UriResolver::removeDotSegments($uri->getPath())); + } + + if ($flags & self::REMOVE_DUPLICATE_SLASHES) { + $uri = $uri->withPath(preg_replace('#//++#', '/', $uri->getPath())); + } + + if ($flags & self::SORT_QUERY_PARAMETERS && $uri->getQuery() !== '') { + $queryKeyValues = explode('&', $uri->getQuery()); + sort($queryKeyValues); + $uri = $uri->withQuery(implode('&', $queryKeyValues)); + } + + return $uri; + } + + /** + * Whether two URIs can be considered equivalent. + * + * Both URIs are normalized automatically before comparison with the given $normalizations bitmask. The method also + * accepts relative URI references and returns true when they are equivalent. This of course assumes they will be + * resolved against the same base URI. If this is not the case, determination of equivalence or difference of + * relative references does not mean anything. + * + * @param UriInterface $uri1 An URI to compare + * @param UriInterface $uri2 An URI to compare + * @param int $normalizations A bitmask of normalizations to apply, see constants + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-6.1 + */ + public static function isEquivalent(UriInterface $uri1, UriInterface $uri2, $normalizations = self::PRESERVING_NORMALIZATIONS) + { + return (string) self::normalize($uri1, $normalizations) === (string) self::normalize($uri2, $normalizations); + } + + private static function capitalizePercentEncoding(UriInterface $uri) + { + $regex = '/(?:%[A-Fa-f0-9]{2})++/'; + + $callback = function (array $match) { + return strtoupper($match[0]); + }; + + return + $uri->withPath( + preg_replace_callback($regex, $callback, $uri->getPath()) + )->withQuery( + preg_replace_callback($regex, $callback, $uri->getQuery()) + ); + } + + private static function decodeUnreservedCharacters(UriInterface $uri) + { + $regex = '/%(?:2D|2E|5F|7E|3[0-9]|[46][1-9A-F]|[57][0-9A])/i'; + + $callback = function (array $match) { + return rawurldecode($match[0]); + }; + + return + $uri->withPath( + preg_replace_callback($regex, $callback, $uri->getPath()) + )->withQuery( + preg_replace_callback($regex, $callback, $uri->getQuery()) + ); + } + + private function __construct() + { + // cannot be instantiated + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UriResolver.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UriResolver.php new file mode 100644 index 0000000..c1cb8a2 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/UriResolver.php @@ -0,0 +1,219 @@ +getScheme() != '') { + return $rel->withPath(self::removeDotSegments($rel->getPath())); + } + + if ($rel->getAuthority() != '') { + $targetAuthority = $rel->getAuthority(); + $targetPath = self::removeDotSegments($rel->getPath()); + $targetQuery = $rel->getQuery(); + } else { + $targetAuthority = $base->getAuthority(); + if ($rel->getPath() === '') { + $targetPath = $base->getPath(); + $targetQuery = $rel->getQuery() != '' ? $rel->getQuery() : $base->getQuery(); + } else { + if ($rel->getPath()[0] === '/') { + $targetPath = $rel->getPath(); + } else { + if ($targetAuthority != '' && $base->getPath() === '') { + $targetPath = '/' . $rel->getPath(); + } else { + $lastSlashPos = strrpos($base->getPath(), '/'); + if ($lastSlashPos === false) { + $targetPath = $rel->getPath(); + } else { + $targetPath = substr($base->getPath(), 0, $lastSlashPos + 1) . $rel->getPath(); + } + } + } + $targetPath = self::removeDotSegments($targetPath); + $targetQuery = $rel->getQuery(); + } + } + + return new Uri(Uri::composeComponents( + $base->getScheme(), + $targetAuthority, + $targetPath, + $targetQuery, + $rel->getFragment() + )); + } + + /** + * Returns the target URI as a relative reference from the base URI. + * + * This method is the counterpart to resolve(): + * + * (string) $target === (string) UriResolver::resolve($base, UriResolver::relativize($base, $target)) + * + * One use-case is to use the current request URI as base URI and then generate relative links in your documents + * to reduce the document size or offer self-contained downloadable document archives. + * + * $base = new Uri('http://example.com/a/b/'); + * echo UriResolver::relativize($base, new Uri('http://example.com/a/b/c')); // prints 'c'. + * echo UriResolver::relativize($base, new Uri('http://example.com/a/x/y')); // prints '../x/y'. + * echo UriResolver::relativize($base, new Uri('http://example.com/a/b/?q')); // prints '?q'. + * echo UriResolver::relativize($base, new Uri('http://example.org/a/b/')); // prints '//example.org/a/b/'. + * + * This method also accepts a target that is already relative and will try to relativize it further. Only a + * relative-path reference will be returned as-is. + * + * echo UriResolver::relativize($base, new Uri('/a/b/c')); // prints 'c' as well + * + * @param UriInterface $base Base URI + * @param UriInterface $target Target URI + * + * @return UriInterface The relative URI reference + */ + public static function relativize(UriInterface $base, UriInterface $target) + { + if ($target->getScheme() !== '' && + ($base->getScheme() !== $target->getScheme() || $target->getAuthority() === '' && $base->getAuthority() !== '') + ) { + return $target; + } + + if (Uri::isRelativePathReference($target)) { + // As the target is already highly relative we return it as-is. It would be possible to resolve + // the target with `$target = self::resolve($base, $target);` and then try make it more relative + // by removing a duplicate query. But let's not do that automatically. + return $target; + } + + if ($target->getAuthority() !== '' && $base->getAuthority() !== $target->getAuthority()) { + return $target->withScheme(''); + } + + // We must remove the path before removing the authority because if the path starts with two slashes, the URI + // would turn invalid. And we also cannot set a relative path before removing the authority, as that is also + // invalid. + $emptyPathUri = $target->withScheme('')->withPath('')->withUserInfo('')->withPort(null)->withHost(''); + + if ($base->getPath() !== $target->getPath()) { + return $emptyPathUri->withPath(self::getRelativePath($base, $target)); + } + + if ($base->getQuery() === $target->getQuery()) { + // Only the target fragment is left. And it must be returned even if base and target fragment are the same. + return $emptyPathUri->withQuery(''); + } + + // If the base URI has a query but the target has none, we cannot return an empty path reference as it would + // inherit the base query component when resolving. + if ($target->getQuery() === '') { + $segments = explode('/', $target->getPath()); + $lastSegment = end($segments); + + return $emptyPathUri->withPath($lastSegment === '' ? './' : $lastSegment); + } + + return $emptyPathUri; + } + + private static function getRelativePath(UriInterface $base, UriInterface $target) + { + $sourceSegments = explode('/', $base->getPath()); + $targetSegments = explode('/', $target->getPath()); + array_pop($sourceSegments); + $targetLastSegment = array_pop($targetSegments); + foreach ($sourceSegments as $i => $segment) { + if (isset($targetSegments[$i]) && $segment === $targetSegments[$i]) { + unset($sourceSegments[$i], $targetSegments[$i]); + } else { + break; + } + } + $targetSegments[] = $targetLastSegment; + $relativePath = str_repeat('../', count($sourceSegments)) . implode('/', $targetSegments); + + // A reference to am empty last segment or an empty first sub-segment must be prefixed with "./". + // This also applies to a segment with a colon character (e.g., "file:colon") that cannot be used + // as the first segment of a relative-path reference, as it would be mistaken for a scheme name. + if ('' === $relativePath || false !== strpos(explode('/', $relativePath, 2)[0], ':')) { + $relativePath = "./$relativePath"; + } elseif ('/' === $relativePath[0]) { + if ($base->getAuthority() != '' && $base->getPath() === '') { + // In this case an extra slash is added by resolve() automatically. So we must not add one here. + $relativePath = ".$relativePath"; + } else { + $relativePath = "./$relativePath"; + } + } + + return $relativePath; + } + + private function __construct() + { + // cannot be instantiated + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/functions.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/functions.php new file mode 100644 index 0000000..e40348d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/functions.php @@ -0,0 +1,828 @@ +getMethod() . ' ' + . $message->getRequestTarget()) + . ' HTTP/' . $message->getProtocolVersion(); + if (!$message->hasHeader('host')) { + $msg .= "\r\nHost: " . $message->getUri()->getHost(); + } + } elseif ($message instanceof ResponseInterface) { + $msg = 'HTTP/' . $message->getProtocolVersion() . ' ' + . $message->getStatusCode() . ' ' + . $message->getReasonPhrase(); + } else { + throw new \InvalidArgumentException('Unknown message type'); + } + + foreach ($message->getHeaders() as $name => $values) { + $msg .= "\r\n{$name}: " . implode(', ', $values); + } + + return "{$msg}\r\n\r\n" . $message->getBody(); +} + +/** + * Returns a UriInterface for the given value. + * + * This function accepts a string or {@see Psr\Http\Message\UriInterface} and + * returns a UriInterface for the given value. If the value is already a + * `UriInterface`, it is returned as-is. + * + * @param string|UriInterface $uri + * + * @return UriInterface + * @throws \InvalidArgumentException + */ +function uri_for($uri) +{ + if ($uri instanceof UriInterface) { + return $uri; + } elseif (is_string($uri)) { + return new Uri($uri); + } + + throw new \InvalidArgumentException('URI must be a string or UriInterface'); +} + +/** + * Create a new stream based on the input type. + * + * Options is an associative array that can contain the following keys: + * - metadata: Array of custom metadata. + * - size: Size of the stream. + * + * @param resource|string|null|int|float|bool|StreamInterface|callable $resource Entity body data + * @param array $options Additional options + * + * @return Stream + * @throws \InvalidArgumentException if the $resource arg is not valid. + */ +function stream_for($resource = '', array $options = []) +{ + if (is_scalar($resource)) { + $stream = fopen('php://temp', 'r+'); + if ($resource !== '') { + fwrite($stream, $resource); + fseek($stream, 0); + } + return new Stream($stream, $options); + } + + switch (gettype($resource)) { + case 'resource': + return new Stream($resource, $options); + case 'object': + if ($resource instanceof StreamInterface) { + return $resource; + } elseif ($resource instanceof \Iterator) { + return new PumpStream(function () use ($resource) { + if (!$resource->valid()) { + return false; + } + $result = $resource->current(); + $resource->next(); + return $result; + }, $options); + } elseif (method_exists($resource, '__toString')) { + return stream_for((string) $resource, $options); + } + break; + case 'NULL': + return new Stream(fopen('php://temp', 'r+'), $options); + } + + if (is_callable($resource)) { + return new PumpStream($resource, $options); + } + + throw new \InvalidArgumentException('Invalid resource type: ' . gettype($resource)); +} + +/** + * Parse an array of header values containing ";" separated data into an + * array of associative arrays representing the header key value pair + * data of the header. When a parameter does not contain a value, but just + * contains a key, this function will inject a key with a '' string value. + * + * @param string|array $header Header to parse into components. + * + * @return array Returns the parsed header values. + */ +function parse_header($header) +{ + static $trimmed = "\"' \n\t\r"; + $params = $matches = []; + + foreach (normalize_header($header) as $val) { + $part = []; + foreach (preg_split('/;(?=([^"]*"[^"]*")*[^"]*$)/', $val) as $kvp) { + if (preg_match_all('/<[^>]+>|[^=]+/', $kvp, $matches)) { + $m = $matches[0]; + if (isset($m[1])) { + $part[trim($m[0], $trimmed)] = trim($m[1], $trimmed); + } else { + $part[] = trim($m[0], $trimmed); + } + } + } + if ($part) { + $params[] = $part; + } + } + + return $params; +} + +/** + * Converts an array of header values that may contain comma separated + * headers into an array of headers with no comma separated values. + * + * @param string|array $header Header to normalize. + * + * @return array Returns the normalized header field values. + */ +function normalize_header($header) +{ + if (!is_array($header)) { + return array_map('trim', explode(',', $header)); + } + + $result = []; + foreach ($header as $value) { + foreach ((array) $value as $v) { + if (strpos($v, ',') === false) { + $result[] = $v; + continue; + } + foreach (preg_split('/,(?=([^"]*"[^"]*")*[^"]*$)/', $v) as $vv) { + $result[] = trim($vv); + } + } + } + + return $result; +} + +/** + * Clone and modify a request with the given changes. + * + * The changes can be one of: + * - method: (string) Changes the HTTP method. + * - set_headers: (array) Sets the given headers. + * - remove_headers: (array) Remove the given headers. + * - body: (mixed) Sets the given body. + * - uri: (UriInterface) Set the URI. + * - query: (string) Set the query string value of the URI. + * - version: (string) Set the protocol version. + * + * @param RequestInterface $request Request to clone and modify. + * @param array $changes Changes to apply. + * + * @return RequestInterface + */ +function modify_request(RequestInterface $request, array $changes) +{ + if (!$changes) { + return $request; + } + + $headers = $request->getHeaders(); + + if (!isset($changes['uri'])) { + $uri = $request->getUri(); + } else { + // Remove the host header if one is on the URI + if ($host = $changes['uri']->getHost()) { + $changes['set_headers']['Host'] = $host; + + if ($port = $changes['uri']->getPort()) { + $standardPorts = ['http' => 80, 'https' => 443]; + $scheme = $changes['uri']->getScheme(); + if (isset($standardPorts[$scheme]) && $port != $standardPorts[$scheme]) { + $changes['set_headers']['Host'] .= ':'.$port; + } + } + } + $uri = $changes['uri']; + } + + if (!empty($changes['remove_headers'])) { + $headers = _caseless_remove($changes['remove_headers'], $headers); + } + + if (!empty($changes['set_headers'])) { + $headers = _caseless_remove(array_keys($changes['set_headers']), $headers); + $headers = $changes['set_headers'] + $headers; + } + + if (isset($changes['query'])) { + $uri = $uri->withQuery($changes['query']); + } + + if ($request instanceof ServerRequestInterface) { + return new ServerRequest( + isset($changes['method']) ? $changes['method'] : $request->getMethod(), + $uri, + $headers, + isset($changes['body']) ? $changes['body'] : $request->getBody(), + isset($changes['version']) + ? $changes['version'] + : $request->getProtocolVersion(), + $request->getServerParams() + ); + } + + return new Request( + isset($changes['method']) ? $changes['method'] : $request->getMethod(), + $uri, + $headers, + isset($changes['body']) ? $changes['body'] : $request->getBody(), + isset($changes['version']) + ? $changes['version'] + : $request->getProtocolVersion() + ); +} + +/** + * Attempts to rewind a message body and throws an exception on failure. + * + * The body of the message will only be rewound if a call to `tell()` returns a + * value other than `0`. + * + * @param MessageInterface $message Message to rewind + * + * @throws \RuntimeException + */ +function rewind_body(MessageInterface $message) +{ + $body = $message->getBody(); + + if ($body->tell()) { + $body->rewind(); + } +} + +/** + * Safely opens a PHP stream resource using a filename. + * + * When fopen fails, PHP normally raises a warning. This function adds an + * error handler that checks for errors and throws an exception instead. + * + * @param string $filename File to open + * @param string $mode Mode used to open the file + * + * @return resource + * @throws \RuntimeException if the file cannot be opened + */ +function try_fopen($filename, $mode) +{ + $ex = null; + set_error_handler(function () use ($filename, $mode, &$ex) { + $ex = new \RuntimeException(sprintf( + 'Unable to open %s using mode %s: %s', + $filename, + $mode, + func_get_args()[1] + )); + }); + + $handle = fopen($filename, $mode); + restore_error_handler(); + + if ($ex) { + /** @var $ex \RuntimeException */ + throw $ex; + } + + return $handle; +} + +/** + * Copy the contents of a stream into a string until the given number of + * bytes have been read. + * + * @param StreamInterface $stream Stream to read + * @param int $maxLen Maximum number of bytes to read. Pass -1 + * to read the entire stream. + * @return string + * @throws \RuntimeException on error. + */ +function copy_to_string(StreamInterface $stream, $maxLen = -1) +{ + $buffer = ''; + + if ($maxLen === -1) { + while (!$stream->eof()) { + $buf = $stream->read(1048576); + // Using a loose equality here to match on '' and false. + if ($buf == null) { + break; + } + $buffer .= $buf; + } + return $buffer; + } + + $len = 0; + while (!$stream->eof() && $len < $maxLen) { + $buf = $stream->read($maxLen - $len); + // Using a loose equality here to match on '' and false. + if ($buf == null) { + break; + } + $buffer .= $buf; + $len = strlen($buffer); + } + + return $buffer; +} + +/** + * Copy the contents of a stream into another stream until the given number + * of bytes have been read. + * + * @param StreamInterface $source Stream to read from + * @param StreamInterface $dest Stream to write to + * @param int $maxLen Maximum number of bytes to read. Pass -1 + * to read the entire stream. + * + * @throws \RuntimeException on error. + */ +function copy_to_stream( + StreamInterface $source, + StreamInterface $dest, + $maxLen = -1 +) { + $bufferSize = 8192; + + if ($maxLen === -1) { + while (!$source->eof()) { + if (!$dest->write($source->read($bufferSize))) { + break; + } + } + } else { + $remaining = $maxLen; + while ($remaining > 0 && !$source->eof()) { + $buf = $source->read(min($bufferSize, $remaining)); + $len = strlen($buf); + if (!$len) { + break; + } + $remaining -= $len; + $dest->write($buf); + } + } +} + +/** + * Calculate a hash of a Stream + * + * @param StreamInterface $stream Stream to calculate the hash for + * @param string $algo Hash algorithm (e.g. md5, crc32, etc) + * @param bool $rawOutput Whether or not to use raw output + * + * @return string Returns the hash of the stream + * @throws \RuntimeException on error. + */ +function hash( + StreamInterface $stream, + $algo, + $rawOutput = false +) { + $pos = $stream->tell(); + + if ($pos > 0) { + $stream->rewind(); + } + + $ctx = hash_init($algo); + while (!$stream->eof()) { + hash_update($ctx, $stream->read(1048576)); + } + + $out = hash_final($ctx, (bool) $rawOutput); + $stream->seek($pos); + + return $out; +} + +/** + * Read a line from the stream up to the maximum allowed buffer length + * + * @param StreamInterface $stream Stream to read from + * @param int $maxLength Maximum buffer length + * + * @return string|bool + */ +function readline(StreamInterface $stream, $maxLength = null) +{ + $buffer = ''; + $size = 0; + + while (!$stream->eof()) { + // Using a loose equality here to match on '' and false. + if (null == ($byte = $stream->read(1))) { + return $buffer; + } + $buffer .= $byte; + // Break when a new line is found or the max length - 1 is reached + if ($byte === "\n" || ++$size === $maxLength - 1) { + break; + } + } + + return $buffer; +} + +/** + * Parses a request message string into a request object. + * + * @param string $message Request message string. + * + * @return Request + */ +function parse_request($message) +{ + $data = _parse_message($message); + $matches = []; + if (!preg_match('/^[\S]+\s+([a-zA-Z]+:\/\/|\/).*/', $data['start-line'], $matches)) { + throw new \InvalidArgumentException('Invalid request string'); + } + $parts = explode(' ', $data['start-line'], 3); + $version = isset($parts[2]) ? explode('/', $parts[2])[1] : '1.1'; + + $request = new Request( + $parts[0], + $matches[1] === '/' ? _parse_request_uri($parts[1], $data['headers']) : $parts[1], + $data['headers'], + $data['body'], + $version + ); + + return $matches[1] === '/' ? $request : $request->withRequestTarget($parts[1]); +} + +/** + * Parses a response message string into a response object. + * + * @param string $message Response message string. + * + * @return Response + */ +function parse_response($message) +{ + $data = _parse_message($message); + // According to https://tools.ietf.org/html/rfc7230#section-3.1.2 the space + // between status-code and reason-phrase is required. But browsers accept + // responses without space and reason as well. + if (!preg_match('/^HTTP\/.* [0-9]{3}( .*|$)/', $data['start-line'])) { + throw new \InvalidArgumentException('Invalid response string'); + } + $parts = explode(' ', $data['start-line'], 3); + + return new Response( + $parts[1], + $data['headers'], + $data['body'], + explode('/', $parts[0])[1], + isset($parts[2]) ? $parts[2] : null + ); +} + +/** + * Parse a query string into an associative array. + * + * If multiple values are found for the same key, the value of that key + * value pair will become an array. This function does not parse nested + * PHP style arrays into an associative array (e.g., foo[a]=1&foo[b]=2 will + * be parsed into ['foo[a]' => '1', 'foo[b]' => '2']). + * + * @param string $str Query string to parse + * @param bool|string $urlEncoding How the query string is encoded + * + * @return array + */ +function parse_query($str, $urlEncoding = true) +{ + $result = []; + + if ($str === '') { + return $result; + } + + if ($urlEncoding === true) { + $decoder = function ($value) { + return rawurldecode(str_replace('+', ' ', $value)); + }; + } elseif ($urlEncoding == PHP_QUERY_RFC3986) { + $decoder = 'rawurldecode'; + } elseif ($urlEncoding == PHP_QUERY_RFC1738) { + $decoder = 'urldecode'; + } else { + $decoder = function ($str) { return $str; }; + } + + foreach (explode('&', $str) as $kvp) { + $parts = explode('=', $kvp, 2); + $key = $decoder($parts[0]); + $value = isset($parts[1]) ? $decoder($parts[1]) : null; + if (!isset($result[$key])) { + $result[$key] = $value; + } else { + if (!is_array($result[$key])) { + $result[$key] = [$result[$key]]; + } + $result[$key][] = $value; + } + } + + return $result; +} + +/** + * Build a query string from an array of key value pairs. + * + * This function can use the return value of parse_query() to build a query + * string. This function does not modify the provided keys when an array is + * encountered (like http_build_query would). + * + * @param array $params Query string parameters. + * @param int|false $encoding Set to false to not encode, PHP_QUERY_RFC3986 + * to encode using RFC3986, or PHP_QUERY_RFC1738 + * to encode using RFC1738. + * @return string + */ +function build_query(array $params, $encoding = PHP_QUERY_RFC3986) +{ + if (!$params) { + return ''; + } + + if ($encoding === false) { + $encoder = function ($str) { return $str; }; + } elseif ($encoding === PHP_QUERY_RFC3986) { + $encoder = 'rawurlencode'; + } elseif ($encoding === PHP_QUERY_RFC1738) { + $encoder = 'urlencode'; + } else { + throw new \InvalidArgumentException('Invalid type'); + } + + $qs = ''; + foreach ($params as $k => $v) { + $k = $encoder($k); + if (!is_array($v)) { + $qs .= $k; + if ($v !== null) { + $qs .= '=' . $encoder($v); + } + $qs .= '&'; + } else { + foreach ($v as $vv) { + $qs .= $k; + if ($vv !== null) { + $qs .= '=' . $encoder($vv); + } + $qs .= '&'; + } + } + } + + return $qs ? (string) substr($qs, 0, -1) : ''; +} + +/** + * Determines the mimetype of a file by looking at its extension. + * + * @param $filename + * + * @return null|string + */ +function mimetype_from_filename($filename) +{ + return mimetype_from_extension(pathinfo($filename, PATHINFO_EXTENSION)); +} + +/** + * Maps a file extensions to a mimetype. + * + * @param $extension string The file extension. + * + * @return string|null + * @link http://svn.apache.org/repos/asf/httpd/httpd/branches/1.3.x/conf/mime.types + */ +function mimetype_from_extension($extension) +{ + static $mimetypes = [ + '7z' => 'application/x-7z-compressed', + 'aac' => 'audio/x-aac', + 'ai' => 'application/postscript', + 'aif' => 'audio/x-aiff', + 'asc' => 'text/plain', + 'asf' => 'video/x-ms-asf', + 'atom' => 'application/atom+xml', + 'avi' => 'video/x-msvideo', + 'bmp' => 'image/bmp', + 'bz2' => 'application/x-bzip2', + 'cer' => 'application/pkix-cert', + 'crl' => 'application/pkix-crl', + 'crt' => 'application/x-x509-ca-cert', + 'css' => 'text/css', + 'csv' => 'text/csv', + 'cu' => 'application/cu-seeme', + 'deb' => 'application/x-debian-package', + 'doc' => 'application/msword', + 'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', + 'dvi' => 'application/x-dvi', + 'eot' => 'application/vnd.ms-fontobject', + 'eps' => 'application/postscript', + 'epub' => 'application/epub+zip', + 'etx' => 'text/x-setext', + 'flac' => 'audio/flac', + 'flv' => 'video/x-flv', + 'gif' => 'image/gif', + 'gz' => 'application/gzip', + 'htm' => 'text/html', + 'html' => 'text/html', + 'ico' => 'image/x-icon', + 'ics' => 'text/calendar', + 'ini' => 'text/plain', + 'iso' => 'application/x-iso9660-image', + 'jar' => 'application/java-archive', + 'jpe' => 'image/jpeg', + 'jpeg' => 'image/jpeg', + 'jpg' => 'image/jpeg', + 'js' => 'text/javascript', + 'json' => 'application/json', + 'latex' => 'application/x-latex', + 'log' => 'text/plain', + 'm4a' => 'audio/mp4', + 'm4v' => 'video/mp4', + 'mid' => 'audio/midi', + 'midi' => 'audio/midi', + 'mov' => 'video/quicktime', + 'mp3' => 'audio/mpeg', + 'mp4' => 'video/mp4', + 'mp4a' => 'audio/mp4', + 'mp4v' => 'video/mp4', + 'mpe' => 'video/mpeg', + 'mpeg' => 'video/mpeg', + 'mpg' => 'video/mpeg', + 'mpg4' => 'video/mp4', + 'oga' => 'audio/ogg', + 'ogg' => 'audio/ogg', + 'ogv' => 'video/ogg', + 'ogx' => 'application/ogg', + 'pbm' => 'image/x-portable-bitmap', + 'pdf' => 'application/pdf', + 'pgm' => 'image/x-portable-graymap', + 'png' => 'image/png', + 'pnm' => 'image/x-portable-anymap', + 'ppm' => 'image/x-portable-pixmap', + 'ppt' => 'application/vnd.ms-powerpoint', + 'pptx' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation', + 'ps' => 'application/postscript', + 'qt' => 'video/quicktime', + 'rar' => 'application/x-rar-compressed', + 'ras' => 'image/x-cmu-raster', + 'rss' => 'application/rss+xml', + 'rtf' => 'application/rtf', + 'sgm' => 'text/sgml', + 'sgml' => 'text/sgml', + 'svg' => 'image/svg+xml', + 'swf' => 'application/x-shockwave-flash', + 'tar' => 'application/x-tar', + 'tif' => 'image/tiff', + 'tiff' => 'image/tiff', + 'torrent' => 'application/x-bittorrent', + 'ttf' => 'application/x-font-ttf', + 'txt' => 'text/plain', + 'wav' => 'audio/x-wav', + 'webm' => 'video/webm', + 'wma' => 'audio/x-ms-wma', + 'wmv' => 'video/x-ms-wmv', + 'woff' => 'application/x-font-woff', + 'wsdl' => 'application/wsdl+xml', + 'xbm' => 'image/x-xbitmap', + 'xls' => 'application/vnd.ms-excel', + 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', + 'xml' => 'application/xml', + 'xpm' => 'image/x-xpixmap', + 'xwd' => 'image/x-xwindowdump', + 'yaml' => 'text/yaml', + 'yml' => 'text/yaml', + 'zip' => 'application/zip', + ]; + + $extension = strtolower($extension); + + return isset($mimetypes[$extension]) + ? $mimetypes[$extension] + : null; +} + +/** + * Parses an HTTP message into an associative array. + * + * The array contains the "start-line" key containing the start line of + * the message, "headers" key containing an associative array of header + * array values, and a "body" key containing the body of the message. + * + * @param string $message HTTP request or response to parse. + * + * @return array + * @internal + */ +function _parse_message($message) +{ + if (!$message) { + throw new \InvalidArgumentException('Invalid message'); + } + + // Iterate over each line in the message, accounting for line endings + $lines = preg_split('/(\\r?\\n)/', $message, -1, PREG_SPLIT_DELIM_CAPTURE); + $result = ['start-line' => array_shift($lines), 'headers' => [], 'body' => '']; + array_shift($lines); + + for ($i = 0, $totalLines = count($lines); $i < $totalLines; $i += 2) { + $line = $lines[$i]; + // If two line breaks were encountered, then this is the end of body + if (empty($line)) { + if ($i < $totalLines - 1) { + $result['body'] = implode('', array_slice($lines, $i + 2)); + } + break; + } + if (strpos($line, ':')) { + $parts = explode(':', $line, 2); + $key = trim($parts[0]); + $value = isset($parts[1]) ? trim($parts[1]) : ''; + $result['headers'][$key][] = $value; + } + } + + return $result; +} + +/** + * Constructs a URI for an HTTP request message. + * + * @param string $path Path from the start-line + * @param array $headers Array of headers (each value an array). + * + * @return string + * @internal + */ +function _parse_request_uri($path, array $headers) +{ + $hostKey = array_filter(array_keys($headers), function ($k) { + return strtolower($k) === 'host'; + }); + + // If no host is found, then a full URI cannot be constructed. + if (!$hostKey) { + return $path; + } + + $host = $headers[reset($hostKey)][0]; + $scheme = substr($host, -4) === ':443' ? 'https' : 'http'; + + return $scheme . '://' . $host . '/' . ltrim($path, '/'); +} + +/** @internal */ +function _caseless_remove($keys, array $data) +{ + $result = []; + + foreach ($keys as &$key) { + $key = strtolower($key); + } + + foreach ($data as $k => $v) { + if (!in_array(strtolower($k), $keys)) { + $result[$k] = $v; + } + } + + return $result; +} diff --git a/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/functions_include.php b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/functions_include.php new file mode 100644 index 0000000..96a4a83 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/guzzlehttp/psr7/src/functions_include.php @@ -0,0 +1,6 @@ +messages()->sendMime()` + +## 2.2.0 + +This version contains a new way of using the API. Each endpoint return a domain object and the +endpoints are grouped like the API documentation. + +### Added + +- Api classes in Mailgun\Api\* +- Api models/responses in Mailgun\Model\* +- Added Hydrators to hydrate PSR-7 responses to arrays or domain objects. +- All exceptions extend `Mailgun\Exception`. +- New exceptions in `Mailgun\Exception` namespace. +- Added `HttpClientConfigurator` to configure the HTTP client. +- Added HttpClient plugins `History` and `ReplaceUriPlugin` +- Assertions with Webmozart\Assert +- `Mailgun\Mailgun::getLastResponse()` +- `Mailgun\Connection\RestClient::getAttachment($url)` +- Clear license information + +### Fixed + +- Fix disordered POST parameters. We do not use array syntax. +- Code styles + +### Deprecated + +The following classes will be removed in version 3.0. + +- `Mailgun\Connection\Exceptions\GenericHTTPError` +- `Mailgun\Connection\Exceptions\InvalidCredentials` +- `Mailgun\Connection\Exceptions\MissingEndpoint` +- `Mailgun\Connection\Exceptions\MissingRequiredParameters` +- `Mailgun\Connection\Exceptions\NoDomainsConfigured` +- `Mailgun\Connection\RestClient` +- `Mailgun\Constants\Api` +- `Mailgun\Constants\ExceptionMessages` +- `Mailgun\Mailgun::$resetClient` +- `Mailgun\Mailgun::sendMessage()` +- `Mailgun\Mailgun::verifyWebhookSignature()` +- `Mailgun\Mailgun::post()` +- `Mailgun\Mailgun::get()` +- `Mailgun\Mailgun::delete()` +- `Mailgun\Mailgun::put()` +- `Mailgun\Mailgun::setApiVersion()` +- `Mailgun\Mailgun::setSslEnabled()` +- `Mailgun\Mailgun::MessageBuilder()` +- `Mailgun\Mailgun::OptInHandler()` +- `Mailgun\Mailgun::BatchMessage()` + +## 2.1.2 + +- Bug fixes with multiple recipients, inline images and attachments. +- Added more tests +- Using PSR-2 code style + +## 2.1.1 + +- Require php-http/message (#142) +- Declare BatchMessage::endpointUrl (#112) + +## 2.1.0 + +- Strict comparison of hash (#117) +- No dependency on Guzzle/PSR7 (#139) +- Build URL string form an array (#138) +- Docblock update (#134) +- Minor fixes (#90, #121, #98) + +## 2.0 + +- Migrated to PHP-HTTP (#94) +- Dropped support for PHP 5.4. + +## 1.8.0 + +- Updated to Guzzle5 (#79) +- Updated default API version from v2 to v3 (#75) +- Show response message on 400, 401 and 404. (#72) +- PHP DocBlocks, Constants Changes, and Minor Refactors (#66) +- Added PHP 7.0 support for Travis-CI, removed PHP 5.3 support (#79) + +## 1.7.2 + +- Added webhook signature verification - (#50) +- Test PHP 5.6 and HHVM - (#51) +- Improved error handling - (#48) +- Fixed attachment handling in Message Builder - (#56) +- Allow any data type in custom data - (#57) +- Return non-JSON response data - (#60) +- Removed legacy closing braces - (#64) + +## 1.7.1 + +- Improved security of OptInHandler - (#31) +- Fixed typo for including an Exception - (#41) +- Fixed Mocks, removed unnecessary code, applied styling - (#44 & #42) +- Less restrictive Guzzle requirement - (#45) + +## 1.7 (2014-1-30) + +Bugfixes: + - patched bug for attachments related to duplicate aggregator bug in Guzzle (#32 @travelton) + +## 1.6 (2014-1-13) + +Enhancement: + - adjust file attachment/inline name (#21 @travelton) + +Bugfixes: + - fixed issue with unordered route actions (#23 @travelton) + +## 1.5 (2013-12-13) + +Enhancement: + - added ability to define non-https endpoint for debugging purposes (#23 @travelton) + +## 1.4 (2013-10-16) + +Bugfixes: + - template IDs were missing from recipient-variables (#15 @travelton) + - batch jobs trigger on to, cc, and bcc (#18 @travelton) + - batch jobs include recipient-variables for to, cc, and bcc (#18 @travelton) + - added method to return message-ids, for easier access (#19 @travelton) + +## 1.3 (2013-09-12) + +Bugfixes: + + - relaxed Guzzle requirement (#7 @travelton) + - fixed reply-to bug (#9 @travelton) + +## 1.2 (2013-09-05) + +Bugfixes: + + - fixed exception handling constants (@travelton) + - fixed MessageBuilder $baseAddress return (#1 @yoye) + - adjusted scope of recipient-variables (#3 @yoye) + - fixed misspellings of Exceptions (#2 @dboggus) + - undefined DEFAULT_TIME_ZONE (#4 @yoye) + - added message IDs to return for BatchMessage (@travelton) + +## 1.1 (2013-08-21) + +Initial Release! diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/LICENSE b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/LICENSE new file mode 100644 index 0000000..89de354 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/LICENSE @@ -0,0 +1,17 @@ +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/README.md b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/README.md new file mode 100644 index 0000000..d5bd5ed --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/README.md @@ -0,0 +1,197 @@ +# Mailgun PHP client + +This is the Mailgun PHP SDK. This SDK contains methods for easily interacting +with the Mailgun API. +Below are examples to get you started. For additional examples, please see our +official documentation +at http://documentation.mailgun.com + +[![Latest Version](https://img.shields.io/github/release/mailgun/mailgun-php.svg?style=flat-square)](https://github.com/mailgun/mailgun-php/releases) +[![Build Status](https://img.shields.io/travis/mailgun/mailgun-php/master.svg?style=flat-square)](https://travis-ci.org/mailgun/mailgun-php) +[![StyleCI](https://styleci.io/repos/11654443/shield?branch=master)](https://styleci.io/repos/11654443) +[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/mailgun/mailgun-php.svg?style=flat-square)](https://scrutinizer-ci.com/g/mailgun/mailgun-php) +[![Quality Score](https://img.shields.io/scrutinizer/g/mailgun/mailgun-php.svg?style=flat-square)](https://scrutinizer-ci.com/g/mailgun/mailgun-php) +[![Total Downloads](https://img.shields.io/packagist/dt/mailgun/mailgun-php.svg?style=flat-square)](https://packagist.org/packages/mailgun/mailgun-php) +[![Join the chat at https://gitter.im/mailgun/mailgun-php](https://badges.gitter.im/mailgun/mailgun-php.svg)](https://gitter.im/mailgun/mailgun-php?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) + +**This is the documentation for dev-master. You find documentation for the latest stable +release [here](https://github.com/mailgun/mailgun-php/tree/v2.1.2).** + +## Installation + +To install the SDK, you will need to be using [Composer](http://getcomposer.org/) +in your project. +If you aren't using Composer yet, it's really simple! Here's how to install +composer: + +```bash +curl -sS https://getcomposer.org/installer | php +``` + +The Mailgun api client is not hard coupled to Guzzle or any other library that sends HTTP messages. It uses an abstraction +called HTTPlug. This will give you the flexibilty to choose what PSR-7 implementation and HTTP client to use. + +If you just want to get started quickly you should run the following command: + +```bash +php composer.phar require mailgun/mailgun-php php-http/curl-client guzzlehttp/psr7 +``` + +### Why requiring so many packages? + +Mailgun has a dependency on the virtual package +[php-http/client-implementation](https://packagist.org/providers/php-http/client-implementation) which requires to you install **an** adapter, but we do not care which one. That is an implementation detail in your application. We also need **a** PSR-7 implementation and **a** message factory. + +You do not have to use the `php-http/curl-client` if you do not want to. You may use the `php-http/guzzle6-adapter`. Read more about the virtual packages, why this is a good idea and about the flexibility it brings at the [HTTPlug docs](http://docs.php-http.org/en/latest/httplug/users.html). + +## Usage + +You should always use Composer's autoloader in your application to automatically load the your dependencies. All examples below assumes you've already included this in your file: + +```php +require 'vendor/autoload.php'; +use Mailgun\Mailgun; +``` + +Here's how to send a message using the SDK: + +```php +# First, instantiate the SDK with your API credentials +$mg = Mailgun::create('key-example'); + +# Now, compose and send your message. +$mg->messages()->send('example.com', [ + 'from' => 'bob@example.com', + 'to' => 'sally@example.com', + 'subject' => 'The PHP SDK is awesome!', + 'text' => 'It is so simple to send a message.' +]); +``` + +### All usage examples + +You find more detailed documentation at in [/doc](doc/index.md) and on +[https://documentation.mailgun.com](https://documentation.mailgun.com/api_reference.html). + +### Response + +The results of a API call is, by default, a domain object. This will make it easy +to understand the response without reading the documentation. One can just read the +doc blocks on the response classes. This provide an excellent IDE integration. + +```php +$mg = Mailgun::create('key-example'); +$dns = $mg->domains()->show('example.com')->getInboundDNSRecords(); + +foreach ($dns as $record) { + echo $record->getType(); +} +``` + +If you rather be working with array then object you can inject the `ArrayHydrator` +to the Mailgun class. + +```php +use Mailgun\Hydrator\ArrayHydrator; + +$configurator = new HttpClientConfigurator(); +$configurator->setApiKey('key-example'); + +$mg = Mailgun::configure($configurator, new ArrayHydrator()); +$data = $mg->domains()->show('example.com'); + +foreach ($data['receiving_dns_records'] as $record) { + echo isset($record['record_type']) ? $record['record_type'] : null; +} +``` + +You could also use the `NoopHydrator` to get a PSR7 Response returned from +the API calls. + +**Warning: When using `NoopHydrator` there will be no exceptions on a non-200 response.** + +### Debugging + +Debugging the PHP SDK can be really helpful when things aren't working quite right. +To debug the SDK, here are some suggestions: + +Set the endpoint to Mailgun's Postbin. A Postbin is a web service that allows you to +post data, which is then displayed through a browser. This allows you to quickly determine +what is actually being transmitted to Mailgun's API. + +**Step 1 - Create a new Postbin.** +Go to http://bin.mailgun.net. The Postbin will generate a special URL. Save that URL. + +**Step 2 - Instantiate the Mailgun client using Postbin.** + +*Tip: The bin id will be the URL part after bin.mailgun.net. It will be random generated letters and numbers. +For example, the bin id in this URL, http://bin.mailgun.net/aecf68de, is "aecf68de".* + +```php +$configurator = new HttpClientConfigurator(); +$configurator->setEndpoint('http://bin.mailgun.net/aecf68de'); +$configurator->setDebug(true); +$mg = Mailgun::configure($configurator); + +# Now, compose and send your message. +$mg->messages()->send('example.com', [ + 'from' => 'bob@example.com', + 'to' => 'sally@example.com', + 'subject' => 'The PHP SDK is awesome!', + 'text' => 'It is so simple to send a message.' +]); +``` +### Additional Info + +For usage examples on each API endpoint, head over to our official documentation +pages. + +This SDK includes a [Message Builder](src/Mailgun/Messages/README.md), +[Batch Message](src/Mailgun/Messages/README.md) and [Opt-In Handler](src/Mailgun/Lists/README.md) component. + +Message Builder allows you to quickly create the array of parameters, required +to send a message, by calling a methods for each parameter. +Batch Message is an extension of Message Builder, and allows you to easily send +a batch message job within a few seconds. The complexity of +batch messaging is eliminated! + +## Framework integration + +If you are using a framework you might consider these composer packages to make the framework integration easier. + +* [tehplague/swiftmailer-mailgun-bundle](https://github.com/tehplague/swiftmailer-mailgun-bundle) for Symfony +* [Bogardo/Mailgun](https://github.com/Bogardo/Mailgun) for Laravel +* [katanyoo/yii2-mailgun-mailer](https://github.com/katanyoo/yii2-mailgun-mailer) for Yii2 + +## Contribute + +We are currently building a new object oriented API client. Feel free to contribute in any way. As an example you may: +* Trying out dev-master the code +* Create issues if you find problems +* Reply to other people's issues +* Review PRs +* Write PR. You find our current milestone [here](https://github.com/mailgun/mailgun-php/milestone/1) + +### Running the test code + +If you want to run the tests you should run the following commands: + +```terminal +git clone git@github.com:mailgun/mailgun-php.git +cd mailgun-php +composer update +composer test +``` + +## Support and Feedback + +Be sure to visit the Mailgun official +[documentation website](http://documentation.mailgun.com/) for additional +information about our API. + +If you find a bug, please submit the issue in Github directly. +[Mailgun-PHP Issues](https://github.com/mailgun/mailgun-php/issues) + +As always, if you need additional assistance, drop us a note through your Control Panel at +[https://mailgun.com/cp/support](https://mailgun.com/cp/support). + diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/composer.json b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/composer.json new file mode 100644 index 0000000..c4290f7 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/composer.json @@ -0,0 +1,41 @@ +{ + "name": "mailgun/mailgun-php", + "description": "The Mailgun SDK provides methods for all API functions.", + "require": { + "php": "^5.5|^7.0", + "php-http/httplug": "^1.0", + "php-http/multipart-stream-builder": "^1.0", + "php-http/message": "^1.0", + "php-http/client-common": "^1.1", + "php-http/discovery": "^1.0", + "webmozart/assert": "^1.2" + }, + "require-dev": { + "phpunit/phpunit": "~4.8", + "php-http/guzzle6-adapter": "^1.0", + "guzzlehttp/psr7": "^1.4" + }, + "autoload": { + "psr-0": { + "Mailgun": "src/" + } + }, + "autoload-dev": { + "psr-4": { + "Mailgun\\Tests\\": "tests/" + } + }, + "license": "MIT", + "authors": [ + { + "name": "Travis Swientek", + "email": "travis@mailgunhq.com" + } + ], + "scripts": { + "test": "vendor/bin/phpunit --testsuite unit && vendor/bin/phpunit --testsuite functional", + "test-all": "vendor/bin/phpunit --testsuite all", + "test-integration": "vendor/bin/phpunit --testsuite integration", + "test-coverage": "vendor/bin/phpunit --testsuite all --coverage-text --coverage-clover=build/coverage.xml" + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Domain.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Domain.php new file mode 100644 index 0000000..5f208c9 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Domain.php @@ -0,0 +1,266 @@ + + */ +class Domain extends HttpApi +{ + /** + * Returns a list of domains on the account. + * + * @param int $limit + * @param int $skip + * + * @return IndexResponse + */ + public function index($limit = 100, $skip = 0) + { + Assert::integer($limit); + Assert::integer($skip); + + $params = [ + 'limit' => $limit, + 'skip' => $skip, + ]; + + $response = $this->httpGet('/v3/domains', $params); + + return $this->hydrateResponse($response, IndexResponse::class); + } + + /** + * Returns a single domain. + * + * @param string $domain Name of the domain. + * + * @return ShowResponse|array|ResponseInterface + */ + public function show($domain) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpGet(sprintf('/v3/domains/%s', $domain)); + + return $this->hydrateResponse($response, ShowResponse::class); + } + + /** + * Creates a new domain for the account. + * See below for spam filtering parameter information. + * {@link https://documentation.mailgun.com/user_manual.html#um-spam-filter}. + * + * @param string $domain Name of the domain. + * @param string $smtpPass Password for SMTP authentication. + * @param string $spamAction `disable` or `tag` - inbound spam filtering. + * @param bool $wildcard Domain will accept email for subdomains. + * + * @return CreateResponse|array|ResponseInterface + */ + public function create($domain, $smtpPass, $spamAction, $wildcard) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($smtpPass); + // TODO(sean.johnson): Extended spam filter input validation. + Assert::stringNotEmpty($spamAction); + Assert::boolean($wildcard); + + $params = [ + 'name' => $domain, + 'smtp_password' => $smtpPass, + 'spam_action' => $spamAction, + 'wildcard' => $wildcard, + ]; + + $response = $this->httpPost('/v3/domains', $params); + + return $this->hydrateResponse($response, CreateResponse::class); + } + + /** + * Removes a domain from the account. + * WARNING: This action is irreversible! Be cautious! + * + * @param string $domain Name of the domain. + * + * @return DeleteResponse|array|ResponseInterface + */ + public function delete($domain) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpDelete(sprintf('/v3/domains/%s', $domain)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } + + /** + * Returns a list of SMTP credentials for the specified domain. + * + * @param string $domain Name of the domain. + * @param int $limit Number of credentials to return + * @param int $skip Number of credentials to omit from the list + * + * @return CredentialResponse + */ + public function credentials($domain, $limit = 100, $skip = 0) + { + Assert::stringNotEmpty($domain); + Assert::integer($limit); + Assert::integer($skip); + + $params = [ + 'limit' => $limit, + 'skip' => $skip, + ]; + + $response = $this->httpGet(sprintf('/v3/domains/%s/credentials', $domain), $params); + + return $this->hydrateResponse($response, CredentialResponse::class); + } + + /** + * Create a new SMTP credential pair for the specified domain. + * + * @param string $domain Name of the domain. + * @param string $login SMTP Username. + * @param string $password SMTP Password. Length min 5, max 32. + * + * @return CreateCredentialResponse|array|ResponseInterface + */ + public function createCredential($domain, $login, $password) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($login); + Assert::stringNotEmpty($password); + Assert::lengthBetween($password, 5, 32, 'SMTP password must be between 5 and 32 characters.'); + + $params = [ + 'login' => $login, + 'password' => $password, + ]; + + $response = $this->httpPost(sprintf('/v3/domains/%s/credentials', $domain), $params); + + return $this->hydrateResponse($response, CreateCredentialResponse::class); + } + + /** + * Update a set of SMTP credentials for the specified domain. + * + * @param string $domain Name of the domain. + * @param string $login SMTP Username. + * @param string $pass New SMTP Password. Length min 5, max 32. + * + * @return UpdateCredentialResponse|array|ResponseInterface + */ + public function updateCredential($domain, $login, $pass) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($login); + Assert::stringNotEmpty($pass); + Assert::lengthBetween($pass, 5, 32, 'SMTP password must be between 5 and 32 characters.'); + + $params = [ + 'password' => $pass, + ]; + + $response = $this->httpPut(sprintf('/v3/domains/%s/credentials/%s', $domain, $login), $params); + + return $this->hydrateResponse($response, UpdateCredentialResponse::class); + } + + /** + * Remove a set of SMTP credentials from the specified domain. + * + * @param string $domain Name of the domain. + * @param string $login SMTP Username. + * + * @return DeleteCredentialResponse|array|ResponseInterface + */ + public function deleteCredential($domain, $login) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($login); + + $response = $this->httpDelete( + sprintf( + '/v3/domains/%s/credentials/%s', + $domain, + $login + ) + ); + + return $this->hydrateResponse($response, DeleteCredentialResponse::class); + } + + /** + * Returns delivery connection settings for the specified domain. + * + * @param string $domain Name of the domain. + * + * @return ConnectionResponse|ResponseInterface + */ + public function connection($domain) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpGet(sprintf('/v3/domains/%s/connection', $domain)); + + return $this->hydrateResponse($response, ConnectionResponse::class); + } + + /** + * Updates the specified delivery connection settings for the specified domain. + * If a parameter is passed in as null, it will not be updated. + * + * @param string $domain Name of the domain. + * @param bool|null $requireTLS Enforces that messages are sent only over a TLS connection. + * @param bool|null $noVerify Disables TLS certificate and hostname verification. + * + * @return UpdateConnectionResponse|array|ResponseInterface + */ + public function updateConnection($domain, $requireTLS, $noVerify) + { + Assert::stringNotEmpty($domain); + Assert::nullOrBoolean($requireTLS); + Assert::nullOrBoolean($noVerify); + + $params = []; + + if (null !== $requireTLS) { + $params['require_tls'] = $requireTLS ? 'true' : 'false'; + } + + if (null !== $noVerify) { + $params['skip_verification'] = $noVerify ? 'true' : 'false'; + } + + $response = $this->httpPut(sprintf('/v3/domains/%s/connection', $domain), $params); + + return $this->hydrateResponse($response, UpdateConnectionResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Event.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Event.php new file mode 100644 index 0000000..d49d4e7 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Event.php @@ -0,0 +1,38 @@ + + */ +class Event extends HttpApi +{ + use Pagination; + + /** + * @param string $domain + * @param array $params + * + * @return EventResponse + */ + public function get($domain, array $params = []) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpGet(sprintf('/v3/%s/events', $domain), $params); + + return $this->hydrateResponse($response, EventResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/HttpApi.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/HttpApi.php new file mode 100644 index 0000000..0035479 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/HttpApi.php @@ -0,0 +1,235 @@ + + */ +abstract class HttpApi +{ + /** + * The HTTP client. + * + * @var HttpClient + */ + private $httpClient; + + /** + * @var Hydrator + */ + protected $hydrator; + + /** + * @var RequestBuilder + */ + protected $requestBuilder; + + /** + * @param HttpClient $httpClient + * @param RequestBuilder $requestBuilder + * @param Hydrator $hydrator + */ + public function __construct(HttpClient $httpClient, RequestBuilder $requestBuilder, Hydrator $hydrator) + { + $this->httpClient = $httpClient; + $this->requestBuilder = $requestBuilder; + if (!$hydrator instanceof NoopHydrator) { + $this->hydrator = $hydrator; + } + } + + /** + * @param ResponseInterface $response + * @param string $class + * + * @return mixed|ResponseInterface + * + * @throws \Exception + */ + protected function hydrateResponse(ResponseInterface $response, $class) + { + if (!$this->hydrator) { + return $response; + } + + if ($response->getStatusCode() !== 200 && $response->getStatusCode() !== 201) { + $this->handleErrors($response); + } + + return $this->hydrator->hydrate($response, $class); + } + + /** + * Throw the correct exception for this error. + * + * @param ResponseInterface $response + * + * @throws \Exception + */ + protected function handleErrors(ResponseInterface $response) + { + $statusCode = $response->getStatusCode(); + switch ($statusCode) { + case 400: + throw HttpClientException::badRequest($response); + case 401: + throw HttpClientException::unauthorized($response); + case 402: + throw HttpClientException::requestFailed($response); + case 404: + throw HttpClientException::notFound($response); + case 500 <= $statusCode: + throw HttpServerException::serverError($statusCode); + default: + throw new UnknownErrorException(); + } + } + + /** + * Send a GET request with query parameters. + * + * @param string $path Request path + * @param array $parameters GET parameters + * @param array $requestHeaders Request Headers + * + * @return ResponseInterface + */ + protected function httpGet($path, array $parameters = [], array $requestHeaders = []) + { + if (count($parameters) > 0) { + $path .= '?'.http_build_query($parameters); + } + + try { + $response = $this->httpClient->sendRequest( + $this->requestBuilder->create('GET', $path, $requestHeaders) + ); + } catch (HttplugException\NetworkException $e) { + throw HttpServerException::networkError($e); + } + + return $response; + } + + /** + * Send a POST request with parameters. + * + * @param string $path Request path + * @param array $parameters POST parameters + * @param array $requestHeaders Request headers + * + * @return ResponseInterface + */ + protected function httpPost($path, array $parameters = [], array $requestHeaders = []) + { + return $this->httpPostRaw($path, $this->createRequestBody($parameters), $requestHeaders); + } + + /** + * Send a POST request with raw data. + * + * @param string $path Request path + * @param array|string $body Request body + * @param array $requestHeaders Request headers + * + * @return ResponseInterface + */ + protected function httpPostRaw($path, $body, array $requestHeaders = []) + { + try { + $response = $this->httpClient->sendRequest( + $this->requestBuilder->create('POST', $path, $requestHeaders, $body) + ); + } catch (HttplugException\NetworkException $e) { + throw HttpServerException::networkError($e); + } + + return $response; + } + + /** + * Send a PUT request. + * + * @param string $path Request path + * @param array $parameters PUT parameters + * @param array $requestHeaders Request headers + * + * @return ResponseInterface + */ + protected function httpPut($path, array $parameters = [], array $requestHeaders = []) + { + try { + $response = $this->httpClient->sendRequest( + $this->requestBuilder->create('PUT', $path, $requestHeaders, $this->createRequestBody($parameters)) + ); + } catch (HttplugException\NetworkException $e) { + throw HttpServerException::networkError($e); + } + + return $response; + } + + /** + * Send a DELETE request. + * + * @param string $path Request path + * @param array $parameters DELETE parameters + * @param array $requestHeaders Request headers + * + * @return ResponseInterface + */ + protected function httpDelete($path, array $parameters = [], array $requestHeaders = []) + { + try { + $response = $this->httpClient->sendRequest( + $this->requestBuilder->create('DELETE', $path, $requestHeaders, $this->createRequestBody($parameters)) + ); + } catch (HttplugException\NetworkException $e) { + throw HttpServerException::networkError($e); + } + + return $response; + } + + /** + * Prepare a set of key-value-pairs to be encoded as multipart/form-data. + * + * @param array $parameters Request parameters + * + * @return array + */ + protected function createRequestBody(array $parameters) + { + $resources = []; + foreach ($parameters as $key => $values) { + if (!is_array($values)) { + $values = [$values]; + } + foreach ($values as $value) { + $resources[] = [ + 'name' => $key, + 'content' => $value, + ]; + } + } + + return $resources; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Message.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Message.php new file mode 100644 index 0000000..cdbfd87 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Message.php @@ -0,0 +1,170 @@ + + */ +class Message extends HttpApi +{ + /** + * @param string $domain + * @param array $params + * + * @return SendResponse + */ + public function send($domain, array $params) + { + Assert::string($domain); + Assert::notEmpty($domain); + Assert::notEmpty($params); + + $postDataMultipart = []; + $fields = ['attachment', 'inline']; + foreach ($fields as $fieldName) { + if (!isset($params[$fieldName])) { + continue; + } + + Assert::isArray($params[$fieldName]); + foreach ($params[$fieldName] as $file) { + $postDataMultipart[] = $this->prepareFile($fieldName, $file); + } + + unset($params[$fieldName]); + } + + $postDataMultipart = array_merge($this->prepareMultipartParameters($params), $postDataMultipart); + $response = $this->httpPostRaw(sprintf('/v3/%s/messages', $domain), $postDataMultipart); + + return $this->hydrateResponse($response, SendResponse::class); + } + + /** + * @param string $domain + * @param array $recipients with all you send emails to. Including bcc and cc + * @param string $message Message filepath or content + * @param array $params + */ + public function sendMime($domain, array $recipients, $message, array $params) + { + Assert::string($domain); + Assert::notEmpty($domain); + Assert::notEmpty($recipients); + Assert::notEmpty($message); + Assert::nullOrIsArray($params); + + $params['to'] = $recipients; + $postDataMultipart = $this->prepareMultipartParameters($params); + + if (is_file($message)) { + $fileData = ['filePath' => $message]; + } else { + $fileData = [ + 'fileContent' => $message, + 'filename' => 'message', + ]; + } + $postDataMultipart[] = $this->prepareFile('message', $fileData); + $response = $this->httpPostRaw(sprintf('/v3/%s/messages.mime', $domain), $postDataMultipart); + + return $this->hydrateResponse($response, SendResponse::class); + } + + /** + * Get stored message. + * + * @param string $url + * @param bool $rawMessage if true we will use "Accept: message/rfc2822" header + * + * @return ShowResponse + */ + public function show($url, $rawMessage = false) + { + Assert::notEmpty($url); + + $headers = []; + if ($rawMessage) { + $headers['Accept'] = 'message/rfc2822'; + } + + $response = $this->httpGet($url, [], $headers); + + return $this->hydrateResponse($response, ShowResponse::class); + } + + /** + * Prepare a file. + * + * @param string $fieldName + * @param array $filePath array('fileContent' => 'content') or array('filePath' => '/foo/bar') + * + * @return array + * + * @throws InvalidArgumentException + */ + private function prepareFile($fieldName, array $filePath) + { + $filename = isset($filePath['filename']) ? $filePath['filename'] : null; + + if (isset($filePath['fileContent'])) { + // File from memory + $resource = fopen('php://temp', 'r+'); + fwrite($resource, $filePath['fileContent']); + rewind($resource); + } elseif (isset($filePath['filePath'])) { + // File form path + $path = $filePath['filePath']; + + // Remove leading @ symbol + if (strpos($path, '@') === 0) { + $path = substr($path, 1); + } + + $resource = fopen($path, 'r'); + } else { + throw new InvalidArgumentException('When using a file you need to specify parameter "fileContent" or "filePath"'); + } + + return [ + 'name' => $fieldName, + 'content' => $resource, + 'filename' => $filename, + ]; + } + + /** + * Prepare multipart parameters. Make sure each POST parameter is splitted into an array with 'name' and 'content' keys. + * + * @param array $params + * + * @return array + */ + private function prepareMultipartParameters(array $params) + { + $postDataMultipart = []; + foreach ($params as $key => $value) { + // If $value is not an array we cast it to an array + foreach ((array) $value as $subValue) { + $postDataMultipart[] = [ + 'name' => $key, + 'content' => $subValue, + ]; + } + } + + return $postDataMultipart; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Pagination.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Pagination.php new file mode 100644 index 0000000..335a8b0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Pagination.php @@ -0,0 +1,83 @@ + + */ +trait Pagination +{ + abstract protected function httpGet($path, array $parameters = [], array $requestHeaders = []); + + abstract protected function hydrateResponse(ResponseInterface $response, $className); + + /** + * @param PagingProvider $response + * + * @return PagingProvider|null + */ + public function nextPage(PagingProvider $response) + { + return $this->getPaginationUrl($response->getNextUrl(), get_class($response)); + } + + /** + * @param PagingProvider $response + * + * @return PagingProvider|null + */ + public function previousPage(PagingProvider $response) + { + return $this->getPaginationUrl($response->getPreviousUrl(), get_class($response)); + } + + /** + * @param PagingProvider $response + * + * @return PagingProvider|null + */ + public function firstPage(PagingProvider $response) + { + return $this->getPaginationUrl($response->getFirstUrl(), get_class($response)); + } + + /** + * @param PagingProvider $response + * + * @return PagingProvider|null + */ + public function lastPage(PagingProvider $response) + { + return $this->getPaginationUrl($response->getLastUrl(), get_class($response)); + } + + /** + * @param string $url + * @param string $class + * + * @return PagingProvider|null + */ + private function getPaginationUrl($url, $class) + { + Assert::stringNotEmpty($class); + + if (empty($url)) { + return; + } + + $response = $this->httpGet($url); + + return $this->hydrateResponse($response, $class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Route.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Route.php new file mode 100644 index 0000000..561550f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Route.php @@ -0,0 +1,157 @@ + + */ +class Route extends HttpApi +{ + /** + * Fetches the list of Routes. + * + * @param int $limit Maximum number of records to return. (100 by default) + * @param int $skip Number of records to skip. (0 by default) + * + * @return IndexResponse + */ + public function index($limit = 100, $skip = 0) + { + Assert::integer($limit); + Assert::integer($skip); + Assert::greaterThan($limit, 0); + Assert::greaterThanEq($skip, 0); + + $params = [ + 'limit' => $limit, + 'skip' => $skip, + ]; + + $response = $this->httpGet('/v3/routes', $params); + + return $this->hydrateResponse($response, IndexResponse::class); + } + + /** + * Returns a single Route object based on its ID. + * + * @param string $routeId Route ID returned by the Routes::index() method + * + * @return ShowResponse + */ + public function show($routeId) + { + Assert::stringNotEmpty($routeId); + + $response = $this->httpGet(sprintf('/v3/routes/%s', $routeId)); + + return $this->hydrateResponse($response, ShowResponse::class); + } + + /** + * Creates a new Route. + * + * @param string $expression A filter expression like "match_recipient('.*@gmail.com')" + * @param array $actions Route action. This action is executed when the expression evaluates to True. Example: "forward('alice@example.com')" + * @param string $description An arbitrary string + * @param int $priority Integer: smaller number indicates higher priority. Higher priority routes are handled first. Defaults to 0. + * + * @return CreateResponse + */ + public function create($expression, array $actions, $description, $priority = 0) + { + Assert::string($expression); + Assert::isArray($actions); + Assert::string($description); + Assert::integer($priority); + + $params = [ + 'priority' => $priority, + 'expression' => $expression, + 'action' => $actions, + 'description' => $description, + ]; + + $response = $this->httpPost('/v3/routes', $params); + + return $this->hydrateResponse($response, CreateResponse::class); + } + + /** + * Updates a given Route by ID. All parameters are optional. + * This API call only updates the specified fields leaving others unchanged. + * + * @param string $routeId Route ID returned by the Routes::index() method + * @param string|null $expression A filter expression like "match_recipient('.*@gmail.com')" + * @param array|null $actions Route action. This action is executed when the expression evaluates to True. Example: "forward('alice@example.com')" + * @param string|null $description An arbitrary string + * @param int|null $priority Integer: smaller number indicates higher priority. Higher priority routes are handled first. Defaults to 0. + * + * @return UpdateResponse + */ + public function update($routeId, $expression = null, array $actions = [], $description = null, $priority = null) + { + Assert::stringNotEmpty($routeId); + Assert::nullOrString($expression); + Assert::isArray($actions); + Assert::nullOrString($description); + Assert::nullOrInteger($priority); + + $params = []; + + if (!empty($expression)) { + $params['expression'] = trim($expression); + } + + foreach ($actions as $action) { + Assert::stringNotEmpty($action); + + $params['action'] = isset($params['action']) ? $params['action'] : []; + $params['action'][] = $action; + } + + if (!empty($description)) { + $params['description'] = trim($description); + } + + if (!empty($priority)) { + $params['priority'] = $priority; + } + + $response = $this->httpPut(sprintf('/v3/routes/%s', $routeId), $params); + + return $this->hydrateResponse($response, UpdateResponse::class); + } + + /** + * Deletes a Route based on the ID. + * + * @param string $routeId Route ID returned by the Routes::index() method + * + * @return DeleteResponse + */ + public function delete($routeId) + { + Assert::stringNotEmpty($routeId); + + $response = $this->httpDelete(sprintf('/v3/routes/%s', $routeId)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Stats.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Stats.php new file mode 100644 index 0000000..cd7b947 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Stats.php @@ -0,0 +1,52 @@ + + */ +class Stats extends HttpApi +{ + /** + * @param string $domain + * @param array $params + * + * @return TotalResponse|array + */ + public function total($domain, array $params = []) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpGet(sprintf('/v3/%s/stats/total', rawurlencode($domain)), $params); + + return $this->hydrateResponse($response, TotalResponse::class); + } + + /** + * @param $domain + * @param array $params + * + * @return AllResponse|array + */ + public function all($domain, array $params = []) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpGet(sprintf('/v3/%s/stats', rawurlencode($domain)), $params); + + return $this->hydrateResponse($response, AllResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression.php new file mode 100644 index 0000000..db35bfe --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression.php @@ -0,0 +1,76 @@ + + */ +class Suppression +{ + /** + * @var HttpClient + */ + private $httpClient; + + /** + * @var RequestBuilder + */ + private $requestBuilder; + + /** + * @var Hydrator + */ + private $hydrator; + + /** + * @param HttpClient $httpClient + * @param RequestBuilder $requestBuilder + * @param Hydrator $hydrator + */ + public function __construct(HttpClient $httpClient, RequestBuilder $requestBuilder, Hydrator $hydrator) + { + $this->httpClient = $httpClient; + $this->requestBuilder = $requestBuilder; + $this->hydrator = $hydrator; + } + + /** + * @return Bounce + */ + public function bounces() + { + return new Bounce($this->httpClient, $this->requestBuilder, $this->hydrator); + } + + /** + * @return Complaint + */ + public function complaints() + { + return new Complaint($this->httpClient, $this->requestBuilder, $this->hydrator); + } + + /** + * @return Unsubscribe + */ + public function unsubscribes() + { + return new Unsubscribe($this->httpClient, $this->requestBuilder, $this->hydrator); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Bounce.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Bounce.php new file mode 100644 index 0000000..b734c3c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Bounce.php @@ -0,0 +1,113 @@ + + */ +class Bounce extends HttpApi +{ + use Pagination; + + /** + * @param string $domain Domain to list bounces for + * @param int $limit optional + * + * @return IndexResponse + */ + public function index($domain, $limit = 100) + { + Assert::stringNotEmpty($domain); + Assert::range($limit, 1, 10000, '"Limit" parameter must be between 1 and 10000'); + + $params = [ + 'limit' => $limit, + ]; + + $response = $this->httpGet(sprintf('/v3/%s/bounces', $domain), $params); + + return $this->hydrateResponse($response, IndexResponse::class); + } + + /** + * @param string $domain Domain to show bounce from + * @param string $address Bounce address to show + * + * @return ShowResponse + */ + public function show($domain, $address) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + + $response = $this->httpGet(sprintf('/v3/%s/bounces/%s', $domain, $address)); + + return $this->hydrateResponse($response, ShowResponse::class); + } + + /** + * @param string $domain Domain to create a bounce for + * @param string $address Address to create a bounce for + * @param array $params optional + * + * @return CreateResponse + */ + public function create($domain, $address, array $params = []) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + + $params['address'] = $address; + + $response = $this->httpPost(sprintf('/v3/%s/bounces', $domain), $params); + + return $this->hydrateResponse($response, CreateResponse::class); + } + + /** + * @param string $domain Domain to delete a bounce for + * @param string $address Bounce address to delete + * + * @return DeleteResponse + */ + public function delete($domain, $address) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + + $response = $this->httpDelete(sprintf('/v3/%s/bounces/%s', $domain, $address)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } + + /** + * @param string $domain Domain to delete all bounces for + * + * @return DeleteResponse + */ + public function deleteAll($domain) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpDelete(sprintf('/v3/%s/bounces', $domain)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Complaint.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Complaint.php new file mode 100644 index 0000000..902d0a5 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Complaint.php @@ -0,0 +1,116 @@ + + */ +class Complaint extends HttpApi +{ + use Pagination; + + /** + * @param string $domain Domain to get complaints for + * @param int $limit optional + * + * @return IndexResponse + */ + public function index($domain, $limit = 100) + { + Assert::stringNotEmpty($domain); + Assert::range($limit, 1, 10000, 'Limit parameter must be between 1 and 10000'); + + $params = [ + 'limit' => $limit, + ]; + + $response = $this->httpGet(sprintf('/v3/%s/complaints', $domain), $params); + + return $this->hydrateResponse($response, IndexResponse::class); + } + + /** + * @param string $domain Domain to show complaint for + * @param string $address Complaint address + * + * @return ShowResponse + */ + public function show($domain, $address) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + $response = $this->httpGet(sprintf('/v3/%s/complaints/%s', $domain, $address)); + + return $this->hydrateResponse($response, ShowResponse::class); + } + + /** + * @param string $domain Domain to create complaint for + * @param string $address Complaint address + * @param string $createdAt (optional) rfc2822 compliant format. (new \DateTime())->format('r') + * + * @return CreateResponse + */ + public function create($domain, $address, $createdAt = null) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + Assert::stringNotEmpty($createdAt); + + $params['address'] = $address; + if (null !== $createdAt) { + $params['created_at'] = $createdAt; + } + + $response = $this->httpPost(sprintf('/v3/%s/complaints', $domain), $params); + + return $this->hydrateResponse($response, CreateResponse::class); + } + + /** + * @param string $domain Domain to delete complaint for + * @param string $address Complaint address + * + * @return DeleteResponse + */ + public function delete($domain, $address) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + + $response = $this->httpDelete(sprintf('/v3/%s/complaints/%s', $domain, $address)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } + + /** + * @param string $domain Domain to delete all bounces for + * + * @return DeleteResponse + */ + public function deleteAll($domain) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpDelete(sprintf('/v3/%s/complaints', $domain)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Unsubscribe.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Unsubscribe.php new file mode 100644 index 0000000..72d894e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Suppression/Unsubscribe.php @@ -0,0 +1,113 @@ + + */ +class Unsubscribe extends HttpApi +{ + use Pagination; + + /** + * @param string $domain Domain to get unsubscribes for + * @param int $limit optional + * + * @return IndexResponse + */ + public function index($domain, $limit = 100) + { + Assert::stringNotEmpty($domain); + Assert::range($limit, 1, 10000, 'Limit parameter must be between 1 and 10000'); + + $params = [ + 'limit' => $limit, + ]; + + $response = $this->httpGet(sprintf('/v3/%s/unsubscribes', $domain), $params); + + return $this->hydrateResponse($response, IndexResponse::class); + } + + /** + * @param string $domain Domain to show unsubscribe for + * @param string $address Unsubscribe address + * + * @return ShowResponse + */ + public function show($domain, $address) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + + $response = $this->httpGet(sprintf('/v3/%s/unsubscribes/%s', $domain, $address)); + + return $this->hydrateResponse($response, ShowResponse::class); + } + + /** + * @param string $domain Domain to create unsubscribe for + * @param string $address Unsubscribe address + * @param array $params optional + * + * @return CreateResponse + */ + public function create($domain, $address, array $params = []) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + + $params['address'] = $address; + + $response = $this->httpPost(sprintf('/v3/%s/unsubscribes', $domain), $params); + + return $this->hydrateResponse($response, CreateResponse::class); + } + + /** + * @param string $domain Domain to delete unsubscribe for + * @param string $address Unsubscribe address + * + * @return DeleteResponse + */ + public function delete($domain, $address) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($address); + + $response = $this->httpDelete(sprintf('/v3/%s/unsubscribes/%s', $domain, $address)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } + + /** + * @param string $domain Domain to delete all unsubscribes for + * + * @return DeleteResponse + */ + public function deleteAll($domain) + { + Assert::stringNotEmpty($domain); + + $response = $this->httpDelete(sprintf('/v3/%s/unsubscribes', $domain)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Tag.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Tag.php new file mode 100644 index 0000000..625274e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Tag.php @@ -0,0 +1,128 @@ + + */ +class Tag extends HttpApi +{ + /** + * Returns a list of tags. + * + * @param string $domain + * @param int $limit + * + * @return IndexResponse|ResponseInterface + */ + public function index($domain, $limit = 100) + { + Assert::stringNotEmpty($domain); + Assert::integer($limit); + + $params = [ + 'limit' => $limit, + ]; + + $response = $this->httpGet(sprintf('/v3/%s/tags', $domain), $params); + + return $this->hydrateResponse($response, IndexResponse::class); + } + + /** + * Returns a single tag. + * + * @param string $domain Name of the domain + * @param string $tag + * + * @return ShowResponse|ResponseInterface + */ + public function show($domain, $tag) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($tag); + + $response = $this->httpGet(sprintf('/v3/%s/tags/%s', $domain, $tag)); + + return $this->hydrateResponse($response, ShowResponse::class); + } + + /** + * Update a tag. + * + * @param string $domain + * @param string $tag + * @param string $description + * + * @return UpdateResponse|ResponseInterface + */ + public function update($domain, $tag, $description) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($tag); + Assert::string($description); + + $params = [ + 'description' => $description, + ]; + + $response = $this->httpPut(sprintf('/v3/%s/tags/%s', $domain, $tag), $params); + + return $this->hydrateResponse($response, UpdateResponse::class); + } + + /** + * Returns statistics for a single tag. + * + * @param string $domain Name of the domain + * @param string $tag + * @param array $params + * + * @return StatisticsResponse|ResponseInterface + */ + public function stats($domain, $tag, array $params) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($tag); + Assert::isArray($params); + + $response = $this->httpGet(sprintf('/v3/%s/tags/%s/stats', $domain, $tag), $params); + + return $this->hydrateResponse($response, StatisticsResponse::class); + } + + /** + * Removes a tag from the account. + * + * @param string $domain Name of the domain + * @param string $tag + * + * @return DeleteResponse|ResponseInterface + */ + public function delete($domain, $tag) + { + Assert::stringNotEmpty($domain); + Assert::stringNotEmpty($tag); + + $response = $this->httpDelete(sprintf('/v3/%s/tags/%s', $domain, $tag)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Webhook.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Webhook.php new file mode 100644 index 0000000..0dd1f18 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Api/Webhook.php @@ -0,0 +1,160 @@ + + */ +class Webhook extends HttpApi +{ + /** + * @var string + */ + private $apiKey; + + /** + * @param HttpClient $httpClient + * @param RequestBuilder $requestBuilder + * @param Hydrator $hydrator + * @param string $apiKey + */ + public function __construct(HttpClient $httpClient, RequestBuilder $requestBuilder, Hydrator $hydrator, $apiKey) + { + parent::__construct($httpClient, $requestBuilder, $hydrator); + $this->apiKey = $apiKey; + } + + /** + * This function verifies the webhook signature with your API key to to see if it is authentic. + * + * If this function returns FALSE, you must not process the request. + * You should reject the request with status code 403 Forbidden. + * + * @param int $timestamp + * @param string $token + * @param string $signature + * + * @return bool + */ + public function verifyWebhookSignature($timestamp, $token, $signature) + { + if (empty($timestamp) || empty($token) || empty($signature)) { + return false; + } + + $hmac = hash_hmac('sha256', $timestamp.$token, $this->apiKey); + + if (function_exists('hash_equals')) { + // hash_equals is constant time, but will not be introduced until PHP 5.6 + return hash_equals($hmac, $signature); + } else { + return $hmac === $signature; + } + } + + /** + * @param string $domain + * + * @return IndexResponse + */ + public function index($domain) + { + Assert::notEmpty($domain); + $response = $this->httpGet(sprintf('/v3/domains/%s/webhooks', $domain)); + + return $this->hydrateResponse($response, IndexResponse::class); + } + + /** + * @param string $domain + * @param string $webhook + * + * @return ShowResponse + */ + public function show($domain, $webhook) + { + Assert::notEmpty($domain); + Assert::notEmpty($webhook); + $response = $this->httpGet(sprintf('/v3/domains/%s/webhooks/%s', $domain, $webhook)); + + return $this->hydrateResponse($response, ShowResponse::class); + } + + /** + * @param string $domain + * @param string $id + * @param string $url + * + * @return CreateResponse + */ + public function create($domain, $id, $url) + { + Assert::notEmpty($domain); + Assert::notEmpty($id); + Assert::notEmpty($url); + + $params = [ + 'id' => $id, + 'url' => $url, + ]; + + $response = $this->httpPost(sprintf('/v3/domains/%s/webhooks', $domain), $params); + + return $this->hydrateResponse($response, CreateResponse::class); + } + + /** + * @param string $domain + * @param string $id + * @param string $url + * + * @return UpdateResponse + */ + public function update($domain, $id, $url) + { + Assert::notEmpty($domain); + Assert::notEmpty($id); + Assert::notEmpty($url); + + $params = [ + 'url' => $url, + ]; + + $response = $this->httpPut(sprintf('/v3/domains/%s/webhooks/%s', $domain, $id), $params); + + return $this->hydrateResponse($response, UpdateResponse::class); + } + + /** + * @param string $domain + * @param string $id + * + * @return DeleteResponse + */ + public function delete($domain, $id) + { + Assert::notEmpty($domain); + Assert::notEmpty($id); + + $response = $this->httpDelete(sprintf('/v3/domains/%s/webhooks/%s', $domain, $id)); + + return $this->hydrateResponse($response, DeleteResponse::class); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Assert.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Assert.php new file mode 100644 index 0000000..e5cbf6d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Assert.php @@ -0,0 +1,25 @@ + + */ +final class Assert extends \Webmozart\Assert\Assert +{ + protected static function reportInvalidArgument($message) + { + throw new InvalidArgumentException($message); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/GenericHTTPError.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/GenericHTTPError.php new file mode 100644 index 0000000..fc9560e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/GenericHTTPError.php @@ -0,0 +1,39 @@ +httpResponseCode = $response_code; + $this->httpResponseBody = $response_body; + } + + public function getHttpResponseCode() + { + return $this->httpResponseCode; + } + + public function getHttpResponseBody() + { + return $this->httpResponseBody; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/InvalidCredentials.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/InvalidCredentials.php new file mode 100644 index 0000000..fad86fe --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Connection/Exceptions/InvalidCredentials.php @@ -0,0 +1,19 @@ +apiKey = $apiKey; + $this->apiHost = $apiHost; + $this->httpClient = $httpClient; + } + + /** + * @param string $method + * @param string $uri + * @param mixed $body + * @param array $files + * @param array $headers + * + * @throws GenericHTTPError + * @throws InvalidCredentials + * @throws MissingEndpoint + * @throws MissingRequiredParameters + * + * @return \stdClass + */ + protected function send($method, $uri, $body = null, $files = [], array $headers = []) + { + $headers['User-Agent'] = Api::SDK_USER_AGENT.'/'.Api::SDK_VERSION; + $headers['Authorization'] = 'Basic '.base64_encode(sprintf('%s:%s', Api::API_USER, $this->apiKey)); + + if (!empty($files)) { + $builder = new MultipartStreamBuilder(); + foreach ($files as $file) { + $builder->addResource($file['name'], $file['contents'], $file); + } + $body = $builder->build(); + $headers['Content-Type'] = 'multipart/form-data; boundary="'.$builder->getBoundary().'"'; + } elseif (is_array($body)) { + $body = http_build_query($body); + $headers['Content-Type'] = 'application/x-www-form-urlencoded'; + } + + $request = MessageFactoryDiscovery::find()->createRequest($method, $this->getApiUrl($uri), $headers, $body); + $response = $this->getHttpClient()->sendRequest($request); + + return $this->responseHandler($response); + } + + /** + * @param string $url + * + * @throws GenericHTTPError + * @throws InvalidCredentials + * @throws MissingEndpoint + * @throws MissingRequiredParameters + * + * @return \stdClass + */ + public function getAttachment($url) + { + $headers['User-Agent'] = Api::SDK_USER_AGENT.'/'.Api::SDK_VERSION; + $headers['Authorization'] = 'Basic '.base64_encode(sprintf('%s:%s', Api::API_USER, $this->apiKey)); + $request = MessageFactoryDiscovery::find()->createRequest('get', $url, $headers); + $response = HttpClientDiscovery::find()->sendRequest($request); + + return $this->responseHandler($response); + } + + /** + * @param string $endpointUrl + * @param array $postData + * @param array $files + * + * @throws GenericHTTPError + * @throws InvalidCredentials + * @throws MissingEndpoint + * @throws MissingRequiredParameters + * + * @return \stdClass + */ + public function post($endpointUrl, array $postData = [], $files = []) + { + $postFiles = []; + + $fields = ['message', 'attachment', 'inline']; + foreach ($fields as $fieldName) { + if (isset($files[$fieldName])) { + if (is_array($files[$fieldName])) { + foreach ($files[$fieldName] as $file) { + $postFiles[] = $this->prepareFile($fieldName, $file); + } + } else { + $postFiles[] = $this->prepareFile($fieldName, $files[$fieldName]); + } + } + } + + $postDataMultipart = []; + foreach ($postData as $key => $value) { + if (is_array($value)) { + foreach ($value as $subValue) { + $postDataMultipart[] = [ + 'name' => $key, + 'contents' => $subValue, + ]; + } + } else { + $postDataMultipart[] = [ + 'name' => $key, + 'contents' => $value, + ]; + } + } + + return $this->send('POST', $endpointUrl, [], array_merge($postDataMultipart, $postFiles)); + } + + /** + * @param string $endpointUrl + * @param array $queryString + * + * @throws GenericHTTPError + * @throws InvalidCredentials + * @throws MissingEndpoint + * @throws MissingRequiredParameters + * + * @return \stdClass + */ + public function get($endpointUrl, $queryString = []) + { + return $this->send('GET', $endpointUrl.'?'.http_build_query($queryString)); + } + + /** + * @param string $endpointUrl + * + * @throws GenericHTTPError + * @throws InvalidCredentials + * @throws MissingEndpoint + * @throws MissingRequiredParameters + * + * @return \stdClass + */ + public function delete($endpointUrl) + { + return $this->send('DELETE', $endpointUrl); + } + + /** + * @param string $endpointUrl + * @param mixed $putData + * + * @throws GenericHTTPError + * @throws InvalidCredentials + * @throws MissingEndpoint + * @throws MissingRequiredParameters + * + * @return \stdClass + */ + public function put($endpointUrl, $putData) + { + return $this->send('PUT', $endpointUrl, $putData); + } + + /** + * @param ResponseInterface $responseObj + * + * @throws GenericHTTPError + * @throws InvalidCredentials + * @throws MissingEndpoint + * @throws MissingRequiredParameters + * + * @return \stdClass + */ + public function responseHandler(ResponseInterface $responseObj) + { + $httpResponseCode = (int) $responseObj->getStatusCode(); + + switch ($httpResponseCode) { + case 200: + $data = (string) $responseObj->getBody(); + $jsonResponseData = json_decode($data, false); + $result = new \stdClass(); + // return response data as json if possible, raw if not + $result->http_response_body = $data && $jsonResponseData === null ? $data : $jsonResponseData; + $result->http_response_code = $httpResponseCode; + + return $result; + case 400: + throw new MissingRequiredParameters(ExceptionMessages::EXCEPTION_MISSING_REQUIRED_PARAMETERS.$this->getResponseExceptionMessage($responseObj)); + case 401: + throw new InvalidCredentials(ExceptionMessages::EXCEPTION_INVALID_CREDENTIALS); + case 404: + throw new MissingEndpoint(ExceptionMessages::EXCEPTION_MISSING_ENDPOINT.$this->getResponseExceptionMessage($responseObj)); + default: + throw new GenericHTTPError(ExceptionMessages::EXCEPTION_GENERIC_HTTP_ERROR, $httpResponseCode, $responseObj->getBody()); + } + } + + /** + * @param ResponseInterface $responseObj + * + * @return string + */ + protected function getResponseExceptionMessage(ResponseInterface $responseObj) + { + $body = (string) $responseObj->getBody(); + $response = json_decode($body); + if (json_last_error() == JSON_ERROR_NONE && isset($response->message)) { + return ' '.$response->message; + } + + return ''; + } + + /** + * Prepare a file for the postBody. + * + * @param string $fieldName + * @param string|array $filePath + * + * @return array + */ + protected function prepareFile($fieldName, $filePath) + { + $filename = null; + + if (is_array($filePath) && isset($filePath['fileContent'])) { + // File from memory + $filename = $filePath['filename']; + $resource = fopen('php://temp', 'r+'); + fwrite($resource, $filePath['fileContent']); + rewind($resource); + } else { + // Backward compatibility code + if (is_array($filePath) && isset($filePath['filePath'])) { + $filename = $filePath['remoteName']; + $filePath = $filePath['filePath']; + } + + // Remove leading @ symbol + if (strpos($filePath, '@') === 0) { + $filePath = substr($filePath, 1); + } + + $resource = fopen($filePath, 'r'); + } + + return [ + 'name' => $fieldName, + 'contents' => $resource, + 'filename' => $filename, + ]; + } + + /** + * @return HttpClient + */ + protected function getHttpClient() + { + if ($this->httpClient === null) { + $this->httpClient = HttpClientDiscovery::find(); + } + + return $this->httpClient; + } + + /** + * @param string $uri + * + * @return string + */ + private function getApiUrl($uri) + { + return $this->generateEndpoint($this->apiHost, $this->apiVersion, $this->sslEnabled).$uri; + } + + /** + * @param string $apiEndpoint + * @param string $apiVersion + * @param bool $ssl + * + * @return string + */ + private function generateEndpoint($apiEndpoint, $apiVersion, $ssl) + { + return ($ssl ? 'https://' : 'http://').$apiEndpoint.'/'.$apiVersion.'/'; + } + + /** + * @param string $apiVersion + * + * @return RestClient + */ + public function setApiVersion($apiVersion) + { + $this->apiVersion = $apiVersion; + + return $this; + } + + /** + * @param bool $sslEnabled + * + * @return RestClient + * + * @deprecated To be removed in 3.0 + */ + public function setSslEnabled($sslEnabled) + { + $this->sslEnabled = $sslEnabled; + + return $this; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Constants/Api.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Constants/Api.php new file mode 100644 index 0000000..16eadd8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Constants/Api.php @@ -0,0 +1,24 @@ + + */ +interface Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HttpClientException.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HttpClientException.php new file mode 100644 index 0000000..1dedffc --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HttpClientException.php @@ -0,0 +1,85 @@ + + */ +final class HttpClientException extends \RuntimeException implements Exception +{ + /** + * @var ResponseInterface|null + */ + private $response; + + /** + * @var array + */ + private $responseBody; + + /** + * @param string $message + * @param int $code + * @param ResponseInterface|null $response + */ + public function __construct($message, $code, ResponseInterface $response = null) + { + parent::__construct($message, $code); + + if ($response) { + $this->response = $response; + $body = $response->getBody()->__toString(); + if (strpos($response->getHeaderLine('Content-Type'), 'application/json') !== 0) { + $this->responseBody['message'] = $body; + } else { + $this->responseBody = json_decode($body, true); + } + } + } + + public static function badRequest(ResponseInterface $response = null) + { + return new self('The parameters passed to the API were invalid. Check your inputs!', 400, $response); + } + + public static function unauthorized(ResponseInterface $response = null) + { + return new self('Your credentials are incorrect.', 401, $response); + } + + public static function requestFailed(ResponseInterface $response = null) + { + return new self('Parameters were valid but request failed. Try again.', 402, $response); + } + + public static function notFound(ResponseInterface $response = null) + { + return new self('The endpoint you tried to access does not exist. Check your URL.', 404, $response); + } + + /** + * @return ResponseInterface + */ + public function getResponse() + { + return $this->response; + } + + /** + * @return array + */ + public function getResponseBody() + { + return $this->responseBody; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HttpServerException.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HttpServerException.php new file mode 100644 index 0000000..3d5aa27 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HttpServerException.php @@ -0,0 +1,33 @@ + + */ +final class HttpServerException extends \RuntimeException implements Exception +{ + public static function serverError($httpStatus = 500) + { + return new self('An unexpected error occurred at Mailgun\'s servers. Try again later and contact support of the error sill exists.', $httpStatus); + } + + public static function networkError(\Exception $previous) + { + return new self('Mailgun\'s servers was unreachable.', 0, $previous); + } + + public static function unknownHttpResponseCode($code) + { + return new self(sprintf('Unknown HTTP response code ("%d") received from the API server', $code)); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HydrationException.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HydrationException.php new file mode 100644 index 0000000..0647a01 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/HydrationException.php @@ -0,0 +1,16 @@ + + */ +final class InvalidArgumentException extends \InvalidArgumentException implements Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/UnknownErrorException.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/UnknownErrorException.php new file mode 100644 index 0000000..23b3a21 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Exception/UnknownErrorException.php @@ -0,0 +1,19 @@ + + */ +final class UnknownErrorException extends \Exception implements Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClient/Plugin/History.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClient/Plugin/History.php new file mode 100644 index 0000000..53105b8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClient/Plugin/History.php @@ -0,0 +1,45 @@ + + */ +final class History implements Journal +{ + /** + * @var ResponseInterface + */ + private $lastResponse; + + /** + * @return ResponseInterface|null + */ + public function getLastResponse() + { + return $this->lastResponse; + } + + public function addSuccess(RequestInterface $request, ResponseInterface $response) + { + $this->lastResponse = $response; + } + + public function addFailure(RequestInterface $request, Exception $exception) + { + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClient/Plugin/ReplaceUriPlugin.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClient/Plugin/ReplaceUriPlugin.php new file mode 100644 index 0000000..0ed1106 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClient/Plugin/ReplaceUriPlugin.php @@ -0,0 +1,45 @@ + + */ +final class ReplaceUriPlugin implements Plugin +{ + /** + * @var UriInterface + */ + private $uri; + + /** + * @param UriInterface $uri + */ + public function __construct(UriInterface $uri) + { + $this->uri = $uri; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + $request = $request->withUri($this->uri); + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClientConfigurator.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClientConfigurator.php new file mode 100644 index 0000000..d156738 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/HttpClientConfigurator.php @@ -0,0 +1,185 @@ + + */ +final class HttpClientConfigurator +{ + /** + * @var string + */ + private $endpoint = 'https://api.mailgun.net'; + + /** + * If debug is true we will send all the request to the endpoint without appending any path. + * + * @var bool + */ + private $debug = false; + + /** + * @var string + */ + private $apiKey; + + /** + * @var UriFactory + */ + private $uriFactory; + + /** + * @var HttpClient + */ + private $httpClient; + + /** + * @var History + */ + private $responseHistory; + + public function __construct() + { + $this->responseHistory = new History(); + } + + /** + * @return PluginClient + */ + public function createConfiguredClient() + { + $plugins = [ + new Plugin\AddHostPlugin($this->getUriFactory()->createUri($this->endpoint)), + new Plugin\HeaderDefaultsPlugin([ + 'User-Agent' => 'mailgun-sdk-php/v2 (https://github.com/mailgun/mailgun-php)', + 'Authorization' => 'Basic '.base64_encode(sprintf('api:%s', $this->getApiKey())), + ]), + new Plugin\HistoryPlugin($this->responseHistory), + ]; + + if ($this->debug) { + $plugins[] = new ReplaceUriPlugin($this->getUriFactory()->createUri($this->endpoint)); + } + + return new PluginClient($this->getHttpClient(), $plugins); + } + + /** + * @param bool $debug + * + * @return HttpClientConfigurator + */ + public function setDebug($debug) + { + $this->debug = $debug; + + return $this; + } + + /** + * @param string $endpoint + * + * @return HttpClientConfigurator + */ + public function setEndpoint($endpoint) + { + $this->endpoint = $endpoint; + + return $this; + } + + /** + * @return string + */ + public function getApiKey() + { + return $this->apiKey; + } + + /** + * @param string $apiKey + * + * @return HttpClientConfigurator + */ + public function setApiKey($apiKey) + { + $this->apiKey = $apiKey; + + return $this; + } + + /** + * @return UriFactory + */ + private function getUriFactory() + { + if ($this->uriFactory === null) { + $this->uriFactory = UriFactoryDiscovery::find(); + } + + return $this->uriFactory; + } + + /** + * @param UriFactory $uriFactory + * + * @return HttpClientConfigurator + */ + public function setUriFactory(UriFactory $uriFactory) + { + $this->uriFactory = $uriFactory; + + return $this; + } + + /** + * @return HttpClient + */ + private function getHttpClient() + { + if ($this->httpClient === null) { + $this->httpClient = HttpClientDiscovery::find(); + } + + return $this->httpClient; + } + + /** + * @param HttpClient $httpClient + * + * @return HttpClientConfigurator + */ + public function setHttpClient(HttpClient $httpClient) + { + $this->httpClient = $httpClient; + + return $this; + } + + /** + * @return History + */ + public function getResponseHistory() + { + return $this->responseHistory; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/ArrayHydrator.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/ArrayHydrator.php new file mode 100644 index 0000000..4174a5e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/ArrayHydrator.php @@ -0,0 +1,42 @@ + + */ +final class ArrayHydrator implements Hydrator +{ + /** + * @param ResponseInterface $response + * @param string $class + * + * @return array + */ + public function hydrate(ResponseInterface $response, $class) + { + $body = $response->getBody()->__toString(); + if (strpos($response->getHeaderLine('Content-Type'), 'application/json') !== 0) { + throw new HydrationException('The ArrayHydrator cannot hydrate response with Content-Type:'.$response->getHeaderLine('Content-Type')); + } + + $content = json_decode($body, true); + if (JSON_ERROR_NONE !== json_last_error()) { + throw new HydrationException(sprintf('Error (%d) when trying to json_decode response', json_last_error())); + } + + return $content; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/Hydrator.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/Hydrator.php new file mode 100644 index 0000000..ac03eb0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/Hydrator.php @@ -0,0 +1,29 @@ + + */ +final class ModelHydrator implements Hydrator +{ + /** + * @param ResponseInterface $response + * @param string $class + * + * @return ResponseInterface + */ + public function hydrate(ResponseInterface $response, $class) + { + $body = $response->getBody()->__toString(); + $contentType = $response->getHeaderLine('Content-Type'); + if (strpos($contentType, 'application/json') !== 0 && strpos($contentType, 'application/octet-stream') !== 0) { + throw new HydrationException('The ModelHydrator cannot hydrate response with Content-Type: '.$contentType); + } + + $data = json_decode($body, true); + if (JSON_ERROR_NONE !== json_last_error()) { + throw new HydrationException(sprintf('Error (%d) when trying to json_decode response', json_last_error())); + } + + if (is_subclass_of($class, ApiResponse::class)) { + $object = call_user_func($class.'::create', $data); + } else { + $object = new $class($data); + } + + return $object; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/NoopHydrator.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/NoopHydrator.php new file mode 100644 index 0000000..f5d8c43 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Hydrator/NoopHydrator.php @@ -0,0 +1,31 @@ + + */ +final class NoopHydrator implements Hydrator +{ + /** + * @param ResponseInterface $response + * @param string $class + * + * @throws \LogicException + */ + public function hydrate(ResponseInterface $response, $class) + { + throw new \LogicException('The NoopHydrator should never be called'); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Lists/OptInHandler.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Lists/OptInHandler.php new file mode 100644 index 0000000..a263563 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Lists/OptInHandler.php @@ -0,0 +1,60 @@ + $recipientAddress, 'l' => $mailingList]; + $encodedInnerPayload = base64_encode(json_encode($innerPayload)); + + $innerHash = hash_hmac('sha1', $encodedInnerPayload, $secretAppId); + $outerPayload = ['h' => $innerHash, 'p' => $encodedInnerPayload]; + + return urlencode(base64_encode(json_encode($outerPayload))); + } + + /** + * @param string $secretAppId + * @param string $uniqueHash + * + * @return array|bool + */ + public function validateHash($secretAppId, $uniqueHash) + { + $decodedOuterPayload = json_decode(base64_decode(urldecode($uniqueHash)), true); + + $decodedHash = $decodedOuterPayload['h']; + $innerPayload = $decodedOuterPayload['p']; + + $decodedInnerPayload = json_decode(base64_decode($innerPayload), true); + $computedInnerHash = hash_hmac('sha1', $innerPayload, $secretAppId); + + if ($computedInnerHash == $decodedHash) { + return ['recipientAddress' => $decodedInnerPayload['r'], 'mailingList' => $decodedInnerPayload['l']]; + } + + return false; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Lists/README.md b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Lists/README.md new file mode 100644 index 0000000..940e4be --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Lists/README.md @@ -0,0 +1,116 @@ +Mailgun - Lists +==================== + +This is the Mailgun PHP *Lists* utilities. + +The below assumes you've already installed the Mailgun PHP SDK in to your project. +If not, go back to the master README for instructions. + +There is currently one utility provided. + +OptInHandler: Provides methods for authenticating an OptInRequest. + +The typical flow for using this utility would be as follows: +**Recipient Requests Subscribe** -> [Validate Recipient Address] -> [Generate Opt In Link] -> [Email Recipient Opt In Link] +**Recipient Clicks Opt In Link** -> [Validate Opt In Link] -> [Subscribe User] -> [Send final confirmation] + +The above flow is modeled below. + +Usage - Opt-In Handler (Recipient Requests Subscribe) +----------------------------------------------------- +Here's how to use Opt-In Handler to validate Opt-In requests. + +```php +# First, instantiate the SDK with your API credentials, domain, and required parameters for example. +$mg = new Mailgun('key-example'); +$mgValidate = new Mailgun('pub-key-example'); + +$domain = 'example.com'; +$mailingList = 'youlist@example.com'; +$secretPassphrase = 'a_secret_passphrase'; +$recipientAddress = 'recipient@example.com'; + +# Let's validate the customer's email address, using Mailgun's validation endpoint. +$result = $mgValidate->get('address/validate', array('address' => $recipientAddress)); + +if($result->http_response_body->is_valid == true){ + # Next, instantiate an OptInHandler object from the SDK. + $optInHandler = $mg->OptInHandler(); + + # Next, generate a hash. + $generatedHash = $optInHandler->generateHash($mailingList, $secretPassphrase, $recipientAddress); + + # Now, let's send a confirmation to the recipient with our link. + $mg->sendMessage($domain, array('from' => 'bob@example.com', + 'to' => $recipientAddress, + 'subject' => 'Please Confirm!', + 'html' => "Hello,

    You have requested to be subscribed + to the mailing list $mailingList. Please     + confirm your subscription.

    Thank you!")); + + # Finally, let's add the subscriber to a Mailing List, as unsubscribed, so we can track non-conversions. + $mg->post("lists/$mailingList/members", array('address' => $recipientAddress, + 'subscribed' => 'no', + 'upsert' => 'yes')); +} +``` + +Usage - Opt-In Handler (Recipient Clicks Opt In Link) +----------------------------------------------------- +Here's how to use Opt-In Handler to validate an Opt-In Hash. + +```php +# First, instantiate the SDK with your API credentials and domain. +$mg = new Mailgun('key-example'); +$domain = 'example.com'; + +# Next, instantiate an OptInHandler object from the SDK. +$optInHandler = $mg->OptInHandler(); + +# Next, grab the hash. +$inboundHash = $_GET['hash']; +$secretPassphrase = 'a_secret_passphrase'; + +# Now, validate the captured hash. +$hashValidation = $optInHandler->validateHash($secretPassphrase, $inboundHash); + +# Lastly, check to see if we have results, parse, subscribe, and send confirmation. +if($hashValidation){ + $validatedList = $hashValidation['mailingList']; + $validatedRecipient = $hashValidation['recipientAddress']; + + $mg->put("lists/$validatedList/members/$validatedRecipient", + array('address' => $validatedRecipient, + 'subscribed' => 'yes')); + + $mg->sendMessage($domain, array('from' => 'bob@example.com', + 'to' => $validatedRecipient, + 'subject' => 'Confirmation Received!', + 'html' => "Hello,

    We've successfully subscribed + you to the list, $validatedList!

    Thank you! + ")); +} +``` + +A few notes: +1. 'a_secret_passphrase' can be anything. It's used as the *key* in hashing, +since your email address will vary. +2. validateHash() will return an array containing the recipient address and list +address. +3. You should *always* send an email confirmation before and after the +subscription request. +4. WARNING: On $_GET['hash'], you need to sanitize this value to prevent +malicious attempts to inject code. + +Available Functions +----------------------------------------------------- + +`string generateHash(string $mailingList, string $secretAppId, string $recipientAddress)` + +`array validateHash(string $secretAppId, string $uniqueHash)` + +More Documentation +------------------ +See the official [Mailgun Docs](http://documentation.mailgun.com/api-sending.html) +for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Mailgun.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Mailgun.php new file mode 100644 index 0000000..a81ae2d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Mailgun.php @@ -0,0 +1,381 @@ +apiKey = $apiKey; + $this->restClient = new RestClient($apiKey, $apiEndpoint, $httpClient); + + $this->httpClient = $httpClient; + $this->requestBuilder = $requestBuilder ?: new RequestBuilder(); + $this->hydrator = $hydrator ?: new ModelHydrator(); + } + + /** + * @param HttpClientConfigurator $configurator + * @param Hydrator|null $hydrator + * @param RequestBuilder|null $requestBuilder + * + * @return Mailgun + */ + public static function configure( + HttpClientConfigurator $configurator, + Hydrator $hydrator = null, + RequestBuilder $requestBuilder = null + ) { + $httpClient = $configurator->createConfiguredClient(); + + return new self($configurator->getApiKey(), $httpClient, 'api.mailgun.net', $hydrator, $requestBuilder); + } + + /** + * @param string $apiKey + * + * @return Mailgun + */ + public static function create($apiKey) + { + $httpClientConfigurator = (new HttpClientConfigurator())->setApiKey($apiKey); + + return self::configure($httpClientConfigurator); + } + + /** + * This function allows the sending of a fully formed message OR a custom + * MIME string. If sending MIME, the string must be passed in to the 3rd + * position of the function call. + * + * @param string $workingDomain + * @param array $postData + * @param array $postFiles + * + * @throws Exceptions\MissingRequiredMIMEParameters + * + * @return \stdClass + * + * @deprecated Use Mailgun->message() instead. Will be removed in 3.0 + */ + public function sendMessage($workingDomain, $postData, $postFiles = []) + { + if (is_array($postFiles)) { + return $this->post("$workingDomain/messages", $postData, $postFiles); + } elseif (is_string($postFiles)) { + $tempFile = tempnam(sys_get_temp_dir(), 'MG_TMP_MIME'); + $fileHandle = fopen($tempFile, 'w'); + fwrite($fileHandle, $postFiles); + + $result = $this->post("$workingDomain/messages.mime", $postData, ['message' => $tempFile]); + fclose($fileHandle); + unlink($tempFile); + + return $result; + } else { + throw new Exceptions\MissingRequiredMIMEParameters(ExceptionMessages::EXCEPTION_MISSING_REQUIRED_MIME_PARAMETERS); + } + } + + /** + * This function checks the signature in a POST request to see if it is + * authentic. + * + * Pass an array of parameters. If you pass nothing, $_POST will be + * used instead. + * + * If this function returns FALSE, you must not process the request. + * You should reject the request with status code 403 Forbidden. + * + * @param array|null $postData + * + * @return bool + * + * @deprecated Use Mailgun->webhook() instead. Will be removed in 3.0 + */ + public function verifyWebhookSignature($postData = null) + { + if ($postData === null) { + $postData = $_POST; + } + if (!isset($postData['timestamp']) || !isset($postData['token']) || !isset($postData['signature'])) { + return false; + } + $hmac = hash_hmac('sha256', "{$postData['timestamp']}{$postData['token']}", $this->apiKey); + $sig = $postData['signature']; + if (function_exists('hash_equals')) { + // hash_equals is constant time, but will not be introduced until PHP 5.6 + return hash_equals($hmac, $sig); + } else { + return $hmac === $sig; + } + } + + /** + * @return ResponseInterface|null + */ + public function getLastResponse() + { + return $this->responseHistory->getLastResponse(); + } + + /** + * @param string $endpointUrl + * @param array $postData + * @param array $files + * + * @return \stdClass + * + * @deprecated Will be removed in 3.0 + */ + public function post($endpointUrl, $postData = [], $files = []) + { + return $this->restClient->post($endpointUrl, $postData, $files); + } + + /** + * @param string $endpointUrl + * @param array $queryString + * + * @return \stdClass + * + * @deprecated Will be removed in 3.0 + */ + public function get($endpointUrl, $queryString = []) + { + return $this->restClient->get($endpointUrl, $queryString); + } + + /** + * @param string $url + * + * @return \stdClass + * + * @deprecated Will be removed in 3.0 + */ + public function getAttachment($url) + { + return $this->restClient->getAttachment($url); + } + + /** + * @param string $endpointUrl + * + * @return \stdClass + * + * @deprecated Will be removed in 3.0 + */ + public function delete($endpointUrl) + { + return $this->restClient->delete($endpointUrl); + } + + /** + * @param string $endpointUrl + * @param array $putData + * + * @return \stdClass + * + * @deprecated Will be removed in 3.0 + */ + public function put($endpointUrl, $putData) + { + return $this->restClient->put($endpointUrl, $putData); + } + + /** + * @param string $apiVersion + * + * @return Mailgun + * + * @deprecated Will be removed in 3.0 + */ + public function setApiVersion($apiVersion) + { + $this->restClient->setApiVersion($apiVersion); + + return $this; + } + + /** + * @param bool $sslEnabled + * + * @return Mailgun + * + * @deprecated This will be removed in 3.0. Mailgun does not support non-secure connections to their API. + */ + public function setSslEnabled($sslEnabled) + { + $this->restClient->setSslEnabled($sslEnabled); + + return $this; + } + + /** + * @return MessageBuilder + * + * @deprecated Will be removed in 3.0 + */ + public function MessageBuilder() + { + return new MessageBuilder(); + } + + /** + * @return OptInHandler + * + * @deprecated Will be removed in 3.0 + */ + public function OptInHandler() + { + return new OptInHandler(); + } + + /** + * @param string $workingDomain + * @param bool $autoSend + * + * @return BatchMessage + * + * @deprecated Will be removed in 3.0 + */ + public function BatchMessage($workingDomain, $autoSend = true) + { + return new BatchMessage($this->restClient, $workingDomain, $autoSend); + } + + /** + * @return Api\Stats + */ + public function stats() + { + return new Api\Stats($this->httpClient, $this->requestBuilder, $this->hydrator); + } + + /** + * @return Api\Domain + */ + public function domains() + { + return new Api\Domain($this->httpClient, $this->requestBuilder, $this->hydrator); + } + + /** + * @return Api\Tag + */ + public function tags() + { + return new Api\Tag($this->httpClient, $this->requestBuilder, $this->hydrator); + } + + /** + * @return Api\Event + */ + public function events() + { + return new Api\Event($this->httpClient, $this->requestBuilder, $this->hydrator); + } + + /** + * @return Api\Route + */ + public function routes() + { + return new Api\Route($this->httpClient, $this->requestBuilder, $this->hydrator); + } + + /** + * @return Api\Webhook + */ + public function webhooks() + { + return new Api\Webhook($this->httpClient, $this->requestBuilder, $this->hydrator, $this->apiKey); + } + + /** + * @return Api\Message + */ + public function messages() + { + return new Api\Message($this->httpClient, $this->requestBuilder, $this->hydrator); + } + + /** + * @return Api\Suppression + */ + public function suppressions() + { + return new Api\Suppression($this->httpClient, $this->requestBuilder, $this->hydrator); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/BatchMessage.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/BatchMessage.php new file mode 100644 index 0000000..36de030 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/BatchMessage.php @@ -0,0 +1,154 @@ +batchRecipientAttributes = []; + $this->autoSend = $autoSend; + $this->restClient = $restClient; + $this->workingDomain = $workingDomain; + $this->endpointUrl = $workingDomain.'/messages'; + } + + /** + * @param string $headerName + * @param string $address + * @param array $variables + * + * @throws MissingRequiredMIMEParameters + * @throws TooManyParameters + */ + protected function addRecipient($headerName, $address, $variables) + { + if (array_key_exists($headerName, $this->counters['recipients'])) { + if ($this->counters['recipients'][$headerName] == Api::RECIPIENT_COUNT_LIMIT) { + if (false === $this->autoSend) { + throw new TooManyParameters(ExceptionMessages::TOO_MANY_RECIPIENTS); + } + $this->sendMessage(); + } + } + + $compiledAddress = $this->parseAddress($address, $variables); + + if (isset($this->message[$headerName])) { + array_push($this->message[$headerName], $compiledAddress); + } elseif ($headerName == 'h:reply-to') { + $this->message[$headerName] = $compiledAddress; + } else { + $this->message[$headerName] = [$compiledAddress]; + } + + if (array_key_exists($headerName, $this->counters['recipients'])) { + $this->counters['recipients'][$headerName] += 1; + if (is_array($variables) && !array_key_exists('id', $variables)) { + $variables['id'] = $this->counters['recipients'][$headerName]; + } + } + $this->batchRecipientAttributes["$address"] = $variables; + } + + /** + * @param array $message + * @param array $files + * + * @throws MissingRequiredMIMEParameters + */ + public function sendMessage($message = [], $files = []) + { + if (count($message) < 1) { + $message = $this->message; + $files = $this->files; + } + if (!array_key_exists('from', $message)) { + throw new MissingRequiredMIMEParameters(ExceptionMessages::EXCEPTION_MISSING_REQUIRED_MIME_PARAMETERS); + } elseif (!array_key_exists('to', $message)) { + throw new MissingRequiredMIMEParameters(ExceptionMessages::EXCEPTION_MISSING_REQUIRED_MIME_PARAMETERS); + } elseif (!array_key_exists('subject', $message)) { + throw new MissingRequiredMIMEParameters(ExceptionMessages::EXCEPTION_MISSING_REQUIRED_MIME_PARAMETERS); + } elseif ((!array_key_exists('text', $message) && !array_key_exists('html', $message))) { + throw new MissingRequiredMIMEParameters(ExceptionMessages::EXCEPTION_MISSING_REQUIRED_MIME_PARAMETERS); + } else { + $message['recipient-variables'] = json_encode($this->batchRecipientAttributes); + $response = $this->restClient->post($this->endpointUrl, $message, $files); + $this->batchRecipientAttributes = []; + $this->counters['recipients']['to'] = 0; + $this->counters['recipients']['cc'] = 0; + $this->counters['recipients']['bcc'] = 0; + unset($this->message['to']); + array_push($this->messageIds, $response->http_response_body->id); + } + } + + /** + * @throws MissingRequiredMIMEParameters + */ + public function finalize() + { + $this->sendMessage(); + } + + /** + * @return string[] + */ + public function getMessageIds() + { + return $this->messageIds; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/Exceptions/InvalidParameter.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/Exceptions/InvalidParameter.php new file mode 100644 index 0000000..9520e41 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/Exceptions/InvalidParameter.php @@ -0,0 +1,16 @@ + [ + 'to' => 0, + 'cc' => 0, + 'bcc' => 0, + ], + 'attributes' => [ + 'attachment' => 0, + 'campaign_id' => 0, + 'custom_option' => 0, + 'tag' => 0, + ], + ]; + + /** + * @param array $params + * @param string $key + * @param mixed $default + * + * @return mixed + */ + protected function safeGet($params, $key, $default) + { + if (array_key_exists($key, $params)) { + return $params[$key]; + } + + return $default; + } + + /** + * @param array $params + * + * @return mixed|string + */ + protected function getFullName($params) + { + if (array_key_exists('first', $params)) { + $first = $this->safeGet($params, 'first', ''); + $last = $this->safeGet($params, 'last', ''); + + return trim("$first $last"); + } + + return $this->safeGet($params, 'full_name', ''); + } + + /** + * @param string $address + * @param array $variables + * + * @return string + */ + protected function parseAddress($address, $variables) + { + if (!is_array($variables)) { + return $address; + } + $fullName = $this->getFullName($variables); + if ($fullName != null) { + return sprintf('"%s" <%s>', $fullName, $address); + } + + return $address; + } + + /** + * @param string $headerName + * @param string $address + * @param array $variables + */ + protected function addRecipient($headerName, $address, $variables) + { + $compiledAddress = $this->parseAddress($address, $variables); + + if ($headerName === 'h:reply-to') { + $this->message[$headerName] = $compiledAddress; + } elseif (isset($this->message[$headerName])) { + array_push($this->message[$headerName], $compiledAddress); + } else { + $this->message[$headerName] = [$compiledAddress]; + } + if (array_key_exists($headerName, $this->counters['recipients'])) { + $this->counters['recipients'][$headerName] += 1; + } + } + + /** + * @param string $address + * @param array|null $variables + * + * @throws TooManyParameters + * + * @return mixed + */ + public function addToRecipient($address, $variables = null) + { + if ($this->counters['recipients']['to'] > Api::RECIPIENT_COUNT_LIMIT) { + throw new TooManyParameters(ExceptionMessages::TOO_MANY_PARAMETERS_RECIPIENT); + } + + $variables = is_array($variables) ? $variables : []; + + $this->addRecipient('to', $address, $variables); + + return end($this->message['to']); + } + + /** + * @param string $address + * @param array|null $variables + * + * @throws TooManyParameters + * + * @return mixed + */ + public function addCcRecipient($address, $variables = null) + { + if ($this->counters['recipients']['cc'] > Api::RECIPIENT_COUNT_LIMIT) { + throw new TooManyParameters(ExceptionMessages::TOO_MANY_PARAMETERS_RECIPIENT); + } + + $variables = is_array($variables) ? $variables : []; + + $this->addRecipient('cc', $address, $variables); + + return end($this->message['cc']); + } + + /** + * @param string $address + * @param array|null $variables + * + * @throws TooManyParameters + * + * @return mixed + */ + public function addBccRecipient($address, $variables = null) + { + if ($this->counters['recipients']['bcc'] > Api::RECIPIENT_COUNT_LIMIT) { + throw new TooManyParameters(ExceptionMessages::TOO_MANY_PARAMETERS_RECIPIENT); + } + + $variables = is_array($variables) ? $variables : []; + + $this->addRecipient('bcc', $address, $variables); + + return end($this->message['bcc']); + } + + /** + * @param string $address + * @param array|null $variables + * + * @return mixed + */ + public function setFromAddress($address, $variables = null) + { + $variables = is_array($variables) ? $variables : []; + + $this->addRecipient('from', $address, $variables); + + return $this->message['from']; + } + + /** + * @param string $address + * @param array|null $variables + * + * @return mixed + */ + public function setReplyToAddress($address, $variables = null) + { + $variables = is_array($variables) ? $variables : []; + + $this->addRecipient('h:reply-to', $address, $variables); + + return $this->message['h:reply-to']; + } + + /** + * @param string $subject + * + * @return mixed + */ + public function setSubject($subject = '') + { + if ($subject == null || $subject == '') { + $subject = ' '; + } + $this->message['subject'] = $subject; + + return $this->message['subject']; + } + + /** + * @param string $headerName + * @param mixed $headerData + * + * @return mixed + */ + public function addCustomHeader($headerName, $headerData) + { + if (!preg_match('/^h:/i', $headerName)) { + $headerName = 'h:'.$headerName; + } + + if (array_key_exists($headerName, $this->message)) { + if (is_array($this->message[$headerName])) { + $this->message[$headerName][] = $headerData; + } else { + $this->message[$headerName] = [$this->message[$headerName], $headerData]; + } + } else { + $this->message[$headerName] = $headerData; + } + + return $this->message[$headerName]; + } + + /** + * @param string $textBody + * + * @return string + */ + public function setTextBody($textBody) + { + if ($textBody == null || $textBody == '') { + $textBody = ' '; + } + $this->message['text'] = $textBody; + + return $this->message['text']; + } + + /** + * @param string $htmlBody + * + * @return string + */ + public function setHtmlBody($htmlBody) + { + if ($htmlBody == null || $htmlBody == '') { + $htmlBody = ' '; + } + $this->message['html'] = $htmlBody; + + return $this->message['html']; + } + + /** + * @param string $attachmentPath + * @param string|null $attachmentName + * + * @return bool + */ + public function addAttachment($attachmentPath, $attachmentName = null) + { + if (isset($this->files['attachment'])) { + $attachment = [ + 'filePath' => $attachmentPath, + 'remoteName' => $attachmentName, + ]; + array_push($this->files['attachment'], $attachment); + } else { + $this->files['attachment'] = [ + [ + 'filePath' => $attachmentPath, + 'remoteName' => $attachmentName, + ], + ]; + } + + return true; + } + + /** + * @param string $inlineImagePath + * @param string|null $inlineImageName + * + * @throws InvalidParameter + * + * @return bool + */ + public function addInlineImage($inlineImagePath, $inlineImageName = null) + { + if (strpos($inlineImagePath, '@') !== 0) { + throw new InvalidParameter(ExceptionMessages::INVALID_PARAMETER_INLINE); + } + + $this->files['inline'][] = [ + 'filePath' => $inlineImagePath, + 'remoteName' => $inlineImageName, + ]; + + return true; + } + + /** + * @param bool $testMode + * + * @return string + */ + public function setTestMode($testMode) + { + if (filter_var($testMode, FILTER_VALIDATE_BOOLEAN)) { + $testMode = 'yes'; + } else { + $testMode = 'no'; + } + $this->message['o:testmode'] = $testMode; + + return $this->message['o:testmode']; + } + + /** + * @param string|int $campaignId + * + * @throws TooManyParameters + * + * @return string|int + */ + public function addCampaignId($campaignId) + { + if ($this->counters['attributes']['campaign_id'] < Api::CAMPAIGN_ID_LIMIT) { + if (isset($this->message['o:campaign'])) { + array_push($this->message['o:campaign'], $campaignId); + } else { + $this->message['o:campaign'] = [$campaignId]; + } + $this->counters['attributes']['campaign_id'] += 1; + + return $this->message['o:campaign']; + } else { + throw new TooManyParameters(ExceptionMessages::TOO_MANY_PARAMETERS_CAMPAIGNS); + } + } + + /** + * @param string $tag + * + * @throws TooManyParameters + */ + public function addTag($tag) + { + if ($this->counters['attributes']['tag'] < Api::TAG_LIMIT) { + if (isset($this->message['o:tag'])) { + array_push($this->message['o:tag'], $tag); + } else { + $this->message['o:tag'] = [$tag]; + } + $this->counters['attributes']['tag'] += 1; + + return $this->message['o:tag']; + } else { + throw new TooManyParameters(ExceptionMessages::TOO_MANY_PARAMETERS_TAGS); + } + } + + /** + * @param bool $enabled + * + * @return mixed + */ + public function setDkim($enabled) + { + if (filter_var($enabled, FILTER_VALIDATE_BOOLEAN)) { + $enabled = 'yes'; + } else { + $enabled = 'no'; + } + $this->message['o:dkim'] = $enabled; + + return $this->message['o:dkim']; + } + + /** + * @param bool $enabled + * + * @return string + */ + public function setOpenTracking($enabled) + { + if (filter_var($enabled, FILTER_VALIDATE_BOOLEAN)) { + $enabled = 'yes'; + } else { + $enabled = 'no'; + } + $this->message['o:tracking-opens'] = $enabled; + + return $this->message['o:tracking-opens']; + } + + /** + * @param bool $enabled + * + * @return string + */ + public function setClickTracking($enabled) + { + if (filter_var($enabled, FILTER_VALIDATE_BOOLEAN)) { + $enabled = 'yes'; + } elseif ($enabled == 'html') { + $enabled = 'html'; + } else { + $enabled = 'no'; + } + $this->message['o:tracking-clicks'] = $enabled; + + return $this->message['o:tracking-clicks']; + } + + /** + * @param string $timeDate + * @param string|null $timeZone + * + * @return string + */ + public function setDeliveryTime($timeDate, $timeZone = null) + { + if (isset($timeZone)) { + $timeZoneObj = new \DateTimeZone("$timeZone"); + } else { + $timeZoneObj = new \DateTimeZone(Api::DEFAULT_TIME_ZONE); + } + + $dateTimeObj = new \DateTime($timeDate, $timeZoneObj); + $formattedTimeDate = $dateTimeObj->format(\DateTime::RFC2822); + $this->message['o:deliverytime'] = $formattedTimeDate; + + return $this->message['o:deliverytime']; + } + + /** + * @param string $customName + * @param mixed $data + */ + public function addCustomData($customName, $data) + { + $this->message['v:'.$customName] = json_encode($data); + } + + /** + * @param string $parameterName + * @param mixed $data + * + * @return mixed + */ + public function addCustomParameter($parameterName, $data) + { + if (isset($this->message[$parameterName])) { + array_push($this->message[$parameterName], $data); + + return $this->message[$parameterName]; + } else { + $this->message[$parameterName] = [$data]; + + return $this->message[$parameterName]; + } + } + + /** + * @param array $message + */ + public function setMessage($message) + { + $this->message = $message; + } + + /** + * @return array + */ + public function getMessage() + { + return $this->message; + } + + /** + * @return array + */ + public function getFiles() + { + return $this->files; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/README.md b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/README.md new file mode 100644 index 0000000..34cab45 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Messages/README.md @@ -0,0 +1,138 @@ +Mailgun - Messages +==================== + +This is the Mailgun PHP *Message* utilities. + +The below assumes you've already installed the Mailgun PHP SDK in to your +project. If not, go back to the master README for instructions. + +There are two utilities included, Message Builder and Batch Message. + +Message Builder: Allows you to build a message object by calling methods for +each MIME attribute. +Batch Message: Inherits Message Builder and allows you to iterate through +recipients from a list. Messages will fire after the 1,000th recipient has been +added. + +Usage - Message Builder +----------------------- +Here's how to use Message Builder to build your Message. + +```php +# First, instantiate the SDK with your API credentials and define your domain. +$mg = new Mailgun("key-example"); +$domain = "example.com"; + +# Next, instantiate a Message Builder object from the SDK. +$messageBldr = $mg->MessageBuilder(); + +# Define the from address. +$messageBldr->setFromAddress("me@example.com", array("first"=>"PHP", "last" => "SDK")); +# Define a to recipient. +$messageBldr->addToRecipient("john.doe@example.com", array("first" => "John", "last" => "Doe")); +# Define a cc recipient. +$messageBldr->addCcRecipient("sally.doe@example.com", array("first" => "Sally", "last" => "Doe")); +# Define the subject. +$messageBldr->setSubject("A message from the PHP SDK using Message Builder!"); +# Define the body of the message. +$messageBldr->setTextBody("This is the text body of the message!"); + +# Other Optional Parameters. +$messageBldr->addCampaignId("My-Awesome-Campaign"); +$messageBldr->addCustomHeader("Customer-Id", "12345"); +$messageBldr->addAttachment("@/tron.jpg"); +$messageBldr->setDeliveryTime("tomorrow 8:00AM", "PST"); +$messageBldr->setClickTracking(true); + +# Finally, send the message. +$mg->post("{$domain}/messages", $messageBldr->getMessage(), $messageBldr->getFiles()); +``` + +Available Functions +----------------------------------------------------- + +`string addToRecipient(string $address, array $attributes)` + +`string addCcRecipient(string $address, array $attributes)` + +`string addBccRecipient(string $address, array $attributes)` + +`string setFromAddress(string $address, array $attributes)` + +`string setSubject(string $subject)` + +`string setTextBody(string $textBody)` + +`string setHtmlBody(string $htmlBody)` + +`bool addAttachment(string $attachmentPath, $attachmentName = null)` + +`bool addInlineImage(string $inlineImagePath)` + +`string setTestMode(bool $testMode)` + +`string addCampaignId(string $campaignId)` + +`string setDkim(bool $enabled)` + +`string setOpenTracking($enabled)` + +`string setClickTracking($enabled)` + +`string setDeliveryTime(string $timeDate, string $timeZone)` + +`string addCustomData(string $optionName, string $data)` + +`string addCustomParameter(string $parameterName, string $data)` + +`array getMessage()` + +`array getFiles()` + + +Usage - Batch Message +--------------------- +Here's how to use Batch Message to easily handle batch sending jobs. + +```php +# First, instantiate the SDK with your API credentials and define your domain. +$mg = new Mailgun("key-example"); +$domain = "example.com"; + +# Next, instantiate a Message Builder object from the SDK, pass in your sending +domain. +$batchMsg = $mg->BatchMessage($domain); + +# Define the from address. +$batchMsg->setFromAddress("me@example.com", array("first"=>"PHP", "last" => "SDK")); +# Define the subject. +$batchMsg->setSubject("A Batch Message from the PHP SDK!"); +# Define the body of the message. +$batchMsg->setTextBody("This is the text body of the message!"); + +# Next, let's add a few recipients to the batch job. +$batchMsg->addToRecipient("john.doe@example.com", array("first" => "John", "last" => "Doe")); +$batchMsg->addToRecipient("sally.doe@example.com", array("first" => "Sally", "last" => "Doe")); +$batchMsg->addToRecipient("mike.jones@example.com", array("first" => "Mike", "last" => "Jones")); +... +// After 1,000 recipients, Batch Message will automatically post your message to +the messages endpoint. + +// Call finalize() to send any remaining recipients still in the buffer. +$batchMsg->finalize(); + +``` + +Available Functions (Inherits all Batch Message and Messages Functions) +----------------------------------------------------------------------- + +`addToRecipient(string $address, string $attributes)` + +`sendMessage(array $message, array $files)` + +`array finalize()` + +More Documentation +------------------ +See the official [Mailgun Docs](http://documentation.mailgun.com/api-sending.html) +for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/ApiResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/ApiResponse.php new file mode 100644 index 0000000..b176214 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/ApiResponse.php @@ -0,0 +1,25 @@ + + */ +interface ApiResponse +{ + /** + * Create an API response object from the HTTP response from the API server. + * + * @param array $data + * + * @return self + */ + public static function create(array $data); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/ConnectionResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/ConnectionResponse.php new file mode 100644 index 0000000..a145d73 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/ConnectionResponse.php @@ -0,0 +1,72 @@ + + */ +final class ConnectionResponse implements ApiResponse +{ + /** + * @var bool + */ + private $noVerify; + + /** + * @var bool + */ + private $requireTLS; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + if (!isset($data['connection'])) { + return; + } + $connSettings = $data['connection']; + + return new self( + isset($connSettings['skip_verification']) ? $connSettings['skip_verification'] : null, + isset($connSettings['require_tls']) ? $connSettings['require_tls'] : null + ); + } + + /** + * @param bool $noVerify Disable remote TLS certificate verification + * @param bool $requireTLS Requires TLS for all outbound communication + */ + private function __construct($noVerify, $requireTLS) + { + $this->noVerify = $noVerify; + $this->requireTLS = $requireTLS; + } + + /** + * @return bool + */ + public function getSkipVerification() + { + return $this->noVerify; + } + + /** + * @return bool + */ + public function getRequireTLS() + { + return $this->requireTLS; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CreateCredentialResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CreateCredentialResponse.php new file mode 100644 index 0000000..1e6afe6 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CreateCredentialResponse.php @@ -0,0 +1,49 @@ + + */ +final class CreateCredentialResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @param string $message + */ + private function __construct($message) + { + $this->message = $message; + } + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + return new self(isset($data['message']) ? $data['message'] : null); + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CreateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CreateResponse.php new file mode 100644 index 0000000..7fa1f4d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CreateResponse.php @@ -0,0 +1,119 @@ + + */ +final class CreateResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @var Domain + */ + private $domain; + + /** + * @var DnsRecord[] + */ + private $inboundDnsRecords; + + /** + * @var DnsRecord[] + */ + private $outboundDnsRecords; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $rx = []; + $tx = []; + $domain = null; + $message = null; + + if (isset($data['domain'])) { + $domain = Domain::create($data['domain']); + } + + if (isset($data['message'])) { + $message = $data['message']; + } + + if (isset($data['receiving_dns_records'])) { + foreach ($data['receiving_dns_records'] as $item) { + $rx[] = DnsRecord::create($item); + } + } + + if (isset($data['sending_dns_records'])) { + foreach ($data['sending_dns_records'] as $item) { + $tx[] = DnsRecord::create($item); + } + } + + return new self($domain, $rx, $tx, $message); + } + + /** + * @param Domain $domainInfo + * @param DnsRecord[] $rxRecords + * @param DnsRecord[] $txRecords + * @param string $message + */ + private function __construct(Domain $domainInfo, array $rxRecords, array $txRecords, $message) + { + $this->domain = $domainInfo; + $this->inboundDnsRecords = $rxRecords; + $this->outboundDnsRecords = $txRecords; + $this->message = $message; + } + + /** + * @return Domain + */ + public function getDomain() + { + return $this->domain; + } + + /** + * @return DnsRecord[] + */ + public function getInboundDNSRecords() + { + return $this->inboundDnsRecords; + } + + /** + * @return DnsRecord[] + */ + public function getOutboundDNSRecords() + { + return $this->outboundDnsRecords; + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CredentialResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CredentialResponse.php new file mode 100644 index 0000000..5706572 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CredentialResponse.php @@ -0,0 +1,77 @@ + + */ +final class CredentialResponse implements ApiResponse +{ + /** + * @var int + */ + private $totalCount; + + /** + * @var CredentialResponseItem[] + */ + private $items; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $items = []; + if (isset($data['items'])) { + foreach ($data['items'] as $item) { + $items[] = CredentialResponseItem::create($item); + } + } + + if (isset($data['total_count'])) { + $count = $data['total_count']; + } else { + $count = count($items); + } + + return new self($count, $items); + } + + /** + * @param int $totalCount + * @param CredentialResponseItem[] $items + */ + private function __construct($totalCount, array $items) + { + $this->totalCount = $totalCount; + $this->items = $items; + } + + /** + * @return int + */ + public function getTotalCount() + { + return $this->totalCount; + } + + /** + * @return CredentialResponseItem[] + */ + public function getCredentials() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CredentialResponseItem.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CredentialResponseItem.php new file mode 100644 index 0000000..c19a85a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/CredentialResponseItem.php @@ -0,0 +1,97 @@ + + */ +final class CredentialResponseItem +{ + /** + * @var int|null + */ + private $sizeBytes; + + /** + * @var \DateTime + */ + private $createdAt; + + /** + * @var string + */ + private $mailbox; + + /** + * @var string + */ + private $login; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $sizeBytes = isset($data['size_bytes']) ? $data['size_bytes'] : null; + $mailbox = isset($data['mailbox']) ? $data['mailbox'] : null; + $login = isset($data['login']) ? $data['login'] : null; + $createdAt = isset($data['created_at']) ? new \DateTime($data['created_at']) : null; + + return new self($sizeBytes, $createdAt, $mailbox, $login); + } + + /** + * @param int $sizeBytes + * @param \DateTime $createdAt + * @param string $mailbox + * @param string $login + */ + private function __construct($sizeBytes, \DateTime $createdAt, $mailbox, $login) + { + $this->sizeBytes = $sizeBytes; + $this->createdAt = $createdAt; + $this->mailbox = $mailbox; + $this->login = $login; + } + + /** + * @return int|null + */ + public function getSizeBytes() + { + return $this->sizeBytes; + } + + /** + * @return \DateTime + */ + public function getCreatedAt() + { + return $this->createdAt; + } + + /** + * @return string + */ + public function getMailbox() + { + return $this->mailbox; + } + + /** + * @return string + */ + public function getLogin() + { + return $this->login; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DeleteCredentialResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DeleteCredentialResponse.php new file mode 100644 index 0000000..2cd8625 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DeleteCredentialResponse.php @@ -0,0 +1,83 @@ + + */ +final class DeleteCredentialResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @var string + */ + private $error; + + /** + * @var string + */ + private $spec; + + /** + * @param string $message + * @param string $error + * @param string $spec + */ + private function __construct($message, $error, $spec) + { + $this->message = $message; + $this->error = $error; + $this->spec = $spec; + } + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + return new self( + isset($data['message']) ? $data['message'] : null, + isset($data['error']) ? $data['error'] : null, + isset($data['spec']) ? $data['spec'] : null + ); + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } + + /** + * @return string + */ + public function getError() + { + return $this->error; + } + + /** + * @return string + */ + public function getSpec() + { + return $this->spec; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DeleteResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DeleteResponse.php new file mode 100644 index 0000000..e48fc61 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DeleteResponse.php @@ -0,0 +1,67 @@ + + */ +final class DeleteResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @var string + */ + private $error; + + /** + * @param string $message + * @param string $error + */ + private function __construct($message, $error) + { + $this->message = $message; + $this->error = $error; + } + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + return new self( + isset($data['message']) ? $data['message'] : null, + isset($data['error']) ? $data['error'] : null + ); + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } + + /** + * @return string + */ + public function getError() + { + return $this->error; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DnsRecord.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DnsRecord.php new file mode 100644 index 0000000..b6eb914 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/DnsRecord.php @@ -0,0 +1,123 @@ + + */ +final class DnsRecord +{ + /** + * @var string|null + */ + private $name; + + /** + * @var string + */ + private $type; + + /** + * @var string + */ + private $value; + + /** + * @var string|null + */ + private $priority; + + /** + * @var string + */ + private $valid; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $name = isset($data['name']) ? $data['name'] : null; + $priority = isset($data['priority']) ? $data['priority'] : null; + $recordType = isset($data['record_type']) ? $data['record_type'] : null; + $value = isset($data['value']) ? $data['value'] : null; + $valid = isset($data['valid']) ? $data['valid'] : null; + + return new self($name, $recordType, $value, $priority, $valid); + } + + /** + * @param string|null $name Name of the record, as used in CNAME, etc. + * @param string $type DNS record type + * @param string $value DNS record value + * @param string|null $priority Record priority, used for MX + * @param string $valid DNS record has been added to domain DNS? + */ + private function __construct($name, $type, $value, $priority, $valid) + { + $this->name = $name; + $this->type = $type; + $this->value = $value; + $this->priority = $priority; + $this->valid = $valid; + } + + /** + * @return string|null + */ + public function getName() + { + return $this->name; + } + + /** + * @return string + */ + public function getType() + { + return $this->type; + } + + /** + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * @return string|null + */ + public function getPriority() + { + return $this->priority; + } + + /** + * @return bool + */ + public function isValid() + { + return 'valid' === $this->valid; + } + + /** + * @return string + */ + public function getValidity() + { + return $this->valid; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/Domain.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/Domain.php new file mode 100644 index 0000000..2182b39 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/Domain.php @@ -0,0 +1,147 @@ + + */ +final class Domain +{ + /** + * @var \DateTime + */ + private $createdAt; + + /** + * @var string + */ + private $smtpLogin; + + /** + * @var string + */ + private $name; + + /** + * @var string + */ + private $smtpPassword; + + /** + * @var bool + */ + private $wildcard; + + /** + * @var string + */ + private $spamAction; + + /** + * @var string + */ + private $state; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + return new self( + isset($data['name']) ? $data['name'] : null, + isset($data['smtp_login']) ? $data['smtp_login'] : null, + isset($data['smtp_password']) ? $data['smtp_password'] : null, + isset($data['wildcard']) ? $data['wildcard'] : null, + isset($data['spam_action']) ? $data['spam_action'] : null, + isset($data['state']) ? $data['state'] : null, + isset($data['created_at']) ? new \DateTime($data['created_at']) : null + ); + } + + /** + * @param string $name + * @param string $smtpLogin + * @param string $smtpPassword + * @param bool $wildcard + * @param string $spamAction + * @param string $state + * @param \DateTime $createdAt + */ + private function __construct($name, $smtpLogin, $smtpPassword, $wildcard, $spamAction, $state, \DateTime $createdAt) + { + $this->name = $name; + $this->smtpLogin = $smtpLogin; + $this->smtpPassword = $smtpPassword; + $this->wildcard = $wildcard; + $this->spamAction = $spamAction; + $this->state = $state; + $this->createdAt = $createdAt; + } + + /** + * @return string + */ + public function getName() + { + return $this->name; + } + + /** + * @return string + */ + public function getSmtpUsername() + { + return $this->smtpLogin; + } + + /** + * @return string + */ + public function getSmtpPassword() + { + return $this->smtpPassword; + } + + /** + * @return bool + */ + public function isWildcard() + { + return $this->wildcard; + } + + /** + * @return string + */ + public function getSpamAction() + { + return $this->spamAction; + } + + /** + * @return string + */ + public function getState() + { + return $this->state; + } + + /** + * @return \DateTime + */ + public function getCreatedAt() + { + return $this->createdAt; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/IndexResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/IndexResponse.php new file mode 100644 index 0000000..abd2cdc --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/IndexResponse.php @@ -0,0 +1,78 @@ + + */ +final class IndexResponse implements ApiResponse +{ + /** + * @var int + */ + private $totalCount; + + /** + * @var Domain[] + */ + private $items; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $items = []; + + if (isset($data['items'])) { + foreach ($data['items'] as $item) { + $items[] = Domain::create($item); + } + } + + if (isset($data['total_count'])) { + $count = $data['total_count']; + } else { + $count = count($items); + } + + return new self($count, $items); + } + + /** + * @param int $totalCount + * @param Domain[] $items + */ + private function __construct($totalCount, array $items) + { + $this->totalCount = $totalCount; + $this->items = $items; + } + + /** + * @return int + */ + public function getTotalCount() + { + return $this->totalCount; + } + + /** + * @return Domain[] + */ + public function getDomains() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/ShowResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/ShowResponse.php new file mode 100644 index 0000000..52e5c98 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/ShowResponse.php @@ -0,0 +1,99 @@ + + */ +final class ShowResponse implements ApiResponse +{ + /** + * @var Domain + */ + private $domain; + + /** + * @var DnsRecord[] + */ + private $inboundDnsRecords; + + /** + * @var DnsRecord[] + */ + private $outboundDnsRecords; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $rx = []; + $tx = []; + $domain = null; + + if (isset($data['domain'])) { + $domain = Domain::create($data['domain']); + } + + if (isset($data['receiving_dns_records'])) { + foreach ($data['receiving_dns_records'] as $item) { + $rx[] = DnsRecord::create($item); + } + } + + if (isset($data['sending_dns_records'])) { + foreach ($data['sending_dns_records'] as $item) { + $tx[] = DnsRecord::create($item); + } + } + + return new self($domain, $rx, $tx); + } + + /** + * @param Domain $domainInfo + * @param DnsRecord[] $rxRecords + * @param DnsRecord[] $txRecords + */ + private function __construct(Domain $domainInfo, array $rxRecords, array $txRecords) + { + $this->domain = $domainInfo; + $this->inboundDnsRecords = $rxRecords; + $this->outboundDnsRecords = $txRecords; + } + + /** + * @return Domain + */ + public function getDomain() + { + return $this->domain; + } + + /** + * @return DnsRecord[] + */ + public function getInboundDNSRecords() + { + return $this->inboundDnsRecords; + } + + /** + * @return DnsRecord[] + */ + public function getOutboundDNSRecords() + { + return $this->outboundDnsRecords; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/UpdateConnectionResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/UpdateConnectionResponse.php new file mode 100644 index 0000000..49f4fc6 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/UpdateConnectionResponse.php @@ -0,0 +1,83 @@ + + */ +final class UpdateConnectionResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @var bool + */ + private $noVerify; + + /** + * @var bool + */ + private $requireTLS; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $message = isset($data['message']) ? $data['message'] : null; + $noVerify = isset($data['skip_verification']) ? $data['skip_verification'] : null; + $requireTLS = isset($data['require_tls']) ? $data['require_tls'] : null; + + return new self($message, $noVerify, $requireTLS); + } + + /** + * @param string $message + * @param bool $noVerify + * @param bool $requireTLS + */ + private function __construct($message, $noVerify, $requireTLS) + { + $this->message = $message; + $this->noVerify = $noVerify; + $this->requireTLS = $requireTLS; + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } + + /** + * @return bool + */ + public function getSkipVerification() + { + return $this->noVerify; + } + + /** + * @return bool + */ + public function getRequireTLS() + { + return $this->requireTLS; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/UpdateCredentialResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/UpdateCredentialResponse.php new file mode 100644 index 0000000..8053a1b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Domain/UpdateCredentialResponse.php @@ -0,0 +1,49 @@ + + */ +final class UpdateCredentialResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @param string $message + */ + private function __construct($message) + { + $this->message = $message; + } + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + return new self(isset($data['message']) ? $data['message'] : null); + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Event/Event.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Event/Event.php new file mode 100644 index 0000000..71fcdcd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Event/Event.php @@ -0,0 +1,505 @@ + + */ +class Event +{ + /** + * @var string status + */ + private $event; + + /** + * @var string + */ + private $id; + + /** + * @var float + */ + private $timestamp; + + /** + * A \DateTime representation of $timestamp. + * + * @var \DateTime + */ + private $eventDate; + + /** + * @var array|string[] + */ + private $tags = []; + + /** + * @var string + */ + private $url; + + /** + * @var string + */ + private $severity; + + /** + * @var array + */ + private $envelope = []; + + /** + * @var array + */ + private $deliveryStatus; + + /** + * @var array|string[] + */ + private $campaigns = []; + + /** + * @var string + */ + private $ip; + + /** + * @var array + */ + private $clientInfo = []; + + /** + * @var string + */ + private $reason; + + /** + * @var array + */ + private $userVariables = []; + + /** + * @var array key=>bool + */ + private $flags = []; + + /** + * @var array multi dimensions + */ + private $routes = []; + + /** + * @var array multi dimensions + */ + private $message = []; + + /** + * @var string + */ + private $recipient; + + /** + * @var array + */ + private $geolocation = []; + + /** + * @var array + */ + private $storage = []; + + /** + * @var string + */ + private $method; + + /** + * @param string $event + * @param string $id + * @param float $timestamp + */ + public function __construct($event, $id, $timestamp) + { + $this->event = $event; + $this->id = $id; + $this->timestamp = $timestamp; + $this->eventDate = new \DateTime(); + $this->eventDate->setTimestamp((int) $timestamp); + } + + /** + * @param array $data + * + * @return Event + */ + public static function create(array $data) + { + $event = new self($data['event'], $data['id'], $data['timestamp']); + + if (isset($data['tags'])) { + $event->setTags($data['tags']); + } + if (isset($data['envelope'])) { + $event->setEnvelope($data['envelope']); + } + if (isset($data['campaigns'])) { + $event->setCampaigns($data['campaigns']); + } + if (isset($data['user-variables'])) { + $event->setUserVariables($data['user-variables']); + } + if (isset($data['flags'])) { + $event->setFlags($data['flags']); + } + if (isset($data['routes'])) { + $event->setRoutes($data['routes']); + } + if (isset($data['message'])) { + $event->setMessage($data['message']); + } + if (isset($data['recipient'])) { + $event->setRecipient($data['recipient']); + } + if (isset($data['method'])) { + $event->setMethod($data['method']); + } + if (isset($data['delivery-status'])) { + $event->setDeliveryStatus($data['delivery-status']); + } + if (isset($data['severity'])) { + $event->setSeverity($data['severity']); + } + if (isset($data['reason'])) { + $event->setReason($data['reason']); + } + if (isset($data['geolocation'])) { + $event->setGeolocation($data['geolocation']); + } + if (isset($data['ip'])) { + $event->setIp($data['ip']); + } + if (isset($data['client-info'])) { + $event->setClientInfo($data['client-info']); + } + if (isset($data['url'])) { + $event->setUrl($data['url']); + } + if (isset($data['storage'])) { + $event->setStorage($data['storage']); + } + + return $event; + } + + /** + * @return string + */ + public function getEvent() + { + return $this->event; + } + + /** + * @return string + */ + public function getId() + { + return $this->id; + } + + /** + * @return float + */ + public function getTimestamp() + { + return $this->timestamp; + } + + /** + * @return \DateTime + */ + public function getEventDate() + { + return $this->eventDate; + } + + /** + * @return array|\string[] + */ + public function getTags() + { + return $this->tags; + } + + /** + * @param array|\string[] $tags + */ + private function setTags($tags) + { + $this->tags = $tags; + } + + /** + * @return string + */ + public function getUrl() + { + return $this->url; + } + + /** + * @param string $url + */ + private function setUrl($url) + { + $this->url = $url; + } + + /** + * @return array + */ + public function getEnvelope() + { + return $this->envelope; + } + + /** + * @param array $envelope + */ + private function setEnvelope($envelope) + { + $this->envelope = $envelope; + } + + /** + * @return array + */ + public function getDeliveryStatus() + { + return $this->deliveryStatus; + } + + /** + * @param array $deliveryStatus + */ + private function setDeliveryStatus($deliveryStatus) + { + $this->deliveryStatus = $deliveryStatus; + } + + /** + * @return array|\string[] + */ + public function getCampaigns() + { + return $this->campaigns; + } + + /** + * @param array|\string[] $campaigns + */ + private function setCampaigns($campaigns) + { + $this->campaigns = $campaigns; + } + + /** + * @return string + */ + public function getIp() + { + return $this->ip; + } + + /** + * @param string $ip + */ + private function setIp($ip) + { + $this->ip = $ip; + } + + /** + * @return array + */ + public function getClientInfo() + { + return $this->clientInfo; + } + + /** + * @param array $clientInfo + */ + private function setClientInfo($clientInfo) + { + $this->clientInfo = $clientInfo; + } + + /** + * @return string + */ + public function getReason() + { + return $this->reason; + } + + /** + * @param string $reason + */ + private function setReason($reason) + { + $this->reason = $reason; + } + + /** + * @return array + */ + public function getUserVariables() + { + return $this->userVariables; + } + + /** + * @param array $userVariables + */ + private function setUserVariables($userVariables) + { + $this->userVariables = $userVariables; + } + + /** + * @return array + */ + public function getFlags() + { + return $this->flags; + } + + /** + * @param array $flags + */ + private function setFlags($flags) + { + $this->flags = $flags; + } + + /** + * @return array + */ + public function getRoutes() + { + return $this->routes; + } + + /** + * @param array $routes + */ + private function setRoutes($routes) + { + $this->routes = $routes; + } + + /** + * @return array + */ + public function getMessage() + { + return $this->message; + } + + /** + * @param array $message + */ + private function setMessage($message) + { + $this->message = $message; + } + + /** + * @return string + */ + public function getRecipient() + { + return $this->recipient; + } + + /** + * @param string $recipient + */ + private function setRecipient($recipient) + { + $this->recipient = $recipient; + } + + /** + * @return array + */ + public function getGeolocation() + { + return $this->geolocation; + } + + /** + * @param array $geolocation + */ + private function setGeolocation($geolocation) + { + $this->geolocation = $geolocation; + } + + /** + * @return array + */ + public function getStorage() + { + return $this->storage; + } + + /** + * @param array $storage + */ + private function setStorage($storage) + { + $this->storage = $storage; + } + + /** + * @return string + */ + public function getMethod() + { + return $this->method; + } + + /** + * @param string $method + */ + private function setMethod($method) + { + $this->method = $method; + } + + /** + * @return string + */ + public function getSeverity() + { + return $this->severity; + } + + /** + * @param string $severity + */ + private function setSeverity($severity) + { + $this->severity = $severity; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Event/EventResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Event/EventResponse.php new file mode 100644 index 0000000..6cb9d5b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Event/EventResponse.php @@ -0,0 +1,57 @@ + + */ +class EventResponse implements ApiResponse, PagingProvider +{ + use PaginationResponse; + + /** + * @var Event[] + */ + private $items; + + /** + * @param Event[] $items + * @param array $paging + */ + public function __construct(array $items, array $paging) + { + $this->items = $items; + $this->paging = $paging; + } + + public static function create(array $data) + { + $events = []; + if (isset($data['items'])) { + foreach ($data['items'] as $item) { + $events[] = Event::create($item); + } + } + + return new self($events, $data['paging']); + } + + /** + * @return Event[] + */ + public function getItems() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Message/SendResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Message/SendResponse.php new file mode 100644 index 0000000..2295804 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Message/SendResponse.php @@ -0,0 +1,74 @@ + + */ +class SendResponse implements ApiResponse +{ + /** + * @var string + */ + private $id; + + /** + * @var string + */ + private $message; + + /** + * @param string $id + * @param string $message + */ + private function __construct($id, $message) + { + $this->id = $id; + $this->message = $message; + } + + /** + * @param array $data + * + * @return SendResponse + */ + public static function create(array $data) + { + $id = ''; + $message = ''; + + if (isset($data['id'])) { + $id = $data['id']; + } + if (isset($data['message'])) { + $message = $data['message']; + } + + return new self($id, $message); + } + + /** + * @return string + */ + public function getId() + { + return $this->id; + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Message/ShowResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Message/ShowResponse.php new file mode 100644 index 0000000..6be7c84 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Message/ShowResponse.php @@ -0,0 +1,402 @@ + + */ +class ShowResponse implements ApiResponse +{ + /** + * Only available with message/rfc2822. + * + * @var string + */ + private $recipient; + + /** + * Only available with message/rfc2822. + * + * @var string + */ + private $bodyMime; + + /** + * @var string + */ + private $recipients; + + /** + * @var string + */ + private $sender; + + /** + * @var string + */ + private $from; + + /** + * @var string + */ + private $subject; + + /** + * @var string + */ + private $bodyPlain; + + /** + * @var string + */ + private $strippedText; + + /** + * @var string + */ + private $strippedSignature; + + /** + * @var string + */ + private $bodyHtml; + + /** + * @var string + */ + private $strippedHtml; + + /** + * @var array + */ + private $attachments; + + /** + * @var string + */ + private $messageUrl; + + /** + * @var string + */ + private $contentIdMap; + + /** + * @var array + */ + private $messageHeaders; + + /** + * Do not let this object be creted without the ::create. + */ + private function __construct() + { + } + + /** + * @param array $data + * + * @return SendResponse + */ + public static function create(array $data) + { + $response = new self(); + + if (isset($data['recipients'])) { + $response->setRecipients($data['recipients']); + } + if (isset($data['sender'])) { + $response->setSender($data['sender']); + } + if (isset($data['from'])) { + $response->setFrom($data['from']); + } + if (isset($data['subject'])) { + $response->setSubject($data['subject']); + } + if (isset($data['body-plain'])) { + $response->setBodyPlain($data['body-plain']); + } + if (isset($data['stripped-text'])) { + $response->setStrippedText($data['stripped-text']); + } + if (isset($data['stripped-signature'])) { + $response->setStrippedSignature($data['stripped-signature']); + } + if (isset($data['body-html'])) { + $response->setBodyHtml($data['body-html']); + } + if (isset($data['stripped-html'])) { + $response->setStrippedHtml($data['stripped-html']); + } + if (isset($data['message-url'])) { + $response->setMessageUrl($data['message-url']); + } + if (isset($data['message-headers'])) { + $response->setMessageHeaders($data['message-headers']); + } + if (isset($data['recipient'])) { + $response->setRecipient($data['recipient']); + } + if (isset($data['body-mime'])) { + $response->setBodyMime($data['body-mime']); + } + if (isset($data['attachments'])) { + $response->setAttachments($data['attachments']); + } + if (isset($data['content-id-map'])) { + $response->setContentIdMap($data['content-id-map']); + } + + return $response; + } + + /** + * @return string + */ + public function getRecipient() + { + return $this->recipient; + } + + /** + * @param string $recipient + */ + private function setRecipient($recipient) + { + $this->recipient = $recipient; + } + + /** + * @return string + */ + public function getBodyMime() + { + return $this->bodyMime; + } + + /** + * @param string $bodyMime + */ + private function setBodyMime($bodyMime) + { + $this->bodyMime = $bodyMime; + } + + /** + * @return string + */ + public function getRecipients() + { + return $this->recipients; + } + + /** + * @param string $recipients + */ + private function setRecipients($recipients) + { + $this->recipients = $recipients; + } + + /** + * @return string + */ + public function getSender() + { + return $this->sender; + } + + /** + * @param string $sender + */ + private function setSender($sender) + { + $this->sender = $sender; + } + + /** + * @return string + */ + public function getFrom() + { + return $this->from; + } + + /** + * @param string $from + */ + private function setFrom($from) + { + $this->from = $from; + } + + /** + * @return string + */ + public function getSubject() + { + return $this->subject; + } + + /** + * @param string $subject + */ + private function setSubject($subject) + { + $this->subject = $subject; + } + + /** + * @return string + */ + public function getBodyPlain() + { + return $this->bodyPlain; + } + + /** + * @param string $bodyPlain + */ + private function setBodyPlain($bodyPlain) + { + $this->bodyPlain = $bodyPlain; + } + + /** + * @return string + */ + public function getStrippedText() + { + return $this->strippedText; + } + + /** + * @param string $strippedText + */ + private function setStrippedText($strippedText) + { + $this->strippedText = $strippedText; + } + + /** + * @return string + */ + public function getStrippedSignature() + { + return $this->strippedSignature; + } + + /** + * @param string $strippedSignature + */ + private function setStrippedSignature($strippedSignature) + { + $this->strippedSignature = $strippedSignature; + } + + /** + * @return string + */ + public function getBodyHtml() + { + return $this->bodyHtml; + } + + /** + * @param string $bodyHtml + */ + private function setBodyHtml($bodyHtml) + { + $this->bodyHtml = $bodyHtml; + } + + /** + * @return string + */ + public function getStrippedHtml() + { + return $this->strippedHtml; + } + + /** + * @param string $strippedHtml + */ + private function setStrippedHtml($strippedHtml) + { + $this->strippedHtml = $strippedHtml; + } + + /** + * @return array + */ + public function getAttachments() + { + return $this->attachments; + } + + /** + * @param array $attachments + */ + private function setAttachments($attachments) + { + $this->attachments = $attachments; + } + + /** + * @return string + */ + public function getMessageUrl() + { + return $this->messageUrl; + } + + /** + * @param string $messageUrl + */ + private function setMessageUrl($messageUrl) + { + $this->messageUrl = $messageUrl; + } + + /** + * @return string + */ + public function getContentIdMap() + { + return $this->contentIdMap; + } + + /** + * @param string $contentIdMap + */ + public function setContentIdMap($contentIdMap) + { + $this->contentIdMap = $contentIdMap; + } + + /** + * @return array + */ + public function getMessageHeaders() + { + return $this->messageHeaders; + } + + /** + * @param array $messageHeaders + */ + private function setMessageHeaders(array $messageHeaders) + { + $this->messageHeaders = $messageHeaders; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/PaginationResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/PaginationResponse.php new file mode 100644 index 0000000..3d2895f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/PaginationResponse.php @@ -0,0 +1,69 @@ + + */ +trait PaginationResponse +{ + /** + * @var array + */ + protected $paging; + + /** + * @return string + */ + public function getNextUrl() + { + if (!isset($this->paging['next'])) { + return; + } + + return $this->paging['next']; + } + + /** + * @return string + */ + public function getPreviousUrl() + { + if (!isset($this->paging['previous'])) { + return; + } + + return $this->paging['previous']; + } + + /** + * @return string + */ + public function getFirstUrl() + { + if (!isset($this->paging['first'])) { + return; + } + + return $this->paging['first']; + } + + /** + * @return string + */ + public function getLastUrl() + { + if (!isset($this->paging['last'])) { + return; + } + + return $this->paging['last']; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/PagingProvider.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/PagingProvider.php new file mode 100644 index 0000000..560a74d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/PagingProvider.php @@ -0,0 +1,44 @@ + + */ +interface PagingProvider +{ + /** + * Returns the `$paging->next` URL. + * + * @return string + */ + public function getNextUrl(); + + /** + * Returns the `$paging->prev` URL. + * + * @return string + */ + public function getPreviousUrl(); + + /** + * Returns the `$paging->first` URL. + * + * @return string + */ + public function getFirstUrl(); + + /** + * Returns the `$paging->last` URL. + * + * @return string + */ + public function getLastUrl(); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Action.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Action.php new file mode 100644 index 0000000..bfdb942 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Action.php @@ -0,0 +1,57 @@ + + */ +final class Action +{ + /** + * @var string + */ + private $action; + + /** + * Action Named Constructor to build several Action DTOs provided by an Array. + * + * @param array $data + * + * @return Action[] + */ + public static function createMultiple(array $data) + { + $items = []; + + foreach ($data as $action) { + $items[] = new self($action); + } + + return $items; + } + + /** + * Action Private Constructor. + * + * @param $action + */ + private function __construct($action) + { + $this->action = $action; + } + + /** + * @return string + */ + public function getAction() + { + return $this->action; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/CreateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/CreateResponse.php new file mode 100644 index 0000000..687d08d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/CreateResponse.php @@ -0,0 +1,68 @@ + + */ +final class CreateResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @var Route + */ + private $route; + + /** + * {@inheritdoc} + */ + public static function create(array $data) + { + $message = isset($data['message']) ? $data['message'] : null; + $route = isset($data['route']) ? Route::create($data['route']) : null; + + return new self($message, $route); + } + + /** + * CreateResponse Private Constructor. + * + * @param string|null $message + * @param Route|null $route + */ + private function __construct($message = null, Route $route = null) + { + $this->message = $message; + $this->route = $route; + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } + + /** + * @return Route + */ + public function getRoute() + { + return $this->route; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/DeleteResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/DeleteResponse.php new file mode 100644 index 0000000..26a2f63 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/DeleteResponse.php @@ -0,0 +1,67 @@ + + */ +final class DeleteResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @var string + */ + private $error; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + return new self( + isset($data['message']) ? $data['message'] : null, + isset($data['error']) ? $data['error'] : null + ); + } + + /** + * @param string $message + * @param string $error + */ + private function __construct($message, $error) + { + $this->message = $message; + $this->error = $error; + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } + + /** + * @return string + */ + public function getError() + { + return $this->error; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/IndexResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/IndexResponse.php new file mode 100644 index 0000000..b78c254 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/IndexResponse.php @@ -0,0 +1,77 @@ + + */ +final class IndexResponse implements ApiResponse +{ + /** + * @var int + */ + private $totalCount; + + /** + * @var Route[] + */ + private $items; + + /** + * {@inheritdoc} + */ + public static function create(array $data) + { + $items = []; + + if (isset($data['items'])) { + foreach ($data['items'] as $item) { + $items[] = Route::create($item); + } + } + + if (isset($data['total_count'])) { + $count = $data['total_count']; + } else { + $count = count($items); + } + + return new self($count, $items); + } + + /** + * @param int $totalCount + * @param Route[] $items + */ + private function __construct($totalCount, array $items) + { + $this->totalCount = $totalCount; + $this->items = $items; + } + + /** + * @return int + */ + public function getTotalCount() + { + return $this->totalCount; + } + + /** + * @return Route[] + */ + public function getRoutes() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/ShowResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/ShowResponse.php new file mode 100644 index 0000000..89b88d0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/ShowResponse.php @@ -0,0 +1,54 @@ + + */ +final class ShowResponse implements ApiResponse +{ + /** + * @var Route|null + */ + private $route; + + /** + * {@inheritdoc} + */ + public static function create(array $data) + { + if (isset($data['route'])) { + return new self(Route::create($data['route'])); + } + + return new self(); + } + + /** + * ShowResponse constructor. + * + * @param Route|null $route + */ + private function __construct(Route $route = null) + { + $this->route = $route; + } + + /** + * @return Route|null + */ + public function getRoute() + { + return $this->route; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/UpdateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/UpdateResponse.php new file mode 100644 index 0000000..43edc0b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Response/UpdateResponse.php @@ -0,0 +1,68 @@ + + */ +final class UpdateResponse implements ApiResponse +{ + /** + * @var string|null + */ + private $message; + + /** + * @var Route|null + */ + private $route; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $message = isset($data['message']) ? $data['message'] : null; + $route = isset($data['id']) ? Route::create($data) : null; + + return new self($message, $route); + } + + /** + * @param string|null $message + * @param Route|null $route + */ + private function __construct($message = null, Route $route = null) + { + $this->message = $message; + $this->route = $route; + } + + /** + * @return string|null + */ + public function getMessage() + { + return $this->message; + } + + /** + * @return Route|null + */ + public function getRoute() + { + return $this->route; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Route.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Route.php new file mode 100644 index 0000000..527073f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Route/Route.php @@ -0,0 +1,133 @@ + + */ +final class Route +{ + /** + * @var string + */ + private $id; + + /** + * @var int + */ + private $priority; + + /** + * @var string + */ + private $filter; + + /** + * @var Action[] + */ + private $actions; + + /** + * @var string + */ + private $description; + + /** + * @var \DateTime + */ + private $createdAt; + + /** + * Route Named Constructor. + * + * @param array $data + * + * @return Route + */ + public static function create(array $data) + { + return new self( + isset($data['id']) ? $data['id'] : null, + isset($data['priority']) ? $data['priority'] : null, + isset($data['expression']) ? $data['expression'] : null, + isset($data['actions']) ? $data['actions'] : [], + isset($data['description']) ? $data['description'] : null, + isset($data['created_at']) ? new \DateTime($data['created_at']) : null + ); + } + + /** + * Route Private Constructor. + * + * @param string $id + * @param int $priority + * @param string $expression + * @param array $actions + * @param string $description + * @param \DateTime $createdAt + */ + private function __construct($id, $priority, $expression, $actions, $description, \DateTime $createdAt = null) + { + $this->id = $id; + $this->priority = $priority; + $this->filter = $expression; + $this->actions = Action::createMultiple($actions); + $this->description = $description; + $this->createdAt = $createdAt; + } + + /** + * @return string + */ + public function getId() + { + return $this->id; + } + + /** + * @return Action[] + */ + public function getActions() + { + return $this->actions; + } + + /** + * @return string + */ + public function getDescription() + { + return $this->description; + } + + /** + * @return string + */ + public function getFilter() + { + return $this->filter; + } + + /** + * @return int + */ + public function getPriority() + { + return $this->priority; + } + + /** + * @return \DateTime + */ + public function getCreatedAt() + { + return $this->createdAt; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/AllResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/AllResponse.php new file mode 100644 index 0000000..215f074 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/AllResponse.php @@ -0,0 +1,77 @@ + + */ +final class AllResponse implements ApiResponse +{ + /** + * @var int + */ + private $totalCount; + + /** + * @var AllResponseItem[] + */ + private $items; + + /** + * @param int $totalCount + * @param AllResponseItem[] $items + */ + private function __construct($totalCount, array $items) + { + $this->totalCount = $totalCount; + $this->items = $items; + } + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $items = []; + if (isset($data['items'])) { + foreach ($data['items'] as $i) { + $items[] = AllResponseItem::create($i); + } + } + + if (isset($data['total_count'])) { + $count = $data['total_count']; + } else { + $count = count($items); + } + + return new self($count, $items); + } + + /** + * @return int + */ + public function getTotalCount() + { + return $this->totalCount; + } + + /** + * @return AllResponseItem[] + */ + public function getItems() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/AllResponseItem.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/AllResponseItem.php new file mode 100644 index 0000000..d5d6dc4 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/AllResponseItem.php @@ -0,0 +1,113 @@ + + */ +final class AllResponseItem +{ + /** + * @var string + */ + private $id; + + /** + * @var string + */ + private $event; + + /** + * @var string + */ + private $totalCount; + + /** + * @var string[] + */ + private $tags; + + /** + * @var \DateTime + */ + private $createdAt; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + return new self( + isset($data['id']) ? $data['id'] : null, + isset($data['event']) ? $data['event'] : null, + isset($data['total_count']) ? $data['total_count'] : null, + isset($data['tags']) ? $data['tags'] : null, + isset($data['created_at']) ? new \DateTime($data['created_at']) : null + ); + } + + /** + * @param string $id + * @param string $event + * @param string $totalCount + * @param \string[] $tags + * @param \DateTime $createdAt + */ + private function __construct($id, $event, $totalCount, array $tags, \DateTime $createdAt) + { + $this->id = $id; + $this->event = $event; + $this->totalCount = $totalCount; + $this->tags = $tags; + $this->createdAt = $createdAt; + } + + /** + * @return string + */ + public function getId() + { + return $this->id; + } + + /** + * @return string + */ + public function getEvent() + { + return $this->event; + } + + /** + * @return string + */ + public function getTotalCount() + { + return $this->totalCount; + } + + /** + * @return string[] + */ + public function getTags() + { + return $this->tags; + } + + /** + * @return \DateTime + */ + public function getCreatedAt() + { + return $this->createdAt; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/TotalResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/TotalResponse.php new file mode 100644 index 0000000..3d4caff --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/TotalResponse.php @@ -0,0 +1,105 @@ + + */ +final class TotalResponse implements ApiResponse +{ + /** + * @var \DateTime + */ + private $start; + + /** + * @var \DateTime + */ + private $end; + + /** + * @var string + */ + private $resolution; + + /** + * @var TotalResponseItem[] + */ + private $stats; + + /** + * @param \DateTime $start + * @param \DateTime $end + * @param string $resolution + * @param TotalResponseItem[] $stats + */ + private function __construct(\DateTime $start, \DateTime $end, $resolution, array $stats) + { + $this->start = $start; + $this->end = $end; + $this->resolution = $resolution; + $this->stats = $stats; + } + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + $stats = []; + if (isset($data['status'])) { + foreach ($data['stats'] as $s) { + $stats[] = TotalResponseItem::create($s); + } + } + + $start = isset($data['start']) ? new \DateTime($data['start']) : null; + $end = isset($data['end']) ? new \DateTime($data['end']) : null; + $resolution = isset($data['resolution']) ? $data['resolution'] : null; + + return new self($start, $end, $resolution, $stats); + } + + /** + * @return \DateTime + */ + public function getStart() + { + return $this->start; + } + + /** + * @return \DateTime + */ + public function getEnd() + { + return $this->end; + } + + /** + * @return string + */ + public function getResolution() + { + return $this->resolution; + } + + /** + * @return TotalResponseItem[] + */ + public function getStats() + { + return $this->stats; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/TotalResponseItem.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/TotalResponseItem.php new file mode 100644 index 0000000..785d7d8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Stats/TotalResponseItem.php @@ -0,0 +1,97 @@ + + */ +class TotalResponseItem +{ + /** + * @var \DateTime + */ + private $time; + + /** + * @var array + */ + private $accepted; + + /** + * @var array + */ + private $delivered; + + /** + * @var array + */ + private $failed; + + /** + * @param array $data + * + * @return self + */ + public static function create(array $data) + { + return new self( + isset($data['time']) ? new \DateTime($data['time']) : null, + isset($data['accepted']) ? $data['accepted'] : null, + isset($data['delivered']) ? $data['delivered'] : null, + isset($data['failed']) ? $data['failed'] : null + ); + } + + /** + * @param \DateTime $time + * @param array $accepted + * @param array $delivered + * @param array $failed + */ + private function __construct(\DateTime $time, array $accepted, array $delivered, array $failed) + { + $this->time = $time; + $this->accepted = $accepted; + $this->delivered = $delivered; + $this->failed = $failed; + } + + /** + * @return \DateTime + */ + public function getTime() + { + return $this->time; + } + + /** + * @return array + */ + public function getAccepted() + { + return $this->accepted; + } + + /** + * @return array + */ + public function getDelivered() + { + return $this->delivered; + } + + /** + * @return array + */ + public function getFailed() + { + return $this->failed; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/BaseResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/BaseResponse.php new file mode 100644 index 0000000..413bee9 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/BaseResponse.php @@ -0,0 +1,69 @@ + + */ +abstract class BaseResponse implements ApiResponse +{ + /** + * @var string + */ + private $address; + + /** + * @var string + */ + private $message; + + /** + * @param string $address + * @param string $message + */ + private function __construct($address, $message) + { + $this->address = $address; + $this->message = $message; + } + + /** + * @param array $data + * + * @return BaseResponse + */ + public static function create(array $data) + { + $address = isset($data['address']) ? $data['address'] : ''; + $message = isset($data['message']) ? $data['message'] : ''; + + return new static($address, $message); + } + + /** + * @return string + */ + public function getAddress() + { + return $this->address; + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/Bounce.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/Bounce.php new file mode 100644 index 0000000..687effc --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/Bounce.php @@ -0,0 +1,123 @@ + + */ +class Bounce +{ + /** + * @var string + */ + private $address; + + /** + * @var string + */ + private $code; + + /** + * @var string + */ + private $error; + + /** + * @var \DateTime + */ + private $createdAt; + + /** + * @param string $address + */ + private function __construct($address) + { + $this->address = $address; + $this->createdAt = new \DateTime(); + } + + /** + * @param array $data + * + * @return Bounce + */ + public static function create(array $data) + { + $bounce = new self($data['address']); + + if (isset($data['code'])) { + $bounce->setCode($data['code']); + } + if (isset($data['error'])) { + $bounce->setError($data['error']); + } + if (isset($data['created_at'])) { + $bounce->setCreatedAt(new \DateTime($data['created_at'])); + } + + return $bounce; + } + + /** + * @return string + */ + public function getAddress() + { + return $this->address; + } + + /** + * @return string + */ + public function getCode() + { + return $this->code; + } + + /** + * @param string $code + */ + private function setCode($code) + { + $this->code = $code; + } + + /** + * @return string + */ + public function getError() + { + return $this->error; + } + + /** + * @param string $error + */ + private function setError($error) + { + $this->error = $error; + } + + /** + * @return \DateTime + */ + public function getCreatedAt() + { + return $this->createdAt; + } + + /** + * @param \DateTime $createdAt + */ + private function setCreatedAt(\DateTime $createdAt) + { + $this->createdAt = $createdAt; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/CreateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/CreateResponse.php new file mode 100644 index 0000000..e91d5e8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/CreateResponse.php @@ -0,0 +1,19 @@ + + */ +final class CreateResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/DeleteResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/DeleteResponse.php new file mode 100644 index 0000000..92dac6a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/DeleteResponse.php @@ -0,0 +1,19 @@ + + */ +final class DeleteResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/IndexResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/IndexResponse.php new file mode 100644 index 0000000..cbf7658 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/IndexResponse.php @@ -0,0 +1,62 @@ + + */ +final class IndexResponse implements ApiResponse, PagingProvider +{ + use PaginationResponse; + + /** + * @var Bounce[] + */ + private $items; + + /** + * @param Bounce[] $items + * @param array $paging + */ + private function __construct(array $items, array $paging) + { + $this->items = $items; + $this->paging = $paging; + } + + /** + * @param array $data + * + * @return IndexResponse + */ + public static function create(array $data) + { + $bounces = []; + if (isset($data['items'])) { + foreach ($data['items'] as $item) { + $bounces[] = Bounce::create($item); + } + } + + return new self($bounces, $data['paging']); + } + + /** + * @return Bounce[] + */ + public function getItems() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/ShowResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/ShowResponse.php new file mode 100644 index 0000000..894babd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Bounce/ShowResponse.php @@ -0,0 +1,19 @@ + + */ +final class ShowResponse extends Bounce implements ApiResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/Complaint.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/Complaint.php new file mode 100644 index 0000000..c9506d2 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/Complaint.php @@ -0,0 +1,75 @@ + + */ +class Complaint +{ + /** + * @var string + */ + private $address; + + /** + * @var \DateTime + */ + private $createdAt; + + /** + * @param string $address + */ + private function __construct($address) + { + $this->address = $address; + $this->createdAt = new \DateTime(); + } + + /** + * @param array $data + * + * @return Complaint + */ + public static function create(array $data) + { + $complaint = new self($data['address']); + + if (isset($data['created_at'])) { + $complaint->setCreatedAt(new \DateTime($data['created_at'])); + } + + return $complaint; + } + + /** + * @return string + */ + public function getAddress() + { + return $this->address; + } + + /** + * @return \DateTime + */ + public function getCreatedAt() + { + return $this->createdAt; + } + + /** + * @param \DateTime $createdAt + */ + private function setCreatedAt(\DateTime $createdAt) + { + $this->createdAt = $createdAt; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/CreateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/CreateResponse.php new file mode 100644 index 0000000..78e3dde --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/CreateResponse.php @@ -0,0 +1,19 @@ + + */ +final class CreateResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/DeleteResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/DeleteResponse.php new file mode 100644 index 0000000..9c8ce93 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/DeleteResponse.php @@ -0,0 +1,19 @@ + + */ +final class DeleteResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/IndexResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/IndexResponse.php new file mode 100644 index 0000000..6f96b4f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/IndexResponse.php @@ -0,0 +1,62 @@ + + */ +final class IndexResponse implements ApiResponse, PagingProvider +{ + use PaginationResponse; + + /** + * @var Complaint[] + */ + private $items; + + /** + * @param Complaint[] $items + * @param array $paging + */ + private function __construct(array $items, array $paging) + { + $this->items = $items; + $this->paging = $paging; + } + + /** + * @param array $data + * + * @return IndexResponse + */ + public static function create(array $data) + { + $complaints = []; + if (isset($data['items'])) { + foreach ($data['items'] as $item) { + $complaints[] = Complaint::create($item); + } + } + + return new self($complaints, $data['paging']); + } + + /** + * @return Complaint[] + */ + public function getItems() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/ShowResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/ShowResponse.php new file mode 100644 index 0000000..4ad2102 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Complaint/ShowResponse.php @@ -0,0 +1,19 @@ + + */ +final class ShowResponse extends Complaint implements ApiResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/CreateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/CreateResponse.php new file mode 100644 index 0000000..8d398f3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/CreateResponse.php @@ -0,0 +1,19 @@ + + */ +final class CreateResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/DeleteResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/DeleteResponse.php new file mode 100644 index 0000000..c873026 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/DeleteResponse.php @@ -0,0 +1,19 @@ + + */ +final class DeleteResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/IndexResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/IndexResponse.php new file mode 100644 index 0000000..fb3ebda --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/IndexResponse.php @@ -0,0 +1,62 @@ + + */ +final class IndexResponse implements ApiResponse, PagingProvider +{ + use PaginationResponse; + + /** + * @var Unsubscribe[] + */ + private $items; + + /** + * @param Unsubscribe[] $items + * @param array $paging + */ + private function __construct(array $items, array $paging) + { + $this->items = $items; + $this->paging = $paging; + } + + /** + * @param array $data + * + * @return IndexResponse + */ + public static function create(array $data) + { + $unsubscribes = []; + if (isset($data['items'])) { + foreach ($data['items'] as $item) { + $unsubscribes[] = Unsubscribe::create($item); + } + } + + return new self($unsubscribes, $data['paging']); + } + + /** + * @return Unsubscribe[] + */ + public function getItems() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/ShowResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/ShowResponse.php new file mode 100644 index 0000000..558c92d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/ShowResponse.php @@ -0,0 +1,19 @@ + + */ +final class ShowResponse extends Unsubscribe implements ApiResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/Unsubscribe.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/Unsubscribe.php new file mode 100644 index 0000000..eed521d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Suppression/Unsubscribe/Unsubscribe.php @@ -0,0 +1,99 @@ + + */ +class Unsubscribe +{ + /** + * @var string + */ + private $address; + + /** + * @var string + */ + private $tag; + + /** + * @var \DateTime + */ + private $createdAt; + + /** + * @param string $address + */ + private function __construct($address) + { + $this->address = $address; + $this->createdAt = new \DateTime(); + } + + /** + * @param array $data + * + * @return Unsubscribe + */ + public static function create(array $data) + { + $unsubscribe = new self($data['address']); + + if (isset($data['tag'])) { + $unsubscribe->setTag($data['tag']); + } + if (isset($data['created_at'])) { + $unsubscribe->setCreatedAt(new \DateTime($data['created_at'])); + } + + return $unsubscribe; + } + + /** + * @return string + */ + public function getAddress() + { + return $this->address; + } + + /** + * @return string + */ + public function getTag() + { + return $this->tag; + } + + /** + * @param string $tag + */ + private function setTag($tag) + { + $this->tag = $tag; + } + + /** + * @return \DateTime + */ + public function getCreatedAt() + { + return $this->createdAt; + } + + /** + * @param \DateTime $createdAt + */ + private function setCreatedAt(\DateTime $createdAt) + { + $this->createdAt = $createdAt; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/DeleteResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/DeleteResponse.php new file mode 100644 index 0000000..84f7a23 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/DeleteResponse.php @@ -0,0 +1,49 @@ + + */ +final class DeleteResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @param string $message + */ + private function __construct($message) + { + $this->message = $message; + } + + /** + * @param array $data + * + * @return DeleteResponse + */ + public static function create(array $data) + { + return new self($data['message']); + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/IndexResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/IndexResponse.php new file mode 100644 index 0000000..feec846 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/IndexResponse.php @@ -0,0 +1,60 @@ + + */ +final class IndexResponse implements ApiResponse, PagingProvider +{ + use PaginationResponse; + + /** + * @var Tag[] + */ + private $items; + + /** + * @param Tag[] $items + * @param array $paging + */ + public function __construct(array $items, array $paging) + { + $this->items = $items; + $this->paging = $paging; + } + + /** + * @param array $data + * + * @return IndexResponse + */ + public static function create(array $data) + { + $items = []; + foreach ($data['items'] as $item) { + $items[] = Tag::create($item); + } + + return new self($items, $data['paging']); + } + + /** + * @return Tag[] + */ + public function getItems() + { + return $this->items; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/ShowResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/ShowResponse.php new file mode 100644 index 0000000..1c1d8e3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/ShowResponse.php @@ -0,0 +1,19 @@ + + */ +final class ShowResponse extends Tag implements ApiResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/StatisticsResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/StatisticsResponse.php new file mode 100644 index 0000000..1716a6f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/StatisticsResponse.php @@ -0,0 +1,131 @@ + + */ +final class StatisticsResponse implements ApiResponse +{ + /** + * @var string + */ + private $tag; + + /** + * @var string + */ + private $description; + + /** + * @var string + */ + private $resolution; + + /** + * @var \DateTime + */ + private $start; + + /** + * @var \DateTime + */ + private $end; + + /** + * @var array + */ + private $stats; + + /** + * @param string $tag + * @param string $description + * @param \DateTime $start + * @param \DateTime $end + * @param string $resolution + * @param array $stats + */ + private function __construct($tag, $description, \DateTime $start, \DateTime $end, $resolution, array $stats) + { + $this->tag = $tag; + $this->description = $description; + $this->resolution = $resolution; + $this->start = $start; + $this->end = $end; + $this->stats = $stats; + } + + /** + * @param array $data + * + * @return StatisticsResponse + */ + public static function create(array $data) + { + return new self( + $data['tag'], + $data['description'], + new \DateTime($data['start']), + new \DateTime($data['end']), + $data['resolution'], + $data['stats'] + ); + } + + /** + * @return string + */ + public function getTag() + { + return $this->tag; + } + + /** + * @return string + */ + public function getDescription() + { + return $this->description; + } + + /** + * @return string + */ + public function getResolution() + { + return $this->resolution; + } + + /** + * @return \DateTime + */ + public function getStart() + { + return $this->start; + } + + /** + * @return \DateTime + */ + public function getEnd() + { + return $this->end; + } + + /** + * @return array + */ + public function getStats() + { + return $this->stats; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/Tag.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/Tag.php new file mode 100644 index 0000000..dabd6a7 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/Tag.php @@ -0,0 +1,73 @@ +tag = $tag; + $this->description = $description; + $this->firstSeen = $firstSeen; + $this->lastSeen = $lastSeen; + } + + /** + * @param array $data + * + * @return Tag + */ + public static function create(array $data) + { + return new self($data['tag'], $data['description'], $data['first-seen'], $data['last-seen']); + } + + /** + * @return string + */ + public function getTag() + { + return $this->tag; + } + + /** + * @return string + */ + public function getDescription() + { + return $this->description; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/UpdateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/UpdateResponse.php new file mode 100644 index 0000000..4f4d2bd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Tag/UpdateResponse.php @@ -0,0 +1,49 @@ + + */ +final class UpdateResponse implements ApiResponse +{ + /** + * @var string + */ + private $message; + + /** + * @param string $message + */ + private function __construct($message) + { + $this->message = $message; + } + + /** + * @param array $data + * + * @return UpdateResponse + */ + public static function create(array $data) + { + return new self($data['message']); + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/BaseResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/BaseResponse.php new file mode 100644 index 0000000..6cd0fe6 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/BaseResponse.php @@ -0,0 +1,78 @@ + + */ +abstract class BaseResponse implements ApiResponse +{ + /** + * @var array + */ + private $webhook = []; + + /** + * @var string + */ + private $message; + + /** + * @param array $webhook + * @param string $message + */ + public function __construct(array $webhook, $message) + { + $this->webhook = $webhook; + $this->message = $message; + } + + /** + * @param array $data + * + * @return static + */ + public static function create(array $data) + { + $webhook = []; + $message = ''; + if (isset($data['webhook'])) { + $webhook = $data['webhook']; + } + + if (isset($data['message'])) { + $message = $data['message']; + } + + return new static($webhook, $message); + } + + /** + * @return string|null + */ + public function getWebhookUrl() + { + if (isset($this->webhook['url'])) { + return $this->webhook['url']; + } + } + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/CreateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/CreateResponse.php new file mode 100644 index 0000000..43d93c0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/CreateResponse.php @@ -0,0 +1,17 @@ + + */ +class CreateResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/DeleteResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/DeleteResponse.php new file mode 100644 index 0000000..8f0c094 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/DeleteResponse.php @@ -0,0 +1,17 @@ + + */ +class DeleteResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/IndexResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/IndexResponse.php new file mode 100644 index 0000000..6ed276c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/IndexResponse.php @@ -0,0 +1,219 @@ + + */ +class IndexResponse implements ApiResponse +{ + /** + * @var array + */ + private $bounce = []; + + /** + * @var array + */ + private $deliver = []; + + /** + * @var array + */ + private $drop = []; + + /** + * @var array + */ + private $spam = []; + + /** + * @var array + */ + private $unsubscribe = []; + + /** + * @var array + */ + private $click = []; + + /** + * @var array + */ + private $open = []; + + /** + * Do not let this object be creted without the ::create. + */ + private function __construct() + { + } + + /** + * @param array $data + * + * @return IndexResponse + */ + public static function create(array $data) + { + $self = new self(); + if (isset($data['bounce'])) { + $self->setBounce($data['bounce']); + } + if (isset($data['deliver'])) { + $self->setDeliver($data['deliver']); + } + if (isset($data['drop'])) { + $self->setDrop($data['drop']); + } + if (isset($data['spam'])) { + $self->setSpam($data['spam']); + } + if (isset($data['unsubscribe'])) { + $self->setUnsubscribe($data['unsubscribe']); + } + if (isset($data['click'])) { + $self->setClick($data['click']); + } + if (isset($data['open'])) { + $self->setOpen($data['open']); + } + + return $self; + } + + /** + * @return string|null + */ + public function getBounceUrl() + { + if (isset($this->bounce['url'])) { + return $this->bounce['url']; + } + } + + /** + * @param array $bounce + */ + private function setBounce($bounce) + { + $this->bounce = $bounce; + } + + /** + * @return string|null + */ + public function getDeliverUrl() + { + if (isset($this->deliver['url'])) { + return $this->deliver['url']; + } + } + + /** + * @param array $deliver + */ + private function setDeliver($deliver) + { + $this->deliver = $deliver; + } + + /** + * @return string|null + */ + public function getDropUrl() + { + if (isset($this->drop['url'])) { + return $this->drop['url']; + } + } + + /** + * @param array $drop + */ + private function setDrop($drop) + { + $this->drop = $drop; + } + + /** + * @return string|null + */ + public function getSpamUrl() + { + if (isset($this->spam['url'])) { + return $this->spam['url']; + } + } + + /** + * @param array $spam + */ + private function setSpam($spam) + { + $this->spam = $spam; + } + + /** + * @return string|null + */ + public function getUnsubscribeUrl() + { + if (isset($this->unsubscribe['url'])) { + return $this->unsubscribe['url']; + } + } + + /** + * @param array $unsubscribe + */ + private function setUnsubscribe($unsubscribe) + { + $this->unsubscribe = $unsubscribe; + } + + /** + * @return string|null + */ + public function getClickUrl() + { + if (isset($this->click['url'])) { + return $this->click['url']; + } + } + + /** + * @param array $click + */ + private function setClick($click) + { + $this->click = $click; + } + + /** + * @return string|null + */ + public function getOpenUrl() + { + if (isset($this->open['url'])) { + return $this->open['url']; + } + } + + /** + * @param array $open + */ + private function setOpen($open) + { + $this->open = $open; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/ShowResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/ShowResponse.php new file mode 100644 index 0000000..10a64c1 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/ShowResponse.php @@ -0,0 +1,56 @@ + + */ +class ShowResponse implements ApiResponse +{ + /** + * @var array + */ + private $webhook = []; + + /** + * @param array $webhook + */ + public function __construct(array $webhook) + { + $this->webhook = $webhook; + } + + /** + * @param array $data + * + * @return ShowResponse + */ + public static function create(array $data) + { + $webhook = []; + if (isset($data['webhook'])) { + $webhook = $data['webhook']; + } + + return new self($webhook); + } + + /** + * @return string|null + */ + public function getWebhookUrl() + { + if (isset($this->webhook['url'])) { + return $this->webhook['url']; + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/UpdateResponse.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/UpdateResponse.php new file mode 100644 index 0000000..7ab0c3f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/Model/Webhook/UpdateResponse.php @@ -0,0 +1,17 @@ + + */ +class UpdateResponse extends BaseResponse +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/RequestBuilder.php b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/RequestBuilder.php new file mode 100644 index 0000000..db1f0b1 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/mailgun/mailgun-php/src/Mailgun/RequestBuilder.php @@ -0,0 +1,121 @@ + + */ +class RequestBuilder +{ + /** + * @var RequestFactory + */ + private $requestFactory; + + /** + * @var MultipartStreamBuilder + */ + private $multipartStreamBuilder; + + /** + * Creates a new PSR-7 request. + * + * @param string $method + * @param string $uri + * @param array $headers + * @param array|string|null $body Request body. If body is an array we will send a as multipart stream request. + * If array, each array *item* MUST look like: + * array ( + * 'content' => string|resource|StreamInterface, + * 'name' => string, + * 'filename'=> string (optional) + * 'headers' => array (optinal) ['header-name' => 'header-value'] + * ) + * + * @return RequestInterface + */ + public function create($method, $uri, array $headers = [], $body = null) + { + if (!is_array($body)) { + return $this->getRequestFactory()->createRequest($method, $uri, $headers, $body); + } + + $builder = $this->getMultipartStreamBuilder(); + foreach ($body as $item) { + $name = $item['name']; + $content = $item['content']; + unset($item['name']); + unset($item['content']); + + $builder->addResource($name, $content, $item); + } + + $multipartStream = $builder->build(); + $boundary = $builder->getBoundary(); + $builder->reset(); + + $headers['Content-Type'] = 'multipart/form-data; boundary="'.$boundary.'"'; + + return $this->getRequestFactory()->createRequest($method, $uri, $headers, $multipartStream); + } + + /** + * @return RequestFactory + */ + private function getRequestFactory() + { + if ($this->requestFactory === null) { + $this->requestFactory = MessageFactoryDiscovery::find(); + } + + return $this->requestFactory; + } + + /** + * @param RequestFactory $requestFactory + * + * @return RequestBuilder + */ + public function setRequestFactory($requestFactory) + { + $this->requestFactory = $requestFactory; + + return $this; + } + + /** + * @return MultipartStreamBuilder + */ + private function getMultipartStreamBuilder() + { + if ($this->multipartStreamBuilder === null) { + $this->multipartStreamBuilder = new MultipartStreamBuilder(); + } + + return $this->multipartStreamBuilder; + } + + /** + * @param MultipartStreamBuilder $multipartStreamBuilder + * + * @return RequestBuilder + */ + public function setMultipartStreamBuilder($multipartStreamBuilder) + { + $this->multipartStreamBuilder = $multipartStreamBuilder; + + return $this; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/CHANGELOG.md new file mode 100644 index 0000000..3031720 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/CHANGELOG.md @@ -0,0 +1,137 @@ +# Change Log + +## 1.7.0 - 2017-11-30 + +### Added + +- Symfony 4 support + +### Changed + +- Strict comparison in DecoderPlugin + +## 1.6.0 - 2017-10-16 + +### Added + +- Add HttpClientPool client to leverage load balancing and fallback mechanism [see the documentation](http://docs.php-http.org/en/latest/components/client-common.html) for more details. +- `PluginClientFactory` to create `PluginClient` instances. +- Added new option 'delay' for `RetryPlugin`. +- Added new option 'decider' for `RetryPlugin`. +- Supports more cookie date formats in the Cookie Plugin + +### Changed + +- The `RetryPlugin` does now wait between retries. To disable/change this feature you must write something like: + +```php +$plugin = new RetryPlugin(['delay' => function(RequestInterface $request, Exception $e, $retries) { + return 0; +}); +``` + +### Deprecated + +- The `debug_plugins` option for `PluginClient` is deprecated and will be removed in 2.0. Use the decorator design pattern instead like in [ProfilePlugin](https://github.com/php-http/HttplugBundle/blob/de33f9c14252f22093a5ec7d84f17535ab31a384/Collector/ProfilePlugin.php). + +## 1.5.0 - 2017-03-30 + +### Added + +- `QueryDefaultsPlugin` to add default query parameters. + +## 1.4.2 - 2017-03-18 + +### Deprecated + +- `DecoderPlugin` does not longer claim to support `compress` content encoding + +### Fixed + +- `CookiePlugin` allows main domain cookies to be sent/stored for subdomains +- `DecoderPlugin` uses the right `FilteredStream` to handle `deflate` content encoding + + +## 1.4.1 - 2017-02-20 + +### Fixed + +- Cast return value of `StreamInterface::getSize` to string in `ContentLengthPlugin` + + +## 1.4.0 - 2016-11-04 + +### Added + +- Add Path plugin +- Base URI plugin that combines Add Host and Add Path plugins + + +## 1.3.0 - 2016-10-16 + +### Changed + +- Fix Emulated Trait to use Http based promise which respect the HttpAsyncClient interface +- Require Httplug 1.1 where we use HTTP specific promises. +- RedirectPlugin: use the full URL instead of the URI to properly keep track of redirects +- Add AddPathPlugin for API URLs with base path +- Add BaseUriPlugin that combines AddHostPlugin and AddPathPlugin + + +## 1.2.1 - 2016-07-26 + +### Changed + +- AddHostPlugin also sets the port if specified + + +## 1.2.0 - 2016-07-14 + +### Added + +- Suggest separate plugins in composer.json +- Introduced `debug_plugins` option for `PluginClient` + + +## 1.1.0 - 2016-05-04 + +### Added + +- Add a flexible http client providing both contract, and only emulating what's necessary +- HTTP Client Router: route requests to underlying clients +- Plugin client and core plugins moved here from `php-http/plugins` + +### Deprecated + +- Extending client classes, they will be made final in version 2.0 + + +## 1.0.0 - 2016-01-27 + +### Changed + +- Remove useless interface in BatchException + + +## 0.2.0 - 2016-01-12 + +### Changed + +- Updated package files +- Updated HTTPlug to RC1 + + +## 0.1.1 - 2015-12-26 + +### Added + +- Emulated clients + + +## 0.1.0 - 2015-12-25 + +### Added + +- Batch client from utils +- Methods client from utils +- Emulators and decorators from client-tools diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/LICENSE b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/LICENSE new file mode 100644 index 0000000..4558d6f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2015-2016 PHP HTTP Team + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/README.md b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/README.md new file mode 100644 index 0000000..017bfce --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/README.md @@ -0,0 +1,55 @@ +# HTTP Client Common + +[![Latest Version](https://img.shields.io/github/release/php-http/client-common.svg?style=flat-square)](https://github.com/php-http/client-common/releases) +[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE) +[![Build Status](https://img.shields.io/travis/php-http/client-common.svg?style=flat-square)](https://travis-ci.org/php-http/client-common) +[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-http/client-common.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/client-common) +[![Quality Score](https://img.shields.io/scrutinizer/g/php-http/client-common.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/client-common) +[![Total Downloads](https://img.shields.io/packagist/dt/php-http/client-common.svg?style=flat-square)](https://packagist.org/packages/php-http/client-common) + +**Common HTTP Client implementations and tools for HTTPlug.** + + +## Install + +Via Composer + +``` bash +$ composer require php-http/client-common +``` + + +## Usage + +This package provides common tools for HTTP Clients: + +- BatchClient to handle sending requests in parallel +- A convenience client with HTTP method names as class methods +- Emulator, decorator layers for sync/async clients + + +## Documentation + +Please see the [official documentation](http://docs.php-http.org/en/latest/components/client-common.html). + + +## Testing + +``` bash +$ composer test +``` + + +## Contributing + +Please see our [contributing guide](http://docs.php-http.org/en/latest/development/contributing.html). + + +## Security + +If you discover any security related issues, please contact us at [security@php-http.org](mailto:security@php-http.org). + + +## License + +The MIT License (MIT). Please see [License File](LICENSE) for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/composer.json b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/composer.json new file mode 100644 index 0000000..fc5fc5f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/composer.json @@ -0,0 +1,43 @@ +{ + "name": "php-http/client-common", + "description": "Common HTTP Client implementations and tools for HTTPlug", + "license": "MIT", + "keywords": ["http", "client", "httplug", "common"], + "homepage": "http://httplug.io", + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "require": { + "php": "^5.4 || ^7.0", + "php-http/httplug": "^1.1", + "php-http/message-factory": "^1.0", + "php-http/message": "^1.6", + "symfony/options-resolver": "^2.6 || ^3.0 || ^4.0" + }, + "require-dev": { + "phpspec/phpspec": "^2.5 || ^3.4 || ^4.2", + "guzzlehttp/psr7": "^1.4" + }, + "suggest": { + "php-http/logger-plugin": "PSR-3 Logger plugin", + "php-http/cache-plugin": "PSR-6 Cache plugin", + "php-http/stopwatch-plugin": "Symfony Stopwatch plugin" + }, + "autoload": { + "psr-4": { + "Http\\Client\\Common\\": "src/" + } + }, + "scripts": { + "test": "vendor/bin/phpspec run", + "test-ci": "vendor/bin/phpspec run -c phpspec.ci.yml" + }, + "extra": { + "branch-alias": { + "dev-master": "1.7-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/BatchClient.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/BatchClient.php new file mode 100644 index 0000000..2036355 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/BatchClient.php @@ -0,0 +1,73 @@ + + */ +class BatchClient implements HttpClient +{ + /** + * @var HttpClient + */ + private $client; + + /** + * @param HttpClient $client + */ + public function __construct(HttpClient $client) + { + $this->client = $client; + } + + /** + * {@inheritdoc} + */ + public function sendRequest(RequestInterface $request) + { + return $this->client->sendRequest($request); + } + + /** + * Send several requests. + * + * You may not assume that the requests are executed in a particular order. If the order matters + * for your application, use sendRequest sequentially. + * + * @param RequestInterface[] The requests to send + * + * @return BatchResult Containing one result per request + * + * @throws BatchException If one or more requests fails. The exception gives access to the + * BatchResult with a map of request to result for success, request to + * exception for failures + */ + public function sendRequests(array $requests) + { + $batchResult = new BatchResult(); + + foreach ($requests as $request) { + try { + $response = $this->sendRequest($request); + $batchResult = $batchResult->addResponse($request, $response); + } catch (Exception $e) { + $batchResult = $batchResult->addException($request, $e); + } + } + + if ($batchResult->hasExceptions()) { + throw new BatchException($batchResult); + } + + return $batchResult; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/BatchResult.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/BatchResult.php new file mode 100644 index 0000000..710611d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/BatchResult.php @@ -0,0 +1,181 @@ + + */ +final class BatchResult +{ + /** + * @var \SplObjectStorage + */ + private $responses; + + /** + * @var \SplObjectStorage + */ + private $exceptions; + + public function __construct() + { + $this->responses = new \SplObjectStorage(); + $this->exceptions = new \SplObjectStorage(); + } + + /** + * Checks if there are any successful responses at all. + * + * @return bool + */ + public function hasResponses() + { + return $this->responses->count() > 0; + } + + /** + * Returns all successful responses. + * + * @return ResponseInterface[] + */ + public function getResponses() + { + $responses = []; + + foreach ($this->responses as $request) { + $responses[] = $this->responses[$request]; + } + + return $responses; + } + + /** + * Checks if there is a successful response for a request. + * + * @param RequestInterface $request + * + * @return bool + */ + public function isSuccessful(RequestInterface $request) + { + return $this->responses->contains($request); + } + + /** + * Returns the response for a successful request. + * + * @param RequestInterface $request + * + * @return ResponseInterface + * + * @throws \UnexpectedValueException If request was not part of the batch or failed + */ + public function getResponseFor(RequestInterface $request) + { + try { + return $this->responses[$request]; + } catch (\UnexpectedValueException $e) { + throw new \UnexpectedValueException('Request not found', $e->getCode(), $e); + } + } + + /** + * Adds a response in an immutable way. + * + * @param RequestInterface $request + * @param ResponseInterface $response + * + * @return BatchResult the new BatchResult with this request-response pair added to it + */ + public function addResponse(RequestInterface $request, ResponseInterface $response) + { + $new = clone $this; + $new->responses->attach($request, $response); + + return $new; + } + + /** + * Checks if there are any unsuccessful requests at all. + * + * @return bool + */ + public function hasExceptions() + { + return $this->exceptions->count() > 0; + } + + /** + * Returns all exceptions for the unsuccessful requests. + * + * @return Exception[] + */ + public function getExceptions() + { + $exceptions = []; + + foreach ($this->exceptions as $request) { + $exceptions[] = $this->exceptions[$request]; + } + + return $exceptions; + } + + /** + * Checks if there is an exception for a request, meaning the request failed. + * + * @param RequestInterface $request + * + * @return bool + */ + public function isFailed(RequestInterface $request) + { + return $this->exceptions->contains($request); + } + + /** + * Returns the exception for a failed request. + * + * @param RequestInterface $request + * + * @return Exception + * + * @throws \UnexpectedValueException If request was not part of the batch or was successful + */ + public function getExceptionFor(RequestInterface $request) + { + try { + return $this->exceptions[$request]; + } catch (\UnexpectedValueException $e) { + throw new \UnexpectedValueException('Request not found', $e->getCode(), $e); + } + } + + /** + * Adds an exception in an immutable way. + * + * @param RequestInterface $request + * @param Exception $exception + * + * @return BatchResult the new BatchResult with this request-exception pair added to it + */ + public function addException(RequestInterface $request, Exception $exception) + { + $new = clone $this; + $new->exceptions->attach($request, $exception); + + return $new; + } + + public function __clone() + { + $this->responses = clone $this->responses; + $this->exceptions = clone $this->exceptions; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/EmulatedHttpAsyncClient.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/EmulatedHttpAsyncClient.php new file mode 100644 index 0000000..1b16316 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/EmulatedHttpAsyncClient.php @@ -0,0 +1,27 @@ + + */ +class EmulatedHttpAsyncClient implements HttpClient, HttpAsyncClient +{ + use HttpAsyncClientEmulator; + use HttpClientDecorator; + + /** + * @param HttpClient $httpClient + */ + public function __construct(HttpClient $httpClient) + { + $this->httpClient = $httpClient; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/EmulatedHttpClient.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/EmulatedHttpClient.php new file mode 100644 index 0000000..01046c8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/EmulatedHttpClient.php @@ -0,0 +1,27 @@ + + */ +class EmulatedHttpClient implements HttpClient, HttpAsyncClient +{ + use HttpAsyncClientDecorator; + use HttpClientEmulator; + + /** + * @param HttpAsyncClient $httpAsyncClient + */ + public function __construct(HttpAsyncClient $httpAsyncClient) + { + $this->httpAsyncClient = $httpAsyncClient; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/BatchException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/BatchException.php new file mode 100644 index 0000000..66a9271 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/BatchException.php @@ -0,0 +1,39 @@ + + */ +final class BatchException extends TransferException +{ + /** + * @var BatchResult + */ + private $result; + + /** + * @param BatchResult $result + */ + public function __construct(BatchResult $result) + { + $this->result = $result; + } + + /** + * Returns the BatchResult that contains all responses and exceptions. + * + * @return BatchResult + */ + public function getResult() + { + return $this->result; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/CircularRedirectionException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/CircularRedirectionException.php new file mode 100644 index 0000000..73ec521 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/CircularRedirectionException.php @@ -0,0 +1,14 @@ + + */ +class CircularRedirectionException extends HttpException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/ClientErrorException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/ClientErrorException.php new file mode 100644 index 0000000..b1f6cc8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/ClientErrorException.php @@ -0,0 +1,14 @@ + + */ +class ClientErrorException extends HttpException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/HttpClientNotFoundException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/HttpClientNotFoundException.php new file mode 100644 index 0000000..5d33f98 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/HttpClientNotFoundException.php @@ -0,0 +1,14 @@ + + */ +class HttpClientNotFoundException extends TransferException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/LoopException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/LoopException.php new file mode 100644 index 0000000..e834124 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/LoopException.php @@ -0,0 +1,14 @@ + + */ +class LoopException extends RequestException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/MultipleRedirectionException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/MultipleRedirectionException.php new file mode 100644 index 0000000..ae514cd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/MultipleRedirectionException.php @@ -0,0 +1,14 @@ + + */ +class MultipleRedirectionException extends HttpException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/ServerErrorException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/ServerErrorException.php new file mode 100644 index 0000000..665d724 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Exception/ServerErrorException.php @@ -0,0 +1,14 @@ + + */ +class ServerErrorException extends HttpException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/FlexibleHttpClient.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/FlexibleHttpClient.php new file mode 100644 index 0000000..58f8813 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/FlexibleHttpClient.php @@ -0,0 +1,39 @@ + + */ +final class FlexibleHttpClient implements HttpClient, HttpAsyncClient +{ + use HttpClientDecorator; + use HttpAsyncClientDecorator; + + /** + * @param HttpClient|HttpAsyncClient $client + */ + public function __construct($client) + { + if (!($client instanceof HttpClient) && !($client instanceof HttpAsyncClient)) { + throw new \LogicException('Client must be an instance of Http\\Client\\HttpClient or Http\\Client\\HttpAsyncClient'); + } + + $this->httpClient = $client; + $this->httpAsyncClient = $client; + + if (!($this->httpClient instanceof HttpClient)) { + $this->httpClient = new EmulatedHttpClient($this->httpClient); + } + + if (!($this->httpAsyncClient instanceof HttpAsyncClient)) { + $this->httpAsyncClient = new EmulatedHttpAsyncClient($this->httpAsyncClient); + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpAsyncClientDecorator.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpAsyncClientDecorator.php new file mode 100644 index 0000000..6eb576c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpAsyncClientDecorator.php @@ -0,0 +1,29 @@ + + */ +trait HttpAsyncClientDecorator +{ + /** + * @var HttpAsyncClient + */ + protected $httpAsyncClient; + + /** + * {@inheritdoc} + * + * @see HttpAsyncClient::sendAsyncRequest + */ + public function sendAsyncRequest(RequestInterface $request) + { + return $this->httpAsyncClient->sendAsyncRequest($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpAsyncClientEmulator.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpAsyncClientEmulator.php new file mode 100644 index 0000000..c0ba354 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpAsyncClientEmulator.php @@ -0,0 +1,36 @@ + + */ +trait HttpAsyncClientEmulator +{ + /** + * {@inheritdoc} + * + * @see HttpClient::sendRequest + */ + abstract public function sendRequest(RequestInterface $request); + + /** + * {@inheritdoc} + * + * @see HttpAsyncClient::sendAsyncRequest + */ + public function sendAsyncRequest(RequestInterface $request) + { + try { + return new Promise\HttpFulfilledPromise($this->sendRequest($request)); + } catch (Exception $e) { + return new Promise\HttpRejectedPromise($e); + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientDecorator.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientDecorator.php new file mode 100644 index 0000000..a33d5ef --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientDecorator.php @@ -0,0 +1,29 @@ + + */ +trait HttpClientDecorator +{ + /** + * @var HttpClient + */ + protected $httpClient; + + /** + * {@inheritdoc} + * + * @see HttpClient::sendRequest + */ + public function sendRequest(RequestInterface $request) + { + return $this->httpClient->sendRequest($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientEmulator.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientEmulator.php new file mode 100644 index 0000000..dbec1ab --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientEmulator.php @@ -0,0 +1,32 @@ + + */ +trait HttpClientEmulator +{ + /** + * {@inheritdoc} + * + * @see HttpClient::sendRequest + */ + public function sendRequest(RequestInterface $request) + { + $promise = $this->sendAsyncRequest($request); + + return $promise->wait(); + } + + /** + * {@inheritdoc} + * + * @see HttpAsyncClient::sendAsyncRequest + */ + abstract public function sendAsyncRequest(RequestInterface $request); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool.php new file mode 100644 index 0000000..7ac292c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool.php @@ -0,0 +1,59 @@ +clientPool[] = $client; + } + + /** + * Return an http client given a specific strategy. + * + * @throws HttpClientNotFoundException When no http client has been found into the pool + * + * @return HttpClientPoolItem Return a http client that can do both sync or async + */ + abstract protected function chooseHttpClient(); + + /** + * {@inheritdoc} + */ + public function sendAsyncRequest(RequestInterface $request) + { + return $this->chooseHttpClient()->sendAsyncRequest($request); + } + + /** + * {@inheritdoc} + */ + public function sendRequest(RequestInterface $request) + { + return $this->chooseHttpClient()->sendRequest($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/LeastUsedClientPool.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/LeastUsedClientPool.php new file mode 100644 index 0000000..6299cce --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/LeastUsedClientPool.php @@ -0,0 +1,45 @@ + + */ +final class LeastUsedClientPool extends HttpClientPool +{ + /** + * {@inheritdoc} + */ + protected function chooseHttpClient() + { + $clientPool = array_filter($this->clientPool, function (HttpClientPoolItem $clientPoolItem) { + return !$clientPoolItem->isDisabled(); + }); + + if (0 === count($clientPool)) { + throw new HttpClientNotFoundException('Cannot choose a http client as there is no one present in the pool'); + } + + usort($clientPool, function (HttpClientPoolItem $clientA, HttpClientPoolItem $clientB) { + if ($clientA->getSendingRequestCount() === $clientB->getSendingRequestCount()) { + return 0; + } + + if ($clientA->getSendingRequestCount() < $clientB->getSendingRequestCount()) { + return -1; + } + + return 1; + }); + + return reset($clientPool); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/RandomClientPool.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/RandomClientPool.php new file mode 100644 index 0000000..3255f86 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/RandomClientPool.php @@ -0,0 +1,31 @@ + + */ +final class RandomClientPool extends HttpClientPool +{ + /** + * {@inheritdoc} + */ + protected function chooseHttpClient() + { + $clientPool = array_filter($this->clientPool, function (HttpClientPoolItem $clientPoolItem) { + return !$clientPoolItem->isDisabled(); + }); + + if (0 === count($clientPool)) { + throw new HttpClientNotFoundException('Cannot choose a http client as there is no one present in the pool'); + } + + return $clientPool[array_rand($clientPool)]; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/RoundRobinClientPool.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/RoundRobinClientPool.php new file mode 100644 index 0000000..8d8e40a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPool/RoundRobinClientPool.php @@ -0,0 +1,41 @@ + + */ +final class RoundRobinClientPool extends HttpClientPool +{ + /** + * {@inheritdoc} + */ + protected function chooseHttpClient() + { + $last = current($this->clientPool); + + do { + $client = next($this->clientPool); + + if (false === $client) { + $client = reset($this->clientPool); + + if (false === $client) { + throw new HttpClientNotFoundException('Cannot choose a http client as there is no one present in the pool'); + } + } + + // Case when there is only one and the last one has been disabled + if ($last === $client && $client->isDisabled()) { + throw new HttpClientNotFoundException('Cannot choose a http client as there is no one enabled in the pool'); + } + } while ($client->isDisabled()); + + return $client; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPoolItem.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPoolItem.php new file mode 100644 index 0000000..09cd6dd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientPoolItem.php @@ -0,0 +1,178 @@ + + */ +class HttpClientPoolItem implements HttpClient, HttpAsyncClient +{ + /** + * @var int Number of request this client is currently sending + */ + private $sendingRequestCount = 0; + + /** + * @var \DateTime|null Time when this client has been disabled or null if enable + */ + private $disabledAt; + + /** + * @var int|null Number of seconds after this client is reenable, by default null: never reenable this client + */ + private $reenableAfter; + + /** + * @var FlexibleHttpClient A http client responding to async and sync request + */ + private $client; + + /** + * @param HttpClient|HttpAsyncClient $client + * @param null|int $reenableAfter Number of seconds after this client is reenable + */ + public function __construct($client, $reenableAfter = null) + { + $this->client = new FlexibleHttpClient($client); + $this->reenableAfter = $reenableAfter; + } + + /** + * {@inheritdoc} + */ + public function sendRequest(RequestInterface $request) + { + if ($this->isDisabled()) { + throw new Exception\RequestException('Cannot send the request as this client has been disabled', $request); + } + + try { + $this->incrementRequestCount(); + $response = $this->client->sendRequest($request); + $this->decrementRequestCount(); + } catch (Exception $e) { + $this->disable(); + $this->decrementRequestCount(); + + throw $e; + } + + return $response; + } + + /** + * {@inheritdoc} + */ + public function sendAsyncRequest(RequestInterface $request) + { + if ($this->isDisabled()) { + throw new Exception\RequestException('Cannot send the request as this client has been disabled', $request); + } + + $this->incrementRequestCount(); + + return $this->client->sendAsyncRequest($request)->then(function ($response) { + $this->decrementRequestCount(); + + return $response; + }, function ($exception) { + $this->disable(); + $this->decrementRequestCount(); + + throw $exception; + }); + } + + /** + * Whether this client is disabled or not. + * + * Will also reactivate this client if possible + * + * @internal + * + * @return bool + */ + public function isDisabled() + { + $disabledAt = $this->getDisabledAt(); + + if (null !== $this->reenableAfter && null !== $disabledAt) { + // Reenable after a certain time + $now = new \DateTime(); + + if (($now->getTimestamp() - $disabledAt->getTimestamp()) >= $this->reenableAfter) { + $this->enable(); + + return false; + } + + return true; + } + + return null !== $disabledAt; + } + + /** + * Get current number of request that is send by the underlying http client. + * + * @internal + * + * @return int + */ + public function getSendingRequestCount() + { + return $this->sendingRequestCount; + } + + /** + * Return when this client has been disabled or null if it's enabled. + * + * @return \DateTime|null + */ + private function getDisabledAt() + { + return $this->disabledAt; + } + + /** + * Increment the request count. + */ + private function incrementRequestCount() + { + ++$this->sendingRequestCount; + } + + /** + * Decrement the request count. + */ + private function decrementRequestCount() + { + --$this->sendingRequestCount; + } + + /** + * Enable the current client. + */ + private function enable() + { + $this->disabledAt = null; + } + + /** + * Disable the current client. + */ + private function disable() + { + $this->disabledAt = new \DateTime('now'); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientRouter.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientRouter.php new file mode 100644 index 0000000..9f72133 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpClientRouter.php @@ -0,0 +1,74 @@ + + */ +final class HttpClientRouter implements HttpClient, HttpAsyncClient +{ + /** + * @var array + */ + private $clients = []; + + /** + * {@inheritdoc} + */ + public function sendRequest(RequestInterface $request) + { + $client = $this->chooseHttpClient($request); + + return $client->sendRequest($request); + } + + /** + * {@inheritdoc} + */ + public function sendAsyncRequest(RequestInterface $request) + { + $client = $this->chooseHttpClient($request); + + return $client->sendAsyncRequest($request); + } + + /** + * Add a client to the router. + * + * @param HttpClient|HttpAsyncClient $client + * @param RequestMatcher $requestMatcher + */ + public function addClient($client, RequestMatcher $requestMatcher) + { + $this->clients[] = [ + 'matcher' => $requestMatcher, + 'client' => new FlexibleHttpClient($client), + ]; + } + + /** + * Choose an HTTP client given a specific request. + * + * @param RequestInterface $request + * + * @return HttpClient|HttpAsyncClient + */ + protected function chooseHttpClient(RequestInterface $request) + { + foreach ($this->clients as $client) { + if ($client['matcher']->matches($request)) { + return $client['client']; + } + } + + throw new RequestException('No client found for the specified request', $request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpMethodsClient.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpMethodsClient.php new file mode 100644 index 0000000..58804fc --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/HttpMethodsClient.php @@ -0,0 +1,205 @@ +get('/foo') + * ->post('/bar') + * ; + * + * The client also exposes the sendRequest methods of the wrapped HttpClient. + * + * @author Márk Sági-Kazár + * @author David Buchmann + */ +class HttpMethodsClient implements HttpClient +{ + /** + * @var HttpClient + */ + private $httpClient; + + /** + * @var RequestFactory + */ + private $requestFactory; + + /** + * @param HttpClient $httpClient The client to send requests with + * @param RequestFactory $requestFactory The message factory to create requests + */ + public function __construct(HttpClient $httpClient, RequestFactory $requestFactory) + { + $this->httpClient = $httpClient; + $this->requestFactory = $requestFactory; + } + + /** + * Sends a GET request. + * + * @param string|UriInterface $uri + * @param array $headers + * + * @throws Exception + * + * @return ResponseInterface + */ + public function get($uri, array $headers = []) + { + return $this->send('GET', $uri, $headers, null); + } + + /** + * Sends an HEAD request. + * + * @param string|UriInterface $uri + * @param array $headers + * + * @throws Exception + * + * @return ResponseInterface + */ + public function head($uri, array $headers = []) + { + return $this->send('HEAD', $uri, $headers, null); + } + + /** + * Sends a TRACE request. + * + * @param string|UriInterface $uri + * @param array $headers + * + * @throws Exception + * + * @return ResponseInterface + */ + public function trace($uri, array $headers = []) + { + return $this->send('TRACE', $uri, $headers, null); + } + + /** + * Sends a POST request. + * + * @param string|UriInterface $uri + * @param array $headers + * @param string|StreamInterface|null $body + * + * @throws Exception + * + * @return ResponseInterface + */ + public function post($uri, array $headers = [], $body = null) + { + return $this->send('POST', $uri, $headers, $body); + } + + /** + * Sends a PUT request. + * + * @param string|UriInterface $uri + * @param array $headers + * @param string|StreamInterface|null $body + * + * @throws Exception + * + * @return ResponseInterface + */ + public function put($uri, array $headers = [], $body = null) + { + return $this->send('PUT', $uri, $headers, $body); + } + + /** + * Sends a PATCH request. + * + * @param string|UriInterface $uri + * @param array $headers + * @param string|StreamInterface|null $body + * + * @throws Exception + * + * @return ResponseInterface + */ + public function patch($uri, array $headers = [], $body = null) + { + return $this->send('PATCH', $uri, $headers, $body); + } + + /** + * Sends a DELETE request. + * + * @param string|UriInterface $uri + * @param array $headers + * @param string|StreamInterface|null $body + * + * @throws Exception + * + * @return ResponseInterface + */ + public function delete($uri, array $headers = [], $body = null) + { + return $this->send('DELETE', $uri, $headers, $body); + } + + /** + * Sends an OPTIONS request. + * + * @param string|UriInterface $uri + * @param array $headers + * @param string|StreamInterface|null $body + * + * @throws Exception + * + * @return ResponseInterface + */ + public function options($uri, array $headers = [], $body = null) + { + return $this->send('OPTIONS', $uri, $headers, $body); + } + + /** + * Sends a request with any HTTP method. + * + * @param string $method HTTP method to use + * @param string|UriInterface $uri + * @param array $headers + * @param string|StreamInterface|null $body + * + * @throws Exception + * + * @return ResponseInterface + */ + public function send($method, $uri, array $headers = [], $body = null) + { + return $this->sendRequest($this->requestFactory->createRequest( + $method, + $uri, + $headers, + $body + )); + } + + /** + * Forward to the underlying HttpClient. + * + * {@inheritdoc} + */ + public function sendRequest(RequestInterface $request) + { + return $this->httpClient->sendRequest($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin.php new file mode 100644 index 0000000..89a2a62 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin.php @@ -0,0 +1,32 @@ + + */ +interface Plugin +{ + /** + * Handle the request and return the response coming from the next callable. + * + * @see http://docs.php-http.org/en/latest/plugins/build-your-own.html + * + * @param RequestInterface $request + * @param callable $next Next middleware in the chain, the request is passed as the first argument + * @param callable $first First middleware in the chain, used to to restart a request + * + * @return Promise Resolves a PSR-7 Response or fails with an Http\Client\Exception (The same as HttpAsyncClient). + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AddHostPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AddHostPlugin.php new file mode 100644 index 0000000..29ab8ae --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AddHostPlugin.php @@ -0,0 +1,77 @@ + + */ +final class AddHostPlugin implements Plugin +{ + /** + * @var UriInterface + */ + private $host; + + /** + * @var bool + */ + private $replace; + + /** + * @param UriInterface $host + * @param array $config { + * + * @var bool $replace True will replace all hosts, false will only add host when none is specified. + * } + */ + public function __construct(UriInterface $host, array $config = []) + { + if ('' === $host->getHost()) { + throw new \LogicException('Host can not be empty'); + } + + $this->host = $host; + + $resolver = new OptionsResolver(); + $this->configureOptions($resolver); + $options = $resolver->resolve($config); + + $this->replace = $options['replace']; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + if ($this->replace || '' === $request->getUri()->getHost()) { + $uri = $request->getUri() + ->withHost($this->host->getHost()) + ->withScheme($this->host->getScheme()) + ->withPort($this->host->getPort()) + ; + + $request = $request->withUri($uri); + } + + return $next($request); + } + + /** + * @param OptionsResolver $resolver + */ + private function configureOptions(OptionsResolver $resolver) + { + $resolver->setDefaults([ + 'replace' => false, + ]); + $resolver->setAllowedTypes('replace', 'bool'); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AddPathPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AddPathPlugin.php new file mode 100644 index 0000000..e24d61a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AddPathPlugin.php @@ -0,0 +1,48 @@ + + */ +final class AddPathPlugin implements Plugin +{ + /** + * @var UriInterface + */ + private $uri; + + /** + * @param UriInterface $uri + */ + public function __construct(UriInterface $uri) + { + if ('' === $uri->getPath()) { + throw new \LogicException('URI path cannot be empty'); + } + + if ('/' === substr($uri->getPath(), -1)) { + throw new \LogicException('URI path cannot end with a slash.'); + } + + $this->uri = $uri; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + $request = $request->withUri($request->getUri() + ->withPath($this->uri->getPath().$request->getUri()->getPath()) + ); + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AuthenticationPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AuthenticationPlugin.php new file mode 100644 index 0000000..194712f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/AuthenticationPlugin.php @@ -0,0 +1,38 @@ + + */ +final class AuthenticationPlugin implements Plugin +{ + /** + * @var Authentication An authentication system + */ + private $authentication; + + /** + * @param Authentication $authentication + */ + public function __construct(Authentication $authentication) + { + $this->authentication = $authentication; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + $request = $this->authentication->authenticate($request); + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/BaseUriPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/BaseUriPlugin.php new file mode 100644 index 0000000..2c2a775 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/BaseUriPlugin.php @@ -0,0 +1,54 @@ + + */ +final class BaseUriPlugin implements Plugin +{ + /** + * @var AddHostPlugin + */ + private $addHostPlugin; + + /** + * @var AddPathPlugin|null + */ + private $addPathPlugin = null; + + /** + * @param UriInterface $uri Has to contain a host name and cans have a path. + * @param array $hostConfig Config for AddHostPlugin. @see AddHostPlugin::configureOptions + */ + public function __construct(UriInterface $uri, array $hostConfig = []) + { + $this->addHostPlugin = new AddHostPlugin($uri, $hostConfig); + + if (rtrim($uri->getPath(), '/')) { + $this->addPathPlugin = new AddPathPlugin($uri); + } + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + $addHostNext = function (RequestInterface $request) use ($next, $first) { + return $this->addHostPlugin->handleRequest($request, $next, $first); + }; + + if ($this->addPathPlugin) { + return $this->addPathPlugin->handleRequest($request, $addHostNext, $first); + } + + return $addHostNext($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ContentLengthPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ContentLengthPlugin.php new file mode 100644 index 0000000..0f7aafa --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ContentLengthPlugin.php @@ -0,0 +1,36 @@ + + */ +final class ContentLengthPlugin implements Plugin +{ + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + if (!$request->hasHeader('Content-Length')) { + $stream = $request->getBody(); + + // Cannot determine the size so we use a chunk stream + if (null === $stream->getSize()) { + $stream = new ChunkStream($stream); + $request = $request->withBody($stream); + $request = $request->withAddedHeader('Transfer-Encoding', 'chunked'); + } else { + $request = $request->withHeader('Content-Length', (string) $stream->getSize()); + } + } + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ContentTypePlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ContentTypePlugin.php new file mode 100644 index 0000000..8ef1d62 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ContentTypePlugin.php @@ -0,0 +1,123 @@ + + */ +final class ContentTypePlugin implements Plugin +{ + /** + * Allow to disable the content type detection when stream is too large (as it can consume a lot of resource). + * + * @var bool + * + * true skip the content type detection + * false detect the content type (default value) + */ + protected $skipDetection; + + /** + * Determine the size stream limit for which the detection as to be skipped (default to 16Mb). + * + * @var int + */ + protected $sizeLimit; + + /** + * @param array $config { + * + * @var bool $skip_detection True skip detection if stream size is bigger than $size_limit. + * @var int $size_limit size stream limit for which the detection as to be skipped. + * } + */ + public function __construct(array $config = []) + { + $resolver = new OptionsResolver(); + $resolver->setDefaults([ + 'skip_detection' => false, + 'size_limit' => 16000000, + ]); + $resolver->setAllowedTypes('skip_detection', 'bool'); + $resolver->setAllowedTypes('size_limit', 'int'); + + $options = $resolver->resolve($config); + + $this->skipDetection = $options['skip_detection']; + $this->sizeLimit = $options['size_limit']; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + if (!$request->hasHeader('Content-Type')) { + $stream = $request->getBody(); + $streamSize = $stream->getSize(); + + if (!$stream->isSeekable()) { + return $next($request); + } + + if (0 === $streamSize) { + return $next($request); + } + + if ($this->skipDetection && (null === $streamSize || $streamSize >= $this->sizeLimit)) { + return $next($request); + } + + if ($this->isJson($stream)) { + $request = $request->withHeader('Content-Type', 'application/json'); + + return $next($request); + } + + if ($this->isXml($stream)) { + $request = $request->withHeader('Content-Type', 'application/xml'); + + return $next($request); + } + } + + return $next($request); + } + + /** + * @param $stream StreamInterface + * + * @return bool + */ + private function isJson($stream) + { + $stream->rewind(); + + json_decode($stream->getContents()); + + return JSON_ERROR_NONE === json_last_error(); + } + + /** + * @param $stream StreamInterface + * + * @return \SimpleXMLElement|false + */ + private function isXml($stream) + { + $stream->rewind(); + + $previousValue = libxml_use_internal_errors(true); + $isXml = simplexml_load_string($stream->getContents()); + libxml_use_internal_errors($previousValue); + + return $isXml; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/CookiePlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/CookiePlugin.php new file mode 100644 index 0000000..59ee90d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/CookiePlugin.php @@ -0,0 +1,180 @@ + + */ +final class CookiePlugin implements Plugin +{ + /** + * Cookie storage. + * + * @var CookieJar + */ + private $cookieJar; + + /** + * @param CookieJar $cookieJar + */ + public function __construct(CookieJar $cookieJar) + { + $this->cookieJar = $cookieJar; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + foreach ($this->cookieJar->getCookies() as $cookie) { + if ($cookie->isExpired()) { + continue; + } + + if (!$cookie->matchDomain($request->getUri()->getHost())) { + continue; + } + + if (!$cookie->matchPath($request->getUri()->getPath())) { + continue; + } + + if ($cookie->isSecure() && ('https' !== $request->getUri()->getScheme())) { + continue; + } + + $request = $request->withAddedHeader('Cookie', sprintf('%s=%s', $cookie->getName(), $cookie->getValue())); + } + + return $next($request)->then(function (ResponseInterface $response) use ($request) { + if ($response->hasHeader('Set-Cookie')) { + $setCookies = $response->getHeader('Set-Cookie'); + + foreach ($setCookies as $setCookie) { + $cookie = $this->createCookie($request, $setCookie); + + // Cookie invalid do not use it + if (null === $cookie) { + continue; + } + + // Restrict setting cookie from another domain + if (!preg_match("/\.{$cookie->getDomain()}$/", '.'.$request->getUri()->getHost())) { + continue; + } + + $this->cookieJar->addCookie($cookie); + } + } + + return $response; + }); + } + + /** + * Creates a cookie from a string. + * + * @param RequestInterface $request + * @param $setCookie + * + * @return Cookie|null + * + * @throws TransferException + */ + private function createCookie(RequestInterface $request, $setCookie) + { + $parts = array_map('trim', explode(';', $setCookie)); + + if (empty($parts) || !strpos($parts[0], '=')) { + return; + } + + list($name, $cookieValue) = $this->createValueKey(array_shift($parts)); + + $maxAge = null; + $expires = null; + $domain = $request->getUri()->getHost(); + $path = $request->getUri()->getPath(); + $secure = false; + $httpOnly = false; + + // Add the cookie pieces into the parsed data array + foreach ($parts as $part) { + list($key, $value) = $this->createValueKey($part); + + switch (strtolower($key)) { + case 'expires': + try { + $expires = CookieUtil::parseDate($value); + } catch (UnexpectedValueException $e) { + throw new TransferException( + sprintf( + 'Cookie header `%s` expires value `%s` could not be converted to date', + $name, + $value + ), + null, + $e + ); + } + + break; + + case 'max-age': + $maxAge = (int) $value; + + break; + + case 'domain': + $domain = $value; + + break; + + case 'path': + $path = $value; + + break; + + case 'secure': + $secure = true; + + break; + + case 'httponly': + $httpOnly = true; + + break; + } + } + + return new Cookie($name, $cookieValue, $maxAge, $domain, $path, $secure, $httpOnly, $expires); + } + + /** + * Separates key/value pair from cookie. + * + * @param $part + * + * @return array + */ + private function createValueKey($part) + { + $parts = explode('=', $part, 2); + $key = trim($parts[0]); + $value = isset($parts[1]) ? trim($parts[1]) : true; + + return [$key, $value]; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/DecoderPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/DecoderPlugin.php new file mode 100644 index 0000000..b661b61 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/DecoderPlugin.php @@ -0,0 +1,140 @@ + + */ +final class DecoderPlugin implements Plugin +{ + /** + * @var bool Whether this plugin decode stream with value in the Content-Encoding header (default to true). + * + * If set to false only the Transfer-Encoding header will be used + */ + private $useContentEncoding; + + /** + * @param array $config { + * + * @var bool $use_content_encoding Whether this plugin should look at the Content-Encoding header first or only at the Transfer-Encoding (defaults to true). + * } + */ + public function __construct(array $config = []) + { + $resolver = new OptionsResolver(); + $resolver->setDefaults([ + 'use_content_encoding' => true, + ]); + $resolver->setAllowedTypes('use_content_encoding', 'bool'); + $options = $resolver->resolve($config); + + $this->useContentEncoding = $options['use_content_encoding']; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + $encodings = extension_loaded('zlib') ? ['gzip', 'deflate'] : ['identity']; + + if ($this->useContentEncoding) { + $request = $request->withHeader('Accept-Encoding', $encodings); + } + $encodings[] = 'chunked'; + $request = $request->withHeader('TE', $encodings); + + return $next($request)->then(function (ResponseInterface $response) { + return $this->decodeResponse($response); + }); + } + + /** + * Decode a response body given its Transfer-Encoding or Content-Encoding value. + * + * @param ResponseInterface $response Response to decode + * + * @return ResponseInterface New response decoded + */ + private function decodeResponse(ResponseInterface $response) + { + $response = $this->decodeOnEncodingHeader('Transfer-Encoding', $response); + + if ($this->useContentEncoding) { + $response = $this->decodeOnEncodingHeader('Content-Encoding', $response); + } + + return $response; + } + + /** + * Decode a response on a specific header (content encoding or transfer encoding mainly). + * + * @param string $headerName Name of the header + * @param ResponseInterface $response Response + * + * @return ResponseInterface A new instance of the response decoded + */ + private function decodeOnEncodingHeader($headerName, ResponseInterface $response) + { + if ($response->hasHeader($headerName)) { + $encodings = $response->getHeader($headerName); + $newEncodings = []; + + while ($encoding = array_pop($encodings)) { + $stream = $this->decorateStream($encoding, $response->getBody()); + + if (false === $stream) { + array_unshift($newEncodings, $encoding); + + continue; + } + + $response = $response->withBody($stream); + } + + $response = $response->withHeader($headerName, $newEncodings); + } + + return $response; + } + + /** + * Decorate a stream given an encoding. + * + * @param string $encoding + * @param StreamInterface $stream + * + * @return StreamInterface|false A new stream interface or false if encoding is not supported + */ + private function decorateStream($encoding, StreamInterface $stream) + { + if ('chunked' === strtolower($encoding)) { + return new Encoding\DechunkStream($stream); + } + + if ('deflate' === strtolower($encoding)) { + return new Encoding\DecompressStream($stream); + } + + if ('gzip' === strtolower($encoding)) { + return new Encoding\GzipDecodeStream($stream); + } + + return false; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ErrorPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ErrorPlugin.php new file mode 100644 index 0000000..f09d3b1 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/ErrorPlugin.php @@ -0,0 +1,55 @@ + + */ +final class ErrorPlugin implements Plugin +{ + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + $promise = $next($request); + + return $promise->then(function (ResponseInterface $response) use ($request) { + return $this->transformResponseToException($request, $response); + }); + } + + /** + * Transform response to an error if possible. + * + * @param RequestInterface $request Request of the call + * @param ResponseInterface $response Response of the call + * + * @throws ClientErrorException If response status code is a 4xx + * @throws ServerErrorException If response status code is a 5xx + * + * @return ResponseInterface If status code is not in 4xx or 5xx return response + */ + protected function transformResponseToException(RequestInterface $request, ResponseInterface $response) + { + if ($response->getStatusCode() >= 400 && $response->getStatusCode() < 500) { + throw new ClientErrorException($response->getReasonPhrase(), $request, $response); + } + + if ($response->getStatusCode() >= 500 && $response->getStatusCode() < 600) { + throw new ServerErrorException($response->getReasonPhrase(), $request, $response); + } + + return $response; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderAppendPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderAppendPlugin.php new file mode 100644 index 0000000..26fd813 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderAppendPlugin.php @@ -0,0 +1,45 @@ + + */ +final class HeaderAppendPlugin implements Plugin +{ + /** + * @var array + */ + private $headers = []; + + /** + * @param array $headers Hashmap of header name to header value + */ + public function __construct(array $headers) + { + $this->headers = $headers; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + foreach ($this->headers as $header => $headerValue) { + $request = $request->withAddedHeader($header, $headerValue); + } + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderDefaultsPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderDefaultsPlugin.php new file mode 100644 index 0000000..6dfc111 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderDefaultsPlugin.php @@ -0,0 +1,43 @@ + + */ +final class HeaderDefaultsPlugin implements Plugin +{ + /** + * @var array + */ + private $headers = []; + + /** + * @param array $headers Hashmap of header name to header value + */ + public function __construct(array $headers) + { + $this->headers = $headers; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + foreach ($this->headers as $header => $headerValue) { + if (!$request->hasHeader($header)) { + $request = $request->withHeader($header, $headerValue); + } + } + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderRemovePlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderRemovePlugin.php new file mode 100644 index 0000000..fc9c19d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderRemovePlugin.php @@ -0,0 +1,41 @@ + + */ +final class HeaderRemovePlugin implements Plugin +{ + /** + * @var array + */ + private $headers = []; + + /** + * @param array $headers List of header names to remove from the request + */ + public function __construct(array $headers) + { + $this->headers = $headers; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + foreach ($this->headers as $header) { + if ($request->hasHeader($header)) { + $request = $request->withoutHeader($header); + } + } + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderSetPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderSetPlugin.php new file mode 100644 index 0000000..75f11d4 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HeaderSetPlugin.php @@ -0,0 +1,41 @@ + + */ +final class HeaderSetPlugin implements Plugin +{ + /** + * @var array + */ + private $headers = []; + + /** + * @param array $headers Hashmap of header name to header value + */ + public function __construct(array $headers) + { + $this->headers = $headers; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + foreach ($this->headers as $header => $headerValue) { + $request = $request->withHeader($header, $headerValue); + } + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HistoryPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HistoryPlugin.php new file mode 100644 index 0000000..5abddbd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/HistoryPlugin.php @@ -0,0 +1,49 @@ + + */ +final class HistoryPlugin implements Plugin +{ + /** + * Journal use to store request / responses / exception. + * + * @var Journal + */ + private $journal; + + /** + * @param Journal $journal + */ + public function __construct(Journal $journal) + { + $this->journal = $journal; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + $journal = $this->journal; + + return $next($request)->then(function (ResponseInterface $response) use ($request, $journal) { + $journal->addSuccess($request, $response); + + return $response; + }, function (Exception $exception) use ($request, $journal) { + $journal->addFailure($request, $exception); + + throw $exception; + }); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/Journal.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/Journal.php new file mode 100644 index 0000000..15f3095 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/Journal.php @@ -0,0 +1,31 @@ + + */ +interface Journal +{ + /** + * Record a successful call. + * + * @param RequestInterface $request Request use to make the call + * @param ResponseInterface $response Response returned by the call + */ + public function addSuccess(RequestInterface $request, ResponseInterface $response); + + /** + * Record a failed call. + * + * @param RequestInterface $request Request use to make the call + * @param Exception $exception Exception returned by the call + */ + public function addFailure(RequestInterface $request, Exception $exception); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/QueryDefaultsPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/QueryDefaultsPlugin.php new file mode 100644 index 0000000..6c1e32c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/QueryDefaultsPlugin.php @@ -0,0 +1,54 @@ + + */ +final class QueryDefaultsPlugin implements Plugin +{ + /** + * @var array + */ + private $queryParams = []; + + /** + * @param array $queryParams Hashmap of query name to query value. Names and values must not be url encoded as + * this plugin will encode them + */ + public function __construct(array $queryParams) + { + $this->queryParams = $queryParams; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + foreach ($this->queryParams as $name => $value) { + $uri = $request->getUri(); + $array = []; + parse_str($uri->getQuery(), $array); + + // If query value is not found + if (!isset($array[$name])) { + $array[$name] = $value; + + // Create a new request with the new URI with the added query param + $request = $request->withUri( + $uri->withQuery(http_build_query($array)) + ); + } + } + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RedirectPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RedirectPlugin.php new file mode 100644 index 0000000..d2f442e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RedirectPlugin.php @@ -0,0 +1,270 @@ + + */ +class RedirectPlugin implements Plugin +{ + /** + * Rule on how to redirect, change method for the new request. + * + * @var array + */ + protected $redirectCodes = [ + 300 => [ + 'switch' => [ + 'unless' => ['GET', 'HEAD'], + 'to' => 'GET', + ], + 'multiple' => true, + 'permanent' => false, + ], + 301 => [ + 'switch' => [ + 'unless' => ['GET', 'HEAD'], + 'to' => 'GET', + ], + 'multiple' => false, + 'permanent' => true, + ], + 302 => [ + 'switch' => [ + 'unless' => ['GET', 'HEAD'], + 'to' => 'GET', + ], + 'multiple' => false, + 'permanent' => false, + ], + 303 => [ + 'switch' => [ + 'unless' => ['GET', 'HEAD'], + 'to' => 'GET', + ], + 'multiple' => false, + 'permanent' => false, + ], + 307 => [ + 'switch' => false, + 'multiple' => false, + 'permanent' => false, + ], + 308 => [ + 'switch' => false, + 'multiple' => false, + 'permanent' => true, + ], + ]; + + /** + * Determine how header should be preserved from old request. + * + * @var bool|array + * + * true will keep all previous headers (default value) + * false will ditch all previous headers + * string[] will keep only headers with the specified names + */ + protected $preserveHeader; + + /** + * Store all previous redirect from 301 / 308 status code. + * + * @var array + */ + protected $redirectStorage = []; + + /** + * Whether the location header must be directly used for a multiple redirection status code (300). + * + * @var bool + */ + protected $useDefaultForMultiple; + + /** + * @var array + */ + protected $circularDetection = []; + + /** + * @param array $config { + * + * @var bool|string[] $preserve_header True keeps all headers, false remove all of them, an array is interpreted as a list of header names to keep + * @var bool $use_default_for_multiple Whether the location header must be directly used for a multiple redirection status code (300). + * } + */ + public function __construct(array $config = []) + { + $resolver = new OptionsResolver(); + $resolver->setDefaults([ + 'preserve_header' => true, + 'use_default_for_multiple' => true, + ]); + $resolver->setAllowedTypes('preserve_header', ['bool', 'array']); + $resolver->setAllowedTypes('use_default_for_multiple', 'bool'); + $resolver->setNormalizer('preserve_header', function (OptionsResolver $resolver, $value) { + if (is_bool($value) && false === $value) { + return []; + } + + return $value; + }); + $options = $resolver->resolve($config); + + $this->preserveHeader = $options['preserve_header']; + $this->useDefaultForMultiple = $options['use_default_for_multiple']; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + // Check in storage + if (array_key_exists((string) $request->getUri(), $this->redirectStorage)) { + $uri = $this->redirectStorage[(string) $request->getUri()]['uri']; + $statusCode = $this->redirectStorage[(string) $request->getUri()]['status']; + $redirectRequest = $this->buildRedirectRequest($request, $uri, $statusCode); + + return $first($redirectRequest); + } + + return $next($request)->then(function (ResponseInterface $response) use ($request, $first) { + $statusCode = $response->getStatusCode(); + + if (!array_key_exists($statusCode, $this->redirectCodes)) { + return $response; + } + + $uri = $this->createUri($response, $request); + $redirectRequest = $this->buildRedirectRequest($request, $uri, $statusCode); + $chainIdentifier = spl_object_hash((object) $first); + + if (!array_key_exists($chainIdentifier, $this->circularDetection)) { + $this->circularDetection[$chainIdentifier] = []; + } + + $this->circularDetection[$chainIdentifier][] = (string) $request->getUri(); + + if (in_array((string) $redirectRequest->getUri(), $this->circularDetection[$chainIdentifier])) { + throw new CircularRedirectionException('Circular redirection detected', $request, $response); + } + + if ($this->redirectCodes[$statusCode]['permanent']) { + $this->redirectStorage[(string) $request->getUri()] = [ + 'uri' => $uri, + 'status' => $statusCode, + ]; + } + + // Call redirect request in synchrone + $redirectPromise = $first($redirectRequest); + + return $redirectPromise->wait(); + }); + } + + /** + * Builds the redirect request. + * + * @param RequestInterface $request Original request + * @param UriInterface $uri New uri + * @param int $statusCode Status code from the redirect response + * + * @return MessageInterface|RequestInterface + */ + protected function buildRedirectRequest(RequestInterface $request, UriInterface $uri, $statusCode) + { + $request = $request->withUri($uri); + + if (false !== $this->redirectCodes[$statusCode]['switch'] && !in_array($request->getMethod(), $this->redirectCodes[$statusCode]['switch']['unless'])) { + $request = $request->withMethod($this->redirectCodes[$statusCode]['switch']['to']); + } + + if (is_array($this->preserveHeader)) { + $headers = array_keys($request->getHeaders()); + + foreach ($headers as $name) { + if (!in_array($name, $this->preserveHeader)) { + $request = $request->withoutHeader($name); + } + } + } + + return $request; + } + + /** + * Creates a new Uri from the old request and the location header. + * + * @param ResponseInterface $response The redirect response + * @param RequestInterface $request The original request + * + * @throws HttpException If location header is not usable (missing or incorrect) + * @throws MultipleRedirectionException If a 300 status code is received and default location cannot be resolved (doesn't use the location header or not present) + * + * @return UriInterface + */ + private function createUri(ResponseInterface $response, RequestInterface $request) + { + if ($this->redirectCodes[$response->getStatusCode()]['multiple'] && (!$this->useDefaultForMultiple || !$response->hasHeader('Location'))) { + throw new MultipleRedirectionException('Cannot choose a redirection', $request, $response); + } + + if (!$response->hasHeader('Location')) { + throw new HttpException('Redirect status code, but no location header present in the response', $request, $response); + } + + $location = $response->getHeaderLine('Location'); + $parsedLocation = parse_url($location); + + if (false === $parsedLocation) { + throw new HttpException(sprintf('Location %s could not be parsed', $location), $request, $response); + } + + $uri = $request->getUri(); + + if (array_key_exists('scheme', $parsedLocation)) { + $uri = $uri->withScheme($parsedLocation['scheme']); + } + + if (array_key_exists('host', $parsedLocation)) { + $uri = $uri->withHost($parsedLocation['host']); + } + + if (array_key_exists('port', $parsedLocation)) { + $uri = $uri->withPort($parsedLocation['port']); + } + + if (array_key_exists('path', $parsedLocation)) { + $uri = $uri->withPath($parsedLocation['path']); + } + + if (array_key_exists('query', $parsedLocation)) { + $uri = $uri->withQuery($parsedLocation['query']); + } else { + $uri = $uri->withQuery(''); + } + + if (array_key_exists('fragment', $parsedLocation)) { + $uri = $uri->withFragment($parsedLocation['fragment']); + } else { + $uri = $uri->withFragment(''); + } + + return $uri; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RequestMatcherPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RequestMatcherPlugin.php new file mode 100644 index 0000000..5f72b02 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RequestMatcherPlugin.php @@ -0,0 +1,47 @@ + + */ +final class RequestMatcherPlugin implements Plugin +{ + /** + * @var RequestMatcher + */ + private $requestMatcher; + + /** + * @var Plugin + */ + private $delegatedPlugin; + + /** + * @param RequestMatcher $requestMatcher + * @param Plugin $delegatedPlugin + */ + public function __construct(RequestMatcher $requestMatcher, Plugin $delegatedPlugin) + { + $this->requestMatcher = $requestMatcher; + $this->delegatedPlugin = $delegatedPlugin; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + if ($this->requestMatcher->matches($request)) { + return $this->delegatedPlugin->handleRequest($request, $next, $first); + } + + return $next($request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RetryPlugin.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RetryPlugin.php new file mode 100644 index 0000000..8446246 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/Plugin/RetryPlugin.php @@ -0,0 +1,122 @@ + + */ +final class RetryPlugin implements Plugin +{ + /** + * Number of retry before sending an exception. + * + * @var int + */ + private $retry; + + /** + * @var callable + */ + private $delay; + + /** + * @var callable + */ + private $decider; + + /** + * Store the retry counter for each request. + * + * @var array + */ + private $retryStorage = []; + + /** + * @param array $config { + * + * @var int $retries Number of retries to attempt if an exception occurs before letting the exception bubble up. + * @var callable $decider A callback that gets a request and an exception to decide after a failure whether the request should be retried. + * @var callable $delay A callback that gets a request, an exception and the number of retries and returns how many microseconds we should wait before trying again. + * } + */ + public function __construct(array $config = []) + { + $resolver = new OptionsResolver(); + $resolver->setDefaults([ + 'retries' => 1, + 'decider' => function (RequestInterface $request, Exception $e) { + return true; + }, + 'delay' => __CLASS__.'::defaultDelay', + ]); + $resolver->setAllowedTypes('retries', 'int'); + $resolver->setAllowedTypes('decider', 'callable'); + $resolver->setAllowedTypes('delay', 'callable'); + $options = $resolver->resolve($config); + + $this->retry = $options['retries']; + $this->decider = $options['decider']; + $this->delay = $options['delay']; + } + + /** + * {@inheritdoc} + */ + public function handleRequest(RequestInterface $request, callable $next, callable $first) + { + $chainIdentifier = spl_object_hash((object) $first); + + return $next($request)->then(function (ResponseInterface $response) use ($request, $chainIdentifier) { + if (array_key_exists($chainIdentifier, $this->retryStorage)) { + unset($this->retryStorage[$chainIdentifier]); + } + + return $response; + }, function (Exception $exception) use ($request, $next, $first, $chainIdentifier) { + if (!array_key_exists($chainIdentifier, $this->retryStorage)) { + $this->retryStorage[$chainIdentifier] = 0; + } + + if ($this->retryStorage[$chainIdentifier] >= $this->retry) { + unset($this->retryStorage[$chainIdentifier]); + + throw $exception; + } + + if (!call_user_func($this->decider, $request, $exception)) { + throw $exception; + } + + $time = call_user_func($this->delay, $request, $exception, $this->retryStorage[$chainIdentifier]); + usleep($time); + + // Retry in synchrone + ++$this->retryStorage[$chainIdentifier]; + $promise = $this->handleRequest($request, $next, $first); + + return $promise->wait(); + }); + } + + /** + * @param RequestInterface $request + * @param Exception $e + * @param int $retries The number of retries we made before. First time this get called it will be 0. + * + * @return int + */ + public static function defaultDelay(RequestInterface $request, Exception $e, $retries) + { + return pow(2, $retries) * 500000; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/PluginClient.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/PluginClient.php new file mode 100644 index 0000000..93aea8f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/PluginClient.php @@ -0,0 +1,179 @@ + + */ +final class PluginClient implements HttpClient, HttpAsyncClient +{ + /** + * An HTTP async client. + * + * @var HttpAsyncClient + */ + private $client; + + /** + * The plugin chain. + * + * @var Plugin[] + */ + private $plugins; + + /** + * A list of options. + * + * @var array + */ + private $options; + + /** + * @param HttpClient|HttpAsyncClient $client + * @param Plugin[] $plugins + * @param array $options { + * + * @var int $max_restarts + * @var Plugin[] $debug_plugins an array of plugins that are injected between each normal plugin + * } + * + * @throws \RuntimeException if client is not an instance of HttpClient or HttpAsyncClient + */ + public function __construct($client, array $plugins = [], array $options = []) + { + if ($client instanceof HttpAsyncClient) { + $this->client = $client; + } elseif ($client instanceof HttpClient) { + $this->client = new EmulatedHttpAsyncClient($client); + } else { + throw new \RuntimeException('Client must be an instance of Http\\Client\\HttpClient or Http\\Client\\HttpAsyncClient'); + } + + $this->plugins = $plugins; + $this->options = $this->configure($options); + } + + /** + * {@inheritdoc} + */ + public function sendRequest(RequestInterface $request) + { + // If we don't have an http client, use the async call + if (!($this->client instanceof HttpClient)) { + return $this->sendAsyncRequest($request)->wait(); + } + + // Else we want to use the synchronous call of the underlying client, and not the async one in the case + // we have both an async and sync call + $pluginChain = $this->createPluginChain($this->plugins, function (RequestInterface $request) { + try { + return new HttpFulfilledPromise($this->client->sendRequest($request)); + } catch (HttplugException $exception) { + return new HttpRejectedPromise($exception); + } + }); + + return $pluginChain($request)->wait(); + } + + /** + * {@inheritdoc} + */ + public function sendAsyncRequest(RequestInterface $request) + { + $pluginChain = $this->createPluginChain($this->plugins, function (RequestInterface $request) { + return $this->client->sendAsyncRequest($request); + }); + + return $pluginChain($request); + } + + /** + * Configure the plugin client. + * + * @param array $options + * + * @return array + */ + private function configure(array $options = []) + { + if (isset($options['debug_plugins'])) { + @trigger_error('The "debug_plugins" option is deprecated since 1.5 and will be removed in 2.0.', E_USER_DEPRECATED); + } + + $resolver = new OptionsResolver(); + $resolver->setDefaults([ + 'max_restarts' => 10, + 'debug_plugins' => [], + ]); + + $resolver + ->setAllowedTypes('debug_plugins', 'array') + ->setAllowedValues('debug_plugins', function (array $plugins) { + foreach ($plugins as $plugin) { + // Make sure each object passed with the `debug_plugins` is an instance of Plugin. + if (!$plugin instanceof Plugin) { + return false; + } + } + + return true; + }); + + return $resolver->resolve($options); + } + + /** + * Create the plugin chain. + * + * @param Plugin[] $pluginList A list of plugins + * @param callable $clientCallable Callable making the HTTP call + * + * @return callable + */ + private function createPluginChain($pluginList, callable $clientCallable) + { + $firstCallable = $lastCallable = $clientCallable; + + /* + * Inject debug plugins between each plugin. + */ + $pluginListWithDebug = $this->options['debug_plugins']; + foreach ($pluginList as $plugin) { + $pluginListWithDebug[] = $plugin; + $pluginListWithDebug = array_merge($pluginListWithDebug, $this->options['debug_plugins']); + } + + while ($plugin = array_pop($pluginListWithDebug)) { + $lastCallable = function (RequestInterface $request) use ($plugin, $lastCallable, &$firstCallable) { + return $plugin->handleRequest($request, $lastCallable, $firstCallable); + }; + + $firstCallable = $lastCallable; + } + + $firstCalls = 0; + $firstCallable = function (RequestInterface $request) use ($lastCallable, &$firstCalls) { + if ($firstCalls > $this->options['max_restarts']) { + throw new LoopException('Too many restarts in plugin client', $request); + } + + ++$firstCalls; + + return $lastCallable($request); + }; + + return $firstCallable; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/PluginClientFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/PluginClientFactory.php new file mode 100644 index 0000000..bd4c08f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/client-common/src/PluginClientFactory.php @@ -0,0 +1,62 @@ + + */ +final class PluginClientFactory +{ + /** + * @var callable + */ + private static $factory; + + /** + * Set the factory to use. + * The callable to provide must have the same arguments and return type as PluginClientFactory::createClient. + * This is used by the HTTPlugBundle to provide a better Symfony integration. + * Unlike the createClient method, this one is static to allow zero configuration profiling by hooking into early + * application execution. + * + * @internal + * + * @param callable $factory + */ + public static function setFactory(callable $factory) + { + static::$factory = $factory; + } + + /** + * @param HttpClient|HttpAsyncClient $client + * @param Plugin[] $plugins + * @param array $options { + * + * @var string $client_name to give client a name which may be used when displaying client information like in + * the HTTPlugBundle profiler. + * } + * + * @see PluginClient constructor for PluginClient specific $options. + * + * @return PluginClient + */ + public function createClient($client, array $plugins = [], array $options = []) + { + if (static::$factory) { + $factory = static::$factory; + + return $factory($client, $plugins, $options); + } + + unset($options['client_name']); + + return new PluginClient($client, $plugins, $options); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/.php_cs b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/.php_cs new file mode 100644 index 0000000..febeee5 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/.php_cs @@ -0,0 +1,9 @@ +level(Symfony\CS\FixerInterface::PSR2_LEVEL) + ->fixers([]) + ->finder( + Symfony\CS\Finder\DefaultFinder::create()->in(__DIR__ . '/src') + ) +; diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/.styleci.yml b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/.styleci.yml new file mode 100644 index 0000000..4d43c93 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/.styleci.yml @@ -0,0 +1,4 @@ +preset: psr2 +finder: + path: + - "src" diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/CHANGELOG.md new file mode 100644 index 0000000..a3f52d1 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/CHANGELOG.md @@ -0,0 +1,163 @@ +# Change Log + +## 1.7 - 2017-02-09 + +### Changed + +- #30: Make sure we rewind streams + +## 1.6.2 - 2017-01-02 + +### Fixed + +- #29: Request not using CURLOPT_POSTFIELDS have content-length set to + +### Changed + +- Use binary mode to create response body stream. + + +## 1.6.1 - 2016-11-11 + +### Fixed + +- #27: ErrorPlugin and sendAsyncRequest() incompatibility + + +## 1.6 - 2016-09-12 + +### Changed + +- `Client::sendRequest` now throws `Http\Client\Exception\NetworkException` on network errors. +- `\UnexpectedValueException` replaced with `Http\Client\Exception\RequestException` in + `Client::sendRequest` and `Client::sendAsyncRequest` + + +## 1.5.1 - 2016-08-29 + +### Fixed + +- #26: Combining CurlClient with StopwatchPlugin causes Promise onRejected handler to never be + invoked. + + +## 1.5 - 2016-08-03 + +### Changed + +- Request body can be send with any method except GET, HEAD and TRACE. +- #25: Make discovery a hard dependency. + + +## 1.4.2 - 2016-06-14 + +### Added + +- #23: "php-http/async-client-implementation" added to "provide" section. + + +## 1.4.1 - 2016-05-30 + +### Fixed + +- #22: Cannot create the client using `HttpClientDiscovery`. + + +## 1.4 - 2016-03-30 + +### Changed + +- #20: Minimize memory usage when reading large response body. + + +## 1.3 - 2016-03-14 + +### Fixed + +- #18: Invalid "Expect" header. + +### Removed + +- #13: Remove HeaderParser. + + +## 1.2 - 2016-03-09 + +### Added + +- #16: Make sure discovery can find the curl client + +### Fixed + +- #15: "Out of memory" sending large files. + + +## 1.1.0 - 2016-01-29 + +### Changed + +- Switch to php-http/message 1.0. + + +## 1.0.0 - 2016-01-28 + +First stable release. + + +## 0.7.0 - 2016-01-26 + +### Changed + +- Migrate from `php-http/discovery` and `php-http/utils` to `php-http/message`. + +## 0.6.0 - 2016-01-12 + +### Changed + +- Root namespace changed from `Http\Curl` to `Http\Client\Curl`. +- Main client class name renamed from `CurlHttpClient` to `Client`. +- Minimum required [php-http/discovery](https://packagist.org/packages/php-http/discovery) + version changed to 0.5. + + +## 0.5.0 - 2015-12-18 + +### Changed + +- Compatibility with php-http/httplug 1.0 beta +- Switch to php-http/discovery 0.4 + + +## 0.4.0 - 2015-12-16 + +### Changed + +- Switch to php-http/message-factory 1.0 + + +## 0.3.1 - 2015-12-14 + +### Changed + +- Requirements fixed. + + +## 0.3.0 - 2015-11-24 + +### Changed + +- Use cURL constants as options keys. + + +## 0.2.0 - 2015-11-17 + +### Added + +- HttpAsyncClient support. + + +## 0.1.0 - 2015-11-11 + +### Added + +- Initial release diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/LICENSE b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/LICENSE new file mode 100644 index 0000000..8e2c4a0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2015 PHP HTTP Team + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/README.md b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/README.md new file mode 100644 index 0000000..fc60b7e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/README.md @@ -0,0 +1,44 @@ +# Curl client for PHP HTTP + +[![Latest Version](https://img.shields.io/github/release/php-http/curl-client.svg?style=flat-square)](https://github.com/php-http/curl-client/releases) +[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE) +[![Build Status](https://img.shields.io/travis/php-http/curl-client.svg?style=flat-square)](https://travis-ci.org/php-http/curl-client) +[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-http/curl-client.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/curl-client) +[![Quality Score](https://img.shields.io/scrutinizer/g/php-http/curl-client.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/curl-client) +[![Total Downloads](https://img.shields.io/packagist/dt/php-http/curl-client.svg?style=flat-square)](https://packagist.org/packages/php-http/curl-client) + +The cURL client use the cURL PHP extension which must be activated in your `php.ini`. + + +## Install + +Via Composer + +``` bash +$ composer require php-http/curl-client +``` + +## Documentation + +Please see the [official documentation](http://docs.php-http.org/en/latest/clients/curl-client.html). + +## Testing + +``` bash +$ composer test +``` + +## Contributing + +Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details. + + +## Security + +If you discover any security related issues, please contact us at +[security@php-http.org](mailto:security@php-http.org). + + +## License + +The MIT License (MIT). Please see [License File](LICENSE) for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/composer.json b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/composer.json new file mode 100644 index 0000000..5d16222 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/composer.json @@ -0,0 +1,50 @@ +{ + "name": "php-http/curl-client", + "description": "cURL client for PHP-HTTP", + "license": "MIT", + "keywords": ["http", "curl"], + "homepage": "http://php-http.org", + "authors": [ + { + "name": "Михаил Красильников", + "email": "m.krasilnikov@yandex.ru" + } + ], + "prefer-stable": true, + "minimum-stability": "beta", + "config": { + "bin-dir": "vendor/bin" + }, + "require": { + "php": "^5.5 || ^7.0", + "ext-curl": "*", + "php-http/httplug": "^1.0", + "php-http/message-factory": "^1.0.2", + "php-http/message": "^1.2", + "php-http/discovery": "^1.0" + }, + "require-dev": { + "guzzlehttp/psr7": "^1.0", + "php-http/client-integration-tests": "^0.5.1", + "phpunit/phpunit": "^4.8.27", + "zendframework/zend-diactoros": "^1.0" + }, + "autoload": { + "psr-4": { + "Http\\Client\\Curl\\": "src/" + } + }, + "autoload-dev": { + "psr-4": { + "Http\\Client\\Curl\\Tests\\": "tests/" + } + }, + "provide": { + "php-http/client-implementation": "1.0", + "php-http/async-client-implementation": "1.0" + }, + "scripts": { + "test": "vendor/bin/phpunit", + "test-ci": "vendor/bin/phpunit --coverage-clover build/coverage.xml" + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/puli.json b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/puli.json new file mode 100644 index 0000000..b35768d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/puli.json @@ -0,0 +1,242 @@ +{ + "version": "1.0", + "name": "php-http/curl-client", + "bindings": { + "98239b8b-103b-4f47-94c7-4cba49a05a1f": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Client\\Curl\\Client", + "type": "Http\\Client\\HttpAsyncClient" + }, + "a6a79968-2aa5-427c-bbe1-a581d9a48321": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Client\\Curl\\Client", + "type": "Http\\Client\\HttpClient" + } + }, + "config": { + "bootstrap-file": "vendor/autoload.php" + }, + "packages": { + "clue/stream-filter": { + "install-path": "vendor/clue/stream-filter", + "installer": "composer", + "env": "dev" + }, + "doctrine/instantiator": { + "install-path": "vendor/doctrine/instantiator", + "installer": "composer", + "env": "dev" + }, + "guzzlehttp/psr7": { + "install-path": "vendor/guzzlehttp/psr7", + "installer": "composer", + "env": "dev" + }, + "justinrainbow/json-schema": { + "install-path": "vendor/justinrainbow/json-schema", + "installer": "composer", + "env": "dev" + }, + "paragonie/random_compat": { + "install-path": "vendor/paragonie/random_compat", + "installer": "composer", + "env": "dev" + }, + "php-http/adapter-integration-tests": { + "install-path": "vendor/php-http/adapter-integration-tests", + "installer": "composer", + "env": "dev" + }, + "php-http/discovery": { + "install-path": "vendor/php-http/discovery", + "installer": "composer", + "env": "dev" + }, + "php-http/httplug": { + "install-path": "vendor/php-http/httplug", + "installer": "composer" + }, + "php-http/message": { + "install-path": "vendor/php-http/message", + "installer": "composer", + "env": "dev" + }, + "php-http/message-factory": { + "install-path": "vendor/php-http/message-factory", + "installer": "composer" + }, + "php-http/promise": { + "install-path": "vendor/php-http/promise", + "installer": "composer" + }, + "phpdocumentor/reflection-docblock": { + "install-path": "vendor/phpdocumentor/reflection-docblock", + "installer": "composer", + "env": "dev" + }, + "phpspec/prophecy": { + "install-path": "vendor/phpspec/prophecy", + "installer": "composer", + "env": "dev" + }, + "phpunit/php-code-coverage": { + "install-path": "vendor/phpunit/php-code-coverage", + "installer": "composer", + "env": "dev" + }, + "phpunit/php-file-iterator": { + "install-path": "vendor/phpunit/php-file-iterator", + "installer": "composer", + "env": "dev" + }, + "phpunit/php-text-template": { + "install-path": "vendor/phpunit/php-text-template", + "installer": "composer", + "env": "dev" + }, + "phpunit/php-timer": { + "install-path": "vendor/phpunit/php-timer", + "installer": "composer", + "env": "dev" + }, + "phpunit/php-token-stream": { + "install-path": "vendor/phpunit/php-token-stream", + "installer": "composer", + "env": "dev" + }, + "phpunit/phpunit": { + "install-path": "vendor/phpunit/phpunit", + "installer": "composer", + "env": "dev" + }, + "phpunit/phpunit-mock-objects": { + "install-path": "vendor/phpunit/phpunit-mock-objects", + "installer": "composer", + "env": "dev" + }, + "psr/http-message": { + "install-path": "vendor/psr/http-message", + "installer": "composer" + }, + "psr/log": { + "install-path": "vendor/psr/log", + "installer": "composer", + "env": "dev" + }, + "puli/composer-plugin": { + "install-path": "vendor/puli/composer-plugin", + "installer": "composer", + "env": "dev" + }, + "puli/discovery": { + "install-path": "vendor/puli/discovery", + "installer": "composer", + "env": "dev" + }, + "puli/repository": { + "install-path": "vendor/puli/repository", + "installer": "composer", + "env": "dev" + }, + "puli/url-generator": { + "install-path": "vendor/puli/url-generator", + "installer": "composer", + "env": "dev" + }, + "ramsey/uuid": { + "install-path": "vendor/ramsey/uuid", + "installer": "composer", + "env": "dev" + }, + "sebastian/comparator": { + "install-path": "vendor/sebastian/comparator", + "installer": "composer", + "env": "dev" + }, + "sebastian/diff": { + "install-path": "vendor/sebastian/diff", + "installer": "composer", + "env": "dev" + }, + "sebastian/environment": { + "install-path": "vendor/sebastian/environment", + "installer": "composer", + "env": "dev" + }, + "sebastian/exporter": { + "install-path": "vendor/sebastian/exporter", + "installer": "composer", + "env": "dev" + }, + "sebastian/global-state": { + "install-path": "vendor/sebastian/global-state", + "installer": "composer", + "env": "dev" + }, + "sebastian/recursion-context": { + "install-path": "vendor/sebastian/recursion-context", + "installer": "composer", + "env": "dev" + }, + "sebastian/version": { + "install-path": "vendor/sebastian/version", + "installer": "composer", + "env": "dev" + }, + "seld/jsonlint": { + "install-path": "vendor/seld/jsonlint", + "installer": "composer", + "env": "dev" + }, + "symfony/filesystem": { + "install-path": "vendor/symfony/filesystem", + "installer": "composer", + "env": "dev" + }, + "symfony/process": { + "install-path": "vendor/symfony/process", + "installer": "composer", + "env": "dev" + }, + "symfony/yaml": { + "install-path": "vendor/symfony/yaml", + "installer": "composer", + "env": "dev" + }, + "th3n3rd/cartesian-product": { + "install-path": "vendor/th3n3rd/cartesian-product", + "installer": "composer", + "env": "dev" + }, + "webmozart/assert": { + "install-path": "vendor/webmozart/assert", + "installer": "composer", + "env": "dev" + }, + "webmozart/expression": { + "install-path": "vendor/webmozart/expression", + "installer": "composer", + "env": "dev" + }, + "webmozart/glob": { + "install-path": "vendor/webmozart/glob", + "installer": "composer", + "env": "dev" + }, + "webmozart/json": { + "install-path": "vendor/webmozart/json", + "installer": "composer", + "env": "dev" + }, + "webmozart/path-util": { + "install-path": "vendor/webmozart/path-util", + "installer": "composer", + "env": "dev" + }, + "zendframework/zend-diactoros": { + "install-path": "vendor/zendframework/zend-diactoros", + "installer": "composer", + "env": "dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/Client.php b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/Client.php new file mode 100644 index 0000000..5696ab3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/Client.php @@ -0,0 +1,371 @@ + + * @author Blake Williams + * + * @api + * @since 1.0 + */ +class Client implements HttpClient, HttpAsyncClient +{ + /** + * cURL options + * + * @var array + */ + private $options; + + /** + * PSR-7 message factory + * + * @var MessageFactory + */ + private $messageFactory; + + /** + * PSR-7 stream factory + * + * @var StreamFactory + */ + private $streamFactory; + + /** + * cURL synchronous requests handle + * + * @var resource|null + */ + private $handle = null; + + /** + * Simultaneous requests runner + * + * @var MultiRunner|null + */ + private $multiRunner = null; + + /** + * Create new client + * + * @param MessageFactory|null $messageFactory HTTP Message factory + * @param StreamFactory|null $streamFactory HTTP Stream factory + * @param array $options cURL options (see http://php.net/curl_setopt) + * + * @throws \Http\Discovery\Exception\NotFoundException If factory discovery failed. + * + * @since 1.0 + */ + public function __construct( + MessageFactory $messageFactory = null, + StreamFactory $streamFactory = null, + array $options = [] + ) { + $this->messageFactory = $messageFactory ?: MessageFactoryDiscovery::find(); + $this->streamFactory = $streamFactory ?: StreamFactoryDiscovery::find(); + $this->options = $options; + } + + /** + * Release resources if still active + */ + public function __destruct() + { + if (is_resource($this->handle)) { + curl_close($this->handle); + } + } + + /** + * Sends a PSR-7 request. + * + * @param RequestInterface $request + * + * @return ResponseInterface + * + * @throws \Http\Client\Exception\NetworkException In case of network problems. + * @throws \Http\Client\Exception\RequestException On invalid request. + * @throws \InvalidArgumentException For invalid header names or values. + * @throws \RuntimeException If creating the body stream fails. + * + * @since 1.6 \UnexpectedValueException replaced with RequestException. + * @since 1.6 Throw NetworkException on network errors. + * @since 1.0 + */ + public function sendRequest(RequestInterface $request) + { + $responseBuilder = $this->createResponseBuilder(); + $options = $this->createCurlOptions($request, $responseBuilder); + + if (is_resource($this->handle)) { + curl_reset($this->handle); + } else { + $this->handle = curl_init(); + } + + curl_setopt_array($this->handle, $options); + curl_exec($this->handle); + + $errno = curl_errno($this->handle); + switch ($errno) { + case CURLE_OK: + // All OK, no actions needed. + break; + case CURLE_COULDNT_RESOLVE_PROXY: + case CURLE_COULDNT_RESOLVE_HOST: + case CURLE_COULDNT_CONNECT: + case CURLE_OPERATION_TIMEOUTED: + case CURLE_SSL_CONNECT_ERROR: + throw new Exception\NetworkException(curl_error($this->handle), $request); + default: + throw new Exception\RequestException(curl_error($this->handle), $request); + } + + $response = $responseBuilder->getResponse(); + $response->getBody()->seek(0); + + return $response; + } + + /** + * Sends a PSR-7 request in an asynchronous way. + * + * @param RequestInterface $request + * + * @return Promise + * + * @throws \Http\Client\Exception\RequestException On invalid request. + * @throws \InvalidArgumentException For invalid header names or values. + * @throws \RuntimeException If creating the body stream fails. + * + * @since 1.6 \UnexpectedValueException replaced with RequestException. + * @since 1.0 + */ + public function sendAsyncRequest(RequestInterface $request) + { + if (!$this->multiRunner instanceof MultiRunner) { + $this->multiRunner = new MultiRunner(); + } + + $handle = curl_init(); + $responseBuilder = $this->createResponseBuilder(); + $options = $this->createCurlOptions($request, $responseBuilder); + curl_setopt_array($handle, $options); + + $core = new PromiseCore($request, $handle, $responseBuilder); + $promise = new CurlPromise($core, $this->multiRunner); + $this->multiRunner->add($core); + + return $promise; + } + + /** + * Generates cURL options + * + * @param RequestInterface $request + * @param ResponseBuilder $responseBuilder + * + * @throws \Http\Client\Exception\RequestException On invalid request. + * @throws \InvalidArgumentException For invalid header names or values. + * @throws \RuntimeException if can not read body + * + * @return array + */ + private function createCurlOptions(RequestInterface $request, ResponseBuilder $responseBuilder) + { + $options = $this->options; + + $options[CURLOPT_HEADER] = false; + $options[CURLOPT_RETURNTRANSFER] = false; + $options[CURLOPT_FOLLOWLOCATION] = false; + + try { + $options[CURLOPT_HTTP_VERSION] + = $this->getProtocolVersion($request->getProtocolVersion()); + } catch (\UnexpectedValueException $e) { + throw new Exception\RequestException($e->getMessage(), $request); + } + $options[CURLOPT_URL] = (string) $request->getUri(); + + $options = $this->addRequestBodyOptions($request, $options); + + $options[CURLOPT_HTTPHEADER] = $this->createHeaders($request, $options); + + if ($request->getUri()->getUserInfo()) { + $options[CURLOPT_USERPWD] = $request->getUri()->getUserInfo(); + } + + $options[CURLOPT_HEADERFUNCTION] = function ($ch, $data) use ($responseBuilder) { + $str = trim($data); + if ('' !== $str) { + if (strpos(strtolower($str), 'http/') === 0) { + $responseBuilder->setStatus($str)->getResponse(); + } else { + $responseBuilder->addHeader($str); + } + } + + return strlen($data); + }; + + $options[CURLOPT_WRITEFUNCTION] = function ($ch, $data) use ($responseBuilder) { + return $responseBuilder->getResponse()->getBody()->write($data); + }; + + return $options; + } + + /** + * Return cURL constant for specified HTTP version + * + * @param string $requestVersion + * + * @throws \UnexpectedValueException if unsupported version requested + * + * @return int + */ + private function getProtocolVersion($requestVersion) + { + switch ($requestVersion) { + case '1.0': + return CURL_HTTP_VERSION_1_0; + case '1.1': + return CURL_HTTP_VERSION_1_1; + case '2.0': + if (defined('CURL_HTTP_VERSION_2_0')) { + return CURL_HTTP_VERSION_2_0; + } + throw new \UnexpectedValueException('libcurl 7.33 needed for HTTP 2.0 support'); + } + + return CURL_HTTP_VERSION_NONE; + } + + /** + * Add request body related cURL options. + * + * @param RequestInterface $request + * @param array $options + * + * @return array + */ + private function addRequestBodyOptions(RequestInterface $request, array $options) + { + /* + * Some HTTP methods cannot have payload: + * + * - GET — cURL will automatically change method to PUT or POST if we set CURLOPT_UPLOAD or + * CURLOPT_POSTFIELDS. + * - HEAD — cURL treats HEAD as GET request with a same restrictions. + * - TRACE — According to RFC7231: a client MUST NOT send a message body in a TRACE request. + */ + if (!in_array($request->getMethod(), ['GET', 'HEAD', 'TRACE'], true)) { + $body = $request->getBody(); + $bodySize = $body->getSize(); + if ($bodySize !== 0) { + if ($body->isSeekable()) { + $body->rewind(); + } + + // Message has non empty body. + if (null === $bodySize || $bodySize > 1024 * 1024) { + // Avoid full loading large or unknown size body into memory + $options[CURLOPT_UPLOAD] = true; + if (null !== $bodySize) { + $options[CURLOPT_INFILESIZE] = $bodySize; + } + $options[CURLOPT_READFUNCTION] = function ($ch, $fd, $length) use ($body) { + return $body->read($length); + }; + } else { + // Small body can be loaded into memory + $options[CURLOPT_POSTFIELDS] = (string) $body; + } + } + } + + if ($request->getMethod() === 'HEAD') { + // This will set HTTP method to "HEAD". + $options[CURLOPT_NOBODY] = true; + } elseif ($request->getMethod() !== 'GET') { + // GET is a default method. Other methods should be specified explicitly. + $options[CURLOPT_CUSTOMREQUEST] = $request->getMethod(); + } + + return $options; + } + + /** + * Create headers array for CURLOPT_HTTPHEADER + * + * @param RequestInterface $request + * @param array $options cURL options + * + * @return string[] + */ + private function createHeaders(RequestInterface $request, array $options) + { + $curlHeaders = []; + $headers = $request->getHeaders(); + foreach ($headers as $name => $values) { + $header = strtolower($name); + if ('expect' === $header) { + // curl-client does not support "Expect-Continue", so dropping "expect" headers + continue; + } + if ('content-length' === $header) { + if (array_key_exists(CURLOPT_POSTFIELDS, $options)) { + // Small body content length can be calculated here. + $values = [strlen($options[CURLOPT_POSTFIELDS])]; + } elseif (!array_key_exists(CURLOPT_READFUNCTION, $options)) { + // Else if there is no body, forcing "Content-length" to 0 + $values = [0]; + } + } + foreach ($values as $value) { + $curlHeaders[] = $name . ': ' . $value; + } + } + /* + * curl-client does not support "Expect-Continue", but cURL adds "Expect" header by default. + * We can not suppress it, but we can set it to empty. + */ + $curlHeaders[] = 'Expect:'; + + return $curlHeaders; + } + + /** + * Create new ResponseBuilder instance + * + * @return ResponseBuilder + * + * @throws \RuntimeException If creating the stream from $body fails. + */ + private function createResponseBuilder() + { + try { + $body = $this->streamFactory->createStream(fopen('php://temp', 'w+b')); + } catch (\InvalidArgumentException $e) { + throw new \RuntimeException('Can not create "php://temp" stream.'); + } + $response = $this->messageFactory->createResponse(200, null, [], $body); + + return new ResponseBuilder($response); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/CurlPromise.php b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/CurlPromise.php new file mode 100644 index 0000000..68a775c --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/CurlPromise.php @@ -0,0 +1,108 @@ + + */ +class CurlPromise implements Promise +{ + /** + * Shared promise core + * + * @var PromiseCore + */ + private $core; + + /** + * Requests runner + * + * @var MultiRunner + */ + private $runner; + + /** + * Create new promise. + * + * @param PromiseCore $core Shared promise core + * @param MultiRunner $runner Simultaneous requests runner + */ + public function __construct(PromiseCore $core, MultiRunner $runner) + { + $this->core = $core; + $this->runner = $runner; + } + + /** + * Add behavior for when the promise is resolved or rejected. + * + * If you do not care about one of the cases, you can set the corresponding callable to null + * The callback will be called when the response or exception arrived and never more than once. + * + * @param callable $onFulfilled Called when a response will be available. + * @param callable $onRejected Called when an error happens. + * + * You must always return the Response in the interface or throw an Exception. + * + * @return Promise Always returns a new promise which is resolved with value of the executed + * callback (onFulfilled / onRejected). + */ + public function then(callable $onFulfilled = null, callable $onRejected = null) + { + if ($onFulfilled) { + $this->core->addOnFulfilled($onFulfilled); + } + if ($onRejected) { + $this->core->addOnRejected($onRejected); + } + + return new self($this->core, $this->runner); + } + + /** + * Get the state of the promise, one of PENDING, FULFILLED or REJECTED. + * + * @return string + */ + public function getState() + { + return $this->core->getState(); + } + + /** + * Wait for the promise to be fulfilled or rejected. + * + * When this method returns, the request has been resolved and the appropriate callable has terminated. + * + * When called with the unwrap option + * + * @param bool $unwrap Whether to return resolved value / throw reason or not + * + * @return \Psr\Http\Message\ResponseInterface|null Resolved value, null if $unwrap is set to false + * + * @throws \Http\Client\Exception The rejection reason. + */ + public function wait($unwrap = true) + { + $this->runner->wait($this->core); + + if ($unwrap) { + if ($this->core->getState() === self::REJECTED) { + throw $this->core->getException(); + } + + return $this->core->getResponse(); + } + return null; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/MultiRunner.php b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/MultiRunner.php new file mode 100644 index 0000000..9094c0f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/MultiRunner.php @@ -0,0 +1,127 @@ + + */ +class MultiRunner +{ + /** + * cURL multi handle + * + * @var resource|null + */ + private $multiHandle = null; + + /** + * Awaiting cores + * + * @var PromiseCore[] + */ + private $cores = []; + + /** + * Release resources if still active + */ + public function __destruct() + { + if (is_resource($this->multiHandle)) { + curl_multi_close($this->multiHandle); + } + } + + /** + * Add promise to runner + * + * @param PromiseCore $core + */ + public function add(PromiseCore $core) + { + foreach ($this->cores as $existed) { + if ($existed === $core) { + return; + } + } + + $this->cores[] = $core; + + if (null === $this->multiHandle) { + $this->multiHandle = curl_multi_init(); + } + curl_multi_add_handle($this->multiHandle, $core->getHandle()); + } + + /** + * Remove promise from runner + * + * @param PromiseCore $core + */ + public function remove(PromiseCore $core) + { + foreach ($this->cores as $index => $existed) { + if ($existed === $core) { + curl_multi_remove_handle($this->multiHandle, $core->getHandle()); + unset($this->cores[$index]); + return; + } + } + } + + /** + * Wait for request(s) to be completed. + * + * @param PromiseCore|null $targetCore + */ + public function wait(PromiseCore $targetCore = null) + { + do { + $status = curl_multi_exec($this->multiHandle, $active); + $info = curl_multi_info_read($this->multiHandle); + if (false !== $info) { + $core = $this->findCoreByHandle($info['handle']); + + if (null === $core) { + // We have no promise for this handle. Drop it. + curl_multi_remove_handle($this->multiHandle, $info['handle']); + continue; + } + + if (CURLE_OK === $info['result']) { + $core->fulfill(); + } else { + $error = curl_error($core->getHandle()); + $core->reject(new RequestException($error, $core->getRequest())); + } + $this->remove($core); + + // This is a promise we are waited for. So exiting wait(). + if ($core === $targetCore) { + return; + } + } + } while ($status === CURLM_CALL_MULTI_PERFORM || $active); + } + + /** + * Find core by handle. + * + * @param resource $handle + * + * @return PromiseCore|null + */ + private function findCoreByHandle($handle) + { + foreach ($this->cores as $core) { + if ($core->getHandle() === $handle) { + return $core; + } + } + return null; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/PromiseCore.php b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/PromiseCore.php new file mode 100644 index 0000000..f1a3aa5 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/PromiseCore.php @@ -0,0 +1,224 @@ + + */ +class PromiseCore +{ + /** + * HTTP request + * + * @var RequestInterface + */ + private $request; + + /** + * cURL handle + * + * @var resource + */ + private $handle; + + /** + * Response builder + * + * @var ResponseBuilder + */ + private $responseBuilder; + + /** + * Promise state + * + * @var string + */ + private $state; + + /** + * Exception + * + * @var Exception|null + */ + private $exception = null; + + /** + * Functions to call when a response will be available. + * + * @var callable[] + */ + private $onFulfilled = []; + + /** + * Functions to call when an error happens. + * + * @var callable[] + */ + private $onRejected = []; + + /** + * Create shared core. + * + * @param RequestInterface $request HTTP request + * @param resource $handle cURL handle + * @param ResponseBuilder $responseBuilder + */ + public function __construct( + RequestInterface $request, + $handle, + ResponseBuilder $responseBuilder + ) { + assert('is_resource($handle)'); + assert('get_resource_type($handle) === "curl"'); + + $this->request = $request; + $this->handle = $handle; + $this->responseBuilder = $responseBuilder; + $this->state = Promise::PENDING; + } + + /** + * Add on fulfilled callback. + * + * @param callable $callback + */ + public function addOnFulfilled(callable $callback) + { + if ($this->getState() === Promise::PENDING) { + $this->onFulfilled[] = $callback; + } elseif ($this->getState() === Promise::FULFILLED) { + $response = call_user_func($callback, $this->responseBuilder->getResponse()); + if ($response instanceof ResponseInterface) { + $this->responseBuilder->setResponse($response); + } + } + } + + /** + * Add on rejected callback. + * + * @param callable $callback + */ + public function addOnRejected(callable $callback) + { + if ($this->getState() === Promise::PENDING) { + $this->onRejected[] = $callback; + } elseif ($this->getState() === Promise::REJECTED) { + $this->exception = call_user_func($callback, $this->exception); + } + } + + /** + * Return cURL handle + * + * @return resource + */ + public function getHandle() + { + return $this->handle; + } + + /** + * Get the state of the promise, one of PENDING, FULFILLED or REJECTED. + * + * @return string + */ + public function getState() + { + return $this->state; + } + + /** + * Return request + * + * @return RequestInterface + */ + public function getRequest() + { + return $this->request; + } + + /** + * Return the value of the promise (fulfilled). + * + * @return ResponseInterface Response Object only when the Promise is fulfilled. + */ + public function getResponse() + { + return $this->responseBuilder->getResponse(); + } + + /** + * Get the reason why the promise was rejected. + * + * If the exception is an instance of Http\Client\Exception\HttpException it will contain + * the response object with the status code and the http reason. + * + * @return Exception Exception Object only when the Promise is rejected. + * + * @throws \LogicException When the promise is not rejected. + */ + public function getException() + { + if (null === $this->exception) { + throw new \LogicException('Promise is not rejected'); + } + + return $this->exception; + } + + /** + * Fulfill promise. + */ + public function fulfill() + { + $this->state = Promise::FULFILLED; + $response = $this->responseBuilder->getResponse(); + try { + $response->getBody()->seek(0); + } catch (\RuntimeException $e) { + $exception = new Exception\TransferException($e->getMessage(), $e->getCode(), $e); + $this->reject($exception); + + return; + } + + while (count($this->onFulfilled) > 0) { + $callback = array_shift($this->onFulfilled); + $response = call_user_func($callback, $response); + } + + if ($response instanceof ResponseInterface) { + $this->responseBuilder->setResponse($response); + } + } + + /** + * Reject promise. + * + * @param Exception $exception Reject reason. + */ + public function reject(Exception $exception) + { + $this->exception = $exception; + $this->state = Promise::REJECTED; + + while (count($this->onRejected) > 0) { + $callback = array_shift($this->onRejected); + try { + $exception = call_user_func($callback, $this->exception); + $this->exception = $exception; + } catch (Exception $exception) { + $this->exception = $exception; + } + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/ResponseBuilder.php b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/ResponseBuilder.php new file mode 100644 index 0000000..99e79db --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/curl-client/src/ResponseBuilder.php @@ -0,0 +1,21 @@ +response = $response; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/CHANGELOG.md new file mode 100644 index 0000000..2c476ea --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/CHANGELOG.md @@ -0,0 +1,186 @@ +# Change Log + +## 1.3.0 - 2017-08-03 + +### Added + +- Discovery support for CakePHP adapter +- Discovery support for Zend adapter +- Discovery support for Artax adapter + +## 1.2.1 - 2017-03-02 + +### Fixed + +- Fixed minor issue with `MockClientStrategy`, also added more tests. + +## 1.2.0 - 2017-02-12 + +### Added + +- MockClientStrategy class. + +## 1.1.1 - 2016-11-27 + +### Changed + +- Made exception messages clearer. `StrategyUnavailableException` is no longer the previous exception to `DiscoveryFailedException`. +- `CommonClassesStrategy` is using `self` instead of `static`. Using `static` makes no sense when `CommonClassesStrategy` is final. + +## 1.1.0 - 2016-10-20 + +### Added + +- Discovery support for Slim Framework factories + +## 1.0.0 - 2016-07-18 + +### Added + +- Added back `Http\Discovery\NotFoundException` to preserve BC with 0.8 version. You may upgrade from 0.8.x and 0.9.x to 1.0.0 without any BC breaks. +- Added interface `Http\Discovery\Exception` which is implemented by all our exceptions + +### Changed + +- Puli strategy renamed to Puli Beta strategy to prevent incompatibility with a future Puli stable + +### Deprecated + +- For BC reasons, the old `Http\Discovery\NotFoundException` (extending the new exception) will be thrown until version 2.0 + + +## 0.9.1 - 2016-06-28 + +### Changed + +- Dropping PHP 5.4 support because we use the ::class constant. + + +## 0.9.0 - 2016-06-25 + +### Added + +- Discovery strategies to find classes + +### Changed + +- [Puli](http://puli.io) made optional +- Improved exceptions +- **[BC] `NotFoundException` moved to `Http\Discovery\Exception\NotFoundException`** + + +## 0.8.0 - 2016-02-11 + +### Changed + +- Puli composer plugin must be installed separately + + +## 0.7.0 - 2016-01-15 + +### Added + +- Temporary puli.phar (Beta 10) executable + +### Changed + +- Updated HTTPlug dependencies +- Updated Puli dependencies +- Local configuration to make tests passing + +### Removed + +- Puli CLI dependency + + +## 0.6.4 - 2016-01-07 + +### Fixed + +- Puli [not working](https://twitter.com/PuliPHP/status/685132540588507137) with the latest json-schema + + +## 0.6.3 - 2016-01-04 + +### Changed + +- Adjust Puli dependencies + + +## 0.6.2 - 2016-01-04 + +### Changed + +- Make Puli CLI a requirement + + +## 0.6.1 - 2016-01-03 + +### Changed + +- More flexible Puli requirement + + +## 0.6.0 - 2015-12-30 + +### Changed + +- Use [Puli](http://puli.io) for discovery +- Improved exception messages + + +## 0.5.0 - 2015-12-25 + +### Changed + +- Updated message factory dependency (php-http/message) + + +## 0.4.0 - 2015-12-17 + +### Added + +- Array condition evaluation in the Class Discovery + +### Removed + +- Message factories (moved to php-http/utils) + + +## 0.3.0 - 2015-11-18 + +### Added + +- HTTP Async Client Discovery +- Stream factories + +### Changed + +- Discoveries and Factories are final +- Message and Uri factories have the type in their names +- Diactoros Message factory uses Stream factory internally + +### Fixed + +- Improved docblocks for API documentation generation + + +## 0.2.0 - 2015-10-31 + +### Changed + +- Renamed AdapterDiscovery to ClientDiscovery + + +## 0.1.1 - 2015-06-13 + +### Fixed + +- Bad HTTP Adapter class name for Guzzle 5 + + +## 0.1.0 - 2015-06-12 + +### Added + +- Initial release diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/LICENSE b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/LICENSE new file mode 100644 index 0000000..4558d6f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2015-2016 PHP HTTP Team + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/README.md b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/README.md new file mode 100644 index 0000000..7c5151e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/README.md @@ -0,0 +1,46 @@ +# HTTPlug Discovery + +[![Latest Version](https://img.shields.io/github/release/php-http/discovery.svg?style=flat-square)](https://github.com/php-http/discovery/releases) +[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE) +[![Build Status](https://img.shields.io/travis/php-http/discovery.svg?style=flat-square)](https://travis-ci.org/php-http/discovery) +[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-http/discovery.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/discovery) +[![Quality Score](https://img.shields.io/scrutinizer/g/php-http/discovery.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/discovery) +[![Total Downloads](https://img.shields.io/packagist/dt/php-http/discovery.svg?style=flat-square)](https://packagist.org/packages/php-http/discovery) + +**Finds installed HTTPlug implementations and PSR-7 message factories.** + + +## Install + +Via Composer + +``` bash +$ composer require php-http/discovery +``` + + +## Documentation + +Please see the [official documentation](http://php-http.readthedocs.org/en/latest/discovery.html). + + +## Testing + +``` bash +$ composer test +``` + + +## Contributing + +Please see our [contributing guide](http://docs.php-http.org/en/latest/development/contributing.html). + + +## Security + +If you discover any security related issues, please contact us at [security@php-http.org](mailto:security@php-http.org). + + +## License + +The MIT License (MIT). Please see [License File](LICENSE) for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/composer.json b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/composer.json new file mode 100644 index 0000000..128af59 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/composer.json @@ -0,0 +1,48 @@ +{ + "name": "php-http/discovery", + "description": "Finds installed HTTPlug implementations and PSR-7 message factories", + "license": "MIT", + "keywords": ["http", "discovery", "client", "adapter", "message", "factory", "psr7"], + "homepage": "http://php-http.org", + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "require": { + "php": "^5.5 || ^7.0" + }, + "require-dev": { + "php-http/httplug": "^1.0", + "php-http/message-factory": "^1.0", + "puli/composer-plugin": "1.0.0-beta10", + "phpspec/phpspec": "^2.4", + "henrikbjorn/phpspec-code-coverage" : "^2.0.2" + }, + "suggest": { + "puli/composer-plugin": "Sets up Puli which is recommended for Discovery to work. Check http://docs.php-http.org/en/latest/discovery.html for more details.", + "php-http/message": "Allow to use Guzzle, Diactoros or Slim Framework factories" + }, + "autoload": { + "psr-4": { + "Http\\Discovery\\": "src/" + } + }, + "autoload-dev": { + "psr-4": { + "spec\\Http\\Discovery\\": "spec/" + } + }, + "scripts": { + "test": "vendor/bin/phpspec run", + "test-ci": "vendor/bin/phpspec run -c phpspec.ci.yml" + }, + "extra": { + "branch-alias": { + "dev-master": "1.3-dev" + } + }, + "prefer-stable": true, + "minimum-stability": "beta" +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/ClassDiscovery.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/ClassDiscovery.php new file mode 100644 index 0000000..2c3e877 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/ClassDiscovery.php @@ -0,0 +1,207 @@ + + * @author Márk Sági-Kazár + * @author Tobias Nyholm + */ +abstract class ClassDiscovery +{ + /** + * A list of strategies to find classes. + * + * @var array + */ + private static $strategies = [ + Strategy\PuliBetaStrategy::class, + Strategy\CommonClassesStrategy::class, + ]; + + /** + * Discovery cache to make the second time we use discovery faster. + * + * @var array + */ + private static $cache = []; + + /** + * Finds a class. + * + * @param string $type + * + * @return string|\Closure + * + * @throws DiscoveryFailedException + */ + protected static function findOneByType($type) + { + // Look in the cache + if (null !== ($class = self::getFromCache($type))) { + return $class; + } + + $exceptions = []; + foreach (self::$strategies as $strategy) { + try { + $candidates = call_user_func($strategy.'::getCandidates', $type); + } catch (StrategyUnavailableException $e) { + $exceptions[] = $e; + continue; + } + + foreach ($candidates as $candidate) { + if (isset($candidate['condition'])) { + if (!self::evaluateCondition($candidate['condition'])) { + continue; + } + } + + // save the result for later use + self::storeInCache($type, $candidate); + + return $candidate['class']; + } + } + + throw DiscoveryFailedException::create($exceptions); + } + + /** + * Get a value from cache. + * + * @param string $type + * + * @return string|null + */ + private static function getFromCache($type) + { + if (!isset(self::$cache[$type])) { + return; + } + + $candidate = self::$cache[$type]; + if (isset($candidate['condition'])) { + if (!self::evaluateCondition($candidate['condition'])) { + return; + } + } + + return $candidate['class']; + } + + /** + * Store a value in cache. + * + * @param string $type + * @param string $class + */ + private static function storeInCache($type, $class) + { + self::$cache[$type] = $class; + } + + /** + * Set new strategies and clear the cache. + * + * @param array $strategies string array of fully qualified class name to a DiscoveryStrategy + */ + public static function setStrategies(array $strategies) + { + self::$strategies = $strategies; + self::clearCache(); + } + + /** + * Append a strategy at the end of the strategy queue. + * + * @param string $strategy Fully qualified class name to a DiscoveryStrategy + */ + public static function appendStrategy($strategy) + { + self::$strategies[] = $strategy; + self::clearCache(); + } + + /** + * Prepend a strategy at the beginning of the strategy queue. + * + * @param string $strategy Fully qualified class name to a DiscoveryStrategy + */ + public static function prependStrategy($strategy) + { + array_unshift(self::$strategies, $strategy); + self::clearCache(); + } + + /** + * Clear the cache. + */ + public static function clearCache() + { + self::$cache = []; + } + + /** + * Evaluates conditions to boolean. + * + * @param mixed $condition + * + * @return bool + */ + protected static function evaluateCondition($condition) + { + if (is_string($condition)) { + // Should be extended for functions, extensions??? + return class_exists($condition); + } elseif (is_callable($condition)) { + return $condition(); + } elseif (is_bool($condition)) { + return $condition; + } elseif (is_array($condition)) { + $evaluatedCondition = true; + + // Immediately stop execution if the condition is false + for ($i = 0; $i < count($condition) && false !== $evaluatedCondition; ++$i) { + $evaluatedCondition &= static::evaluateCondition($condition[$i]); + } + + return $evaluatedCondition; + } + + return false; + } + + /** + * Get an instance of the $class. + * + * @param string|\Closure $class A FQCN of a class or a closure that instantiate the class. + * + * @return object + * + * @throws ClassInstantiationFailedException + */ + protected static function instantiateClass($class) + { + try { + if (is_string($class)) { + return new $class(); + } + + if (is_callable($class)) { + return $class(); + } + } catch (\Exception $e) { + throw new ClassInstantiationFailedException('Unexpected exception when instantiating class.', 0, $e); + } + + throw new ClassInstantiationFailedException('Could not instantiate class because parameter is neither a callable nor a string'); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception.php new file mode 100644 index 0000000..973c908 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception.php @@ -0,0 +1,12 @@ + + */ +interface Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/ClassInstantiationFailedException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/ClassInstantiationFailedException.php new file mode 100644 index 0000000..e95bf5d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/ClassInstantiationFailedException.php @@ -0,0 +1,14 @@ + + */ +final class ClassInstantiationFailedException extends \RuntimeException implements Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/DiscoveryFailedException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/DiscoveryFailedException.php new file mode 100644 index 0000000..304b727 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/DiscoveryFailedException.php @@ -0,0 +1,51 @@ + + */ +final class DiscoveryFailedException extends \Exception implements Exception +{ + /** + * @var \Exception[] + */ + private $exceptions; + + /** + * @param string $message + * @param \Exception[] $exceptions + */ + public function __construct($message, array $exceptions = []) + { + $this->exceptions = $exceptions; + + parent::__construct($message); + } + + /** + * @param \Exception[] $exceptions + */ + public static function create($exceptions) + { + $message = 'Could not find resource using any discovery strategy. Find more information at http://docs.php-http.org/en/latest/discovery.html#common-errors'; + foreach ($exceptions as $e) { + $message .= "\n - ".$e->getMessage(); + } + $message .= "\n\n"; + + return new self($message, $exceptions); + } + + /** + * @return \Exception[] + */ + public function getExceptions() + { + return $this->exceptions; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/NotFoundException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/NotFoundException.php new file mode 100644 index 0000000..befbf48 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/NotFoundException.php @@ -0,0 +1,16 @@ + + */ +/*final */class NotFoundException extends \RuntimeException implements Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/PuliUnavailableException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/PuliUnavailableException.php new file mode 100644 index 0000000..a6ade73 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/PuliUnavailableException.php @@ -0,0 +1,12 @@ + + */ +final class PuliUnavailableException extends StrategyUnavailableException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/StrategyUnavailableException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/StrategyUnavailableException.php new file mode 100644 index 0000000..89ecf35 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Exception/StrategyUnavailableException.php @@ -0,0 +1,15 @@ + + */ +class StrategyUnavailableException extends \RuntimeException implements Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/HttpAsyncClientDiscovery.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/HttpAsyncClientDiscovery.php new file mode 100644 index 0000000..6ef60e7 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/HttpAsyncClientDiscovery.php @@ -0,0 +1,36 @@ + + */ +final class HttpAsyncClientDiscovery extends ClassDiscovery +{ + /** + * Finds an HTTP Async Client. + * + * @return HttpAsyncClient + * + * @throws Exception\NotFoundException + */ + public static function find() + { + try { + $asyncClient = static::findOneByType(HttpAsyncClient::class); + } catch (DiscoveryFailedException $e) { + throw new NotFoundException( + 'No HTTPlug async clients found. Make sure to install a package providing "php-http/async-client-implementation". Example: "php-http/guzzle6-adapter".', + 0, + $e + ); + } + + return static::instantiateClass($asyncClient); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/HttpClientDiscovery.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/HttpClientDiscovery.php new file mode 100644 index 0000000..2654b7e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/HttpClientDiscovery.php @@ -0,0 +1,36 @@ + + */ +final class HttpClientDiscovery extends ClassDiscovery +{ + /** + * Finds an HTTP Client. + * + * @return HttpClient + * + * @throws Exception\NotFoundException + */ + public static function find() + { + try { + $client = static::findOneByType(HttpClient::class); + } catch (DiscoveryFailedException $e) { + throw new NotFoundException( + 'No HTTPlug clients found. Make sure to install a package providing "php-http/client-implementation". Example: "php-http/guzzle6-adapter".', + 0, + $e + ); + } + + return static::instantiateClass($client); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/MessageFactoryDiscovery.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/MessageFactoryDiscovery.php new file mode 100644 index 0000000..c21b9bf --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/MessageFactoryDiscovery.php @@ -0,0 +1,36 @@ + + */ +final class MessageFactoryDiscovery extends ClassDiscovery +{ + /** + * Finds a Message Factory. + * + * @return MessageFactory + * + * @throws Exception\NotFoundException + */ + public static function find() + { + try { + $messageFactory = static::findOneByType(MessageFactory::class); + } catch (DiscoveryFailedException $e) { + throw new NotFoundException( + 'No message factories found. To use Guzzle, Diactoros or Slim Framework factories install php-http/message and the chosen message implementation.', + 0, + $e + ); + } + + return static::instantiateClass($messageFactory); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/NotFoundException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/NotFoundException.php new file mode 100644 index 0000000..d59dadb --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/NotFoundException.php @@ -0,0 +1,14 @@ + + * + * @deprecated since since version 1.0, and will be removed in 2.0. Use {@link \Http\Discovery\Exception\NotFoundException} instead. + */ +final class NotFoundException extends \Http\Discovery\Exception\NotFoundException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/CommonClassesStrategy.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/CommonClassesStrategy.php new file mode 100644 index 0000000..6e42bee --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/CommonClassesStrategy.php @@ -0,0 +1,82 @@ + + */ +final class CommonClassesStrategy implements DiscoveryStrategy +{ + /** + * @var array + */ + private static $classes = [ + 'Http\Message\MessageFactory' => [ + ['class' => GuzzleMessageFactory::class, 'condition' => [GuzzleRequest::class, GuzzleMessageFactory::class]], + ['class' => DiactorosMessageFactory::class, 'condition' => [DiactorosRequest::class, DiactorosMessageFactory::class]], + ['class' => SlimMessageFactory::class, 'condition' => [SlimRequest::class, SlimMessageFactory::class]], + ], + 'Http\Message\StreamFactory' => [ + ['class' => GuzzleStreamFactory::class, 'condition' => [GuzzleRequest::class, GuzzleStreamFactory::class]], + ['class' => DiactorosStreamFactory::class, 'condition' => [DiactorosRequest::class, DiactorosStreamFactory::class]], + ['class' => SlimStreamFactory::class, 'condition' => [SlimRequest::class, SlimStreamFactory::class]], + ], + 'Http\Message\UriFactory' => [ + ['class' => GuzzleUriFactory::class, 'condition' => [GuzzleRequest::class, GuzzleUriFactory::class]], + ['class' => DiactorosUriFactory::class, 'condition' => [DiactorosRequest::class, DiactorosUriFactory::class]], + ['class' => SlimUriFactory::class, 'condition' => [SlimRequest::class, SlimUriFactory::class]], + ], + 'Http\Client\HttpAsyncClient' => [ + ['class' => Guzzle6::class, 'condition' => Guzzle6::class], + ['class' => Curl::class, 'condition' => Curl::class], + ['class' => React::class, 'condition' => React::class], + ], + 'Http\Client\HttpClient' => [ + ['class' => Guzzle6::class, 'condition' => Guzzle6::class], + ['class' => Guzzle5::class, 'condition' => Guzzle5::class], + ['class' => Curl::class, 'condition' => Curl::class], + ['class' => Socket::class, 'condition' => Socket::class], + ['class' => Buzz::class, 'condition' => Buzz::class], + ['class' => React::class, 'condition' => React::class], + ['class' => Cake::class, 'condition' => Cake::class], + ['class' => Zend::class, 'condition' => Zend::class], + ['class' => Artax::class, 'condition' => Artax::class], + ], + ]; + + /** + * {@inheritdoc} + */ + public static function getCandidates($type) + { + if (isset(self::$classes[$type])) { + return self::$classes[$type]; + } + + return []; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/DiscoveryStrategy.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/DiscoveryStrategy.php new file mode 100644 index 0000000..641485a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/DiscoveryStrategy.php @@ -0,0 +1,23 @@ + + */ +interface DiscoveryStrategy +{ + /** + * Find a resource of a specific type. + * + * @param string $type + * + * @return array The return value is always an array with zero or more elements. Each + * element is an array with two keys ['class' => string, 'condition' => mixed]. + * + * @throws StrategyUnavailableException if we cannot use this strategy. + */ + public static function getCandidates($type); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/MockClientStrategy.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/MockClientStrategy.php new file mode 100644 index 0000000..ea464cf --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/MockClientStrategy.php @@ -0,0 +1,24 @@ + + */ +final class MockClientStrategy implements DiscoveryStrategy +{ + /** + * {@inheritdoc} + */ + public static function getCandidates($type) + { + return ($type === HttpClient::class) + ? [['class' => Mock::class, 'condition' => Mock::class]] + : []; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/PuliBetaStrategy.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/PuliBetaStrategy.php new file mode 100644 index 0000000..2666fb3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/Strategy/PuliBetaStrategy.php @@ -0,0 +1,91 @@ + + * @author Márk Sági-Kazár + */ +class PuliBetaStrategy implements DiscoveryStrategy +{ + /** + * @var GeneratedPuliFactory + */ + protected static $puliFactory; + + /** + * @var Discovery + */ + protected static $puliDiscovery; + + /** + * @return GeneratedPuliFactory + * + * @throws PuliUnavailableException + */ + private static function getPuliFactory() + { + if (null === self::$puliFactory) { + if (!defined('PULI_FACTORY_CLASS')) { + throw new PuliUnavailableException('Puli Factory is not available'); + } + + $puliFactoryClass = PULI_FACTORY_CLASS; + + if (!class_exists($puliFactoryClass)) { + throw new PuliUnavailableException('Puli Factory class does not exist'); + } + + self::$puliFactory = new $puliFactoryClass(); + } + + return self::$puliFactory; + } + + /** + * Returns the Puli discovery layer. + * + * @return Discovery + * + * @throws PuliUnavailableException + */ + private static function getPuliDiscovery() + { + if (!isset(self::$puliDiscovery)) { + $factory = self::getPuliFactory(); + $repository = $factory->createRepository(); + + self::$puliDiscovery = $factory->createDiscovery($repository); + } + + return self::$puliDiscovery; + } + + /** + * {@inheritdoc} + */ + public static function getCandidates($type) + { + $returnData = []; + $bindings = self::getPuliDiscovery()->findBindings($type); + + foreach ($bindings as $binding) { + $condition = true; + if ($binding->hasParameterValue('depends')) { + $condition = $binding->getParameterValue('depends'); + } + $returnData[] = ['class' => $binding->getClassName(), 'condition' => $condition]; + } + + return $returnData; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/StreamFactoryDiscovery.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/StreamFactoryDiscovery.php new file mode 100644 index 0000000..7bcc8ce --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/StreamFactoryDiscovery.php @@ -0,0 +1,36 @@ + + */ +final class StreamFactoryDiscovery extends ClassDiscovery +{ + /** + * Finds a Stream Factory. + * + * @return StreamFactory + * + * @throws Exception\NotFoundException + */ + public static function find() + { + try { + $streamFactory = static::findOneByType(StreamFactory::class); + } catch (DiscoveryFailedException $e) { + throw new NotFoundException( + 'No stream factories found. To use Guzzle, Diactoros or Slim Framework factories install php-http/message and the chosen message implementation.', + 0, + $e + ); + } + + return static::instantiateClass($streamFactory); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/UriFactoryDiscovery.php b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/UriFactoryDiscovery.php new file mode 100644 index 0000000..1eef1e6 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/discovery/src/UriFactoryDiscovery.php @@ -0,0 +1,36 @@ + + */ +final class UriFactoryDiscovery extends ClassDiscovery +{ + /** + * Finds a URI Factory. + * + * @return UriFactory + * + * @throws Exception\NotFoundException + */ + public static function find() + { + try { + $uriFactory = static::findOneByType(UriFactory::class); + } catch (DiscoveryFailedException $e) { + throw new NotFoundException( + 'No uri factories found. To use Guzzle, Diactoros or Slim Framework factories install php-http/message and the chosen message implementation.', + 0, + $e + ); + } + + return static::instantiateClass($uriFactory); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/CHANGELOG.md new file mode 100644 index 0000000..8478966 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/CHANGELOG.md @@ -0,0 +1,72 @@ +# Change Log + +## 1.1.0 - 2016-08-31 + +- Added HttpFulfilledPromise and HttpRejectedPromise which respect the HttpAsyncClient interface + +## 1.0.0 - 2016-01-26 + +### Removed + +- Stability configuration from composer + + +## 1.0.0-RC1 - 2016-01-12 + +### Changed + +- Updated package files +- Updated promise dependency to RC1 + + +## 1.0.0-beta - 2015-12-17 + +### Added + +- Puli configuration and binding types + +### Changed + +- Exception concept + + +## 1.0.0-alpha3 - 2015-12-13 + +### Changed + +- Async client does not throw exceptions + +### Removed + +- Promise interface moved to its own repository: [php-http/promise](https://github.com/php-http/promise) + + +## 1.0.0-alpha2 - 2015-11-16 + +### Added + +- Async client and Promise interface + + +## 1.0.0-alpha - 2015-10-26 + +### Added + +- Better domain exceptions. + +### Changed + +- Purpose of the library: general HTTP CLient abstraction. + +### Removed + +- Request options: they should be configured at construction time. +- Multiple request sending: should be done asynchronously using Async Client. +- `getName` method + + +## 0.1.0 - 2015-06-03 + +### Added + +- Initial release diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/LICENSE b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/LICENSE new file mode 100644 index 0000000..48741e4 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/LICENSE @@ -0,0 +1,20 @@ +Copyright (c) 2014-2015 Eric GELOEN +Copyright (c) 2015-2016 PHP HTTP Team + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/README.md b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/README.md new file mode 100644 index 0000000..f46212b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/README.md @@ -0,0 +1,57 @@ +# HTTPlug + +[![Latest Version](https://img.shields.io/github/release/php-http/httplug.svg?style=flat-square)](https://github.com/php-http/httplug/releases) +[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE) +[![Build Status](https://img.shields.io/travis/php-http/httplug.svg?style=flat-square)](https://travis-ci.org/php-http/httplug) +[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-http/httplug.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/httplug) +[![Quality Score](https://img.shields.io/scrutinizer/g/php-http/httplug.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/httplug) +[![Total Downloads](https://img.shields.io/packagist/dt/php-http/httplug.svg?style=flat-square)](https://packagist.org/packages/php-http/httplug) + +[![Slack Status](http://slack.httplug.io/badge.svg)](http://slack.httplug.io) +[![Email](https://img.shields.io/badge/email-team@httplug.io-blue.svg?style=flat-square)](mailto:team@httplug.io) + +**HTTPlug, the HTTP client abstraction for PHP.** + + +## Install + +Via Composer + +``` bash +$ composer require php-http/httplug +``` + + +## Intro + +This is the contract package for HTTP Client. +Use it to create HTTP Clients which are interoperable and compatible with [PSR-7](http://www.php-fig.org/psr/psr-7/). + +This library is the official successor of the [ivory http adapter](https://github.com/egeloen/ivory-http-adapter). + + +## Documentation + +Please see the [official documentation](http://docs.php-http.org). + + +## Testing + +``` bash +$ composer test +``` + + +## Contributing + +Please see our [contributing guide](http://docs.php-http.org/en/latest/development/contributing.html). + + +## Security + +If you discover any security related issues, please contact us at [security@php-http.org](mailto:security@php-http.org). + + +## License + +The MIT License (MIT). Please see [License File](LICENSE) for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/composer.json b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/composer.json new file mode 100644 index 0000000..f74c4d3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/composer.json @@ -0,0 +1,40 @@ +{ + "name": "php-http/httplug", + "description": "HTTPlug, the HTTP client abstraction for PHP", + "license": "MIT", + "keywords": ["http", "client"], + "homepage": "http://httplug.io", + "authors": [ + { + "name": "Eric GELOEN", + "email": "geloen.eric@gmail.com" + }, + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "require": { + "php": ">=5.4", + "psr/http-message": "^1.0", + "php-http/promise": "^1.0" + }, + "require-dev": { + "phpspec/phpspec": "^2.4", + "henrikbjorn/phpspec-code-coverage" : "^1.0" + }, + "autoload": { + "psr-4": { + "Http\\Client\\": "src/" + } + }, + "scripts": { + "test": "vendor/bin/phpspec run", + "test-ci": "vendor/bin/phpspec run -c phpspec.ci.yml" + }, + "extra": { + "branch-alias": { + "dev-master": "1.1-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/puli.json b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/puli.json new file mode 100644 index 0000000..4168331 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/puli.json @@ -0,0 +1,12 @@ +{ + "version": "1.0", + "name": "php-http/httplug", + "binding-types": { + "Http\\Client\\HttpAsyncClient": { + "description": "Async HTTP Client" + }, + "Http\\Client\\HttpClient": { + "description": "HTTP Client" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception.php new file mode 100644 index 0000000..e7382c3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception.php @@ -0,0 +1,12 @@ + + */ +interface Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/HttpException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/HttpException.php new file mode 100644 index 0000000..f4f32a4 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/HttpException.php @@ -0,0 +1,74 @@ + + */ +class HttpException extends RequestException +{ + /** + * @var ResponseInterface + */ + protected $response; + + /** + * @param string $message + * @param RequestInterface $request + * @param ResponseInterface $response + * @param \Exception|null $previous + */ + public function __construct( + $message, + RequestInterface $request, + ResponseInterface $response, + \Exception $previous = null + ) { + parent::__construct($message, $request, $previous); + + $this->response = $response; + $this->code = $response->getStatusCode(); + } + + /** + * Returns the response. + * + * @return ResponseInterface + */ + public function getResponse() + { + return $this->response; + } + + /** + * Factory method to create a new exception with a normalized error message. + * + * @param RequestInterface $request + * @param ResponseInterface $response + * @param \Exception|null $previous + * + * @return HttpException + */ + public static function create( + RequestInterface $request, + ResponseInterface $response, + \Exception $previous = null + ) { + $message = sprintf( + '[url] %s [http method] %s [status code] %s [reason phrase] %s', + $request->getRequestTarget(), + $request->getMethod(), + $response->getStatusCode(), + $response->getReasonPhrase() + ); + + return new self($message, $request, $response, $previous); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/NetworkException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/NetworkException.php new file mode 100644 index 0000000..f2198e5 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/NetworkException.php @@ -0,0 +1,14 @@ + + */ +class NetworkException extends RequestException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/RequestException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/RequestException.php new file mode 100644 index 0000000..cdce14b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/RequestException.php @@ -0,0 +1,43 @@ + + */ +class RequestException extends TransferException +{ + /** + * @var RequestInterface + */ + private $request; + + /** + * @param string $message + * @param RequestInterface $request + * @param \Exception|null $previous + */ + public function __construct($message, RequestInterface $request, \Exception $previous = null) + { + $this->request = $request; + + parent::__construct($message, 0, $previous); + } + + /** + * Returns the request. + * + * @return RequestInterface + */ + public function getRequest() + { + return $this->request; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/TransferException.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/TransferException.php new file mode 100644 index 0000000..a858cf5 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Exception/TransferException.php @@ -0,0 +1,14 @@ + + */ +class TransferException extends \RuntimeException implements Exception +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/HttpAsyncClient.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/HttpAsyncClient.php new file mode 100644 index 0000000..492e511 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/HttpAsyncClient.php @@ -0,0 +1,27 @@ + + */ +interface HttpAsyncClient +{ + /** + * Sends a PSR-7 request in an asynchronous way. + * + * Exceptions related to processing the request are available from the returned Promise. + * + * @param RequestInterface $request + * + * @return Promise Resolves a PSR-7 Response or fails with an Http\Client\Exception. + * + * @throws \Exception If processing the request is impossible (eg. bad configuration). + */ + public function sendAsyncRequest(RequestInterface $request); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/HttpClient.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/HttpClient.php new file mode 100644 index 0000000..0e51749 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/HttpClient.php @@ -0,0 +1,28 @@ + + * @author Márk Sági-Kazár + * @author David Buchmann + */ +interface HttpClient +{ + /** + * Sends a PSR-7 request. + * + * @param RequestInterface $request + * + * @return ResponseInterface + * + * @throws \Http\Client\Exception If an error happens during processing the request. + * @throws \Exception If processing the request is impossible (eg. bad configuration). + */ + public function sendRequest(RequestInterface $request); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Promise/HttpFulfilledPromise.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Promise/HttpFulfilledPromise.php new file mode 100644 index 0000000..6779e44 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Promise/HttpFulfilledPromise.php @@ -0,0 +1,57 @@ +response = $response; + } + + /** + * {@inheritdoc} + */ + public function then(callable $onFulfilled = null, callable $onRejected = null) + { + if (null === $onFulfilled) { + return $this; + } + + try { + return new self($onFulfilled($this->response)); + } catch (Exception $e) { + return new HttpRejectedPromise($e); + } + } + + /** + * {@inheritdoc} + */ + public function getState() + { + return Promise::FULFILLED; + } + + /** + * {@inheritdoc} + */ + public function wait($unwrap = true) + { + if ($unwrap) { + return $this->response; + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Promise/HttpRejectedPromise.php b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Promise/HttpRejectedPromise.php new file mode 100644 index 0000000..bfb0738 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/httplug/src/Promise/HttpRejectedPromise.php @@ -0,0 +1,56 @@ +exception = $exception; + } + + /** + * {@inheritdoc} + */ + public function then(callable $onFulfilled = null, callable $onRejected = null) + { + if (null === $onRejected) { + return $this; + } + + try { + return new HttpFulfilledPromise($onRejected($this->exception)); + } catch (Exception $e) { + return new self($e); + } + } + + /** + * {@inheritdoc} + */ + public function getState() + { + return Promise::REJECTED; + } + + /** + * {@inheritdoc} + */ + public function wait($unwrap = true) + { + if ($unwrap) { + throw $this->exception; + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/CHANGELOG.md new file mode 100644 index 0000000..4711924 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/CHANGELOG.md @@ -0,0 +1,65 @@ +# Change Log + + +## 1.0.2 - 2015-12-19 + +### Added + +- Request and Response factory binding types to Puli + + +## 1.0.1 - 2015-12-17 + +### Added + +- Puli configuration and binding types + + +## 1.0.0 - 2015-12-15 + +### Added + +- Response Factory in order to be reused in Message and Server Message factories +- Request Factory + +### Changed + +- Message Factory extends Request and Response factories + + +## 1.0.0-RC1 - 2015-12-14 + +### Added + +- CS check + +### Changed + +- RuntimeException is thrown when the StreamFactory cannot write to the underlying stream + + +## 0.3.0 - 2015-11-16 + +### Removed + +- Client Context Factory +- Factory Awares and Templates + + +## 0.2.0 - 2015-11-16 + +### Changed + +- Reordered the parameters when creating a message to have the protocol last, +as its the least likely to need to be changed. + + +## 0.1.0 - 2015-06-01 + +### Added + +- Initial release + +### Changed + +- Helpers are renamed to templates diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/LICENSE b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/LICENSE new file mode 100644 index 0000000..8e2c4a0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2015 PHP HTTP Team + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/README.md b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/README.md new file mode 100644 index 0000000..4654495 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/README.md @@ -0,0 +1,36 @@ +# PSR-7 Message Factory + +[![Latest Version](https://img.shields.io/github/release/php-http/message-factory.svg?style=flat-square)](https://github.com/php-http/message-factory/releases) +[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE) +[![Total Downloads](https://img.shields.io/packagist/dt/php-http/message-factory.svg?style=flat-square)](https://packagist.org/packages/php-http/message-factory) + +**Factory interfaces for PSR-7 HTTP Message.** + + +## Install + +Via Composer + +``` bash +$ composer require php-http/message-factory +``` + + +## Documentation + +Please see the [official documentation](http://php-http.readthedocs.org/en/latest/message-factory/). + + +## Contributing + +Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details. + + +## Security + +If you discover any security related issues, please contact us at [security@php-http.org](mailto:security@php-http.org). + + +## License + +The MIT License (MIT). Please see [License File](LICENSE) for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/composer.json b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/composer.json new file mode 100644 index 0000000..7c72feb --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/composer.json @@ -0,0 +1,27 @@ +{ + "name": "php-http/message-factory", + "description": "Factory interfaces for PSR-7 HTTP Message", + "license": "MIT", + "keywords": ["http", "factory", "message", "stream", "uri"], + "homepage": "http://php-http.org", + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "require": { + "php": ">=5.4", + "psr/http-message": "^1.0" + }, + "autoload": { + "psr-4": { + "Http\\Message\\": "src/" + } + }, + "extra": { + "branch-alias": { + "dev-master": "1.0-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/puli.json b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/puli.json new file mode 100644 index 0000000..08d3762 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/puli.json @@ -0,0 +1,43 @@ +{ + "version": "1.0", + "binding-types": { + "Http\\Message\\MessageFactory": { + "description": "PSR-7 Message Factory", + "parameters": { + "depends": { + "description": "Optional class dependency which can be checked by consumers" + } + } + }, + "Http\\Message\\RequestFactory": { + "parameters": { + "depends": { + "description": "Optional class dependency which can be checked by consumers" + } + } + }, + "Http\\Message\\ResponseFactory": { + "parameters": { + "depends": { + "description": "Optional class dependency which can be checked by consumers" + } + } + }, + "Http\\Message\\StreamFactory": { + "description": "PSR-7 Stream Factory", + "parameters": { + "depends": { + "description": "Optional class dependency which can be checked by consumers" + } + } + }, + "Http\\Message\\UriFactory": { + "description": "PSR-7 URI Factory", + "parameters": { + "depends": { + "description": "Optional class dependency which can be checked by consumers" + } + } + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/MessageFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/MessageFactory.php new file mode 100644 index 0000000..965aaa8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/MessageFactory.php @@ -0,0 +1,12 @@ + + */ +interface MessageFactory extends RequestFactory, ResponseFactory +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/RequestFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/RequestFactory.php new file mode 100644 index 0000000..624e82f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/RequestFactory.php @@ -0,0 +1,34 @@ + + */ +interface RequestFactory +{ + /** + * Creates a new PSR-7 request. + * + * @param string $method + * @param string|UriInterface $uri + * @param array $headers + * @param resource|string|StreamInterface|null $body + * @param string $protocolVersion + * + * @return RequestInterface + */ + public function createRequest( + $method, + $uri, + array $headers = [], + $body = null, + $protocolVersion = '1.1' + ); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/ResponseFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/ResponseFactory.php new file mode 100644 index 0000000..2411ed3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/ResponseFactory.php @@ -0,0 +1,35 @@ + + */ +interface ResponseFactory +{ + /** + * Creates a new PSR-7 response. + * + * @param int $statusCode + * @param string|null $reasonPhrase + * @param array $headers + * @param resource|string|StreamInterface|null $body + * @param string $protocolVersion + * + * @return ResponseInterface + */ + public function createResponse( + $statusCode = 200, + $reasonPhrase = null, + array $headers = [], + $body = null, + $protocolVersion = '1.1' + ); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/StreamFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/StreamFactory.php new file mode 100644 index 0000000..327a902 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/StreamFactory.php @@ -0,0 +1,25 @@ + + */ +interface StreamFactory +{ + /** + * Creates a new PSR-7 stream. + * + * @param string|resource|StreamInterface|null $body + * + * @return StreamInterface + * + * @throws \InvalidArgumentException If the stream body is invalid. + * @throws \RuntimeException If creating the stream from $body fails. + */ + public function createStream($body = null); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/UriFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/UriFactory.php new file mode 100644 index 0000000..f05e625 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message-factory/src/UriFactory.php @@ -0,0 +1,24 @@ + + */ +interface UriFactory +{ + /** + * Creates an PSR-7 URI. + * + * @param string|UriInterface $uri + * + * @return UriInterface + * + * @throws \InvalidArgumentException If the $uri argument can not be converted into a valid URI. + */ + public function createUri($uri); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/php-http/message/CHANGELOG.md new file mode 100644 index 0000000..7676349 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/CHANGELOG.md @@ -0,0 +1,139 @@ +# Change Log + + +## 1.6.0 - 2017-07-05 + +### Added + +- CookieUtil::parseDate to create a date from cookie date string + +### Fixed + +- Fix curl command of CurlFormatter when there is an user-agent header + +## 1.5.0 - 2017-02-14 + +### Added + +- Check for empty string in Stream factories +- Cookie::createWithoutValidation Static constructor to create a cookie. Will not perform any attribute validation during instantiation. +- Cookie::isValid Method to check if cookie attributes are valid. + +### Fixed + +- FilteredStream::getSize returns null because the contents size is unknown. +- Stream factories does not rewinds streams. The previous behavior was not coherent between factories and inputs. + +### Deprecated + +- FilteredStream::getReadFilter The read filter is internal and should never be used by consuming code. +- FilteredStream::getWriteFilter We did not implement writing to the streams at all. And if we do, the filter is an internal information and should not be used by consuming code. + + +## 1.4.1 - 2016-12-16 + +### Fixed + +- Cookie::matchPath Cookie with root path (`/`) will not match sub path (e.g. `/cookie`). + + +## 1.4.0 - 2016-10-20 + +### Added + +- Message, stream and URI factories for [Slim Framework](https://github.com/slimphp/Slim) +- BufferedStream that allow you to decorate a non-seekable stream with a seekable one. +- cUrlFormatter to be able to redo the request with a cURL command + + +## 1.3.1 - 2016-07-15 + +### Fixed + +- FullHttpMessageFormatter will not read from streams that you cannot rewind (non-seekable) +- FullHttpMessageFormatter will not read from the stream if $maxBodyLength is zero +- FullHttpMessageFormatter rewinds streams after they are read + + +## 1.3.0 - 2016-07-14 + +### Added + +- FullHttpMessageFormatter to include headers and body in the formatted message + +### Fixed + +- #41: Response builder broke header value + + +## 1.2.0 - 2016-03-29 + +### Added + +- The RequestMatcher is built after the Symfony RequestMatcher and separates + scheme, host and path expressions and provides an option to filter on the + method +- New RequestConditional authentication method using request matchers +- Add automatic basic auth info detection based on the URL + +### Changed + +- Improved ResponseBuilder + +### Deprecated + +- RegexRequestMatcher, use RequestMatcher instead +- Matching authenitcation method, use RequestConditional instead + + +## 1.1.0 - 2016-02-25 + +### Added + + - Add a request matcher interface and regex implementation + - Add a callback request matcher implementation + - Add a ResponseBuilder, to create PSR7 Response from a string + +### Fixed + + - Fix casting string on a FilteredStream not filtering the output + + +## 1.0.0 - 2016-01-27 + + +## 0.2.0 - 2015-12-29 + +### Added + +- Autoregistration of stream filters using Composer autoload +- Cookie +- [Apigen](http://www.apigen.org/) configuration + + +## 0.1.2 - 2015-12-26 + +### Added + +- Request and response factory bindings + +### Fixed + +- Chunk filter namespace in Dechunk stream + + +## 0.1.1 - 2015-12-25 + +### Added + +- Formatter + + +## 0.1.0 - 2015-12-24 + +### Added + +- Authentication +- Encoding +- Message decorator +- Message factory (Guzzle, Diactoros) diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/LICENSE b/Postman/Postman-Mail/mailgun/vendor/php-http/message/LICENSE new file mode 100644 index 0000000..4558d6f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2015-2016 PHP HTTP Team + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/README.md b/Postman/Postman-Mail/mailgun/vendor/php-http/message/README.md new file mode 100644 index 0000000..338b415 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/README.md @@ -0,0 +1,61 @@ +# HTTP Message + +[![Latest Version](https://img.shields.io/github/release/php-http/message.svg?style=flat-square)](https://github.com/php-http/message/releases) +[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE) +[![Build Status](https://img.shields.io/travis/php-http/message.svg?style=flat-square)](https://travis-ci.org/php-http/message) +[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-http/message.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/message) +[![Quality Score](https://img.shields.io/scrutinizer/g/php-http/message.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/message) +[![Total Downloads](https://img.shields.io/packagist/dt/php-http/message.svg?style=flat-square)](https://packagist.org/packages/php-http/message) + +**HTTP Message related tools.** + + +## Install + +Via Composer + +``` bash +$ composer require php-http/message +``` + + +## Intro + +This package contains various PSR-7 tools which might be useful in an HTTP workflow: + +- Authentication method implementations +- Various Stream encoding tools +- Message decorators +- Message factory implementations for Guzzle PSR-7 and Diactoros +- Cookie implementation +- Request matchers + + +## Documentation + +Please see the [official documentation](http://docs.php-http.org/en/latest/message.html). + + +## Testing + +``` bash +$ composer test +``` + + +## Contributing + +Please see our [contributing guide](http://docs.php-http.org/en/latest/development/contributing.html). + +## Cretids + +Thanks to [Cuzzle](https://github.com/namshi/cuzzle) for inpiration for the `CurlCommandFormatter`. + +## Security + +If you discover any security related issues, please contact us at [security@php-http.org](mailto:security@php-http.org). + + +## License + +The MIT License (MIT). Please see [License File](LICENSE) for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/apigen.neon b/Postman/Postman-Mail/mailgun/vendor/php-http/message/apigen.neon new file mode 100644 index 0000000..0ba1a18 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/apigen.neon @@ -0,0 +1,6 @@ +source: + - src/ + +destination: build/api/ + +templateTheme: bootstrap diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/composer.json b/Postman/Postman-Mail/mailgun/vendor/php-http/message/composer.json new file mode 100644 index 0000000..6fbc5db --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/composer.json @@ -0,0 +1,60 @@ +{ + "name": "php-http/message", + "description": "HTTP Message related tools", + "license": "MIT", + "keywords": ["message", "http", "psr-7"], + "homepage": "http://php-http.org", + "authors": [ + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "require": { + "php": ">=5.4", + "psr/http-message": "^1.0", + "php-http/message-factory": "^1.0.2", + "clue/stream-filter": "^1.3" + }, + "provide": { + "php-http/message-factory-implementation": "1.0" + }, + "require-dev": { + "zendframework/zend-diactoros": "^1.0", + "guzzlehttp/psr7": "^1.0", + "ext-zlib": "*", + "phpspec/phpspec": "^2.4", + "henrikbjorn/phpspec-code-coverage" : "^1.0", + "coduo/phpspec-data-provider-extension": "^1.0", + "akeneo/phpspec-skip-example-extension": "^1.0", + "slim/slim": "^3.0" + }, + "suggest": { + "zendframework/zend-diactoros": "Used with Diactoros Factories", + "guzzlehttp/psr7": "Used with Guzzle PSR-7 Factories", + "slim/slim": "Used with Slim Framework PSR-7 implementation", + "ext-zlib": "Used with compressor/decompressor streams" + }, + "autoload": { + "psr-4": { + "Http\\Message\\": "src/" + }, + "files": [ + "src/filters.php" + ] + }, + "autoload-dev": { + "psr-4": { + "spec\\Http\\Message\\": "spec/" + } + }, + "scripts": { + "test": "vendor/bin/phpspec run", + "test-ci": "vendor/bin/phpspec run -c phpspec.ci.yml" + }, + "extra": { + "branch-alias": { + "dev-master": "1.6-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/puli.json b/Postman/Postman-Mail/mailgun/vendor/php-http/message/puli.json new file mode 100644 index 0000000..024a85d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/puli.json @@ -0,0 +1,111 @@ +{ + "version": "1.0", + "name": "php-http/message", + "bindings": { + "064d003d-78a1-48c4-8f3b-1f92ff25da69": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\DiactorosMessageFactory", + "type": "Http\\Message\\MessageFactory", + "parameters": { + "depends": "Zend\\Diactoros\\Request" + } + }, + "0836751e-6558-4d1b-8993-4a52012947c3": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\SlimMessageFactory", + "type": "Http\\Message\\ResponseFactory" + }, + "1d127622-dc61-4bfa-b9da-d221548d72c3": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\SlimMessageFactory", + "type": "Http\\Message\\RequestFactory" + }, + "2438c2d0-0658-441f-8855-ddaf0f87d54d": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\GuzzleMessageFactory", + "type": "Http\\Message\\MessageFactory", + "parameters": { + "depends": "GuzzleHttp\\Psr7\\Request" + } + }, + "253aa08c-d705-46e7-b1d2-e28c97eef792": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\GuzzleMessageFactory", + "type": "Http\\Message\\RequestFactory", + "parameters": { + "depends": "GuzzleHttp\\Psr7\\Request" + } + }, + "273a34f9-62f4-4ba1-9801-b1284d49ff89": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\StreamFactory\\GuzzleStreamFactory", + "type": "Http\\Message\\StreamFactory", + "parameters": { + "depends": "GuzzleHttp\\Psr7\\Stream" + } + }, + "304b83db-b594-4d83-ae75-1f633adf92f7": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\UriFactory\\GuzzleUriFactory", + "type": "Http\\Message\\UriFactory", + "parameters": { + "depends": "GuzzleHttp\\Psr7\\Uri" + } + }, + "3f4bc1cd-aa95-4702-9fa7-65408e471691": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\UriFactory\\DiactorosUriFactory", + "type": "Http\\Message\\UriFactory", + "parameters": { + "depends": "Zend\\Diactoros\\Uri" + } + }, + "4672a6ee-ad9e-4109-a5d1-b7d46f26c7a1": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\SlimMessageFactory", + "type": "Http\\Message\\MessageFactory" + }, + "6234e947-d3bd-43eb-97d5-7f9e22e6bb1b": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\DiactorosMessageFactory", + "type": "Http\\Message\\ResponseFactory", + "parameters": { + "depends": "Zend\\Diactoros\\Response" + } + }, + "6a9ad6ce-d82c-470f-8e30-60f21d9d95bf": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\UriFactory\\SlimUriFactory", + "type": "Http\\Message\\UriFactory" + }, + "72c2afa0-ea56-4d03-adb6-a9f241a8a734": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\StreamFactory\\SlimStreamFactory", + "type": "Http\\Message\\StreamFactory" + }, + "95c1be8f-39fe-4abd-8351-92cb14379a75": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\StreamFactory\\DiactorosStreamFactory", + "type": "Http\\Message\\StreamFactory", + "parameters": { + "depends": "Zend\\Diactoros\\Stream" + } + }, + "a018af27-7590-4dcf-83a1-497f95604cd6": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\GuzzleMessageFactory", + "type": "Http\\Message\\ResponseFactory", + "parameters": { + "depends": "GuzzleHttp\\Psr7\\Response" + } + }, + "c07955b1-de46-43db-923b-d07fae9382cb": { + "_class": "Puli\\Discovery\\Binding\\ClassBinding", + "class": "Http\\Message\\MessageFactory\\DiactorosMessageFactory", + "type": "Http\\Message\\RequestFactory", + "parameters": { + "depends": "Zend\\Diactoros\\Request" + } + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication.php new file mode 100644 index 0000000..b50366f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication.php @@ -0,0 +1,22 @@ + + */ +interface Authentication +{ + /** + * Authenticates a request. + * + * @param RequestInterface $request + * + * @return RequestInterface + */ + public function authenticate(RequestInterface $request); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/AutoBasicAuth.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/AutoBasicAuth.php new file mode 100644 index 0000000..7b6a429 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/AutoBasicAuth.php @@ -0,0 +1,48 @@ + + */ +final class AutoBasicAuth implements Authentication +{ + /** + * Whether user info should be removed from the URI. + * + * @var bool + */ + private $shouldRemoveUserInfo; + + /** + * @param bool|true $shouldRremoveUserInfo + */ + public function __construct($shouldRremoveUserInfo = true) + { + $this->shouldRemoveUserInfo = (bool) $shouldRremoveUserInfo; + } + + /** + * {@inheritdoc} + */ + public function authenticate(RequestInterface $request) + { + $uri = $request->getUri(); + $userInfo = $uri->getUserInfo(); + + if (!empty($userInfo)) { + if ($this->shouldRemoveUserInfo) { + $request = $request->withUri($uri->withUserInfo('')); + } + + $request = $request->withHeader('Authorization', sprintf('Basic %s', base64_encode($userInfo))); + } + + return $request; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/BasicAuth.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/BasicAuth.php new file mode 100644 index 0000000..23618a5 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/BasicAuth.php @@ -0,0 +1,44 @@ + + */ +final class BasicAuth implements Authentication +{ + /** + * @var string + */ + private $username; + + /** + * @var string + */ + private $password; + + /** + * @param string $username + * @param string $password + */ + public function __construct($username, $password) + { + $this->username = $username; + $this->password = $password; + } + + /** + * {@inheritdoc} + */ + public function authenticate(RequestInterface $request) + { + $header = sprintf('Basic %s', base64_encode(sprintf('%s:%s', $this->username, $this->password))); + + return $request->withHeader('Authorization', $header); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Bearer.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Bearer.php new file mode 100644 index 0000000..a8fb21a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Bearer.php @@ -0,0 +1,37 @@ + + */ +final class Bearer implements Authentication +{ + /** + * @var string + */ + private $token; + + /** + * @param string $token + */ + public function __construct($token) + { + $this->token = $token; + } + + /** + * {@inheritdoc} + */ + public function authenticate(RequestInterface $request) + { + $header = sprintf('Bearer %s', $this->token); + + return $request->withHeader('Authorization', $header); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Chain.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Chain.php new file mode 100644 index 0000000..71002bb --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Chain.php @@ -0,0 +1,47 @@ + + */ +final class Chain implements Authentication +{ + /** + * @var Authentication[] + */ + private $authenticationChain = []; + + /** + * @param Authentication[] $authenticationChain + */ + public function __construct(array $authenticationChain = []) + { + foreach ($authenticationChain as $authentication) { + if (!$authentication instanceof Authentication) { + throw new \InvalidArgumentException( + 'Members of the authentication chain must be of type Http\Message\Authentication' + ); + } + } + + $this->authenticationChain = $authenticationChain; + } + + /** + * {@inheritdoc} + */ + public function authenticate(RequestInterface $request) + { + foreach ($this->authenticationChain as $authentication) { + $request = $authentication->authenticate($request); + } + + return $request; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Matching.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Matching.php new file mode 100644 index 0000000..4b89b50 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Matching.php @@ -0,0 +1,74 @@ + + * + * @deprecated since since version 1.2, and will be removed in 2.0. Use {@link RequestConditional} instead. + */ +final class Matching implements Authentication +{ + /** + * @var Authentication + */ + private $authentication; + + /** + * @var CallbackRequestMatcher + */ + private $matcher; + + /** + * @param Authentication $authentication + * @param callable|null $matcher + */ + public function __construct(Authentication $authentication, callable $matcher = null) + { + if (is_null($matcher)) { + $matcher = function () { + return true; + }; + } + + $this->authentication = $authentication; + $this->matcher = new CallbackRequestMatcher($matcher); + } + + /** + * {@inheritdoc} + */ + public function authenticate(RequestInterface $request) + { + if ($this->matcher->matches($request)) { + return $this->authentication->authenticate($request); + } + + return $request; + } + + /** + * Creates a matching authentication for an URL. + * + * @param Authentication $authentication + * @param string $url + * + * @return self + */ + public static function createUrlMatcher(Authentication $authentication, $url) + { + $matcher = function (RequestInterface $request) use ($url) { + return preg_match($url, $request->getRequestTarget()); + }; + + return new static($authentication, $matcher); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/QueryParam.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/QueryParam.php new file mode 100644 index 0000000..14b58ff --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/QueryParam.php @@ -0,0 +1,50 @@ + + */ +final class QueryParam implements Authentication +{ + /** + * @var array + */ + private $params = []; + + /** + * @param array $params + */ + public function __construct(array $params) + { + $this->params = $params; + } + + /** + * {@inheritdoc} + */ + public function authenticate(RequestInterface $request) + { + $uri = $request->getUri(); + $query = $uri->getQuery(); + $params = []; + + parse_str($query, $params); + + $params = array_merge($params, $this->params); + + $query = http_build_query($params); + + $uri = $uri->withQuery($query); + + return $request->withUri($uri); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/RequestConditional.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/RequestConditional.php new file mode 100644 index 0000000..5477440 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/RequestConditional.php @@ -0,0 +1,47 @@ + + */ +final class RequestConditional implements Authentication +{ + /** + * @var RequestMatcher + */ + private $requestMatcher; + + /** + * @var Authentication + */ + private $authentication; + + /** + * @param RequestMatcher $requestMatcher + * @param Authentication $authentication + */ + public function __construct(RequestMatcher $requestMatcher, Authentication $authentication) + { + $this->requestMatcher = $requestMatcher; + $this->authentication = $authentication; + } + + /** + * {@inheritdoc} + */ + public function authenticate(RequestInterface $request) + { + if ($this->requestMatcher->matches($request)) { + return $this->authentication->authenticate($request); + } + + return $request; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Wsse.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Wsse.php new file mode 100644 index 0000000..fbbde33 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Authentication/Wsse.php @@ -0,0 +1,58 @@ + + */ +final class Wsse implements Authentication +{ + /** + * @var string + */ + private $username; + + /** + * @var string + */ + private $password; + + /** + * @param string $username + * @param string $password + */ + public function __construct($username, $password) + { + $this->username = $username; + $this->password = $password; + } + + /** + * {@inheritdoc} + */ + public function authenticate(RequestInterface $request) + { + // TODO: generate better nonce? + $nonce = substr(md5(uniqid(uniqid().'_', true)), 0, 16); + $created = date('c'); + $digest = base64_encode(sha1(base64_decode($nonce).$created.$this->password, true)); + + $wsse = sprintf( + 'UsernameToken Username="%s", PasswordDigest="%s", Nonce="%s", Created="%s"', + $this->username, + $digest, + $nonce, + $created + ); + + return $request + ->withHeader('Authorization', 'WSSE profile="UsernameToken"') + ->withHeader('X-WSSE', $wsse) + ; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Builder/ResponseBuilder.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Builder/ResponseBuilder.php new file mode 100644 index 0000000..e6933a0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Builder/ResponseBuilder.php @@ -0,0 +1,148 @@ +response = $response; + } + + /** + * Return response. + * + * @return ResponseInterface + */ + public function getResponse() + { + return $this->response; + } + + /** + * Add headers represented by an array of header lines. + * + * @param string[] $headers Response headers as array of header lines. + * + * @return $this + * + * @throws \UnexpectedValueException For invalid header values. + * @throws \InvalidArgumentException For invalid status code arguments. + */ + public function setHeadersFromArray(array $headers) + { + $status = array_shift($headers); + $this->setStatus($status); + + foreach ($headers as $headerLine) { + $headerLine = trim($headerLine); + if ('' === $headerLine) { + continue; + } + + $this->addHeader($headerLine); + } + + return $this; + } + + /** + * Add headers represented by a single string. + * + * @param string $headers Response headers as single string. + * + * @return $this + * + * @throws \InvalidArgumentException if $headers is not a string on object with __toString() + * @throws \UnexpectedValueException For invalid header values. + */ + public function setHeadersFromString($headers) + { + if (!(is_string($headers) + || (is_object($headers) && method_exists($headers, '__toString'))) + ) { + throw new \InvalidArgumentException( + sprintf( + '%s expects parameter 1 to be a string, %s given', + __METHOD__, + is_object($headers) ? get_class($headers) : gettype($headers) + ) + ); + } + + $this->setHeadersFromArray(explode("\r\n", $headers)); + + return $this; + } + + /** + * Set response status from a status string. + * + * @param string $statusLine Response status as a string. + * + * @return $this + * + * @throws \InvalidArgumentException For invalid status line. + */ + public function setStatus($statusLine) + { + $parts = explode(' ', $statusLine, 3); + if (count($parts) < 2 || strpos(strtolower($parts[0]), 'http/') !== 0) { + throw new \InvalidArgumentException( + sprintf('"%s" is not a valid HTTP status line', $statusLine) + ); + } + + $reasonPhrase = count($parts) > 2 ? $parts[2] : ''; + $this->response = $this->response + ->withStatus((int) $parts[1], $reasonPhrase) + ->withProtocolVersion(substr($parts[0], 5)); + + return $this; + } + + /** + * Add header represented by a string. + * + * @param string $headerLine Response header as a string. + * + * @return $this + * + * @throws \InvalidArgumentException For invalid header names or values. + */ + public function addHeader($headerLine) + { + $parts = explode(':', $headerLine, 2); + if (count($parts) !== 2) { + throw new \InvalidArgumentException( + sprintf('"%s" is not a valid HTTP header line', $headerLine) + ); + } + $name = trim($parts[0]); + $value = trim($parts[1]); + if ($this->response->hasHeader($name)) { + $this->response = $this->response->withAddedHeader($name, $value); + } else { + $this->response = $this->response->withHeader($name, $value); + } + + return $this; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Cookie.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Cookie.php new file mode 100644 index 0000000..5f61b90 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Cookie.php @@ -0,0 +1,526 @@ + + * + * @see http://tools.ietf.org/search/rfc6265 + */ +final class Cookie +{ + /** + * @var string + */ + private $name; + + /** + * @var string|null + */ + private $value; + + /** + * @var int|null + */ + private $maxAge; + + /** + * @var string|null + */ + private $domain; + + /** + * @var string + */ + private $path; + + /** + * @var bool + */ + private $secure; + + /** + * @var bool + */ + private $httpOnly; + + /** + * Expires attribute is HTTP 1.0 only and should be avoided. + * + * @var \DateTime|null + */ + private $expires; + + /** + * @param string $name + * @param string|null $value + * @param int $maxAge + * @param string|null $domain + * @param string|null $path + * @param bool $secure + * @param bool $httpOnly + * @param \DateTime|null $expires Expires attribute is HTTP 1.0 only and should be avoided. + * + * @throws \InvalidArgumentException If name, value or max age is not valid. + */ + public function __construct( + $name, + $value = null, + $maxAge = null, + $domain = null, + $path = null, + $secure = false, + $httpOnly = false, + \DateTime $expires = null + ) { + $this->validateName($name); + $this->validateValue($value); + $this->validateMaxAge($maxAge); + + $this->name = $name; + $this->value = $value; + $this->maxAge = $maxAge; + $this->expires = $expires; + $this->domain = $this->normalizeDomain($domain); + $this->path = $this->normalizePath($path); + $this->secure = (bool) $secure; + $this->httpOnly = (bool) $httpOnly; + } + + /** + * Creates a new cookie without any attribute validation. + * + * @param string $name + * @param string|null $value + * @param int $maxAge + * @param string|null $domain + * @param string|null $path + * @param bool $secure + * @param bool $httpOnly + * @param \DateTime|null $expires Expires attribute is HTTP 1.0 only and should be avoided. + */ + public static function createWithoutValidation( + $name, + $value = null, + $maxAge = null, + $domain = null, + $path = null, + $secure = false, + $httpOnly = false, + \DateTime $expires = null + ) { + $cookie = new self('name', null, null, $domain, $path, $secure, $httpOnly, $expires); + $cookie->name = $name; + $cookie->value = $value; + $cookie->maxAge = $maxAge; + + return $cookie; + } + + /** + * Returns the name. + * + * @return string + */ + public function getName() + { + return $this->name; + } + + /** + * Returns the value. + * + * @return string|null + */ + public function getValue() + { + return $this->value; + } + + /** + * Checks if there is a value. + * + * @return bool + */ + public function hasValue() + { + return isset($this->value); + } + + /** + * Sets the value. + * + * @param string|null $value + * + * @return Cookie + */ + public function withValue($value) + { + $this->validateValue($value); + + $new = clone $this; + $new->value = $value; + + return $new; + } + + /** + * Returns the max age. + * + * @return int|null + */ + public function getMaxAge() + { + return $this->maxAge; + } + + /** + * Checks if there is a max age. + * + * @return bool + */ + public function hasMaxAge() + { + return isset($this->maxAge); + } + + /** + * Sets the max age. + * + * @param int|null $maxAge + * + * @return Cookie + */ + public function withMaxAge($maxAge) + { + $this->validateMaxAge($maxAge); + + $new = clone $this; + $new->maxAge = $maxAge; + + return $new; + } + + /** + * Returns the expiration time. + * + * @return \DateTime|null + */ + public function getExpires() + { + return $this->expires; + } + + /** + * Checks if there is an expiration time. + * + * @return bool + */ + public function hasExpires() + { + return isset($this->expires); + } + + /** + * Sets the expires. + * + * @param \DateTime|null $expires + * + * @return Cookie + */ + public function withExpires(\DateTime $expires = null) + { + $new = clone $this; + $new->expires = $expires; + + return $new; + } + + /** + * Checks if the cookie is expired. + * + * @return bool + */ + public function isExpired() + { + return isset($this->expires) and $this->expires < new \DateTime(); + } + + /** + * Returns the domain. + * + * @return string|null + */ + public function getDomain() + { + return $this->domain; + } + + /** + * Checks if there is a domain. + * + * @return bool + */ + public function hasDomain() + { + return isset($this->domain); + } + + /** + * Sets the domain. + * + * @param string|null $domain + * + * @return Cookie + */ + public function withDomain($domain) + { + $new = clone $this; + $new->domain = $this->normalizeDomain($domain); + + return $new; + } + + /** + * Checks whether this cookie is meant for this domain. + * + * @see http://tools.ietf.org/html/rfc6265#section-5.1.3 + * + * @param string $domain + * + * @return bool + */ + public function matchDomain($domain) + { + // Domain is not set or exact match + if (!$this->hasDomain() || strcasecmp($domain, $this->domain) === 0) { + return true; + } + + // Domain is not an IP address + if (filter_var($domain, FILTER_VALIDATE_IP)) { + return false; + } + + return (bool) preg_match(sprintf('/\b%s$/i', preg_quote($this->domain)), $domain); + } + + /** + * Returns the path. + * + * @return string + */ + public function getPath() + { + return $this->path; + } + + /** + * Sets the path. + * + * @param string|null $path + * + * @return Cookie + */ + public function withPath($path) + { + $new = clone $this; + $new->path = $this->normalizePath($path); + + return $new; + } + + /** + * Checks whether this cookie is meant for this path. + * + * @see http://tools.ietf.org/html/rfc6265#section-5.1.4 + * + * @param string $path + * + * @return bool + */ + public function matchPath($path) + { + return $this->path === $path || (strpos($path, rtrim($this->path, '/').'/') === 0); + } + + /** + * Checks whether this cookie may only be sent over HTTPS. + * + * @return bool + */ + public function isSecure() + { + return $this->secure; + } + + /** + * Sets whether this cookie should only be sent over HTTPS. + * + * @param bool $secure + * + * @return Cookie + */ + public function withSecure($secure) + { + $new = clone $this; + $new->secure = (bool) $secure; + + return $new; + } + + /** + * Check whether this cookie may not be accessed through Javascript. + * + * @return bool + */ + public function isHttpOnly() + { + return $this->httpOnly; + } + + /** + * Sets whether this cookie may not be accessed through Javascript. + * + * @param bool $httpOnly + * + * @return Cookie + */ + public function withHttpOnly($httpOnly) + { + $new = clone $this; + $new->httpOnly = (bool) $httpOnly; + + return $new; + } + + /** + * Checks if this cookie represents the same cookie as $cookie. + * + * This does not compare the values, only name, domain and path. + * + * @param Cookie $cookie + * + * @return bool + */ + public function match(Cookie $cookie) + { + return $this->name === $cookie->name && $this->domain === $cookie->domain and $this->path === $cookie->path; + } + + /** + * Validates cookie attributes. + * + * @return bool + */ + public function isValid() + { + try { + $this->validateName($this->name); + $this->validateValue($this->value); + $this->validateMaxAge($this->maxAge); + } catch (\InvalidArgumentException $e) { + return false; + } + + return true; + } + + /** + * Validates the name attribute. + * + * @see http://tools.ietf.org/search/rfc2616#section-2.2 + * + * @param string $name + * + * @throws \InvalidArgumentException If the name is empty or contains invalid characters. + */ + private function validateName($name) + { + if (strlen($name) < 1) { + throw new \InvalidArgumentException('The name cannot be empty'); + } + + // Name attribute is a token as per spec in RFC 2616 + if (preg_match('/[\x00-\x20\x22\x28-\x29\x2C\x2F\x3A-\x40\x5B-\x5D\x7B\x7D\x7F]/', $name)) { + throw new \InvalidArgumentException(sprintf('The cookie name "%s" contains invalid characters.', $name)); + } + } + + /** + * Validates a value. + * + * @see http://tools.ietf.org/html/rfc6265#section-4.1.1 + * + * @param string|null $value + * + * @throws \InvalidArgumentException If the value contains invalid characters. + */ + private function validateValue($value) + { + if (isset($value)) { + if (preg_match('/[^\x21\x23-\x2B\x2D-\x3A\x3C-\x5B\x5D-\x7E]/', $value)) { + throw new \InvalidArgumentException(sprintf('The cookie value "%s" contains invalid characters.', $value)); + } + } + } + + /** + * Validates a Max-Age attribute. + * + * @param int|null $maxAge + * + * @throws \InvalidArgumentException If the Max-Age is not an empty or integer value. + */ + private function validateMaxAge($maxAge) + { + if (isset($maxAge)) { + if (!is_int($maxAge)) { + throw new \InvalidArgumentException('Max-Age must be integer'); + } + } + } + + /** + * Remove the leading '.' and lowercase the domain as per spec in RFC 6265. + * + * @see http://tools.ietf.org/html/rfc6265#section-4.1.2.3 + * @see http://tools.ietf.org/html/rfc6265#section-5.1.3 + * @see http://tools.ietf.org/html/rfc6265#section-5.2.3 + * + * @param string|null $domain + * + * @return string + */ + private function normalizeDomain($domain) + { + if (isset($domain)) { + $domain = ltrim(strtolower($domain), '.'); + } + + return $domain; + } + + /** + * Processes path as per spec in RFC 6265. + * + * @see http://tools.ietf.org/html/rfc6265#section-5.1.4 + * @see http://tools.ietf.org/html/rfc6265#section-5.2.4 + * + * @param string|null $path + * + * @return string + */ + private function normalizePath($path) + { + $path = rtrim($path, '/'); + + if (empty($path) or substr($path, 0, 1) !== '/') { + $path = '/'; + } + + return $path; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/CookieJar.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/CookieJar.php new file mode 100644 index 0000000..ab267d3 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/CookieJar.php @@ -0,0 +1,220 @@ + + */ +final class CookieJar implements \Countable, \IteratorAggregate +{ + /** + * @var \SplObjectStorage + */ + protected $cookies; + + public function __construct() + { + $this->cookies = new \SplObjectStorage(); + } + + /** + * Checks if there is a cookie. + * + * @param Cookie $cookie + * + * @return bool + */ + public function hasCookie(Cookie $cookie) + { + return $this->cookies->contains($cookie); + } + + /** + * Adds a cookie. + * + * @param Cookie $cookie + */ + public function addCookie(Cookie $cookie) + { + if (!$this->hasCookie($cookie)) { + $cookies = $this->getMatchingCookies($cookie); + + foreach ($cookies as $matchingCookie) { + if ($cookie->getValue() !== $matchingCookie->getValue() || $cookie->getMaxAge() > $matchingCookie->getMaxAge()) { + $this->removeCookie($matchingCookie); + + continue; + } + } + + if ($cookie->hasValue()) { + $this->cookies->attach($cookie); + } + } + } + + /** + * Removes a cookie. + * + * @param Cookie $cookie + */ + public function removeCookie(Cookie $cookie) + { + $this->cookies->detach($cookie); + } + + /** + * Returns the cookies. + * + * @return Cookie[] + */ + public function getCookies() + { + $match = function ($matchCookie) { + return true; + }; + + return $this->findMatchingCookies($match); + } + + /** + * Returns all matching cookies. + * + * @param Cookie $cookie + * + * @return Cookie[] + */ + public function getMatchingCookies(Cookie $cookie) + { + $match = function ($matchCookie) use ($cookie) { + return $matchCookie->match($cookie); + }; + + return $this->findMatchingCookies($match); + } + + /** + * Finds matching cookies based on a callable. + * + * @param callable $match + * + * @return Cookie[] + */ + protected function findMatchingCookies(callable $match) + { + $cookies = []; + + foreach ($this->cookies as $cookie) { + if ($match($cookie)) { + $cookies[] = $cookie; + } + } + + return $cookies; + } + + /** + * Checks if there are cookies. + * + * @return bool + */ + public function hasCookies() + { + return $this->cookies->count() > 0; + } + + /** + * Sets the cookies and removes any previous one. + * + * @param Cookie[] $cookies + */ + public function setCookies(array $cookies) + { + $this->clear(); + $this->addCookies($cookies); + } + + /** + * Adds some cookies. + * + * @param Cookie[] $cookies + */ + public function addCookies(array $cookies) + { + foreach ($cookies as $cookie) { + $this->addCookie($cookie); + } + } + + /** + * Removes some cookies. + * + * @param Cookie[] $cookies + */ + public function removeCookies(array $cookies) + { + foreach ($cookies as $cookie) { + $this->removeCookie($cookie); + } + } + + /** + * Removes cookies which match the given parameters. + * + * Null means that parameter should not be matched + * + * @param string|null $name + * @param string|null $domain + * @param string|null $path + */ + public function removeMatchingCookies($name = null, $domain = null, $path = null) + { + $match = function ($cookie) use ($name, $domain, $path) { + $match = true; + + if (isset($name)) { + $match = $match && ($cookie->getName() === $name); + } + + if (isset($domain)) { + $match = $match && $cookie->matchDomain($domain); + } + + if (isset($path)) { + $match = $match && $cookie->matchPath($path); + } + + return $match; + }; + + $cookies = $this->findMatchingCookies($match); + + $this->removeCookies($cookies); + } + + /** + * Removes all cookies. + */ + public function clear() + { + $this->cookies = new \SplObjectStorage(); + } + + /** + * {@inheritdoc} + */ + public function count() + { + return $this->cookies->count(); + } + + /** + * {@inheritdoc} + */ + public function getIterator() + { + return clone $this->cookies; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/CookieUtil.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/CookieUtil.php new file mode 100644 index 0000000..5c670d4 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/CookieUtil.php @@ -0,0 +1,53 @@ + + */ +trait MessageDecorator +{ + /** + * @var MessageInterface + */ + private $message; + + /** + * Returns the decorated message. + * + * Since the underlying Message is immutable as well + * exposing it is not an issue, because it's state cannot be altered + * + * @return MessageInterface + */ + public function getMessage() + { + return $this->message; + } + + /** + * {@inheritdoc} + */ + public function getProtocolVersion() + { + return $this->message->getProtocolVersion(); + } + + /** + * {@inheritdoc} + */ + public function withProtocolVersion($version) + { + $new = clone $this; + $new->message = $this->message->withProtocolVersion($version); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getHeaders() + { + return $this->message->getHeaders(); + } + + /** + * {@inheritdoc} + */ + public function hasHeader($header) + { + return $this->message->hasHeader($header); + } + + /** + * {@inheritdoc} + */ + public function getHeader($header) + { + return $this->message->getHeader($header); + } + + /** + * {@inheritdoc} + */ + public function getHeaderLine($header) + { + return $this->message->getHeaderLine($header); + } + + /** + * {@inheritdoc} + */ + public function withHeader($header, $value) + { + $new = clone $this; + $new->message = $this->message->withHeader($header, $value); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function withAddedHeader($header, $value) + { + $new = clone $this; + $new->message = $this->message->withAddedHeader($header, $value); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function withoutHeader($header) + { + $new = clone $this; + $new->message = $this->message->withoutHeader($header); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getBody() + { + return $this->message->getBody(); + } + + /** + * {@inheritdoc} + */ + public function withBody(StreamInterface $body) + { + $new = clone $this; + $new->message = $this->message->withBody($body); + + return $new; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/RequestDecorator.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/RequestDecorator.php new file mode 100644 index 0000000..7c50e58 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/RequestDecorator.php @@ -0,0 +1,88 @@ + + */ +trait RequestDecorator +{ + use MessageDecorator { + getMessage as getRequest; + } + + /** + * Exchanges the underlying request with another. + * + * @param RequestInterface $request + * + * @return self + */ + public function withRequest(RequestInterface $request) + { + $new = clone $this; + $new->message = $request; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getRequestTarget() + { + return $this->message->getRequestTarget(); + } + + /** + * {@inheritdoc} + */ + public function withRequestTarget($requestTarget) + { + $new = clone $this; + $new->message = $this->message->withRequestTarget($requestTarget); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getMethod() + { + return $this->message->getMethod(); + } + + /** + * {@inheritdoc} + */ + public function withMethod($method) + { + $new = clone $this; + $new->message = $this->message->withMethod($method); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getUri() + { + return $this->message->getUri(); + } + + /** + * {@inheritdoc} + */ + public function withUri(UriInterface $uri, $preserveHost = false) + { + $new = clone $this; + $new->message = $this->message->withUri($uri, $preserveHost); + + return $new; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/ResponseDecorator.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/ResponseDecorator.php new file mode 100644 index 0000000..82d9ae0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/ResponseDecorator.php @@ -0,0 +1,57 @@ + + */ +trait ResponseDecorator +{ + use MessageDecorator { + getMessage as getResponse; + } + + /** + * Exchanges the underlying response with another. + * + * @param ResponseInterface $response + * + * @return self + */ + public function withResponse(ResponseInterface $response) + { + $new = clone $this; + $new->message = $response; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getStatusCode() + { + return $this->message->getStatusCode(); + } + + /** + * {@inheritdoc} + */ + public function withStatus($code, $reasonPhrase = '') + { + $new = clone $this; + $new->message = $this->message->withStatus($code, $reasonPhrase); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getReasonPhrase() + { + return $this->message->getReasonPhrase(); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/StreamDecorator.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/StreamDecorator.php new file mode 100644 index 0000000..f405c7a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Decorator/StreamDecorator.php @@ -0,0 +1,138 @@ + + */ +trait StreamDecorator +{ + /** + * @var StreamInterface + */ + protected $stream; + + /** + * {@inheritdoc} + */ + public function __toString() + { + return $this->stream->__toString(); + } + + /** + * {@inheritdoc} + */ + public function close() + { + $this->stream->close(); + } + + /** + * {@inheritdoc} + */ + public function detach() + { + return $this->stream->detach(); + } + + /** + * {@inheritdoc} + */ + public function getSize() + { + return $this->stream->getSize(); + } + + /** + * {@inheritdoc} + */ + public function tell() + { + return $this->stream->tell(); + } + + /** + * {@inheritdoc} + */ + public function eof() + { + return $this->stream->eof(); + } + + /** + * {@inheritdoc} + */ + public function isSeekable() + { + return $this->stream->isSeekable(); + } + + /** + * {@inheritdoc} + */ + public function seek($offset, $whence = SEEK_SET) + { + $this->stream->seek($offset, $whence); + } + + /** + * {@inheritdoc} + */ + public function rewind() + { + $this->stream->rewind(); + } + + /** + * {@inheritdoc} + */ + public function isWritable() + { + return $this->stream->isWritable(); + } + + /** + * {@inheritdoc} + */ + public function write($string) + { + return $this->stream->write($string); + } + + /** + * {@inheritdoc} + */ + public function isReadable() + { + return $this->stream->isReadable(); + } + + /** + * {@inheritdoc} + */ + public function read($length) + { + return $this->stream->read($length); + } + + /** + * {@inheritdoc} + */ + public function getContents() + { + return $this->stream->getContents(); + } + + /** + * {@inheritdoc} + */ + public function getMetadata($key = null) + { + return $this->stream->getMetadata($key); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/ChunkStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/ChunkStream.php new file mode 100644 index 0000000..74c2fbd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/ChunkStream.php @@ -0,0 +1,39 @@ + + */ +class ChunkStream extends FilteredStream +{ + /** + * {@inheritdoc} + */ + protected function readFilter() + { + return 'chunk'; + } + + /** + * {@inheritdoc} + */ + protected function writeFilter() + { + return 'dechunk'; + } + + /** + * {@inheritdoc} + */ + protected function fill() + { + parent::fill(); + + if ($this->stream->eof()) { + $this->buffer .= "0\r\n\r\n"; + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/CompressStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/CompressStream.php new file mode 100644 index 0000000..d1013dc --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/CompressStream.php @@ -0,0 +1,42 @@ + + */ +class CompressStream extends FilteredStream +{ + /** + * @param StreamInterface $stream + * @param int $level + */ + public function __construct(StreamInterface $stream, $level = -1) + { + if (!extension_loaded('zlib')) { + throw new \RuntimeException('The zlib extension must be enabled to use this stream'); + } + + parent::__construct($stream, ['window' => 15, 'level' => $level], ['window' => 15]); + } + + /** + * {@inheritdoc} + */ + protected function readFilter() + { + return 'zlib.deflate'; + } + + /** + * {@inheritdoc} + */ + protected function writeFilter() + { + return 'zlib.inflate'; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DechunkStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DechunkStream.php new file mode 100644 index 0000000..4cade83 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DechunkStream.php @@ -0,0 +1,29 @@ + + */ +class DechunkStream extends FilteredStream +{ + /** + * {@inheritdoc} + */ + protected function readFilter() + { + return 'dechunk'; + } + + /** + * {@inheritdoc} + */ + protected function writeFilter() + { + return 'chunk'; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DecompressStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DecompressStream.php new file mode 100644 index 0000000..4e3a723 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DecompressStream.php @@ -0,0 +1,42 @@ + + */ +class DecompressStream extends FilteredStream +{ + /** + * @param StreamInterface $stream + * @param int $level + */ + public function __construct(StreamInterface $stream, $level = -1) + { + if (!extension_loaded('zlib')) { + throw new \RuntimeException('The zlib extension must be enabled to use this stream'); + } + + parent::__construct($stream, ['window' => 15], ['window' => 15, 'level' => $level]); + } + + /** + * {@inheritdoc} + */ + protected function readFilter() + { + return 'zlib.inflate'; + } + + /** + * {@inheritdoc} + */ + protected function writeFilter() + { + return 'zlib.deflate'; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DeflateStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DeflateStream.php new file mode 100644 index 0000000..1d7344b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/DeflateStream.php @@ -0,0 +1,38 @@ + + */ +class DeflateStream extends FilteredStream +{ + /** + * @param StreamInterface $stream + * @param int $level + */ + public function __construct(StreamInterface $stream, $level = -1) + { + parent::__construct($stream, ['window' => -15, 'level' => $level], ['window' => -15]); + } + + /** + * {@inheritdoc} + */ + protected function readFilter() + { + return 'zlib.deflate'; + } + + /** + * {@inheritdoc} + */ + protected function writeFilter() + { + return 'zlib.inflate'; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/Filter/Chunk.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/Filter/Chunk.php new file mode 100644 index 0000000..0f8f53b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/Filter/Chunk.php @@ -0,0 +1,30 @@ + + */ +class Chunk extends \php_user_filter +{ + /** + * {@inheritdoc} + */ + public function filter($in, $out, &$consumed, $closing) + { + while ($bucket = stream_bucket_make_writeable($in)) { + $lenbucket = stream_bucket_new($this->stream, dechex($bucket->datalen)."\r\n"); + stream_bucket_append($out, $lenbucket); + + $consumed += $bucket->datalen; + stream_bucket_append($out, $bucket); + + $lenbucket = stream_bucket_new($this->stream, "\r\n"); + stream_bucket_append($out, $lenbucket); + } + + return PSFS_PASS_ON; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/FilteredStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/FilteredStream.php new file mode 100644 index 0000000..a32554b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/FilteredStream.php @@ -0,0 +1,198 @@ + + */ +abstract class FilteredStream implements StreamInterface +{ + const BUFFER_SIZE = 8192; + + use StreamDecorator; + + /** + * @var callable + */ + protected $readFilterCallback; + + /** + * @var resource + * + * @deprecated since version 1.5, will be removed in 2.0 + */ + protected $readFilter; + + /** + * @var callable + * + * @deprecated since version 1.5, will be removed in 2.0 + */ + protected $writeFilterCallback; + + /** + * @var resource + * + * @deprecated since version 1.5, will be removed in 2.0 + */ + protected $writeFilter; + + /** + * Internal buffer. + * + * @var string + */ + protected $buffer = ''; + + /** + * @param StreamInterface $stream + * @param mixed|null $readFilterOptions + * @param mixed|null $writeFilterOptions deprecated since 1.5, will be removed in 2.0 + */ + public function __construct(StreamInterface $stream, $readFilterOptions = null, $writeFilterOptions = null) + { + $this->readFilterCallback = Filter\fun($this->readFilter(), $readFilterOptions); + $this->writeFilterCallback = Filter\fun($this->writeFilter(), $writeFilterOptions); + + if (null !== $writeFilterOptions) { + @trigger_error('The $writeFilterOptions argument is deprecated since version 1.5 and will be removed in 2.0.', E_USER_DEPRECATED); + } + + $this->stream = $stream; + } + + /** + * {@inheritdoc} + */ + public function read($length) + { + if (strlen($this->buffer) >= $length) { + $read = substr($this->buffer, 0, $length); + $this->buffer = substr($this->buffer, $length); + + return $read; + } + + if ($this->stream->eof()) { + $buffer = $this->buffer; + $this->buffer = ''; + + return $buffer; + } + + $read = $this->buffer; + $this->buffer = ''; + $this->fill(); + + return $read.$this->read($length - strlen($read)); + } + + /** + * {@inheritdoc} + */ + public function eof() + { + return $this->stream->eof() && $this->buffer === ''; + } + + /** + * Buffer is filled by reading underlying stream. + * + * Callback is reading once more even if the stream is ended. + * This allow to get last data in the PHP buffer otherwise this + * bug is present : https://bugs.php.net/bug.php?id=48725 + */ + protected function fill() + { + $readFilterCallback = $this->readFilterCallback; + $this->buffer .= $readFilterCallback($this->stream->read(self::BUFFER_SIZE)); + + if ($this->stream->eof()) { + $this->buffer .= $readFilterCallback(); + } + } + + /** + * {@inheritdoc} + */ + public function getContents() + { + $buffer = ''; + + while (!$this->eof()) { + $buf = $this->read(self::BUFFER_SIZE); + // Using a loose equality here to match on '' and false. + if ($buf == null) { + break; + } + + $buffer .= $buf; + } + + return $buffer; + } + + /** + * {@inheritdoc} + */ + public function getSize() + { + return; + } + + /** + * {@inheritdoc} + */ + public function __toString() + { + return $this->getContents(); + } + + /** + * Returns the read filter name. + * + * @return string + * + * @deprecated since version 1.5, will be removed in 2.0 + */ + public function getReadFilter() + { + @trigger_error('The '.__CLASS__.'::'.__METHOD__.' method is deprecated since version 1.5 and will be removed in 2.0.', E_USER_DEPRECATED); + + return $this->readFilter(); + } + + /** + * Returns the write filter name. + * + * @return string + */ + abstract protected function readFilter(); + + /** + * Returns the write filter name. + * + * @return string + * + * @deprecated since version 1.5, will be removed in 2.0 + */ + public function getWriteFilter() + { + @trigger_error('The '.__CLASS__.'::'.__METHOD__.' method is deprecated since version 1.5 and will be removed in 2.0.', E_USER_DEPRECATED); + + return $this->writeFilter(); + } + + /** + * Returns the write filter name. + * + * @return string + */ + abstract protected function writeFilter(); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/GzipDecodeStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/GzipDecodeStream.php new file mode 100644 index 0000000..4f958ed --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/GzipDecodeStream.php @@ -0,0 +1,42 @@ + + */ +class GzipDecodeStream extends FilteredStream +{ + /** + * @param StreamInterface $stream + * @param int $level + */ + public function __construct(StreamInterface $stream, $level = -1) + { + if (!extension_loaded('zlib')) { + throw new \RuntimeException('The zlib extension must be enabled to use this stream'); + } + + parent::__construct($stream, ['window' => 31], ['window' => 31, 'level' => $level]); + } + + /** + * {@inheritdoc} + */ + protected function readFilter() + { + return 'zlib.inflate'; + } + + /** + * {@inheritdoc} + */ + protected function writeFilter() + { + return 'zlib.deflate'; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/GzipEncodeStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/GzipEncodeStream.php new file mode 100644 index 0000000..1066eec --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/GzipEncodeStream.php @@ -0,0 +1,42 @@ + + */ +class GzipEncodeStream extends FilteredStream +{ + /** + * @param StreamInterface $stream + * @param int $level + */ + public function __construct(StreamInterface $stream, $level = -1) + { + if (!extension_loaded('zlib')) { + throw new \RuntimeException('The zlib extension must be enabled to use this stream'); + } + + parent::__construct($stream, ['window' => 31, 'level' => $level], ['window' => 31]); + } + + /** + * {@inheritdoc} + */ + protected function readFilter() + { + return 'zlib.deflate'; + } + + /** + * {@inheritdoc} + */ + protected function writeFilter() + { + return 'zlib.inflate'; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/InflateStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/InflateStream.php new file mode 100644 index 0000000..7070230 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Encoding/InflateStream.php @@ -0,0 +1,42 @@ + + */ +class InflateStream extends FilteredStream +{ + /** + * @param StreamInterface $stream + * @param int $level + */ + public function __construct(StreamInterface $stream, $level = -1) + { + if (!extension_loaded('zlib')) { + throw new \RuntimeException('The zlib extension must be enabled to use this stream'); + } + + parent::__construct($stream, ['window' => -15], ['window' => -15, 'level' => $level]); + } + + /** + * {@inheritdoc} + */ + protected function readFilter() + { + return 'zlib.inflate'; + } + + /** + * {@inheritdoc} + */ + protected function writeFilter() + { + return 'zlib.deflate'; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Exception.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Exception.php new file mode 100644 index 0000000..80d4cd9 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Exception.php @@ -0,0 +1,10 @@ + + */ +interface Formatter +{ + /** + * Formats a request. + * + * @param RequestInterface $request + * + * @return string + */ + public function formatRequest(RequestInterface $request); + + /** + * Formats a response. + * + * @param ResponseInterface $response + * + * @return string + */ + public function formatResponse(ResponseInterface $response); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/CurlCommandFormatter.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/CurlCommandFormatter.php new file mode 100644 index 0000000..a0fe7e5 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/CurlCommandFormatter.php @@ -0,0 +1,80 @@ + + */ +class CurlCommandFormatter implements Formatter +{ + /** + * {@inheritdoc} + */ + public function formatRequest(RequestInterface $request) + { + $command = sprintf('curl %s', escapeshellarg((string) $request->getUri()->withFragment(''))); + if ($request->getProtocolVersion() === '1.0') { + $command .= ' --http1.0'; + } elseif ($request->getProtocolVersion() === '2.0') { + $command .= ' --http2'; + } + + $method = strtoupper($request->getMethod()); + if ('HEAD' === $method) { + $command .= ' --head'; + } elseif ('GET' !== $method) { + $command .= ' --request '.$method; + } + + $command .= $this->getHeadersAsCommandOptions($request); + + $body = $request->getBody(); + if ($body->getSize() > 0) { + if (!$body->isSeekable()) { + return 'Cant format Request as cUrl command if body stream is not seekable.'; + } + $command .= sprintf(' --data %s', escapeshellarg($body->__toString())); + $body->rewind(); + } + + return $command; + } + + /** + * {@inheritdoc} + */ + public function formatResponse(ResponseInterface $response) + { + return ''; + } + + /** + * @param RequestInterface $request + * + * @return string + */ + private function getHeadersAsCommandOptions(RequestInterface $request) + { + $command = ''; + foreach ($request->getHeaders() as $name => $values) { + if ('host' === strtolower($name) && $values[0] === $request->getUri()->getHost()) { + continue; + } + + if ('user-agent' === strtolower($name)) { + $command .= sprintf(' -A %s', escapeshellarg($values[0])); + continue; + } + + $command .= sprintf(' -H %s', escapeshellarg($name.': '.$request->getHeaderLine($name))); + } + + return $command; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/FullHttpMessageFormatter.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/FullHttpMessageFormatter.php new file mode 100644 index 0000000..3fa1029 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/FullHttpMessageFormatter.php @@ -0,0 +1,91 @@ + + */ +class FullHttpMessageFormatter implements Formatter +{ + /** + * The maximum length of the body. + * + * @var int + */ + private $maxBodyLength; + + /** + * @param int $maxBodyLength + */ + public function __construct($maxBodyLength = 1000) + { + $this->maxBodyLength = $maxBodyLength; + } + + /** + * {@inheritdoc} + */ + public function formatRequest(RequestInterface $request) + { + $message = sprintf( + "%s %s HTTP/%s\n", + $request->getMethod(), + $request->getRequestTarget(), + $request->getProtocolVersion() + ); + + foreach ($request->getHeaders() as $name => $values) { + $message .= $name.': '.implode(', ', $values)."\n"; + } + + return $this->addBody($request, $message); + } + + /** + * {@inheritdoc} + */ + public function formatResponse(ResponseInterface $response) + { + $message = sprintf( + "HTTP/%s %s %s\n", + $response->getProtocolVersion(), + $response->getStatusCode(), + $response->getReasonPhrase() + ); + + foreach ($response->getHeaders() as $name => $values) { + $message .= $name.': '.implode(', ', $values)."\n"; + } + + return $this->addBody($response, $message); + } + + /** + * Add the message body if the stream is seekable. + * + * @param MessageInterface $request + * @param string $message + * + * @return string + */ + private function addBody(MessageInterface $request, $message) + { + $stream = $request->getBody(); + if (!$stream->isSeekable() || $this->maxBodyLength === 0) { + // Do not read the stream + $message .= "\n"; + } else { + $message .= "\n".mb_substr($stream->__toString(), 0, $this->maxBodyLength); + $stream->rewind(); + } + + return $message; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/SimpleFormatter.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/SimpleFormatter.php new file mode 100644 index 0000000..b1fcabd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Formatter/SimpleFormatter.php @@ -0,0 +1,42 @@ + + * @author Márk Sági-Kazár + */ +class SimpleFormatter implements Formatter +{ + /** + * {@inheritdoc} + */ + public function formatRequest(RequestInterface $request) + { + return sprintf( + '%s %s %s', + $request->getMethod(), + $request->getUri()->__toString(), + $request->getProtocolVersion() + ); + } + + /** + * {@inheritdoc} + */ + public function formatResponse(ResponseInterface $response) + { + return sprintf( + '%s %s %s', + $response->getStatusCode(), + $response->getReasonPhrase(), + $response->getProtocolVersion() + ); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/DiactorosMessageFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/DiactorosMessageFactory.php new file mode 100644 index 0000000..53f08ae --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/DiactorosMessageFactory.php @@ -0,0 +1,61 @@ + + */ +final class DiactorosMessageFactory implements MessageFactory +{ + /** + * @var DiactorosStreamFactory + */ + private $streamFactory; + + public function __construct() + { + $this->streamFactory = new DiactorosStreamFactory(); + } + + /** + * {@inheritdoc} + */ + public function createRequest( + $method, + $uri, + array $headers = [], + $body = null, + $protocolVersion = '1.1' + ) { + return (new Request( + $uri, + $method, + $this->streamFactory->createStream($body), + $headers + ))->withProtocolVersion($protocolVersion); + } + + /** + * {@inheritdoc} + */ + public function createResponse( + $statusCode = 200, + $reasonPhrase = null, + array $headers = [], + $body = null, + $protocolVersion = '1.1' + ) { + return (new Response( + $this->streamFactory->createStream($body), + $statusCode, + $headers + ))->withProtocolVersion($protocolVersion); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/GuzzleMessageFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/GuzzleMessageFactory.php new file mode 100644 index 0000000..59eb655 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/GuzzleMessageFactory.php @@ -0,0 +1,53 @@ + + */ +final class GuzzleMessageFactory implements MessageFactory +{ + /** + * {@inheritdoc} + */ + public function createRequest( + $method, + $uri, + array $headers = [], + $body = null, + $protocolVersion = '1.1' + ) { + return new Request( + $method, + $uri, + $headers, + $body, + $protocolVersion + ); + } + + /** + * {@inheritdoc} + */ + public function createResponse( + $statusCode = 200, + $reasonPhrase = null, + array $headers = [], + $body = null, + $protocolVersion = '1.1' + ) { + return new Response( + $statusCode, + $headers, + $body, + $protocolVersion, + $reasonPhrase + ); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/SlimMessageFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/SlimMessageFactory.php new file mode 100644 index 0000000..cdad2ec --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/MessageFactory/SlimMessageFactory.php @@ -0,0 +1,72 @@ + + */ +final class SlimMessageFactory implements MessageFactory +{ + /** + * @var SlimStreamFactory + */ + private $streamFactory; + + /** + * @var SlimUriFactory + */ + private $uriFactory; + + public function __construct() + { + $this->streamFactory = new SlimStreamFactory(); + $this->uriFactory = new SlimUriFactory(); + } + + /** + * {@inheritdoc} + */ + public function createRequest( + $method, + $uri, + array $headers = [], + $body = null, + $protocolVersion = '1.1' + ) { + return (new Request( + $method, + $this->uriFactory->createUri($uri), + new Headers($headers), + [], + [], + $this->streamFactory->createStream($body), + [] + ))->withProtocolVersion($protocolVersion); + } + + /** + * {@inheritdoc} + */ + public function createResponse( + $statusCode = 200, + $reasonPhrase = null, + array $headers = [], + $body = null, + $protocolVersion = '1.1' + ) { + return (new Response( + $statusCode, + new Headers($headers), + $this->streamFactory->createStream($body) + ))->withProtocolVersion($protocolVersion); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher.php new file mode 100644 index 0000000..94fe532 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher.php @@ -0,0 +1,26 @@ + + */ +interface RequestMatcher +{ + /** + * Decides whether the rule(s) implemented by the strategy matches the supplied request. + * + * @param RequestInterface $request The PSR7 request to check for a match + * + * @return bool true if the request matches, false otherwise + */ + public function matches(RequestInterface $request); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/CallbackRequestMatcher.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/CallbackRequestMatcher.php new file mode 100644 index 0000000..4d45e32 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/CallbackRequestMatcher.php @@ -0,0 +1,35 @@ + + */ +final class CallbackRequestMatcher implements RequestMatcher +{ + /** + * @var callable + */ + private $callback; + + /** + * @param callable $callback + */ + public function __construct(callable $callback) + { + $this->callback = $callback; + } + + /** + * {@inheritdoc} + */ + public function matches(RequestInterface $request) + { + return (bool) call_user_func($this->callback, $request); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/RegexRequestMatcher.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/RegexRequestMatcher.php new file mode 100644 index 0000000..91f3729 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/RegexRequestMatcher.php @@ -0,0 +1,41 @@ + + * + * @deprecated since version 1.2 and will be removed in 2.0. Use {@link RequestMatcher} instead. + */ +final class RegexRequestMatcher implements RequestMatcher +{ + /** + * Matching regex. + * + * @var string + */ + private $regex; + + /** + * @param string $regex + */ + public function __construct($regex) + { + $this->regex = $regex; + } + + /** + * {@inheritdoc} + */ + public function matches(RequestInterface $request) + { + return (bool) preg_match($this->regex, (string) $request->getUri()); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/RequestMatcher.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/RequestMatcher.php new file mode 100644 index 0000000..e2aa021 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/RequestMatcher/RequestMatcher.php @@ -0,0 +1,78 @@ + + * @author Joel Wurtz + */ +final class RequestMatcher implements RequestMatcherInterface +{ + /** + * @var string + */ + private $path; + + /** + * @var string + */ + private $host; + + /** + * @var array + */ + private $methods = []; + + /** + * @var string[] + */ + private $schemes = []; + + /** + * The regular expressions used for path or host must be specified without delimiter. + * You do not need to escape the forward slash / to match it. + * + * @param string|null $path Regular expression for the path + * @param string|null $host Regular expression for the hostname + * @param string|string[]|null $methods Method or list of methods to match + * @param string|string[]|null $schemes Scheme or list of schemes to match (e.g. http or https) + */ + public function __construct($path = null, $host = null, $methods = [], $schemes = []) + { + $this->path = $path; + $this->host = $host; + $this->methods = array_map('strtoupper', (array) $methods); + $this->schemes = array_map('strtolower', (array) $schemes); + } + + /** + * {@inheritdoc} + * + * @api + */ + public function matches(RequestInterface $request) + { + if ($this->schemes && !in_array($request->getUri()->getScheme(), $this->schemes)) { + return false; + } + + if ($this->methods && !in_array($request->getMethod(), $this->methods)) { + return false; + } + + if (null !== $this->path && !preg_match('{'.$this->path.'}', rawurldecode($request->getUri()->getPath()))) { + return false; + } + + if (null !== $this->host && !preg_match('{'.$this->host.'}i', $request->getUri()->getHost())) { + return false; + } + + return true; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Stream/BufferedStream.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Stream/BufferedStream.php new file mode 100644 index 0000000..1eac974 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/Stream/BufferedStream.php @@ -0,0 +1,270 @@ +stream = $stream; + $this->size = $stream->getSize(); + + if ($useFileBuffer) { + $this->resource = fopen('php://temp/maxmemory:'.$memoryBuffer, 'rw+'); + } else { + $this->resource = fopen('php://memory', 'rw+'); + } + + if (false === $this->resource) { + throw new \RuntimeException('Cannot create a resource over temp or memory implementation'); + } + } + + /** + * {@inheritdoc} + */ + public function __toString() + { + try { + $this->rewind(); + + return $this->getContents(); + } catch (\Throwable $throwable) { + return ''; + } catch (\Exception $exception) { // Layer to be BC with PHP 5, remove this when we only support PHP 7+ + return ''; + } + } + + /** + * {@inheritdoc} + */ + public function close() + { + if (null === $this->resource) { + throw new \RuntimeException('Cannot close on a detached stream'); + } + + $this->stream->close(); + fclose($this->resource); + } + + /** + * {@inheritdoc} + */ + public function detach() + { + if (null === $this->resource) { + return; + } + + // Force reading the remaining data of the stream + $this->getContents(); + + $resource = $this->resource; + $this->stream->close(); + $this->stream = null; + $this->resource = null; + + return $resource; + } + + /** + * {@inheritdoc} + */ + public function getSize() + { + if (null === $this->resource) { + return; + } + + if (null === $this->size && $this->stream->eof()) { + return $this->written; + } + + return $this->size; + } + + /** + * {@inheritdoc} + */ + public function tell() + { + if (null === $this->resource) { + throw new \RuntimeException('Cannot tell on a detached stream'); + } + + return ftell($this->resource); + } + + /** + * {@inheritdoc} + */ + public function eof() + { + if (null === $this->resource) { + throw new \RuntimeException('Cannot call eof on a detached stream'); + } + + // We are at the end only when both our resource and underlying stream are at eof + return $this->stream->eof() && (ftell($this->resource) === $this->written); + } + + /** + * {@inheritdoc} + */ + public function isSeekable() + { + return null !== $this->resource; + } + + /** + * {@inheritdoc} + */ + public function seek($offset, $whence = SEEK_SET) + { + if (null === $this->resource) { + throw new \RuntimeException('Cannot seek on a detached stream'); + } + + fseek($this->resource, $offset, $whence); + } + + /** + * {@inheritdoc} + */ + public function rewind() + { + if (null === $this->resource) { + throw new \RuntimeException('Cannot rewind on a detached stream'); + } + + rewind($this->resource); + } + + /** + * {@inheritdoc} + */ + public function isWritable() + { + return false; + } + + /** + * {@inheritdoc} + */ + public function write($string) + { + throw new \RuntimeException('Cannot write on this stream'); + } + + /** + * {@inheritdoc} + */ + public function isReadable() + { + return null !== $this->resource; + } + + /** + * {@inheritdoc} + */ + public function read($length) + { + if (null === $this->resource) { + throw new \RuntimeException('Cannot read on a detached stream'); + } + + $read = ''; + + // First read from the resource + if (ftell($this->resource) !== $this->written) { + $read = fread($this->resource, $length); + } + + $bytesRead = strlen($read); + + if ($bytesRead < $length) { + $streamRead = $this->stream->read($length - $bytesRead); + + // Write on the underlying stream what we read + $this->written += fwrite($this->resource, $streamRead); + $read .= $streamRead; + } + + return $read; + } + + /** + * {@inheritdoc} + */ + public function getContents() + { + if (null === $this->resource) { + throw new \RuntimeException('Cannot read on a detached stream'); + } + + $read = ''; + + while (!$this->eof()) { + $read .= $this->read(8192); + } + + return $read; + } + + /** + * {@inheritdoc} + */ + public function getMetadata($key = null) + { + if (null === $this->resource) { + if (null === $key) { + return []; + } + + return; + } + + $metadata = stream_get_meta_data($this->resource); + + if (null === $key) { + return $metadata; + } + + if (!array_key_exists($key, $metadata)) { + return; + } + + return $metadata[$key]; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/DiactorosStreamFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/DiactorosStreamFactory.php new file mode 100644 index 0000000..a75ec98 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/DiactorosStreamFactory.php @@ -0,0 +1,36 @@ + + */ +final class DiactorosStreamFactory implements StreamFactory +{ + /** + * {@inheritdoc} + */ + public function createStream($body = null) + { + if ($body instanceof StreamInterface) { + return $body; + } + + if (is_resource($body)) { + return new Stream($body); + } + + $stream = new Stream('php://memory', 'rw'); + if (null !== $body && '' !== $body) { + $stream->write((string) $body); + } + + return $stream; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/GuzzleStreamFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/GuzzleStreamFactory.php new file mode 100644 index 0000000..10f4d3f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/GuzzleStreamFactory.php @@ -0,0 +1,21 @@ + + */ +final class GuzzleStreamFactory implements StreamFactory +{ + /** + * {@inheritdoc} + */ + public function createStream($body = null) + { + return \GuzzleHttp\Psr7\stream_for($body); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/SlimStreamFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/SlimStreamFactory.php new file mode 100644 index 0000000..efcadc4 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/StreamFactory/SlimStreamFactory.php @@ -0,0 +1,37 @@ + + */ +final class SlimStreamFactory implements StreamFactory +{ + /** + * {@inheritdoc} + */ + public function createStream($body = null) + { + if ($body instanceof StreamInterface) { + return $body; + } + + if (is_resource($body)) { + return new Stream($body); + } + + $resource = fopen('php://memory', 'r+'); + $stream = new Stream($resource); + if (null !== $body && '' !== $body) { + $stream->write((string) $body); + } + + return $stream; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/DiactorosUriFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/DiactorosUriFactory.php new file mode 100644 index 0000000..268c361 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/DiactorosUriFactory.php @@ -0,0 +1,29 @@ + + */ +final class DiactorosUriFactory implements UriFactory +{ + /** + * {@inheritdoc} + */ + public function createUri($uri) + { + if ($uri instanceof UriInterface) { + return $uri; + } elseif (is_string($uri)) { + return new Uri($uri); + } + + throw new \InvalidArgumentException('URI must be a string or UriInterface'); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/GuzzleUriFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/GuzzleUriFactory.php new file mode 100644 index 0000000..4c1c286 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/GuzzleUriFactory.php @@ -0,0 +1,22 @@ + + */ +final class GuzzleUriFactory implements UriFactory +{ + /** + * {@inheritdoc} + */ + public function createUri($uri) + { + return Psr7\uri_for($uri); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/SlimUriFactory.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/SlimUriFactory.php new file mode 100644 index 0000000..c013d54 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/UriFactory/SlimUriFactory.php @@ -0,0 +1,31 @@ + + */ +final class SlimUriFactory implements UriFactory +{ + /** + * {@inheritdoc} + */ + public function createUri($uri) + { + if ($uri instanceof UriInterface) { + return $uri; + } + + if (is_string($uri)) { + return Uri::createFromString($uri); + } + + throw new \InvalidArgumentException('URI must be a string or UriInterface'); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/filters.php b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/filters.php new file mode 100644 index 0000000..15ed73d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/message/src/filters.php @@ -0,0 +1,6 @@ + + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/README.md b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/README.md new file mode 100644 index 0000000..10ad058 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/README.md @@ -0,0 +1,37 @@ +# PSR-7 Multipart Stream Builder + +[![Latest Version](https://img.shields.io/github/release/php-http/multipart-stream-builder.svg?style=flat-square)](https://github.com/php-http/multipart-stream-builder/releases) +[![Build Status](https://img.shields.io/travis/php-http/multipart-stream-builder.svg?style=flat-square)](https://travis-ci.org/php-http/multipart-stream-builder) +[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-http/multipart-stream-builder.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/multipart-stream-builder) +[![Quality Score](https://img.shields.io/scrutinizer/g/php-http/multipart-stream-builder.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/multipart-stream-builder) +[![Total Downloads](https://img.shields.io/packagist/dt/php-http/multipart-stream-builder.svg?style=flat-square)](https://packagist.org/packages/php-http/multipart-stream-builder) + +**A builder for Multipart PSR-7 Streams. The builder create streams independenly form any PSR-7 implementation.** + + +## Install + +Via Composer + +``` bash +$ composer require php-http/multipart-stream-builder +``` + +## Documentation + +Please see the [official documentation](http://php-http.readthedocs.org/en/latest/components/multipart-stream-builder.html). + + +## Contributing + +Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details. + + +## Security + +If you discover any security related issues, please contact us at [security@php-http.org](mailto:security@php-http.org). + + +## License + +The MIT License (MIT). Please see [License File](LICENSE) for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/composer.json b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/composer.json new file mode 100644 index 0000000..1ada360 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/composer.json @@ -0,0 +1,43 @@ +{ + "name": "php-http/multipart-stream-builder", + "description": "A builder class that help you create a multipart stream", + "license": "MIT", + "keywords": ["http", "factory", "message", "stream", "multipart stream"], + "homepage": "http://php-http.org", + "authors": [ + { + "name": "Tobias Nyholm", + "email": "tobias.nyholm@gmail.com" + } + ], + "require": { + "php": "^5.5 || ^7.0", + "psr/http-message": "^1.0", + "php-http/message-factory": "^1.0.2", + "php-http/discovery": "^1.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.8 || ^5.4", + "php-http/message": "^1.5", + "zendframework/zend-diactoros": "^1.3.5" + }, + "autoload": { + "psr-4": { + "Http\\Message\\MultipartStream\\": "src/" + } + }, + "autoload-dev": { + "psr-4": { + "tests\\Http\\Message\\MultipartStream\\": "tests/" + } + }, + "scripts": { + "test": "vendor/bin/phpunit", + "test-ci": "vendor/bin/phpunit --coverage-text --coverage-clover=build/coverage.xml" + }, + "extra": { + "branch-alias": { + "dev-master": "0.3-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/ApacheMimetypeHelper.php b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/ApacheMimetypeHelper.php new file mode 100644 index 0000000..6e4ca66 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/ApacheMimetypeHelper.php @@ -0,0 +1,142 @@ + + */ +class ApacheMimetypeHelper implements MimetypeHelper +{ + /** + * {@inheritdoc} + * + * @see http://svn.apache.org/repos/asf/httpd/httpd/branches/1.3.x/conf/mime.types + */ + public function getMimetypeFromFilename($filename) + { + return $this->getMimetypeFromExtension(pathinfo($filename, PATHINFO_EXTENSION)); + } + + /** + * {@inheritdoc} + * + * @see http://svn.apache.org/repos/asf/httpd/httpd/branches/1.3.x/conf/mime.types + */ + public function getMimetypeFromExtension($extension) + { + static $mimetypes = [ + '7z' => 'application/x-7z-compressed', + 'aac' => 'audio/x-aac', + 'ai' => 'application/postscript', + 'aif' => 'audio/x-aiff', + 'asc' => 'text/plain', + 'asf' => 'video/x-ms-asf', + 'atom' => 'application/atom+xml', + 'avi' => 'video/x-msvideo', + 'bmp' => 'image/bmp', + 'bz2' => 'application/x-bzip2', + 'cer' => 'application/pkix-cert', + 'crl' => 'application/pkix-crl', + 'crt' => 'application/x-x509-ca-cert', + 'css' => 'text/css', + 'csv' => 'text/csv', + 'cu' => 'application/cu-seeme', + 'deb' => 'application/x-debian-package', + 'doc' => 'application/msword', + 'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', + 'dvi' => 'application/x-dvi', + 'eot' => 'application/vnd.ms-fontobject', + 'eps' => 'application/postscript', + 'epub' => 'application/epub+zip', + 'etx' => 'text/x-setext', + 'flac' => 'audio/flac', + 'flv' => 'video/x-flv', + 'gif' => 'image/gif', + 'gz' => 'application/gzip', + 'htm' => 'text/html', + 'html' => 'text/html', + 'ico' => 'image/x-icon', + 'ics' => 'text/calendar', + 'ini' => 'text/plain', + 'iso' => 'application/x-iso9660-image', + 'jar' => 'application/java-archive', + 'jpe' => 'image/jpeg', + 'jpeg' => 'image/jpeg', + 'jpg' => 'image/jpeg', + 'js' => 'text/javascript', + 'json' => 'application/json', + 'latex' => 'application/x-latex', + 'log' => 'text/plain', + 'm4a' => 'audio/mp4', + 'm4v' => 'video/mp4', + 'mid' => 'audio/midi', + 'midi' => 'audio/midi', + 'mov' => 'video/quicktime', + 'mp3' => 'audio/mpeg', + 'mp4' => 'video/mp4', + 'mp4a' => 'audio/mp4', + 'mp4v' => 'video/mp4', + 'mpe' => 'video/mpeg', + 'mpeg' => 'video/mpeg', + 'mpg' => 'video/mpeg', + 'mpg4' => 'video/mp4', + 'oga' => 'audio/ogg', + 'ogg' => 'audio/ogg', + 'ogv' => 'video/ogg', + 'ogx' => 'application/ogg', + 'pbm' => 'image/x-portable-bitmap', + 'pdf' => 'application/pdf', + 'pgm' => 'image/x-portable-graymap', + 'png' => 'image/png', + 'pnm' => 'image/x-portable-anymap', + 'ppm' => 'image/x-portable-pixmap', + 'ppt' => 'application/vnd.ms-powerpoint', + 'pptx' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation', + 'ps' => 'application/postscript', + 'qt' => 'video/quicktime', + 'rar' => 'application/x-rar-compressed', + 'ras' => 'image/x-cmu-raster', + 'rss' => 'application/rss+xml', + 'rtf' => 'application/rtf', + 'sgm' => 'text/sgml', + 'sgml' => 'text/sgml', + 'svg' => 'image/svg+xml', + 'swf' => 'application/x-shockwave-flash', + 'tar' => 'application/x-tar', + 'tif' => 'image/tiff', + 'tiff' => 'image/tiff', + 'torrent' => 'application/x-bittorrent', + 'ttf' => 'application/x-font-ttf', + 'txt' => 'text/plain', + 'wav' => 'audio/x-wav', + 'webm' => 'video/webm', + 'wma' => 'audio/x-ms-wma', + 'wmv' => 'video/x-ms-wmv', + 'woff' => 'application/x-font-woff', + 'wsdl' => 'application/wsdl+xml', + 'xbm' => 'image/x-xbitmap', + 'xls' => 'application/vnd.ms-excel', + 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', + 'xml' => 'application/xml', + 'xpm' => 'image/x-xpixmap', + 'xwd' => 'image/x-xwindowdump', + 'yaml' => 'text/yaml', + 'yml' => 'text/yaml', + 'zip' => 'application/zip', + + // Non-Apache standard + 'pkpass' => 'application/vnd.apple.pkpass', + 'msg' => 'application/vnd.ms-outlook', + ]; + + $extension = strtolower($extension); + + return isset($mimetypes[$extension]) + ? $mimetypes[$extension] + : null; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/CustomMimetypeHelper.php b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/CustomMimetypeHelper.php new file mode 100644 index 0000000..9f3f0d9 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/CustomMimetypeHelper.php @@ -0,0 +1,51 @@ + + */ +class CustomMimetypeHelper extends ApacheMimetypeHelper +{ + /** + * @var array + */ + private $mimetypes = []; + + /** + * @param array $mimetypes should be of type extension => mimetype + */ + public function __construct(array $mimetypes = []) + { + $this->mimetypes = $mimetypes; + } + + /** + * @param string $extension + * @param string $mimetype + * + * @return $this + */ + public function addMimetype($extension, $mimetype) + { + $this->mimetypes[$extension] = $mimetype; + + return $this; + } + + /** + * {@inheritdoc} + * + * Check if we have any defined mimetypes and of not fallback to ApacheMimetypeHelper + */ + public function getMimetypeFromExtension($extension) + { + $extension = strtolower($extension); + + return isset($this->mimetypes[$extension]) + ? $this->mimetypes[$extension] + : parent::getMimetypeFromExtension($extension); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/MimetypeHelper.php b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/MimetypeHelper.php new file mode 100644 index 0000000..fa7cf18 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/MimetypeHelper.php @@ -0,0 +1,27 @@ + + */ +interface MimetypeHelper +{ + /** + * Determines the mimetype of a file by looking at its extension. + * + * @param string $filename + * + * @return null|string + */ + public function getMimetypeFromFilename($filename); + + /** + * Maps a file extensions to a mimetype. + * + * @param string $extension The file extension + * + * @return string|null + */ + public function getMimetypeFromExtension($extension); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/MultipartStreamBuilder.php b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/MultipartStreamBuilder.php new file mode 100644 index 0000000..3421d73 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/multipart-stream-builder/src/MultipartStreamBuilder.php @@ -0,0 +1,278 @@ + + */ +class MultipartStreamBuilder +{ + /** + * @var StreamFactory + */ + private $streamFactory; + + /** + * @var MimetypeHelper + */ + private $mimetypeHelper; + + /** + * @var string + */ + private $boundary; + + /** + * @var array Element where each Element is an array with keys ['contents', 'headers', 'filename'] + */ + private $data = []; + + /** + * @param StreamFactory|null $streamFactory + */ + public function __construct(StreamFactory $streamFactory = null) + { + $this->streamFactory = $streamFactory ?: StreamFactoryDiscovery::find(); + } + + /** + * Add a resource to the Multipart Stream. + * + * @param string $name the formpost name + * @param string|resource|StreamInterface $resource + * @param array $options { + * + * @var array $headers additional headers ['header-name' => 'header-value'] + * @var string $filename + * } + * + * @return MultipartStreamBuilder + */ + public function addResource($name, $resource, array $options = []) + { + $stream = $this->streamFactory->createStream($resource); + + // validate options['headers'] exists + if (!isset($options['headers'])) { + $options['headers'] = []; + } + + // Try to add filename if it is missing + if (empty($options['filename'])) { + $options['filename'] = null; + $uri = $stream->getMetadata('uri'); + if (substr($uri, 0, 6) !== 'php://') { + $options['filename'] = $uri; + } + } + + $this->prepareHeaders($name, $stream, $options['filename'], $options['headers']); + $this->data[] = ['contents' => $stream, 'headers' => $options['headers'], 'filename' => $options['filename']]; + + return $this; + } + + /** + * Build the stream. + * + * @return StreamInterface + */ + public function build() + { + $streams = ''; + foreach ($this->data as $data) { + // Add start and headers + $streams .= "--{$this->getBoundary()}\r\n". + $this->getHeaders($data['headers'])."\r\n"; + + // Convert the stream to string + /* @var $contentStream StreamInterface */ + $contentStream = $data['contents']; + if ($contentStream->isSeekable()) { + $streams .= $contentStream->__toString(); + } else { + $streams .= $contentStream->getContents(); + } + + $streams .= "\r\n"; + } + + // Append end + $streams .= "--{$this->getBoundary()}--\r\n"; + + return $this->streamFactory->createStream($streams); + } + + /** + * Add extra headers if they are missing. + * + * @param string $name + * @param StreamInterface $stream + * @param string $filename + * @param array &$headers + */ + private function prepareHeaders($name, StreamInterface $stream, $filename, array &$headers) + { + $hasFilename = $filename === '0' || $filename; + + // Set a default content-disposition header if one was not provided + if (!$this->hasHeader($headers, 'content-disposition')) { + $headers['Content-Disposition'] = sprintf('form-data; name="%s"', $name); + if ($hasFilename) { + $headers['Content-Disposition'] .= sprintf('; filename="%s"', $this->basename($filename)); + } + } + + // Set a default content-length header if one was not provided + if (!$this->hasHeader($headers, 'content-length')) { + if ($length = $stream->getSize()) { + $headers['Content-Length'] = (string) $length; + } + } + + // Set a default Content-Type if one was not provided + if (!$this->hasHeader($headers, 'content-type') && $hasFilename) { + if ($type = $this->getMimetypeHelper()->getMimetypeFromFilename($filename)) { + $headers['Content-Type'] = $type; + } + } + } + + /** + * Get the headers formatted for the HTTP message. + * + * @param array $headers + * + * @return string + */ + private function getHeaders(array $headers) + { + $str = ''; + foreach ($headers as $key => $value) { + $str .= sprintf("%s: %s\r\n", $key, $value); + } + + return $str; + } + + /** + * Check if header exist. + * + * @param array $headers + * @param string $key case insensitive + * + * @return bool + */ + private function hasHeader(array $headers, $key) + { + $lowercaseHeader = strtolower($key); + foreach ($headers as $k => $v) { + if (strtolower($k) === $lowercaseHeader) { + return true; + } + } + + return false; + } + + /** + * Get the boundary that separates the streams. + * + * @return string + */ + public function getBoundary() + { + if ($this->boundary === null) { + $this->boundary = uniqid('', true); + } + + return $this->boundary; + } + + /** + * @param string $boundary + * + * @return MultipartStreamBuilder + */ + public function setBoundary($boundary) + { + $this->boundary = $boundary; + + return $this; + } + + /** + * @return MimetypeHelper + */ + private function getMimetypeHelper() + { + if ($this->mimetypeHelper === null) { + $this->mimetypeHelper = new ApacheMimetypeHelper(); + } + + return $this->mimetypeHelper; + } + + /** + * If you have custom file extension you may overwrite the default MimetypeHelper with your own. + * + * @param MimetypeHelper $mimetypeHelper + * + * @return MultipartStreamBuilder + */ + public function setMimetypeHelper(MimetypeHelper $mimetypeHelper) + { + $this->mimetypeHelper = $mimetypeHelper; + + return $this; + } + + /** + * Reset and clear all stored data. This allows you to use builder for a subsequent request. + * + * @return MultipartStreamBuilder + */ + public function reset() + { + $this->data = []; + $this->boundary = null; + + return $this; + } + + /** + * Gets the filename from a given path. + * + * PHP's basename() does not properly support streams or filenames beginning with a non-US-ASCII character. + * + * @author Drupal 8.2 + * + * @param string $path + * + * @return string + */ + private function basename($path) + { + $separators = '/'; + if (DIRECTORY_SEPARATOR != '/') { + // For Windows OS add special separator. + $separators .= DIRECTORY_SEPARATOR; + } + + // Remove right-most slashes when $path points to directory. + $path = rtrim($path, $separators); + + // Returns the trailing part of the $path starting after one of the directory separators. + $filename = preg_match('@[^'.preg_quote($separators, '@').']+$@', $path, $matches) ? $matches[0] : ''; + + return $filename; + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/promise/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/CHANGELOG.md new file mode 100644 index 0000000..336e140 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/CHANGELOG.md @@ -0,0 +1,35 @@ +# Change Log + + +## 1.0.0 - 2016-01-26 + +### Removed + +- PSR-7 dependency + + +## 1.0.0-RC1 - 2016-01-12 + +### Added + +- Tests for full coverage + +## Changed + +- Updated package files +- Clarified wait method behavior +- Contributing guide moved to the documentation + + +## 0.1.1 - 2015-12-24 + +## Added + +- Fulfilled and Rejected promise implementations + + +## 0.1.0 - 2015-12-13 + +## Added + +- Promise interface diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/promise/LICENSE b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/LICENSE new file mode 100644 index 0000000..4558d6f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2015-2016 PHP HTTP Team + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/promise/README.md b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/README.md new file mode 100644 index 0000000..adda2ae --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/README.md @@ -0,0 +1,49 @@ +# Promise + +[![Latest Version](https://img.shields.io/github/release/php-http/promise.svg?style=flat-square)](https://github.com/php-http/promise/releases) +[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE) +[![Build Status](https://img.shields.io/travis/php-http/promise.svg?style=flat-square)](https://travis-ci.org/php-http/promise) +[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-http/promise.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/promise) +[![Quality Score](https://img.shields.io/scrutinizer/g/php-http/promise.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-http/promise) +[![Total Downloads](https://img.shields.io/packagist/dt/php-http/promise.svg?style=flat-square)](https://packagist.org/packages/php-http/promise) + +**Promise used for asynchronous HTTP requests.** + +**Note:** This will eventually be removed/deprecated and replaced with the upcoming Promise PSR. + + +## Install + +Via Composer + +``` bash +$ composer require php-http/promise +``` + + +## Documentation + +Please see the [official documentation](http://docs.php-http.org). + + +## Testing + +``` bash +$ composer test +``` + + +## Contributing + +Please see our [contributing guide](http://docs.php-http.org/en/latest/development/contributing.html). + + +## Security + +If you discover any security related issues, please contact us at [security@httplug.io](mailto:security@httplug.io) +or [security@php-http.org](mailto:security@php-http.org). + + +## License + +The MIT License (MIT). Please see [License File](LICENSE) for more information. diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/promise/composer.json b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/composer.json new file mode 100644 index 0000000..ff1d2ce --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/composer.json @@ -0,0 +1,35 @@ +{ + "name": "php-http/promise", + "description": "Promise used for asynchronous HTTP requests", + "license": "MIT", + "keywords": ["promise"], + "homepage": "http://httplug.io", + "authors": [ + { + "name": "Joel Wurtz", + "email": "joel.wurtz@gmail.com" + }, + { + "name": "Márk Sági-Kazár", + "email": "mark.sagikazar@gmail.com" + } + ], + "require-dev": { + "phpspec/phpspec": "^2.4", + "henrikbjorn/phpspec-code-coverage" : "^1.0" + }, + "autoload": { + "psr-4": { + "Http\\Promise\\": "src/" + } + }, + "scripts": { + "test": "vendor/bin/phpspec run", + "test-ci": "vendor/bin/phpspec run -c phpspec.yml.ci" + }, + "extra": { + "branch-alias": { + "dev-master": "1.1-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/FulfilledPromise.php b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/FulfilledPromise.php new file mode 100644 index 0000000..f60f686 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/FulfilledPromise.php @@ -0,0 +1,58 @@ + + */ +final class FulfilledPromise implements Promise +{ + /** + * @var mixed + */ + private $result; + + /** + * @param $result + */ + public function __construct($result) + { + $this->result = $result; + } + + /** + * {@inheritdoc} + */ + public function then(callable $onFulfilled = null, callable $onRejected = null) + { + if (null === $onFulfilled) { + return $this; + } + + try { + return new self($onFulfilled($this->result)); + } catch (\Exception $e) { + return new RejectedPromise($e); + } + } + + /** + * {@inheritdoc} + */ + public function getState() + { + return Promise::FULFILLED; + } + + /** + * {@inheritdoc} + */ + public function wait($unwrap = true) + { + if ($unwrap) { + return $this->result; + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/Promise.php b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/Promise.php new file mode 100644 index 0000000..e2cf5f8 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/Promise.php @@ -0,0 +1,69 @@ + + * @author Márk Sági-Kazár + */ +interface Promise +{ + /** + * Promise has not been fulfilled or rejected. + */ + const PENDING = 'pending'; + + /** + * Promise has been fulfilled. + */ + const FULFILLED = 'fulfilled'; + + /** + * Promise has been rejected. + */ + const REJECTED = 'rejected'; + + /** + * Adds behavior for when the promise is resolved or rejected (response will be available, or error happens). + * + * If you do not care about one of the cases, you can set the corresponding callable to null + * The callback will be called when the value arrived and never more than once. + * + * @param callable $onFulfilled Called when a response will be available. + * @param callable $onRejected Called when an exception occurs. + * + * @return Promise A new resolved promise with value of the executed callback (onFulfilled / onRejected). + */ + public function then(callable $onFulfilled = null, callable $onRejected = null); + + /** + * Returns the state of the promise, one of PENDING, FULFILLED or REJECTED. + * + * @return string + */ + public function getState(); + + /** + * Wait for the promise to be fulfilled or rejected. + * + * When this method returns, the request has been resolved and if callables have been + * specified, the appropriate one has terminated. + * + * When $unwrap is true (the default), the response is returned, or the exception thrown + * on failure. Otherwise, nothing is returned or thrown. + * + * @param bool $unwrap Whether to return resolved value / throw reason or not + * + * @return mixed Resolved value, null if $unwrap is set to false + * + * @throws \Exception The rejection reason if $unwrap is set to true and the request failed. + */ + public function wait($unwrap = true); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/RejectedPromise.php b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/RejectedPromise.php new file mode 100644 index 0000000..e396a40 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/php-http/promise/src/RejectedPromise.php @@ -0,0 +1,58 @@ + + */ +final class RejectedPromise implements Promise +{ + /** + * @var \Exception + */ + private $exception; + + /** + * @param \Exception $exception + */ + public function __construct(\Exception $exception) + { + $this->exception = $exception; + } + + /** + * {@inheritdoc} + */ + public function then(callable $onFulfilled = null, callable $onRejected = null) + { + if (null === $onRejected) { + return $this; + } + + try { + return new FulfilledPromise($onRejected($this->exception)); + } catch (\Exception $e) { + return new self($e); + } + } + + /** + * {@inheritdoc} + */ + public function getState() + { + return Promise::REJECTED; + } + + /** + * {@inheritdoc} + */ + public function wait($unwrap = true) + { + if ($unwrap) { + throw $this->exception; + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/psr/http-message/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/CHANGELOG.md new file mode 100644 index 0000000..74b1ef9 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/CHANGELOG.md @@ -0,0 +1,36 @@ +# Changelog + +All notable changes to this project will be documented in this file, in reverse chronological order by release. + +## 1.0.1 - 2016-08-06 + +### Added + +- Nothing. + +### Deprecated + +- Nothing. + +### Removed + +- Nothing. + +### Fixed + +- Updated all `@return self` annotation references in interfaces to use + `@return static`, which more closelly follows the semantics of the + specification. +- Updated the `MessageInterface::getHeaders()` return annotation to use the + value `string[][]`, indicating the format is a nested array of strings. +- Updated the `@link` annotation for `RequestInterface::withRequestTarget()` + to point to the correct section of RFC 7230. +- Updated the `ServerRequestInterface::withUploadedFiles()` parameter annotation + to add the parameter name (`$uploadedFiles`). +- Updated a `@throws` annotation for the `UploadedFileInterface::moveTo()` + method to correctly reference the method parameter (it was referencing an + incorrect parameter name previously). + +## 1.0.0 - 2016-05-18 + +Initial stable release; reflects accepted PSR-7 specification. diff --git a/Postman/Postman-Mail/mailgun/vendor/psr/http-message/LICENSE b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/LICENSE new file mode 100644 index 0000000..c2d8e45 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2014 PHP Framework Interoperability Group + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/psr/http-message/README.md b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/README.md new file mode 100644 index 0000000..2818533 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/README.md @@ -0,0 +1,13 @@ +PSR Http Message +================ + +This repository holds all interfaces/classes/traits related to +[PSR-7](http://www.php-fig.org/psr/psr-7/). + +Note that this is not a HTTP message implementation of its own. It is merely an +interface that describes a HTTP message. See the specification for more details. + +Usage +----- + +We'll certainly need some stuff in here. \ No newline at end of file diff --git a/Postman/Postman-Mail/mailgun/vendor/psr/http-message/composer.json b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/composer.json new file mode 100644 index 0000000..b0d2937 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/composer.json @@ -0,0 +1,26 @@ +{ + "name": "psr/http-message", + "description": "Common interface for HTTP messages", + "keywords": ["psr", "psr-7", "http", "http-message", "request", "response"], + "homepage": "https://github.com/php-fig/http-message", + "license": "MIT", + "authors": [ + { + "name": "PHP-FIG", + "homepage": "http://www.php-fig.org/" + } + ], + "require": { + "php": ">=5.3.0" + }, + "autoload": { + "psr-4": { + "Psr\\Http\\Message\\": "src/" + } + }, + "extra": { + "branch-alias": { + "dev-master": "1.0.x-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/MessageInterface.php b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/MessageInterface.php new file mode 100644 index 0000000..dd46e5e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/MessageInterface.php @@ -0,0 +1,187 @@ +getHeaders() as $name => $values) { + * echo $name . ": " . implode(", ", $values); + * } + * + * // Emit headers iteratively: + * foreach ($message->getHeaders() as $name => $values) { + * foreach ($values as $value) { + * header(sprintf('%s: %s', $name, $value), false); + * } + * } + * + * While header names are not case-sensitive, getHeaders() will preserve the + * exact case in which headers were originally specified. + * + * @return string[][] Returns an associative array of the message's headers. Each + * key MUST be a header name, and each value MUST be an array of strings + * for that header. + */ + public function getHeaders(); + + /** + * Checks if a header exists by the given case-insensitive name. + * + * @param string $name Case-insensitive header field name. + * @return bool Returns true if any header names match the given header + * name using a case-insensitive string comparison. Returns false if + * no matching header name is found in the message. + */ + public function hasHeader($name); + + /** + * Retrieves a message header value by the given case-insensitive name. + * + * This method returns an array of all the header values of the given + * case-insensitive header name. + * + * If the header does not appear in the message, this method MUST return an + * empty array. + * + * @param string $name Case-insensitive header field name. + * @return string[] An array of string values as provided for the given + * header. If the header does not appear in the message, this method MUST + * return an empty array. + */ + public function getHeader($name); + + /** + * Retrieves a comma-separated string of the values for a single header. + * + * This method returns all of the header values of the given + * case-insensitive header name as a string concatenated together using + * a comma. + * + * NOTE: Not all header values may be appropriately represented using + * comma concatenation. For such headers, use getHeader() instead + * and supply your own delimiter when concatenating. + * + * If the header does not appear in the message, this method MUST return + * an empty string. + * + * @param string $name Case-insensitive header field name. + * @return string A string of values as provided for the given header + * concatenated together using a comma. If the header does not appear in + * the message, this method MUST return an empty string. + */ + public function getHeaderLine($name); + + /** + * Return an instance with the provided value replacing the specified header. + * + * While header names are case-insensitive, the casing of the header will + * be preserved by this function, and returned from getHeaders(). + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * new and/or updated header and value. + * + * @param string $name Case-insensitive header field name. + * @param string|string[] $value Header value(s). + * @return static + * @throws \InvalidArgumentException for invalid header names or values. + */ + public function withHeader($name, $value); + + /** + * Return an instance with the specified header appended with the given value. + * + * Existing values for the specified header will be maintained. The new + * value(s) will be appended to the existing list. If the header did not + * exist previously, it will be added. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * new header and/or value. + * + * @param string $name Case-insensitive header field name to add. + * @param string|string[] $value Header value(s). + * @return static + * @throws \InvalidArgumentException for invalid header names or values. + */ + public function withAddedHeader($name, $value); + + /** + * Return an instance without the specified header. + * + * Header resolution MUST be done without case-sensitivity. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that removes + * the named header. + * + * @param string $name Case-insensitive header field name to remove. + * @return static + */ + public function withoutHeader($name); + + /** + * Gets the body of the message. + * + * @return StreamInterface Returns the body as a stream. + */ + public function getBody(); + + /** + * Return an instance with the specified message body. + * + * The body MUST be a StreamInterface object. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return a new instance that has the + * new body stream. + * + * @param StreamInterface $body Body. + * @return static + * @throws \InvalidArgumentException When the body is not valid. + */ + public function withBody(StreamInterface $body); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/RequestInterface.php b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/RequestInterface.php new file mode 100644 index 0000000..a96d4fd --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/RequestInterface.php @@ -0,0 +1,129 @@ +getQuery()` + * or from the `QUERY_STRING` server param. + * + * @return array + */ + public function getQueryParams(); + + /** + * Return an instance with the specified query string arguments. + * + * These values SHOULD remain immutable over the course of the incoming + * request. They MAY be injected during instantiation, such as from PHP's + * $_GET superglobal, or MAY be derived from some other value such as the + * URI. In cases where the arguments are parsed from the URI, the data + * MUST be compatible with what PHP's parse_str() would return for + * purposes of how duplicate query parameters are handled, and how nested + * sets are handled. + * + * Setting query string arguments MUST NOT change the URI stored by the + * request, nor the values in the server params. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * updated query string arguments. + * + * @param array $query Array of query string arguments, typically from + * $_GET. + * @return static + */ + public function withQueryParams(array $query); + + /** + * Retrieve normalized file upload data. + * + * This method returns upload metadata in a normalized tree, with each leaf + * an instance of Psr\Http\Message\UploadedFileInterface. + * + * These values MAY be prepared from $_FILES or the message body during + * instantiation, or MAY be injected via withUploadedFiles(). + * + * @return array An array tree of UploadedFileInterface instances; an empty + * array MUST be returned if no data is present. + */ + public function getUploadedFiles(); + + /** + * Create a new instance with the specified uploaded files. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * updated body parameters. + * + * @param array $uploadedFiles An array tree of UploadedFileInterface instances. + * @return static + * @throws \InvalidArgumentException if an invalid structure is provided. + */ + public function withUploadedFiles(array $uploadedFiles); + + /** + * Retrieve any parameters provided in the request body. + * + * If the request Content-Type is either application/x-www-form-urlencoded + * or multipart/form-data, and the request method is POST, this method MUST + * return the contents of $_POST. + * + * Otherwise, this method may return any results of deserializing + * the request body content; as parsing returns structured content, the + * potential types MUST be arrays or objects only. A null value indicates + * the absence of body content. + * + * @return null|array|object The deserialized body parameters, if any. + * These will typically be an array or object. + */ + public function getParsedBody(); + + /** + * Return an instance with the specified body parameters. + * + * These MAY be injected during instantiation. + * + * If the request Content-Type is either application/x-www-form-urlencoded + * or multipart/form-data, and the request method is POST, use this method + * ONLY to inject the contents of $_POST. + * + * The data IS NOT REQUIRED to come from $_POST, but MUST be the results of + * deserializing the request body content. Deserialization/parsing returns + * structured data, and, as such, this method ONLY accepts arrays or objects, + * or a null value if nothing was available to parse. + * + * As an example, if content negotiation determines that the request data + * is a JSON payload, this method could be used to create a request + * instance with the deserialized parameters. + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * updated body parameters. + * + * @param null|array|object $data The deserialized body data. This will + * typically be in an array or object. + * @return static + * @throws \InvalidArgumentException if an unsupported argument type is + * provided. + */ + public function withParsedBody($data); + + /** + * Retrieve attributes derived from the request. + * + * The request "attributes" may be used to allow injection of any + * parameters derived from the request: e.g., the results of path + * match operations; the results of decrypting cookies; the results of + * deserializing non-form-encoded message bodies; etc. Attributes + * will be application and request specific, and CAN be mutable. + * + * @return array Attributes derived from the request. + */ + public function getAttributes(); + + /** + * Retrieve a single derived request attribute. + * + * Retrieves a single derived request attribute as described in + * getAttributes(). If the attribute has not been previously set, returns + * the default value as provided. + * + * This method obviates the need for a hasAttribute() method, as it allows + * specifying a default value to return if the attribute is not found. + * + * @see getAttributes() + * @param string $name The attribute name. + * @param mixed $default Default value to return if the attribute does not exist. + * @return mixed + */ + public function getAttribute($name, $default = null); + + /** + * Return an instance with the specified derived request attribute. + * + * This method allows setting a single derived request attribute as + * described in getAttributes(). + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that has the + * updated attribute. + * + * @see getAttributes() + * @param string $name The attribute name. + * @param mixed $value The value of the attribute. + * @return static + */ + public function withAttribute($name, $value); + + /** + * Return an instance that removes the specified derived request attribute. + * + * This method allows removing a single derived request attribute as + * described in getAttributes(). + * + * This method MUST be implemented in such a way as to retain the + * immutability of the message, and MUST return an instance that removes + * the attribute. + * + * @see getAttributes() + * @param string $name The attribute name. + * @return static + */ + public function withoutAttribute($name); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/StreamInterface.php b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/StreamInterface.php new file mode 100644 index 0000000..f68f391 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/psr/http-message/src/StreamInterface.php @@ -0,0 +1,158 @@ + + * [user-info@]host[:port] + * + * + * If the port component is not set or is the standard port for the current + * scheme, it SHOULD NOT be included. + * + * @see https://tools.ietf.org/html/rfc3986#section-3.2 + * @return string The URI authority, in "[user-info@]host[:port]" format. + */ + public function getAuthority(); + + /** + * Retrieve the user information component of the URI. + * + * If no user information is present, this method MUST return an empty + * string. + * + * If a user is present in the URI, this will return that value; + * additionally, if the password is also present, it will be appended to the + * user value, with a colon (":") separating the values. + * + * The trailing "@" character is not part of the user information and MUST + * NOT be added. + * + * @return string The URI user information, in "username[:password]" format. + */ + public function getUserInfo(); + + /** + * Retrieve the host component of the URI. + * + * If no host is present, this method MUST return an empty string. + * + * The value returned MUST be normalized to lowercase, per RFC 3986 + * Section 3.2.2. + * + * @see http://tools.ietf.org/html/rfc3986#section-3.2.2 + * @return string The URI host. + */ + public function getHost(); + + /** + * Retrieve the port component of the URI. + * + * If a port is present, and it is non-standard for the current scheme, + * this method MUST return it as an integer. If the port is the standard port + * used with the current scheme, this method SHOULD return null. + * + * If no port is present, and no scheme is present, this method MUST return + * a null value. + * + * If no port is present, but a scheme is present, this method MAY return + * the standard port for that scheme, but SHOULD return null. + * + * @return null|int The URI port. + */ + public function getPort(); + + /** + * Retrieve the path component of the URI. + * + * The path can either be empty or absolute (starting with a slash) or + * rootless (not starting with a slash). Implementations MUST support all + * three syntaxes. + * + * Normally, the empty path "" and absolute path "/" are considered equal as + * defined in RFC 7230 Section 2.7.3. But this method MUST NOT automatically + * do this normalization because in contexts with a trimmed base path, e.g. + * the front controller, this difference becomes significant. It's the task + * of the user to handle both "" and "/". + * + * The value returned MUST be percent-encoded, but MUST NOT double-encode + * any characters. To determine what characters to encode, please refer to + * RFC 3986, Sections 2 and 3.3. + * + * As an example, if the value should include a slash ("/") not intended as + * delimiter between path segments, that value MUST be passed in encoded + * form (e.g., "%2F") to the instance. + * + * @see https://tools.ietf.org/html/rfc3986#section-2 + * @see https://tools.ietf.org/html/rfc3986#section-3.3 + * @return string The URI path. + */ + public function getPath(); + + /** + * Retrieve the query string of the URI. + * + * If no query string is present, this method MUST return an empty string. + * + * The leading "?" character is not part of the query and MUST NOT be + * added. + * + * The value returned MUST be percent-encoded, but MUST NOT double-encode + * any characters. To determine what characters to encode, please refer to + * RFC 3986, Sections 2 and 3.4. + * + * As an example, if a value in a key/value pair of the query string should + * include an ampersand ("&") not intended as a delimiter between values, + * that value MUST be passed in encoded form (e.g., "%26") to the instance. + * + * @see https://tools.ietf.org/html/rfc3986#section-2 + * @see https://tools.ietf.org/html/rfc3986#section-3.4 + * @return string The URI query string. + */ + public function getQuery(); + + /** + * Retrieve the fragment component of the URI. + * + * If no fragment is present, this method MUST return an empty string. + * + * The leading "#" character is not part of the fragment and MUST NOT be + * added. + * + * The value returned MUST be percent-encoded, but MUST NOT double-encode + * any characters. To determine what characters to encode, please refer to + * RFC 3986, Sections 2 and 3.5. + * + * @see https://tools.ietf.org/html/rfc3986#section-2 + * @see https://tools.ietf.org/html/rfc3986#section-3.5 + * @return string The URI fragment. + */ + public function getFragment(); + + /** + * Return an instance with the specified scheme. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified scheme. + * + * Implementations MUST support the schemes "http" and "https" case + * insensitively, and MAY accommodate other schemes if required. + * + * An empty scheme is equivalent to removing the scheme. + * + * @param string $scheme The scheme to use with the new instance. + * @return static A new instance with the specified scheme. + * @throws \InvalidArgumentException for invalid or unsupported schemes. + */ + public function withScheme($scheme); + + /** + * Return an instance with the specified user information. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified user information. + * + * Password is optional, but the user information MUST include the + * user; an empty string for the user is equivalent to removing user + * information. + * + * @param string $user The user name to use for authority. + * @param null|string $password The password associated with $user. + * @return static A new instance with the specified user information. + */ + public function withUserInfo($user, $password = null); + + /** + * Return an instance with the specified host. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified host. + * + * An empty host value is equivalent to removing the host. + * + * @param string $host The hostname to use with the new instance. + * @return static A new instance with the specified host. + * @throws \InvalidArgumentException for invalid hostnames. + */ + public function withHost($host); + + /** + * Return an instance with the specified port. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified port. + * + * Implementations MUST raise an exception for ports outside the + * established TCP and UDP port ranges. + * + * A null value provided for the port is equivalent to removing the port + * information. + * + * @param null|int $port The port to use with the new instance; a null value + * removes the port information. + * @return static A new instance with the specified port. + * @throws \InvalidArgumentException for invalid ports. + */ + public function withPort($port); + + /** + * Return an instance with the specified path. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified path. + * + * The path can either be empty or absolute (starting with a slash) or + * rootless (not starting with a slash). Implementations MUST support all + * three syntaxes. + * + * If the path is intended to be domain-relative rather than path relative then + * it must begin with a slash ("/"). Paths not starting with a slash ("/") + * are assumed to be relative to some base path known to the application or + * consumer. + * + * Users can provide both encoded and decoded path characters. + * Implementations ensure the correct encoding as outlined in getPath(). + * + * @param string $path The path to use with the new instance. + * @return static A new instance with the specified path. + * @throws \InvalidArgumentException for invalid paths. + */ + public function withPath($path); + + /** + * Return an instance with the specified query string. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified query string. + * + * Users can provide both encoded and decoded query characters. + * Implementations ensure the correct encoding as outlined in getQuery(). + * + * An empty query string value is equivalent to removing the query string. + * + * @param string $query The query string to use with the new instance. + * @return static A new instance with the specified query string. + * @throws \InvalidArgumentException for invalid query strings. + */ + public function withQuery($query); + + /** + * Return an instance with the specified URI fragment. + * + * This method MUST retain the state of the current instance, and return + * an instance that contains the specified URI fragment. + * + * Users can provide both encoded and decoded fragment characters. + * Implementations ensure the correct encoding as outlined in getFragment(). + * + * An empty fragment value is equivalent to removing the fragment. + * + * @param string $fragment The fragment to use with the new instance. + * @return static A new instance with the specified fragment. + */ + public function withFragment($fragment); + + /** + * Return the string representation as a URI reference. + * + * Depending on which components of the URI are present, the resulting + * string is either a full URI or relative reference according to RFC 3986, + * Section 4.1. The method concatenates the various components of the URI, + * using the appropriate delimiters: + * + * - If a scheme is present, it MUST be suffixed by ":". + * - If an authority is present, it MUST be prefixed by "//". + * - The path can be concatenated without delimiters. But there are two + * cases where the path has to be adjusted to make the URI reference + * valid as PHP does not allow to throw an exception in __toString(): + * - If the path is rootless and an authority is present, the path MUST + * be prefixed by "/". + * - If the path is starting with more than one "/" and no authority is + * present, the starting slashes MUST be reduced to one. + * - If a query is present, it MUST be prefixed by "?". + * - If a fragment is present, it MUST be prefixed by "#". + * + * @see http://tools.ietf.org/html/rfc3986#section-4.1 + * @return string + */ + public function __toString(); +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/CHANGELOG.md new file mode 100644 index 0000000..c8f0244 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/CHANGELOG.md @@ -0,0 +1,52 @@ +CHANGELOG +========= + +3.4.0 +----- + + * added `OptionsResolverIntrospector` to inspect options definitions inside an `OptionsResolver` instance + * added array of types support in allowed types (e.g int[]) + +2.6.0 +----- + + * deprecated OptionsResolverInterface + * [BC BREAK] removed "array" type hint from OptionsResolverInterface methods + setRequired(), setAllowedValues(), addAllowedValues(), setAllowedTypes() and + addAllowedTypes() + * added OptionsResolver::setDefault() + * added OptionsResolver::hasDefault() + * added OptionsResolver::setNormalizer() + * added OptionsResolver::isRequired() + * added OptionsResolver::getRequiredOptions() + * added OptionsResolver::isMissing() + * added OptionsResolver::getMissingOptions() + * added OptionsResolver::setDefined() + * added OptionsResolver::isDefined() + * added OptionsResolver::getDefinedOptions() + * added OptionsResolver::remove() + * added OptionsResolver::clear() + * deprecated OptionsResolver::replaceDefaults() + * deprecated OptionsResolver::setOptional() in favor of setDefined() + * deprecated OptionsResolver::isKnown() in favor of isDefined() + * [BC BREAK] OptionsResolver::isRequired() returns true now if a required + option has a default value set + * [BC BREAK] merged Options into OptionsResolver and turned Options into an + interface + * deprecated Options::overload() (now in OptionsResolver) + * deprecated Options::set() (now in OptionsResolver) + * deprecated Options::get() (now in OptionsResolver) + * deprecated Options::has() (now in OptionsResolver) + * deprecated Options::replace() (now in OptionsResolver) + * [BC BREAK] Options::get() (now in OptionsResolver) can only be used within + lazy option/normalizer closures now + * [BC BREAK] removed Traversable interface from Options since using within + lazy option/normalizer closures resulted in exceptions + * [BC BREAK] removed Options::all() since using within lazy option/normalizer + closures resulted in exceptions + * [BC BREAK] OptionDefinitionException now extends LogicException instead of + RuntimeException + * [BC BREAK] normalizers are not executed anymore for unset options + * normalizers are executed after validating the options now + * [BC BREAK] an UndefinedOptionsException is now thrown instead of an + InvalidOptionsException when non-existing options are passed diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Debug/OptionsResolverIntrospector.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Debug/OptionsResolverIntrospector.php new file mode 100644 index 0000000..6031724 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Debug/OptionsResolverIntrospector.php @@ -0,0 +1,102 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Debug; + +use Symfony\Component\OptionsResolver\Exception\NoConfigurationException; +use Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException; +use Symfony\Component\OptionsResolver\OptionsResolver; + +/** + * @author Maxime Steinhausser + * + * @final + */ +class OptionsResolverIntrospector +{ + private $get; + + public function __construct(OptionsResolver $optionsResolver) + { + $this->get = \Closure::bind(function ($property, $option, $message) { + /** @var OptionsResolver $this */ + if (!$this->isDefined($option)) { + throw new UndefinedOptionsException(sprintf('The option "%s" does not exist.', $option)); + } + + if (!array_key_exists($option, $this->{$property})) { + throw new NoConfigurationException($message); + } + + return $this->{$property}[$option]; + }, $optionsResolver, $optionsResolver); + } + + /** + * @param string $option + * + * @return mixed + * + * @throws NoConfigurationException on no configured value + */ + public function getDefault($option) + { + return call_user_func($this->get, 'defaults', $option, sprintf('No default value was set for the "%s" option.', $option)); + } + + /** + * @param string $option + * + * @return \Closure[] + * + * @throws NoConfigurationException on no configured closures + */ + public function getLazyClosures($option) + { + return call_user_func($this->get, 'lazy', $option, sprintf('No lazy closures were set for the "%s" option.', $option)); + } + + /** + * @param string $option + * + * @return string[] + * + * @throws NoConfigurationException on no configured types + */ + public function getAllowedTypes($option) + { + return call_user_func($this->get, 'allowedTypes', $option, sprintf('No allowed types were set for the "%s" option.', $option)); + } + + /** + * @param string $option + * + * @return mixed[] + * + * @throws NoConfigurationException on no configured values + */ + public function getAllowedValues($option) + { + return call_user_func($this->get, 'allowedValues', $option, sprintf('No allowed values were set for the "%s" option.', $option)); + } + + /** + * @param string $option + * + * @return \Closure + * + * @throws NoConfigurationException on no configured normalizer + */ + public function getNormalizer($option) + { + return call_user_func($this->get, 'normalizers', $option, sprintf('No normalizer was set for the "%s" option.', $option)); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/AccessException.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/AccessException.php new file mode 100644 index 0000000..c12b680 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/AccessException.php @@ -0,0 +1,22 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +/** + * Thrown when trying to read an option outside of or write it inside of + * {@link \Symfony\Component\OptionsResolver\Options::resolve()}. + * + * @author Bernhard Schussek + */ +class AccessException extends \LogicException implements ExceptionInterface +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/ExceptionInterface.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/ExceptionInterface.php new file mode 100644 index 0000000..b62bb51 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/ExceptionInterface.php @@ -0,0 +1,21 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +/** + * Marker interface for all exceptions thrown by the OptionsResolver component. + * + * @author Bernhard Schussek + */ +interface ExceptionInterface +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/InvalidArgumentException.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/InvalidArgumentException.php new file mode 100644 index 0000000..6d421d6 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/InvalidArgumentException.php @@ -0,0 +1,21 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +/** + * Thrown when an argument is invalid. + * + * @author Bernhard Schussek + */ +class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/InvalidOptionsException.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/InvalidOptionsException.php new file mode 100644 index 0000000..6fd4f12 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/InvalidOptionsException.php @@ -0,0 +1,23 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +/** + * Thrown when the value of an option does not match its validation rules. + * + * You should make sure a valid value is passed to the option. + * + * @author Bernhard Schussek + */ +class InvalidOptionsException extends InvalidArgumentException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/MissingOptionsException.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/MissingOptionsException.php new file mode 100644 index 0000000..faa487f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/MissingOptionsException.php @@ -0,0 +1,23 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +/** + * Exception thrown when a required option is missing. + * + * Add the option to the passed options array. + * + * @author Bernhard Schussek + */ +class MissingOptionsException extends InvalidArgumentException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/NoConfigurationException.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/NoConfigurationException.php new file mode 100644 index 0000000..6693ec1 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/NoConfigurationException.php @@ -0,0 +1,26 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +use Symfony\Component\OptionsResolver\Debug\OptionsResolverIntrospector; + +/** + * Thrown when trying to introspect an option definition property + * for which no value was configured inside the OptionsResolver instance. + * + * @see OptionsResolverIntrospector + * + * @author Maxime Steinhausser + */ +class NoConfigurationException extends \RuntimeException implements ExceptionInterface +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/NoSuchOptionException.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/NoSuchOptionException.php new file mode 100644 index 0000000..4c3280f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/NoSuchOptionException.php @@ -0,0 +1,26 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +/** + * Thrown when trying to read an option that has no value set. + * + * When accessing optional options from within a lazy option or normalizer you should first + * check whether the optional option is set. You can do this with `isset($options['optional'])`. + * In contrast to the {@link UndefinedOptionsException}, this is a runtime exception that can + * occur when evaluating lazy options. + * + * @author Tobias Schultze + */ +class NoSuchOptionException extends \OutOfBoundsException implements ExceptionInterface +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/OptionDefinitionException.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/OptionDefinitionException.php new file mode 100644 index 0000000..e8e339d --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/OptionDefinitionException.php @@ -0,0 +1,21 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +/** + * Thrown when two lazy options have a cyclic dependency. + * + * @author Bernhard Schussek + */ +class OptionDefinitionException extends \LogicException implements ExceptionInterface +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/UndefinedOptionsException.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/UndefinedOptionsException.php new file mode 100644 index 0000000..6ca3fce --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Exception/UndefinedOptionsException.php @@ -0,0 +1,24 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Exception; + +/** + * Exception thrown when an undefined option is passed. + * + * You should remove the options in question from your code or define them + * beforehand. + * + * @author Bernhard Schussek + */ +class UndefinedOptionsException extends InvalidArgumentException +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/LICENSE b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/LICENSE new file mode 100644 index 0000000..17d16a1 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2004-2017 Fabien Potencier + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Options.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Options.php new file mode 100644 index 0000000..d444ec4 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Options.php @@ -0,0 +1,22 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver; + +/** + * Contains resolved option values. + * + * @author Bernhard Schussek + * @author Tobias Schultze + */ +interface Options extends \ArrayAccess, \Countable +{ +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/OptionsResolver.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/OptionsResolver.php new file mode 100644 index 0000000..f5b84f0 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/OptionsResolver.php @@ -0,0 +1,1076 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver; + +use Symfony\Component\OptionsResolver\Exception\AccessException; +use Symfony\Component\OptionsResolver\Exception\InvalidOptionsException; +use Symfony\Component\OptionsResolver\Exception\MissingOptionsException; +use Symfony\Component\OptionsResolver\Exception\NoSuchOptionException; +use Symfony\Component\OptionsResolver\Exception\OptionDefinitionException; +use Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException; + +/** + * Validates options and merges them with default values. + * + * @author Bernhard Schussek + * @author Tobias Schultze + */ +class OptionsResolver implements Options +{ + /** + * The names of all defined options. + */ + private $defined = array(); + + /** + * The default option values. + */ + private $defaults = array(); + + /** + * The names of required options. + */ + private $required = array(); + + /** + * The resolved option values. + */ + private $resolved = array(); + + /** + * A list of normalizer closures. + * + * @var \Closure[] + */ + private $normalizers = array(); + + /** + * A list of accepted values for each option. + */ + private $allowedValues = array(); + + /** + * A list of accepted types for each option. + */ + private $allowedTypes = array(); + + /** + * A list of closures for evaluating lazy options. + */ + private $lazy = array(); + + /** + * A list of lazy options whose closure is currently being called. + * + * This list helps detecting circular dependencies between lazy options. + */ + private $calling = array(); + + /** + * Whether the instance is locked for reading. + * + * Once locked, the options cannot be changed anymore. This is + * necessary in order to avoid inconsistencies during the resolving + * process. If any option is changed after being read, all evaluated + * lazy options that depend on this option would become invalid. + */ + private $locked = false; + + private static $typeAliases = array( + 'boolean' => 'bool', + 'integer' => 'int', + 'double' => 'float', + ); + + /** + * Sets the default value of a given option. + * + * If the default value should be set based on other options, you can pass + * a closure with the following signature: + * + * function (Options $options) { + * // ... + * } + * + * The closure will be evaluated when {@link resolve()} is called. The + * closure has access to the resolved values of other options through the + * passed {@link Options} instance: + * + * function (Options $options) { + * if (isset($options['port'])) { + * // ... + * } + * } + * + * If you want to access the previously set default value, add a second + * argument to the closure's signature: + * + * $options->setDefault('name', 'Default Name'); + * + * $options->setDefault('name', function (Options $options, $previousValue) { + * // 'Default Name' === $previousValue + * }); + * + * This is mostly useful if the configuration of the {@link Options} object + * is spread across different locations of your code, such as base and + * sub-classes. + * + * @param string $option The name of the option + * @param mixed $value The default value of the option + * + * @return $this + * + * @throws AccessException If called from a lazy option or normalizer + */ + public function setDefault($option, $value) + { + // Setting is not possible once resolving starts, because then lazy + // options could manipulate the state of the object, leading to + // inconsistent results. + if ($this->locked) { + throw new AccessException('Default values cannot be set from a lazy option or normalizer.'); + } + + // If an option is a closure that should be evaluated lazily, store it + // in the "lazy" property. + if ($value instanceof \Closure) { + $reflClosure = new \ReflectionFunction($value); + $params = $reflClosure->getParameters(); + + if (isset($params[0]) && null !== ($class = $params[0]->getClass()) && Options::class === $class->name) { + // Initialize the option if no previous value exists + if (!isset($this->defaults[$option])) { + $this->defaults[$option] = null; + } + + // Ignore previous lazy options if the closure has no second parameter + if (!isset($this->lazy[$option]) || !isset($params[1])) { + $this->lazy[$option] = array(); + } + + // Store closure for later evaluation + $this->lazy[$option][] = $value; + $this->defined[$option] = true; + + // Make sure the option is processed + unset($this->resolved[$option]); + + return $this; + } + } + + // This option is not lazy anymore + unset($this->lazy[$option]); + + // Yet undefined options can be marked as resolved, because we only need + // to resolve options with lazy closures, normalizers or validation + // rules, none of which can exist for undefined options + // If the option was resolved before, update the resolved value + if (!isset($this->defined[$option]) || array_key_exists($option, $this->resolved)) { + $this->resolved[$option] = $value; + } + + $this->defaults[$option] = $value; + $this->defined[$option] = true; + + return $this; + } + + /** + * Sets a list of default values. + * + * @param array $defaults The default values to set + * + * @return $this + * + * @throws AccessException If called from a lazy option or normalizer + */ + public function setDefaults(array $defaults) + { + foreach ($defaults as $option => $value) { + $this->setDefault($option, $value); + } + + return $this; + } + + /** + * Returns whether a default value is set for an option. + * + * Returns true if {@link setDefault()} was called for this option. + * An option is also considered set if it was set to null. + * + * @param string $option The option name + * + * @return bool Whether a default value is set + */ + public function hasDefault($option) + { + return array_key_exists($option, $this->defaults); + } + + /** + * Marks one or more options as required. + * + * @param string|string[] $optionNames One or more option names + * + * @return $this + * + * @throws AccessException If called from a lazy option or normalizer + */ + public function setRequired($optionNames) + { + if ($this->locked) { + throw new AccessException('Options cannot be made required from a lazy option or normalizer.'); + } + + foreach ((array) $optionNames as $option) { + $this->defined[$option] = true; + $this->required[$option] = true; + } + + return $this; + } + + /** + * Returns whether an option is required. + * + * An option is required if it was passed to {@link setRequired()}. + * + * @param string $option The name of the option + * + * @return bool Whether the option is required + */ + public function isRequired($option) + { + return isset($this->required[$option]); + } + + /** + * Returns the names of all required options. + * + * @return string[] The names of the required options + * + * @see isRequired() + */ + public function getRequiredOptions() + { + return array_keys($this->required); + } + + /** + * Returns whether an option is missing a default value. + * + * An option is missing if it was passed to {@link setRequired()}, but not + * to {@link setDefault()}. This option must be passed explicitly to + * {@link resolve()}, otherwise an exception will be thrown. + * + * @param string $option The name of the option + * + * @return bool Whether the option is missing + */ + public function isMissing($option) + { + return isset($this->required[$option]) && !array_key_exists($option, $this->defaults); + } + + /** + * Returns the names of all options missing a default value. + * + * @return string[] The names of the missing options + * + * @see isMissing() + */ + public function getMissingOptions() + { + return array_keys(array_diff_key($this->required, $this->defaults)); + } + + /** + * Defines a valid option name. + * + * Defines an option name without setting a default value. The option will + * be accepted when passed to {@link resolve()}. When not passed, the + * option will not be included in the resolved options. + * + * @param string|string[] $optionNames One or more option names + * + * @return $this + * + * @throws AccessException If called from a lazy option or normalizer + */ + public function setDefined($optionNames) + { + if ($this->locked) { + throw new AccessException('Options cannot be defined from a lazy option or normalizer.'); + } + + foreach ((array) $optionNames as $option) { + $this->defined[$option] = true; + } + + return $this; + } + + /** + * Returns whether an option is defined. + * + * Returns true for any option passed to {@link setDefault()}, + * {@link setRequired()} or {@link setDefined()}. + * + * @param string $option The option name + * + * @return bool Whether the option is defined + */ + public function isDefined($option) + { + return isset($this->defined[$option]); + } + + /** + * Returns the names of all defined options. + * + * @return string[] The names of the defined options + * + * @see isDefined() + */ + public function getDefinedOptions() + { + return array_keys($this->defined); + } + + /** + * Sets the normalizer for an option. + * + * The normalizer should be a closure with the following signature: + * + * ```php + * function (Options $options, $value) { + * // ... + * } + * ``` + * + * The closure is invoked when {@link resolve()} is called. The closure + * has access to the resolved values of other options through the passed + * {@link Options} instance. + * + * The second parameter passed to the closure is the value of + * the option. + * + * The resolved option value is set to the return value of the closure. + * + * @param string $option The option name + * @param \Closure $normalizer The normalizer + * + * @return $this + * + * @throws UndefinedOptionsException If the option is undefined + * @throws AccessException If called from a lazy option or normalizer + */ + public function setNormalizer($option, \Closure $normalizer) + { + if ($this->locked) { + throw new AccessException('Normalizers cannot be set from a lazy option or normalizer.'); + } + + if (!isset($this->defined[$option])) { + throw new UndefinedOptionsException(sprintf( + 'The option "%s" does not exist. Defined options are: "%s".', + $option, + implode('", "', array_keys($this->defined)) + )); + } + + $this->normalizers[$option] = $normalizer; + + // Make sure the option is processed + unset($this->resolved[$option]); + + return $this; + } + + /** + * Sets allowed values for an option. + * + * Instead of passing values, you may also pass a closures with the + * following signature: + * + * function ($value) { + * // return true or false + * } + * + * The closure receives the value as argument and should return true to + * accept the value and false to reject the value. + * + * @param string $option The option name + * @param mixed $allowedValues One or more acceptable values/closures + * + * @return $this + * + * @throws UndefinedOptionsException If the option is undefined + * @throws AccessException If called from a lazy option or normalizer + */ + public function setAllowedValues($option, $allowedValues) + { + if ($this->locked) { + throw new AccessException('Allowed values cannot be set from a lazy option or normalizer.'); + } + + if (!isset($this->defined[$option])) { + throw new UndefinedOptionsException(sprintf( + 'The option "%s" does not exist. Defined options are: "%s".', + $option, + implode('", "', array_keys($this->defined)) + )); + } + + $this->allowedValues[$option] = is_array($allowedValues) ? $allowedValues : array($allowedValues); + + // Make sure the option is processed + unset($this->resolved[$option]); + + return $this; + } + + /** + * Adds allowed values for an option. + * + * The values are merged with the allowed values defined previously. + * + * Instead of passing values, you may also pass a closures with the + * following signature: + * + * function ($value) { + * // return true or false + * } + * + * The closure receives the value as argument and should return true to + * accept the value and false to reject the value. + * + * @param string $option The option name + * @param mixed $allowedValues One or more acceptable values/closures + * + * @return $this + * + * @throws UndefinedOptionsException If the option is undefined + * @throws AccessException If called from a lazy option or normalizer + */ + public function addAllowedValues($option, $allowedValues) + { + if ($this->locked) { + throw new AccessException('Allowed values cannot be added from a lazy option or normalizer.'); + } + + if (!isset($this->defined[$option])) { + throw new UndefinedOptionsException(sprintf( + 'The option "%s" does not exist. Defined options are: "%s".', + $option, + implode('", "', array_keys($this->defined)) + )); + } + + if (!is_array($allowedValues)) { + $allowedValues = array($allowedValues); + } + + if (!isset($this->allowedValues[$option])) { + $this->allowedValues[$option] = $allowedValues; + } else { + $this->allowedValues[$option] = array_merge($this->allowedValues[$option], $allowedValues); + } + + // Make sure the option is processed + unset($this->resolved[$option]); + + return $this; + } + + /** + * Sets allowed types for an option. + * + * Any type for which a corresponding is_() function exists is + * acceptable. Additionally, fully-qualified class or interface names may + * be passed. + * + * @param string $option The option name + * @param string|string[] $allowedTypes One or more accepted types + * + * @return $this + * + * @throws UndefinedOptionsException If the option is undefined + * @throws AccessException If called from a lazy option or normalizer + */ + public function setAllowedTypes($option, $allowedTypes) + { + if ($this->locked) { + throw new AccessException('Allowed types cannot be set from a lazy option or normalizer.'); + } + + if (!isset($this->defined[$option])) { + throw new UndefinedOptionsException(sprintf( + 'The option "%s" does not exist. Defined options are: "%s".', + $option, + implode('", "', array_keys($this->defined)) + )); + } + + $this->allowedTypes[$option] = (array) $allowedTypes; + + // Make sure the option is processed + unset($this->resolved[$option]); + + return $this; + } + + /** + * Adds allowed types for an option. + * + * The types are merged with the allowed types defined previously. + * + * Any type for which a corresponding is_() function exists is + * acceptable. Additionally, fully-qualified class or interface names may + * be passed. + * + * @param string $option The option name + * @param string|string[] $allowedTypes One or more accepted types + * + * @return $this + * + * @throws UndefinedOptionsException If the option is undefined + * @throws AccessException If called from a lazy option or normalizer + */ + public function addAllowedTypes($option, $allowedTypes) + { + if ($this->locked) { + throw new AccessException('Allowed types cannot be added from a lazy option or normalizer.'); + } + + if (!isset($this->defined[$option])) { + throw new UndefinedOptionsException(sprintf( + 'The option "%s" does not exist. Defined options are: "%s".', + $option, + implode('", "', array_keys($this->defined)) + )); + } + + if (!isset($this->allowedTypes[$option])) { + $this->allowedTypes[$option] = (array) $allowedTypes; + } else { + $this->allowedTypes[$option] = array_merge($this->allowedTypes[$option], (array) $allowedTypes); + } + + // Make sure the option is processed + unset($this->resolved[$option]); + + return $this; + } + + /** + * Removes the option with the given name. + * + * Undefined options are ignored. + * + * @param string|string[] $optionNames One or more option names + * + * @return $this + * + * @throws AccessException If called from a lazy option or normalizer + */ + public function remove($optionNames) + { + if ($this->locked) { + throw new AccessException('Options cannot be removed from a lazy option or normalizer.'); + } + + foreach ((array) $optionNames as $option) { + unset($this->defined[$option], $this->defaults[$option], $this->required[$option], $this->resolved[$option]); + unset($this->lazy[$option], $this->normalizers[$option], $this->allowedTypes[$option], $this->allowedValues[$option]); + } + + return $this; + } + + /** + * Removes all options. + * + * @return $this + * + * @throws AccessException If called from a lazy option or normalizer + */ + public function clear() + { + if ($this->locked) { + throw new AccessException('Options cannot be cleared from a lazy option or normalizer.'); + } + + $this->defined = array(); + $this->defaults = array(); + $this->required = array(); + $this->resolved = array(); + $this->lazy = array(); + $this->normalizers = array(); + $this->allowedTypes = array(); + $this->allowedValues = array(); + + return $this; + } + + /** + * Merges options with the default values stored in the container and + * validates them. + * + * Exceptions are thrown if: + * + * - Undefined options are passed; + * - Required options are missing; + * - Options have invalid types; + * - Options have invalid values. + * + * @param array $options A map of option names to values + * + * @return array The merged and validated options + * + * @throws UndefinedOptionsException If an option name is undefined + * @throws InvalidOptionsException If an option doesn't fulfill the + * specified validation rules + * @throws MissingOptionsException If a required option is missing + * @throws OptionDefinitionException If there is a cyclic dependency between + * lazy options and/or normalizers + * @throws NoSuchOptionException If a lazy option reads an unavailable option + * @throws AccessException If called from a lazy option or normalizer + */ + public function resolve(array $options = array()) + { + if ($this->locked) { + throw new AccessException('Options cannot be resolved from a lazy option or normalizer.'); + } + + // Allow this method to be called multiple times + $clone = clone $this; + + // Make sure that no unknown options are passed + $diff = array_diff_key($options, $clone->defined); + + if (count($diff) > 0) { + ksort($clone->defined); + ksort($diff); + + throw new UndefinedOptionsException(sprintf( + (count($diff) > 1 ? 'The options "%s" do not exist.' : 'The option "%s" does not exist.').' Defined options are: "%s".', + implode('", "', array_keys($diff)), + implode('", "', array_keys($clone->defined)) + )); + } + + // Override options set by the user + foreach ($options as $option => $value) { + $clone->defaults[$option] = $value; + unset($clone->resolved[$option], $clone->lazy[$option]); + } + + // Check whether any required option is missing + $diff = array_diff_key($clone->required, $clone->defaults); + + if (count($diff) > 0) { + ksort($diff); + + throw new MissingOptionsException(sprintf( + count($diff) > 1 ? 'The required options "%s" are missing.' : 'The required option "%s" is missing.', + implode('", "', array_keys($diff)) + )); + } + + // Lock the container + $clone->locked = true; + + // Now process the individual options. Use offsetGet(), which resolves + // the option itself and any options that the option depends on + foreach ($clone->defaults as $option => $_) { + $clone->offsetGet($option); + } + + return $clone->resolved; + } + + /** + * Returns the resolved value of an option. + * + * @param string $option The option name + * + * @return mixed The option value + * + * @throws AccessException If accessing this method outside of + * {@link resolve()} + * @throws NoSuchOptionException If the option is not set + * @throws InvalidOptionsException If the option doesn't fulfill the + * specified validation rules + * @throws OptionDefinitionException If there is a cyclic dependency between + * lazy options and/or normalizers + */ + public function offsetGet($option) + { + if (!$this->locked) { + throw new AccessException('Array access is only supported within closures of lazy options and normalizers.'); + } + + // Shortcut for resolved options + if (array_key_exists($option, $this->resolved)) { + return $this->resolved[$option]; + } + + // Check whether the option is set at all + if (!array_key_exists($option, $this->defaults)) { + if (!isset($this->defined[$option])) { + throw new NoSuchOptionException(sprintf( + 'The option "%s" does not exist. Defined options are: "%s".', + $option, + implode('", "', array_keys($this->defined)) + )); + } + + throw new NoSuchOptionException(sprintf( + 'The optional option "%s" has no value set. You should make sure it is set with "isset" before reading it.', + $option + )); + } + + $value = $this->defaults[$option]; + + // Resolve the option if the default value is lazily evaluated + if (isset($this->lazy[$option])) { + // If the closure is already being called, we have a cyclic + // dependency + if (isset($this->calling[$option])) { + throw new OptionDefinitionException(sprintf( + 'The options "%s" have a cyclic dependency.', + implode('", "', array_keys($this->calling)) + )); + } + + // The following section must be protected from cyclic + // calls. Set $calling for the current $option to detect a cyclic + // dependency + // BEGIN + $this->calling[$option] = true; + try { + foreach ($this->lazy[$option] as $closure) { + $value = $closure($this, $value); + } + } finally { + unset($this->calling[$option]); + } + // END + } + + // Validate the type of the resolved option + if (isset($this->allowedTypes[$option])) { + $valid = false; + $invalidTypes = array(); + + foreach ($this->allowedTypes[$option] as $type) { + $type = isset(self::$typeAliases[$type]) ? self::$typeAliases[$type] : $type; + + if ($valid = $this->verifyTypes($type, $value, $invalidTypes)) { + break; + } + } + + if (!$valid) { + throw new InvalidOptionsException(sprintf( + 'The option "%s" with value %s is expected to be of type '. + '"%s", but is of type "%s".', + $option, + $this->formatValue($value), + implode('" or "', $this->allowedTypes[$option]), + implode('|', array_keys($invalidTypes)) + )); + } + } + + // Validate the value of the resolved option + if (isset($this->allowedValues[$option])) { + $success = false; + $printableAllowedValues = array(); + + foreach ($this->allowedValues[$option] as $allowedValue) { + if ($allowedValue instanceof \Closure) { + if ($allowedValue($value)) { + $success = true; + break; + } + + // Don't include closures in the exception message + continue; + } elseif ($value === $allowedValue) { + $success = true; + break; + } + + $printableAllowedValues[] = $allowedValue; + } + + if (!$success) { + $message = sprintf( + 'The option "%s" with value %s is invalid.', + $option, + $this->formatValue($value) + ); + + if (count($printableAllowedValues) > 0) { + $message .= sprintf( + ' Accepted values are: %s.', + $this->formatValues($printableAllowedValues) + ); + } + + throw new InvalidOptionsException($message); + } + } + + // Normalize the validated option + if (isset($this->normalizers[$option])) { + // If the closure is already being called, we have a cyclic + // dependency + if (isset($this->calling[$option])) { + throw new OptionDefinitionException(sprintf( + 'The options "%s" have a cyclic dependency.', + implode('", "', array_keys($this->calling)) + )); + } + + $normalizer = $this->normalizers[$option]; + + // The following section must be protected from cyclic + // calls. Set $calling for the current $option to detect a cyclic + // dependency + // BEGIN + $this->calling[$option] = true; + try { + $value = $normalizer($this, $value); + } finally { + unset($this->calling[$option]); + } + // END + } + + // Mark as resolved + $this->resolved[$option] = $value; + + return $value; + } + + /** + * @param string $type + * @param mixed $value + * @param array &$invalidTypes + * + * @return bool + */ + private function verifyTypes($type, $value, array &$invalidTypes) + { + if ('[]' === substr($type, -2) && is_array($value)) { + $originalType = $type; + $type = substr($type, 0, -2); + $invalidValues = array_filter( // Filter out valid values, keeping invalid values in the resulting array + $value, + function ($value) use ($type) { + return (function_exists($isFunction = 'is_'.$type) && !$isFunction($value)) || !$value instanceof $type; + } + ); + + if (!$invalidValues) { + return true; + } + + $invalidTypes[$this->formatTypeOf($value, $originalType)] = true; + + return false; + } + + if ((function_exists($isFunction = 'is_'.$type) && $isFunction($value)) || $value instanceof $type) { + return true; + } + + if (!$invalidTypes) { + $invalidTypes[$this->formatTypeOf($value, null)] = true; + } + + return false; + } + + /** + * Returns whether a resolved option with the given name exists. + * + * @param string $option The option name + * + * @return bool Whether the option is set + * + * @throws AccessException If accessing this method outside of {@link resolve()} + * + * @see \ArrayAccess::offsetExists() + */ + public function offsetExists($option) + { + if (!$this->locked) { + throw new AccessException('Array access is only supported within closures of lazy options and normalizers.'); + } + + return array_key_exists($option, $this->defaults); + } + + /** + * Not supported. + * + * @throws AccessException + */ + public function offsetSet($option, $value) + { + throw new AccessException('Setting options via array access is not supported. Use setDefault() instead.'); + } + + /** + * Not supported. + * + * @throws AccessException + */ + public function offsetUnset($option) + { + throw new AccessException('Removing options via array access is not supported. Use remove() instead.'); + } + + /** + * Returns the number of set options. + * + * This may be only a subset of the defined options. + * + * @return int Number of options + * + * @throws AccessException If accessing this method outside of {@link resolve()} + * + * @see \Countable::count() + */ + public function count() + { + if (!$this->locked) { + throw new AccessException('Counting is only supported within closures of lazy options and normalizers.'); + } + + return count($this->defaults); + } + + /** + * Returns a string representation of the type of the value. + * + * This method should be used if you pass the type of a value as + * message parameter to a constraint violation. Note that such + * parameters should usually not be included in messages aimed at + * non-technical people. + * + * @param mixed $value The value to return the type of + * @param string $type + * + * @return string The type of the value + */ + private function formatTypeOf($value, $type) + { + $suffix = ''; + + if ('[]' === substr($type, -2)) { + $suffix = '[]'; + $type = substr($type, 0, -2); + while ('[]' === substr($type, -2)) { + $type = substr($type, 0, -2); + $value = array_shift($value); + if (!is_array($value)) { + break; + } + $suffix .= '[]'; + } + + if (is_array($value)) { + $subTypes = array(); + foreach ($value as $val) { + $subTypes[$this->formatTypeOf($val, null)] = true; + } + + return implode('|', array_keys($subTypes)).$suffix; + } + } + + return (is_object($value) ? get_class($value) : gettype($value)).$suffix; + } + + /** + * Returns a string representation of the value. + * + * This method returns the equivalent PHP tokens for most scalar types + * (i.e. "false" for false, "1" for 1 etc.). Strings are always wrapped + * in double quotes ("). + * + * @param mixed $value The value to format as string + * + * @return string The string representation of the passed value + */ + private function formatValue($value) + { + if (is_object($value)) { + return get_class($value); + } + + if (is_array($value)) { + return 'array'; + } + + if (is_string($value)) { + return '"'.$value.'"'; + } + + if (is_resource($value)) { + return 'resource'; + } + + if (null === $value) { + return 'null'; + } + + if (false === $value) { + return 'false'; + } + + if (true === $value) { + return 'true'; + } + + return (string) $value; + } + + /** + * Returns a string representation of a list of values. + * + * Each of the values is converted to a string using + * {@link formatValue()}. The values are then concatenated with commas. + * + * @param array $values A list of values + * + * @return string The string representation of the value list + * + * @see formatValue() + */ + private function formatValues(array $values) + { + foreach ($values as $key => $value) { + $values[$key] = $this->formatValue($value); + } + + return implode(', ', $values); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/README.md b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/README.md new file mode 100644 index 0000000..245e69b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/README.md @@ -0,0 +1,15 @@ +OptionsResolver Component +========================= + +The OptionsResolver component is `array_replace` on steroids. It allows you to +create an options system with required options, defaults, validation (type, +value), normalization and more. + +Resources +--------- + + * [Documentation](https://symfony.com/doc/current/components/options_resolver.html) + * [Contributing](https://symfony.com/doc/current/contributing/index.html) + * [Report issues](https://github.com/symfony/symfony/issues) and + [send Pull Requests](https://github.com/symfony/symfony/pulls) + in the [main Symfony repository](https://github.com/symfony/symfony) diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Tests/Debug/OptionsResolverIntrospectorTest.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Tests/Debug/OptionsResolverIntrospectorTest.php new file mode 100644 index 0000000..7c4753a --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Tests/Debug/OptionsResolverIntrospectorTest.php @@ -0,0 +1,203 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Tests\Debug; + +use PHPUnit\Framework\TestCase; +use Symfony\Component\OptionsResolver\Debug\OptionsResolverIntrospector; +use Symfony\Component\OptionsResolver\Options; +use Symfony\Component\OptionsResolver\OptionsResolver; + +class OptionsResolverIntrospectorTest extends TestCase +{ + public function testGetDefault() + { + $resolver = new OptionsResolver(); + $resolver->setDefault($option = 'foo', 'bar'); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getDefault($option)); + } + + public function testGetDefaultNull() + { + $resolver = new OptionsResolver(); + $resolver->setDefault($option = 'foo', null); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertNull($debug->getDefault($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\NoConfigurationException + * @expectedExceptionMessage No default value was set for the "foo" option. + */ + public function testGetDefaultThrowsOnNoConfiguredValue() + { + $resolver = new OptionsResolver(); + $resolver->setDefined($option = 'foo'); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getDefault($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + * @expectedExceptionMessage The option "foo" does not exist. + */ + public function testGetDefaultThrowsOnNotDefinedOption() + { + $resolver = new OptionsResolver(); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getDefault('foo')); + } + + public function testGetLazyClosures() + { + $resolver = new OptionsResolver(); + $closures = array(); + $resolver->setDefault($option = 'foo', $closures[] = function (Options $options) {}); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame($closures, $debug->getLazyClosures($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\NoConfigurationException + * @expectedExceptionMessage No lazy closures were set for the "foo" option. + */ + public function testGetLazyClosuresThrowsOnNoConfiguredValue() + { + $resolver = new OptionsResolver(); + $resolver->setDefined($option = 'foo'); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getLazyClosures($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + * @expectedExceptionMessage The option "foo" does not exist. + */ + public function testGetLazyClosuresThrowsOnNotDefinedOption() + { + $resolver = new OptionsResolver(); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getLazyClosures('foo')); + } + + public function testGetAllowedTypes() + { + $resolver = new OptionsResolver(); + $resolver->setDefined($option = 'foo'); + $resolver->setAllowedTypes($option = 'foo', $allowedTypes = array('string', 'bool')); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame($allowedTypes, $debug->getAllowedTypes($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\NoConfigurationException + * @expectedExceptionMessage No allowed types were set for the "foo" option. + */ + public function testGetAllowedTypesThrowsOnNoConfiguredValue() + { + $resolver = new OptionsResolver(); + $resolver->setDefined($option = 'foo'); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getAllowedTypes($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + * @expectedExceptionMessage The option "foo" does not exist. + */ + public function testGetAllowedTypesThrowsOnNotDefinedOption() + { + $resolver = new OptionsResolver(); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getAllowedTypes('foo')); + } + + public function testGetAllowedValues() + { + $resolver = new OptionsResolver(); + $resolver->setDefined($option = 'foo'); + $resolver->setAllowedValues($option = 'foo', $allowedValues = array('bar', 'baz')); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame($allowedValues, $debug->getAllowedValues($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\NoConfigurationException + * @expectedExceptionMessage No allowed values were set for the "foo" option. + */ + public function testGetAllowedValuesThrowsOnNoConfiguredValue() + { + $resolver = new OptionsResolver(); + $resolver->setDefined($option = 'foo'); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getAllowedValues($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + * @expectedExceptionMessage The option "foo" does not exist. + */ + public function testGetAllowedValuesThrowsOnNotDefinedOption() + { + $resolver = new OptionsResolver(); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getAllowedValues('foo')); + } + + public function testGetNormalizer() + { + $resolver = new OptionsResolver(); + $resolver->setDefined($option = 'foo'); + $resolver->setNormalizer($option = 'foo', $normalizer = function () {}); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame($normalizer, $debug->getNormalizer($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\NoConfigurationException + * @expectedExceptionMessage No normalizer was set for the "foo" option. + */ + public function testGetNormalizerThrowsOnNoConfiguredValue() + { + $resolver = new OptionsResolver(); + $resolver->setDefined($option = 'foo'); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getNormalizer($option)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + * @expectedExceptionMessage The option "foo" does not exist. + */ + public function testGetNormalizerThrowsOnNotDefinedOption() + { + $resolver = new OptionsResolver(); + + $debug = new OptionsResolverIntrospector($resolver); + $this->assertSame('bar', $debug->getNormalizer('foo')); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Tests/OptionsResolverTest.php b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Tests/OptionsResolverTest.php new file mode 100644 index 0000000..b95e039 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/Tests/OptionsResolverTest.php @@ -0,0 +1,1644 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Symfony\Component\OptionsResolver\Tests; + +use PHPUnit\Framework\Assert; +use PHPUnit\Framework\TestCase; +use Symfony\Component\OptionsResolver\Exception\InvalidOptionsException; +use Symfony\Component\OptionsResolver\Options; +use Symfony\Component\OptionsResolver\OptionsResolver; + +class OptionsResolverTest extends TestCase +{ + /** + * @var OptionsResolver + */ + private $resolver; + + protected function setUp() + { + $this->resolver = new OptionsResolver(); + } + + //////////////////////////////////////////////////////////////////////////// + // resolve() + //////////////////////////////////////////////////////////////////////////// + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + * @expectedExceptionMessage The option "foo" does not exist. Defined options are: "a", "z". + */ + public function testResolveFailsIfNonExistingOption() + { + $this->resolver->setDefault('z', '1'); + $this->resolver->setDefault('a', '2'); + + $this->resolver->resolve(array('foo' => 'bar')); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + * @expectedExceptionMessage The options "baz", "foo", "ping" do not exist. Defined options are: "a", "z". + */ + public function testResolveFailsIfMultipleNonExistingOptions() + { + $this->resolver->setDefault('z', '1'); + $this->resolver->setDefault('a', '2'); + + $this->resolver->resolve(array('ping' => 'pong', 'foo' => 'bar', 'baz' => 'bam')); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testResolveFailsFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->resolve(array()); + }); + + $this->resolver->resolve(); + } + + //////////////////////////////////////////////////////////////////////////// + // setDefault()/hasDefault() + //////////////////////////////////////////////////////////////////////////// + + public function testSetDefaultReturnsThis() + { + $this->assertSame($this->resolver, $this->resolver->setDefault('foo', 'bar')); + } + + public function testSetDefault() + { + $this->resolver->setDefault('one', '1'); + $this->resolver->setDefault('two', '20'); + + $this->assertEquals(array( + 'one' => '1', + 'two' => '20', + ), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfSetDefaultFromLazyOption() + { + $this->resolver->setDefault('lazy', function (Options $options) { + $options->setDefault('default', 42); + }); + + $this->resolver->resolve(); + } + + public function testHasDefault() + { + $this->assertFalse($this->resolver->hasDefault('foo')); + $this->resolver->setDefault('foo', 42); + $this->assertTrue($this->resolver->hasDefault('foo')); + } + + public function testHasDefaultWithNullValue() + { + $this->assertFalse($this->resolver->hasDefault('foo')); + $this->resolver->setDefault('foo', null); + $this->assertTrue($this->resolver->hasDefault('foo')); + } + + //////////////////////////////////////////////////////////////////////////// + // lazy setDefault() + //////////////////////////////////////////////////////////////////////////// + + public function testSetLazyReturnsThis() + { + $this->assertSame($this->resolver, $this->resolver->setDefault('foo', function (Options $options) {})); + } + + public function testSetLazyClosure() + { + $this->resolver->setDefault('foo', function (Options $options) { + return 'lazy'; + }); + + $this->assertEquals(array('foo' => 'lazy'), $this->resolver->resolve()); + } + + public function testClosureWithoutTypeHintNotInvoked() + { + $closure = function ($options) { + Assert::fail('Should not be called'); + }; + + $this->resolver->setDefault('foo', $closure); + + $this->assertSame(array('foo' => $closure), $this->resolver->resolve()); + } + + public function testClosureWithoutParametersNotInvoked() + { + $closure = function () { + Assert::fail('Should not be called'); + }; + + $this->resolver->setDefault('foo', $closure); + + $this->assertSame(array('foo' => $closure), $this->resolver->resolve()); + } + + public function testAccessPreviousDefaultValue() + { + // defined by superclass + $this->resolver->setDefault('foo', 'bar'); + + // defined by subclass + $this->resolver->setDefault('foo', function (Options $options, $previousValue) { + Assert::assertEquals('bar', $previousValue); + + return 'lazy'; + }); + + $this->assertEquals(array('foo' => 'lazy'), $this->resolver->resolve()); + } + + public function testAccessPreviousLazyDefaultValue() + { + // defined by superclass + $this->resolver->setDefault('foo', function (Options $options) { + return 'bar'; + }); + + // defined by subclass + $this->resolver->setDefault('foo', function (Options $options, $previousValue) { + Assert::assertEquals('bar', $previousValue); + + return 'lazy'; + }); + + $this->assertEquals(array('foo' => 'lazy'), $this->resolver->resolve()); + } + + public function testPreviousValueIsNotEvaluatedIfNoSecondArgument() + { + // defined by superclass + $this->resolver->setDefault('foo', function () { + Assert::fail('Should not be called'); + }); + + // defined by subclass, no $previousValue argument defined! + $this->resolver->setDefault('foo', function (Options $options) { + return 'lazy'; + }); + + $this->assertEquals(array('foo' => 'lazy'), $this->resolver->resolve()); + } + + public function testOverwrittenLazyOptionNotEvaluated() + { + $this->resolver->setDefault('foo', function (Options $options) { + Assert::fail('Should not be called'); + }); + + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testInvokeEachLazyOptionOnlyOnce() + { + $calls = 0; + + $this->resolver->setDefault('lazy1', function (Options $options) use (&$calls) { + Assert::assertSame(1, ++$calls); + + $options['lazy2']; + }); + + $this->resolver->setDefault('lazy2', function (Options $options) use (&$calls) { + Assert::assertSame(2, ++$calls); + }); + + $this->resolver->resolve(); + + $this->assertSame(2, $calls); + } + + //////////////////////////////////////////////////////////////////////////// + // setRequired()/isRequired()/getRequiredOptions() + //////////////////////////////////////////////////////////////////////////// + + public function testSetRequiredReturnsThis() + { + $this->assertSame($this->resolver, $this->resolver->setRequired('foo')); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfSetRequiredFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->setRequired('bar'); + }); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\MissingOptionsException + */ + public function testResolveFailsIfRequiredOptionMissing() + { + $this->resolver->setRequired('foo'); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfRequiredOptionSet() + { + $this->resolver->setRequired('foo'); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertNotEmpty($this->resolver->resolve()); + } + + public function testResolveSucceedsIfRequiredOptionPassed() + { + $this->resolver->setRequired('foo'); + + $this->assertNotEmpty($this->resolver->resolve(array('foo' => 'bar'))); + } + + public function testIsRequired() + { + $this->assertFalse($this->resolver->isRequired('foo')); + $this->resolver->setRequired('foo'); + $this->assertTrue($this->resolver->isRequired('foo')); + } + + public function testRequiredIfSetBefore() + { + $this->assertFalse($this->resolver->isRequired('foo')); + + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setRequired('foo'); + + $this->assertTrue($this->resolver->isRequired('foo')); + } + + public function testStillRequiredAfterSet() + { + $this->assertFalse($this->resolver->isRequired('foo')); + + $this->resolver->setRequired('foo'); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertTrue($this->resolver->isRequired('foo')); + } + + public function testIsNotRequiredAfterRemove() + { + $this->assertFalse($this->resolver->isRequired('foo')); + $this->resolver->setRequired('foo'); + $this->resolver->remove('foo'); + $this->assertFalse($this->resolver->isRequired('foo')); + } + + public function testIsNotRequiredAfterClear() + { + $this->assertFalse($this->resolver->isRequired('foo')); + $this->resolver->setRequired('foo'); + $this->resolver->clear(); + $this->assertFalse($this->resolver->isRequired('foo')); + } + + public function testGetRequiredOptions() + { + $this->resolver->setRequired(array('foo', 'bar')); + $this->resolver->setDefault('bam', 'baz'); + $this->resolver->setDefault('foo', 'boo'); + + $this->assertSame(array('foo', 'bar'), $this->resolver->getRequiredOptions()); + } + + //////////////////////////////////////////////////////////////////////////// + // isMissing()/getMissingOptions() + //////////////////////////////////////////////////////////////////////////// + + public function testIsMissingIfNotSet() + { + $this->assertFalse($this->resolver->isMissing('foo')); + $this->resolver->setRequired('foo'); + $this->assertTrue($this->resolver->isMissing('foo')); + } + + public function testIsNotMissingIfSet() + { + $this->resolver->setDefault('foo', 'bar'); + + $this->assertFalse($this->resolver->isMissing('foo')); + $this->resolver->setRequired('foo'); + $this->assertFalse($this->resolver->isMissing('foo')); + } + + public function testIsNotMissingAfterRemove() + { + $this->resolver->setRequired('foo'); + $this->resolver->remove('foo'); + $this->assertFalse($this->resolver->isMissing('foo')); + } + + public function testIsNotMissingAfterClear() + { + $this->resolver->setRequired('foo'); + $this->resolver->clear(); + $this->assertFalse($this->resolver->isRequired('foo')); + } + + public function testGetMissingOptions() + { + $this->resolver->setRequired(array('foo', 'bar')); + $this->resolver->setDefault('bam', 'baz'); + $this->resolver->setDefault('foo', 'boo'); + + $this->assertSame(array('bar'), $this->resolver->getMissingOptions()); + } + + //////////////////////////////////////////////////////////////////////////// + // setDefined()/isDefined()/getDefinedOptions() + //////////////////////////////////////////////////////////////////////////// + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfSetDefinedFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->setDefined('bar'); + }); + + $this->resolver->resolve(); + } + + public function testDefinedOptionsNotIncludedInResolvedOptions() + { + $this->resolver->setDefined('foo'); + + $this->assertSame(array(), $this->resolver->resolve()); + } + + public function testDefinedOptionsIncludedIfDefaultSetBefore() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setDefined('foo'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testDefinedOptionsIncludedIfDefaultSetAfter() + { + $this->resolver->setDefined('foo'); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testDefinedOptionsIncludedIfPassedToResolve() + { + $this->resolver->setDefined('foo'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve(array('foo' => 'bar'))); + } + + public function testIsDefined() + { + $this->assertFalse($this->resolver->isDefined('foo')); + $this->resolver->setDefined('foo'); + $this->assertTrue($this->resolver->isDefined('foo')); + } + + public function testLazyOptionsAreDefined() + { + $this->assertFalse($this->resolver->isDefined('foo')); + $this->resolver->setDefault('foo', function (Options $options) {}); + $this->assertTrue($this->resolver->isDefined('foo')); + } + + public function testRequiredOptionsAreDefined() + { + $this->assertFalse($this->resolver->isDefined('foo')); + $this->resolver->setRequired('foo'); + $this->assertTrue($this->resolver->isDefined('foo')); + } + + public function testSetOptionsAreDefined() + { + $this->assertFalse($this->resolver->isDefined('foo')); + $this->resolver->setDefault('foo', 'bar'); + $this->assertTrue($this->resolver->isDefined('foo')); + } + + public function testGetDefinedOptions() + { + $this->resolver->setDefined(array('foo', 'bar')); + $this->resolver->setDefault('baz', 'bam'); + $this->resolver->setRequired('boo'); + + $this->assertSame(array('foo', 'bar', 'baz', 'boo'), $this->resolver->getDefinedOptions()); + } + + public function testRemovedOptionsAreNotDefined() + { + $this->assertFalse($this->resolver->isDefined('foo')); + $this->resolver->setDefined('foo'); + $this->assertTrue($this->resolver->isDefined('foo')); + $this->resolver->remove('foo'); + $this->assertFalse($this->resolver->isDefined('foo')); + } + + public function testClearedOptionsAreNotDefined() + { + $this->assertFalse($this->resolver->isDefined('foo')); + $this->resolver->setDefined('foo'); + $this->assertTrue($this->resolver->isDefined('foo')); + $this->resolver->clear(); + $this->assertFalse($this->resolver->isDefined('foo')); + } + + //////////////////////////////////////////////////////////////////////////// + // setAllowedTypes() + //////////////////////////////////////////////////////////////////////////// + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + */ + public function testSetAllowedTypesFailsIfUnknownOption() + { + $this->resolver->setAllowedTypes('foo', 'string'); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfSetAllowedTypesFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->setAllowedTypes('bar', 'string'); + }); + + $this->resolver->setDefault('bar', 'baz'); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + * @expectedExceptionMessage The option "foo" with value array is expected to be of type "int[]", but is of type "DateTime[]". + */ + public function testResolveFailsIfInvalidTypedArray() + { + $this->resolver->setDefined('foo'); + $this->resolver->setAllowedTypes('foo', 'int[]'); + + $this->resolver->resolve(array('foo' => array(new \DateTime()))); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + * @expectedExceptionMessage The option "foo" with value "bar" is expected to be of type "int[]", but is of type "string". + */ + public function testResolveFailsWithNonArray() + { + $this->resolver->setDefined('foo'); + $this->resolver->setAllowedTypes('foo', 'int[]'); + + $this->resolver->resolve(array('foo' => 'bar')); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + * @expectedExceptionMessage The option "foo" with value array is expected to be of type "int[]", but is of type "integer|stdClass|array|DateTime[]". + */ + public function testResolveFailsIfTypedArrayContainsInvalidTypes() + { + $this->resolver->setDefined('foo'); + $this->resolver->setAllowedTypes('foo', 'int[]'); + $values = range(1, 5); + $values[] = new \stdClass(); + $values[] = array(); + $values[] = new \DateTime(); + $values[] = 123; + + $this->resolver->resolve(array('foo' => $values)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + * @expectedExceptionMessage The option "foo" with value array is expected to be of type "int[][]", but is of type "double[][]". + */ + public function testResolveFailsWithCorrectLevelsButWrongScalar() + { + $this->resolver->setDefined('foo'); + $this->resolver->setAllowedTypes('foo', 'int[][]'); + + $this->resolver->resolve( + array( + 'foo' => array( + array(1.2), + ), + ) + ); + } + + /** + * @dataProvider provideInvalidTypes + */ + public function testResolveFailsIfInvalidType($actualType, $allowedType, $exceptionMessage) + { + $this->resolver->setDefined('option'); + $this->resolver->setAllowedTypes('option', $allowedType); + + if (method_exists($this, 'expectException')) { + $this->expectException('Symfony\Component\OptionsResolver\Exception\InvalidOptionsException'); + $this->expectExceptionMessage($exceptionMessage); + } else { + $this->setExpectedException('Symfony\Component\OptionsResolver\Exception\InvalidOptionsException', $exceptionMessage); + } + + $this->resolver->resolve(array('option' => $actualType)); + } + + public function provideInvalidTypes() + { + return array( + array(true, 'string', 'The option "option" with value true is expected to be of type "string", but is of type "boolean".'), + array(false, 'string', 'The option "option" with value false is expected to be of type "string", but is of type "boolean".'), + array(fopen(__FILE__, 'r'), 'string', 'The option "option" with value resource is expected to be of type "string", but is of type "resource".'), + array(array(), 'string', 'The option "option" with value array is expected to be of type "string", but is of type "array".'), + array(new OptionsResolver(), 'string', 'The option "option" with value Symfony\Component\OptionsResolver\OptionsResolver is expected to be of type "string", but is of type "Symfony\Component\OptionsResolver\OptionsResolver".'), + array(42, 'string', 'The option "option" with value 42 is expected to be of type "string", but is of type "integer".'), + array(null, 'string', 'The option "option" with value null is expected to be of type "string", but is of type "NULL".'), + array('bar', '\stdClass', 'The option "option" with value "bar" is expected to be of type "\stdClass", but is of type "string".'), + ); + } + + public function testResolveSucceedsIfValidType() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedTypes('foo', 'string'); + + $this->assertNotEmpty($this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + * @expectedExceptionMessage The option "foo" with value 42 is expected to be of type "string" or "bool", but is of type "integer". + */ + public function testResolveFailsIfInvalidTypeMultiple() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->setAllowedTypes('foo', array('string', 'bool')); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfValidTypeMultiple() + { + $this->resolver->setDefault('foo', true); + $this->resolver->setAllowedTypes('foo', array('string', 'bool')); + + $this->assertNotEmpty($this->resolver->resolve()); + } + + public function testResolveSucceedsIfInstanceOfClass() + { + $this->resolver->setDefault('foo', new \stdClass()); + $this->resolver->setAllowedTypes('foo', '\stdClass'); + + $this->assertNotEmpty($this->resolver->resolve()); + } + + public function testResolveSucceedsIfTypedArray() + { + $this->resolver->setDefault('foo', null); + $this->resolver->setAllowedTypes('foo', array('null', 'DateTime[]')); + + $data = array( + 'foo' => array( + new \DateTime(), + new \DateTime(), + ), + ); + $result = $this->resolver->resolve($data); + $this->assertEquals($data, $result); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testResolveFailsIfNotInstanceOfClass() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedTypes('foo', '\stdClass'); + + $this->resolver->resolve(); + } + + //////////////////////////////////////////////////////////////////////////// + // addAllowedTypes() + //////////////////////////////////////////////////////////////////////////// + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + */ + public function testAddAllowedTypesFailsIfUnknownOption() + { + $this->resolver->addAllowedTypes('foo', 'string'); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfAddAllowedTypesFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->addAllowedTypes('bar', 'string'); + }); + + $this->resolver->setDefault('bar', 'baz'); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testResolveFailsIfInvalidAddedType() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->addAllowedTypes('foo', 'string'); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfValidAddedType() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->addAllowedTypes('foo', 'string'); + + $this->assertNotEmpty($this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testResolveFailsIfInvalidAddedTypeMultiple() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->addAllowedTypes('foo', array('string', 'bool')); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfValidAddedTypeMultiple() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->addAllowedTypes('foo', array('string', 'bool')); + + $this->assertNotEmpty($this->resolver->resolve()); + } + + public function testAddAllowedTypesDoesNotOverwrite() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedTypes('foo', 'string'); + $this->resolver->addAllowedTypes('foo', 'bool'); + + $this->resolver->setDefault('foo', 'bar'); + + $this->assertNotEmpty($this->resolver->resolve()); + } + + public function testAddAllowedTypesDoesNotOverwrite2() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedTypes('foo', 'string'); + $this->resolver->addAllowedTypes('foo', 'bool'); + + $this->resolver->setDefault('foo', false); + + $this->assertNotEmpty($this->resolver->resolve()); + } + + //////////////////////////////////////////////////////////////////////////// + // setAllowedValues() + //////////////////////////////////////////////////////////////////////////// + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + */ + public function testSetAllowedValuesFailsIfUnknownOption() + { + $this->resolver->setAllowedValues('foo', 'bar'); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfSetAllowedValuesFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->setAllowedValues('bar', 'baz'); + }); + + $this->resolver->setDefault('bar', 'baz'); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + * @expectedExceptionMessage The option "foo" with value 42 is invalid. Accepted values are: "bar". + */ + public function testResolveFailsIfInvalidValue() + { + $this->resolver->setDefined('foo'); + $this->resolver->setAllowedValues('foo', 'bar'); + + $this->resolver->resolve(array('foo' => 42)); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + * @expectedExceptionMessage The option "foo" with value null is invalid. Accepted values are: "bar". + */ + public function testResolveFailsIfInvalidValueIsNull() + { + $this->resolver->setDefault('foo', null); + $this->resolver->setAllowedValues('foo', 'bar'); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testResolveFailsIfInvalidValueStrict() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->setAllowedValues('foo', '42'); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfValidValue() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedValues('foo', 'bar'); + + $this->assertEquals(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testResolveSucceedsIfValidValueIsNull() + { + $this->resolver->setDefault('foo', null); + $this->resolver->setAllowedValues('foo', null); + + $this->assertEquals(array('foo' => null), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + * @expectedExceptionMessage The option "foo" with value 42 is invalid. Accepted values are: "bar", false, null. + */ + public function testResolveFailsIfInvalidValueMultiple() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->setAllowedValues('foo', array('bar', false, null)); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfValidValueMultiple() + { + $this->resolver->setDefault('foo', 'baz'); + $this->resolver->setAllowedValues('foo', array('bar', 'baz')); + + $this->assertEquals(array('foo' => 'baz'), $this->resolver->resolve()); + } + + public function testResolveFailsIfClosureReturnsFalse() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->setAllowedValues('foo', function ($value) use (&$passedValue) { + $passedValue = $value; + + return false; + }); + + try { + $this->resolver->resolve(); + $this->fail('Should fail'); + } catch (InvalidOptionsException $e) { + } + + $this->assertSame(42, $passedValue); + } + + public function testResolveSucceedsIfClosureReturnsTrue() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedValues('foo', function ($value) use (&$passedValue) { + $passedValue = $value; + + return true; + }); + + $this->assertEquals(array('foo' => 'bar'), $this->resolver->resolve()); + $this->assertSame('bar', $passedValue); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testResolveFailsIfAllClosuresReturnFalse() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->setAllowedValues('foo', array( + function () { return false; }, + function () { return false; }, + function () { return false; }, + )); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfAnyClosureReturnsTrue() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedValues('foo', array( + function () { return false; }, + function () { return true; }, + function () { return false; }, + )); + + $this->assertEquals(array('foo' => 'bar'), $this->resolver->resolve()); + } + + //////////////////////////////////////////////////////////////////////////// + // addAllowedValues() + //////////////////////////////////////////////////////////////////////////// + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + */ + public function testAddAllowedValuesFailsIfUnknownOption() + { + $this->resolver->addAllowedValues('foo', 'bar'); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfAddAllowedValuesFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->addAllowedValues('bar', 'baz'); + }); + + $this->resolver->setDefault('bar', 'baz'); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testResolveFailsIfInvalidAddedValue() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->addAllowedValues('foo', 'bar'); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfValidAddedValue() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->addAllowedValues('foo', 'bar'); + + $this->assertEquals(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testResolveSucceedsIfValidAddedValueIsNull() + { + $this->resolver->setDefault('foo', null); + $this->resolver->addAllowedValues('foo', null); + + $this->assertEquals(array('foo' => null), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testResolveFailsIfInvalidAddedValueMultiple() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->addAllowedValues('foo', array('bar', 'baz')); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfValidAddedValueMultiple() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->addAllowedValues('foo', array('bar', 'baz')); + + $this->assertEquals(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testAddAllowedValuesDoesNotOverwrite() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedValues('foo', 'bar'); + $this->resolver->addAllowedValues('foo', 'baz'); + + $this->assertEquals(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testAddAllowedValuesDoesNotOverwrite2() + { + $this->resolver->setDefault('foo', 'baz'); + $this->resolver->setAllowedValues('foo', 'bar'); + $this->resolver->addAllowedValues('foo', 'baz'); + + $this->assertEquals(array('foo' => 'baz'), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testResolveFailsIfAllAddedClosuresReturnFalse() + { + $this->resolver->setDefault('foo', 42); + $this->resolver->setAllowedValues('foo', function () { return false; }); + $this->resolver->addAllowedValues('foo', function () { return false; }); + + $this->resolver->resolve(); + } + + public function testResolveSucceedsIfAnyAddedClosureReturnsTrue() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedValues('foo', function () { return false; }); + $this->resolver->addAllowedValues('foo', function () { return true; }); + + $this->assertEquals(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testResolveSucceedsIfAnyAddedClosureReturnsTrue2() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedValues('foo', function () { return true; }); + $this->resolver->addAllowedValues('foo', function () { return false; }); + + $this->assertEquals(array('foo' => 'bar'), $this->resolver->resolve()); + } + + //////////////////////////////////////////////////////////////////////////// + // setNormalizer() + //////////////////////////////////////////////////////////////////////////// + + public function testSetNormalizerReturnsThis() + { + $this->resolver->setDefault('foo', 'bar'); + $this->assertSame($this->resolver, $this->resolver->setNormalizer('foo', function () {})); + } + + public function testSetNormalizerClosure() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setNormalizer('foo', function () { + return 'normalized'; + }); + + $this->assertEquals(array('foo' => 'normalized'), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\UndefinedOptionsException + */ + public function testSetNormalizerFailsIfUnknownOption() + { + $this->resolver->setNormalizer('foo', function () {}); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfSetNormalizerFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->setNormalizer('foo', function () {}); + }); + + $this->resolver->setDefault('bar', 'baz'); + + $this->resolver->resolve(); + } + + public function testNormalizerReceivesSetOption() + { + $this->resolver->setDefault('foo', 'bar'); + + $this->resolver->setNormalizer('foo', function (Options $options, $value) { + return 'normalized['.$value.']'; + }); + + $this->assertEquals(array('foo' => 'normalized[bar]'), $this->resolver->resolve()); + } + + public function testNormalizerReceivesPassedOption() + { + $this->resolver->setDefault('foo', 'bar'); + + $this->resolver->setNormalizer('foo', function (Options $options, $value) { + return 'normalized['.$value.']'; + }); + + $resolved = $this->resolver->resolve(array('foo' => 'baz')); + + $this->assertEquals(array('foo' => 'normalized[baz]'), $resolved); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testValidateTypeBeforeNormalization() + { + $this->resolver->setDefault('foo', 'bar'); + + $this->resolver->setAllowedTypes('foo', 'int'); + + $this->resolver->setNormalizer('foo', function () { + Assert::fail('Should not be called.'); + }); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException + */ + public function testValidateValueBeforeNormalization() + { + $this->resolver->setDefault('foo', 'bar'); + + $this->resolver->setAllowedValues('foo', 'baz'); + + $this->resolver->setNormalizer('foo', function () { + Assert::fail('Should not be called.'); + }); + + $this->resolver->resolve(); + } + + public function testNormalizerCanAccessOtherOptions() + { + $this->resolver->setDefault('default', 'bar'); + $this->resolver->setDefault('norm', 'baz'); + + $this->resolver->setNormalizer('norm', function (Options $options) { + /* @var TestCase $test */ + Assert::assertSame('bar', $options['default']); + + return 'normalized'; + }); + + $this->assertEquals(array( + 'default' => 'bar', + 'norm' => 'normalized', + ), $this->resolver->resolve()); + } + + public function testNormalizerCanAccessLazyOptions() + { + $this->resolver->setDefault('lazy', function (Options $options) { + return 'bar'; + }); + $this->resolver->setDefault('norm', 'baz'); + + $this->resolver->setNormalizer('norm', function (Options $options) { + /* @var TestCase $test */ + Assert::assertEquals('bar', $options['lazy']); + + return 'normalized'; + }); + + $this->assertEquals(array( + 'lazy' => 'bar', + 'norm' => 'normalized', + ), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\OptionDefinitionException + */ + public function testFailIfCyclicDependencyBetweenNormalizers() + { + $this->resolver->setDefault('norm1', 'bar'); + $this->resolver->setDefault('norm2', 'baz'); + + $this->resolver->setNormalizer('norm1', function (Options $options) { + $options['norm2']; + }); + + $this->resolver->setNormalizer('norm2', function (Options $options) { + $options['norm1']; + }); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\OptionDefinitionException + */ + public function testFailIfCyclicDependencyBetweenNormalizerAndLazyOption() + { + $this->resolver->setDefault('lazy', function (Options $options) { + $options['norm']; + }); + + $this->resolver->setDefault('norm', 'baz'); + + $this->resolver->setNormalizer('norm', function (Options $options) { + $options['lazy']; + }); + + $this->resolver->resolve(); + } + + public function testCaughtExceptionFromNormalizerDoesNotCrashOptionResolver() + { + $throw = true; + + $this->resolver->setDefaults(array('catcher' => null, 'thrower' => null)); + + $this->resolver->setNormalizer('catcher', function (Options $options) { + try { + return $options['thrower']; + } catch (\Exception $e) { + return false; + } + }); + + $this->resolver->setNormalizer('thrower', function () use (&$throw) { + if ($throw) { + $throw = false; + throw new \UnexpectedValueException('throwing'); + } + + return true; + }); + + $this->assertSame(array('catcher' => false, 'thrower' => true), $this->resolver->resolve()); + } + + public function testCaughtExceptionFromLazyDoesNotCrashOptionResolver() + { + $throw = true; + + $this->resolver->setDefault('catcher', function (Options $options) { + try { + return $options['thrower']; + } catch (\Exception $e) { + return false; + } + }); + + $this->resolver->setDefault('thrower', function (Options $options) use (&$throw) { + if ($throw) { + $throw = false; + throw new \UnexpectedValueException('throwing'); + } + + return true; + }); + + $this->assertSame(array('catcher' => false, 'thrower' => true), $this->resolver->resolve()); + } + + public function testInvokeEachNormalizerOnlyOnce() + { + $calls = 0; + + $this->resolver->setDefault('norm1', 'bar'); + $this->resolver->setDefault('norm2', 'baz'); + + $this->resolver->setNormalizer('norm1', function ($options) use (&$calls) { + Assert::assertSame(1, ++$calls); + + $options['norm2']; + }); + $this->resolver->setNormalizer('norm2', function () use (&$calls) { + Assert::assertSame(2, ++$calls); + }); + + $this->resolver->resolve(); + + $this->assertSame(2, $calls); + } + + public function testNormalizerNotCalledForUnsetOptions() + { + $this->resolver->setDefined('norm'); + + $this->resolver->setNormalizer('norm', function () { + Assert::fail('Should not be called.'); + }); + + $this->assertEmpty($this->resolver->resolve()); + } + + //////////////////////////////////////////////////////////////////////////// + // setDefaults() + //////////////////////////////////////////////////////////////////////////// + + public function testSetDefaultsReturnsThis() + { + $this->assertSame($this->resolver, $this->resolver->setDefaults(array('foo', 'bar'))); + } + + public function testSetDefaults() + { + $this->resolver->setDefault('one', '1'); + $this->resolver->setDefault('two', 'bar'); + + $this->resolver->setDefaults(array( + 'two' => '2', + 'three' => '3', + )); + + $this->assertEquals(array( + 'one' => '1', + 'two' => '2', + 'three' => '3', + ), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfSetDefaultsFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->setDefaults(array('two' => '2')); + }); + + $this->resolver->resolve(); + } + + //////////////////////////////////////////////////////////////////////////// + // remove() + //////////////////////////////////////////////////////////////////////////// + + public function testRemoveReturnsThis() + { + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame($this->resolver, $this->resolver->remove('foo')); + } + + public function testRemoveSingleOption() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setDefault('baz', 'boo'); + $this->resolver->remove('foo'); + + $this->assertSame(array('baz' => 'boo'), $this->resolver->resolve()); + } + + public function testRemoveMultipleOptions() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setDefault('baz', 'boo'); + $this->resolver->setDefault('doo', 'dam'); + + $this->resolver->remove(array('foo', 'doo')); + + $this->assertSame(array('baz' => 'boo'), $this->resolver->resolve()); + } + + public function testRemoveLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + return 'lazy'; + }); + $this->resolver->remove('foo'); + + $this->assertSame(array(), $this->resolver->resolve()); + } + + public function testRemoveNormalizer() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setNormalizer('foo', function (Options $options, $value) { + return 'normalized'; + }); + $this->resolver->remove('foo'); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testRemoveAllowedTypes() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedTypes('foo', 'int'); + $this->resolver->remove('foo'); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testRemoveAllowedValues() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedValues('foo', array('baz', 'boo')); + $this->resolver->remove('foo'); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfRemoveFromLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->remove('bar'); + }); + + $this->resolver->setDefault('bar', 'baz'); + + $this->resolver->resolve(); + } + + public function testRemoveUnknownOptionIgnored() + { + $this->assertNotNull($this->resolver->remove('foo')); + } + + //////////////////////////////////////////////////////////////////////////// + // clear() + //////////////////////////////////////////////////////////////////////////// + + public function testClearReturnsThis() + { + $this->assertSame($this->resolver, $this->resolver->clear()); + } + + public function testClearRemovesAllOptions() + { + $this->resolver->setDefault('one', 1); + $this->resolver->setDefault('two', 2); + + $this->resolver->clear(); + + $this->assertEmpty($this->resolver->resolve()); + } + + public function testClearLazyOption() + { + $this->resolver->setDefault('foo', function (Options $options) { + return 'lazy'; + }); + $this->resolver->clear(); + + $this->assertSame(array(), $this->resolver->resolve()); + } + + public function testClearNormalizer() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setNormalizer('foo', function (Options $options, $value) { + return 'normalized'; + }); + $this->resolver->clear(); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testClearAllowedTypes() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedTypes('foo', 'int'); + $this->resolver->clear(); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + public function testClearAllowedValues() + { + $this->resolver->setDefault('foo', 'bar'); + $this->resolver->setAllowedValues('foo', 'baz'); + $this->resolver->clear(); + $this->resolver->setDefault('foo', 'bar'); + + $this->assertSame(array('foo' => 'bar'), $this->resolver->resolve()); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testFailIfClearFromLazyption() + { + $this->resolver->setDefault('foo', function (Options $options) { + $options->clear(); + }); + + $this->resolver->setDefault('bar', 'baz'); + + $this->resolver->resolve(); + } + + public function testClearOptionAndNormalizer() + { + $this->resolver->setDefault('foo1', 'bar'); + $this->resolver->setNormalizer('foo1', function (Options $options) { + return ''; + }); + $this->resolver->setDefault('foo2', 'bar'); + $this->resolver->setNormalizer('foo2', function (Options $options) { + return ''; + }); + + $this->resolver->clear(); + $this->assertEmpty($this->resolver->resolve()); + } + + //////////////////////////////////////////////////////////////////////////// + // ArrayAccess + //////////////////////////////////////////////////////////////////////////// + + public function testArrayAccess() + { + $this->resolver->setDefault('default1', 0); + $this->resolver->setDefault('default2', 1); + $this->resolver->setRequired('required'); + $this->resolver->setDefined('defined'); + $this->resolver->setDefault('lazy1', function (Options $options) { + return 'lazy'; + }); + + $this->resolver->setDefault('lazy2', function (Options $options) { + Assert::assertTrue(isset($options['default1'])); + Assert::assertTrue(isset($options['default2'])); + Assert::assertTrue(isset($options['required'])); + Assert::assertTrue(isset($options['lazy1'])); + Assert::assertTrue(isset($options['lazy2'])); + Assert::assertFalse(isset($options['defined'])); + + Assert::assertSame(0, $options['default1']); + Assert::assertSame(42, $options['default2']); + Assert::assertSame('value', $options['required']); + Assert::assertSame('lazy', $options['lazy1']); + + // Obviously $options['lazy'] and $options['defined'] cannot be + // accessed + }); + + $this->resolver->resolve(array('default2' => 42, 'required' => 'value')); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testArrayAccessGetFailsOutsideResolve() + { + $this->resolver->setDefault('default', 0); + + $this->resolver['default']; + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testArrayAccessExistsFailsOutsideResolve() + { + $this->resolver->setDefault('default', 0); + + isset($this->resolver['default']); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testArrayAccessSetNotSupported() + { + $this->resolver['default'] = 0; + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testArrayAccessUnsetNotSupported() + { + $this->resolver->setDefault('default', 0); + + unset($this->resolver['default']); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\NoSuchOptionException + * @expectedExceptionMessage The option "undefined" does not exist. Defined options are: "foo", "lazy". + */ + public function testFailIfGetNonExisting() + { + $this->resolver->setDefault('foo', 'bar'); + + $this->resolver->setDefault('lazy', function (Options $options) { + $options['undefined']; + }); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\NoSuchOptionException + * @expectedExceptionMessage The optional option "defined" has no value set. You should make sure it is set with "isset" before reading it. + */ + public function testFailIfGetDefinedButUnset() + { + $this->resolver->setDefined('defined'); + + $this->resolver->setDefault('lazy', function (Options $options) { + $options['defined']; + }); + + $this->resolver->resolve(); + } + + /** + * @expectedException \Symfony\Component\OptionsResolver\Exception\OptionDefinitionException + */ + public function testFailIfCyclicDependency() + { + $this->resolver->setDefault('lazy1', function (Options $options) { + $options['lazy2']; + }); + + $this->resolver->setDefault('lazy2', function (Options $options) { + $options['lazy1']; + }); + + $this->resolver->resolve(); + } + + //////////////////////////////////////////////////////////////////////////// + // Countable + //////////////////////////////////////////////////////////////////////////// + + public function testCount() + { + $this->resolver->setDefault('default', 0); + $this->resolver->setRequired('required'); + $this->resolver->setDefined('defined'); + $this->resolver->setDefault('lazy1', function () {}); + + $this->resolver->setDefault('lazy2', function (Options $options) { + Assert::assertCount(4, $options); + }); + + $this->assertCount(4, $this->resolver->resolve(array('required' => 'value'))); + } + + /** + * In resolve() we count the options that are actually set (which may be + * only a subset of the defined options). Outside of resolve(), it's not + * clear what is counted. + * + * @expectedException \Symfony\Component\OptionsResolver\Exception\AccessException + */ + public function testCountFailsOutsideResolve() + { + $this->resolver->setDefault('foo', 0); + $this->resolver->setRequired('bar'); + $this->resolver->setDefined('bar'); + $this->resolver->setDefault('lazy1', function () {}); + + count($this->resolver); + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/composer.json b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/composer.json new file mode 100644 index 0000000..895847e --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/composer.json @@ -0,0 +1,33 @@ +{ + "name": "symfony/options-resolver", + "type": "library", + "description": "Symfony OptionsResolver Component", + "keywords": ["options", "config", "configuration"], + "homepage": "https://symfony.com", + "license": "MIT", + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "require": { + "php": "^5.5.9|>=7.0.8" + }, + "autoload": { + "psr-4": { "Symfony\\Component\\OptionsResolver\\": "" }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "minimum-stability": "dev", + "extra": { + "branch-alias": { + "dev-master": "3.4-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/phpunit.xml.dist b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/phpunit.xml.dist new file mode 100644 index 0000000..7e04e60 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/symfony/options-resolver/phpunit.xml.dist @@ -0,0 +1,31 @@ + + + + + + + + + + ./Tests/ + + + + + + ./ + + ./Resources + ./Tests + ./vendor + + + + diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.composer-auth.json b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.composer-auth.json new file mode 100644 index 0000000..eea8001 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.composer-auth.json @@ -0,0 +1,7 @@ +{ + "github-oauth": { + "github.com": "PLEASE DO NOT USE THIS TOKEN IN YOUR OWN PROJECTS/FORKS", + "github.com": "This token is reserved for testing the webmozart/* repositories", + "github.com": "a9debbffdd953ee9b3b82dbc3b807cde2086bb86" + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.styleci.yml b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.styleci.yml new file mode 100644 index 0000000..92da20f --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.styleci.yml @@ -0,0 +1,8 @@ +preset: symfony + +enabled: + - ordered_use + +disabled: + - empty_return + - phpdoc_annotation_without_dot # This is still buggy: https://github.com/symfony/symfony/pull/19198 diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.travis.yml b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.travis.yml new file mode 100644 index 0000000..1265196 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/.travis.yml @@ -0,0 +1,39 @@ +language: php + +sudo: false + +branches: + only: + - master + +cache: + directories: + - $HOME/.composer/cache/files + +matrix: + include: + - php: 5.3 + - php: 5.4 + - php: 5.5 + - php: 5.6 + - php: hhvm + - php: nightly + - php: 7.0 + env: COVERAGE=yes + - php: 7.0 + env: COMPOSER_FLAGS='--prefer-lowest --prefer-stable' + allow_failures: + - php: hhvm + - php: nightly + fast_finish: true + +before_install: + - if [[ $TRAVIS_PHP_VERSION != hhvm && $COVERAGE != yes ]]; then phpenv config-rm xdebug.ini; fi; + - if [[ $TRAVIS_REPO_SLUG = webmozart/assert ]]; then cp .composer-auth.json ~/.composer/auth.json; fi; + - composer self-update + +install: composer update $COMPOSER_FLAGS --prefer-dist --no-interaction + +script: if [[ $COVERAGE = yes ]]; then vendor/bin/phpunit --verbose --coverage-clover=coverage.clover; else vendor/bin/phpunit --verbose; fi + +after_script: if [[ $COVERAGE = yes ]]; then wget https://scrutinizer-ci.com/ocular.phar && php ocular.phar code-coverage:upload --format=php-clover coverage.clover; fi diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/CHANGELOG.md b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/CHANGELOG.md new file mode 100644 index 0000000..3298361 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/CHANGELOG.md @@ -0,0 +1,34 @@ +Changelog +========= + +* 1.2.0 (2016-11-23) + + * added `Assert::throws()` + * added `Assert::count()` + * added extension point `Assert::reportInvalidArgument()` for custom subclasses + +* 1.1.0 (2016-08-09) + + * added `Assert::object()` + * added `Assert::propertyExists()` + * added `Assert::propertyNotExists()` + * added `Assert::methodExists()` + * added `Assert::methodNotExists()` + * added `Assert::uuid()` + +* 1.0.2 (2015-08-24) + + * integrated Style CI + * add tests for minimum package dependencies on Travis CI + +* 1.0.1 (2015-05-12) + + * added support for PHP 5.3.3 + +* 1.0.0 (2015-05-12) + + * first stable release + +* 1.0.0-beta (2015-03-19) + + * first beta release diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/LICENSE b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/LICENSE new file mode 100644 index 0000000..9e2e307 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/LICENSE @@ -0,0 +1,20 @@ +The MIT License (MIT) + +Copyright (c) 2014 Bernhard Schussek + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/README.md b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/README.md new file mode 100644 index 0000000..d176860 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/README.md @@ -0,0 +1,242 @@ +Webmozart Assert +================ + +[![Build Status](https://travis-ci.org/webmozart/assert.svg?branch=1.2.0)](https://travis-ci.org/webmozart/assert) +[![Build status](https://ci.appveyor.com/api/projects/status/lyg83bcsisrr94se/branch/master?svg=true)](https://ci.appveyor.com/project/webmozart/assert/branch/master) +[![Latest Stable Version](https://poser.pugx.org/webmozart/assert/v/stable.svg)](https://packagist.org/packages/webmozart/assert) +[![Total Downloads](https://poser.pugx.org/webmozart/assert/downloads.svg)](https://packagist.org/packages/webmozart/assert) +[![Dependency Status](https://www.versioneye.com/php/webmozart:assert/1.2.0/badge.svg)](https://www.versioneye.com/php/webmozart:assert/1.2.0) + +Latest release: [1.2.0](https://packagist.org/packages/webmozart/assert#1.2.0) + +PHP >= 5.3.9 + +This library contains efficient assertions to test the input and output of +your methods. With these assertions, you can greatly reduce the amount of coding +needed to write a safe implementation. + +All assertions in the [`Assert`] class throw an `\InvalidArgumentException` if +they fail. + +FAQ +--- + +**What's the difference to [beberlei/assert]?** + +This library is heavily inspired by Benjamin Eberlei's wonderful [assert package], +but fixes a usability issue with error messages that can't be fixed there without +breaking backwards compatibility. + +This package features usable error messages by default. However, you can also +easily write custom error messages: + +``` +Assert::string($path, 'The path is expected to be a string. Got: %s'); +``` + +In [beberlei/assert], the ordering of the `%s` placeholders is different for +every assertion. This package, on the contrary, provides consistent placeholder +ordering for all assertions: + +* `%s`: The tested value as string, e.g. `"/foo/bar"`. +* `%2$s`, `%3$s`, ...: Additional assertion-specific values, e.g. the + minimum/maximum length, allowed values, etc. + +Check the source code of the assertions to find out details about the additional +available placeholders. + +Installation +------------ + +Use [Composer] to install the package: + +``` +$ composer require webmozart/assert +``` + +Example +------- + +```php +use Webmozart\Assert\Assert; + +class Employee +{ + public function __construct($id) + { + Assert::integer($id, 'The employee ID must be an integer. Got: %s'); + Assert::greaterThan($id, 0, 'The employee ID must be a positive integer. Got: %s'); + } +} +``` + +If you create an employee with an invalid ID, an exception is thrown: + +```php +new Employee('foobar'); +// => InvalidArgumentException: +// The employee ID must be an integer. Got: string + +new Employee(-10); +// => InvalidArgumentException: +// The employee ID must be a positive integer. Got: -10 +``` + +Assertions +---------- + +The [`Assert`] class provides the following assertions: + +### Type Assertions + +Method | Description +----------------------------------------------- | -------------------------------------------------- +`string($value, $message = '')` | Check that a value is a string +`stringNotEmpty($value, $message = '')` | Check that a value is a non-empty string +`integer($value, $message = '')` | Check that a value is an integer +`integerish($value, $message = '')` | Check that a value casts to an integer +`float($value, $message = '')` | Check that a value is a float +`numeric($value, $message = '')` | Check that a value is numeric +`boolean($value, $message = '')` | Check that a value is a boolean +`scalar($value, $message = '')` | Check that a value is a scalar +`object($value, $message = '')` | Check that a value is an object +`resource($value, $type = null, $message = '')` | Check that a value is a resource +`isCallable($value, $message = '')` | Check that a value is a callable +`isArray($value, $message = '')` | Check that a value is an array +`isTraversable($value, $message = '')` | Check that a value is an array or a `\Traversable` +`isInstanceOf($value, $class, $message = '')` | Check that a value is an `instanceof` a class +`notInstanceOf($value, $class, $message = '')` | Check that a value is not an `instanceof` a class + +### Comparison Assertions + +Method | Description +----------------------------------------------- | -------------------------------------------------- +`true($value, $message = '')` | Check that a value is `true` +`false($value, $message = '')` | Check that a value is `false` +`null($value, $message = '')` | Check that a value is `null` +`notNull($value, $message = '')` | Check that a value is not `null` +`isEmpty($value, $message = '')` | Check that a value is `empty()` +`notEmpty($value, $message = '')` | Check that a value is not `empty()` +`eq($value, $value2, $message = '')` | Check that a value equals another (`==`) +`notEq($value, $value2, $message = '')` | Check that a value does not equal another (`!=`) +`same($value, $value2, $message = '')` | Check that a value is identical to another (`===`) +`notSame($value, $value2, $message = '')` | Check that a value is not identical to another (`!==`) +`greaterThan($value, $value2, $message = '')` | Check that a value is greater than another +`greaterThanEq($value, $value2, $message = '')` | Check that a value is greater than or equal to another +`lessThan($value, $value2, $message = '')` | Check that a value is less than another +`lessThanEq($value, $value2, $message = '')` | Check that a value is less than or equal to another +`range($value, $min, $max, $message = '')` | Check that a value is within a range +`oneOf($value, array $values, $message = '')` | Check that a value is one of a list of values + +### String Assertions + +You should check that a value is a string with `Assert::string()` before making +any of the following assertions. + +Method | Description +--------------------------------------------------- | -------------------------------------------------- +`contains($value, $subString, $message = '')` | Check that a string contains a substring +`startsWith($value, $prefix, $message = '')` | Check that a string has a prefix +`startsWithLetter($value, $message = '')` | Check that a string starts with a letter +`endsWith($value, $suffix, $message = '')` | Check that a string has a suffix +`regex($value, $pattern, $message = '')` | Check that a string matches a regular expression +`alpha($value, $message = '')` | Check that a string contains letters only +`digits($value, $message = '')` | Check that a string contains digits only +`alnum($value, $message = '')` | Check that a string contains letters and digits only +`lower($value, $message = '')` | Check that a string contains lowercase characters only +`upper($value, $message = '')` | Check that a string contains uppercase characters only +`length($value, $length, $message = '')` | Check that a string has a certain number of characters +`minLength($value, $min, $message = '')` | Check that a string has at least a certain number of characters +`maxLength($value, $max, $message = '')` | Check that a string has at most a certain number of characters +`lengthBetween($value, $min, $max, $message = '')` | Check that a string has a length in the given range +`uuid($value, $message = '')` | Check that a string is a valid UUID + +### File Assertions + +Method | Description +----------------------------------- | -------------------------------------------------- +`fileExists($value, $message = '')` | Check that a value is an existing path +`file($value, $message = '')` | Check that a value is an existing file +`directory($value, $message = '')` | Check that a value is an existing directory +`readable($value, $message = '')` | Check that a value is a readable path +`writable($value, $message = '')` | Check that a value is a writable path + +### Object Assertions + +Method | Description +----------------------------------------------------- | -------------------------------------------------- +`classExists($value, $message = '')` | Check that a value is an existing class name +`subclassOf($value, $class, $message = '')` | Check that a class is a subclass of another +`implementsInterface($value, $class, $message = '')` | Check that a class implements an interface +`propertyExists($value, $property, $message = '')` | Check that a property exists in a class/object +`propertyNotExists($value, $property, $message = '')` | Check that a property does not exist in a class/object +`methodExists($value, $method, $message = '')` | Check that a method exists in a class/object +`methodNotExists($value, $method, $message = '')` | Check that a method does not exist in a class/object + +### Array Assertions + +Method | Description +------------------------------------------- | -------------------------------------------------- +`keyExists($array, $key, $message = '')` | Check that a key exists in an array +`keyNotExists($array, $key, $message = '')` | Check that a key does not exist in an array +`count($array, $number, $message = '')` | Check that an array contains a specific number of elements + +### Function Assertions + +Method | Description +------------------------------------------- | ----------------------------------------------------------------------------------------------------- +`throws($closure, $class, $message = '')` | Check that a function throws a certain exception. Subclasses of the exception class will be accepted. + +### Collection Assertions + +All of the above assertions can be prefixed with `all*()` to test the contents +of an array or a `\Traversable`: + +```php +Assert::allIsInstanceOf($employees, 'Acme\Employee'); +``` + +### Nullable Assertions + +All of the above assertions can be prefixed with `nullOr*()` to run the +assertion only if it the value is not `null`: + +```php +Assert::nullOrString($middleName, 'The middle name must be a string or null. Got: %s'); +``` + +Authors +------- + +* [Bernhard Schussek] a.k.a. [@webmozart] +* [The Community Contributors] + +Contribute +---------- + +Contributions to the package are always welcome! + +* Report any bugs or issues you find on the [issue tracker]. +* You can grab the source code at the package's [Git repository]. + +Support +------- + +If you are having problems, send a mail to bschussek@gmail.com or shout out to +[@webmozart] on Twitter. + +License +------- + +All contents of this package are licensed under the [MIT license]. + +[beberlei/assert]: https://github.com/beberlei/assert +[assert package]: https://github.com/beberlei/assert +[Composer]: https://getcomposer.org +[Bernhard Schussek]: http://webmozarts.com +[The Community Contributors]: https://github.com/webmozart/assert/graphs/contributors +[issue tracker]: https://github.com/webmozart/assert +[Git repository]: https://github.com/webmozart/assert +[@webmozart]: https://twitter.com/webmozart +[MIT license]: LICENSE +[`Assert`]: src/Assert.php diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/appveyor.yml b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/appveyor.yml new file mode 100644 index 0000000..3a413bc --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/appveyor.yml @@ -0,0 +1,40 @@ +build: false +platform: x86 +clone_folder: c:\projects\webmozart\assert + +branches: + only: + - master + +cache: + - c:\php -> appveyor.yml + +init: + - SET PATH=c:\php;%PATH% + - SET COMPOSER_NO_INTERACTION=1 + - SET PHP=1 + +install: + - IF EXIST c:\php (SET PHP=0) ELSE (mkdir c:\php) + - cd c:\php + - IF %PHP%==1 appveyor DownloadFile http://windows.php.net/downloads/releases/archives/php-7.0.0-nts-Win32-VC14-x86.zip + - IF %PHP%==1 7z x php-7.0.0-nts-Win32-VC14-x86.zip -y >nul + - IF %PHP%==1 del /Q *.zip + - IF %PHP%==1 echo @php %%~dp0composer.phar %%* > composer.bat + - IF %PHP%==1 copy /Y php.ini-development php.ini + - IF %PHP%==1 echo max_execution_time=1200 >> php.ini + - IF %PHP%==1 echo date.timezone="UTC" >> php.ini + - IF %PHP%==1 echo extension_dir=ext >> php.ini + - IF %PHP%==1 echo extension=php_curl.dll >> php.ini + - IF %PHP%==1 echo extension=php_openssl.dll >> php.ini + - IF %PHP%==1 echo extension=php_mbstring.dll >> php.ini + - IF %PHP%==1 echo extension=php_fileinfo.dll >> php.ini + - appveyor DownloadFile https://getcomposer.org/composer.phar + - cd c:\projects\webmozart\assert + - mkdir %APPDATA%\Composer + - IF %APPVEYOR_REPO_NAME%==webmozart/assert copy /Y .composer-auth.json %APPDATA%\Composer\auth.json + - composer update --prefer-dist --no-progress --ansi + +test_script: + - cd c:\projects\webmozart\assert + - vendor\bin\phpunit.bat --verbose diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/composer.json b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/composer.json new file mode 100644 index 0000000..c49e623 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/composer.json @@ -0,0 +1,34 @@ +{ + "name": "webmozart/assert", + "description": "Assertions to validate method input/output with nice error messages.", + "keywords": ["assert", "check", "validate"], + "license": "MIT", + "authors": [ + { + "name": "Bernhard Schussek", + "email": "bschussek@gmail.com" + } + ], + "require": { + "php": "^5.3.3 || ^7.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.6", + "sebastian/version": "^1.0.1" + }, + "autoload": { + "psr-4": { + "Webmozart\\Assert\\": "src/" + } + }, + "autoload-dev": { + "psr-4": { + "Webmozart\\Assert\\Tests\\": "tests/" + } + }, + "extra": { + "branch-alias": { + "dev-master": "1.3-dev" + } + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/phpunit.xml.dist b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/phpunit.xml.dist new file mode 100644 index 0000000..db20e9b --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/phpunit.xml.dist @@ -0,0 +1,16 @@ + + + + + + ./tests/ + + + + + + + ./src/ + + + diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/src/Assert.php b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/src/Assert.php new file mode 100644 index 0000000..083ad20 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/src/Assert.php @@ -0,0 +1,948 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Webmozart\Assert; + +use BadMethodCallException; +use InvalidArgumentException; +use Traversable; +use Exception; +use Throwable; +use Closure; + +/** + * Efficient assertions to validate the input/output of your methods. + * + * @method static void nullOrString($value, $message = '') + * @method static void nullOrStringNotEmpty($value, $message = '') + * @method static void nullOrInteger($value, $message = '') + * @method static void nullOrIntegerish($value, $message = '') + * @method static void nullOrFloat($value, $message = '') + * @method static void nullOrNumeric($value, $message = '') + * @method static void nullOrBoolean($value, $message = '') + * @method static void nullOrScalar($value, $message = '') + * @method static void nullOrObject($value, $message = '') + * @method static void nullOrResource($value, $type = null, $message = '') + * @method static void nullOrIsCallable($value, $message = '') + * @method static void nullOrIsArray($value, $message = '') + * @method static void nullOrIsTraversable($value, $message = '') + * @method static void nullOrIsInstanceOf($value, $class, $message = '') + * @method static void nullOrNotInstanceOf($value, $class, $message = '') + * @method static void nullOrIsEmpty($value, $message = '') + * @method static void nullOrNotEmpty($value, $message = '') + * @method static void nullOrTrue($value, $message = '') + * @method static void nullOrFalse($value, $message = '') + * @method static void nullOrEq($value, $value2, $message = '') + * @method static void nullOrNotEq($value,$value2, $message = '') + * @method static void nullOrSame($value, $value2, $message = '') + * @method static void nullOrNotSame($value, $value2, $message = '') + * @method static void nullOrGreaterThan($value, $value2, $message = '') + * @method static void nullOrGreaterThanEq($value, $value2, $message = '') + * @method static void nullOrLessThan($value, $value2, $message = '') + * @method static void nullOrLessThanEq($value, $value2, $message = '') + * @method static void nullOrRange($value, $min, $max, $message = '') + * @method static void nullOrOneOf($value, $values, $message = '') + * @method static void nullOrContains($value, $subString, $message = '') + * @method static void nullOrStartsWith($value, $prefix, $message = '') + * @method static void nullOrStartsWithLetter($value, $message = '') + * @method static void nullOrEndsWith($value, $suffix, $message = '') + * @method static void nullOrRegex($value, $pattern, $message = '') + * @method static void nullOrAlpha($value, $message = '') + * @method static void nullOrDigits($value, $message = '') + * @method static void nullOrAlnum($value, $message = '') + * @method static void nullOrLower($value, $message = '') + * @method static void nullOrUpper($value, $message = '') + * @method static void nullOrLength($value, $length, $message = '') + * @method static void nullOrMinLength($value, $min, $message = '') + * @method static void nullOrMaxLength($value, $max, $message = '') + * @method static void nullOrLengthBetween($value, $min, $max, $message = '') + * @method static void nullOrFileExists($value, $message = '') + * @method static void nullOrFile($value, $message = '') + * @method static void nullOrDirectory($value, $message = '') + * @method static void nullOrReadable($value, $message = '') + * @method static void nullOrWritable($value, $message = '') + * @method static void nullOrClassExists($value, $message = '') + * @method static void nullOrSubclassOf($value, $class, $message = '') + * @method static void nullOrImplementsInterface($value, $interface, $message = '') + * @method static void nullOrPropertyExists($value, $property, $message = '') + * @method static void nullOrPropertyNotExists($value, $property, $message = '') + * @method static void nullOrMethodExists($value, $method, $message = '') + * @method static void nullOrMethodNotExists($value, $method, $message = '') + * @method static void nullOrKeyExists($value, $key, $message = '') + * @method static void nullOrKeyNotExists($value, $key, $message = '') + * @method static void nullOrCount($value, $key, $message = '') + * @method static void nullOrUuid($values, $message = '') + * @method static void allString($values, $message = '') + * @method static void allStringNotEmpty($values, $message = '') + * @method static void allInteger($values, $message = '') + * @method static void allIntegerish($values, $message = '') + * @method static void allFloat($values, $message = '') + * @method static void allNumeric($values, $message = '') + * @method static void allBoolean($values, $message = '') + * @method static void allScalar($values, $message = '') + * @method static void allObject($values, $message = '') + * @method static void allResource($values, $type = null, $message = '') + * @method static void allIsCallable($values, $message = '') + * @method static void allIsArray($values, $message = '') + * @method static void allIsTraversable($values, $message = '') + * @method static void allIsInstanceOf($values, $class, $message = '') + * @method static void allNotInstanceOf($values, $class, $message = '') + * @method static void allNull($values, $message = '') + * @method static void allNotNull($values, $message = '') + * @method static void allIsEmpty($values, $message = '') + * @method static void allNotEmpty($values, $message = '') + * @method static void allTrue($values, $message = '') + * @method static void allFalse($values, $message = '') + * @method static void allEq($values, $value2, $message = '') + * @method static void allNotEq($values,$value2, $message = '') + * @method static void allSame($values, $value2, $message = '') + * @method static void allNotSame($values, $value2, $message = '') + * @method static void allGreaterThan($values, $value2, $message = '') + * @method static void allGreaterThanEq($values, $value2, $message = '') + * @method static void allLessThan($values, $value2, $message = '') + * @method static void allLessThanEq($values, $value2, $message = '') + * @method static void allRange($values, $min, $max, $message = '') + * @method static void allOneOf($values, $values, $message = '') + * @method static void allContains($values, $subString, $message = '') + * @method static void allStartsWith($values, $prefix, $message = '') + * @method static void allStartsWithLetter($values, $message = '') + * @method static void allEndsWith($values, $suffix, $message = '') + * @method static void allRegex($values, $pattern, $message = '') + * @method static void allAlpha($values, $message = '') + * @method static void allDigits($values, $message = '') + * @method static void allAlnum($values, $message = '') + * @method static void allLower($values, $message = '') + * @method static void allUpper($values, $message = '') + * @method static void allLength($values, $length, $message = '') + * @method static void allMinLength($values, $min, $message = '') + * @method static void allMaxLength($values, $max, $message = '') + * @method static void allLengthBetween($values, $min, $max, $message = '') + * @method static void allFileExists($values, $message = '') + * @method static void allFile($values, $message = '') + * @method static void allDirectory($values, $message = '') + * @method static void allReadable($values, $message = '') + * @method static void allWritable($values, $message = '') + * @method static void allClassExists($values, $message = '') + * @method static void allSubclassOf($values, $class, $message = '') + * @method static void allImplementsInterface($values, $interface, $message = '') + * @method static void allPropertyExists($values, $property, $message = '') + * @method static void allPropertyNotExists($values, $property, $message = '') + * @method static void allMethodExists($values, $method, $message = '') + * @method static void allMethodNotExists($values, $method, $message = '') + * @method static void allKeyExists($values, $key, $message = '') + * @method static void allKeyNotExists($values, $key, $message = '') + * @method static void allCount($values, $key, $message = '') + * @method static void allUuid($values, $message = '') + * + * @since 1.0 + * + * @author Bernhard Schussek + */ +class Assert +{ + public static function string($value, $message = '') + { + if (!is_string($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a string. Got: %s', + static::typeToString($value) + )); + } + } + + public static function stringNotEmpty($value, $message = '') + { + static::string($value, $message); + static::notEmpty($value, $message); + } + + public static function integer($value, $message = '') + { + if (!is_int($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an integer. Got: %s', + static::typeToString($value) + )); + } + } + + public static function integerish($value, $message = '') + { + if (!is_numeric($value) || $value != (int) $value) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an integerish value. Got: %s', + static::typeToString($value) + )); + } + } + + public static function float($value, $message = '') + { + if (!is_float($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a float. Got: %s', + static::typeToString($value) + )); + } + } + + public static function numeric($value, $message = '') + { + if (!is_numeric($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a numeric. Got: %s', + static::typeToString($value) + )); + } + } + + public static function boolean($value, $message = '') + { + if (!is_bool($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a boolean. Got: %s', + static::typeToString($value) + )); + } + } + + public static function scalar($value, $message = '') + { + if (!is_scalar($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a scalar. Got: %s', + static::typeToString($value) + )); + } + } + + public static function object($value, $message = '') + { + if (!is_object($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an object. Got: %s', + static::typeToString($value) + )); + } + } + + public static function resource($value, $type = null, $message = '') + { + if (!is_resource($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a resource. Got: %s', + static::typeToString($value) + )); + } + + if ($type && $type !== get_resource_type($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a resource of type %2$s. Got: %s', + static::typeToString($value), + $type + )); + } + } + + public static function isCallable($value, $message = '') + { + if (!is_callable($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a callable. Got: %s', + static::typeToString($value) + )); + } + } + + public static function isArray($value, $message = '') + { + if (!is_array($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an array. Got: %s', + static::typeToString($value) + )); + } + } + + public static function isTraversable($value, $message = '') + { + if (!is_array($value) && !($value instanceof Traversable)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a traversable. Got: %s', + static::typeToString($value) + )); + } + } + + public static function isInstanceOf($value, $class, $message = '') + { + if (!($value instanceof $class)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an instance of %2$s. Got: %s', + static::typeToString($value), + $class + )); + } + } + + public static function notInstanceOf($value, $class, $message = '') + { + if ($value instanceof $class) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an instance other than %2$s. Got: %s', + static::typeToString($value), + $class + )); + } + } + + public static function isEmpty($value, $message = '') + { + if (!empty($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an empty value. Got: %s', + static::valueToString($value) + )); + } + } + + public static function notEmpty($value, $message = '') + { + if (empty($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a non-empty value. Got: %s', + static::valueToString($value) + )); + } + } + + public static function null($value, $message = '') + { + if (null !== $value) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected null. Got: %s', + static::valueToString($value) + )); + } + } + + public static function notNull($value, $message = '') + { + if (null === $value) { + static::reportInvalidArgument( + $message ?: 'Expected a value other than null.' + ); + } + } + + public static function true($value, $message = '') + { + if (true !== $value) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to be true. Got: %s', + static::valueToString($value) + )); + } + } + + public static function false($value, $message = '') + { + if (false !== $value) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to be false. Got: %s', + static::valueToString($value) + )); + } + } + + public static function eq($value, $value2, $message = '') + { + if ($value2 != $value) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value equal to %2$s. Got: %s', + static::valueToString($value), + static::valueToString($value2) + )); + } + } + + public static function notEq($value, $value2, $message = '') + { + if ($value2 == $value) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a different value than %s.', + static::valueToString($value2) + )); + } + } + + public static function same($value, $value2, $message = '') + { + if ($value2 !== $value) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value identical to %2$s. Got: %s', + static::valueToString($value), + static::valueToString($value2) + )); + } + } + + public static function notSame($value, $value2, $message = '') + { + if ($value2 === $value) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value not identical to %s.', + static::valueToString($value2) + )); + } + } + + public static function greaterThan($value, $limit, $message = '') + { + if ($value <= $limit) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value greater than %2$s. Got: %s', + static::valueToString($value), + static::valueToString($limit) + )); + } + } + + public static function greaterThanEq($value, $limit, $message = '') + { + if ($value < $limit) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value greater than or equal to %2$s. Got: %s', + static::valueToString($value), + static::valueToString($limit) + )); + } + } + + public static function lessThan($value, $limit, $message = '') + { + if ($value >= $limit) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value less than %2$s. Got: %s', + static::valueToString($value), + static::valueToString($limit) + )); + } + } + + public static function lessThanEq($value, $limit, $message = '') + { + if ($value > $limit) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value less than or equal to %2$s. Got: %s', + static::valueToString($value), + static::valueToString($limit) + )); + } + } + + public static function range($value, $min, $max, $message = '') + { + if ($value < $min || $value > $max) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value between %2$s and %3$s. Got: %s', + static::valueToString($value), + static::valueToString($min), + static::valueToString($max) + )); + } + } + + public static function oneOf($value, array $values, $message = '') + { + if (!in_array($value, $values, true)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected one of: %2$s. Got: %s', + static::valueToString($value), + implode(', ', array_map(array('static', 'valueToString'), $values)) + )); + } + } + + public static function contains($value, $subString, $message = '') + { + if (false === strpos($value, $subString)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain %2$s. Got: %s', + static::valueToString($value), + static::valueToString($subString) + )); + } + } + + public static function startsWith($value, $prefix, $message = '') + { + if (0 !== strpos($value, $prefix)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to start with %2$s. Got: %s', + static::valueToString($value), + static::valueToString($prefix) + )); + } + } + + public static function startsWithLetter($value, $message = '') + { + $valid = isset($value[0]); + + if ($valid) { + $locale = setlocale(LC_CTYPE, 0); + setlocale(LC_CTYPE, 'C'); + $valid = ctype_alpha($value[0]); + setlocale(LC_CTYPE, $locale); + } + + if (!$valid) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to start with a letter. Got: %s', + static::valueToString($value) + )); + } + } + + public static function endsWith($value, $suffix, $message = '') + { + if ($suffix !== substr($value, -static::strlen($suffix))) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to end with %2$s. Got: %s', + static::valueToString($value), + static::valueToString($suffix) + )); + } + } + + public static function regex($value, $pattern, $message = '') + { + if (!preg_match($pattern, $value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'The value %s does not match the expected pattern.', + static::valueToString($value) + )); + } + } + + public static function alpha($value, $message = '') + { + $locale = setlocale(LC_CTYPE, 0); + setlocale(LC_CTYPE, 'C'); + $valid = !ctype_alpha($value); + setlocale(LC_CTYPE, $locale); + + if ($valid) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain only letters. Got: %s', + static::valueToString($value) + )); + } + } + + public static function digits($value, $message = '') + { + $locale = setlocale(LC_CTYPE, 0); + setlocale(LC_CTYPE, 'C'); + $valid = !ctype_digit($value); + setlocale(LC_CTYPE, $locale); + + if ($valid) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain digits only. Got: %s', + static::valueToString($value) + )); + } + } + + public static function alnum($value, $message = '') + { + $locale = setlocale(LC_CTYPE, 0); + setlocale(LC_CTYPE, 'C'); + $valid = !ctype_alnum($value); + setlocale(LC_CTYPE, $locale); + + if ($valid) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain letters and digits only. Got: %s', + static::valueToString($value) + )); + } + } + + public static function lower($value, $message = '') + { + $locale = setlocale(LC_CTYPE, 0); + setlocale(LC_CTYPE, 'C'); + $valid = !ctype_lower($value); + setlocale(LC_CTYPE, $locale); + + if ($valid) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain lowercase characters only. Got: %s', + static::valueToString($value) + )); + } + } + + public static function upper($value, $message = '') + { + $locale = setlocale(LC_CTYPE, 0); + setlocale(LC_CTYPE, 'C'); + $valid = !ctype_upper($value); + setlocale(LC_CTYPE, $locale); + + if ($valid) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain uppercase characters only. Got: %s', + static::valueToString($value) + )); + } + } + + public static function length($value, $length, $message = '') + { + if ($length !== static::strlen($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain %2$s characters. Got: %s', + static::valueToString($value), + $length + )); + } + } + + public static function minLength($value, $min, $message = '') + { + if (static::strlen($value) < $min) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain at least %2$s characters. Got: %s', + static::valueToString($value), + $min + )); + } + } + + public static function maxLength($value, $max, $message = '') + { + if (static::strlen($value) > $max) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain at most %2$s characters. Got: %s', + static::valueToString($value), + $max + )); + } + } + + public static function lengthBetween($value, $min, $max, $message = '') + { + $length = static::strlen($value); + + if ($length < $min || $length > $max) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a value to contain between %2$s and %3$s characters. Got: %s', + static::valueToString($value), + $min, + $max + )); + } + } + + public static function fileExists($value, $message = '') + { + static::string($value); + + if (!file_exists($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'The file %s does not exist.', + static::valueToString($value) + )); + } + } + + public static function file($value, $message = '') + { + static::fileExists($value, $message); + + if (!is_file($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'The path %s is not a file.', + static::valueToString($value) + )); + } + } + + public static function directory($value, $message = '') + { + static::fileExists($value, $message); + + if (!is_dir($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'The path %s is no directory.', + static::valueToString($value) + )); + } + } + + public static function readable($value, $message = '') + { + if (!is_readable($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'The path %s is not readable.', + static::valueToString($value) + )); + } + } + + public static function writable($value, $message = '') + { + if (!is_writable($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'The path %s is not writable.', + static::valueToString($value) + )); + } + } + + public static function classExists($value, $message = '') + { + if (!class_exists($value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an existing class name. Got: %s', + static::valueToString($value) + )); + } + } + + public static function subclassOf($value, $class, $message = '') + { + if (!is_subclass_of($value, $class)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected a sub-class of %2$s. Got: %s', + static::valueToString($value), + static::valueToString($class) + )); + } + } + + public static function implementsInterface($value, $interface, $message = '') + { + if (!in_array($interface, class_implements($value))) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected an implementation of %2$s. Got: %s', + static::valueToString($value), + static::valueToString($interface) + )); + } + } + + public static function propertyExists($classOrObject, $property, $message = '') + { + if (!property_exists($classOrObject, $property)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected the property %s to exist.', + static::valueToString($property) + )); + } + } + + public static function propertyNotExists($classOrObject, $property, $message = '') + { + if (property_exists($classOrObject, $property)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected the property %s to not exist.', + static::valueToString($property) + )); + } + } + + public static function methodExists($classOrObject, $method, $message = '') + { + if (!method_exists($classOrObject, $method)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected the method %s to exist.', + static::valueToString($method) + )); + } + } + + public static function methodNotExists($classOrObject, $method, $message = '') + { + if (method_exists($classOrObject, $method)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected the method %s to not exist.', + static::valueToString($method) + )); + } + } + + public static function keyExists($array, $key, $message = '') + { + if (!array_key_exists($key, $array)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected the key %s to exist.', + static::valueToString($key) + )); + } + } + + public static function keyNotExists($array, $key, $message = '') + { + if (array_key_exists($key, $array)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Expected the key %s to not exist.', + static::valueToString($key) + )); + } + } + + public static function count($array, $number, $message = '') + { + static::eq( + count($array), + $number, + $message ?: sprintf('Expected an array to contain %d elements. Got: %d.', $number, count($array)) + ); + } + + public static function uuid($value, $message = '') + { + $value = str_replace(array('urn:', 'uuid:', '{', '}'), '', $value); + + // The nil UUID is special form of UUID that is specified to have all + // 128 bits set to zero. + if ('00000000-0000-0000-0000-000000000000' === $value) { + return; + } + + if (!preg_match('/^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$/', $value)) { + static::reportInvalidArgument(sprintf( + $message ?: 'Value %s is not a valid UUID.', + static::valueToString($value) + )); + } + } + + public static function throws(Closure $expression, $class = 'Exception', $message = '') + { + static::string($class); + + $actual = 'none'; + try { + $expression(); + } catch (Exception $e) { + $actual = get_class($e); + if ($e instanceof $class) { + return; + } + } catch (Throwable $e) { + $actual = get_class($e); + if ($e instanceof $class) { + return; + } + } + + static::reportInvalidArgument($message ?: sprintf( + 'Expected to throw "%s", got "%s"', + $class, + $actual + )); + } + + public static function __callStatic($name, $arguments) + { + if ('nullOr' === substr($name, 0, 6)) { + if (null !== $arguments[0]) { + $method = lcfirst(substr($name, 6)); + call_user_func_array(array('static', $method), $arguments); + } + + return; + } + + if ('all' === substr($name, 0, 3)) { + static::isTraversable($arguments[0]); + + $method = lcfirst(substr($name, 3)); + $args = $arguments; + + foreach ($arguments[0] as $entry) { + $args[0] = $entry; + + call_user_func_array(array('static', $method), $args); + } + + return; + } + + throw new BadMethodCallException('No such method: '.$name); + } + + protected static function valueToString($value) + { + if (null === $value) { + return 'null'; + } + + if (true === $value) { + return 'true'; + } + + if (false === $value) { + return 'false'; + } + + if (is_array($value)) { + return 'array'; + } + + if (is_object($value)) { + return get_class($value); + } + + if (is_resource($value)) { + return 'resource'; + } + + if (is_string($value)) { + return '"'.$value.'"'; + } + + return (string) $value; + } + + protected static function typeToString($value) + { + return is_object($value) ? get_class($value) : gettype($value); + } + + protected static function strlen($value) + { + if (!function_exists('mb_detect_encoding')) { + return strlen($value); + } + + if (false === $encoding = mb_detect_encoding($value)) { + return strlen($value); + } + + return mb_strwidth($value, $encoding); + } + + protected static function reportInvalidArgument($message) + { + throw new InvalidArgumentException($message); + } + + private function __construct() + { + } +} diff --git a/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/tests/AssertTest.php b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/tests/AssertTest.php new file mode 100644 index 0000000..e9ed505 --- /dev/null +++ b/Postman/Postman-Mail/mailgun/vendor/webmozart/assert/tests/AssertTest.php @@ -0,0 +1,451 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Webmozart\Assert\Tests; + +use ArrayIterator; +use Exception; +use Error; +use LogicException; +use PHPUnit_Framework_TestCase; +use RuntimeException; +use stdClass; +use Webmozart\Assert\Assert; + +/** + * @since 1.0 + * + * @author Bernhard Schussek + */ +class AssertTest extends PHPUnit_Framework_TestCase +{ + private static $resource; + + public static function getResource() + { + if (!static::$resource) { + static::$resource = fopen(__FILE__, 'r'); + } + + return static::$resource; + } + + public static function tearDownAfterClass() + { + @fclose(self::$resource); + } + + public function getTests() + { + $resource = self::getResource(); + + return array( + array('string', array('value'), true), + array('string', array(''), true), + array('string', array(1234), false), + array('stringNotEmpty', array('value'), true), + array('stringNotEmpty', array(''), false), + array('stringNotEmpty', array(1234), false), + array('integer', array(123), true), + array('integer', array('123'), false), + array('integer', array(1.0), false), + array('integer', array(1.23), false), + array('integerish', array(1.0), true), + array('integerish', array(1.23), false), + array('integerish', array(123), true), + array('integerish', array('123'), true), + array('float', array(1.0), true), + array('float', array(1.23), true), + array('float', array(123), false), + array('float', array('123'), false), + array('numeric', array(1.0), true), + array('numeric', array(1.23), true), + array('numeric', array(123), true), + array('numeric', array('123'), true), + array('numeric', array('foo'), false), + array('boolean', array(true), true), + array('boolean', array(false), true), + array('boolean', array(1), false), + array('boolean', array('1'), false), + array('scalar', array('1'), true), + array('scalar', array(123), true), + array('scalar', array(true), true), + array('scalar', array(null), false), + array('scalar', array(array()), false), + array('scalar', array(new stdClass()), false), + array('object', array(new stdClass()), true), + array('object', array(new RuntimeException()), true), + array('object', array(null), false), + array('object', array(true), false), + array('object', array(1), false), + array('object', array(array()), false), + array('resource', array($resource), true), + array('resource', array($resource, 'stream'), true), + array('resource', array($resource, 'other'), false), + array('resource', array(1), false), + array('isCallable', array('strlen'), true), + array('isCallable', array(array($this, 'getTests')), true), + array('isCallable', array(function () {}), true), + array('isCallable', array(1234), false), + array('isCallable', array('foobar'), false), + array('isArray', array(array()), true), + array('isArray', array(array(1, 2, 3)), true), + array('isArray', array(new ArrayIterator(array())), false), + array('isArray', array(123), false), + array('isArray', array(new stdClass()), false), + array('isTraversable', array(array()), true), + array('isTraversable', array(array(1, 2, 3)), true), + array('isTraversable', array(new ArrayIterator(array())), true), + array('isTraversable', array(123), false), + array('isTraversable', array(new stdClass()), false), + array('isInstanceOf', array(new stdClass(), 'stdClass'), true), + array('isInstanceOf', array(new Exception(), 'stdClass'), false), + array('isInstanceOf', array(123, 'stdClass'), false), + array('isInstanceOf', array(array(), 'stdClass'), false), + array('notInstanceOf', array(new stdClass(), 'stdClass'), false), + array('notInstanceOf', array(new Exception(), 'stdClass'), true), + array('notInstanceOf', array(123, 'stdClass'), true), + array('notInstanceOf', array(array(), 'stdClass'), true), + array('true', array(true), true), + array('true', array(false), false), + array('true', array(1), false), + array('true', array(null), false), + array('false', array(false), true), + array('false', array(true), false), + array('false', array(1), false), + array('false', array(0), false), + array('false', array(null), false), + array('null', array(null), true), + array('null', array(false), false), + array('null', array(0), false), + array('notNull', array(false), true), + array('notNull', array(0), true), + array('notNull', array(null), false), + array('isEmpty', array(null), true), + array('isEmpty', array(false), true), + array('isEmpty', array(0), true), + array('isEmpty', array(''), true), + array('isEmpty', array(1), false), + array('isEmpty', array('a'), false), + array('notEmpty', array(1), true), + array('notEmpty', array('a'), true), + array('notEmpty', array(null), false), + array('notEmpty', array(false), false), + array('notEmpty', array(0), false), + array('notEmpty', array(''), false), + array('eq', array(1, 1), true), + array('eq', array(1, '1'), true), + array('eq', array(1, true), true), + array('eq', array(1, 0), false), + array('notEq', array(1, 0), true), + array('notEq', array(1, 1), false), + array('notEq', array(1, '1'), false), + array('notEq', array(1, true), false), + array('same', array(1, 1), true), + array('same', array(1, '1'), false), + array('same', array(1, true), false), + array('same', array(1, 0), false), + array('notSame', array(1, 0), true), + array('notSame', array(1, 1), false), + array('notSame', array(1, '1'), true), + array('notSame', array(1, true), true), + array('greaterThan', array(1, 0), true), + array('greaterThan', array(0, 0), false), + array('greaterThanEq', array(2, 1), true), + array('greaterThanEq', array(1, 1), true), + array('greaterThanEq', array(0, 1), false), + array('lessThan', array(0, 1), true), + array('lessThan', array(1, 1), false), + array('lessThanEq', array(0, 1), true), + array('lessThanEq', array(1, 1), true), + array('lessThanEq', array(2, 1), false), + array('range', array(1, 1, 2), true), + array('range', array(2, 1, 2), true), + array('range', array(0, 1, 2), false), + array('range', array(3, 1, 2), false), + array('oneOf', array(1, array(1, 2, 3)), true), + array('oneOf', array(1, array('1', '2', '3')), false), + array('contains', array('abcd', 'ab'), true), + array('contains', array('abcd', 'bc'), true), + array('contains', array('abcd', 'cd'), true), + array('contains', array('abcd', 'de'), false), + array('contains', array('', 'de'), false), + array('startsWith', array('abcd', 'ab'), true), + array('startsWith', array('abcd', 'bc'), false), + array('startsWith', array('', 'bc'), false), + array('startsWithLetter', array('abcd'), true), + array('startsWithLetter', array('1abcd'), false), + array('startsWithLetter', array(''), false), + array('endsWith', array('abcd', 'cd'), true), + array('endsWith', array('abcd', 'bc'), false), + array('endsWith', array('', 'bc'), false), + array('regex', array('abcd', '~^ab~'), true), + array('regex', array('abcd', '~^bc~'), false), + array('regex', array('', '~^bc~'), false), + array('alpha', array('abcd'), true), + array('alpha', array('ab1cd'), false), + array('alpha', array(''), false), + array('digits', array('1234'), true), + array('digits', array('12a34'), false), + array('digits', array(''), false), + array('alnum', array('ab12'), true), + array('alnum', array('ab12$'), false), + array('alnum', array(''), false), + array('lower', array('abcd'), true), + array('lower', array('abCd'), false), + array('lower', array('ab_d'), false), + array('lower', array(''), false), + array('upper', array('ABCD'), true), + array('upper', array('ABcD'), false), + array('upper', array('AB_D'), false), + array('upper', array(''), false), + array('length', array('abcd', 4), true), + array('length', array('abc', 4), false), + array('length', array('abcde', 4), false), + array('length', array('äbcd', 4), true, true), + array('length', array('äbc', 4), false, true), + array('length', array('äbcde', 4), false, true), + array('minLength', array('abcd', 4), true), + array('minLength', array('abcde', 4), true), + array('minLength', array('abc', 4), false), + array('minLength', array('äbcd', 4), true, true), + array('minLength', array('äbcde', 4), true, true), + array('minLength', array('äbc', 4), false, true), + array('maxLength', array('abcd', 4), true), + array('maxLength', array('abc', 4), true), + array('maxLength', array('abcde', 4), false), + array('maxLength', array('äbcd', 4), true, true), + array('maxLength', array('äbc', 4), true, true), + array('maxLength', array('äbcde', 4), false, true), + array('lengthBetween', array('abcd', 3, 5), true), + array('lengthBetween', array('abc', 3, 5), true), + array('lengthBetween', array('abcde', 3, 5), true), + array('lengthBetween', array('ab', 3, 5), false), + array('lengthBetween', array('abcdef', 3, 5), false), + array('lengthBetween', array('äbcd', 3, 5), true, true), + array('lengthBetween', array('äbc', 3, 5), true, true), + array('lengthBetween', array('äbcde', 3, 5), true, true), + array('lengthBetween', array('äb', 3, 5), false, true), + array('lengthBetween', array('äbcdef', 3, 5), false, true), + array('fileExists', array(__FILE__), true), + array('fileExists', array(__DIR__), true), + array('fileExists', array(__DIR__.'/foobar'), false), + array('file', array(__FILE__), true), + array('file', array(__DIR__), false), + array('file', array(__DIR__.'/foobar'), false), + array('directory', array(__DIR__), true), + array('directory', array(__FILE__), false), + array('directory', array(__DIR__.'/foobar'), false), + // no tests for readable()/writable() for now + array('classExists', array(__CLASS__), true), + array('classExists', array(__NAMESPACE__.'\Foobar'), false), + array('subclassOf', array(__CLASS__, 'PHPUnit_Framework_TestCase'), true), + array('subclassOf', array(__CLASS__, 'stdClass'), false), + array('implementsInterface', array('ArrayIterator', 'Traversable'), true), + array('implementsInterface', array(__CLASS__, 'Traversable'), false), + array('propertyExists', array((object) array('property' => 0), 'property'), true), + array('propertyExists', array((object) array('property' => null), 'property'), true), + array('propertyExists', array((object) array('property' => null), 'foo'), false), + array('propertyNotExists', array((object) array('property' => 0), 'property'), false), + array('propertyNotExists', array((object) array('property' => null), 'property'), false), + array('propertyNotExists', array((object) array('property' => null), 'foo'), true), + array('methodExists', array('RuntimeException', 'getMessage'), true), + array('methodExists', array(new RuntimeException(), 'getMessage'), true), + array('methodExists', array('stdClass', 'getMessage'), false), + array('methodExists', array(new stdClass(), 'getMessage'), false), + array('methodExists', array(null, 'getMessage'), false), + array('methodExists', array(true, 'getMessage'), false), + array('methodExists', array(1, 'getMessage'), false), + array('methodNotExists', array('RuntimeException', 'getMessage'), false), + array('methodNotExists', array(new RuntimeException(), 'getMessage'), false), + array('methodNotExists', array('stdClass', 'getMessage'), true), + array('methodNotExists', array(new stdClass(), 'getMessage'), true), + array('methodNotExists', array(null, 'getMessage'), true), + array('methodNotExists', array(true, 'getMessage'), true), + array('methodNotExists', array(1, 'getMessage'), true), + array('keyExists', array(array('key' => 0), 'key'), true), + array('keyExists', array(array('key' => null), 'key'), true), + array('keyExists', array(array('key' => null), 'foo'), false), + array('keyNotExists', array(array('key' => 0), 'key'), false), + array('keyNotExists', array(array('key' => null), 'key'), false), + array('keyNotExists', array(array('key' => null), 'foo'), true), + array('count', array(array(0, 1, 2), 3), true), + array('count', array(array(0, 1, 2), 2), false), + array('uuid', array('00000000-0000-0000-0000-000000000000'), true), + array('uuid', array('ff6f8cb0-c57d-21e1-9b21-0800200c9a66'), true), + array('uuid', array('ff6f8cb0-c57d-11e1-9b21-0800200c9a66'), true), + array('uuid', array('ff6f8cb0-c57d-31e1-9b21-0800200c9a66'), true), + array('uuid', array('ff6f8cb0-c57d-41e1-9b21-0800200c9a66'), true), + array('uuid', array('ff6f8cb0-c57d-51e1-9b21-0800200c9a66'), true), + array('uuid', array('FF6F8CB0-C57D-11E1-9B21-0800200C9A66'), true), + array('uuid', array('zf6f8cb0-c57d-11e1-9b21-0800200c9a66'), false), + array('uuid', array('af6f8cb0c57d11e19b210800200c9a66'), false), + array('uuid', array('ff6f8cb0-c57da-51e1-9b21-0800200c9a66'), false), + array('uuid', array('af6f8cb-c57d-11e1-9b21-0800200c9a66'), false), + array('uuid', array('3f6f8cb0-c57d-11e1-9b21-0800200c9a6'), false), + array('throws', array(function() { throw new LogicException('test'); }, 'LogicException'), true), + array('throws', array(function() { throw new LogicException('test'); }, 'IllogicException'), false), + array('throws', array(function() { throw new Exception('test'); }), true), + array('throws', array(function() { trigger_error('test'); }, 'Throwable'), true, false, 70000), + array('throws', array(function() { trigger_error('test'); }, 'Unthrowable'), false, false, 70000), + array('throws', array(function() { throw new Error(); }, 'Throwable'), true, true, 70000), + ); + } + + public function getMethods() + { + $methods = array(); + + foreach ($this->getTests() as $params) { + $methods[$params[0]] = array($params[0]); + } + + return array_values($methods); + } + + /** + * @dataProvider getTests + */ + public function testAssert($method, $args, $success, $multibyte = false, $minVersion = null) + { + if ($minVersion && PHP_VERSION_ID < $minVersion) { + $this->markTestSkipped(sprintf('This test requires php %s or upper.', $minVersion)); + + return; + } + if ($multibyte && !function_exists('mb_strlen')) { + $this->markTestSkipped('The function mb_strlen() is not available'); + + return; + } + + if (!$success) { + $this->setExpectedException('\InvalidArgumentException'); + } + + call_user_func_array(array('Webmozart\Assert\Assert', $method), $args); + } + + /** + * @dataProvider getTests + */ + public function testNullOr($method, $args, $success, $multibyte = false, $minVersion = null) + { + if ($minVersion && PHP_VERSION_ID < $minVersion) { + $this->markTestSkipped(sprintf('This test requires php %s or upper.', $minVersion)); + + return; + } + if ($multibyte && !function_exists('mb_strlen')) { + $this->markTestSkipped('The function mb_strlen() is not available'); + + return; + } + + if (!$success && null !== reset($args)) { + $this->setExpectedException('\InvalidArgumentException'); + } + + call_user_func_array(array('Webmozart\Assert\Assert', 'nullOr'.ucfirst($method)), $args); + } + + /** + * @dataProvider getMethods + */ + public function testNullOrAcceptsNull($method) + { + call_user_func(array('Webmozart\Assert\Assert', 'nullOr'.ucfirst($method)), null); + } + + /** + * @dataProvider getTests + */ + public function testAllArray($method, $args, $success, $multibyte = false, $minVersion = null) + { + if ($minVersion && PHP_VERSION_ID < $minVersion) { + $this->markTestSkipped(sprintf('This test requires php %s or upper.', $minVersion)); + + return; + } + if ($multibyte && !function_exists('mb_strlen')) { + $this->markTestSkipped('The function mb_strlen() is not available'); + + return; + } + + if (!$success) { + $this->setExpectedException('\InvalidArgumentException'); + } + + $arg = array_shift($args); + array_unshift($args, array($arg)); + + call_user_func_array(array('Webmozart\Assert\Assert', 'all'.ucfirst($method)), $args); + } + + /** + * @dataProvider getTests + */ + public function testAllTraversable($method, $args, $success, $multibyte = false, $minVersion = null) + { + if ($minVersion && PHP_VERSION_ID < $minVersion) { + $this->markTestSkipped(sprintf('This test requires php %s or upper.', $minVersion)); + + return; + } + if ($multibyte && !function_exists('mb_strlen')) { + $this->markTestSkipped('The function mb_strlen() is not available'); + + return; + } + + if (!$success) { + $this->setExpectedException('\InvalidArgumentException'); + } + + $arg = array_shift($args); + array_unshift($args, new ArrayIterator(array($arg))); + + call_user_func_array(array('Webmozart\Assert\Assert', 'all'.ucfirst($method)), $args); + } + + public function getStringConversions() + { + return array( + array('integer', array('foobar'), 'Expected an integer. Got: string'), + array('string', array(1), 'Expected a string. Got: integer'), + array('string', array(true), 'Expected a string. Got: boolean'), + array('string', array(null), 'Expected a string. Got: NULL'), + array('string', array(array()), 'Expected a string. Got: array'), + array('string', array(new stdClass()), 'Expected a string. Got: stdClass'), + array('string', array(self::getResource()), 'Expected a string. Got: resource'), + + array('eq', array('1', '2'), 'Expected a value equal to "2". Got: "1"'), + array('eq', array(1, 2), 'Expected a value equal to 2. Got: 1'), + array('eq', array(true, false), 'Expected a value equal to false. Got: true'), + array('eq', array(true, null), 'Expected a value equal to null. Got: true'), + array('eq', array(null, true), 'Expected a value equal to true. Got: null'), + array('eq', array(array(1), array(2)), 'Expected a value equal to array. Got: array'), + array('eq', array(new ArrayIterator(array()), new stdClass()), 'Expected a value equal to stdClass. Got: ArrayIterator'), + array('eq', array(1, self::getResource()), 'Expected a value equal to resource. Got: 1'), + ); + } + + /** + * @dataProvider getStringConversions + */ + public function testConvertValuesToStrings($method, $args, $exceptionMessage) + { + $this->setExpectedException('\InvalidArgumentException', $exceptionMessage); + + call_user_func_array(array('Webmozart\Assert\Assert', $method), $args); + } +} diff --git a/Postman/Postman-Mail/postman_gmail.js b/Postman/Postman-Mail/postman_gmail.js new file mode 100644 index 0000000..365bcdd --- /dev/null +++ b/Postman/Postman-Mail/postman_gmail.js @@ -0,0 +1,35 @@ +jQuery(document).ready(function() { + postmanGmailInit(); +}); + +function postmanGmailInit() { + + // define the PostmanMandrill class + var PostmanGmail = function() { + this.slug = 'gmail_api'; + } + + // behavior for handling the user's transport change + PostmanGmail.prototype.handleTransportChange = function(transportName) { + if (transportName == this.slug) { + hide('div.transport_setting'); + hide('div.authentication_setting'); + show('div#oauth_settings'); + } + } + + PostmanGmail.prototype.handleConfigurationResponse = function(response) { + // handled by PostmanSmtp + } + + // add this class to the global transports + var transport = new PostmanGmail(); + transports.push(transport); + + // since we are initialize the screen, check if needs to be modded + // by this + // transport + var transportName = jQuery('select#input_transport_type').val(); + transport.handleTransportChange(transportName); + +} \ No newline at end of file diff --git a/Postman/Postman-Mail/postman_mailgun.js b/Postman/Postman-Mail/postman_mailgun.js new file mode 100644 index 0000000..d87e256 --- /dev/null +++ b/Postman/Postman-Mail/postman_mailgun.js @@ -0,0 +1,40 @@ +jQuery(document).ready(function() { + + // enable toggling of the API field from password to plain text + enablePasswordDisplayOnEntry('mailgun_api_key', 'toggleMailgunApiKey'); + + // define the PostmanMandrill class + var PostmanMailgun = function() { + + } + + // behavior for handling the user's transport change + PostmanMailgun.prototype.handleTransportChange = function(transportName) { + if (transportName == 'mailgun_api') { + hide('div.transport_setting'); + hide('div.authentication_setting'); + show('div#mailgun_settings'); + } + } + + // behavior for handling the wizard configuration from the + // server (after the port test) + PostmanMailgun.prototype.handleConfigurationResponse = function(response) { + var transportName = response.configuration.transport_type; + if (transportName == 'mailgun_api') { + show('section.wizard_mailgun'); + } else { + hide('section.wizard_mailgun'); + } + } + + // add this class to the global transports + var transport = new PostmanMailgun(); + transports.push(transport); + + // since we are initialize the screen, check if needs to be modded by this + // transport + var transportName = jQuery('select#input_transport_type').val(); + transport.handleTransportChange(transportName); + +}); diff --git a/Postman/Postman-Mail/postman_mandrill.js b/Postman/Postman-Mail/postman_mandrill.js new file mode 100644 index 0000000..5154246 --- /dev/null +++ b/Postman/Postman-Mail/postman_mandrill.js @@ -0,0 +1,40 @@ +jQuery(document).ready(function() { + + // enable toggling of the API field from password to plain text + enablePasswordDisplayOnEntry('mandrill_api_key', 'toggleMandrillApiKey'); + + // define the PostmanMandrill class + var PostmanMandrill = function() { + this.slug = 'mandrill_api'; + } + + // behavior for handling the user's transport change + PostmanMandrill.prototype.handleTransportChange = function(transportName) { + if (transportName == this.slug) { + hide('div.transport_setting'); + hide('div.authentication_setting'); + show('div#mandrill_settings'); + } + } + + // behavior for handling the wizard configuration from the + // server (after the port test) + PostmanMandrill.prototype.handleConfigurationResponse = function(response) { + var transportName = response.configuration.transport_type; + if (transportName == this.slug) { + show('section.wizard_mandrill'); + } else { + hide('section.wizard_mandrill'); + } + } + + // add this class to the global transports + var transport = new PostmanMandrill(); + transports.push(transport); + + // since we are initialize the screen, check if needs to be modded by this + // transport + var transportName = jQuery('select#input_transport_type').val(); + transport.handleTransportChange(transportName); + +}); diff --git a/Postman/Postman-Mail/postman_sendgrid.js b/Postman/Postman-Mail/postman_sendgrid.js new file mode 100644 index 0000000..9cbdef3 --- /dev/null +++ b/Postman/Postman-Mail/postman_sendgrid.js @@ -0,0 +1,40 @@ +jQuery(document).ready(function() { + + // enable toggling of the API field from password to plain text + enablePasswordDisplayOnEntry('sendgrid_api_key', 'toggleSendGridApiKey'); + + // define the PostmanMandrill class + var PostmanSendGrid = function() { + + } + + // behavior for handling the user's transport change + PostmanSendGrid.prototype.handleTransportChange = function(transportName) { + if (transportName == 'sendgrid_api') { + hide('div.transport_setting'); + hide('div.authentication_setting'); + show('div#sendgrid_settings'); + } + } + + // behavior for handling the wizard configuration from the + // server (after the port test) + PostmanSendGrid.prototype.handleConfigurationResponse = function(response) { + var transportName = response.configuration.transport_type; + if (transportName == 'sendgrid_api') { + show('section.wizard_sendgrid'); + } else { + hide('section.wizard_sendgrid'); + } + } + + // add this class to the global transports + var transport = new PostmanSendGrid(); + transports.push(transport); + + // since we are initialize the screen, check if needs to be modded by this + // transport + var transportName = jQuery('select#input_transport_type').val(); + transport.handleTransportChange(transportName); + +}); diff --git a/Postman/Postman-Mail/postman_smtp.js b/Postman/Postman-Mail/postman_smtp.js new file mode 100644 index 0000000..2e6d18f --- /dev/null +++ b/Postman/Postman-Mail/postman_smtp.js @@ -0,0 +1,89 @@ +jQuery(document).ready(function() { + postmanSmtpInit(); +}); + +function postmanSmtpInit() { + // define the PostmanMandrill class + var PostmanSmtp = function(name) { + this.slug = name; + } + + // behavior for handling the user's transport change + PostmanSmtp.prototype.handleTransportChange = function(transportName) { + if (transportName == 'default') { + hide('div.transport_setting'); + hide('div.authentication_setting'); + } else if (transportName == this.slug) { + show('div#smtp_config'); + var $choice = jQuery('select#input_auth_type').val(); + if ($choice == 'none') { + hide('div.authentication_setting'); + } else if ($choice != 'oauth2') { + show('div#password_settings'); + hide('div.authentication_setting.non-basic'); + } else { + hide('div.authentication_setting.non-oauth2'); + show('div#oauth_settings'); + } + } + } + + // behavior for handling the wizard configuration from the + // server (after the port test) + PostmanSmtp.prototype.handleConfigurationResponse = function(response) { + var transportName = response.configuration.transport_type; + if (!(transportName == this.slug || transportName == 'gmail_api')) { + hide('.wizard-auth-oauth2'); + hide('.wizard-auth-basic'); + return; + } + console.debug('prepping screen for smtp transport '); + if (response.configuration.display_auth == 'oauth2') { + show('p#wizard_oauth2_help'); + jQuery('p#wizard_oauth2_help').html( + response.configuration.help_text); + jQuery(postman_redirect_url_el).val( + response.configuration.redirect_url); + jQuery('#input_oauth_callback_domain').val( + response.configuration.callback_domain); + jQuery('#client_id').html(response.configuration.client_id_label); + jQuery('#client_secret').html( + response.configuration.client_secret_label); + jQuery('#redirect_url').html( + response.configuration.redirect_url_label); + jQuery('#callback_domain').html( + response.configuration.callback_domain_label); + } + redirectUrlWarning = response.configuration.dot_notation_url; + jQuery('#input_transport_type').val( + response.configuration.transport_type); + jQuery('#input_auth_type').val(response.configuration.auth_type); + jQuery('#input_enc_type').val(response.configuration.enc_type); + jQuery('#input_port').val(response.configuration.port); + + // hide the fields we don't use so validation + // will work + if (response.configuration.display_auth == 'oauth2') { + // where authentication is oauth2 + show('.wizard-auth-oauth2'); + hide('.wizard-auth-basic'); + } else if (response.configuration.display_auth == 'password') { + // where authentication is password + hide('.wizard-auth-oauth2'); + show('.wizard-auth-basic'); + } else { + // where authentication is none + hide('.wizard-auth-oauth2'); + hide('.wizard-auth-basic'); + } + } + + // add this class to the global transports + var transport = new PostmanSmtp('smtp'); + transports.push(transport); + + // since we are initialize the screen, check if needs to be + // modded by this transport + var transportName = jQuery('select#input_transport_type').val(); + transport.handleTransportChange(transportName); +} \ No newline at end of file diff --git a/Postman/Postman-Mail/sendgrid/.editorconfig b/Postman/Postman-Mail/sendgrid/.editorconfig new file mode 100644 index 0000000..e18928d --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/.editorconfig @@ -0,0 +1,8 @@ +root = true + +[*.php] +indent_style = space +indent_size = 4 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true diff --git a/Postman/Postman-Mail/sendgrid/.travis.yml b/Postman/Postman-Mail/sendgrid/.travis.yml new file mode 100644 index 0000000..11fc944 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/.travis.yml @@ -0,0 +1,35 @@ +language: php +before_script: +- phpenv local 5.4 +- composer install --dev --no-interaction +- phpenv local --unset +- cd test +script: +- "../vendor/bin/phpunit --coverage-clover clover.xml" +after_script: +- cd .. +- phpenv local 5.4 +- phpenv local --unset +- "./scripts/s3upload.sh" +php: +- 5.3 +- 5.4 +- 5.5 +- 5.6 +env: + global: + - S3_POLICY: ewogICJleHBpcmF0aW9uIjogIjIxMDAtMDEtMDFUMTI6MDA6MDAuMDAwWiIsCiAgImNvbmRpdGlvbnMiOiBbCiAgICB7ImFjbCI6ICJwdWJsaWMtcmVhZCIgfSwKICAgIHsiYnVja2V0IjogInNlbmRncmlkLW9wZW4tc291cmNlIiB9LAogICAgWyJzdGFydHMtd2l0aCIsICIka2V5IiwgInNlbmRncmlkLXBocC8iXSwKICAgIFsiY29udGVudC1sZW5ndGgtcmFuZ2UiLCAyMDQ4LCAyNjg0MzU0NTZdLAogICAgWyJlcSIsICIkQ29udGVudC1UeXBlIiwgImFwcGxpY2F0aW9uL3ppcCJdCiAgXQp9Cgo= + - secure: eUN0huKA436uIkISu6V3yW01/gZHC6slBvlnprMPEhzclU2szH6qhWEXWS5CcOG6EEDBReqLZdNAwu+FC69KGFO9+6oW2GQQLSsfEViqFi/Ig2N0r4EBO4jLRebgq0GOfetPwQvJH27d8BCiloPy8rXBb5pskxSNw4B4bRyXHz4= + - secure: j38xzMNmzYXR/JJdVumPmDoDVxb6FUDF497AuVPHowGh0egFW8XHWCOMeQWqWZI4Gg17pViQNIJ3xC6WBvob70AF8fsNm0+vxF2s7abXDMcbq5flLTS6ydKLgNu+na/RAkOBbTwxJAGIH/fQh8BH8iGKerCwoqf8sDErAge4NMw= + - secure: h3HlxBOsNXBDrIJ0yl467ST6Q8R2TmbL7PltlPcRoHy5gAxn5UiDv5W2+6DSXrwQrTjOUunZ+O9ckcaQGQy1JNhGMwgIkJpyWAHDIHhTYGU289uUIDTHQW/soX0qHJSHSx3iMgDOIc7XnfTz6W7Nv1gYKZFedOMsZ5uBMeGyiXE= + - secure: SKSl/RHFQNhGT7OUj7E0AbrQnuDhhCRI/4jC76mmzvy8EJBDgUNevAKJGtug+LVilHrlbk9fLC8rayPW6SGv0s3PowTGm8NMOc48aRBLOr7QRo/sMikJCmRuU6HWptr0NKuf2fq6lV94WDm/pDdyOSNyLga9/eaIDs/Sacp78sw= +notifications: + hipchat: + rooms: + secure: l4RUOBY44kVhSxx54NU3cmvn598rRMB7Y272Ct/W0fBm1tdGncp42A/rwg7JkiZH9EWXs3tKtoSjqw5xT6QeScUGQDdykS5QVO8lEIkDRGD4WwQ3VDJmRy1+04WtgqFEK8SyYTCcCl4ZJ0rtOcJZgDMvigkOJuLxwGXTDuvfu1k= + template: + - '%{repository} + Build %{build_number} on branch %{branch} by %{author}: %{message} + View on GitHub' + format: html + notify: true diff --git a/Postman/Postman-Mail/sendgrid/composer.json b/Postman/Postman-Mail/sendgrid/composer.json new file mode 100644 index 0000000..95d93ce --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/composer.json @@ -0,0 +1,5 @@ +{ + "require": { + "sendgrid/sendgrid": "~7" + } +} \ No newline at end of file diff --git a/Postman/Postman-Mail/sendgrid/composer.lock b/Postman/Postman-Mail/sendgrid/composer.lock new file mode 100644 index 0000000..fd6a6e2 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/composer.lock @@ -0,0 +1,128 @@ +{ + "_readme": [ + "This file locks the dependencies of your project to a known state", + "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file", + "This file is @generated automatically" + ], + "hash": "cb037c28e262c69616caad2764cb3a4f", + "content-hash": "907e285f65325b51e424d991537f18af", + "packages": [ + { + "name": "sendgrid/php-http-client", + "version": "3.9.6", + "source": { + "type": "git", + "url": "https://github.com/sendgrid/php-http-client.git", + "reference": "e9a04d949ee2d19938ab83dc100933a3b41a8ec7" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sendgrid/php-http-client/zipball/e9a04d949ee2d19938ab83dc100933a3b41a8ec7", + "reference": "e9a04d949ee2d19938ab83dc100933a3b41a8ec7", + "shasum": "" + }, + "require": { + "php": ">=5.6" + }, + "require-dev": { + "phpunit/phpunit": "~4.4", + "squizlabs/php_codesniffer": "~2.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "SendGrid\\": "lib/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Matt Bernier", + "email": "dx@sendgrid.com" + }, + { + "name": "Elmer Thomas", + "email": "elmer@thinkingserious.com" + } + ], + "description": "HTTP REST client, simplified for PHP", + "homepage": "http://github.com/sendgrid/php-http-client", + "keywords": [ + "api", + "fluent", + "http", + "rest", + "sendgrid" + ], + "time": "2018-04-10 18:06:08" + }, + { + "name": "sendgrid/sendgrid", + "version": "7.3.0", + "source": { + "type": "git", + "url": "https://github.com/sendgrid/sendgrid-php.git", + "reference": "37fa19d3ae019842f07a2a43e92ed0f566ad927d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sendgrid/sendgrid-php/zipball/37fa19d3ae019842f07a2a43e92ed0f566ad927d", + "reference": "37fa19d3ae019842f07a2a43e92ed0f566ad927d", + "shasum": "" + }, + "require": { + "ext-curl": "*", + "ext-json": "*", + "ext-mbstring": "*", + "ext-openssl": "*", + "php": ">=5.6", + "sendgrid/php-http-client": "~3.9" + }, + "replace": { + "sendgrid/sendgrid-php": "*" + }, + "require-dev": { + "phpunit/phpunit": "^5.7.9 || ^6.4.3", + "squizlabs/php_codesniffer": "3.*", + "swaggest/json-diff": "^3.4" + }, + "type": "library", + "autoload": { + "psr-4": { + "SendGrid\\": "lib/", + "SendGrid\\Mail\\": "lib/mail/", + "SendGrid\\Contacts\\": "lib/contacts/", + "SendGrid\\Stats\\": "lib/stats/" + }, + "files": [ + "lib/SendGrid.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "This library allows you to quickly and easily send emails through Twilio SendGrid using PHP.", + "homepage": "http://github.com/sendgrid/sendgrid-php", + "keywords": [ + "email", + "grid", + "send", + "sendgrid", + "twilio sendgrid" + ], + "time": "2019-04-15 17:27:21" + } + ], + "packages-dev": [], + "aliases": [], + "minimum-stability": "stable", + "stability-flags": [], + "prefer-stable": false, + "prefer-lowest": false, + "platform": [], + "platform-dev": [] +} diff --git a/Postman/Postman-Mail/sendgrid/sendgrid-php.php b/Postman/Postman-Mail/sendgrid/sendgrid-php.php new file mode 100644 index 0000000..47449d1 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/sendgrid-php.php @@ -0,0 +1,5 @@ + \ No newline at end of file diff --git a/Postman/Postman-Mail/sendgrid/vendor/autoload.php b/Postman/Postman-Mail/sendgrid/vendor/autoload.php new file mode 100644 index 0000000..764afb2 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/autoload.php @@ -0,0 +1,7 @@ + + * Jordi Boggiano + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +namespace Composer\Autoload; + +/** + * ClassLoader implements a PSR-0, PSR-4 and classmap class loader. + * + * $loader = new \Composer\Autoload\ClassLoader(); + * + * // register classes with namespaces + * $loader->add('Symfony\Component', __DIR__.'/component'); + * $loader->add('Symfony', __DIR__.'/framework'); + * + * // activate the autoloader + * $loader->register(); + * + * // to enable searching the include path (eg. for PEAR packages) + * $loader->setUseIncludePath(true); + * + * In this example, if you try to use a class in the Symfony\Component + * namespace or one of its children (Symfony\Component\Console for instance), + * the autoloader will first look for the class under the component/ + * directory, and it will then fallback to the framework/ directory if not + * found before giving up. + * + * This class is loosely based on the Symfony UniversalClassLoader. + * + * @author Fabien Potencier + * @author Jordi Boggiano + * @see http://www.php-fig.org/psr/psr-0/ + * @see http://www.php-fig.org/psr/psr-4/ + */ +class ClassLoader +{ + // PSR-4 + private $prefixLengthsPsr4 = array(); + private $prefixDirsPsr4 = array(); + private $fallbackDirsPsr4 = array(); + + // PSR-0 + private $prefixesPsr0 = array(); + private $fallbackDirsPsr0 = array(); + + private $useIncludePath = false; + private $classMap = array(); + + private $classMapAuthoritative = false; + + public function getPrefixes() + { + if (!empty($this->prefixesPsr0)) { + return call_user_func_array('array_merge', $this->prefixesPsr0); + } + + return array(); + } + + public function getPrefixesPsr4() + { + return $this->prefixDirsPsr4; + } + + public function getFallbackDirs() + { + return $this->fallbackDirsPsr0; + } + + public function getFallbackDirsPsr4() + { + return $this->fallbackDirsPsr4; + } + + public function getClassMap() + { + return $this->classMap; + } + + /** + * @param array $classMap Class to filename map + */ + public function addClassMap(array $classMap) + { + if ($this->classMap) { + $this->classMap = array_merge($this->classMap, $classMap); + } else { + $this->classMap = $classMap; + } + } + + /** + * Registers a set of PSR-0 directories for a given prefix, either + * appending or prepending to the ones previously set for this prefix. + * + * @param string $prefix The prefix + * @param array|string $paths The PSR-0 root directories + * @param bool $prepend Whether to prepend the directories + */ + public function add($prefix, $paths, $prepend = false) + { + if (!$prefix) { + if ($prepend) { + $this->fallbackDirsPsr0 = array_merge( + (array) $paths, + $this->fallbackDirsPsr0 + ); + } else { + $this->fallbackDirsPsr0 = array_merge( + $this->fallbackDirsPsr0, + (array) $paths + ); + } + + return; + } + + $first = $prefix[0]; + if (!isset($this->prefixesPsr0[$first][$prefix])) { + $this->prefixesPsr0[$first][$prefix] = (array) $paths; + + return; + } + if ($prepend) { + $this->prefixesPsr0[$first][$prefix] = array_merge( + (array) $paths, + $this->prefixesPsr0[$first][$prefix] + ); + } else { + $this->prefixesPsr0[$first][$prefix] = array_merge( + $this->prefixesPsr0[$first][$prefix], + (array) $paths + ); + } + } + + /** + * Registers a set of PSR-4 directories for a given namespace, either + * appending or prepending to the ones previously set for this namespace. + * + * @param string $prefix The prefix/namespace, with trailing '\\' + * @param array|string $paths The PSR-4 base directories + * @param bool $prepend Whether to prepend the directories + * + * @throws \InvalidArgumentException + */ + public function addPsr4($prefix, $paths, $prepend = false) + { + if (!$prefix) { + // Register directories for the root namespace. + if ($prepend) { + $this->fallbackDirsPsr4 = array_merge( + (array) $paths, + $this->fallbackDirsPsr4 + ); + } else { + $this->fallbackDirsPsr4 = array_merge( + $this->fallbackDirsPsr4, + (array) $paths + ); + } + } elseif (!isset($this->prefixDirsPsr4[$prefix])) { + // Register directories for a new namespace. + $length = strlen($prefix); + if ('\\' !== $prefix[$length - 1]) { + throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); + } + $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; + $this->prefixDirsPsr4[$prefix] = (array) $paths; + } elseif ($prepend) { + // Prepend directories for an already registered namespace. + $this->prefixDirsPsr4[$prefix] = array_merge( + (array) $paths, + $this->prefixDirsPsr4[$prefix] + ); + } else { + // Append directories for an already registered namespace. + $this->prefixDirsPsr4[$prefix] = array_merge( + $this->prefixDirsPsr4[$prefix], + (array) $paths + ); + } + } + + /** + * Registers a set of PSR-0 directories for a given prefix, + * replacing any others previously set for this prefix. + * + * @param string $prefix The prefix + * @param array|string $paths The PSR-0 base directories + */ + public function set($prefix, $paths) + { + if (!$prefix) { + $this->fallbackDirsPsr0 = (array) $paths; + } else { + $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths; + } + } + + /** + * Registers a set of PSR-4 directories for a given namespace, + * replacing any others previously set for this namespace. + * + * @param string $prefix The prefix/namespace, with trailing '\\' + * @param array|string $paths The PSR-4 base directories + * + * @throws \InvalidArgumentException + */ + public function setPsr4($prefix, $paths) + { + if (!$prefix) { + $this->fallbackDirsPsr4 = (array) $paths; + } else { + $length = strlen($prefix); + if ('\\' !== $prefix[$length - 1]) { + throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); + } + $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; + $this->prefixDirsPsr4[$prefix] = (array) $paths; + } + } + + /** + * Turns on searching the include path for class files. + * + * @param bool $useIncludePath + */ + public function setUseIncludePath($useIncludePath) + { + $this->useIncludePath = $useIncludePath; + } + + /** + * Can be used to check if the autoloader uses the include path to check + * for classes. + * + * @return bool + */ + public function getUseIncludePath() + { + return $this->useIncludePath; + } + + /** + * Turns off searching the prefix and fallback directories for classes + * that have not been registered with the class map. + * + * @param bool $classMapAuthoritative + */ + public function setClassMapAuthoritative($classMapAuthoritative) + { + $this->classMapAuthoritative = $classMapAuthoritative; + } + + /** + * Should class lookup fail if not found in the current class map? + * + * @return bool + */ + public function isClassMapAuthoritative() + { + return $this->classMapAuthoritative; + } + + /** + * Registers this instance as an autoloader. + * + * @param bool $prepend Whether to prepend the autoloader or not + */ + public function register($prepend = false) + { + spl_autoload_register(array($this, 'loadClass'), true, $prepend); + } + + /** + * Unregisters this instance as an autoloader. + */ + public function unregister() + { + spl_autoload_unregister(array($this, 'loadClass')); + } + + /** + * Loads the given class or interface. + * + * @param string $class The name of the class + * @return bool|null True if loaded, null otherwise + */ + public function loadClass($class) + { + if ($file = $this->findFile($class)) { + includeFile($file); + + return true; + } + } + + /** + * Finds the path to the file where the class is defined. + * + * @param string $class The name of the class + * + * @return string|false The path if found, false otherwise + */ + public function findFile($class) + { + // work around for PHP 5.3.0 - 5.3.2 https://bugs.php.net/50731 + if ('\\' == $class[0]) { + $class = substr($class, 1); + } + + // class map lookup + if (isset($this->classMap[$class])) { + return $this->classMap[$class]; + } + if ($this->classMapAuthoritative) { + return false; + } + + $file = $this->findFileWithExtension($class, '.php'); + + // Search for Hack files if we are running on HHVM + if ($file === null && defined('HHVM_VERSION')) { + $file = $this->findFileWithExtension($class, '.hh'); + } + + if ($file === null) { + // Remember that this class does not exist. + return $this->classMap[$class] = false; + } + + return $file; + } + + private function findFileWithExtension($class, $ext) + { + // PSR-4 lookup + $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; + + $first = $class[0]; + if (isset($this->prefixLengthsPsr4[$first])) { + foreach ($this->prefixLengthsPsr4[$first] as $prefix => $length) { + if (0 === strpos($class, $prefix)) { + foreach ($this->prefixDirsPsr4[$prefix] as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $length))) { + return $file; + } + } + } + } + } + + // PSR-4 fallback dirs + foreach ($this->fallbackDirsPsr4 as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) { + return $file; + } + } + + // PSR-0 lookup + if (false !== $pos = strrpos($class, '\\')) { + // namespaced class name + $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1) + . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR); + } else { + // PEAR-like class name + $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext; + } + + if (isset($this->prefixesPsr0[$first])) { + foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) { + if (0 === strpos($class, $prefix)) { + foreach ($dirs as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { + return $file; + } + } + } + } + } + + // PSR-0 fallback dirs + foreach ($this->fallbackDirsPsr0 as $dir) { + if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { + return $file; + } + } + + // PSR-0 include paths. + if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { + return $file; + } + } +} + +/** + * Scope isolated include. + * + * Prevents access to $this/self from included files. + */ +function includeFile($file) +{ + include $file; +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/composer/LICENSE b/Postman/Postman-Mail/sendgrid/vendor/composer/LICENSE new file mode 100644 index 0000000..ee274f1 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/composer/LICENSE @@ -0,0 +1,433 @@ +Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: Composer +Upstream-Contact: Jordi Boggiano +Source: https://github.com/composer/composer + +Files: * +Copyright: 2016, Nils Adermann + 2016, Jordi Boggiano +License: Expat + +Files: res/cacert.pem +Copyright: 2015, Mozilla Foundation +License: MPL-2.0 + +Files: src/Composer/Util/RemoteFilesystem.php + src/Composer/Util/TlsHelper.php +Copyright: 2016, Nils Adermann + 2016, Jordi Boggiano + 2013, Evan Coury +License: Expat and BSD-2-Clause + +License: BSD-2-Clause + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + . + * Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + . + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + . + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +License: Expat + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to deal + in the Software without restriction, including without limitation the rights + to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + copies of the Software, and to permit persons to whom the Software is furnished + to do so, subject to the following conditions: + . + The above copyright notice and this permission notice shall be included in all + copies or substantial portions of the Software. + . + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + THE SOFTWARE. + +License: MPL-2.0 + 1. Definitions + -------------- + . + 1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + . + 1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + . + 1.3. "Contribution" + means Covered Software of a particular Contributor. + . + 1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + . + 1.5. "Incompatible With Secondary Licenses" + means + . + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + . + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + . + 1.6. "Executable Form" + means any form of the work other than Source Code Form. + . + 1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + . + 1.8. "License" + means this document. + . + 1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + . + 1.10. "Modifications" + means any of the following: + . + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + . + (b) any new file in Source Code Form that contains any Covered + Software. + . + 1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + . + 1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + . + 1.13. "Source Code Form" + means the form of the work preferred for making modifications. + . + 1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + . + 2. License Grants and Conditions + -------------------------------- + . + 2.1. Grants + . + Each Contributor hereby grants You a world-wide, royalty-free, + non-exclusive license: + . + (a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + . + (b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + . + 2.2. Effective Date + . + The licenses granted in Section 2.1 with respect to any Contribution + become effective for each Contribution on the date the Contributor first + distributes such Contribution. + . + 2.3. Limitations on Grant Scope + . + The licenses granted in this Section 2 are the only rights granted under + this License. No additional rights or licenses will be implied from the + distribution or licensing of Covered Software under this License. + Notwithstanding Section 2.1(b) above, no patent license is granted by a + Contributor: + . + (a) for any code that a Contributor has removed from Covered Software; + or + . + (b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + . + (c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + . + This License does not grant any rights in the trademarks, service marks, + or logos of any Contributor (except as may be necessary to comply with + the notice requirements in Section 3.4). + . + 2.4. Subsequent Licenses + . + No Contributor makes additional grants as a result of Your choice to + distribute the Covered Software under a subsequent version of this + License (see Section 10.2) or under the terms of a Secondary License (if + permitted under the terms of Section 3.3). + . + 2.5. Representation + . + Each Contributor represents that the Contributor believes its + Contributions are its original creation(s) or it has sufficient rights + to grant the rights to its Contributions conveyed by this License. + . + 2.6. Fair Use + . + This License is not intended to limit any rights You have under + applicable copyright doctrines of fair use, fair dealing, or other + equivalents. + . + 2.7. Conditions + . + Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted + in Section 2.1. + . + 3. Responsibilities + ------------------- + . + 3.1. Distribution of Source Form + . + All distribution of Covered Software in Source Code Form, including any + Modifications that You create or to which You contribute, must be under + the terms of this License. You must inform recipients that the Source + Code Form of the Covered Software is governed by the terms of this + License, and how they can obtain a copy of this License. You may not + attempt to alter or restrict the recipients' rights in the Source Code + Form. + . + 3.2. Distribution of Executable Form + . + If You distribute Covered Software in Executable Form then: + . + (a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + . + (b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + . + 3.3. Distribution of a Larger Work + . + You may create and distribute a Larger Work under terms of Your choice, + provided that You also comply with the requirements of this License for + the Covered Software. If the Larger Work is a combination of Covered + Software with a work governed by one or more Secondary Licenses, and the + Covered Software is not Incompatible With Secondary Licenses, this + License permits You to additionally distribute such Covered Software + under the terms of such Secondary License(s), so that the recipient of + the Larger Work may, at their option, further distribute the Covered + Software under the terms of either this License or such Secondary + License(s). + . + 3.4. Notices + . + You may not remove or alter the substance of any license notices + (including copyright notices, patent notices, disclaimers of warranty, + or limitations of liability) contained within the Source Code Form of + the Covered Software, except that You may alter any license notices to + the extent required to remedy known factual inaccuracies. + . + 3.5. Application of Additional Terms + . + You may choose to offer, and to charge a fee for, warranty, support, + indemnity or liability obligations to one or more recipients of Covered + Software. However, You may do so only on Your own behalf, and not on + behalf of any Contributor. You must make it absolutely clear that any + such warranty, support, indemnity, or liability obligation is offered by + You alone, and You hereby agree to indemnify every Contributor for any + liability incurred by such Contributor as a result of warranty, support, + indemnity or liability terms You offer. You may include additional + disclaimers of warranty and limitations of liability specific to any + jurisdiction. + . + 4. Inability to Comply Due to Statute or Regulation + --------------------------------------------------- + . + If it is impossible for You to comply with any of the terms of this + License with respect to some or all of the Covered Software due to + statute, judicial order, or regulation then You must: (a) comply with + the terms of this License to the maximum extent possible; and (b) + describe the limitations and the code they affect. Such description must + be placed in a text file included with all distributions of the Covered + Software under this License. Except to the extent prohibited by statute + or regulation, such description must be sufficiently detailed for a + recipient of ordinary skill to be able to understand it. + . + 5. Termination + -------------- + . + 5.1. The rights granted under this License will terminate automatically + if You fail to comply with any of its terms. However, if You become + compliant, then the rights granted under this License from a particular + Contributor are reinstated (a) provisionally, unless and until such + Contributor explicitly and finally terminates Your grants, and (b) on an + ongoing basis, if such Contributor fails to notify You of the + non-compliance by some reasonable means prior to 60 days after You have + come back into compliance. Moreover, Your grants from a particular + Contributor are reinstated on an ongoing basis if such Contributor + notifies You of the non-compliance by some reasonable means, this is the + first time You have received notice of non-compliance with this License + from such Contributor, and You become compliant prior to 30 days after + Your receipt of the notice. + . + 5.2. If You initiate litigation against any entity by asserting a patent + infringement claim (excluding declaratory judgment actions, + counter-claims, and cross-claims) alleging that a Contributor Version + directly or indirectly infringes any patent, then the rights granted to + You by any and all Contributors for the Covered Software under Section + 2.1 of this License shall terminate. + . + 5.3. In the event of termination under Sections 5.1 or 5.2 above, all + end user license agreements (excluding distributors and resellers) which + have been validly granted by You or Your distributors under this License + prior to termination shall survive termination. + . + ************************************************************************ + * * + * 6. Disclaimer of Warranty * + * ------------------------- * + * * + * Covered Software is provided under this License on an "as is" * + * basis, without warranty of any kind, either expressed, implied, or * + * statutory, including, without limitation, warranties that the * + * Covered Software is free of defects, merchantable, fit for a * + * particular purpose or non-infringing. The entire risk as to the * + * quality and performance of the Covered Software is with You. * + * Should any Covered Software prove defective in any respect, You * + * (not any Contributor) assume the cost of any necessary servicing, * + * repair, or correction. This disclaimer of warranty constitutes an * + * essential part of this License. No use of any Covered Software is * + * authorized under this License except under this disclaimer. * + * * + ************************************************************************ + . + ************************************************************************ + * * + * 7. Limitation of Liability * + * -------------------------- * + * * + * Under no circumstances and under no legal theory, whether tort * + * (including negligence), contract, or otherwise, shall any * + * Contributor, or anyone who distributes Covered Software as * + * permitted above, be liable to You for any direct, indirect, * + * special, incidental, or consequential damages of any character * + * including, without limitation, damages for lost profits, loss of * + * goodwill, work stoppage, computer failure or malfunction, or any * + * and all other commercial damages or losses, even if such party * + * shall have been informed of the possibility of such damages. This * + * limitation of liability shall not apply to liability for death or * + * personal injury resulting from such party's negligence to the * + * extent applicable law prohibits such limitation. Some * + * jurisdictions do not allow the exclusion or limitation of * + * incidental or consequential damages, so this exclusion and * + * limitation may not apply to You. * + * * + ************************************************************************ + . + 8. Litigation + ------------- + . + Any litigation relating to this License may be brought only in the + courts of a jurisdiction where the defendant maintains its principal + place of business and such litigation shall be governed by laws of that + jurisdiction, without reference to its conflict-of-law provisions. + Nothing in this Section shall prevent a party's ability to bring + cross-claims or counter-claims. + . + 9. Miscellaneous + ---------------- + . + This License represents the complete agreement concerning the subject + matter hereof. If any provision of this License is held to be + unenforceable, such provision shall be reformed only to the extent + necessary to make it enforceable. Any law or regulation which provides + that the language of a contract shall be construed against the drafter + shall not be used to construe this License against a Contributor. + . + 10. Versions of the License + --------------------------- + . + 10.1. New Versions + . + Mozilla Foundation is the license steward. Except as provided in Section + 10.3, no one other than the license steward has the right to modify or + publish new versions of this License. Each version will be given a + distinguishing version number. + . + 10.2. Effect of New Versions + . + You may distribute the Covered Software under the terms of the version + of the License under which You originally received the Covered Software, + or under the terms of any subsequent version published by the license + steward. + . + 10.3. Modified Versions + . + If you create software not governed by this License, and you want to + create a new license for such software, you may create and use a + modified version of this License if you rename the license and remove + any references to the name of the license steward (except to note that + such modified license differs from this License). + . + 10.4. Distributing Source Code Form that is Incompatible With Secondary + Licenses + . + If You choose to distribute Source Code Form that is Incompatible With + Secondary Licenses under the terms of this version of the License, the + notice described in Exhibit B of this License must be attached. + . + Exhibit A - Source Code Form License Notice + ------------------------------------------- + . + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at http://mozilla.org/MPL/2.0/. + . + If it is not possible or desirable to put the notice in a particular + file, then You may include the notice in a location (such as a LICENSE + file in a relevant directory) where a recipient would be likely to look + for such a notice. + . + You may add additional accurate notices of copyright ownership. + . + Exhibit B - "Incompatible With Secondary Licenses" Notice + --------------------------------------------------------- + . + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. diff --git a/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_classmap.php b/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_classmap.php new file mode 100644 index 0000000..7a91153 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_classmap.php @@ -0,0 +1,9 @@ + $vendorDir . '/sendgrid/sendgrid/lib/SendGrid.php', +); diff --git a/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_namespaces.php b/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_namespaces.php new file mode 100644 index 0000000..b7fc012 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_namespaces.php @@ -0,0 +1,9 @@ + array($vendorDir . '/sendgrid/sendgrid/lib/stats'), + 'SendGrid\\Mail\\' => array($vendorDir . '/sendgrid/sendgrid/lib/mail'), + 'SendGrid\\Contacts\\' => array($vendorDir . '/sendgrid/sendgrid/lib/contacts'), + 'SendGrid\\' => array($vendorDir . '/sendgrid/php-http-client/lib', $vendorDir . '/sendgrid/sendgrid/lib'), +); diff --git a/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_real.php b/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_real.php new file mode 100644 index 0000000..35b4612 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/composer/autoload_real.php @@ -0,0 +1,59 @@ + $path) { + $loader->set($namespace, $path); + } + + $map = require __DIR__ . '/autoload_psr4.php'; + foreach ($map as $namespace => $path) { + $loader->setPsr4($namespace, $path); + } + + $classMap = require __DIR__ . '/autoload_classmap.php'; + if ($classMap) { + $loader->addClassMap($classMap); + } + + $loader->register(true); + + $includeFiles = require __DIR__ . '/autoload_files.php'; + foreach ($includeFiles as $fileIdentifier => $file) { + composerRequireb8261ccd2bb9e98223bcd166b46db8d9($fileIdentifier, $file); + } + + return $loader; + } +} + +function composerRequireb8261ccd2bb9e98223bcd166b46db8d9($fileIdentifier, $file) +{ + if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) { + require $file; + + $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/composer/installed.json b/Postman/Postman-Mail/sendgrid/vendor/composer/installed.json new file mode 100644 index 0000000..f86362a --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/composer/installed.json @@ -0,0 +1,115 @@ +[ + { + "name": "sendgrid/php-http-client", + "version": "3.9.6", + "version_normalized": "3.9.6.0", + "source": { + "type": "git", + "url": "https://github.com/sendgrid/php-http-client.git", + "reference": "e9a04d949ee2d19938ab83dc100933a3b41a8ec7" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sendgrid/php-http-client/zipball/e9a04d949ee2d19938ab83dc100933a3b41a8ec7", + "reference": "e9a04d949ee2d19938ab83dc100933a3b41a8ec7", + "shasum": "" + }, + "require": { + "php": ">=5.6" + }, + "require-dev": { + "phpunit/phpunit": "~4.4", + "squizlabs/php_codesniffer": "~2.0" + }, + "time": "2018-04-10 18:06:08", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-4": { + "SendGrid\\": "lib/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Matt Bernier", + "email": "dx@sendgrid.com" + }, + { + "name": "Elmer Thomas", + "email": "elmer@thinkingserious.com" + } + ], + "description": "HTTP REST client, simplified for PHP", + "homepage": "http://github.com/sendgrid/php-http-client", + "keywords": [ + "api", + "fluent", + "http", + "rest", + "sendgrid" + ] + }, + { + "name": "sendgrid/sendgrid", + "version": "7.3.0", + "version_normalized": "7.3.0.0", + "source": { + "type": "git", + "url": "https://github.com/sendgrid/sendgrid-php.git", + "reference": "37fa19d3ae019842f07a2a43e92ed0f566ad927d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sendgrid/sendgrid-php/zipball/37fa19d3ae019842f07a2a43e92ed0f566ad927d", + "reference": "37fa19d3ae019842f07a2a43e92ed0f566ad927d", + "shasum": "" + }, + "require": { + "ext-curl": "*", + "ext-json": "*", + "ext-mbstring": "*", + "ext-openssl": "*", + "php": ">=5.6", + "sendgrid/php-http-client": "~3.9" + }, + "replace": { + "sendgrid/sendgrid-php": "*" + }, + "require-dev": { + "phpunit/phpunit": "^5.7.9 || ^6.4.3", + "squizlabs/php_codesniffer": "3.*", + "swaggest/json-diff": "^3.4" + }, + "time": "2019-04-15 17:27:21", + "type": "library", + "installation-source": "dist", + "autoload": { + "psr-4": { + "SendGrid\\": "lib/", + "SendGrid\\Mail\\": "lib/mail/", + "SendGrid\\Contacts\\": "lib/contacts/", + "SendGrid\\Stats\\": "lib/stats/" + }, + "files": [ + "lib/SendGrid.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "This library allows you to quickly and easily send emails through Twilio SendGrid using PHP.", + "homepage": "http://github.com/sendgrid/sendgrid-php", + "keywords": [ + "email", + "grid", + "send", + "sendgrid", + "twilio sendgrid" + ] + } +] diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.codeclimate.yml b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.codeclimate.yml new file mode 100644 index 0000000..0bd0385 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.codeclimate.yml @@ -0,0 +1,18 @@ +engines: + duplication: + enabled: true + config: + languages: + - "php" + phpcodesniffer: + enabled: true + config: + file_extensions: "php" + standard: "PSR1,PSR2" +ratings: + paths: + - "**.php" +exclude_paths: + - "examples/**/*" + - "test/**/*" + - "vendor/**/*" \ No newline at end of file diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.github/ISSUE_TEMPLATE b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.github/ISSUE_TEMPLATE new file mode 100644 index 0000000..94a2122 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.github/ISSUE_TEMPLATE @@ -0,0 +1,17 @@ +#### Issue Summary + +A summary of the issue and the environment in which it occurs. If suitable, include the steps required to reproduce the bug. Please feel free to include screenshots, screencasts, code examples. + + +#### Steps to Reproduce + +1. This is the first step +2. This is the second step +3. Further steps, etc. + +Any other information you want to share that is relevant to the issue being reported. Especially, why do you consider this to be a bug? What do you expect to happen instead? + +#### Technical details: + +* php-http-client Version: master (latest commit: [commit number]) +* PHP Version: X.X diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.github/PULL_REQUEST_TEMPLATE b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.github/PULL_REQUEST_TEMPLATE new file mode 100644 index 0000000..7ad590b --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.github/PULL_REQUEST_TEMPLATE @@ -0,0 +1,24 @@ + +# Fixes # + +### Checklist +- [ ] I have made a material change to the repo (functionality, testing, spelling, grammar) +- [ ] I have read the [Contribution Guide] and my PR follows them. +- [ ] I updated my branch with the master branch. +- [ ] I have added tests that prove my fix is effective or that my feature works +- [ ] I have added necessary documentation about the functionality in the appropriate .md file +- [ ] I have added in line documentation to the code I modified + +### Short description of what this PR does: +- +- + +If you have questions, please send an email to [Sendgrid](mailto:dx@sendgrid.com), or file a Github Issue in this repository. diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.travis.yml b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.travis.yml new file mode 100644 index 0000000..0ba5d28 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/.travis.yml @@ -0,0 +1,27 @@ +language: php +before_script: +- composer install --dev --no-interaction +- cd test/unit +script: +- ../../vendor/bin/phpunit . --bootstrap bootstrap.php --filter test* --coverage-clover=coverage.xml +after_success: +- bash <(curl -s https://codecov.io/bash) +php: +- 5.6 +- 7.0 +env: + global: + - secure: eUN0huKA436uIkISu6V3yW01/gZHC6slBvlnprMPEhzclU2szH6qhWEXWS5CcOG6EEDBReqLZdNAwu+FC69KGFO9+6oW2GQQLSsfEViqFi/Ig2N0r4EBO4jLRebgq0GOfetPwQvJH27d8BCiloPy8rXBb5pskxSNw4B4bRyXHz4= + - secure: j38xzMNmzYXR/JJdVumPmDoDVxb6FUDF497AuVPHowGh0egFW8XHWCOMeQWqWZI4Gg17pViQNIJ3xC6WBvob70AF8fsNm0+vxF2s7abXDMcbq5flLTS6ydKLgNu+na/RAkOBbTwxJAGIH/fQh8BH8iGKerCwoqf8sDErAge4NMw= + - secure: h3HlxBOsNXBDrIJ0yl467ST6Q8R2TmbL7PltlPcRoHy5gAxn5UiDv5W2+6DSXrwQrTjOUunZ+O9ckcaQGQy1JNhGMwgIkJpyWAHDIHhTYGU289uUIDTHQW/soX0qHJSHSx3iMgDOIc7XnfTz6W7Nv1gYKZFedOMsZ5uBMeGyiXE= + - secure: SKSl/RHFQNhGT7OUj7E0AbrQnuDhhCRI/4jC76mmzvy8EJBDgUNevAKJGtug+LVilHrlbk9fLC8rayPW6SGv0s3PowTGm8NMOc48aRBLOr7QRo/sMikJCmRuU6HWptr0NKuf2fq6lV94WDm/pDdyOSNyLga9/eaIDs/Sacp78sw= +notifications: + hipchat: + rooms: + secure: EFEaChRQCOLvxAvmxJe357CbfJ/wpW7ddhU0dqUljawSKbdeTkoF0Ja2NbtnIPVpJrqN9qT8BXTK3fmsJ7OJO+QCLi0R2FPnI7r+GpmjFqkxHO0KJ/Oiv1kB9jL1UcKuwhSsPubWPRvt4TKuDhEefuZb1X2xSFZZAzqROrLKtqUmy9vgpRYZtxmGRTGLfLmih8DJP96yvIOE/7/lp8lEdmXw4xF1NZtshnOiOLYrahY4pcOSl3y7eepzaGA33wWS/truH0Rh/IgTOYP2Z/ujIZE9Eg6nSwwOI8U2XzK/BEwEhrHCeyj3oAoBoGbO/m9ydaM6QM8/VT3JdVHPIWFpIhCioClwrIs3m1KsoMVeqEbuWF3h+ju6RMve5fCNvGV8tUyKpZ8GEVlEc7WdwkSKXeINgRLv7AykybZ6EkCRPkQ61/h+cNQlwKqtfeUaoBwjGAnfMQMQX5qApUn/ow8TbULnveqswhkV1fBsydiPBJxdlDe8x54GclCmgU5wnd283THUecP+8dznU+xVgfHqBnf2k9wirSEnYXh2T228kYUmEWKfhRq/7e86K2DAQAO5Vw/6HgL7e1ZVDccH6hx3lTGyjlUskkZvzktwi6gZ9gxOihQ8Yzkc1IQANr8ckQJvOZjMTQxJqgFWgXJWgRxWlpPiISLauaegcH2eNwGPRmY= + template: + - '%{repository} + Build %{build_number} on branch %{branch} by %{author}: %{message} + View on GitHub' + format: html + notify: true diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/CONTRIBUTING.md b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/CONTRIBUTING.md new file mode 100644 index 0000000..6b01be8 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/CONTRIBUTING.md @@ -0,0 +1,201 @@ +Hello! Thank you for choosing to help contribute to one of the SendGrid open source projects. There are many ways you can contribute and help is always welcome. We simply ask that you follow the following contribution policies. + +- [CLAs and CCLAs](#cla) +- [Roadmap & Milestones](#roadmap) +- [Feature Request](#feature-request) +- [Submit a Bug Report](#submit-a-bug-report) +- [Improvements to the Codebase](#improvements-to-the-codebase) +- [Understanding the Code Base](#understanding-the-codebase) +- [Testing](#testing) +- [Style Guidelines & Naming Conventions](#style-guidelines-and-naming-conventions) +- [Creating a Pull Request](#creating-a-pull-request) +- [Code Reviews](#code-reviews) + + +We use [Milestones](https://github.com/sendgrid/php-http-client/milestones) to help define current roadmaps, please feel free to grab an issue from the current milestone. Please indicate that you have begun work on it to avoid collisions. Once a PR is made, community review, comments, suggestions and additional PRs are welcomed and encouraged. + + +## CLAs and CCLAs + +Before you get started, SendGrid requires that a SendGrid Contributor License Agreement (CLA) be filled out by every contributor to a SendGrid open source project. + +Our goal with the CLA is to clarify the rights of our contributors and reduce other risks arising from inappropriate contributions. The CLA also clarifies the rights SendGrid holds in each contribution and helps to avoid misunderstandings over what rights each contributor is required to grant to SendGrid when making a contribution. In this way the CLA encourages broad participation by our open source community and helps us build strong open source projects, free from any individual contributor withholding or revoking rights to any contribution. + +SendGrid does not merge a pull request made against a SendGrid open source project until that pull request is associated with a signed CLA. Copies of the CLA are available [here](https://gist.github.com/SendGridDX/98b42c0a5d500058357b80278fde3be8#file-sendgrid_cla). + +When you create a Pull Request, after a few seconds, a comment will appear with a link to the CLA. Click the link and fill out the brief form and then click the "I agree" button and you are all set. You will not be asked to re-sign the CLA unless we make a change. + +There are a few ways to contribute, which we'll enumerate below: + + +## Feature Request + +If you'd like to make a feature request, please read this section. + +The GitHub issue tracker is the preferred channel for library feature requests, but please respect the following restrictions: + +- Please **search for existing issues** in order to ensure we don't have duplicate bugs/feature requests. +- Please be respectful and considerate of others when commenting on issues + + +## Submit a Bug Report + +Note: DO NOT include your credentials in ANY code examples, descriptions, or media you make public. + +A software bug is a demonstrable issue in the code base. In order for us to diagnose the issue and respond as quickly as possible, please add as much detail as possible into your bug report. + +Before you decide to create a new issue, please try the following: + +1. Check the Github issues tab if the identified issue has already been reported, if so, please add a +1 to the existing post. +2. Update to the latest version of this code and check if issue has already been fixed +3. Copy and fill in the Bug Report Template we have provided below + +### Please use our Bug Report Template + +In order to make the process easier, we've included a [sample bug report template](https://github.com/sendgrid/php-http-client/.github/ISSUE_TEMPLATE) (borrowed from [Ghost](https://github.com/TryGhost/Ghost/)). The template uses [GitHub flavored markdown](https://help.github.com/articles/github-flavored-markdown/) for formatting. + + +## Improvements to the Codebase + +We welcome direct contributions to the php-http-client code base. Thank you! + +### Development Environment ### + +#### Install and Run Locally #### + +##### Prerequisites ##### + +- PHP 5.6 or 7.0 +- [Composer](https://getcomposer.org/) + +##### Initial setup: ##### + +```bash +git clone https://github.com/sendgrid/php-http-client.git +cd php-http-client +``` + +### Environment Variables + +First, get your free SendGrid account [here](https://sendgrid.com/free?source=php-http-client). + +Next, update your environment with your [SENDGRID_API_KEY](https://app.sendgrid.com/settings/api_keys). + +```bash +echo "export SENDGRID_API_KEY='YOUR_API_KEY'" > sendgrid.env +echo "sendgrid.env" >> .gitignore +source ./sendgrid.env +``` + +##### Execute: ##### + +See the [examples folder](https://github.com/sendgrid/php-http-client/tree/master/examples). + + +## Understanding the Code Base + +**/examples** + +Working examples that demonstrate usage. + +**/test/unit** + +Unit tests. + +**/lib/SendGrid/Client.php** + +An HTTP client with a fluent interface using method chaining and reflection. By returning self on [__call](https://github.com/sendgrid/php-http-client/blob/master/lib/client.php#L212) and [_()](https://github.com/sendgrid/php-http-client/blob/master/lib/client.pph#L198), we can dynamically build the URL using method chaining and [__call](https://github.com/sendgrid/php-http-client/blob/master/lib/client.php#L212) allows us to dynamically receive the method calls to achieve reflection. + +This allows for the following mapping from a URL to a method chain: + +`/api_client/{api_key_id}/version` maps to `client->api_client().->_($api_key_id)->version->()` where is a [HTTP verb](https://github.com/sendgrid/php-http-client/blob/master/lib/client.php#L94). + +**/lib/SendGrid/Config.php** + +Loads the environment variables. + + +## Testing + +All PRs require passing tests before the PR will be reviewed. + +All test files are in the [`/test/unit`](https://github.com/sendgrid/php-http-client/tree/master/test/unit) directory. + +For the purposes of contributing to this repo, please update the [`ClientTest.php`](https://github.com/sendgrid/php-http-client/blob/master/test/unit/ClientTest.php) file with unit tests as you modify the code. + +```bash +composer install +cd test/unit +../../vendor/bin/phpunit . --bootstrap bootstrap.php --filter test* +``` + + +## Style Guidelines & Naming Conventions + +Generally, we follow the style guidelines as suggested by the official language. However, we ask that you conform to the styles that already exist in the library. If you wish to deviate, please explain your reasoning. + +- [pear coding standards](https://pear.php.net/manual/en/standards.php) + +Please run your code through: + +- [PHP Code Sniffer](https://github.com/squizlabs/PHP_CodeSniffer) + + +## Creating a Pull Request + +1. [Fork](https://help.github.com/fork-a-repo/) the project, clone your fork, + and configure the remotes: + + ```bash + # Clone your fork of the repo into the current directory + git clone https://github.com/sendgrid/php-http-client + # Navigate to the newly cloned directory + cd php-http-client + # Assign the original repo to a remote called "upstream" + git remote add upstream https://github.com/sendgrid/php-http-client + ``` + +2. If you cloned a while ago, get the latest changes from upstream: + + ```bash + git checkout + git pull upstream + ``` + +3. Create a new topic branch (off the main project development branch) to + contain your feature, change, or fix: + + ```bash + git checkout -b + ``` + +4. Commit your changes in logical chunks. Please adhere to these [git commit + message guidelines](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) + or your code is unlikely be merged into the main project. Use Git's + [interactive rebase](https://help.github.com/articles/interactive-rebase) + feature to tidy up your commits before making them public. + +4a. Create tests. + +4b. Create or update the example code that demonstrates the functionality of this change to the code. + +5. Locally merge (or rebase) the upstream development branch into your topic branch: + + ```bash + git pull [--rebase] upstream master + ``` + +6. Push your topic branch up to your fork: + + ```bash + git push origin + ``` + +7. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/) + with a clear title and description against the `master` branch. All tests must be passing before we will review the PR. + + +## Code Reviews +If you can, please look at open PRs and review them. Give feedback and help us merge these PRs much faster! If you don't know how, Github has some great [information on how to review a Pull Request](https://help.github.com/articles/about-pull-request-reviews/). + +If you have any additional questions, please feel free to [email](mailto:dx@sendgrid.com) us or create an issue in this repo. diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/Dockerfile b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/Dockerfile new file mode 100644 index 0000000..da1ef10 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/Dockerfile @@ -0,0 +1,13 @@ +FROM php:7.1-apache + +ARG sendgrid_apikey +ENV SENDGRID_API_KEY=$sendgrid_apikey + +COPY . /var/www/client +WORKDIR /var/www/client + +RUN apt-get update && \ + apt-get install -y git zip zlib1g-dev && docker-php-ext-install zip +RUN curl --silent --show-error https://getcomposer.org/installer | php + +RUN php composer.phar install diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/LICENSE.txt b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/LICENSE.txt new file mode 100644 index 0000000..8a3ef00 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/LICENSE.txt @@ -0,0 +1,22 @@ +The MIT License (MIT) + +Copyright (c) 2012-2018 SendGrid, Inc. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/README.md b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/README.md new file mode 100644 index 0000000..ef7236a --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/README.md @@ -0,0 +1,195 @@ +![SendGrid Logo](https://uiux.s3.amazonaws.com/2016-logos/email-logo%402x.png) + +[![Travis Badge](https://travis-ci.org/sendgrid/php-http-client.svg?branch=master)](https://travis-ci.org/sendgrid/php-http-client) +[![Latest Version on Packagist](https://img.shields.io/packagist/v/sendgrid/php-http-client.svg?style=flat-square)](https://packagist.org/packages/sendgrid/php-http-client) +[![Email Notifications Badge](https://dx.sendgrid.com/badge/php)](https://dx.sendgrid.com/newsletter/php) +[![Twitter Follow](https://img.shields.io/twitter/follow/sendgrid.svg?style=social&label=Follow)](https://twitter.com/sendgrid) +[![GitHub contributors](https://img.shields.io/github/contributors/sendgrid/php-http-client.svg)](https://github.com/sendgrid/php-http-client/graphs/contributors) +[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE.txt) + +**Quickly and easily access any RESTful or RESTful-like API.** + +If you are looking for the SendGrid API client library, please see [this repo](https://github.com/sendgrid/sendgrid-php). + +# Announcements + +All updates to this library is documented in our [CHANGELOG](https://github.com/sendgrid/php-http-client/blob/master/CHANGELOG.md). + +# Table of Contents +- [Installation](#installation) +- [Quick Start](#quick-start) +- [Usage](#usage) +- [Roadmap](#roadmap) +- [How to Contribute](#contribute) +- [Thanks](#thanks) +- [About](#about) +- [License](#license) + + +# Installation + +## Prerequisites + +- PHP version 5.6 or 7.0 + +## Install with Composer + +Add php-http-client to your `composer.json` file. If you are not using [Composer](http://getcomposer.org), you should be. It's an excellent way to manage dependencies in your PHP application. + +```json +{ + "require": { + "sendgrid/php-http-client": "~3.9.6" + } +} +``` + +Then at the top of your PHP script require the autoloader: + +```php +require __DIR__ . '/vendor/autoload.php'; +``` + +Then from the command line: + +```bash +composer install +``` + +## Install without Composer + +You should create directory `lib` in directory of your application and clone to `lib` repositories [php-http-client](https://github.com/sendgrid/php-http-client.git) and [sendgrid-php](https://github.com/sendgrid/sendgrid-php.git): + +``` +$ cd /path/to/your/app +$ mkdir lib +$ cd lib +$ git clone https://github.com/sendgrid/php-http-client.git +``` + +In the next step you should create `loader.php`: + +``` +$ cd /path/to/your/app +$ touch loader.php +``` + +And add to `loader.php` code below: + +```php + +# Quick Start + +Here is a quick example: + +`GET /your/api/{param}/call` + +```php +// include __DIR__ . '/loader.php'; +require 'vendor/autoload.php'; +$apiKey = YOUR_SENDGRID_API_KEY; +$authHeaders = [ + 'Authorization: Bearer ' . $apiKey +]; +$client = new SendGrid\Client('https://api.sendgrid.com', $authHeaders); +$param = 'foo'; +$response = $client->your()->api()->_($param)->call()->get(); + +var_dump( + $response->statusCode(), + $response->headers(), + $response->body() +); +``` + +`POST /your/api/{param}/call` with headers, query parameters and a request body with versioning. + +```php +// include __DIR__ . '/loader.php'; +require 'vendor/autoload.php'; +$apiKey = YOUR_SENDGRID_API_KEY; +$authHeaders = [ + 'Authorization: Bearer ' . $apiKey +]; +$client = new SendGrid\Client('https://api.sendgrid.com', $authHeaders); +$queryParams = [ + 'hello' => 0, 'world' => 1 +]; +$requestHeaders = [ + 'X-Test' => 'test' +]; +$data = [ + 'some' => 1, 'awesome' => 2, 'data' => 3 +]; +$param = 'bar'; +$response = $client->your()->api()->_($param)->call()->post($data, $queryParams, $requestHeaders); + +var_dump( + $response->statusCode(), + $response->headers(), + $response->body() +); +``` + + +# Usage + +- [Usage Examples](USAGE.md) + +## Environment Variables + +You can do the following to create a .env file: + +```cp .env_example .env``` + +Then, just add your API Key into your .env file. + + +# Roadmap + +If you are interested in the future direction of this project, please take a look at our [milestones](https://github.com/sendgrid/php-http-client/milestones). We would love to hear your feedback. + + +# How to Contribute + +We encourage contribution to our libraries, please see our [CONTRIBUTING](https://github.com/sendgrid/php-http-client/blob/master/CONTRIBUTING.md) guide for details. + +Quick links: + +- [Feature Request](https://github.com/sendgrid/php-http-client/blob/master/CONTRIBUTING.md#feature-request) +- [Bug Reports](https://github.com/sendgrid/php-http-client/blob/master/CONTRIBUTING.md#submit-a-bug-report) +- [Sign the CLA to Create a Pull Request](https://github.com/sendgrid/php-http-client/blob/master/CONTRIBUTING.md#cla) +- [Improvements to the Codebase](https://github.com/sendgrid/php-http-client/blob/master/CONTRIBUTING.md#improvements-to-the-codebase) +- [Review Pull Requests](https://github.com/sendgrid/php-http-client/blob/master/CONTRIBUTING.md#code-reviews) + + +# Thanks + +We were inspired by the work done on [birdy](https://github.com/inueni/birdy) and [universalclient](https://github.com/dgreisen/universalclient). + + +# About + +php-http-client is guided and supported by the SendGrid [Developer Experience Team](mailto:dx@sendgrid.com). + +php-http-client is maintained and funded by SendGrid, Inc. The names and logos for php-http-client are trademarks of SendGrid, Inc. + + +# License +[The MIT License (MIT)](LICENSE.txt) diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/composer.json b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/composer.json new file mode 100644 index 0000000..5c0a3af --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/composer.json @@ -0,0 +1,36 @@ +{ + "name": "sendgrid/php-http-client", + "description": "HTTP REST client, simplified for PHP", + "type": "library", + "version": "3.9.6", + "homepage": "http://github.com/sendgrid/php-http-client", + "keywords": ["SendGrid", "HTTP", "REST", "API", "Fluent"], + "license": "MIT", + "authors": [ + { + "name": "Matt Bernier", + "email": "dx@sendgrid.com" + }, + { + "name": "Elmer Thomas", + "email": "elmer@thinkingserious.com" + } + ], + "require": { + "php": ">=5.6" + }, + "require-dev": { + "phpunit/phpunit": "~4.4", + "squizlabs/php_codesniffer": "~2.0" + }, + "autoload": { + "psr-4": { + "SendGrid\\": "lib/" + } + }, + "autoload-dev": { + "psr-4": { + "SendGrid\\Test\\": "test/unit/" + } + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/lib/Client.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/lib/Client.php new file mode 100644 index 0000000..ec732b9 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/lib/Client.php @@ -0,0 +1,596 @@ + + * @author Elmer Thomas + * @copyright 2018 SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/php-http-client + */ + +namespace SendGrid; + +/** + * + * Class Client + * @package SendGrid + * @version 3.9.5 + * + * Quickly and easily access any REST or REST-like API. + * + * @method Response get($body = null, $query = null, $headers = null) + * @method Response post($body = null, $query = null, $headers = null) + * @method Response patch($body = null, $query = null, $headers = null) + * @method Response put($body = null, $query = null, $headers = null) + * @method Response delete($body = null, $query = null, $headers = null) + * + * @method Client version($value) + * @method Client|Response send() + * + * Adding all the endpoints as a method so code completion works + * + * General + * @method Client stats() + * @method Client search() + * @method Client monthly() + * @method Client sums() + * @method Client monitor() + * @method Client test() + * + * Access settings + * @method Client access_settings() + * @method Client activity() + * @method Client whitelist() + * + * Alerts + * @method Client alerts() + * + * Api keys + * @method Client api_keys() + * + * ASM + * @method Client asm() + * @method Client groups() + * + * Browsers + * @method Client browsers() + * + * Campaigns + * @method Client campaigns() + * @method Client schedules() + * @method Client now() + * + * Categories + * @method Client categories() + * + * Clients + * @method Client clients() + * + * ContactDB + * @method Client contactdb() + * @method Client custom_fields() + * @method Client lists() + * @method Client recipients() + * @method Client billable_count() + * @method Client count() + * @method Client reserved_fields() + * @method Client segments() + * + * Devices + * @method Client devices() + * + * Geo + * @method Client geo() + * + * Ips + * @method Client ips() + * @method Client assigned() + * @method Client pools() + * @method Client warmup() + * + * Mail + * @method Client mail() + * @method Client batch() + * + * Mailbox Providers + * @method Client mailbox_providers() + * + * Mail settings + * @method Client mail_settings() + * @method Client address_whitelist() + * @method Client bcc() + * @method Client bounce_purge() + * @method Client footer() + * @method Client forward_bounce() + * @method Client forward_spam() + * @method Client plain_content() + * @method Client spam_check() + * @method Client template() + * + * Partner settings + * @method Client partner_settings() + * @method Client new_relic() + * + * Scopes + * @method Client scopes() + * + * Senders + * @method Client senders() + * @method Client resend_verification() + * + * Sub Users + * @method Client subusers() + * @method Client reputations() + * + * Supressions + * @method Client suppressions() + * @method Client global() + * @method Client blocks() + * @method Client bounces() + * @method Client invalid_emails() + * @method Client spam_reports() + * @method Client unsubcribes() + * + * Templates + * @method Client templates() + * @method Client versions() + * @method Client activate() + * + * Tracking settings + * @method Client tracking_settings() + * @method Client click() + * @method Client google_analytics() + * @method Client open() + * @method Client subscription() + * + * User + * @method Client user() + * @method Client account() + * @method Client credits() + * @method Client email() + * @method Client password() + * @method Client profile() + * @method Client scheduled_sends() + * @method Client enforced_tls() + * @method Client settings() + * @method Client username() + * @method Client webhooks() + * @method Client event() + * @method Client parse() + * + * Missed any? Simply add them by doing: @method Client method() + */ +class Client +{ + const TOO_MANY_REQUESTS_HTTP_CODE = 429; + + /** + * @var string + */ + protected $host; + + /** + * @var array + */ + protected $headers; + + /** + * @var string + */ + protected $version; + + /** + * @var array + */ + protected $path; + + /** + * @var array + */ + protected $curlOptions; + + /** + * @var bool + */ + protected $isConcurrentRequest; + + /** + * @var array + */ + protected $savedRequests; + + /** + * @var bool + */ + protected $retryOnLimit; + + /** + * These are the supported HTTP verbs + * + * @var array + */ + private $methods = ['get', 'post', 'patch', 'put', 'delete']; + + /** + * Initialize the client + * + * @param string $host the base url (e.g. https://api.sendgrid.com) + * @param array $headers global request headers + * @param string $version api version (configurable) - this is specific to the SendGrid API + * @param array $path holds the segments of the url path + * @param array $curlOptions extra options to set during curl initialization + * @param bool $retryOnLimit set default retry on limit flag + */ + public function __construct($host, $headers = null, $version = null, $path = null, $curlOptions = null, $retryOnLimit = false) + { + $this->host = $host; + $this->headers = $headers ?: []; + $this->version = $version; + $this->path = $path ?: []; + $this->curlOptions = $curlOptions ?: []; + $this->retryOnLimit = $retryOnLimit; + $this->isConcurrentRequest = false; + $this->savedRequests = []; + } + + /** + * @return string + */ + public function getHost() + { + return $this->host; + } + + /** + * @return array + */ + public function getHeaders() + { + return $this->headers; + } + + /** + * @return string|null + */ + public function getVersion() + { + return $this->version; + } + + /** + * @return array + */ + public function getPath() + { + return $this->path; + } + + /** + * @return array + */ + public function getCurlOptions() + { + return $this->curlOptions; + } + + /** + * Set extra options to set during curl initialization + * + * @param array $options + * + * @return Client + */ + public function setCurlOptions(array $options) + { + $this->curlOptions = $options; + + return $this; + } + + /** + * Set default retry on limit flag + * + * @param bool $retry + * + * @return Client + */ + public function setRetryOnLimit($retry) + { + $this->retryOnLimit = $retry; + + return $this; + } + + /** + * Set concurrent request flag + * + * @param bool $isConcurrent + * + * @return Client + */ + public function setIsConcurrentRequest($isConcurrent) + { + $this->isConcurrentRequest = $isConcurrent; + + return $this; + } + + /** + * Build the final URL to be passed + * + * @param array $queryParams an array of all the query parameters + * + * @return string + */ + private function buildUrl($queryParams = null) + { + $path = '/' . implode('/', $this->path); + if (isset($queryParams)) { + $path .= '?' . http_build_query($queryParams); + } + return sprintf('%s%s%s', $this->host, $this->version ?: '', $path); + } + + /** + * Creates curl options for a request + * this function does not mutate any private variables + * + * @param string $method + * @param array $body + * @param array $headers + * + * @return array + */ + private function createCurlOptions($method, $body = null, $headers = null) + { + $options = [ + CURLOPT_RETURNTRANSFER => true, + CURLOPT_HEADER => true, + CURLOPT_CUSTOMREQUEST => strtoupper($method), + CURLOPT_SSL_VERIFYPEER => true, + CURLOPT_FAILONERROR => false + ] + $this->curlOptions; + + if (isset($headers)) { + $headers = array_merge($this->headers, $headers); + } else { + $headers = $this->headers; + } + + if (isset($body)) { + $encodedBody = json_encode($body); + $options[CURLOPT_POSTFIELDS] = $encodedBody; + $headers = array_merge($headers, ['Content-Type: application/json']); + } + $options[CURLOPT_HTTPHEADER] = $headers; + + return $options; + } + + /** + * @param array $requestData + * e.g. ['method' => 'POST', 'url' => 'www.example.com', 'body' => 'test body', 'headers' => []] + * @param bool $retryOnLimit + * + * @return array + */ + private function createSavedRequest(array $requestData, $retryOnLimit = false) + { + return array_merge($requestData, ['retryOnLimit' => $retryOnLimit]); + } + + /** + * @param array $requests + * + * @return array + */ + private function createCurlMultiHandle(array $requests) + { + $channels = []; + $multiHandle = curl_multi_init(); + + foreach ($requests as $id => $data) { + $channels[$id] = curl_init($data['url']); + $curlOpts = $this->createCurlOptions($data['method'], $data['body'], $data['headers']); + curl_setopt_array($channels[$id], $curlOpts); + curl_multi_add_handle($multiHandle, $channels[$id]); + } + + return [$channels, $multiHandle]; + } + + /** + * Prepare response object + * + * @param resource $channel the curl resource + * @param string $content + * + * @return Response object + */ + private function parseResponse($channel, $content) + { + $headerSize = curl_getinfo($channel, CURLINFO_HEADER_SIZE); + $statusCode = curl_getinfo($channel, CURLINFO_HTTP_CODE); + + $responseBody = substr($content, $headerSize); + + $responseHeaders = substr($content, 0, $headerSize); + $responseHeaders = explode("\n", $responseHeaders); + $responseHeaders = array_map('trim', $responseHeaders); + + return new Response($statusCode, $responseBody, $responseHeaders); + } + + /** + * Retry request + * + * @param array $responseHeaders headers from rate limited response + * @param string $method the HTTP verb + * @param string $url the final url to call + * @param array $body request body + * @param array $headers original headers + * + * @return Response response object + */ + private function retryRequest(array $responseHeaders, $method, $url, $body, $headers) + { + $sleepDurations = $responseHeaders['X-Ratelimit-Reset'] - time(); + sleep($sleepDurations > 0 ? $sleepDurations : 0); + return $this->makeRequest($method, $url, $body, $headers, false); + } + + /** + * Make the API call and return the response. + * This is separated into it's own function, so we can mock it easily for testing. + * + * @param string $method the HTTP verb + * @param string $url the final url to call + * @param array $body request body + * @param array $headers any additional request headers + * @param bool $retryOnLimit should retry if rate limit is reach? + * + * @return Response object + */ + public function makeRequest($method, $url, $body = null, $headers = null, $retryOnLimit = false) + { + $channel = curl_init($url); + + $options = $this->createCurlOptions($method, $body, $headers); + + curl_setopt_array($channel, $options); + $content = curl_exec($channel); + + $response = $this->parseResponse($channel, $content); + + if ($response->statusCode() === self::TOO_MANY_REQUESTS_HTTP_CODE && $retryOnLimit) { + $responseHeaders = $response->headers(true); + return $this->retryRequest($responseHeaders, $method, $url, $body, $headers); + } + + curl_close($channel); + + return $response; + } + + /** + * Send all saved requests at once + * + * @param array $requests + * + * @return Response[] + */ + public function makeAllRequests(array $requests = []) + { + if (empty($requests)) { + $requests = $this->savedRequests; + } + list($channels, $multiHandle) = $this->createCurlMultiHandle($requests); + + // running all requests + $isRunning = null; + do { + curl_multi_exec($multiHandle, $isRunning); + } while ($isRunning); + + // get response and close all handles + $retryRequests = []; + $responses = []; + $sleepDurations = 0; + foreach ($channels as $id => $channel) { + + $content = curl_multi_getcontent($channel); + $response = $this->parseResponse($channel, $content); + + if ($response->statusCode() === self::TOO_MANY_REQUESTS_HTTP_CODE && $requests[$id]['retryOnLimit']) { + $headers = $response->headers(true); + $sleepDurations = max($sleepDurations, $headers['X-Ratelimit-Reset'] - time()); + $requestData = [ + 'method' => $requests[$id]['method'], + 'url' => $requests[$id]['url'], + 'body' => $requests[$id]['body'], + 'headers' => $headers, + ]; + $retryRequests[] = $this->createSavedRequest($requestData, false); + } else { + $responses[] = $response; + } + + curl_multi_remove_handle($multiHandle, $channel); + } + curl_multi_close($multiHandle); + + // retry requests + if (!empty($retryRequests)) { + sleep($sleepDurations > 0 ? $sleepDurations : 0); + $responses = array_merge($responses, $this->makeAllRequests($retryRequests)); + } + return $responses; + } + + /** + * Add variable values to the url. (e.g. /your/api/{variable_value}/call) + * Another example: if you have a PHP reserved word, such as and, in your url, you must use this method. + * + * @param string $name name of the url segment + * + * @return Client object + */ + public function _($name = null) + { + if (isset($name)) { + $this->path[] = $name; + } + $client = new static($this->host, $this->headers, $this->version, $this->path); + $client->setCurlOptions($this->curlOptions); + $client->setRetryOnLimit($this->retryOnLimit); + $this->path = []; + + return $client; + } + + /** + * Dynamically add method calls to the url, then call a method. + * (e.g. client.name.name.method()) + * + * @param string $name name of the dynamic method call or HTTP verb + * @param array $args parameters passed with the method call + * + * @return Client|Response|Response[]|null object + */ + public function __call($name, $args) + { + $name = strtolower($name); + + if ($name === 'version') { + $this->version = $args[0]; + return $this->_(); + } + + // send all saved requests + if (($name === 'send') && $this->isConcurrentRequest) { + return $this->makeAllRequests(); + } + + if (in_array($name, $this->methods, true)) { + $body = isset($args[0]) ? $args[0] : null; + $queryParams = isset($args[1]) ? $args[1] : null; + $url = $this->buildUrl($queryParams); + $headers = isset($args[2]) ? $args[2] : null; + $retryOnLimit = isset($args[3]) ? $args[3] : $this->retryOnLimit; + + if ($this->isConcurrentRequest) { + // save request to be sent later + $requestData = ['method' => $name, 'url' => $url, 'body' => $body, 'headers' => $headers]; + $this->savedRequests[] = $this->createSavedRequest($requestData, $retryOnLimit); + return null; + } + + return $this->makeRequest($name, $url, $body, $headers, $retryOnLimit); + } + + return $this->_($name); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/lib/Response.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/lib/Response.php new file mode 100644 index 0000000..f658f2c --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/php-http-client/lib/Response.php @@ -0,0 +1,113 @@ + + * @author Elmer Thomas + * @copyright 2018 SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/php-http-client + */ + +namespace SendGrid; + +/** + * Holds the response from an API call. + */ +class Response +{ + /** + * @var int + */ + protected $statusCode; + + /** + * @var string + */ + protected $body; + + /** + * @var array + */ + protected $headers; + + /** + * Setup the response data + * + * @param int $statusCode the status code. + * @param string $body the response body. + * @param array $headers an array of response headers. + */ + public function __construct($statusCode = 200, $body = '', array $headers = []) + { + $this->statusCode = $statusCode; + $this->body = $body; + $this->headers = $headers; + } + + /** + * The status code + * + * @return int + */ + public function statusCode() + { + return $this->statusCode; + } + + /** + * The response body + * + * @return string + */ + public function body() + { + return $this->body; + } + + /** + * The response headers + * + * @param bool $assoc + * + * @return array + */ + public function headers($assoc = false) + { + if (!$assoc) { + return $this->headers; + } + + return $this->prettifyHeaders($this->headers); + } + + /** + * Returns response headers as associative array + * + * @param array $headers + * + * @return array + */ + private function prettifyHeaders(array $headers) + { + return array_reduce( + array_filter($headers), + function ($result, $header) { + + if (false === strpos($header, ':')) { + $result['Status'] = trim($header); + + return $result; + } + + list($key, $value) = explode(':', $header, 2); + $result[trim($key)] = trim($value); + + return $result; + }, + [] + ); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.codeclimate.yml b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.codeclimate.yml new file mode 100644 index 0000000..bd9c6ec --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.codeclimate.yml @@ -0,0 +1,11 @@ +--- +engines: + duplication: + enabled: true + config: + languages: + - php + fixme: + enabled: true + phpmd: + enabled: true diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.editorconfig b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.editorconfig new file mode 100644 index 0000000..e18928d --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.editorconfig @@ -0,0 +1,8 @@ +root = true + +[*.php] +indent_style = space +indent_size = 4 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.env.sample b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.env.sample new file mode 100644 index 0000000..937e999 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.env.sample @@ -0,0 +1 @@ +export SENDGRID_API_KEY='' diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.github/ISSUE_TEMPLATE b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.github/ISSUE_TEMPLATE new file mode 100644 index 0000000..d378427 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.github/ISSUE_TEMPLATE @@ -0,0 +1,16 @@ +#### Issue Summary + +A summary of the issue and the environment in which it occurs. If suitable, include the steps required to reproduce the bug. Please feel free to include screenshots, screencasts, code examples. + +#### Steps to Reproduce + +1. This is the first step +2. This is the second step +3. Further steps, etc. + +Any other information you want to share that is relevant to the issue being reported. Especially, why do you consider this to be a bug? What do you expect to happen instead? + +#### Technical details: + +* sendgrid-php Version: master (latest commit: [commit number]) +* PHP Version: 5.6, 7.0, 7.1, 7.2 (as of May 17, 2018) diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.github/PULL_REQUEST_TEMPLATE b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.github/PULL_REQUEST_TEMPLATE new file mode 100644 index 0000000..d1e0450 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.github/PULL_REQUEST_TEMPLATE @@ -0,0 +1,26 @@ + +# Fixes # + +### Checklist +- [ ] I acknowledge that all my contributions will be made under the project's license +- [ ] I have made a material change to the repo (functionality, testing, spelling, grammar) +- [ ] I have read the [Contribution Guide] and my PR follows them. +- [ ] I updated my branch with the development branch. +- [ ] I have added tests that prove my fix is effective or that my feature works +- [ ] I have added necessary documentation about the functionality in the appropriate .md file +- [ ] I have added in line documentation to the code I modified + +### Short description of what this PR does: +- +- + +If you have questions, please send an email to [Twilio Sendgrid](mailto:dx@sendgrid.com), or file a Github Issue in this repository. diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.travis.yml b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.travis.yml new file mode 100644 index 0000000..c222a38 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/.travis.yml @@ -0,0 +1,33 @@ +language: php + +before_script: +- composer install +- "./test/prism.sh &" +- sleep 60 +- cd test + +script: +- "../vendor/bin/phpunit . --filter test*" + +after_script: +- cd ../ +after_success: +- bash <(curl -s https://codecov.io/bash) + +php: +- 5.6 +- 7.0 +- 7.1 +- 7.2 +- 7.3 + +notifications: + hipchat: + rooms: + secure: l4RUOBY44kVhSxx54NU3cmvn598rRMB7Y272Ct/W0fBm1tdGncp42A/rwg7JkiZH9EWXs3tKtoSjqw5xT6QeScUGQDdykS5QVO8lEIkDRGD4WwQ3VDJmRy1+04WtgqFEK8SyYTCcCl4ZJ0rtOcJZgDMvigkOJuLxwGXTDuvfu1k= + template: + - '%{repository} + Build %{build_number} on branch %{branch} by %{author}: %{message} + View on GitHub' + format: html + notify: true diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/CODE_OF_CONDUCT.md b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..2bd6362 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/CODE_OF_CONDUCT.md @@ -0,0 +1,38 @@ +# Twilio SendGrid Community Code of Conduct + +The Twilio SendGrid open source community is made up of members from around the globe with a diverse set of skills, personalities, and experiences. It is through these differences that our community experiences successes and continued growth. When you're working with members of the community, we encourage you to follow these guidelines, which help steer our interactions and strive to maintain a positive, successful and growing community. + +### Be Open +Members of the community are open to collaboration, whether it's on pull requests, code reviews, approvals, issues or otherwise. We're receptive to constructive comments and criticism, as the experiences and skill sets of all members contribute to the whole of our efforts. We're accepting of all who wish to take part in our activities, fostering an environment where anyone can participate, and everyone can make a difference. + +### Be Considerate +Members of the community are considerate of their peers, which include other contributors and users of Twilio SendGrid. We're thoughtful when addressing the efforts of others, keeping in mind that often the labor was completed with the intent of the good of the community. We're attentive in our communications, whether in person or online, and we're tactful when approaching differing views. + +### Be Respectful +Members of the community are respectful. We're respectful of others, their positions, their skills, their commitments and their efforts. We're respectful of the volunteer efforts that permeate the Twilio SendGrid community. We're respectful of the processes outlined in the community, and we work within them. When we disagree, we are courteous in raising our issues. Overall, we're good to each other. We contribute to this community not because we have to, but because we want to. If we remember that, these guidelines will come naturally. + +## Additional Guidance + +### Disclose Potential Conflicts of Interest +Community discussions often involve interested parties. We expect participants to be aware when they are conflicted due to employment or other projects they are involved in and disclose those interests to other project members. When in doubt, over-disclose. Perceived conflicts of interest are important to address so that the community’s decisions are credible even when unpopular, difficult or favorable to the interests of one group over another. + +### Interpretation +This Code is not exhaustive or complete. It is not a rulebook; it serves to distill our common understanding of a collaborative, shared environment and goals. We expect it to be followed in spirit as much as in the letter. When in doubt, try to abide by [Twilio SendGrid’s cultural values](https://sendgrid.com/blog/employee-engagement-the-4h-way) defined by our “4H’s”: Happy, Hungry, Humble and Honest. + +### Enforcement +Most members of the Twilio SendGrid community always comply with this Code, not because of the existence of this Code, but because they have long experience participating in open source communities where the conduct described above is normal and expected. However, failure to observe this Code may be grounds for suspension, reporting the user for abuse or changing permissions for outside contributors. + +## If you have concerns about someone’s conduct +**Initiate Direct Contact** - It is always appropriate to email a community member (if contact information is available), mention that you think their behavior was out of line, and (if necessary) point them to this Code. + +**Discuss Publicly** - Discussing publicly is always acceptable. Note, though, that approaching the person directly may be better, as it tends to make them less defensive, and it respects the time of other community members, so you probably want to try direct contact first. + +**Contact the Moderators** - You can reach the Twilio SendGrid moderators by emailing dx@sendgrid.com. + +## Attribution + +Twilio SendGrid thanks the following, on which it draws for content and inspiration: + +* [Python Community Code of Conduct](https://www.python.org/psf/codeofconduct/) +* [Open Source Initiative General Code of Conduct](https://opensource.org/codeofconduct) +* [Apache Code of Conduct](https://www.apache.org/foundation/policies/conduct.html) diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/LICENSE.md b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/LICENSE.md new file mode 100644 index 0000000..42495db --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/LICENSE.md @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2012-19 Twilio SendGrid, Inc. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/README.md b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/README.md new file mode 100644 index 0000000..79d38ee --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/README.md @@ -0,0 +1,232 @@ +![SendGrid Logo](https://github.com/sendgrid/sendgrid-python/raw/master/twilio_sendgrid_logo.png) + +[![BuildStatus](https://travis-ci.org/sendgrid/sendgrid-php.svg?branch=master)](https://travis-ci.org/sendgrid/sendgrid-php) +[![Packagist](https://img.shields.io/packagist/v/sendgrid/sendgrid.svg)](https://packagist.org/packages/sendgrid/sendgrid) +[![Downloads](https://img.shields.io/packagist/dt/sendgrid/sendgrid.svg?maxAge=3600)](https://packagist.org/packages/sendgrid/sendgrid) +[![Email Notifications Badge](https://dx.sendgrid.com/badge/php)](https://dx.sendgrid.com/newsletter/php) +[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE.md) +[![Twitter Follow](https://img.shields.io/twitter/follow/sendgrid.svg?style=social&label=Follow)](https://twitter.com/sendgrid) +[![GitHub contributors](https://img.shields.io/github/contributors/sendgrid/sendgrid-php.svg)](https://github.com/sendgrid/sendgrid-php/graphs/contributors) +[![Open Source Helpers](https://www.codetriage.com/sendgrid/sendgrid-php/badges/users.svg)](https://www.codetriage.com/sendgrid/sendgrid-php) + +**NEW:** +- Subscribe to email [notifications](https://dx.sendgrid.com/newsletter/php) for releases and breaking changes. +- Send SMS messages with [Twilio](https://github.com/sendgrid/sendgrid-php/blob/master/USE_CASES.md#sms). + +**This library allows you to quickly and easily use the Twilio SendGrid Web API v3 via PHP.** + +Version 7.X.X of this library provides full support for all Twilio SendGrid [Web API v3](https://sendgrid.com/docs/API_Reference/Web_API_v3/index.html) endpoints, including the new [v3 /mail/send](https://sendgrid.com/blog/introducing-v3mailsend-sendgrids-new-mail-endpoint). + +We want this library to be community driven and Twilio SendGrid led. Your help is needed to realize this goal. To help make sure we are building the right things in the right order, we ask that you create [issues](https://github.com/sendgrid/sendgrid-php/issues) and [pull requests](https://github.com/sendgrid/sendgrid-php/blob/master/CONTRIBUTING.md) or simply upvote or comment on existing issues or pull requests. + +Please browse the rest of this README for further details. + +We appreciate your continued support, thank you! + +# Table of Contents + +* [Installation](#installation) +* [Quick Start](#quick-start) +* [Use Cases](#use-cases) +* [Usage](#usage) +* [Announcements](#announcements) +* [Roadmap](#roadmap) +* [How to Contribute](#contribute) +* [Troubleshooting](#troubleshooting) +* [About](#about) +* [License](#license) + + +# Installation + +## Prerequisites + +- PHP version 5.6, 7.0, 7.1 or 7.2 +- The Twilio SendGrid service, starting at the [free level](https://sendgrid.com/free?source=sendgrid-php) to send up to 40,000 emails for the first 30 days, then send 100 emails/day free forever or check out [our pricing](https://sendgrid.com/pricing?source=sendgrid-php). +- For SMS messages, you will need a free [Twilio account](https://www.twilio.com/try-twilio?source=sendgrid-php). + +## Setup Environment Variables + +Update the development environment with your [SENDGRID_API_KEY](https://app.sendgrid.com/settings/api_keys), for example: + +1. Copy the sample env file to a new file named `.env` +```bash +cp .env.sample .env +``` +2. Edit the `.env` file to include your `SENDGRID_API_KEY` +3. Source the `.env` file +```bash +source ./.env +``` + +## Install Package + +Add Twilio SendGrid to your `composer.json` file. If you are not using [Composer](http://getcomposer.org), we highly recommend it. It's an excellent way to manage dependencies in your PHP application. + +```json +{ + "require": { + "sendgrid/sendgrid": "~7" + } +} +``` + +#### Alternative: Install package from zip + +If you are not using Composer, simply download and install the **[latest packaged release of the library as a zip](https://github.com/sendgrid/sendgrid-php/releases/download/v7.3.0/sendgrid-php.zip)**. + +[**⬇︎ Download Packaged Library ⬇︎**](https://github.com/sendgrid/sendgrid-php/releases/download/v7.3.0/sendgrid-php.zip) + +Previous versions of the library can be found in the [version index](https://sendgrid-open-source.s3.amazonaws.com/index.html) or downloaded directly from [GitHub](https://github.com/sendgrid/sendgrid-php/releases). + +## Dependencies + +- The Twilio SendGrid Service, starting at the [free level](https://sendgrid.com/free?source=sendgrid-php) +- The dependency free [php-http-client](https://github.com/sendgrid/php-http-client) + + +# Quick Start + +## Hello Email + +The following is the minimum needed code to send an email. You may find more examples in our USE_CASES file: + +```php +/sendgrid-php.php"); +// If not using Composer, uncomment the above line and +// download sendgrid-php.zip from the latest release here, +// replacing with the path to the sendgrid-php.php file, +// which is included in the download: +// https://github.com/sendgrid/sendgrid-php/releases + +$email = new \SendGrid\Mail\Mail(); +$email->setFrom("test@example.com", "Example User"); +$email->setSubject("Sending with Twilio SendGrid is Fun"); +$email->addTo("test@example.com", "Example User"); +$email->addContent("text/plain", "and easy to do anywhere, even with PHP"); +$email->addContent( + "text/html", "and easy to do anywhere, even with PHP" +); +$sendgrid = new \SendGrid(getenv('SENDGRID_API_KEY')); +try { + $response = $sendgrid->send($email); + print $response->statusCode() . "\n"; + print_r($response->headers()); + print $response->body() . "\n"; +} catch (Exception $e) { + echo 'Caught exception: '. $e->getMessage() ."\n"; +} +``` + +The `SendGrid\Mail` constructor creates a [personalization object](https://sendgrid.com/docs/Classroom/Send/v3_Mail_Send/personalizations.html) for you. [Here](https://github.com/sendgrid/sendgrid-php/blob/master/USE_CASES.md#kitchen-sink) is an example of how to add to it. + +## General v3 Web API Usage (With Fluent Interface) + +```php +/sendgrid-php.php"); +// If not using Composer, uncomment the above line and +// download sendgrid-php.zip from the latest release here, +// replacing with the path to the sendgrid-php.php file, +// which is included in the download: +// https://github.com/sendgrid/sendgrid-php/releases + +$apiKey = getenv('SENDGRID_API_KEY'); +$sg = new \SendGrid($apiKey); + +try { + $response = $sg->client->suppression()->bounces()->get(); + print $response->statusCode() . "\n"; + print_r($response->headers()); + print $response->body() . "\n"; +} catch (Exception $e) { + echo 'Caught exception: '. $e->getMessage(). "\n"; +} +``` + +## General v3 Web API Usage (Without Fluent Interface) + +```php +/sendgrid-php.php"); +// If not using Composer, uncomment the above line and +// download sendgrid-php.zip from the latest release here, +// replacing with the path to the sendgrid-php.php file, +// which is included in the download: +// https://github.com/sendgrid/sendgrid-php/releases + +$apiKey = getenv('SENDGRID_API_KEY'); +$sg = new \SendGrid($apiKey); + +try { + $response = $sg->client->_("suppression/bounces")->get(); + print $response->statusCode() . "\n"; + print_r($response->headers()); + print $response->body() . "\n"; +} catch (Exception $e) { + echo 'Caught exception: '. $e->getMessage(). "\n"; +} +``` + + +# Use Cases + +[Examples of common API use cases](https://github.com/sendgrid/sendgrid-php/blob/master/USE_CASES.md), such as how to send an email with a transactional template. + + +# Usage + +- [Twilio SendGrid Docs](https://sendgrid.com/docs/API_Reference/index.html) +- [Generic Library Usage + Documentation](https://github.com/sendgrid/sendgrid-php/tree/master/USAGE.md) +- [Example Code](https://github.com/sendgrid/sendgrid-php/blob/master/USE_CASES.md) + + +# Announcements + +v7 has been released! Please see the [release notes](https://github.com/sendgrid/sendgrid-php/releases/tag/v7.0.0) for details. + +All updates to this library are documented in our [CHANGELOG](https://github.com/sendgrid/sendgrid-php/blob/master/CHANGELOG.md) and [releases](https://github.com/sendgrid/sendgrid-php/releases). You may also subscribe to email [release notifications](https://dx.sendgrid.com/newsletter/php) for releases and breaking changes. + + +# Roadmap + +If you are interested in the future direction of this project, please take a look at our open [issues](https://github.com/sendgrid/sendgrid-php/issues) and [pull requests](https://github.com/sendgrid/sendgrid-php/pulls). We would love to hear your feedback. + + +# How to Contribute + +We encourage contribution to our libraries (you might even score some nifty swag), please see our [CONTRIBUTING](https://github.com/sendgrid/sendgrid-php/blob/master/CONTRIBUTING.md) guide for details. + +Quick links: + +- [Feature Request](https://github.com/sendgrid/sendgrid-php/blob/master/CONTRIBUTING.md#feature_request) +- [Bug Reports](https://github.com/sendgrid/sendgrid-php/blob/master/CONTRIBUTING.md#submit_a_bug_report) +- [Sign the CLA to Create a Pull Request](https://github.com/sendgrid/sendgrid-php/blob/master/CONTRIBUTING.md#cla) +- [Improvements to the Codebase](https://github.com/sendgrid/sendgrid-php/blob/master/CONTRIBUTING.md#improvements_to_the_codebase) +- [Review Pull Requests](https://github.com/sendgrid/sendgrid-php/blob/master/CONTRIBUTING.md#code-reviews) + + +# Troubleshooting + +Please see our [troubleshooting guide](https://github.com/sendgrid/sendgrid-php/blob/master/TROUBLESHOOTING.md) for common library issues. + + +# About + +sendgrid-php is guided and supported by the Twilio [Developer Experience Team](mailto:dx@sendgrid.com). + +sendgrid-php is maintained and funded by Twilio SendGrid, Inc. The names and logos for sendgrid-php are trademarks of Twilio SendGrid, Inc. + + +# License +[The MIT License (MIT)](LICENSE.txt) diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/composer.json b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/composer.json new file mode 100644 index 0000000..d7dea0e --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/composer.json @@ -0,0 +1,47 @@ +{ + "name": "sendgrid/sendgrid", + "description": "This library allows you to quickly and easily send emails through Twilio SendGrid using PHP.", + "version": "7.3.0", + "homepage": "http://github.com/sendgrid/sendgrid-php", + "license": "MIT", + "keywords": [ + "SendGrid", + "sendgrid", + "Twilio SendGrid", + "twilio sendgrid", + "email", + "send", + "grid" + ], + "require": { + "php": ">=5.6", + "sendgrid/php-http-client": "~3.9", + "ext-curl": "*", + "ext-json": "*", + "ext-mbstring": "*", + "ext-openssl": "*" + }, + "require-dev": { + "phpunit/phpunit": "^5.7.9 || ^6.4.3", + "squizlabs/php_codesniffer": "3.*", + "swaggest/json-diff": "^3.4" + }, + "replace": { + "sendgrid/sendgrid-php": "*" + }, + "type": "library", + "autoload": { + "psr-4": { + "SendGrid\\": "lib/", + "SendGrid\\Mail\\": "lib/mail/", + "SendGrid\\Contacts\\": "lib/contacts/", + "SendGrid\\Stats\\": "lib/stats/" + }, + "files": ["lib/SendGrid.php"] + }, + "autoload-dev": { + "psr-4": { + "SendGrid\\Tests\\": "test/" + } + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/Dockerfile b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/Dockerfile new file mode 100644 index 0000000..125579e --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/Dockerfile @@ -0,0 +1,22 @@ +FROM php:7.1-cli + +ENV OAI_SPEC_URL="https://raw.githubusercontent.com/sendgrid/sendgrid-oai/master/oai_stoplight.json" +ENV SENDGRID_API_KEY $SENDGRID_API_KEY + +# install Prism +WORKDIR /root + +# install Prism +ADD https://raw.githubusercontent.com/stoplightio/prism/master/install.sh install.sh +RUN chmod +x ./install.sh && sync && \ + ./install.sh && \ + rm ./install.sh + +# set up default Twilio SendGrid env +WORKDIR /root + +RUN mkdir sendgrid-php +COPY entrypoint.sh entrypoint.sh +RUN chmod +x entrypoint.sh +ENTRYPOINT ["./entrypoint.sh"] +CMD ["--mock"] diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/README.md b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/README.md new file mode 100644 index 0000000..7a2b4cb --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/README.md @@ -0,0 +1,50 @@ +Use Docker to easily try out or contribute to the sendgrid-php library. + +This Docker image contains: + - PHP 7.1.16 + - A running instance of [Stoplight.io's Prism](https://stoplight.io/platform/prism/), which lets you try out the Twilio SendGrid API without actually sending email + - A mirrored copy of sendgrid-php so that you may develop locally and then run the tests within the Docker container. + +# Table of Contents + +* [Quick Start](#quick-start) +* [Testing](#testing) +* [Contributing](#contributing) + + +# Quick Start + +0. Install Composer: + - `php -r "readfile('https://getcomposer.org/installer');" | php` + - `mv composer.phar /usr/local/bin/composer` +1. Clone the sendgrid-php repo + - `git clone https://github.com/sendgrid/sendgrid-php.git` + - `cd sendgrid-php` + - `composer install` +2. [Install Docker](https://docs.docker.com/install/) +3. [Setup local environment variable SENDGRID_API_KEY](https://github.com/sendgrid/sendgrid-php#setup-environment-variables) +4. Build Docker image, run Docker container, login to the Docker container + - `docker image build --tag="sendgrid/php7" ./docker` + - `docker run -itd --name="sendgrid_php7" -v $(pwd):/root/sendgrid-php sendgrid/php7 /bin/bash` +5. Run the tests within the Docker container + - `docker exec -it sendgrid_php7 /bin/bash -c 'cd sendgrid-php/test; ../vendor/bin/phpunit . --filter test*; exec "${SHELL:-sh}"'` + +Now you can continue development locally, and run `../vendor/bin/phpunit . --filter test*` inside of the container to test. Replace `test*` with the name of a particular test if you do not wish to run the entire suite of tests. + +To clean up the container: `docker stop sendgrid_php7 && docker rm sendgrid_php7`. + +Happy Hacking! + + +# For Testing the Library (Kick the Tires) + +- After step 5 in the QuickStart, within the Docker container: + - `cd ../` + - `php sendmail.php` + + +# For Contributors + +- Develop per usual locally, but before pushing up to GitHub, you can run the tests locally in the Docker container per step 5 of the quickstart. +- To run all the tests: `../vendor/bin/phpunit . --filter test*` +- To run an individual test: `../vendor/bin/phpunit . --filter [Name of Test]` diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/entrypoint.sh b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/entrypoint.sh new file mode 100644 index 0000000..fd2bcbd --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/docker/entrypoint.sh @@ -0,0 +1,15 @@ +#! /bin/bash +clear + +if [ "$1" != "--no-mock" ] +then + echo "Starting Prism in mock mode. Calls made to Prism will not actually send emails." + echo "Disable this by running this container with --no-mock." + prism run --mock --spec $OAI_SPEC_URL 2> /dev/null & +else + echo "Starting Prism in live (--no-mock) mode. Calls made to Prism will send emails." + prism run --spec $OAI_SPEC_URL 2> /dev/null & +fi + +cd sendgrid-php +exec $SHELL diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/SendGrid.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/SendGrid.php new file mode 100644 index 0000000..08ee1d6 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/SendGrid.php @@ -0,0 +1,77 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +/** + * This class is the interface to the Twilio SendGrid Web API + * + * @package SendGrid\Mail + */ +class SendGrid +{ + const VERSION = '7.3.0'; + + // @var string + protected $namespace = 'SendGrid'; + + // @var \SendGrid\Client + public $client; + // @var string + public $version = self::VERSION; + + /** + * Setup the HTTP Client + * + * @param string $apiKey Your Twilio SendGrid API Key. + * @param array $options An array of options, currently only "host", "curl" and + * "impersonateSubuser" are implemented. + */ + public function __construct($apiKey, $options = array()) + { + $headers = array( + 'Authorization: Bearer '.$apiKey, + 'User-Agent: sendgrid/' . $this->version . ';php', + 'Accept: application/json' + ); + + $host = isset($options['host']) ? $options['host'] : + 'https://api.sendgrid.com'; + + if (!empty($options['impersonateSubuser'])) { + $headers[] = 'On-Behalf-Of: '. $options['impersonateSubuser']; + } + + $curlOptions = isset($options['curl']) ? $options['curl'] : null; + + $this->client = new \SendGrid\Client( + $host, + $headers, + '/v3', + null, + $curlOptions + ); + } + + /** + * Make an API request + * + * @param \SendGrid\Mail\Mail $email A Mail object, containing the request object + * + * @return \SendGrid\Response + */ + public function send(\SendGrid\Mail\Mail $email) + { + return $this->client->mail()->send()->post($email); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/README.md b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/README.md new file mode 100644 index 0000000..601f3b3 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/README.md @@ -0,0 +1,16 @@ +# Recipients Helper + +**This helper allows you to quickly and easily build a subscription form to add contacts to your contactdb in Sendgrid.** + +## Quick Start + +Run the [example](https://github.com/sendgrid/sendgrid-php/blob/master/examples/helpers/contacts/recipients.php) (make sure you have set your environment variable to include your SENDGRID_API_KEY). + +```bash +php examples/helpers/contacts/recipients.php +``` + +## Usage + +- See this complete working [example](https://github.com/sendgrid/sendgrid-php/blob/master/examples/helpers/contacts/recipients.php). +- [Documentation](https://sendgrid.com/docs/API_Reference/api_v3.html#contacts-api-recipients) diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/Recipient.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/Recipient.php new file mode 100644 index 0000000..7eb00be --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/Recipient.php @@ -0,0 +1,92 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Contacts; +/** + * This class is used to construct a recipient for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Recipient implements \JsonSerializable +{ + /** @var $firstName string First name of the email recipient */ + private $firstName; + /** @var $lastName string Last name of the email recipient */ + private $lastName; + /** @var $email string Email address of the recipient */ + private $email; + + /** + * Create a recipient for the /mail/send API call + * + * @param string $firstName First name of the email recipient + * @param string $lastName Last name of the email recipient + * @param string $email Email address of the recipient + */ + public function __construct($firstName, $lastName, $email) + { + $this->firstName = $firstName; + $this->lastName = $lastName; + $this->email = $email; + } + + /** + * Retrieve the first name of the recipient + * + * @return string + */ + public function getFirstName() + { + return $this->firstName; + } + + /** + * Retrieve the last name of the recipient + * + * @return string + */ + public function getLastName() + { + return $this->lastName; + } + + /** + * Retrieve the email address of the recipient + * + * @return string + */ + public function getEmail() + { + return $this->email; + } + + /** + * Return an array representing a recipient object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'email' => $this->getEmail(), + 'first_name' => $this->getFirstName(), + 'last_name' => $this->getLastName() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/RecipientForm.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/RecipientForm.php new file mode 100644 index 0000000..18bbc53 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/contacts/RecipientForm.php @@ -0,0 +1,55 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Contacts; + +/** + * This class is used to build a html form and provides a submission + * endpoint for the form that makes a /contactdb/recipients API call. + * + * @package SendGrid\Contacts + */ +class RecipientForm +{ + /** @var $html string HTML content for the form */ + private $html; + + /** + * Form constructor + * + * @param string $url The url the form should submit to + */ + public function __construct($url) + { + $html = ' + First Name:
    + Last Name:
    + E-mail:
    + +'; + $this->html = $html; + } + + /** + * Return the HTML form + * + * @return string + */ + public function __toString() + { + return $this->html; + } + +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/loader.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/loader.php new file mode 100644 index 0000000..9e6a749 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/loader.php @@ -0,0 +1,54 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ +require_once __DIR__ . '/SendGrid.php'; +require_once __DIR__ . '/contacts/Recipient.php'; +require_once __DIR__ . '/contacts/RecipientForm.php'; +require_once __DIR__ . '/mail/EmailAddress.php'; +require_once __DIR__ . '/mail/Asm.php'; +require_once __DIR__ . '/mail/Attachment.php'; +require_once __DIR__ . '/mail/BatchId.php'; +require_once __DIR__ . '/mail/Bcc.php'; +require_once __DIR__ . '/mail/BccSettings.php'; +require_once __DIR__ . '/mail/BypassListManagement.php'; +require_once __DIR__ . '/mail/Category.php'; +require_once __DIR__ . '/mail/Cc.php'; +require_once __DIR__ . '/mail/ClickTracking.php'; +require_once __DIR__ . '/mail/Content.php'; +require_once __DIR__ . '/mail/CustomArg.php'; +require_once __DIR__ . '/mail/Footer.php'; +require_once __DIR__ . '/mail/From.php'; +require_once __DIR__ . '/mail/Ganalytics.php'; +require_once __DIR__ . '/mail/GroupId.php'; +require_once __DIR__ . '/mail/GroupsToDisplay.php'; +require_once __DIR__ . '/mail/Header.php'; +require_once __DIR__ . '/mail/HtmlContent.php'; +require_once __DIR__ . '/mail/IpPoolName.php'; +require_once __DIR__ . '/mail/Mail.php'; +require_once __DIR__ . '/mail/MailSettings.php'; +require_once __DIR__ . '/mail/MimeType.php'; +require_once __DIR__ . '/mail/OpenTracking.php'; +require_once __DIR__ . '/mail/Personalization.php'; +require_once __DIR__ . '/mail/PlainTextContent.php'; +require_once __DIR__ . '/mail/ReplyTo.php'; +require_once __DIR__ . '/mail/Section.php'; +require_once __DIR__ . '/mail/SandBoxMode.php'; +require_once __DIR__ . '/mail/SendAt.php'; +require_once __DIR__ . '/mail/SpamCheck.php'; +require_once __DIR__ . '/mail/Subject.php'; +require_once __DIR__ . '/mail/SubscriptionTracking.php'; +require_once __DIR__ . '/mail/Substitution.php'; +require_once __DIR__ . '/mail/TemplateId.php'; +require_once __DIR__ . '/mail/TrackingSettings.php'; +require_once __DIR__ . '/mail/To.php'; +require_once __DIR__ . '/stats/Stats.php'; diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Asm.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Asm.php new file mode 100644 index 0000000..c5f3643 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Asm.php @@ -0,0 +1,150 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Asm object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Asm implements \JsonSerializable +{ + /** @var $group_id int The unsubscribe group to associate with this email */ + private $group_id; + /** + * @var $groups_to_display int[] An array containing the unsubscribe groups that you + * would like to be displayed on the unsubscribe preferences page. + */ + private $groups_to_display; + + /** + * Optional constructor + * + * @param int|GroupId|null $group_id A GroupId object or the + * unsubscribe group to + * associate with this email + * @param int[]|GroupsToDisplay|null $groups_to_display A GroupsToDisplay + * object or an array + * containing the + * unsubscribe groups + * that you would like + * to be displayed + * on the unsubscribe + * preferences page. + */ + public function __construct( + $group_id = null, + $groups_to_display = null + ) { + if (isset($group_id)) { + $this->setGroupId($group_id); + } + if (isset($groups_to_display)) { + $this->setGroupsToDisplay($groups_to_display); + } + } + + /** + * Add the group id to a Asm object + * + * @param int|GroupId $group_id The unsubscribe group to associate with this + * email + * + * @throws TypeException + */ + public function setGroupId($group_id) + { + if ($group_id instanceof GroupId) { + $this->group_id = $group_id->getGroupId(); + } else { + if (!is_int($group_id)) { + throw new TypeException( + '$group_id must be an instance of Twilio SendGrid\Mail\GroupId or of type int.' + ); + } + $this->group_id = new GroupId($group_id); + } + return; + } + + /** + * Retrieve the GroupId object from a Asm object + * + * The unsubscribe group to associate with this email + * + * @return int + */ + public function getGroupId() + { + return $this->group_id; + } + + /** + * Add the groups to display id(s) to a Asm object + * + * @param int[]|GroupsToDisplay $groups_to_display A GroupsToDisplay + * object or an array + * containing the + * unsubscribe groups + * that you would like + * to be displayed + * on the unsubscribe + * preferences page. + * + * @throws TypeException + */ + public function setGroupsToDisplay($groups_to_display) + { + if ($groups_to_display instanceof GroupsToDisplay) { + $this->groups_to_display = $groups_to_display->getGroupsToDisplay(); + } else { + if (!is_array($groups_to_display)) { + throw new TypeException( + '$groups_to_display must be an instance of Twilio SendGrid\Mail\GroupsToDisplay or of type array.' + ); + } + $this->groups_to_display = new GroupsToDisplay($groups_to_display); + } + return; + } + + /** + * Retrieve the groups to display id(s) from a Asm object + * + * @return int[] + */ + public function getGroupsToDisplay() + { + return $this->groups_to_display; + } + + /** + * Return an array representing a Asm object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'group_id' => $this->getGroupId(), + 'groups_to_display' => $this->getGroupsToDisplay() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Attachment.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Attachment.php new file mode 100644 index 0000000..632781c --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Attachment.php @@ -0,0 +1,235 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Attachment object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Attachment implements \JsonSerializable +{ + /** @var $content string Base64 encoded content */ + private $content; + /** @var $type string Mime type of the attachment */ + private $type; + /** @var $filename string File name of the attachment */ + private $filename; + /** @var $disposition string How the attachment should be displayed: inline or attachment, default is attachment */ + private $disposition; + /** @var $content_id string Used when disposition is inline to diplay the file within the body of the email */ + private $content_id; + + /** + * Optional constructor + * + * @param string $content Base64 encoded content + * @param string $type Mime type of the attachment + * @param string $filename File name of the attachment + * @param string $disposition How the attachment should be displayed: inline + * or attachment, default is attachment + * @param string $content_id Used when disposition is inline to diplay the + * file within the body of the email + */ + public function __construct( + $content = null, + $type = null, + $filename = null, + $disposition = null, + $content_id = null + ) { + if (isset($content)) { + $this->setContent($content); + } + if (isset($type)) { + $this->setType($type); + } + if (isset($filename)) { + $this->setFilename($filename); + } + if (isset($disposition)) { + $this->setDisposition($disposition); + } + if (isset($content_id)) { + $this->setContentID($content_id); + } + } + + /** + * Add the content to a Attachment object + * + * @param string $content Base64 encoded content + * + * @throws TypeException + */ + public function setContent($content) + { + if (!is_string($content)) { + throw new TypeException('$content must be of type string.'); + } + if (!$this->isBase64($content)) { + $this->content = base64_encode($content); + } else { + $this->content = $content; + } + } + + /** + * Retrieve the content from a Attachment object + * + * @return string + */ + public function getContent() + { + return $this->content; + } + + /** + * Add the mime type to a Attachment object + * + * @param string $type Mime type of the attachment + * + * @throws TypeException + */ + public function setType($type) + { + if (!is_string($type)) { + throw new TypeException('$type must be of type string.'); + } + $this->type = $type; + } + + /** + * Retrieve the mime type from a Attachment object + * + * @return string + */ + public function getType() + { + return $this->type; + } + + /** + * Add the file name to a Attachment object + * + * @param string $filename File name of the attachment + * + * @throws TypeException + */ + public function setFilename($filename) + { + if (!is_string($filename)) { + throw new TypeException('$filename must be of type string'); + } + $this->filename = $filename; + } + + /** + * Retrieve the file name from a Attachment object + * + * @return string + */ + public function getFilename() + { + return $this->filename; + } + + /** + * Add the disposition to a Attachment object + * + * @param string $disposition How the attachment should be displayed: + * inline or attachment, default is attachment + * + * @throws TypeException + */ + public function setDisposition($disposition) + { + if (!is_string($disposition)) { + throw new TypeException('$disposition must be of type string.'); + } + $this->disposition = $disposition; + } + + /** + * Retrieve the disposition from a Attachment object + * + * @return string + */ + public function getDisposition() + { + return $this->disposition; + } + + /** + * Add the content id to a Attachment object + * + * @param string $content_id Used when disposition is inline to diplay + * the file within the body of the email + */ + public function setContentID($content_id) + { + if (!is_string($content_id)) { + throw new TypeException('$content_id must be of type string.'); + } + $this->content_id = $content_id; + } + + /** + * Retrieve the content id from a Attachment object + * + * @return string + */ + public function getContentID() + { + return $this->content_id; + } + + /** + * Verifies whether or not the provided string is a valid base64 string + * + * @param $string string The string that has to be checked + * @return bool + */ + private function isBase64($string) + { + $decoded_data = base64_decode($string, true); + $encoded_data = base64_encode($decoded_data); + if ($encoded_data != $string) { + return false; + } + return true; + } + + /** + * Return an array representing a Attachment object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'content' => $this->getContent(), + 'type' => $this->getType(), + 'filename' => $this->getFilename(), + 'disposition' => $this->getDisposition(), + 'content_id' => $this->getContentID() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BatchId.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BatchId.php new file mode 100644 index 0000000..508e60c --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BatchId.php @@ -0,0 +1,75 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a BatchId object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class BatchId implements \JsonSerializable +{ + /** @var $batch_id string This ID represents a batch of emails to be sent at the same time */ + private $batch_id; + + /** + * Optional constructor + * + * @param string|null $batch_id This ID represents a batch of emails to + * be sent at the same time + */ + public function __construct($batch_id = null) + { + if (isset($batch_id)) { + $this->setBatchId($batch_id); + } + } + + /** + * Add the batch id to a BatchId object + * + * @param string $batch_id This ID represents a batch of emails to be sent + * at the same time + * + * @throws TypeException + */ + public function setBatchId($batch_id) + { + if (!is_string($batch_id)) { + throw new TypeException('$batch_id must be of type string.'); + } + $this->batch_id = $batch_id; + } + + /** + * Return the batch id from a BatchId object + * + * @return string + */ + public function getBatchId() + { + return $this->batch_id; + } + + /** + * Return an array representing a BatchId object for the Twilio SendGrid API + * + * @return null|string + */ + public function jsonSerialize() + { + return $this->getBatchId(); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Bcc.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Bcc.php new file mode 100644 index 0000000..88a588c --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Bcc.php @@ -0,0 +1,24 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Bcc object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Bcc extends EmailAddress implements \JsonSerializable +{ +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BccSettings.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BccSettings.php new file mode 100644 index 0000000..1841f01 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BccSettings.php @@ -0,0 +1,118 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a BccSettings object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class BccSettings implements \JsonSerializable +{ + /** @var $enable bool Indicates if this setting is enabled */ + private $enable; + /** @var $email string The email address that you would like to receive the BCC */ + private $email; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + * @param string|null $email The email address that you would like + * to receive the BCC + */ + public function __construct($enable = null, $email = null) + { + if (isset($enable)) { + $this->setEnable($enable); + } + if (isset($email)) { + $this->setEmail($email); + } + } + + /** + * Update the enable setting on a BccSettings object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool.'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting on a BccSettings object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Add the email setting on a BccSettings object + * + * @param string $email The email address that you would like + * to receive the BCC + * + * @throws TypeException + */ + public function setEmail($email) + { + if (!is_string($email) && + filter_var($email, FILTER_VALIDATE_EMAIL) + ) { + throw new TypeException( + '$email must valid and be of type string.' + ); + } + $this->email = $email; + } + + /** + * Retrieve the email setting on a BccSettings object + * + * @return string + */ + public function getEmail() + { + return $this->email; + } + + /** + * Return an array representing a BccSettings object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable(), + 'email' => $this->getEmail() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BypassListManagement.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BypassListManagement.php new file mode 100644 index 0000000..9b6762d --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/BypassListManagement.php @@ -0,0 +1,87 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a BypassListManagement object for + * the /mail/send API call + * + * Allows you to bypass all unsubscribe groups and suppressions to + * ensure that the email is delivered to every single recipient. This + * should only be used in emergencies when it is absolutely necessary + * that every recipient receives your email + * + * @package SendGrid\Mail + */ +class BypassListManagement implements \JsonSerializable +{ + /** @var $enable bool Indicates if this setting is enabled */ + private $enable; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + */ + public function __construct($enable = null) + { + if (isset($enable)) { + $this->setEnable($enable); + } + } + + /** + * Update the enable setting on a BypassListManagement object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool.'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting on a BypassListManagement object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Return an array representing a BypassListManagement object for + * the SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Category.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Category.php new file mode 100644 index 0000000..ce94ddc --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Category.php @@ -0,0 +1,77 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Category object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Category implements \JsonSerializable +{ + /** @var $category string A category name for an email message. Each category name may not exceed 255 characters */ + private $category; + + /** + * Optional constructor + * + * @param string|null $category A category name for an email message. + * Each category name may not exceed 255 + * characters + */ + public function __construct($category = null) + { + if (isset($category)) { + $this->setCategory($category); + } + } + + /** + * Add a category to a Category object + * + * @param string $category A category name for an email message. + * Each category name may not exceed 255 + * characters + * + * @throws TypeException + */ + public function setCategory($category) + { + if (!is_string($category)) { + throw new TypeException('$category must be of type string.'); + } + $this->category = $category; + } + + /** + * Retrieve a category from a Category object + * + * @return string + */ + public function getCategory() + { + return $this->category; + } + + /** + * Return an array representing a Category object for the Twilio SendGrid API + * + * @return string + */ + public function jsonSerialize() + { + return $this->getCategory(); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Cc.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Cc.php new file mode 100644 index 0000000..70485ee --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Cc.php @@ -0,0 +1,24 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Cc object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Cc extends EmailAddress implements \JsonSerializable +{ +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/ClickTracking.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/ClickTracking.php new file mode 100644 index 0000000..abce412 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/ClickTracking.php @@ -0,0 +1,114 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a ClickTracking object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class ClickTracking implements \JsonSerializable +{ + /** @var $enable bool Indicates if this setting is enabled */ + private $enable; + /* @var $enable_text bool Indicates if this setting should be included in the text/plain portion of your email */ + private $enable_text; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + * @param bool|null $enable_text Indicates if this setting should be + * included in the text/plain portion of + * your email + */ + public function __construct($enable = null, $enable_text = null) + { + if (isset($enable)) { + $this->setEnable($enable); + } + if (isset($enable_text)) { + $this->setEnableText($enable_text); + } + } + + /** + * Update the enable setting on a ClickTracking object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool.'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting on a ClickTracking object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Update the enable text setting on a ClickTracking object + * + * @param bool $enable_text Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnableText($enable_text) + { + if (!is_bool($enable_text)) { + throw new TypeException('$enable_text must be of type bool'); + } + $this->enable_text = $enable_text; + } + + /** + * Retrieve the enable_text setting on a ClickTracking object + * + * @return bool + */ + public function getEnableText() + { + return $this->enable_text; + } + + /** + * Return an array representing a ClickTracking object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable(), + 'enable_text' => $this->getEnableText() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Content.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Content.php new file mode 100644 index 0000000..62417d5 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Content.php @@ -0,0 +1,118 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Content object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Content implements \JsonSerializable +{ + /** @var $type string The mime type of the content you are including in your email. For example, “text/plain” or “text/html” */ + private $type; + /** @var $value string The actual content of the specified mime type that you are including in your email */ + private $value; + + /** + * Optional constructor + * + * @param string|null $type The mime type of the content you are including + * in your email. For example, “text/plain” or + * “text/html” + * @param string|null $value The actual content of the specified mime type + * that you are including in your email + */ + public function __construct($type = null, $value = null) + { + if (isset($type)) { + $this->setType($type); + } + if (isset($value)) { + $this->setValue($value); + } + } + + /** + * Add the mime type on a Content object + * + * @param string $type The mime type of the content you are including + * in your email. For example, “text/plain” or + * “text/html” + * + * @throws TypeException + */ + public function setType($type) + { + if (!is_string($type)) { + throw new TypeException('$type must be of type string.'); + } + $this->type = $type; + } + + /** + * Retrieve the mime type on a Content object + * + * @return string + */ + public function getType() + { + return $this->type; + } + + /** + * Add the content value to a Content object + * + * @param string $value The actual content of the specified mime type + * that you are including in your email + * + * @throws TypeException + */ + public function setValue($value) + { + if (!is_string($value)) { + throw new TypeException('$value must be of type string'); + } + $this->value = mb_convert_encoding($value, 'UTF-8', 'UTF-8'); + } + + /** + * Retrieve the content value to a Content object + * + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * Return an array representing a Contact object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'type' => $this->getType(), + 'value' => $this->getValue() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/CustomArg.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/CustomArg.php new file mode 100644 index 0000000..031f035 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/CustomArg.php @@ -0,0 +1,119 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a CustomArg object for the /mail/send API call + * + * Values that are specific to the entire send that will be carried along with the + * email and its activity data. Substitutions will not be made on custom arguments, + * so any string that is entered into this parameter will be assumed to be the + * custom argument that you would like to be used. This parameter is overridden by + * personalizations[x].custom_args if that parameter has been defined. Total custom + * args size may not exceed 10,000 bytes. + * + * @package SendGrid\Mail + */ +class CustomArg implements \JsonSerializable +{ + /** @var $key string Custom arg key */ + private $key; + /** @var $value string Custom arg value */ + private $value; + + /** + * Optional constructor + * + * @param string|null $key Custom arg key + * @param string|null $value Custom arg value + */ + public function __construct($key = null, $value = null) + { + if (isset($key)) { + $this->setKey($key); + } + if (isset($value)) { + $this->setValue($value); + } + } + + /** + * Add a custom arg key on a CustomArg object + * + * @param string $key Custom arg key + * + * @throws TypeException + */ + public function setKey($key) + { + if (!is_string($key)) { + throw new TypeException('$key must be of type string'); + } + $this->key = (string) $key; + } + + /** + * Retrieve a custom arg key on a CustomArg object + * + * @return string + */ + public function getKey() + { + return $this->key; + } + + /** + * Add a custom arg value on a CustomArg object + * + * @param string $value Custom arg value + * + * @throws TypeException + */ + public function setValue($value) + { + if (!is_string($value)) { + throw new TypeException('$value must be of type string.'); + } + $this->value = (string) $value; + } + + /** + * Retrieve a custom arg key on a CustomArg object + * + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * Return an array representing a CustomArg object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'key' => $this->getKey(), + 'value' => $this->getValue() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/EmailAddress.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/EmailAddress.php new file mode 100644 index 0000000..88299f5 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/EmailAddress.php @@ -0,0 +1,222 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a EmailAddress object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class EmailAddress implements \JsonSerializable +{ + /** @var $name string The name of the person associated with the email */ + private $name; + /** @var $email string The email address */ + private $email; + /** @var $substitutions Substitution[] An array of key/value substitutions to be be applied to the text and html content of the email body */ + private $substitutions; + /** @var $subject Subject The personalized subject of the email */ + private $subject; + + /** + * Optional constructor + * + * @param string|null $emailAddress The email address + * @param string|null $name The name of the person associated with + * the email + * @param array|null $substitutions An array of key/value substitutions to + * be be applied to the text and html content + * of the email body + * @param string|null $subject The personalized subject of the email + */ + public function __construct( + $emailAddress = null, + $name = null, + $substitutions = null, + $subject = null + ) { + if (isset($emailAddress)) { + $this->setEmailAddress($emailAddress); + } + if (isset($name) && $name !== null) { + $this->setName($name); + } + if (isset($substitutions)) { + $this->setSubstitutions($substitutions); + } + if (isset($subject)) { + $this->setSubject($subject); + } + } + + /** + * Add the email address to a EmailAddress object + * + * @param string $emailAddress The email address + * + * @throws TypeException + */ + public function setEmailAddress($emailAddress) + { + if (!(is_string($emailAddress) && + filter_var($emailAddress, FILTER_VALIDATE_EMAIL)) + ) { + throw new TypeException( + '$emailAddress must be valid and of type string.' + ); + } + $this->email = $emailAddress; + } + + /** + * Retrieve the email address from a EmailAddress object + * + * @return string + */ + public function getEmailAddress() + { + return $this->email; + } + + /** + * Retrieve the email address from a EmailAddress object + * + * @return string + */ + public function getEmail() + { + return $this->getEmailAddress(); + } + + /** + * Add a name to a EmailAddress object + * + * @param string $name The name of the person associated with the email + * + * @throws TypeException + */ + public function setName($name) + { + if (!is_string($name)) { + throw new TypeException('$name must be of type string.'); + } + + /* + Issue #368 + ========== + If the name is not wrapped in double quotes and contains a comma or + semicolon, the API fails to parse it correctly. + When wrapped in double quotes, commas, semicolons and unescaped single + quotes are supported. + Escaped double quotes are supported as well but will appear unescaped in + the mail (e.g. "O\'Keefe"). + Double quotes will be shown in some email clients, so the name should + only be wrapped when necessary. + */ + // Only wrapp in double quote if comma or semicolon are found + if (false !== strpos($name, ',') || false !== strpos($name, ';')) { + // Unescape quotes + $name = stripslashes(html_entity_decode($name, ENT_QUOTES)); + // Escape only double quotes + $name = str_replace('"', '\\"', $name); + // Wrapp in double quotes + $name = '"' . $name . '"'; + } + $this->name = (!empty($name)) ? $name : null; + } + + /** + * Retrieve the name from a EmailAddress object + * + * @return string + */ + public function getName() + { + return $this->name; + } + + /** + * Add substitutions to a EmailAddress object + * + * @param array $substitutions An array of key/value substitutions to + * be be applied to the text and html content + * of the email body + * + * @throws TypeException + */ + public function setSubstitutions($substitutions) + { + if (!is_array($substitutions)) { + throw new TypeException('$substitutions must be an array.'); + } + + $this->substitutions = $substitutions; + } + + /** + * Retrieve substitutions from a EmailAddress object + */ + public function getSubstitutions() + { + return $this->substitutions; + } + + /** + * Add a subject to a EmailAddress object + * + * @param string $subject The personalized subject of the email + * + * @throws TypeException + */ + public function setSubject($subject) + { + if (!is_string($subject)) { + throw new TypeException('$subject must be of type string.'); + } + if (!($subject instanceof Subject)) { + $this->subject = new Subject($subject); + } else { + $this->subject = $subject; + } + } + + /** + * Retrieve a subject from a EmailAddress object + * + * @return Subject + */ + public function getSubject() + { + return $this->subject; + } + + /** + * Return an array representing a EmailAddress object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'name' => $this->getName(), + 'email' => $this->getEmail() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Footer.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Footer.php new file mode 100644 index 0000000..92d2f4b --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Footer.php @@ -0,0 +1,144 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Footer object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Footer implements \JsonSerializable +{ + /** @var $enable bool Indicates if this setting is enabled */ + private $enable; + /** @var $text string The plain text content of your footer */ + private $text; + /** @var $html string The HTML content of your footer */ + private $html; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + * @param string|null $text The plain text content of your footer + * @param string|null $html The HTML content of your footer + */ + public function __construct($enable = null, $text = null, $html = null) + { + if (isset($enable)) { + $this->setEnable($enable); + } + if (isset($text)) { + $this->setText($text); + } + if (isset($html)) { + $this->setHtml($html); + } + } + + /** + * Update the enable setting on a Footer object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting on a Footer object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Add text to a Footer object + * + * @param string $text The plain text content of your footer + * + * @throws TypeException + */ + public function setText($text) + { + if (!is_string($text)) { + throw new TypeException('$text must be of type string.'); + } + $this->text = $text; + } + + /** + * Retrieve text to a Footer object + * + * @return string + */ + public function getText() + { + return $this->text; + } + + /** + * Add html to a Footer object + * + * @param string $html The HTML content of your footer + * + * @throws TypeException + */ + public function setHtml($html) + { + if (!is_string($html)) { + throw new TypeException('$html must be of type string.'); + } + $this->html = $html; + } + + /** + * Retrieve html from a Footer object + * + * @return string + */ + public function getHtml() + { + return $this->html; + } + + /** + * Return an array representing a Footer object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable(), + 'text' => $this->getText(), + 'html' => $this->getHtml() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/From.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/From.php new file mode 100644 index 0000000..602000a --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/From.php @@ -0,0 +1,24 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a From object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class From extends EmailAddress implements \JsonSerializable +{ +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Ganalytics.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Ganalytics.php new file mode 100644 index 0000000..2d51188 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Ganalytics.php @@ -0,0 +1,251 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Ganalytics object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Ganalytics implements \JsonSerializable +{ + /** @var $enable bool Indicates if this setting is enabled */ + private $enable; + /** @var $utm_source string Name of the referrer source. (e.g. Google, SomeDomain.com, or Marketing Email) */ + private $utm_source; + /** @var $utm_medium string Name of the marketing medium. (e.g. Email) */ + private $utm_medium; + /** @var $utm_term string Used to identify any paid keywords */ + private $utm_term; + /** @var $utm_content string Used to differentiate your campaign from advertisements */ + private $utm_content; + /** @var $utm_campaign string The name of the campaign */ + private $utm_campaign; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + * @param string|null $utm_source Name of the referrer source. (e.g. + * Google, SomeDomain.com, or Marketing Email) + * @param string|null $utm_medium Name of the marketing medium. (e.g. Email) + * @param string|null $utm_term Used to identify any paid keywords + * @param string|null $utm_content Used to differentiate your campaign from + * advertisements + * @param string|null $utm_campaign The name of the campaign + */ + public function __construct( + $enable = null, + $utm_source = null, + $utm_medium = null, + $utm_term = null, + $utm_content = null, + $utm_campaign = null + ) + { + if (isset($enable)) { + $this->setEnable($enable); + } + if (isset($utm_source)) { + $this->setCampaignSource($utm_source); + } + if (isset($utm_medium)) { + $this->setCampaignMedium($utm_medium); + } + if (isset($utm_term)) { + $this->setCampaignTerm($utm_term); + } + if (isset($utm_content)) { + $this->setCampaignContent($utm_content); + } + if (isset($utm_campaign)) { + $this->setCampaignName($utm_campaign); + } + } + + /** + * Update the enable setting on a Ganalytics object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool.'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting on a Ganalytics object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Add the campaign source to a Ganalytics object + * + * @param string $utm_source Name of the referrer source. (e.g. + * Google, SomeDomain.com, or Marketing Email) + * + * @throws TypeException + */ + public function setCampaignSource($utm_source) + { + if (!is_string($utm_source)) { + throw new TypeException('$utm_source must be of type string.'); + } + $this->utm_source = $utm_source; + } + + /** + * Return the campaign source from a Ganalytics object + * + * @return string + */ + public function getCampaignSource() + { + return $this->utm_source; + } + + /** + * Add the campaign medium to a Ganalytics object + * + * @param string $utm_medium Name of the marketing medium. (e.g. Email) + * + * @throws TypeException + */ + public function setCampaignMedium($utm_medium) + { + if (!is_string($utm_medium)) { + throw new TypeException('$utm_medium must be of type string.'); + } + $this->utm_medium = $utm_medium; + } + + /** + * Return the campaign medium from a Ganalytics object + * + * @return string + */ + public function getCampaignMedium() + { + return $this->utm_medium; + } + + /** + * Add the campaign term to a Ganalytics object + * + * @param string $utm_term Used to identify any paid keywords + * + * @throws TypeException + */ + public function setCampaignTerm($utm_term) + { + if (!is_string($utm_term)) { + throw new TypeException('$utm_term must be of type string'); + } + $this->utm_term = $utm_term; + } + + /** + * Return the campaign term from a Ganalytics object + * + * @return string + */ + public function getCampaignTerm() + { + return $this->utm_term; + } + + /** + * Add the campaign content to a Ganalytics object + * + * @param string $utm_content Used to differentiate your campaign from + * advertisements + * + * @throws TypeException + */ + public function setCampaignContent($utm_content) + { + if (!is_string($utm_content)) { + throw new TypeException('$utm_content must be of type string.'); + } + $this->utm_content = $utm_content; + } + + /** + * Return the campaign content from a Ganalytics object + * + * @return string + */ + public function getCampaignContent() + { + return $this->utm_content; + } + + /** + * Add the campaign name to a Ganalytics object + * + * @param string $utm_campaign The name of the campaign + * + * @throws TypeException + */ + public function setCampaignName($utm_campaign) + { + if (!is_string($utm_campaign)) { + throw new TypeException('$utm_campaign must be of type string.'); + } + $this->utm_campaign = $utm_campaign; + } + + /** + * Return the campaign name from a Ganalytics object + * + * @return string + */ + public function getCampaignName() + { + return $this->utm_campaign; + } + + /** + * Return an array representing a Ganalytics object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable(), + 'utm_source' => $this->getCampaignSource(), + 'utm_medium' => $this->getCampaignMedium(), + 'utm_term' => $this->getCampaignTerm(), + 'utm_content' => $this->getCampaignContent(), + 'utm_campaign' => $this->getCampaignName() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/GroupId.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/GroupId.php new file mode 100644 index 0000000..64c52a7 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/GroupId.php @@ -0,0 +1,73 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a GroupId object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class GroupId implements \JsonSerializable +{ + /** @var $group_id int The unsubscribe group to associate with this email */ + private $group_id; + + /** + * Optional constructor + * + * @param int|null $group_id The unsubscribe group to associate with this email + */ + public function __construct($group_id = null) + { + if (isset($group_id)) { + $this->setGroupId($group_id); + } + } + + /** + * Add the group id to a GroupId object + * + * @param int $group_id The unsubscribe group to associate with this email + * + * @throws TypeException + */ + public function setGroupId($group_id) + { + if (!is_int($group_id)) { + throw new TypeException('$group_id must be of type int.'); + } + $this->group_id = $group_id; + } + + /** + * Retrieve the group id from a GroupId object + * + * @return int + */ + public function getGroupId() + { + return $this->group_id; + } + + /** + * Return an array representing a GroupId object for the Twilio SendGrid API + * + * @return int + */ + public function jsonSerialize() + { + return $this->getGroupId(); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/GroupsToDisplay.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/GroupsToDisplay.php new file mode 100644 index 0000000..7ed1120 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/GroupsToDisplay.php @@ -0,0 +1,87 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a GroupsToDisplay object for + * the /mail/send API call + * + * @package SendGrid\Mail + */ +class GroupsToDisplay implements \JsonSerializable +{ + /** @var $groups_to_display int[] An array containing the unsubscribe groups that you would like to be displayed on the unsubscribe preferences page. Maximum of 25 */ + private $groups_to_display; + + /** + * Optional constructor + * + * @param int[]|int|null $groups_to_display An array containing + * the unsubscribe groups + * that you would like to + * be displayed on the + * unsubscribe preferences + * page. Maximum of 25 + */ + public function __construct($groups_to_display = null) + { + if (isset($groups_to_display)) { + $this->setGroupsToDisplay($groups_to_display); + } + } + + /** + * Add a group to display on a GroupsToDisplay object + * + * @param int|int[] $groups_to_display The unsubscribe group(s) + * that you would like to be + * displayed on the unsubscribe + * preferences page + * + * @throws TypeException + * @return null + */ + public function setGroupsToDisplay($groups_to_display) + { + if (!is_array($groups_to_display)) { + throw new TypeException('$groups_to_display must be an array.'); + } + if (is_array($groups_to_display)) { + $this->groups_to_display = $groups_to_display; + } else { + $this->groups_to_display[] = $groups_to_display; + } + } + + /** + * Return the group(s) to display on a GroupsToDisplay object + * + * @return int[] + */ + public function getGroupsToDisplay() + { + return $this->groups_to_display; + } + + /** + * Return an array representing a GroupsToDisplay object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return $this->getGroupsToDisplay(); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Header.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Header.php new file mode 100644 index 0000000..aa901cf --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Header.php @@ -0,0 +1,116 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Header object for the /mail/send API call + * + * An object containing key/value pairs of header names and the value to substitute + * for them. You must ensure these are properly encoded if they contain unicode + * characters. Must not be one of the reserved headers + * + * @package SendGrid\Mail + */ +class Header implements \JsonSerializable +{ + /** @var $key string Header key */ + private $key; + /** @var $value string Header value */ + private $value; + + /** + * Optional constructor + * + * @param string|null $key Header key + * @param string|null $value Header value + */ + public function __construct($key = null, $value = null) + { + if (isset($key)) { + $this->setKey($key); + } + if (isset($value)) { + $this->setValue($value); + } + } + + /** + * Add the key on a Header object + * + * @param string $key Header key + * + * @throws TypeException + */ + public function setKey($key) + { + if (!is_string($key)) { + throw new TypeException('$key must be of type string.'); + } + $this->key = $key; + } + + /** + * Retrieve the key from a Header object + * + * @return string + */ + public function getKey() + { + return $this->key; + } + + /** + * Add the value on a Header object + * + * @param string $value Header value + * + * @throws TypeException + */ + public function setValue($value) + { + if (!is_string($value)) { + throw new TypeException('$value must be of type string.'); + } + $this->value = $value; + } + + /** + * Retrieve the value from a Header object + * + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * Return an array representing a Header object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'key' => $this->getKey(), + 'value' => $this->getValue() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/HtmlContent.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/HtmlContent.php new file mode 100644 index 0000000..b8d6e9b --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/HtmlContent.php @@ -0,0 +1,33 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Content object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class HtmlContent extends Content +{ + /** + * Create a Content object with a HTML mime type + * + * @param string $value HTML formatted content + */ + public function __construct($value) + { + parent::__construct(MimeType::HTML, $value); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/IpPoolName.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/IpPoolName.php new file mode 100644 index 0000000..5e0cdeb --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/IpPoolName.php @@ -0,0 +1,77 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a IpPoolName object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class IpPoolName implements \JsonSerializable +{ + /** @var $ip_pool_name string The IP Pool that you would like to send this email from. Minimum length: 2, Maximum Length: 64 */ + private $ip_pool_name; + + /** + * Optional constructor + * + * @param string|null $ip_pool_name The IP Pool that you would like to + * send this email from. Minimum length: + * 2, Maximum Length: 64 + */ + public function __construct($ip_pool_name = null) + { + if (isset($ip_pool_name)) { + $this->setIpPoolName($ip_pool_name); + } + } + + /** + * Set the ip pool name on a IpPoolName object + * + * @param string $ip_pool_name The IP Pool that you would like to + * send this email from. Minimum length: + * 2, Maximum Length: 64 + * + * @throws TypeException + */ + public function setIpPoolName($ip_pool_name) + { + if (!is_string($ip_pool_name)) { + throw new TypeException('$ip_pool_name must be of type string.'); + } + $this->ip_pool_name = $ip_pool_name; + } + + /** + * Retrieve the ip pool name from a IpPoolName object + * + * @return string + */ + public function getIpPoolName() + { + return $this->ip_pool_name; + } + + /** + * Return an array representing a IpPoolName object for the Twilio SendGrid API + * + * @return string + */ + public function jsonSerialize() + { + return $this->getIpPoolName(); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Mail.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Mail.php new file mode 100644 index 0000000..86a5128 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Mail.php @@ -0,0 +1,1911 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a request body for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Mail implements \JsonSerializable +{ + /** @var $from From Email address of the sender */ + private $from; + + /** @var $subject Subject Subject of the email */ + private $subject; + + /** @var $contents Content[] Content(s) of the email */ + private $contents; + + /** @var $attachments Attachment[] Email attachments */ + private $attachments; + + /** @var $template_id TemplateId Id of a template that you would like to use */ + private $template_id; + + /** @var $sections Section[] Key/value pairs that define block sections of code to be used as substitutions */ + private $sections; + + /** @var $headers Header[] Header names and the value to substitute for them */ + private $headers; + + /** @var $categories Category[] Category names for this message */ + private $categories; + + /** @var $custom_args CustomArg[] Values that are specific to the entire send that will be carried along with the email and its activity data */ + private $custom_args; + + /** @var $substitutions Substitution[] Substitutions that will apply to the text and html content of the body of your email, in addition to the subject and reply-to parameters */ + private $substitutions; + + /** @var $send_at SendAt A unix timestamp allowing you to specify when you want your email to be delivered */ + private $send_at; + + /** @var $batch_id BatchId This ID represents a batch of emails to be sent at the same time */ + private $batch_id; + + /** @var $asm ASM Specifies how to handle unsubscribes */ + private $asm; + + /** @var $ip_pool_name IpPoolName The IP Pool that you would like to send this email from */ + private $ip_pool_name; + + /** @var $mail_settings MailSettings A collection of different mail settings that you can use to specify how you would like this email to be handled */ + private $mail_settings; + + /** @var $tracking_settings TrackingSettings Settings to determine how you would like to track the metrics of how your recipients interact with your email */ + private $tracking_settings; + + /** @var $reply_to ReplyTo Email to be use when replied to */ + private $reply_to; + + /** @var $personalization Personalization[] Messages and their metadata */ + private $personalization; + + const VERSION = "7.0.0"; + + /** + * If passing parameters into this constructor include + * $from, $to, $subject, $plainTextContent and + * $htmlContent at a minimum. In that case, a Personalization + * object will be created for you. + * + * @param From|null $from Email address of the sender + * @param To|To[]|null $to Recipient(s) email + * address(es) + * @param Subject|Subject[]|null $subject Subject(s) + * @param PlainTextContent|null $plainTextContent Plain text version of + * content + * @param HtmlContent|null $htmlContent Html version of content + * @param Substitution[]|null $globalSubstitutions Substitutions for entire + * email + */ + public function __construct( + $from = null, + $to = null, + $subject = null, + $plainTextContent = null, + $htmlContent = null, + array $globalSubstitutions = null + ) { + if (!isset($from) + && !isset($to) + && !isset($subject) + && !isset($plainTextContent) + && !isset($htmlContent) + && !isset($globalSubstitutions) + ) { + $this->personalization[] = new Personalization(); + return; + } + if (isset($from)) { + $this->setFrom($from); + } + if (isset($to)) { + if (!is_array($to)) { + $to = [$to]; + } + $subjectCount = 0; + $personalization = new Personalization(); + foreach ($to as $email) { + if ($subs = $email->getSubstitutions()) { + $personalization = new Personalization(); + } + $personalization->addTo($email); + if ($subs = $email->getSubstitutions()) { + foreach ($subs as $key => $value) { + $personalization->addSubstitution($key, $value); + } + } + if ($email->getSubject()) { + $personalization->setSubject($email->getSubject()); + } + if (is_array($subject)) { + if ($subjectCount < sizeof($subject)) { + $personalization->setSubject($subject[$subjectCount]); + } + $subjectCount++; + } + if (is_array($globalSubstitutions)) { + foreach ($globalSubstitutions as $key => $value) { + $personalization->addSubstitution($key, $value); + } + } + if ($subs = $email->getSubstitutions()) { + $this->addPersonalization($personalization); + } + } + if (!$subs = $email->getSubstitutions()) { + $this->addPersonalization($personalization); + } + } + if (isset($subject)) { + if (!is_array($subject)) { + $this->setSubject($subject); + } + } + if (isset($plainTextContent)) { + $this->addContent($plainTextContent); + } + if (isset($htmlContent)) { + $this->addContent($htmlContent); + } + } + + /** + * Adds a To, Cc or Bcc object to a Personalization object + * + * @param string $emailType Object type name: + * To, Cc or Bcc + * @param string $email Recipient email + * address + * @param string|null $name Recipient name + * @param Substitution[]|array|null $substitutions Personalized + * substitutions + * @param int|null $personalizationIndex Index into an array + * of existing + * Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + * + * @return null + */ + private function addRecipientEmail( + $emailType, + $email, + $name = null, + $substitutions = null, + $personalizationIndex = null, + $personalization = null + ) { + $personalizationFunctionCall = "add" . $emailType; + $emailType = "\SendGrid\Mail\\" . $emailType; + if (!($email instanceof $emailType)) { + $email = new $emailType( + $email, + $name, + $substitutions + ); + } + if ($personalization != null) { + $personalization->$personalizationFunctionCall($email); + if ($subs = $email->getSubstitutions()) { + foreach ($subs as $key => $value) { + $personalization->addSubstitution($key, $value); + } + } + $this->addPersonalization($personalization); + return; + } else { + if (isset($personalizationIndex) + && !isset($this->personalization[$personalizationIndex]) + ) { + // TODO: We should only do this if there exists an index + // previous. For example, if given an index 3 and there is + // no index 2, we should throw an error. + $this->personalization[$personalizationIndex] + = new Personalization(); + } + if ($this->personalization[0] != null && $personalizationIndex == 0) { + $this->personalization[0]->$personalizationFunctionCall($email); + if ($subs = $email->getSubstitutions()) { + foreach ($subs as $key => $value) { + $this->personalization[0]->addSubstitution($key, $value); + } + } + return; + } else if ($this->personalization[$personalizationIndex] != null) { + $this->personalization[$personalizationIndex]->$personalizationFunctionCall($email); + if ($subs = $email->getSubstitutions()) { + foreach ($subs as $key => $value) { + $this->personalization[$personalizationIndex]->addSubstitution( + $key, + $value + ); + } + } + return; + } else { + $personalization = new Personalization(); + $personalization->$personalizationFunctionCall($email); + if ($subs = $email->getSubstitutions()) { + foreach ($subs as $key => $value) { + $personalization->addSubstitution($key, $value); + } + } + if (($personalizationIndex != 0) + && ($this->getPersonalizationCount() <= $personalizationIndex) + ) { + $this->personalization[$personalizationIndex] = $personalization; + } else { + $this->addPersonalization($personalization); + } + return; + } + } + } + + /** + * Adds an array of To, Cc or Bcc objects to a Personalization object + * + * @param string $emailType Object type name: To, Cc + * or Bcc + * @param To[]|Cc[]|Bcc[] $emails Array of email recipients + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A Personalization object + */ + private function addRecipientEmails( + $emailType, + $emails, + $personalizationIndex = null, + $personalization = null + ) { + $emailFunctionCall = "add" . $emailType; + + if (current($emails) instanceof EmailAddress) { + foreach ($emails as $email) { + $this->$emailFunctionCall( + $email, + $name = null, + $personalizationIndex, + $personalization + ); + } + } else { + foreach ($emails as $email => $name) { + $this->$emailFunctionCall( + $email, + $name, + $personalizationIndex, + $personalization + ); + } + } + } + + /** + * Add a Personalization object to the Mail object + * + * @param Personalization $personalization A Personalization object + */ + public function addPersonalization($personalization) + { + $this->personalization[] = $personalization; + } + + /** + * Retrieve a Personalization object from the Mail object + * + * @return Personalization[] + */ + public function getPersonalizations() + { + return $this->personalization; + } + + /** + * Retrieve the number of Personalization objects associated with the Mail object + * + * @return int + */ + public function getPersonalizationCount() + { + return count($this->personalization); + } + + /** + * Adds an email recipient to a Personalization object + * + * @param string|To $to Email address or To object + * @param string $name Recipient name + * @param array|Substitution[] $substitutions Personalized substitutions + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addTo( + $to, + $name = null, + $substitutions = null, + $personalizationIndex = null, + $personalization = null + ) { + if ($to instanceof To) { + $name = $to->getName(); + $substitutions = $to->getSubstitutions(); + $to = $to->getEmailAddress(); + } + $this->addRecipientEmail( + "To", + $to, + $name, + $substitutions, + $personalizationIndex, + $personalization + ); + } + + /** + * Adds multiple email recipients to a Personalization object + * + * @param To[]|array $toEmails Array of To objects or + * key/value pairs of email + * address/recipient names + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addTos( + $toEmails, + $personalizationIndex = null, + $personalization = null + ) { + $this->addRecipientEmails( + "To", + $toEmails, + $personalizationIndex, + $personalization + ); + } + + /** + * Adds an email cc recipient to a Personalization object + * + * @param string|Cc $cc Email address or Cc object + * @param string $name Recipient name + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addCc( + $cc, + $name = null, + $personalizationIndex = null, + $personalization = null + ) { + if ($cc instanceof Cc) { + $name = $cc->getName(); + $cc = $cc->getEmailAddress(); + } + $this->addRecipientEmail( + "Cc", + $cc, + $name, + $personalizationIndex, + $personalization + ); + } + + /** + * Adds multiple email cc recipients to a Personalization object + * + * @param Cc[]|array $ccEmails Array of Cc objects or + * key/value pairs of email + * address/recipient names + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addCcs( + $ccEmails, + $personalizationIndex = null, + $personalization = null + ) { + $this->addRecipientEmails( + "Cc", + $ccEmails, + $personalizationIndex, + $personalization + ); + } + + /** + * Adds an email bcc recipient to a Personalization object + * + * @param string|Bcc $bcc Email address or Bcc object + * @param string $name Recipient name + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addBcc( + $bcc, + $name = null, + $personalizationIndex = null, + $personalization = null + ) { + if ($bcc instanceof Bcc) { + $name = $bcc->getName(); + $bcc = $bcc->getEmailAddress(); + } + $this->addRecipientEmail( + "Bcc", + $bcc, + $name, + $personalizationIndex, + $personalization + ); + } + + /** + * Adds multiple email bcc recipients to a Personalization object + * + * @param Bcc[]|array $bccEmails Array of Bcc objects or + * key/value pairs of email + * address/recipient names + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addBccs( + $bccEmails, + $personalizationIndex = null, + $personalization = null + ) { + $this->addRecipientEmails( + "Bcc", + $bccEmails, + $personalizationIndex, + $personalization + ); + } + + /** + * Add a subject to a Personalization or Mail object + * + * If you don't provide a Personalization object or index, the + * subject will be global to entire message. Note that + * subjects added to Personalization objects override + * global subjects. + * + * @param string|Subject $subject Email subject + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function setSubject( + $subject, + $personalizationIndex = null, + $personalization = null + ) { + if (!($subject instanceof Subject)) { + $subject = new Subject($subject); + } + + if ($personalization != null) { + $personalization->setSubject($subject); + $this->addPersonalization($personalization); + return; + } + if ($personalizationIndex != null) { + $this->personalization[$personalizationIndex]->setSubject($subject); + return; + } + $this->setGlobalSubject($subject); + return; + } + + /** + * Retrieve a subject attached to a Personalization object + * + * @param int|0 $personalizationIndex Index into an array of + * existing Personalization + * objects + * + * @return Subject + */ + public function getSubject($personalizationIndex = 0) + { + return $this->personalization[$personalizationIndex]->getSubject(); + } + + /** + * Add a header to a Personalization or Mail object + * + * If you don't provide a Personalization object or index, the + * header will be global to entire message. Note that + * headers added to Personalization objects override + * global headers. + * + * @param string|Header $key Key or Header object + * @param string|null $value Value + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addHeader( + $key, + $value = null, + $personalizationIndex = null, + $personalization = null + ) { + $header = null; + if ($key instanceof Header) { + $h = $key; + $header = new Header($h->getKey(), $h->getValue()); + } else { + $header = new Header($key, $value); + } + if ($personalization != null) { + $personalization->addHeader($header); + $this->addPersonalization($personalization); + return; + } else { + if ($this->personalization[0] != null) { + $this->personalization[0]->addHeader($header); + } else if ($this->personalization[$personalizationIndex] != null) { + $this->personalization[$personalizationIndex]->addHeader($header); + } else { + $personalization = new Personalization(); + $personalization->addHeader($header); + if (($personalizationIndex != 0) + && ($this->getPersonalizationCount() <= $personalizationIndex) + ) { + $this->personalization[$personalizationIndex] = $personalization; + } else { + $this->addPersonalization($personalization); + } + } + return; + } + } + + /** + * Adds multiple headers to a Personalization or Mail object + * + * If you don't provide a Personalization object or index, the + * header will be global to entire message. Note that + * headers added to Personalization objects override + * global headers. + * + * @param array|Header[] $headers Array of Header objects + * or key values + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addHeaders( + $headers, + $personalizationIndex = null, + $personalization = null + ) { + if (current($headers) instanceof Header) { + foreach ($headers as $header) { + $this->addHeader($header); + } + } else { + foreach ($headers as $key => $value) { + $this->addHeader( + $key, + $value, + $personalizationIndex, + $personalization + ); + } + } + } + + /** + * Retrieve the headers attached to a Personalization object + * + * @param int|0 $personalizationIndex Index into an array of + * existing Personalization + * objects + * + * @return Header[] + */ + public function getHeaders($personalizationIndex = 0) + { + return $this->personalization[$personalizationIndex]->getHeaders(); + } + + /** + * Add a DynamicTemplateData object or key/value to a Personalization object + * + * @param DynamicTemplateData|string $data DynamicTemplateData object or the key of a + * dynamic data + * @param string|null $value Value + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addDynamicTemplateData( + $key, + $value = null, + $personalizationIndex = null, + $personalization = null + ) { + $this->addSubstitution($key, $value, $personalizationIndex, $personalization); + } + + /** + * Add a DynamicTemplateData object or key/value to a Personalization object + * + * @param array|DynamicTemplateData[] $data Array of DynamicTemplateData objects or key/values + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addDynamicTemplateDatas( + $datas, + $personalizationIndex = null, + $personalization = null + ) { + $this->addSubstitutions($datas); + } + + /** + * Retrieve dynamic template data key/value pairs from a Personalization object + * + * @param int|0 $personalizationIndex Index into an array of + * existing Personalization + * objects + * + * @return array + */ + public function getDynamicTemplateDatas($personalizationIndex = 0) + { + return $this->getSubstitutions($personalizationIndex); + } + + /** + * Add a substitution to a Personalization or Mail object + * + * If you don't provide a Personalization object or index, the + * substitution will be global to entire message. Note that + * substitutions added to Personalization objects override + * global substitutions. + * + * @param string|Substitution $key Key or Substitution object + * @param string|null $value Value + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + * + * @return null + */ + public function addSubstitution( + $key, + $value = null, + $personalizationIndex = null, + $personalization = null + ) { + $substitution = null; + if ($key instanceof Substitution) { + $s = $key; + $substitution = new Substitution($s->getKey(), $s->getValue()); + } else { + $substitution = new Substitution($key, $value); + } + if ($personalization != null) { + $personalization->addSubstitution($substitution); + $this->addPersonalization($personalization); + return; + } else { + if ($this->personalization[0] != null) { + $this->personalization[0]->addSubstitution($substitution); + } else if ($this->personalization[$personalizationIndex] != null) { + $this->personalization[$personalizationIndex]->addSubstitution($substitution); + } else { + $personalization = new Personalization(); + $personalization->addSubstitution($substitution); + if (($personalizationIndex != 0) + && ($this->getPersonalizationCount() <= $personalizationIndex) + ) { + $this->personalization[$personalizationIndex] = $personalization; + } else { + $this->addPersonalization($personalization); + } + } + return; + } + } + + /** + * Adds multiple substitutions to a Personalization or Mail object + * + * If you don't provide a Personalization object or index, the + * substitution will be global to entire message. Note that + * substitutions added to Personalization objects override + * global headers. + * + * @param array|Substitution[] $substitutions Array of Substitution + * objects or key/values + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * ersonalization object + */ + public function addSubstitutions( + $substitutions, + $personalizationIndex = null, + $personalization = null + ) { + if (current($substitutions) instanceof Substitution) { + foreach ($substitutions as $substitution) { + $this->addSubstitution($substitution); + } + } else { + foreach ($substitutions as $key => $value) { + $this->addSubstitution( + $key, + $value, + $personalizationIndex, + $personalization + ); + } + } + } + + /** + * Retrieve the substitutions attached to a Personalization object + * + * @param int|0 $personalizationIndex Index into an array of + * existing Personalization + * objects + * + * @return Substitution[] + */ + public function getSubstitutions($personalizationIndex = 0) + { + return $this->personalization[$personalizationIndex]->getSubstitutions(); + } + + /** + * Add a custom arg to a Personalization or Mail object + * + * Note that custom args added to Personalization objects + * override global custom args. + * + * @param string|CustomArg $key Key or CustomArg object + * @param string|null $value Value + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addCustomArg( + $key, + $value = null, + $personalizationIndex = null, + $personalization = null + ) { + $custom_arg = null; + if ($key instanceof CustomArg) { + $ca = $key; + $custom_arg = new CustomArg($ca->getKey(), $ca->getValue()); + } else { + $custom_arg = new CustomArg($key, $value); + } + if ($personalization != null) { + $personalization->addCustomArg($custom_arg); + $this->addPersonalization($personalization); + return; + } else { + if ($this->personalization[0] != null) { + $this->personalization[0]->addCustomArg($custom_arg); + } else if ($this->personalization[$personalizationIndex] != null) { + $this->personalization[$personalizationIndex]->addCustomArg( + $custom_arg + ); + } else { + $personalization = new Personalization(); + $personalization->addCustomArg($custom_arg); + if (($personalizationIndex != 0) + && ($this->getPersonalizationCount() <= $personalizationIndex) + ) { + $this->personalization[$personalizationIndex] = $personalization; + } else { + $this->addPersonalization($personalization); + } + } + return; + } + } + + /** + * Adds multiple custom args to a Personalization or Mail object + * + * If you don't provide a Personalization object or index, the + * custom arg will be global to entire message. Note that + * custom args added to Personalization objects override + * global custom args. + * + * @param array|CustomArg[] $custom_args Array of CustomArg objects + * or key/values + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function addCustomArgs( + $custom_args, + $personalizationIndex = null, + $personalization = null + ) { + if (current($custom_args) instanceof CustomArg) { + foreach ($custom_args as $custom_arg) { + $this->addCustomArg($custom_arg); + } + } else { + foreach ($custom_args as $key => $value) { + $this->addCustomArg( + $key, + $value, + $personalizationIndex, + $personalization + ); + } + } + } + + /** + * Retrieve the custom args attached to a Personalization object + * + * @param int|0 $personalizationIndex Index into an array of + * existing Personalization + * objects + * + * @return CustomArg[] + */ + public function getCustomArgs($personalizationIndex = 0) + { + return $this->personalization[$personalizationIndex]->getCustomArgs(); + } + + /** + * Add a unix timestamp allowing you to specify when you want your + * email to be delivered to a Personalization or Mail object + * + * If you don't provide a Personalization object or index, the + * send at timestamp will be global to entire message. Note that + * timestamps added to Personalization objects override + * global timestamps. + * + * @param int|SendAt $send_at A unix timestamp + * @param int|null $personalizationIndex Index into an array of + * existing Personalization + * objects + * @param Personalization|null $personalization A pre-created + * Personalization object + */ + public function setSendAt( + $send_at, + $personalizationIndex = null, + $personalization = null + ) { + if (!($send_at instanceof SendAt)) { + $send_at = new SendAt($send_at); + } + if ($personalization != null) { + $personalization->setSendAt($send_at); + $this->addPersonalization($personalization); + return; + } else { + if ($this->personalization[0] != null) { + $this->personalization[0]->setSendAt($send_at); + return; + } else if ($this->personalization[$personalizationIndex] != null) { + $this->personalization[$personalizationIndex]->setSendAt($send_at); + return; + } else { + $personalization = new Personalization(); + $personalization->setSendAt($send_at); + if (($personalizationIndex != 0) + && ($this->getPersonalizationCount() <= $personalizationIndex) + ) { + $this->personalization[$personalizationIndex] = $personalization; + } else { + $this->addPersonalization($personalization); + } + return; + } + } + } + + /** + * Retrieve the unix timestamp attached to a Personalization object + * + * @param int|0 $personalizationIndex Index into an array of + * existing Personalization + * objects + * + * @return SendAt + */ + public function getSendAt($personalizationIndex = 0) + { + return $this->personalization[$personalizationIndex]->getSendAt(); + } + + /** + * Add the sender email address to a Mail object + * + * @param string|From $email Email address or From object + * @param string|null $name Sender name + * + * @throws TypeException + */ + public function setFrom($email, $name = null) + { + if ($email instanceof From) { + $this->from = $email; + } else { + + if ( + is_string($email) && filter_var($email, FILTER_VALIDATE_EMAIL) + ) { + $this->from = new From($email, $name); + } else { + throw new TypeException( + '$email must be valid and of type string.' + ); + } + + } + return; + } + + /** + * Retrieve the sender attached to a Mail object + * + * @return From + */ + public function getFrom() + { + return $this->from; + } + + /** + * Add the reply to email address to a Mail object + * + * @param string|ReplyTo $email Email address or From object + * @param string|null $name Reply to name + */ + public function setReplyTo($email, $name = null) + { + if ($email instanceof ReplyTo) { + $this->reply_to = $email; + } else { + $this->reply_to = new ReplyTo($email, $name); + } + } + + /** + * Retrieve the reply to information attached to a Mail object + * + * @return ReplyTo + */ + public function getReplyTo() + { + return $this->reply_to; + } + + + /** + * Add a subject to a Mail object + * + * Note that + * subjects added to Personalization objects override + * global subjects. + * + * @param string|Subject $subject Email subject + */ + public function setGlobalSubject($subject) + { + if (!($subject instanceof Subject)) { + $subject = new Subject($subject); + } + $this->subject = $subject; + } + + /** + * Retrieve a subject attached to a Mail object + * + * @return Subject + */ + public function getGlobalSubject() + { + return $this->subject; + } + + /** + * Add content to a Mail object + * + * For a list of pre-configured mime types, please see + * MimeType.php + * + * @param string|Content $type Mime type or Content object + * @param string|null $value Contents (e.g. text or html) + */ + public function addContent($type, $value = null) + { + if ($type instanceof Content) { + $content = $type; + } else { + $content = new Content($type, $value); + } + $this->contents[] = $content; + } + + /** + * Adds multiple Content objects to a Mail object + * + * @param array|Content[] $contents Array of Content objects + * or key value pairs + */ + public function addContents($contents) + { + if (current($contents) instanceof Content) { + foreach ($contents as $content) { + $this->addContent($content); + } + } else { + foreach ($contents as $key => $value) { + $this->addContent($key, $value); + } + } + } + + /** + * Retrieve the contents attached to a Mail object + * + * Will return array of Content Objects with text/plain MimeType first + * Array re-ordered before return where this is not already the case + * + * @return Content[] + */ + public function getContents() + { + if ($this->contents) { + if ($this->contents[0]->getType() !== 'text/plain' + && count($this->contents) > 1 + ) { + foreach ($this->contents as $key => $value) { + if ($value->getType() == 'text/plain') { + $plain_content = $value; + unset($this->contents[$key]); + break; + } + } + array_unshift($this->contents, $plain_content); + } + } + + return $this->contents; + } + + /** + * Add an attachment to a Mail object + * + * @param string|Attachment $attachment Attachment object or + * Base64 encoded content + * @param string|null $type Mime type of the attachment + * @param string|null $filename File name of the attachment + * @param string|null $disposition How the attachment should be + * displayed: inline or attachment + * default is attachment + * @param string|null $content_id Used when disposition is inline + * to diplay the file within the + * body of the email + */ + public function addAttachment( + $attachment, + $type = null, + $filename = null, + $disposition = null, + $content_id = null + ) { + if (is_array($attachment)) { + $attachment = new Attachment( + $attachment[0], + $attachment[1], + $attachment[2], + $attachment[3], + $attachment[4] + ); + } else if (!($attachment instanceof Attachment)) { + $attachment = new Attachment( + $attachment, + $type, + $filename, + $disposition, + $content_id + ); + } + $this->attachments[] = $attachment; + } + + /** + * Adds multiple attachments to a Mail object + * + * @param array|Attachment[] $attachments Array of Attachment objects + * or arrays + */ + public function addAttachments($attachments) + { + foreach ($attachments as $attachment) { + $this->addAttachment($attachment); + } + } + + /** + * Retrieve the attachments attached to a Mail object + * + * @return Attachment[] + */ + public function getAttachments() + { + return $this->attachments; + } + + /** + * Add a template id to a Mail object + * + * @param string $template_id The id of the template to be + * appied to this email + */ + public function setTemplateId($template_id) + { + if (!($template_id instanceof TemplateId)) { + $template_id = new TemplateId($template_id); + } + + $this->template_id = $template_id; + } + + /** + * Retrieve a template id attached to a Mail object + * + * @return TemplateId + */ + public function getTemplateId() + { + return $this->template_id; + } + + /** + * Add a section to a Mail object + * + * @param string|Section $key Key or Section object + * @param string|null $value Value + */ + public function addSection($key, $value = null) + { + if ($key instanceof Section) { + $section = $key; + $this->sections[$section->getKey()] + = $section->getValue(); + return; + } + $this->sections[$key] = (string)$value; + } + + /** + * Adds multiple sections to a Mail object + * + * @param array|Section[] $sections Array of CustomArg objects + * or key/values + */ + public function addSections($sections) + { + if (current($sections) instanceof Section) { + foreach ($sections as $section) { + $this->addSection($section); + } + } else { + foreach ($sections as $key => $value) { + $this->addSection($key, $value); + } + } + } + + /** + * Retrieve the section(s) attached to a Mail object + * + * @return Section[] + */ + public function getSections() + { + return $this->sections; + } + + /** + * Add a header to a Mail object + * + * Note that headers added to Personalization objects override + * global headers. + * + * @param string|Header $key Key or Header object + * @param string|null $value Value + */ + public function addGlobalHeader($key, $value = null) + { + if ($key instanceof Header) { + $header = $key; + $this->headers[$header->getKey()] + = $header->getValue(); + return; + } + $this->headers[$key] = (string)$value; + } + + /** + * Adds multiple headers to a Mail object + * + * Note that headers added to Personalization objects override + * global headers. + * + * @param array|Header[] $headers Array of Header objects + * or key values + */ + public function addGlobalHeaders($headers) + { + if (current($headers) instanceof Header) { + foreach ($headers as $header) { + $this->addGlobalHeader($header); + } + } else { + foreach ($headers as $key => $value) { + $this->addGlobalHeader($key, $value); + } + } + } + + /** + * Retrieve the headers attached to a Mail object + * + * @return Header[] + */ + public function getGlobalHeaders() + { + return $this->headers; + } + + /** + * Add a substitution to a Mail object + * + * Note that substitutions added to Personalization objects override + * global substitutions. + * + * @param string|Substitution $key Key or Substitution object + * @param string|null $value Value + */ + public function addGlobalSubstitution($key, $value = null) + { + if ($key instanceof Substitution) { + $substitution = $key; + $this->substitutions[$substitution->getKey()] + = $substitution->getValue(); + return; + } + $this->substitutions[$key] = $value; + } + + /** + * Adds multiple substitutions to a Mail object + * + * Note that substitutions added to Personalization objects override + * global headers. + * + * @param array|Substitution[] $substitutions Array of Substitution + * objects or key/values + */ + public function addGlobalSubstitutions($substitutions) + { + if (current($substitutions) instanceof Substitution) { + foreach ($substitutions as $substitution) { + $this->addGlobalSubstitution($substitution); + } + } else { + foreach ($substitutions as $key => $value) { + $this->addGlobalSubstitution($key, $value); + } + } + } + + /** + * Retrieve the substitutions attached to a Mail object + * + * @return Substitution[] + */ + public function getGlobalSubstitutions() + { + return $this->substitutions; + } + + /** + * Add a category to a Mail object + * + * @param string|Category $category Category object or category name + */ + public function addCategory($category) + { + if (!($category instanceof Category)) { + $category = new Category($category); + } + $this->categories[] = $category; + } + + /** + * Adds multiple categories to a Mail object + * + * @param array|Category[] $categories Array of Category objects + * or arrays + */ + public function addCategories($categories) + { + foreach ($categories as $category) { + $this->addCategory($category); + } + return; + } + + /** + * Retrieve the categories attached to a Mail object + * + * @return Category[] + */ + public function getCategories() + { + return $this->categories; + } + + /** + * Add a custom arg to a Mail object + * + * Note that custom args added to Personalization objects override + * global custom args. + * + * @param string|CustomArg $key Key or CustomArg object + * @param string|null $value Value + */ + public function addGlobalCustomArg($key, $value = null) + { + if ($key instanceof CustomArg) { + $custom_arg = $key; + $this->custom_args[$custom_arg->getKey()] + = $custom_arg->getValue(); + return; + } + $this->custom_args[$key] = (string)$value; + } + + /** + * Adds multiple custom args to a Mail object + * + * Note that custom args added to Personalization objects override + * global custom args. + * + * @param array|CustomArg[] $custom_args Array of CustomArg objects + * or key/values + */ + public function addGlobalCustomArgs($custom_args) + { + if (current($custom_args) instanceof CustomArg) { + foreach ($custom_args as $custom_arg) { + $this->addGlobalCustomArg($custom_arg); + } + } else { + foreach ($custom_args as $key => $value) { + $this->addGlobalCustomArg($key, $value); + } + } + } + + /** + * Retrieve the custom args attached to a Mail object + * + * @return CustomArg[] + */ + public function getGlobalCustomArgs() + { + return $this->custom_args; + } + + /** + * Add a unix timestamp allowing you to specify when you want your + * email to be delivered to a Mail object + * + * Note that timestamps added to Personalization objects override + * global timestamps. + * + * @param int|SendAt $send_at A unix timestamp + */ + public function setGlobalSendAt($send_at) + { + if (!($send_at instanceof SendAt)) { + $send_at = new SendAt($send_at); + } + $this->send_at = $send_at; + } + + /** + * Retrieve the unix timestamp attached to a Mail object + * + * @return SendAt + */ + public function getGlobalSendAt() + { + return $this->send_at; + } + + /** + * Add a batch id to a Mail object + * + * @param string|BatchId $batch_id Id for a batch of emails + * to be sent at the same time + */ + public function setBatchId($batch_id) + { + if (!($batch_id instanceof BatchId)) { + $batch_id = new BatchId($batch_id); + } + $this->batch_id = $batch_id; + } + + /** + * Retrieve the batch id attached to a Mail object + * + * @return BatchId + */ + public function getBatchId() + { + return $this->batch_id; + } + + /** + * Add a Asm describing how to handle unsubscribes to a Mail object + * + * @param int|Asm $group_id Asm object or unsubscribe group id + * to associate this email with + * @param array $groups_to_display Array of integer ids of unsubscribe + * groups to be displayed on the + * unsubscribe preferences page + */ + public function setAsm($group_id, $groups_to_display = null) + { + if ($group_id instanceof Asm) { + $asm = $group_id; + $this->asm = $asm; + } else { + $this->asm = new Asm($group_id, $groups_to_display); + } + } + + /** + * Retrieve the Asm object describing how to handle unsubscribes attached + * to a Mail object + * + * @return Asm + */ + public function getAsm() + { + return $this->asm; + } + + /** + * Add the IP pool name to a Mail object + * + * @param string|IpPoolName $ip_pool_name The IP Pool that you would + * like to send this email from + */ + public function setIpPoolName($ip_pool_name) + { + if ($ip_pool_name instanceof IpPoolName) { + $this->ip_pool_name = $ip_pool_name->getIpPoolName(); + } else { + $this->ip_pool_name = new IpPoolName($ip_pool_name); + } + + } + + /** + * Retrieve the IP pool name attached to a Mail object + * + * @return IpPoolName + */ + public function getIpPoolName() + { + return $this->ip_pool_name; + } + + /** + * Add a MailSettings object to a Mail object + * + * @param MailSettings $mail_settings A collection of different + * mail settings that you can + * use to specify how you would + * like this email to be handled + * @throws TypeException + */ + public function setMailSettings($mail_settings) + { + if (!($mail_settings instanceof MailSettings)) { + throw new TypeException( + '$mail_settings must be an instance of SendGrid\Mail\MailSettings' + ); + } + $this->mail_settings = $mail_settings; + } + + /** + * Retrieve the MailSettings object attached to a Mail object + * + * @return MailSettings + */ + public function getMailSettings() + { + return $this->mail_settings; + } + + /** + * Set the Bcc settings on a MailSettings object + * + * @param bool|BccSettings $enable A BccSettings object or a boolean + * to determine if this setting is active + * @param string|null $email The email address to be bcc'ed + */ + public function setBccSettings($enable, $email = null) + { + if (!($this->mail_settings instanceof MailSettings)) { + $this->mail_settings = new MailSettings(); + } + $this->mail_settings->setBccSettings($enable, $email); + } + + /** + * Enable bypass list management on a MailSettings object + * + * Allows you to bypass all unsubscribe groups and suppressions to ensure + * that the email is delivered to every single recipient. This should only + * be used in emergencies when it is absolutely necessary that every + * recipient receives your email. + */ + public function enableBypassListManagement() + { + if (!$this->mail_settings instanceof MailSettings) { + $this->mail_settings = new MailSettings(); + } + $this->mail_settings->setBypassListManagement(true); + } + + /** + * Disable bypass list management on a MailSettings object + * + * Allows you to bypass all unsubscribe groups and suppressions to ensure + * that the email is delivered to every single recipient. This should only + * be used in emergencies when it is absolutely necessary that every + * recipient receives your email. + */ + public function disableBypassListManagement() + { + if (!($this->mail_settings instanceof MailSettings)) { + $this->mail_settings = new MailSettings(); + } + $this->mail_settings->setBypassListManagement(false); + } + + /** + * Set the Footer settings on a MailSettings object + * + * @param bool|Footer $enable A Footer object or a boolean + * to determine if this setting is active + * @param string|null $text The plain text content of the footer + * @param string|null $html The HTML content of the footer + */ + public function setFooter($enable = null, $text = null, $html = null) + { + if (!$this->mail_settings instanceof MailSettings) { + $this->mail_settings = new MailSettings(); + } + $this->mail_settings->setFooter($enable, $text, $html); + } + + /** + * Enable sandbox mode on a MailSettings object + * + * This allows you to send a test email to ensure that your request + * body is valid and formatted correctly. + */ + public function enableSandBoxMode() + { + if (!($this->mail_settings instanceof MailSettings)) { + $this->mail_settings = new MailSettings(); + } + $this->mail_settings->setSandBoxMode(true); + } + + /** + * Disable sandbox mode on a MailSettings object + * + * This allows you to send a test email to ensure that your request + * body is valid and formatted correctly. + */ + public function disableSandBoxMode() + { + if (!($this->mail_settings instanceof MailSettings)) { + $this->mail_settings = new MailSettings(); + } + $this->mail_settings->setSandBoxMode(false); + } + + /** + * Set the spam check settings on a MailSettings object + * + * @param bool|SpamCheck $enable A SpamCheck object or a boolean + * to determine if this setting is active + * @param int|null $threshold The threshold used to determine if your + * content qualifies as spam on a scale from + * 1 to 10, with 10 being most strict, or + * most likely to be considered as spam + * @param string|null $post_to_url An Inbound Parse URL that you would like + * a copy of your email along with the spam + * report to be sent to + */ + public function setSpamCheck($enable = null, $threshold = null, $post_to_url = null) + { + if (!$this->mail_settings instanceof MailSettings) { + $this->mail_settings = new MailSettings(); + } + $this->mail_settings->setSpamCheck($enable, $threshold, $post_to_url); + } + + /** + * Add a TrackingSettings object to a Mail object + * + * @param TrackingSettings $tracking_settings Settings to determine how you + * would like to track the metrics + * of how your recipients interact + * with your email + * @throws TypeException + */ + public function setTrackingSettings($tracking_settings) + { + if (!($tracking_settings instanceof TrackingSettings)) { + throw new TypeException( + '$tracking_settings must be an instance of SendGrid\Mail\TrackingSettings' + ); + } + $this->tracking_settings = $tracking_settings; + } + + /** + * Retrieve the TrackingSettings object attached to a Mail object + * + * @return TrackingSettings + */ + public function getTrackingSettings() + { + return $this->tracking_settings; + } + + /** + * Set the click tracking settings on a TrackingSettings object + * + * @param bool|ClickTracking $enable A ClickTracking object or a boolean + * to determine if this setting is active + * @param bool|null $enable_text Indicates if this setting should be + * included in the text/plain portion of + * your email + */ + public function setClickTracking($enable = null, $enable_text = null) + { + if (!($this->tracking_settings instanceof TrackingSettings)) { + $this->tracking_settings = new TrackingSettings(); + } + $this->tracking_settings->setClickTracking($enable, $enable_text); + } + + /** + * Set the open tracking settings on a TrackingSettings object + * + * @param bool|OpenTracking $enable A OpenTracking object or a boolean + * to determine if this setting is + * active + * @param string|null $substitution_tag Allows you to specify a + * substitution tag that you can + * insert in the body of your email + * at a location that you desire. + * This tag will be replaced by the + * open tracking pixel + */ + public function setOpenTracking($enable = null, $substitution_tag = null) + { + if (!($this->tracking_settings instanceof TrackingSettings)) { + $this->tracking_settings = new TrackingSettings(); + } + $this->tracking_settings->setOpenTracking($enable, $substitution_tag); + } + + /** + * Set the subscription tracking settings on a TrackingSettings object + * + * @param bool|SubscriptionTracking $enable A SubscriptionTracking + * object or a boolean to + * determine if this setting + * is active + * @param string|null $text Text to be appended to the + * email, with the + * subscription tracking + * link. You may control + * where the link is by using + * the tag <% %> + * @param string|null $html HTML to be appended to the + * email, with the + * subscription tracking + * link. You may control + * where the link is by using + * the tag <% %> + * @param string|null $substitution_tag A tag that will be + * replaced with the + * unsubscribe URL. for + * example: + * [unsubscribe_url]. If this + * parameter is used, it will + * override both the text and + * html parameters. The URL + * of the link will be placed + * at the substitution tag’s + * location, with no + * additional formatting + */ + public function setSubscriptionTracking( + $enable = null, + $text = null, + $html = null, + $substitution_tag = null + ) { + if (!($this->tracking_settings instanceof TrackingSettings)) { + $this->tracking_settings = new TrackingSettings(); + } + $this->tracking_settings->setSubscriptionTracking( + $enable, + $text, + $html, + $substitution_tag + ); + } + + /** + * Set the Google anatlyics settings on a TrackingSettings object + * + * @param bool|Ganalytics $enable A Ganalytics object or a boolean to + * determine if this setting + * is active + * @param string|null $utm_source Name of the referrer source. (e.g. + * Google, SomeDomain.com, or + * Marketing Email) + * @param string|null $utm_medium Name of the marketing medium. + * (e.g. Email) + * @param string|null $utm_term Used to identify any paid keywords. + * @param string|null $utm_content Used to differentiate your campaign + * from advertisements + * @param string|null $utm_campaign The name of the campaign + */ + public function setGanalytics( + $enable = null, + $utm_source = null, + $utm_medium = null, + $utm_term = null, + $utm_content = null, + $utm_campaign = null + ) { + if (!($this->tracking_settings instanceof TrackingSettings)) { + $this->tracking_settings = new TrackingSettings(); + } + $this->tracking_settings->setGanalytics( + $enable, + $utm_source, + $utm_medium, + $utm_term, + $utm_content, + $utm_campaign + ); + } + + /** + * Return an array representing a request object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + // Detect if we are using the new dynamic templates + $template_id = $this->getTemplateId(); + if ($template_id != null) { + if (substr((string) $template_id->getTemplateId(), 0, 2) == "d-") { + foreach ($this->personalization as $personalization) { + $personalization->setHasDynamicTemplate(true); + } + } + } + return array_filter( + [ + 'personalizations' => $this->getPersonalizations(), + 'from' => $this->getFrom(), + 'reply_to' => $this->getReplyTo(), + 'subject' => $this->getGlobalSubject(), + 'content' => $this->getContents(), + 'attachments' => $this->getAttachments(), + 'template_id' => $this->getTemplateId(), + 'sections' => $this->getSections(), + 'headers' => $this->getGlobalHeaders(), + 'categories' => $this->getCategories(), + 'custom_args' => $this->getGlobalCustomArgs(), + 'send_at' => $this->getGlobalSendAt(), + 'batch_id' => $this->getBatchId(), + 'asm' => $this->getASM(), + 'ip_pool_name' => $this->getIpPoolName(), + 'substitutions' => $this->getGlobalSubstitutions(), + 'mail_settings' => $this->getMailSettings(), + 'tracking_settings' => $this->getTrackingSettings() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/MailSettings.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/MailSettings.php new file mode 100644 index 0000000..8ee56ea --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/MailSettings.php @@ -0,0 +1,274 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a MailSettings object for the /mail/send API call + * + * A collection of different mail settings that you can use to specify how you would + * like this email to be handled + * + * @package SendGrid\Mail + */ +class MailSettings implements \JsonSerializable +{ + /** @var $bcc Bcc object */ + private $bcc; + /** @var $bypass_list_management BypassListManagement object */ + private $bypass_list_management; + /** @var $footer Footer object */ + private $footer; + /** @var $sandbox_mode SandBoxMode object */ + private $sandbox_mode; + /** @var $spam_check SpamCheck object */ + private $spam_check; + + /** + * Optional constructor + * + * @param BccSettings|null $bcc_settings BccSettings object + * @param BypassListManagement|null $bypass_list_management BypassListManagement + * object + * @param Footer|null $footer Footer object + * @param SandBoxMode|null $sandbox_mode SandBoxMode object + * @param SpamCheck|null $spam_check SpamCheck object + */ + public function __construct( + $bcc_settings = null, + $bypass_list_management = null, + $footer = null, + $sandbox_mode = null, + $spam_check = null + ) { + if (isset($bcc_settings)) { + $this->setBccSettings($bcc_settings); + } + if (isset($bypass_list_management)) { + $this->setBypassListManagement($bypass_list_management); + } + if (isset($footer)) { + $this->setFooter($footer); + } + if (isset($sandbox_mode)) { + $this->setSandboxMode($sandbox_mode); + } + if (isset($spam_check)) { + $this->setSpamCheck($spam_check); + } + } + + /** + * Set the bcc settings on a MailSettings object + * + * @param BccSettings|bool $enable The BccSettings object or an indication + * if the setting is enabled + * @param string|null $email The email address that you would like + * to receive the BCC + * + * @throws TypeException + */ + public function setBccSettings($enable, $email = null) + { + if ($enable instanceof BccSettings) { + $bcc = $enable; + $this->bcc = $bcc; + return; + } + if (!is_bool($enable)) { + throw new TypeException( + '$enable must be an instance of SendGrid\Mail\BccSettings or of type bool.' + ); + } + $this->bcc = new BccSettings($enable, $email); + } + + /** + * Retrieve the bcc settings from a MailSettings object + * + * @return Bcc + */ + public function getBccSettings() + { + return $this->bcc; + } + + /** + * Set bypass list management settings on a MailSettings object + * + * @param BypassListManagement|bool $enable The BypassListManagement + * object or an indication + * if the setting is enabled + * + * @throws TypeException + */ + public function setBypassListManagement($enable) + { + if ($enable instanceof BypassListManagement) { + $bypass_list_management = $enable; + $this->bypass_list_management = $bypass_list_management; + return; + } + if (!is_bool($enable)) { + throw new TypeException( + '$enable must be an instance of SendGrid\Mail\BypassListManagement or of type bool.' + ); + } + $this->bypass_list_management = new BypassListManagement($enable); + return; + } + + /** + * Retrieve bypass list management settings from a MailSettings object + * + * @return BypassListManagement + */ + public function getBypassListManagement() + { + return $this->bypass_list_management; + } + + /** + * Set the footer settings on a MailSettings object + * + * @param Footer|bool $enable The Footer object or an indication + * if the setting is enabled + * @param string|null $text The plain text content of your footer + * @param string|null $html The HTML content of your footer + * + * @return null + */ + public function setFooter($enable, $text = null, $html = null) + { + if ($enable instanceof Footer) { + $footer = $enable; + $this->footer = $footer; + return; + } + $this->footer = new Footer($enable, $text, $html); + return; + } + + /** + * Retrieve the footer settings from a MailSettings object + * + * @return Footer + */ + public function getFooter() + { + return $this->footer; + } + + /** + * Set sandbox mode settings on a MailSettings object + * + * @param SandBoxMode|bool $enable The SandBoxMode object or an + * indication if the setting is enabled + * + * @return null + */ + public function setSandboxMode($enable) + { + if ($enable instanceof SandBoxMode) { + $sandbox_mode = $enable; + $this->sandbox_mode = $sandbox_mode; + return; + } + $this->sandbox_mode = new SandBoxMode($enable); + return; + } + + /** + * Retrieve sandbox mode settings on a MailSettings object + * + * @return SandBoxMode + */ + public function getSandboxMode() + { + return $this->sandbox_mode; + } + + /** + * Enable sandbox mode on a MailSettings object + */ + public function enableSandboxMode() + { + $this->setSandboxMode(true); + } + + /** + * Disable sandbox mode on a MailSettings object + */ + public function disableSandboxMode() + { + $this->setSandboxMode(false); + } + + /** + * Set spam check settings on a MailSettings object + * + * @param SpamCheck|bool $enable The SpamCheck object or an + * indication if the setting is enabled + * @param int $threshold The threshold used to determine if your + * content qualifies as spam on a scale + * from 1 to 10, with 10 being most strict, + * or most + * @param string $post_to_url An Inbound Parse URL that you would like + * a copy of your email along with the spam + * report to be sent to + * + * @return null + */ + public function setSpamCheck($enable, $threshold = null, $post_to_url = null) + { + if ($enable instanceof SpamCheck) { + $spam_check = $enable; + $this->spam_check = $spam_check; + return; + } + $this->spam_check = new SpamCheck($enable, $threshold, $post_to_url); + return; + } + + /** + * Retrieve spam check settings from a MailSettings object + * + * @return SpamCheck + */ + public function getSpamCheck() + { + return $this->spam_check; + } + + /** + * Return an array representing a MailSettings object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'bcc' => $this->getBccSettings(), + 'bypass_list_management' => $this->getBypassListManagement(), + 'footer' => $this->getFooter(), + 'sandbox_mode' => $this->getSandboxMode(), + 'spam_check' => $this->getSpamCheck() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/MimeType.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/MimeType.php new file mode 100644 index 0000000..6d33872 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/MimeType.php @@ -0,0 +1,26 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to define the content mime types for the /mail/send API call + * + * @package SendGrid\Mail + */ +abstract class MimeType +{ + const HTML = "text/html"; + const TEXT = "text/plain"; +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/OpenTracking.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/OpenTracking.php new file mode 100644 index 0000000..f3204fe --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/OpenTracking.php @@ -0,0 +1,124 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a OpenTracking object for the /mail/send API call + * + * Allows you to track whether the email was opened or not, but including a single + * pixel image in the body of the content. When the pixel is loaded, we can log that + * the email was opened + * + * @package SendGrid\Mail + */ +class OpenTracking implements \JsonSerializable +{ + /** @var $enable bool Indicates if this setting is enabled */ + private $enable; + /** @var $substitution_tag string Allows you to specify a substitution tag that you can insert in the body of your email at a location that you desire. This tag will be replaced by the open tracking pixel */ + private $substitution_tag; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + * @param string|null $substitution_tag Allows you to specify a substitution + * tag that you can insert in the body + * of your email at a location that you + * desire. This tag will be replaced by + * the open tracking pixel + */ + public function __construct($enable = null, $substitution_tag = null) + { + if (isset($enable)) { + $this->setEnable($enable); + } + if (isset($substitution_tag)) { + $this->setSubstitutionTag($substitution_tag); + } + } + + /** + * Update the enable setting on a OpenTracking object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting on a OpenTracking object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Set the substitution tag on a OpenTracking object + * + * @param string $substitution_tag Allows you to specify a substitution + * tag that you can insert in the body + * of your email at a location that you + * desire. This tag will be replaced by + * the open tracking pixel + * + * @throws TypeException + */ + public function setSubstitutionTag($substitution_tag) + { + if (!is_string($substitution_tag)) { + throw new TypeException('$substitution_tag must be of type string.'); + } + $this->substitution_tag = $substitution_tag; + } + + /** + * Retrieve the substitution tag from a OpenTracking object + * + * @return string + */ + public function getSubstitutionTag() + { + return $this->substitution_tag; + } + + /** + * Return an array representing a OpenTracking object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable(), + 'substitution_tag' => $this->getSubstitutionTag() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Personalization.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Personalization.php new file mode 100644 index 0000000..711a824 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Personalization.php @@ -0,0 +1,312 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Personalization object for + * the /mail/send API call + * + * Each Personalization can be thought of as an envelope - it defines + * who should receive an individual message and how that message should be handled + * + * @package SendGrid\Mail + */ +class Personalization implements \JsonSerializable +{ + /** @var $tos To[] objects */ + private $tos; + /** @var $ccs Cc[] objects */ + private $ccs; + /** @var $bccs Bcc[] objects */ + private $bccs; + /** @var $subject Subject object */ + private $subject; + /** @var $headers Header[] array of header key values */ + private $headers; + /** @var $substitutions Substitution[] array of substitution key values, used for legacy templates */ + private $substitutions; + /** @var array of dynamic template data key values */ + private $dynamic_template_data; + /** @var bool if we are using dynamic templates this will be true */ + private $has_dynamic_template = false; + /** @var $custom_args CustomArg[] array of custom arg key values */ + private $custom_args; + /** @var $send_at SendAt object */ + private $send_at; + + /** + * Add a To object to a Personalization object + * + * @param To $email To object + */ + public function addTo($email) + { + $this->tos[] = $email; + } + + /** + * Retrieve To object(s) from a Personalization object + * + * @return To[] + */ + public function getTos() + { + return $this->tos; + } + + /** + * Add a Cc object to a Personalization object + * + * @param Cc $email Cc object + */ + public function addCc($email) + { + $this->ccs[] = $email; + } + + /** + * Retrieve Cc object(s) from a Personalization object + * + * @return Cc[] + */ + public function getCcs() + { + return $this->ccs; + } + + /** + * Add a Bcc object to a Personalization object + * + * @param Bcc $email Bcc object + */ + public function addBcc($email) + { + $this->bccs[] = $email; + } + + /** + * Retrieve Bcc object(s) from a Personalization object + * + * @return Bcc[] + */ + public function getBccs() + { + return $this->bccs; + } + + /** + * Add a subject object to a Personalization object + * + * @param Subject $subject Subject object + * + * @throws TypeException + */ + public function setSubject($subject) + { + if (!($subject instanceof Subject)) { + throw new TypeException( + '$subject must be an instance of SendGrid\Mail\Subject' + ); + } + $this->subject = $subject; + } + + /** + * Retrieve a Subject object from a Personalization object + * + * @return Subject + */ + public function getSubject() + { + return $this->subject; + } + + /** + * Add a Header object to a Personalization object + * + * @param Header $header Header object + */ + public function addHeader($header) + { + $this->headers[$header->getKey()] = $header->getValue(); + } + + /** + * Retrieve header key/value pairs from a Personalization object + * + * @return array + */ + public function getHeaders() + { + return $this->headers; + } + + /** + * Add a Substitution object or key/value to a Personalization object + * + * @param Substitution|string $data DynamicTemplateData object or the key of a + * dynamic data + * @param string|null $value The value of dynmic data + * + * @return null + */ + public function addDynamicTemplateData($data, $value = null) + { + $this->addSubstitution($data, $value); + } + + /** + * Retrieve dynamic template data key/value pairs from a Personalization object + * + * @return array + */ + public function getDynamicTemplateData() + { + return $this->getSubstitutions(); + } + + /** + * Add a Substitution object or key/value to a Personalization object + * + * @param Substitution|string $substitution Substitution object or the key of a + * substitution + * @param string|null $value The value of a substitution + */ + public function addSubstitution($substitution, $value = null) + { + if (!($substitution instanceof Substitution)) { + $key = $substitution; + $substitution = new Substitution($key, $value); + } + $this->substitutions[$substitution->getKey()] = $substitution->getValue(); + } + + /** + * Retrieve substitution key/value pairs from a Personalization object + * + * @return array + */ + public function getSubstitutions() + { + return $this->substitutions; + } + + /** + * Add a CustomArg object to a Personalization object + * + * @param CustomArg $custom_arg CustomArg object + */ + public function addCustomArg($custom_arg) + { + $this->custom_args[$custom_arg->getKey()] = (string)$custom_arg->getValue(); + } + + /** + * Retrieve custom arg key/value pairs from a Personalization object + * + * @return array + */ + public function getCustomArgs() + { + return $this->custom_args; + } + + /** + * Add a SendAt object to a Personalization object + * + * @param SendAt $send_at SendAt object + * + * @throws TypeException + */ + public function setSendAt($send_at) + { + if (!($send_at instanceof SendAt)) { + throw new TypeException( + '$send_at must be an instance of SendGrid\Mail\SendAt' + ); + } + $this->send_at = $send_at; + } + + /** + * Retrieve a SendAt object from a Personalization object + * + * @return SendAt + */ + public function getSendAt() + { + return $this->send_at; + } + + /** + * Specify if this personalization is using dynamic templates + * + * @param bool $has_dynamic_template are we using dynamic templates + * + * @throws TypeException + */ + public function setHasDynamicTemplate($has_dynamic_template) + { + if (is_bool($has_dynamic_template) != true) { + throw new TypeException( + '$has_dynamic_template must be an instance of bool' + ); + } + $this->has_dynamic_template = $has_dynamic_template; + } + + /** + * Determine if this Personalization object is using dynamic templates + * + * @return bool + */ + public function getHasDynamicTemplate() + { + return $this->has_dynamic_template; + } + + /** + * Return an array representing a Personalization object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + if ($this->getHasDynamicTemplate() == true) { + $dynamic_substitutions = $this->getSubstitutions(); + $substitutions = null; + } else { + $substitutions = $this->getSubstitutions(); + $dynamic_substitutions = null; + } + + return array_filter( + [ + 'to' => $this->getTos(), + 'cc' => $this->getCcs(), + 'bcc' => $this->getBccs(), + 'subject' => $this->getSubject(), + 'headers' => $this->getHeaders(), + 'substitutions' => $substitutions, + 'dynamic_template_data' => $dynamic_substitutions, + 'custom_args' => $this->getCustomArgs(), + 'send_at' => $this->getSendAt() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/PlainTextContent.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/PlainTextContent.php new file mode 100644 index 0000000..a6acbef --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/PlainTextContent.php @@ -0,0 +1,33 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Content object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class PlainTextContent extends Content +{ + /** + * Create a Content object with a plain text mime type + * + * @param string $value plain text formatted content + */ + public function __construct($value) + { + parent::__construct(MimeType::TEXT, $value); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/README.md b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/README.md new file mode 100644 index 0000000..87a0997 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/README.md @@ -0,0 +1,14 @@ +**This helper allows you to quickly and easily build a Mail object for sending email through Twilio SendGrid.** + +# Quick Start + +Run the [example](https://github.com/sendgrid/sendgrid-php/blob/master/examples/helpers/mail/example.php) (make sure you have set your environment variable to include your SENDGRID_API_KEY). + +```bash +php examples/helpers/mail/example.php +``` + +## Usage + +- See this complete working [example](https://github.com/sendgrid/sendgrid-php/blob/master/examples/helpers/mail/example.php). +- [Documentation](https://sendgrid.com/docs/API_Reference/Web_API_v3/Mail/overview.html) diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/ReplyTo.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/ReplyTo.php new file mode 100644 index 0000000..3f4e10d --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/ReplyTo.php @@ -0,0 +1,24 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a ReplyTo object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class ReplyTo extends EmailAddress implements \JsonSerializable +{ +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SandBoxMode.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SandBoxMode.php new file mode 100644 index 0000000..ab7a1fb --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SandBoxMode.php @@ -0,0 +1,80 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a SandBoxMode object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class SandBoxMode implements \JsonSerializable +{ + // @var bool Indicates if this setting is enabled + private $enable; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + */ + public function __construct($enable = null) + { + if (isset($enable)) { + $this->setEnable($enable); + } + } + + /** + * Update the enable setting on a SandBoxMode object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool.'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting on a SandBoxMode object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Return an array representing a SandBoxMode object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Section.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Section.php new file mode 100644 index 0000000..eb2e246 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Section.php @@ -0,0 +1,115 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Section object for the /mail/send API call + * + * An object of key/value pairs that define block sections of code to be used + * as substitutions + * + * @package SendGrid\Mail + */ +class Section implements \JsonSerializable +{ + /** @var $key string Section key */ + private $key; + /** @var $value string Section value */ + private $value; + + /** + * Optional constructor + * + * @param string|null $key Section key + * @param string|null $value Section value + */ + public function __construct($key = null, $value = null) + { + if (isset($key)) { + $this->setKey($key); + } + if (isset($value)) { + $this->setValue($value); + } + } + + /** + * Add the key on a Section object + * + * @param string $key Section key + * + * @throws TypeException + */ + public function setKey($key) + { + if (!is_string($key)) { + throw new TypeException('$key must be of type string.'); + } + $this->key = $key; + } + + /** + * Retrieve the key from a Section object + * + * @return string + */ + public function getKey() + { + return $this->key; + } + + /** + * Add the value on a Section object + * + * @param string $value Section value + * + * @throws TypeException + */ + public function setValue($value) + { + if (!is_string($value)) { + throw new TypeException('$value must be of type string.'); + } + $this->value = $value; + } + + /** + * Retrieve the value from a Section object + * + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * Return an array representing a Section object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'key' => $this->getKey(), + 'value' => $this->getValue() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SendAt.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SendAt.php new file mode 100644 index 0000000..1dbb3f1 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SendAt.php @@ -0,0 +1,102 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ +namespace SendGrid\Mail; + +/** + * This class is used to construct a SendAt object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class SendAt implements \JsonSerializable +{ + /** + * @var $send_at int A unix timestamp allowing you to specify when you want your email + * to be delivered. This may be overridden by the personalizations[x].send_at + * parameter. You can't schedule more than 72 hours in advance. If you have + * the flexibility, it's better to schedule mail for off-peak times. Most + * emails are scheduled and sent at the top of the hour or half hour. + * Scheduling email to avoid those times (for example, scheduling at 10:53) can + * result in lower deferral rates because it won't be going through our servers + * at the same times as everyone else's mail + */ + + private $send_at; + + /** + * Optional constructor + * + * @param int|null $send_at A unix timestamp allowing you to specify when you + * want your email to be delivered. This may be + * overridden by the personalizations[x].send_at + * parameter. You can't schedule more than 72 hours + * in advance. If you have the flexibility, it's better + * to schedule mail for off-peak times. Most emails are + * scheduled and sent at the top of the hour or half + * hour. Scheduling email to avoid those times (for + * example, scheduling at 10:53) can result in lower + * deferral rates because it won't be going through + * our servers at the same times as everyone else's mail + */ + public function __construct($send_at=null) + { + if (isset($send_at)) { + $this->setSendAt($send_at); + } + } + + /** + * Add the send at value to a SendAt object + * + * @param int $send_at A unix timestamp allowing you to specify when you + * want your email to be delivered. This may be + * overridden by the personalizations[x].send_at + * parameter. You can't schedule more than 72 hours + * in advance. If you have the flexibility, it's better + * to schedule mail for off-peak times. Most emails are + * scheduled and sent at the top of the hour or half + * hour. Scheduling email to avoid those times (for + * example, scheduling at 10:53) can result in lower + * deferral rates because it won't be going through + * our servers at the same times as everyone else's mail + * + * @throws TypeException + */ + public function setSendAt($send_at) + { + if (!is_int($send_at)) { + throw new TypeException('$send_at must be of type int.'); + } + $this->send_at = $send_at; + } + + /** + * Retrieve the send at value from a SendAt object + * + * @return int + */ + public function getSendAt() + { + return $this->send_at; + } + + /** + * Return an array representing a SendAt object for the Twilio SendGrid API + * + * @return int + */ + public function jsonSerialize() + { + return $this->getSendAt(); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SpamCheck.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SpamCheck.php new file mode 100644 index 0000000..4173c77 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SpamCheck.php @@ -0,0 +1,161 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a SpamCheck object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class SpamCheck implements \JsonSerializable +{ + /** @var $enable bool Indicates if this setting is enabled */ + private $enable; + /** + * @var $threshold int The threshold used to determine if your content qualifies as + * spam on a scale from 1 to 10, with 10 being most strict, or most + * likely to be considered as spam + */ + private $threshold; + /** + * @var $post_to_urlstring An Inbound Parse URL that you would like a copy of your + * email along with the spam report to be sent to + */ + private $post_to_url; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + * @param int|null $threshold The threshold used to determine if your + * content qualifies as spam on a scale + * from 1 to 10, with 10 being most strict, + * or most + * @param string|null $post_to_url An Inbound Parse URL that you would like + * a copy of your email along with the spam + * report to be sent to + */ + public function __construct($enable = null, $threshold = null, $post_to_url = null) + { + if (isset($enable)) { + $this->setEnable($enable); + } + if (isset($threshold)) { + $this->setThreshold($threshold); + } + if (isset($post_to_url)) { + $this->setPostToUrl($post_to_url); + } + } + + /** + * Update the enable setting on a SpamCheck object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool.'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting on a SpamCheck object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Set the threshold value on a SpamCheck object + * + * @param int $threshold The threshold used to determine if your + * content qualifies as spam on a scale + * from 1 to 10, with 10 being most strict, + * or most + * + * @throws TypeException + */ + public function setThreshold($threshold) + { + if (!is_int($threshold)) { + throw new TypeException('$threshold must be of type int.'); + } + $this->threshold = $threshold; + } + + /** + * Retrieve the threshold value from a SpamCheck object + * + * @return int + */ + public function getThreshold() + { + return $this->threshold; + } + + /** + * Set the post to url value on a SpamCheck object + * + * @param string $post_to_url An Inbound Parse URL that you would like + * a copy of your email along with the spam + * report to be sent to + * + * @throws TypeException + */ + public function setPostToUrl($post_to_url) + { + if (!is_string($post_to_url)) { + throw new TypeException('$post_to_url must be of type string.'); + } + $this->post_to_url = $post_to_url; + } + + /** + * Retrieve the post to url value from a SpamCheck object + * + * @return string + */ + public function getPostToUrl() + { + return $this->post_to_url; + } + + /** + * Return an array representing a SpamCheck object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable(), + 'threshold' => $this->getThreshold(), + 'post_to_url' => $this->getPostToUrl() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Subject.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Subject.php new file mode 100644 index 0000000..94b4066 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Subject.php @@ -0,0 +1,74 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Subject object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class Subject implements \JsonSerializable +{ + /** @var $subject string The email subject */ + private $subject; + + /** + * Optional constructor + * + * @param string|null $subject The email subject + */ + public function __construct($subject = null) + { + if (isset($subject)) { + $this->setSubject($subject); + } + } + + /** + * Set the subject on a Subject object + * + * @param string $subject The email subject + * + * @throws TypeException + */ + public function setSubject($subject) + { + if (!is_string($subject)) { + throw new TypeException('$subject must be of type string.'); + } + + $this->subject = $subject; + } + + /** + * Retrieve the subject from a Subject object + * + * @return string + */ + public function getSubject() + { + return mb_convert_encoding($this->subject, 'UTF-8', 'UTF-8'); + } + + /** + * Return an array representing a Subject object for the Twilio SendGrid API + * + * @return string + */ + public function jsonSerialize() + { + return $this->getSubject(); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SubscriptionTracking.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SubscriptionTracking.php new file mode 100644 index 0000000..87fb15a --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/SubscriptionTracking.php @@ -0,0 +1,228 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a SubscriptionTracking object for + * the /mail/send API call + * + * Allows you to insert a subscription management link at the bottom + * of the text and html bodies of your email. If you would like to + * specify the location of the link within your email, you may use + * the substitution_tag + * + * @package SendGrid\Mail + */ +class SubscriptionTracking implements \JsonSerializable +{ + /** @var $enable bool Indicates if this setting is enabled */ + private $enable; + /** + * @var $text string Text to be appended to the email, with the + * subscription tracking link. You may control where the + * link is by using the tag <% %> + */ + private $text; + /** + * @var $htmlstring string to be appended to the email, with the + * subscription tracking link. You may control where the + * link is by using the tag <% %> + */ + private $html; + /** + * @var $substitution_tag string A tag that will be replaced with the + * unsubscribe URL. for example: [unsubscribe_url]. If + * this parameter is used, it will override both the text + * and html parameters. The URL of the link will be placed + * at the substitution tag’s location, with no additional + * formatting + */ + private $substitution_tag; + + /** + * Optional constructor + * + * @param bool|null $enable Indicates if this setting is enabled + * @param string|null $text Text to be appended to the email, with + * the subscription tracking link. You may + * control where the link is by using the + * tag <% %> + * @param string|null $html HTML to be appended to the email, with + * the subscription tracking link. You may + * control where the link is by using the + * tag <% %> + * @param string|null $substitution_tag A tag that will be replaced with the + * unsubscribe URL. For example: + * [unsubscribe_url]. If this parameter + * is used, it will override both the text + * and html parameters. The URL of the link + * will be placed at the substitution tag’s + * location, with no additional formatting + */ + public function __construct( + $enable = null, + $text = null, + $html = null, + $substitution_tag = null + ) { + if (isset($enable)) { + $this->setEnable($enable); + } + if (isset($text)) { + $this->setText($text); + } + if (isset($html)) { + $this->setHtml($html); + } + if (isset($substitution_tag)) { + $this->setSubstitutionTag($substitution_tag); + } + } + + /** + * Update the enable setting on a SubscriptionTracking object + * + * @param bool $enable Indicates if this setting is enabled + * + * @throws TypeException + */ + public function setEnable($enable) + { + if (!is_bool($enable)) { + throw new TypeException('$enable must be of type bool.'); + } + $this->enable = $enable; + } + + /** + * Retrieve the enable setting from a SubscriptionTracking object + * + * @return bool + */ + public function getEnable() + { + return $this->enable; + } + + /** + * Add text to a SubscriptionTracking object + * + * @param string $text Text to be appended to the email, with + * the subscription tracking link. You may + * control where the link is by using the + * tag <% %> + * + * @throws TypeException + */ + public function setText($text) + { + if (!is_string($text)) { + throw new TypeException('$text must be of type string.'); + } + $this->text = $text; + } + + /** + * Retrieve text from a SubscriptionTracking object + * + * @return string + */ + public function getText() + { + return $this->text; + } + + /** + * Add HTML to a SubscriptionTracking object + * + * @param string $html HTML to be appended to the email, with + * the subscription tracking link. You may + * control where the link is by using the + * tag <% %> + * + * @throws TypeException + */ + public function setHtml($html) + { + if (!is_string($html)) { + throw new TypeException('$html must be of type string.'); + } + $this->html = $html; + } + + /** + * Retrieve HTML from a SubscriptionTracking object + * + * @return string + */ + public function getHtml() + { + return $this->html; + } + + /** + * Add a substitution tag to a SubscriptionTracking object + * + * @param string $substitution_tag A tag that will be replaced with the + * unsubscribe URL. for example: + * [unsubscribe_url]. If this parameter + * is used, it will override both the text + * and html parameters. The URL of the link + * will be placed at the substitution tag’s + * location, with no additional formatting %> + * + * @throws TypeException + */ + public function setSubstitutionTag($substitution_tag) + { + if (!is_string($substitution_tag)) { + throw new TypeException( + '$substitution_tag must be of type string.' + ); + } + $this->substitution_tag = $substitution_tag; + } + + /** + * Retrieve a substitution tag from a SubscriptionTracking object + * + * @return string + */ + public function getSubstitutionTag() + { + return $this->substitution_tag; + } + + /** + * Return an array representing a SubscriptionTracking object + * for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'enable' => $this->getEnable(), + 'text' => $this->getText(), + 'html' => $this->getHtml(), + 'substitution_tag' => $this->getSubstitutionTag() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Substitution.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Substitution.php new file mode 100644 index 0000000..c18e080 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/Substitution.php @@ -0,0 +1,120 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a Substitution object for the /mail/send API call + * + * A collection of key/value pairs following the pattern "substitution_tag":"value + * to substitute". All are assumed to be strings. These substitutions will apply + * to the text and html content of the body of your email, in addition to the + * subject and reply-to parameters. The total collective size of your substitutions + * may not exceed 10,000 bytes per personalization object + * + * @package SendGrid\Mail + */ +class Substitution implements \JsonSerializable +{ + /** @var $key string Substitution key */ + private $key; + /** @var $value string Substitution value */ + private $value; + + /** + * Optional constructor + * + * @param string|null $key Substitution key + * @param string|null $value Substitution value + */ + public function __construct($key = null, $value = null) + { + if (isset($key)) { + $this->setKey($key); + } + if (isset($value)) { + $this->setValue($value); + } + } + + /** + * Add the key on a Substitution object + * + * @param string $key Substitution key + * + * @throws TypeException + * @return null + */ + public function setKey($key) + { + if (!is_string($key)) { + throw new TypeException('$key must be of type string.'); + } + $this->key = (string) $key; + } + + /** + * Retrieve the key from a Substitution object + * + * @return string + */ + public function getKey() + { + return $this->key; + } + + /** + * Add the value on a Substitution object + * + * @param string|array|bool|int $value Substitution value + * + * @throws TypeException + * @return null + */ + public function setValue($value) + { + if (!is_string($value) && !is_array($value) && !is_object($value) &&!is_bool($value) &&!is_int($value)) { + throw new TypeException('$value must be of type string, array or object.'); + } + $this->value = $value; + } + + /** + * Retrieve the value from a Substitution object + * + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * Return an array representing a Substitution object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'key' => $this->getKey(), + 'value' => $this->getValue() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TemplateId.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TemplateId.php new file mode 100644 index 0000000..890de3f --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TemplateId.php @@ -0,0 +1,86 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a TemplateId object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class TemplateId implements \JsonSerializable +{ + /** + * @var $template_id string The id of a template that you would like to use. If you use a + * template that contains a subject and content (either text or html), you do + * not need to specify those at the personalizations nor message level + */ + private $template_id; + + /** + * Optional constructor + * + * @param string|null $template_id The id of a template that you would like + * to use. If you use a template that contains + * a subject and content (either text or html), + * you do not need to specify those at the + * personalizations nor message level + */ + public function __construct($template_id = null) + { + if (isset($template_id)) { + $this->setTemplateId($template_id); + } + } + + /** + * Add a template id to a TemplateId object + * + * @param string $template_id The id of a template that you would like + * to use. If you use a template that contains + * a subject and content (either text or html), + * you do not need to specify those at the + * personalizations nor message level + * + * @throws TypeException + */ + public function setTemplateId($template_id) + { + if (!is_string($template_id)) { + throw new TypeException('$template_id must be of type string.'); + } + + $this->template_id = $template_id; + } + + /** + * Retrieve a template id from a TemplateId object + * + * @return string + */ + public function getTemplateId() + { + return $this->template_id; + } + + /** + * Return an array representing a TemplateId object for the Twilio SendGrid API + * + * @return string + */ + public function jsonSerialize() + { + return $this->getTemplateId(); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/To.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/To.php new file mode 100644 index 0000000..d9e3537 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/To.php @@ -0,0 +1,24 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a To object for the /mail/send API call + * + * @package SendGrid\Mail + */ +class To extends EmailAddress implements \JsonSerializable +{ +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TrackingSettings.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TrackingSettings.php new file mode 100644 index 0000000..271ec06 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TrackingSettings.php @@ -0,0 +1,252 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Mail; + +/** + * This class is used to construct a TrackingSettings object for the + * /mail/send API call + * + * @package SendGrid\Mail + */ +class TrackingSettings implements \JsonSerializable +{ + /** @var $click_tracking ClickTracking object */ + private $click_tracking; + /** @var $open_tracking OpenTracking object */ + private $open_tracking; + /** @var $subscription_tracking SubscriptionTracking object */ + private $subscription_tracking; + /** @var $ganalytics Ganalytics object */ + private $ganalytics; + + /** + * Optional constructor + * + * @param ClickTracking|null $click_tracking ClickTracking object + * @param OpenTracking|null $open_tracking OpenTracking object + * @param SubscriptionTracking|null $subscription_tracking SubscriptionTracking + * object + * @param Ganalytics|null $ganalytics Ganalytics object + */ + public function __construct( + $click_tracking = null, + $open_tracking = null, + $subscription_tracking = null, + $ganalytics = null + ) + { + if (isset($click_tracking)) { + $this->setClickTracking($click_tracking); + } + if (isset($open_tracking)) { + $this->setOpenTracking($open_tracking); + } + if (isset($subscription_tracking)) { + $this->setSubscriptionTracking($subscription_tracking); + } + if (isset($ganalytics)) { + $this->setGanalytics($ganalytics); + } + } + + /** + * Set the click tracking settings on a TrackingSettings object + * + * @param ClickTracking|bool $enable The ClickTracking object or an + * indication if the setting is enabled + * @param bool|null $enable_text Indicates if this setting should be + * included in the text/plain portion of + * your email + */ + public function setClickTracking($enable, $enable_text = null) + { + if ($enable instanceof ClickTracking) { + $click_tracking = $enable; + $this->click_tracking = $click_tracking; + return; + } + $this->click_tracking = new ClickTracking($enable, $enable_text); + } + + /** + * Retrieve the click tracking settings from a TrackingSettings object + * + * @return ClickTracking + */ + public function getClickTracking() + { + return $this->click_tracking; + } + + /** + * Set the open tracking settings on a TrackingSettings object + * + * @param OpenTracking|bool $enable The ClickTracking object or an + * indication if the setting is + * enabled + * @param string|null $substitution_tag Allows you to specify a + * substitution tag that you can + * insert in the body of your email + * at a location that you desire. + * This tag will be replaced by + * the open tracking pixelail + * + * @return null + */ + public function setOpenTracking($enable, $substitution_tag = null) + { + if ($enable instanceof OpenTracking) { + $open_tracking = $enable; + $this->open_tracking = $open_tracking; + return; + } + $this->open_tracking = new OpenTracking($enable, $substitution_tag); + return; + } + + /** + * Retrieve the open tracking settings on a TrackingSettings object + * + * @return OpenTracking + */ + public function getOpenTracking() + { + return $this->open_tracking; + } + + /** + * Set the subscription tracking settings on a TrackingSettings object + * + * @param SubscriptionTracking|bool $enable The SubscriptionTracking + * object or an indication + * if the setting is enabled + * @param string|null $text Text to be appended to the + * email, with the + * subscription tracking + * link. You may control + * where the link is by using + * the tag <% %> + * @param string|null $html HTML to be appended to the + * email, with the + * subscription tracking + * link. You may control + * where the link is by using + * the tag <% %> + * @param string|null $substitution_tag A tag that will be + * replaced with the + * unsubscribe URL. For + * example: + * [unsubscribe_url]. If this + * parameter is used, it will + * override both the text + * and html parameters. The + * URL of the link will be + * placed at the substitution + * tag’s location, with no + * additional formatting + */ + public function setSubscriptionTracking( + $enable, + $text = null, + $html = null, + $substitution_tag = null + ) { + if ($enable instanceof SubscriptionTracking) { + $subscription_tracking = $enable; + $this->subscription_tracking = $subscription_tracking; + return; + } + $this->subscription_tracking + = new SubscriptionTracking($enable, $text, $html, $substitution_tag); + } + + /** + * Retrieve the subscription tracking settings from a TrackingSettings object + * + * @return SubscriptionTracking + */ + public function getSubscriptionTracking() + { + return $this->subscription_tracking; + } + + /** + * Set the Google analytics settings on a TrackingSettings object + * + * @param Ganalytics|bool $enable The Ganalytics object or an indication + * if the setting is enabled + * @param string|null $utm_source Name of the referrer source. (e.g. + * Google, SomeDomain.com, or + * Marketing Email) + * @param string|null $utm_medium Name of the marketing medium. (e.g. + * Email) + * @param string|null $utm_term Used to identify any paid keywords + * @param string|null $utm_content Used to differentiate your campaign from + * advertisements + * @param string|null $utm_campaign The name of the campaign + */ + public function setGanalytics( + $enable, + $utm_source = null, + $utm_medium = null, + $utm_term = null, + $utm_content = null, + $utm_campaign = null + ) { + if ($enable instanceof Ganalytics) { + $ganalytics = $enable; + $this->ganalytics = $ganalytics; + return; + } + $this->ganalytics = new Ganalytics( + $enable, + $utm_source, + $utm_medium, + $utm_term, + $utm_content, + $utm_campaign + ); + } + + /** + * Retrieve the Google analytics settings from a TrackingSettings object + * + * @return Ganalytics + */ + public function getGanalytics() + { + return $this->ganalytics; + } + + /** + * Return an array representing a TrackingSettings object for the Twilio SendGrid API + * + * @return null|array + */ + public function jsonSerialize() + { + return array_filter( + [ + 'click_tracking' => $this->getClickTracking(), + 'open_tracking' => $this->getOpenTracking(), + 'subscription_tracking' => $this->getSubscriptionTracking(), + 'ganalytics' => $this->getGanalytics() + ], + function ($value) { + return $value !== null; + } + ) ?: null; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TypeException.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TypeException.php new file mode 100644 index 0000000..980b60f --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/lib/mail/TypeException.php @@ -0,0 +1,7 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ +namespace SendGrid\Stats; + +/** + * This class is used to retrieve stats from a /mail/send API call + * + * @package SendGrid\Mail + */ +class Stats +{ + const DATE_FORMAT = 'Y-m-d'; + const OPTIONS_SORT_DIRECTION = ['asc', 'desc']; + const OPTIONS_AGGREGATED_BY = ['day', 'week', 'month']; + + // @var string + private $startDate; + + // @var string + private $endDate; + + // @var string + private $aggregatedBy; + + /** + * Stats constructor + * + * @param string $startDate YYYYMMDD + * @param string $endDate YYYYMMDD + * @param string $aggregatedBy day|week|month + */ + public function __construct($startDate, $endDate = null, $aggregatedBy = null) + { + $this->validateDateFormat($startDate); + if (null !== $endDate) { + $this->validateDateFormat($endDate); + } + if (null !== $aggregatedBy) { + $this->validateOptions( + 'aggregatedBy', + $aggregatedBy, + self::OPTIONS_AGGREGATED_BY + ); + } + $this->startDate = $startDate; + $this->endDate = $endDate; + $this->aggregatedBy = $aggregatedBy; + } + + /** + * Retrieve global stats parameters, start date, end date and + * aggregated by + * + * @return array + */ + public function getGlobal() + { + return [ + 'start_date' => $this->startDate, + 'end_date' => $this->endDate, + 'aggregated_by' => $this->aggregatedBy + ]; + } + + /** + * Retrieve an array of categories + * + * @param array $categories + * + * @return array + * @throws \Exception + */ + public function getCategory($categories) + { + $this->validateNumericArray('categories', $categories); + $stats = $this->getGlobal(); + $stats['categories'] = $categories; + return $stats; + } + + /** + * Retrieve global stats parameters, start date, end date and + * aggregated for the given set of subusers + * + * @param array $subusers Subuser accounts + * + * @return array + * @throws \Exception + */ + public function getSubuser($subusers) + { + $this->validateNumericArray('subusers', $subusers); + $stats = $this->getGlobal(); + $stats['subusers'] = $subusers; + return $stats; + } + + /** + * Retrieve global stats parameters, start date, end date, + * aggregated by, sort by metric, sort by direction, limit + * and offset + * + * @param string $sortByMetric blocks|bounce_drops|bounces| + * clicks|deferred|delivered| + * invalid_emails|opens|processed| + * requests|spam_report_drops| + * spam_reports|unique_clicks| + * unique_opens|unsubscribe_drops| + * unsubsribes + * @param string $sortByDirection asc|desc + * @param integer $limit The number of results to return + * @param integer $offset The point in the list to begin + * retrieving results + * + * @return array + * @throws \Exception + */ + public function getSum( + $sortByMetric = 'delivered', + $sortByDirection = 'desc', + $limit = 5, $offset = 0 + ) { + $this->validateOptions( + 'sortByDirection', + $sortByDirection, + self::OPTIONS_SORT_DIRECTION + ); + $this->validateInteger('limit', $limit); + $this->validateInteger('offset', $offset); + $stats = $this->getGlobal(); + $stats['sort_by_metric'] = $sortByMetric; + $stats['sort_by_direction'] = $sortByDirection; + $stats['limit'] = $limit; + $stats['offset'] = $offset; + return $stats; + } + + /** + * Retrieve monthly stats by subuser + * + * @param string $subuser Subuser account + * @param string $sortByMetric blocks|bounce_drops|bounces| + * clicks|deferred|delivered| + * invalid_emails|opens|processed| + * requests|spam_report_drops| + * spam_reports|unique_clicks| + * unique_opens|unsubscribe_drops| + * unsubsribes + * @param string $sortByDirection asc|desc + * @param integer $limit The number of results to return + * @param integer $offset The point in the list to begin + * retrieving results + * + * @return array + * @throws \Exception + */ + public function getSubuserMonthly( + $subuser = null, + $sortByMetric = 'delivered', + $sortByDirection = 'desc', + $limit = 5, + $offset = 0 + ) { + $this->validateOptions( + 'sortByDirection', + $sortByDirection, + self::OPTIONS_SORT_DIRECTION + ); + $this->validateInteger('limit', $limit); + $this->validateInteger('offset', $offset); + return [ + 'date' => $this->startDate, + 'subuser' => $subuser, + 'sort_by_metric' => $sortByMetric, + 'sort_by_direction' => $sortByDirection, + 'limit' => $limit, + 'offset' => $offset + ]; + } + + /** + * Validate the date format + * + * @param string $date YYYY-MM-DD + * + * @return null + * @throws \Exception + */ + protected function validateDateFormat($date) + { + if (false === \DateTime::createFromFormat(self::DATE_FORMAT, $date)) { + throw new \Exception('Date must be in the YYYY-MM-DD format.'); + } + } + + /** + * Validate options + * + * @param string $name Name of option + * @param string $value Value of option + * @param array $options Array of options + * + * @return null + * @throws \Exception + */ + protected function validateOptions($name, $value, $options) + { + if (!in_array($value, $options)) { + throw new \Exception( + $name . ' must be one of: ' . implode(', ', $options) + ); + } + } + + /** + * Validate integer + * + * @param string $name Name as a string + * @param integer $value Value as an integer + * + * @return null + * @throws \Exception + */ + protected function validateInteger($name, $value) + { + if (!is_integer($value)) { + throw new \Exception($name . ' must be an integer.'); + } + } + + /** + * Validate a numeric array + * + * @param string $name Name as a string + * @param array $value Value as an array of integers + * + * @return null + * @throws \Exception + */ + protected function validateNumericArray($name, $value) + { + if (!is_array($value) || empty($value) || !$this->isNumeric($value)) { + throw new \Exception($name . ' must be a non-empty numeric array.'); + } + } + + /** + * Determine if the array is numeric + * + * @param array $array Array of values + * + * @return bool + */ + protected function isNumeric(array $array) + { + return array_keys($array) == range(0, count($array) - 1); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/phpcs.xml b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/phpcs.xml new file mode 100644 index 0000000..f646392 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/phpcs.xml @@ -0,0 +1,196 @@ + + + The PSR-2 coding standard. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + 0 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + 0 + + + 0 + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/scripts/package.sh b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/scripts/package.sh new file mode 100755 index 0000000..6d23743 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/scripts/package.sh @@ -0,0 +1,9 @@ +#!/bin/bash + +rm -rf vendor composer.lock +composer install --no-dev +printf "" > sendgrid-php.php +cd .. +zip -r sendgrid-php.zip sendgrid-php -x \*.git\* \*composer.json\* \*scripts\* \*test\* \*.travis.yml\* \*prism\* + +exit 0 diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/sendgrid-php.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/sendgrid-php.php new file mode 100644 index 0000000..a17aebb --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/sendgrid-php.php @@ -0,0 +1,3 @@ + \ No newline at end of file diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/BaseTestClass.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/BaseTestClass.php new file mode 100644 index 0000000..a3fe54e --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/BaseTestClass.php @@ -0,0 +1,70 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ +namespace SendGrid\Tests; + +use PHPUnit\Framework\TestCase; +use Swaggest\JsonDiff\JsonDiff; +use Swaggest\JsonDiff\JsonPatch; + +/** + * This class facilitates testing the request object + * generation for a /mail/send API call + * + * @package SendGrid\Mail + */ +class BaseTestClass extends TestCase +{ + // @var string Twilio SendGrid API Key + protected static $apiKey; + // @var SendGrid Twilio SendGrid client + protected static $sg; + + /** + * This method is run before the classes are initialised + * + * @return null + */ + public static function setUpBeforeClass() + { + self::$apiKey = "SENDGRID_API_KEY"; + $host = ['host' => 'http://localhost:4010']; + self::$sg = new \SendGrid(self::$apiKey, $host); + } + + /** + * Compares to JSON objects and returns True if equal, + * else return array of differences + * + * @param string $json1 A string representation of a JSON object + * @param string $json2 A string representation of a JSON object + * + * @return bool|array + */ + public static function compareJSONObjects($json1, $json2) + { + $diff = new JsonDiff( + json_decode($json1), + json_decode($json2), + JsonDiff::REARRANGE_ARRAYS + ); + $patch = $diff->getPatch(); + $patch_array = JsonPatch::export($patch); + if (empty($patch_array)) { + return true; + } else { + return $patch_array; + } + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/data/test.txt b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/data/test.txt new file mode 100644 index 0000000..ce01362 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/data/test.txt @@ -0,0 +1 @@ +hello diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Alerts/AlertsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Alerts/AlertsTest.php new file mode 100644 index 0000000..b330ee7 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Alerts/AlertsTest.php @@ -0,0 +1,52 @@ +client->alerts()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testAlertsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->alerts()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAlertsIdPatchMethod() + { + $request_body = json_decode('{ + "email_to": "example@example.com" +}'); + $alert_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->alerts()->_($alert_id)->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAlertsIdGetMethod() + { + $alert_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->alerts()->_($alert_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAlertsIdDeleteMethod() + { + $alert_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->alerts()->_($alert_id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/ApiKeys/ApiKeysTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/ApiKeys/ApiKeysTest.php new file mode 100644 index 0000000..0602185 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/ApiKeys/ApiKeysTest.php @@ -0,0 +1,74 @@ +client->api_keys()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testApiKeysGetMethod() + { + $query_params = json_decode('{"limit": 1}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->api_keys()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testApiKeysIdPutMethod() + { + $request_body = json_decode('{ + "name": "A New Hope", + "scopes": [ + "user.profile.read", + "user.profile.update" + ] +}'); + $api_key_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->api_keys()->_($api_key_id)->put($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testApiKeysIdPatchMethod() + { + $request_body = json_decode('{ + "name": "A New Hope" +}'); + $api_key_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->api_keys()->_($api_key_id)->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testApiKeysIdGetMethod() + { + $api_key_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->api_keys()->_($api_key_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testApiKeysIdDeleteMethod() + { + $api_key_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->api_keys()->_($api_key_id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Asm/AsmGroupsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Asm/AsmGroupsTest.php new file mode 100644 index 0000000..b2887dc --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Asm/AsmGroupsTest.php @@ -0,0 +1,105 @@ +client->asm()->groups()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testAsmGroupsGetMethod() + { + $query_params = json_decode('{"id": 1}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->asm()->groups()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAsmGroupsIdPatchMethod() + { + $request_body = json_decode('{ + "description": "Suggestions for items our users might like.", + "id": 103, + "name": "Item Suggestions" +}'); + $group_id = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->asm()->groups()->_($group_id)->patch($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testAsmGroupsIdGetMethod() + { + $group_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->asm()->groups()->_($group_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAsmGroupsIdDeleteMethod() + { + $group_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->asm()->groups()->_($group_id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testAsmGroupsIdSuppressionPostMethod() + { + $request_body = json_decode('{ + "recipient_emails": [ + "test1@example.com", + "test2@example.com" + ] +}'); + $group_id = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->asm()->groups()->_($group_id)->suppressions()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testAsmGroupsIdSuppressionGetMethod() + { + $group_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->asm()->groups()->_($group_id)->suppressions()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAsmGroupsIdSuppressionSearchPostMethod() + { + $request_body = json_decode('{ + "recipient_emails": [ + "exists1@example.com", + "exists2@example.com", + "doesnotexists@example.com" + ] +}'); + $group_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->asm()->groups()->_($group_id)->suppressions()->search() + ->post($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAsmGroupsIdSuppressionEmailDeleteMethod() + { + $group_id = "test_url_param"; + $email = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->asm()->groups()->_($group_id)->suppressions()->_($email) + ->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Asm/AsmSuppressionTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Asm/AsmSuppressionTest.php new file mode 100644 index 0000000..af96cc8 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Asm/AsmSuppressionTest.php @@ -0,0 +1,52 @@ +client->asm()->suppressions()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAsmSuppressionGlobalPostMethod() + { + $request_body = json_decode('{ + "recipient_emails": [ + "test1@example.com", + "test2@example.com" + ] +}'); + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->asm()->suppressions()->global()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testAsmSuppressionGlobalEmailGetMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->asm()->suppressions()->global()->_($email)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAsmSuppressionGlobalEmailDeleteMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->asm()->suppressions()->global()->_($email)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testAsmSuppressionEmailGetMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->asm()->suppressions()->_($email)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Campaigns/CampaignsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Campaigns/CampaignsTest.php new file mode 100644 index 0000000..56df198 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Campaigns/CampaignsTest.php @@ -0,0 +1,134 @@ +

    Check out our spring line!

    ", + "ip_pool": "marketing", + "list_ids": [ + 110, + 124 + ], + "plain_content": "Check out our spring line!", + "segment_ids": [ + 110 + ], + "sender_id": 124451, + "subject": "New Products for Spring!", + "suppression_group_id": 42, + "title": "March Newsletter" +}'); + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->campaigns()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testCampaignsGetMethod() + { + $query_params = json_decode('{"limit": 1, "offset": 1}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->campaigns()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testCampaignsIdPatchMethod() + { + $request_body = json_decode('{ + "categories": [ + "summer line" + ], + "html_content": "

    Check out our summer line!

    ", + "plain_content": "Check out our summer line!", + "subject": "New Products for Summer!", + "title": "May Newsletter" +}'); + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testCampaignsIdGetMethod() + { + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testCampaignsIdDeleteMethod() + { + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testCampaignsIdSchedulesPatchMethod() + { + $request_body = json_decode('{ + "send_at": 1489451436 +}'); + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->schedules()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testCampaignsIdSchedulesPostMethod() + { + $request_body = json_decode('{ + "send_at": 1489771528 +}'); + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->schedules()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testCampaignsIdSchedulesGetMethod() + { + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->schedules()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testCampaignsIdSchedulesDeleteMethod() + { + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->schedules()->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testCampaignsIdSchedulesNowPostMethod() + { + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->schedules()->now()->post(null, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testCampaignsIdSchedulesTestPostMethod() + { + $request_body = json_decode('{ + "to": "your.email@example.com" +}'); + $campaign_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->campaigns()->_($campaign_id)->schedules()->test() + ->post($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Categories/CategoriesTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Categories/CategoriesTest.php new file mode 100644 index 0000000..33442f4 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Categories/CategoriesTest.php @@ -0,0 +1,32 @@ +client->categories()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testCategoriesStatsGetMethod() + { + $query_params = json_decode('{"end_date": "2016-04-01", "aggregated_by": "day", "limit": 1, "offset": 1, "start_date": "2016-01-01", "categories": "test_string"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->categories()->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testCategoriesStatsSumsGetMethod() + { + $query_params = json_decode('{"end_date": "2016-04-01", "aggregated_by": "day", "limit": 1, "sort_by_metric": "test_string", "offset": 1, "start_date": "2016-01-01", "sort_by_direction": "asc"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->categories()->stats()->sums()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Contacts/ContactDbTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Contacts/ContactDbTest.php new file mode 100644 index 0000000..c412950 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Contacts/ContactDbTest.php @@ -0,0 +1,424 @@ +client->contactdb() + ->custom_fields() + ->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testContactDbCustomFieldsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->custom_fields() + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbCustomFieldsIdGetMethod() + { + $custom_field_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->custom_fields() + ->_($custom_field_id) + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbCustomFieldsIdDeleteMethod() + { + $custom_field_id = "test_url_param"; + $request_headers = ["X-Mock: 202"]; + $response = self::$sg->client->contactdb() + ->custom_fields() + ->_($custom_field_id) + ->delete(null, null, $request_headers); + $this->assertEquals(202, $response->statusCode()); + } + + public function testContactDbListsPostMethod() + { + $request_body = json_decode('{ + "name": "your list name" +}'); + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->contactdb() + ->lists() + ->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testContactDbListsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->lists() + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbListsDeleteMethod() + { + $request_body = json_decode('[ + 1, + 2, + 3, + 4 +]'); + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->contactdb() + ->lists() + ->delete($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testContactDbListsIdPatchMethod() + { + $request_body = json_decode('{ + "name": "newlistname" +}'); + $query_params = json_decode('{"list_id": 1}'); + $list_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->lists() + ->_($list_id) + ->patch($request_body, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbListsIdGetMethod() + { + $query_params = json_decode('{"list_id": 1}'); + $list_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->lists() + ->_($list_id) + ->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbListsIdDeleteMethod() + { + $query_params = json_decode('{"delete_contacts": "true"}'); + $list_id = "test_url_param"; + $request_headers = ["X-Mock: 202"]; + $response = self::$sg->client->contactdb() + ->lists() + ->_($list_id) + ->delete(null, $query_params, $request_headers); + $this->assertEquals(202, $response->statusCode()); + } + + public function testContactDbListsIdRecipientsPostMethod() + { + $request_body = json_decode('[ + "recipient_id1", + "recipient_id2" +]'); + $list_id = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->contactdb() + ->lists() + ->_($list_id) + ->recipients() + ->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testContactDbListsIdRecipientsGetMethod() + { + $query_params = json_decode('{"page": 1, "page_size": 1, "list_id": 1}'); + $list_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->lists() + ->_($list_id) + ->recipients() + ->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbListsIdRecipientsIdPostMethod() + { + $list_id = "test_url_param"; + $recipient_id = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->contactdb() + ->lists() + ->_($list_id) + ->recipients() + ->_($recipient_id) + ->post(null, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testContactDbListsIdRecipientsIdDeleteMethod() + { + $query_params = json_decode('{"recipient_id": 1, "list_id": 1}'); + $list_id = "test_url_param"; + $recipient_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->contactdb() + ->lists() + ->_($list_id) + ->recipients() + ->_($recipient_id) + ->delete(null, $query_params, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testContactDbRecipientsPatchMethod() + { + $request_body = json_decode('[ + { + "email": "jones@example.com", + "first_name": "Guy", + "last_name": "Jones" + } +]'); + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->patch($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testContactDbRecipientsPostMethod() + { + $request_body = json_decode('[ + { + "age": 25, + "email": "example@example.com", + "first_name": "", + "last_name": "User" + }, + { + "age": 25, + "email": "example2@example.com", + "first_name": "Example", + "last_name": "User" + } +]'); + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testContactDbRecipientsGetMethod() + { + $query_params = json_decode('{"page": 1, "page_size": 1}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbRecipientsDeleteMethod() + { + $request_body = json_decode('[ + "recipient_id1", + "recipient_id2" +]'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->delete($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbRecipientsBillableCountGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->billable_count() + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbRecipientsCountMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->count() + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbRecipientsSearchGetMethod() + { + $query_params = json_decode('{"{field_name}": "test_string"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->search() + ->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbRecipientsIdGetMethod() + { + $recipient_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->_($recipient_id) + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbRecipientsIdDeleteMethod() + { + $recipient_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->_($recipient_id) + ->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testContactDbRecipientsIdListsGetMethod() + { + $recipient_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->recipients() + ->_($recipient_id) + ->lists() + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbReservedFieldsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->reserved_fields() + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbSegmentsPostMethod() + { + $request_body = json_decode('{ + "conditions": [ + { + "and_or": "", + "field": "last_name", + "operator": "eq", + "value": "Miller" + }, + { + "and_or": "and", + "field": "last_clicked", + "operator": "gt", + "value": "01/02/2015" + }, + { + "and_or": "or", + "field": "clicks.campaign_identifier", + "operator": "eq", + "value": "513" + } + ], + "list_id": 4, + "name": "Last Name Miller" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->segments() + ->post($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbSegmentsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->segments() + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbSegmentsIdPatchMethod() + { + $request_body = json_decode('{ + "conditions": [ + { + "and_or": "", + "field": "last_name", + "operator": "eq", + "value": "Miller" + } + ], + "list_id": 5, + "name": "The Millers" +}'); + $query_params = json_decode('{"segment_id": "test_string"}'); + $segment_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->segments() + ->_($segment_id) + ->patch($request_body, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbSegmentsIdGetMethod() + { + $query_params = json_decode('{"segment_id": 1}'); + $segment_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->segments() + ->_($segment_id) + ->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testContactDbSegmentsIdDeleteMethod() + { + $query_params = json_decode('{"delete_contacts": "true"}'); + $segment_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->contactdb() + ->segments() + ->_($segment_id) + ->delete(null, $query_params, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testContactDbSegmentsIdRecipientsGetMethod() + { + $query_params = json_decode('{"page": 1, "page_size": 1}'); + $segment_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->contactdb() + ->segments() + ->_($segment_id) + ->recipients() + ->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpPoolsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpPoolsTest.php new file mode 100644 index 0000000..17bb8e9 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpPoolsTest.php @@ -0,0 +1,72 @@ +client->ips()->pools()->post($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpPoolsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->ips()->pools()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpPoolsPoolNamePutMethod() + { + $request_body = json_decode('{ + "name": "new_pool_name" +}'); + $pool_name = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->ips()->pools()->_($pool_name)->put($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpPoolsPoolNameGetMethod() + { + $pool_name = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->ips()->pools()->_($pool_name)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpPoolsPoolNameDeleteMethod() + { + $pool_name = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->ips()->pools()->_($pool_name)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testIpPoolsPoolNameIpsPostMethod() + { + $request_body = json_decode('{ + "ip": "0.0.0.0" +}'); + $pool_name = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->ips()->pools()->_($pool_name)->ips()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testIpPoolsPoolNameIpsIdDeleteMethod() + { + $pool_name = "test_url_param"; + $ip = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->ips()->pools()->_($pool_name)->ips()->_($ip)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpsTest.php new file mode 100644 index 0000000..345daeb --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpsTest.php @@ -0,0 +1,31 @@ +client->ips()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpsAssignedGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->ips()->assigned()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpsIpAddressGetMethod() + { + $ip_address = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->ips()->_($ip_address)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpsWarmupTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpsWarmupTest.php new file mode 100644 index 0000000..9e4945f --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Ip/IpsWarmupTest.php @@ -0,0 +1,41 @@ +client->ips()->warmup()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpsWarmupPostMethod() + { + $request_body = json_decode('{ + "ip": "0.0.0.0" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->ips()->warmup()->post($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpsWarmupIpAddressGetMethod() + { + $ip_address = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->ips()->warmup()->_($ip_address)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testIpsWarmupIpAddressDeleteMethod() + { + $ip_address = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->ips()->warmup()->_($ip_address)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailBatchTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailBatchTest.php new file mode 100644 index 0000000..506ced5 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailBatchTest.php @@ -0,0 +1,23 @@ +client->mail()->batch()->post(null, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testMailBatchIdGetMethod() + { + $batch_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail()->batch()->_($batch_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailSendTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailSendTest.php new file mode 100644 index 0000000..30e299a --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailSendTest.php @@ -0,0 +1,153 @@ +

    Hello, world!

    " + } + ], + "custom_args": { + "New Argument 1": "New Value 1", + "activationAttempt": "1", + "customerAccountNumber": "[CUSTOMER ACCOUNT NUMBER GOES HERE]" + }, + "from": { + "email": "sam.smith@example.com", + "name": "Sam Smith" + }, + "headers": {}, + "ip_pool_name": "[YOUR POOL NAME GOES HERE]", + "mail_settings": { + "bcc": { + "email": "ben.doe@example.com", + "enable": true + }, + "bypass_list_management": { + "enable": true + }, + "footer": { + "enable": true, + "html": "

    Thanks
    The Twilio SendGrid Team

    ", + "text": "Thanks,/n The Twilio SendGrid Team" + }, + "sandbox_mode": { + "enable": false + }, + "spam_check": { + "enable": true, + "post_to_url": "http://example.com/compliance", + "threshold": 3 + } + }, + "personalizations": [ + { + "bcc": [ + { + "email": "sam.doe@example.com", + "name": "Sam Doe" + } + ], + "cc": [ + { + "email": "jane.doe@example.com", + "name": "Jane Doe" + } + ], + "custom_args": { + "New Argument 1": "New Value 1", + "activationAttempt": "1", + "customerAccountNumber": "[CUSTOMER ACCOUNT NUMBER GOES HERE]" + }, + "headers": { + "X-Accept-Language": "en", + "X-Mailer": "MyApp" + }, + "send_at": 1409348513, + "subject": "Hello, World!", + "substitutions": { + "id": "substitutions", + "type": "object" + }, + "to": [ + { + "email": "john.doe@example.com", + "name": "John Doe" + } + ] + } + ], + "reply_to": { + "email": "sam.smith@example.com", + "name": "Sam Smith" + }, + "sections": { + "section": { + ":sectionName1": "section 1 text", + ":sectionName2": "section 2 text" + } + }, + "send_at": 1409348513, + "subject": "Hello, World!", + "template_id": "[YOUR TEMPLATE ID GOES HERE]", + "tracking_settings": { + "click_tracking": { + "enable": true, + "enable_text": true + }, + "ganalytics": { + "enable": true, + "utm_campaign": "[NAME OF YOUR REFERRER SOURCE]", + "utm_content": "[USE THIS SPACE TO DIFFERENTIATE YOUR EMAIL FROM ADS]", + "utm_medium": "[NAME OF YOUR MARKETING MEDIUM e.g. email]", + "utm_name": "[NAME OF YOUR CAMPAIGN]", + "utm_term": "[IDENTIFY PAID KEYWORDS HERE]" + }, + "open_tracking": { + "enable": true, + "substitution_tag": "%opentrack" + }, + "subscription_tracking": { + "enable": true, + "html": "If you would like to unsubscribe and stop receiving these emails <% clickhere %>.", + "substitution_tag": "<%click here%>", + "text": "If you would like to unsubscribe and stop receiving these emails <% click here %>." + } + } +}'); + $request_headers = ["X-Mock: 202"]; + $response = self::$sg->client->mail()->send()->post($request_body, null, $request_headers); + $this->assertEquals(202, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailSettingsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailSettingsTest.php new file mode 100644 index 0000000..aa4065a --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailSettingsTest.php @@ -0,0 +1,183 @@ +client->mail_settings()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsAddressWhitelistPatchMethod() + { + $request_body = json_decode('{ + "enabled": true, + "list": [ + "email1@example.com", + "example.com" + ] +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->address_whitelist()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsAddressWhitelistGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->address_whitelist()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsBccPatchMethod() + { + $request_body = json_decode('{ + "email": "email@example.com", + "enabled": false +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->bcc()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsBccGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->bcc()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsBouncePurgePatchMethod() + { + $request_body = json_decode('{ + "enabled": true, + "hard_bounces": 5, + "soft_bounces": 5 +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->bounce_purge()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsBouncePurgeGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->bounce_purge()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsFooterPatchMethod() + { + $request_body = json_decode('{ + "enabled": true, + "html_content": "...", + "plain_content": "..." +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->footer()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsFooterGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->footer()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsForwardBouncePatchMethod() + { + $request_body = json_decode('{ + "email": "example@example.com", + "enabled": true +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->forward_bounce()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsForwardBounceGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->forward_bounce()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsForwardSpamPatchMethod() + { + $request_body = json_decode('{ + "email": "", + "enabled": false +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->forward_spam()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsForwardSpamGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->forward_spam()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsPlainContentPatchMethod() + { + $request_body = json_decode('{ + "enabled": false +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->plain_content()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsPlainContentGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->plain_content()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsSpamCheckPatchMethod() + { + $request_body = json_decode('{ + "enabled": true, + "max_score": 5, + "url": "url" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->spam_check()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsSpamCheckGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->spam_check()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsTemplatePatchMethod() + { + $request_body = json_decode('{ + "enabled": true, + "html_content": "<% body %>" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->template()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testMailSettingsTemplateGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->mail_settings()->template()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailboxProvidersTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailboxProvidersTest.php new file mode 100644 index 0000000..8fba4d0 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Mail/MailboxProvidersTest.php @@ -0,0 +1,18 @@ +client->mailbox_providers() + ->stats() + ->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Scopes/ScopesTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Scopes/ScopesTest.php new file mode 100644 index 0000000..edeb675 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Scopes/ScopesTest.php @@ -0,0 +1,15 @@ +client->scopes()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/DomainAuthenticationTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/DomainAuthenticationTest.php new file mode 100644 index 0000000..8cd7437 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/DomainAuthenticationTest.php @@ -0,0 +1,124 @@ +client->whitelabel()->domains()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testWhitelabelDomainsGetMethod() + { + $query_params = json_decode('{"username": "test_string", "domain": "test_string", "exclude_subusers": "true", "limit": 1, "offset": 1}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->domains()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelDomainsDefaultGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->domains()->default()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelDomainsSubUserGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->domains()->subuser()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelDomainsSubUserDeleteMethod() + { + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->whitelabel()->domains()->subuser()->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testWhitelabelDomainsIdPatchMethod() + { + $request_body = json_decode('{ + "custom_spf": true, + "default": false +}'); + $domain_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->domains()->_($domain_id)->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelDomainsIdGetMethod() + { + $domain_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->domains()->_($domain_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelDomainsIdDeleteMethod() + { + $domain_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->whitelabel()->domains()->_($domain_id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testWhitelabelDomainsIdSubUserPostMethod() + { + $request_body = json_decode('{ + "username": "jane@example.com" +}'); + $domain_id = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->whitelabel()->domains()->_($domain_id)->subuser() + ->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testWhitelabelDomainsIdIpsPostMethod() + { + $request_body = json_decode('{ + "ip": "192.168.0.1" +}'); + $id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->domains()->_($id)->ips()->post($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelDomainsIdIpsDeleteMethod() + { + $id = "test_url_param"; + $ip = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->domains()->_($id)->ips()->_($ip)->delete(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelDomainsIdValidatePostMethod() + { + $id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->domains()->_($id)->validate()->post(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/LinkBrandingTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/LinkBrandingTest.php new file mode 100644 index 0000000..9493c8f --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/LinkBrandingTest.php @@ -0,0 +1,99 @@ +client->whitelabel()->links()->post($request_body, $query_params, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testWhitelabelLinksGetMethod() + { + $query_params = json_decode('{"limit": 1}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->links()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelLinksDefaultGetMethod() + { + $query_params = json_decode('{"domain": "test_string"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->links()->default()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelLinksSubUserGetMethod() + { + $query_params = json_decode('{"username": "test_string"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->links()->subuser()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelLinksSubUserDeleteMethod() + { + $query_params = json_decode('{"username": "test_string"}'); + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->whitelabel()->links()->subuser()->delete(null, $query_params, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testWhitelabelLinksIdPatchMethod() + { + $request_body = json_decode('{ + "default": true +}'); + $id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->links()->_($id)->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelLinksIdGetMethod() + { + $id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->links()->_($id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelLinksIdDeleteMethod() + { + $id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->whitelabel()->links()->_($id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testWhitelabelLinksIdValidatePostMethod() + { + $id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->links()->_($id)->validate()->post(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelLinksIdSubUserPostMethod() + { + $request_body = json_decode('{ + "username": "jane@example.com" +}'); + $link_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->links()->_($link_id)->subuser()->post($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/ReverseDNSTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/ReverseDNSTest.php new file mode 100644 index 0000000..96b2bd7 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/SenderAuthentication/ReverseDNSTest.php @@ -0,0 +1,52 @@ +client->whitelabel()->ips()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testWhitelabelIpsGetMethod() + { + $query_params = json_decode('{"ip": "test_string", "limit": 1, "offset": 1}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->ips()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelIpsIdGetMethod() + { + $id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->ips()->_($id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testWhitelabelIpsIdDeleteMethod() + { + $id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->whitelabel()->ips()->_($id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testWhitelabelIpsIdValidatePostMethod() + { + $id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->whitelabel()->ips()->_($id)->validate()->post(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Senders/SendersTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Senders/SendersTest.php new file mode 100644 index 0000000..82471bd --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Senders/SendersTest.php @@ -0,0 +1,99 @@ +client->senders() + ->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testSendersGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->senders() + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSendersIdPatchMethod() + { + $request_body = json_decode('{ + "address": "123 Elm St.", + "address_2": "Apt. 456", + "city": "Denver", + "country": "United States", + "from": { + "email": "from@example.com", + "name": "Example INC" + }, + "nickname": "My Sender ID", + "reply_to": { + "email": "replyto@example.com", + "name": "Example INC" + }, + "state": "Colorado", + "zip": "80202" +}'); + $sender_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->senders() + ->_($sender_id) + ->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSendersIdGetMethod() + { + $sender_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->senders() + ->_($sender_id) + ->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSendersIdDeleteMethod() + { + $sender_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->senders() + ->_($sender_id) + ->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testSendersIdResendVerificationPostMethod() + { + $sender_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->senders() + ->_($sender_id) + ->resend_verification() + ->post(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/AccessSettingsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/AccessSettingsTest.php new file mode 100644 index 0000000..576766a --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/AccessSettingsTest.php @@ -0,0 +1,76 @@ + 1 + ]; + $request_headers = ['X-Mock: 200']; + $response = self::$sg->client->access_settings()->activity()->get(null, $query_params, $request_headers); + + $this->assertEquals(200, $response->statusCode()); + } + + public function testAccessSettingsWhitelistPostMethod() + { + $request_body = json_decode('{ + "ips": [ + { + "ip": "192.168.1.1" + }, + { + "ip": "192.*.*.*" + }, + { + "ip": "192.168.1.3/32" + } + ] +}'); + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->access_settings()->whitelist()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testAccessSettingsWhitelistGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->access_settings()->whitelist()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAccessSettingsWhitelistDeleteMethod() + { + $request_body = json_decode('{ + "ids": [ + 1, + 2, + 3 + ] +}'); + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->access_settings()->whitelist()->delete($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testAccessSettingsWhitelistRuleIdGetMethod() + { + $rule_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->access_settings()->whitelist()->_($rule_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testAccessSettingsWhitelistRuleIdDeleteMethod() + { + $rule_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->access_settings()->whitelist()->_($rule_id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/PartnerSettingsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/PartnerSettingsTest.php new file mode 100644 index 0000000..d4c525f --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/PartnerSettingsTest.php @@ -0,0 +1,35 @@ +client->partner_settings()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testPartnerSettingsNewRelicPatchMethod() + { + $request_body = json_decode('{ + "enable_subuser_statistics": true, + "enabled": true, + "license_key": "" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->partner_settings()->new_relic()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testPartnerSettingsNewRelicGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->partner_settings()->new_relic()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/TrackingSettingsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/TrackingSettingsTest.php new file mode 100644 index 0000000..07c41f0 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Settings/TrackingSettingsTest.php @@ -0,0 +1,94 @@ +client->tracking_settings()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTrackingSettingsClickPatchMethod() + { + $request_body = json_decode('{ + "enabled": true +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->tracking_settings()->click()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTrackingSettingsClickGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->tracking_settings()->click()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTrackingSettingsGoogleAnalyticsPatchMethod() + { + $request_body = json_decode('{ + "enabled": true, + "utm_campaign": "website", + "utm_content": "", + "utm_medium": "email", + "utm_source": "sendgrid.com", + "utm_term": "" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->tracking_settings()->google_analytics()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTrackingSettingsGoogleAnalyticsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->tracking_settings()->google_analytics()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTrackingSettingsOpenPatchMethod() + { + $request_body = json_decode('{ + "enabled": true +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->tracking_settings()->open()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTrackingSettingsOpenGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->tracking_settings()->open()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTrackingSettingsSubscriptionPatchMethod() + { + $request_body = json_decode('{ + "enabled": true, + "html_content": "html content", + "landing": "landing page html", + "plain_content": "text content", + "replace": "replacement tag", + "url": "url" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->tracking_settings()->subscription()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTrackingSettingsSubscriptionGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->tracking_settings()->subscription()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/BrowserStatsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/BrowserStatsTest.php new file mode 100644 index 0000000..685cfe0 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/BrowserStatsTest.php @@ -0,0 +1,16 @@ +client->browsers()->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/ClientsStatsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/ClientsStatsTest.php new file mode 100644 index 0000000..633fd62 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/ClientsStatsTest.php @@ -0,0 +1,25 @@ +client->clients()->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testClientsClientTypeStatsGetMethod() + { + $query_params = json_decode('{"aggregated_by": "day", "start_date": "2016-01-01", "end_date": "2016-04-01"}'); + $client_type = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->clients()->_($client_type)->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/DevicesStatsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/DevicesStatsTest.php new file mode 100644 index 0000000..08b6131 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/DevicesStatsTest.php @@ -0,0 +1,16 @@ +client->devices()->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/GeoStatsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/GeoStatsTest.php new file mode 100644 index 0000000..b006f93 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/GeoStatsTest.php @@ -0,0 +1,16 @@ +client->geo()->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/StatsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/StatsTest.php new file mode 100644 index 0000000..3646122 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Stats/StatsTest.php @@ -0,0 +1,16 @@ +client->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Subusers/SubUsersTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Subusers/SubUsersTest.php new file mode 100644 index 0000000..1774f90 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Subusers/SubUsersTest.php @@ -0,0 +1,155 @@ +client->subusers()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersPostMethod() + { + $request_body = json_decode('{ + "email": "John@example.com", + "ips": [ + "1.1.1.1", + "2.2.2.2" + ], + "password": "johns_password", + "username": "John@example.com" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->post($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersReputationGetMethod() + { + $query_params = json_decode('{"usernames": "test_string"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->reputations()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersStatsGetMethod() + { + $query_params = json_decode('{"end_date": "2016-04-01", "aggregated_by": "day", "limit": 1, "offset": 1, "start_date": "2016-01-01", "subusers": "test_string"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersStatsMonthlyGetMethod() + { + $query_params = json_decode('{"subuser": "test_string", "limit": 1, "sort_by_metric": "test_string", "offset": 1, "date": "test_string", "sort_by_direction": "asc"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->stats()->monthly()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersStatsSumsGetMethod() + { + $query_params = json_decode('{"end_date": "2016-04-01", "aggregated_by": "day", "limit": 1, "sort_by_metric": "test_string", "offset": 1, "start_date": "2016-01-01", "sort_by_direction": "asc"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->stats()->sums()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersNamePatchMethod() + { + $request_body = json_decode('{ + "disabled": false +}'); + $subuser_name = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->subusers()->_($subuser_name)->patch($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testSubUsersNameDeleteMethod() + { + $subuser_name = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->subusers()->_($subuser_name)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testSubUsersNameIpsPutMethod() + { + $request_body = json_decode('[ + "127.0.0.1" +]'); + $subuser_name = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->_($subuser_name)->ips()->put($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersNameMonitorPutMethod() + { + $request_body = json_decode('{ + "email": "example@example.com", + "frequency": 500 +}'); + $subuser_name = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->_($subuser_name)->monitor()->put( + $request_body, + null, + $request_headers + ); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersNameMonitorPostMethod() + { + $request_body = json_decode('{ + "email": "example@example.com", + "frequency": 50000 +}'); + $subuser_name = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->_($subuser_name)->monitor()->post( + $request_body, + null, + $request_headers + ); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersNameMonitorGetMethod() + { + $subuser_name = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->_($subuser_name)->monitor()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSubUsersNameMonitorDeleteMethod() + { + $subuser_name = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->subusers()->_($subuser_name)->monitor()->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testSubUsersNameStatsMonthlyGetMethod() + { + $query_params = json_decode('{"date": "test_string", "sort_by_direction": "asc", "limit": 1, "sort_by_metric": "test_string", "offset": 1}'); + $subuser_name = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->subusers()->_($subuser_name)->stats()->monthly()->get( + null, + $query_params, + $request_headers + ); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionBlocksTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionBlocksTest.php new file mode 100644 index 0000000..e0c90e2 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionBlocksTest.php @@ -0,0 +1,46 @@ +client->suppression()->blocks()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSuppressionBlocksDeleteMethod() + { + $request_body = json_decode('{ + "delete_all": false, + "emails": [ + "example1@example.com", + "example2@example.com" + ] +}'); + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->suppression()->blocks()->delete($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testSuppressionBlocksEmailGetMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->suppression()->blocks()->_($email)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSuppressionBlocksEmailDeleteMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->suppression()->blocks()->_($email)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionBouncesTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionBouncesTest.php new file mode 100644 index 0000000..b440de3 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionBouncesTest.php @@ -0,0 +1,47 @@ +client->suppression()->bounces()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSuppressionBouncesDeleteMethod() + { + $request_body = json_decode('{ + "delete_all": true, + "emails": [ + "example@example.com", + "example2@example.com" + ] +}'); + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->suppression()->bounces()->delete($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testSuppressionBouncesEmailGetMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->suppression()->bounces()->_($email)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSuppressionBouncesEmailDeleteMethod() + { + $query_params = json_decode('{"email_address": "example@example.com"}'); + $email = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->suppression()->bounces()->_($email)->delete(null, $query_params, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionInvalidEmailsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionInvalidEmailsTest.php new file mode 100644 index 0000000..040a21f --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionInvalidEmailsTest.php @@ -0,0 +1,46 @@ +client->suppression()->invalid_emails()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSuppressionInvalidEmailsDeleteMethod() + { + $request_body = json_decode('{ + "delete_all": false, + "emails": [ + "example1@example.com", + "example2@example.com" + ] +}'); + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->suppression()->invalid_emails()->delete($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testSuppressionInvalidEmailsEmailGetMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->suppression()->invalid_emails()->_($email)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSuppressionBouncesEmailDeleteMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->suppression()->invalid_emails()->_($email)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionSpamReportsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionSpamReportsTest.php new file mode 100644 index 0000000..fc640fe --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionSpamReportsTest.php @@ -0,0 +1,46 @@ +client->suppression()->spam_reports()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSuppressionSpamReportsDeleteMethod() + { + $request_body = json_decode('{ + "delete_all": false, + "emails": [ + "example1@example.com", + "example2@example.com" + ] +}'); + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->suppression()->spam_reports()->delete($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testSuppressionSpamReportsEmailGetMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->suppression()->spam_reports()->_($email)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testSuppressionSpamReportsEmailDeleteMethod() + { + $email = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->suppression()->spam_reports()->_($email)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionUnsubscribesTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionUnsubscribesTest.php new file mode 100644 index 0000000..0c20423 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Suppression/SuppressionUnsubscribesTest.php @@ -0,0 +1,16 @@ +client->suppression()->unsubscribes()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Templates/TemplatesTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Templates/TemplatesTest.php new file mode 100644 index 0000000..8dc71f0 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Templates/TemplatesTest.php @@ -0,0 +1,114 @@ +client->templates()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testTemplatesGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->templates()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTemplatesIdPatchMethod() + { + $request_body = json_decode('{ + "name": "new_example_name" +}'); + $template_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->templates()->_($template_id)->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTemplatesIdGetMethod() + { + $template_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->templates()->_($template_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTemplatesIdDeleteMethod() + { + $template_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->templates()->_($template_id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testTemplatesIdVersionsPostMethod() + { + $request_body = json_decode('{ + "active": 1, + "html_content": "<%body%>", + "name": "example_version_name", + "plain_content": "<%body%>", + "subject": "<%subject%>", + "template_id": "ddb96bbc-9b92-425e-8979-99464621b543" +}'); + $template_id = "test_url_param"; + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->templates()->_($template_id)->versions()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testTemplatesIdVersionsIdPatchMethod() + { + $request_body = json_decode('{ + "active": 1, + "html_content": "<%body%>", + "name": "updated_example_name", + "plain_content": "<%body%>", + "subject": "<%subject%>" +}'); + $template_id = "test_url_param"; + $version_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->templates()->_($template_id)->versions()->_($version_id) + ->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTemplatesIdVersionsIdGetMethod() + { + $template_id = "test_url_param"; + $version_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->templates()->_($template_id)->versions()->_($version_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testTemplatesIdVersionsIdDeleteMethod() + { + $template_id = "test_url_param"; + $version_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->templates()->_($template_id)->versions()->_($version_id) + ->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testTemplatesIdVersionsIdActivatePostMethod() + { + $template_id = "test_url_param"; + $version_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->templates()->_($template_id)->versions()->_($version_id)->activate() + ->post(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Users/UserTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Users/UserTest.php new file mode 100644 index 0000000..45f789e --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/Users/UserTest.php @@ -0,0 +1,274 @@ +client->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserAccountGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->account()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserCreditsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->credits()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserEmailPutMethod() + { + $request_body = json_decode('{ + "email": "example@example.com" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->email()->put($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserEmailGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->email()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserPasswordPutMethod() + { + $request_body = json_decode('{ + "new_password": "new_password", + "old_password": "old_password" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->password()->put($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserProfilePatchMethod() + { + $request_body = json_decode('{ + "city": "Orange", + "first_name": "Example", + "last_name": "User" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->profile()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserProfileGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->profile()->get(null, null, $request_headers); + $this->assertEquals($response->statusCode(), 200); + } + + public function testUserScheduledSendsPostMethod() + { + $request_body = json_decode('{ + "batch_id": "YOUR_BATCH_ID", + "status": "pause" +}'); + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->user()->scheduled_sends()->post($request_body, null, $request_headers); + $this->assertEquals(201, $response->statusCode()); + } + + public function testUserScheduledSendsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->scheduled_sends()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserScheduledSendsBatchIdPatchMethod() + { + $request_body = json_decode('{ + "status": "pause" +}'); + $batch_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->user()->scheduled_sends()->_($batch_id)->patch( + $request_body, + null, + $request_headers + ); + $this->assertEquals(204, $response->statusCode()); + } + + public function testUserScheduledSendsBatchIdGetMethod() + { + $batch_id = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->scheduled_sends()->_($batch_id)->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserScheduledSendsBatchIdDeleteMethod() + { + $batch_id = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->user()->scheduled_sends()->_($batch_id)->delete(null, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testUserSettingsEnforcedTlsPatchMethod() + { + $request_body = json_decode('{ + "require_tls": true, + "require_valid_cert": false +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->settings()->enforced_tls()->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserSettingsEnforcedTlsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->settings()->enforced_tls()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserUsernamePutMethod() + { + $request_body = json_decode('{ + "username": "test_username" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->username()->put($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserUsernameGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->username()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserWebhooksEventSettingsPatchMethod() + { + $request_body = json_decode('{ + "bounce": true, + "click": true, + "deferred": true, + "delivered": true, + "dropped": true, + "enabled": true, + "group_resubscribe": true, + "group_unsubscribe": true, + "open": true, + "processed": true, + "spam_report": true, + "unsubscribe": true, + "url": "url" +}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->webhooks()->event()->settings()->patch( + $request_body, + null, + $request_headers + ); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserWebhooksEventSettingsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->webhooks()->event()->settings()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserWebhooksEventTestPostMethod() + { + $request_body = json_decode('{ + "url": "url" +}'); + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->user()->webhooks()->event()->test()->post($request_body, null, $request_headers); + $this->assertEquals(204, $response->statusCode()); + } + + public function testUserWebhooksParseSettingsPostMethod() + { + $request_body = json_decode('{ + "hostname": "myhostname.com", + "send_raw": false, + "spam_check": true, + "url": "http://email.myhosthame.com" +}'); + $request_headers = ["X-Mock: 201"]; + $response = self::$sg->client->user()->webhooks()->parse()->settings()->post( + $request_body, + null, + $request_headers + ); + $this->assertEquals(201, $response->statusCode()); + } + + public function testUserWebhooksParseSettingsGetMethod() + { + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->webhooks()->parse()->settings()->get(null, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserWebhooksParseHostnamePatchMethod() + { + $request_body = json_decode('{ + "send_raw": true, + "spam_check": false, + "url": "http://newdomain.com/parse" +}'); + $hostname = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->webhooks()->parse()->settings()->_($hostname) + ->patch($request_body, null, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserWebhooksParseHostnameGetMethod() + { + $hostname = "test_url_param"; + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->webhooks()->parse()->settings()->_($hostname)->get( + null, + null, + $request_headers + ); + $this->assertEquals(200, $response->statusCode()); + } + + public function testUserWebhooksParseHostnameDeleteMethod() + { + $hostname = "test_url_param"; + $request_headers = ["X-Mock: 204"]; + $response = self::$sg->client->user()->webhooks()->parse()->settings()->_($hostname)->delete( + null, + null, + $request_headers + ); + $this->assertEquals(204, $response->statusCode()); + } + + public function testUserWebhooksParseStatsGetMethod() + { + $query_params = json_decode('{"aggregated_by": "day", "limit": "test_string", "start_date": "2016-01-01", "end_date": "2016-04-01", "offset": "test_string"}'); + $request_headers = ["X-Mock: 200"]; + $response = self::$sg->client->user()->webhooks()->parse()->stats()->get(null, $query_params, $request_headers); + $this->assertEquals(200, $response->statusCode()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/helpers/contacts/RecipientsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/helpers/contacts/RecipientsTest.php new file mode 100644 index 0000000..b82764e --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/helpers/contacts/RecipientsTest.php @@ -0,0 +1,31 @@ +assertEquals( + $form, '
    + First Name:
    + Last Name:
    + E-mail:
    + +
    ' + ); + } + public function testRecipientsFormSubmit() + { + $firstName = 'Test'; + $lastName = 'Tester'; + $email = 'test@test.com'; + $recipient = new Recipient($firstName, $lastName, $email); + $json = json_encode($recipient); + $this->assertEquals($json, '{"email":"test@test.com","first_name":"Test","last_name":"Tester"}'); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/helpers/stats/StatsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/helpers/stats/StatsTest.php new file mode 100644 index 0000000..a30226d --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/integration/helpers/stats/StatsTest.php @@ -0,0 +1,238 @@ +assertEquals($expectedGlobal, $userStats->getGlobal()); + $this->assertEquals($expectedCategory, $userStats->getCategory($expectedCategory['categories'])); + $this->assertEquals($expectedSubuser, $userStats->getSubuser($expectedSubuser['subusers'])); + $this->assertEquals($expectedSum, $userStats->getSum( + $expectedSum['sort_by_metric'], + $expectedSum['sort_by_direction'], + $expectedSum['limit'], + $expectedSum['offset'] + )); + $this->assertEquals($expectedSubuserMonthly, $userStats->getSubuserMonthly( + $expectedSubuserMonthly['subuser'], + $expectedSubuserMonthly['sort_by_metric'], + $expectedSubuserMonthly['sort_by_direction'], + $expectedSubuserMonthly['limit'], + $expectedSubuserMonthly['offset'] + )); + } + + /** + * @param array $expectedGlobal + * @param array $expectedCategory + * @param array $expectedSubuser + * @param array $expectedSum + * @param array $expectedSubuserMonthly + * @dataProvider invalidValues + * @expectedException Exception + */ + public function testGetValuesFail( + $expectedGlobal, + $expectedCategory, + $expectedSubuser, + $expectedSum, + $expectedSubuserMonthly + ) { + $this->testGetValues( + $expectedGlobal, + $expectedCategory, + $expectedSubuser, + $expectedSum, + $expectedSubuserMonthly + ); + } + + public function validValues() + { + return [ + [ + $this->getExpectedGlobal('1980-01-01', null, null), + $this->getExpectedCategory('1980-01-01', null, null, ['cat1', 'cat2']), + $this->getExpectedSubuser('1980-01-01', null, null, ['user1', 'user2']), + $this->getExpectedSum('1980-01-01', null, null, 'delivered', 'desc', 5, 0), + $this->getExpectedSubuserMonthly('1980-01-01', 'user1', 'delivered', 'desc', 5, 0), + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', null), + $this->getExpectedCategory('1980-01-01', '2017-01-01', null, ['cat1']), + $this->getExpectedSubuser('1980-01-01', '2017-01-01', null, ['user1']), + $this->getExpectedSum('1980-01-01', '2017-01-01', null, 'delivered', 'asc', 10, 2), + $this->getExpectedSubuserMonthly('1980-01-01', 'user1', 'delivered', 'asc', 10, 2), + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', ['cat1']), + $this->getExpectedSubuser('1980-01-01', '2017-01-01', 'day', ['user1']), + $this->getExpectedSum('1980-01-01', '2017-01-01', 'day', 'delivered', 'asc', 50, 6), + $this->getExpectedSubuserMonthly('1980-01-01', 'user1', 'delivered', 'asc', 50, 6), + ], + ]; + } + + public function invalidValues() + { + return [ + [ + $this->getExpectedGlobal(null, null, null), + null, + null, + null, + null + ], + [ + $this->getExpectedGlobal('1980-01-0145', null, null), + null, + null, + null, + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '1980-01-0145', null), + null, + null, + null, + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '1980-01-02', 'asdf'), + null, + null, + null, + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', null), + null, + null, + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', null), + null, + null, + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', []), + null, + null, + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', ['a' => 'b']), + null, + null, + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', ['cat1']), + $this->getExpectedSubuser('1980-01-01', '2017-01-01', 'day', null), + $this->getExpectedSum('1980-01-01', '2017-01-01', 'day', 'delivered', null, 50, 6), + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', ['cat1']), + $this->getExpectedSubuser('1980-01-01', '2017-01-01', 'day', null), + $this->getExpectedSum('1980-01-01', '2017-01-01', 'day', 'delivered', 'asdf', 50, 6), + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', ['cat1']), + $this->getExpectedSubuser('1980-01-01', '2017-01-01', 'day', null), + $this->getExpectedSum('1980-01-01', '2017-01-01', 'day', 'delivered', 'asc', null, 'asdf'), + null + ], + [ + $this->getExpectedGlobal('1980-01-01', '2017-01-01', 'day'), + $this->getExpectedCategory('1980-01-01', '2017-01-01', 'day', ['cat1']), + $this->getExpectedSubuser('1980-01-01', '2017-01-01', 'day', ['user1']), + $this->getExpectedSum('1980-01-01', '2017-01-01', 'day', 'delivered', 'asc', 50, 6), + $this->getExpectedSubuserMonthly('1980-01-01', 'user1', 'delivered', 'asc', 50, null), + ], + ]; + } + + public function getExpectedGlobal($startDate, $endDate, $aggregatedBy) + { + return [ + 'start_date' => $startDate, + 'end_date' => $endDate, + 'aggregated_by' => $aggregatedBy, + ]; + } + + public function getExpectedCategory($startDate, $endDate, $aggregatedBy, $categories) + { + return [ + 'start_date' => $startDate, + 'end_date' => $endDate, + 'aggregated_by' => $aggregatedBy, + 'categories' => $categories + ]; + } + + public function getExpectedSubuser($startDate, $endDate, $aggregatedBy, $subusers) + { + return [ + 'start_date' => $startDate, + 'end_date' => $endDate, + 'aggregated_by' => $aggregatedBy, + 'subusers' => $subusers + ]; + } + + public function getExpectedSum($startDate, $endDate, $aggregatedBy, $sortByMetric, $sortByDirection, $limit, $offset) + { + return [ + 'start_date' => $startDate, + 'end_date' => $endDate, + 'aggregated_by' => $aggregatedBy, + 'sort_by_metric' => $sortByMetric, + 'sort_by_direction' => $sortByDirection, + 'limit' => $limit, + 'offset' => $offset + ]; + } + + public function getExpectedSubuserMonthly($date, $subuser, $sortByMetric, $sortByDirection, $limit, $offset) + { + return [ + 'date' => $date, + 'subuser' => $subuser, + 'sort_by_metric' => $sortByMetric, + 'sort_by_direction' => $sortByDirection, + 'limit' => $limit, + 'offset' => $offset + ]; + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/phpunit.xml.dist b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/phpunit.xml.dist new file mode 100644 index 0000000..c80a65f --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/phpunit.xml.dist @@ -0,0 +1,8 @@ + + + + + . + + + diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/prism.sh b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/prism.sh new file mode 100755 index 0000000..4537445 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/prism.sh @@ -0,0 +1,63 @@ +#!/bin/bash + +get_latest_release() { + curl --silent "https://api.github.com/repos/stoplightio/prism/releases/latest" | # Get latest release from GitHub api + grep '"tag_name":' | # Get tag line + sed -E 's/.*"([^"]+)".*/\1/' # Pluck JSON value +} +set -eu + +install () { + +echo "Installing Prism..." + +UNAME=$(uname) +ARCH=$(uname -m) +if [ "$UNAME" != "Linux" ] && [ "$UNAME" != "Darwin" ] && [ "$ARCH" != "x86_64" ] && [ "$ARCH" != "i686" ]; then + echo "Sorry, OS/Architecture not supported: ${UNAME}/${ARCH}. Download binary from https://github.com/stoplightio/prism/releases" + exit 1 +fi + +if [ "$UNAME" = "Darwin" ] ; then + OSX_ARCH=$(uname -m) + if [ "${OSX_ARCH}" = "x86_64" ] ; then + PLATFORM="darwin_amd64" + fi +elif [ "$UNAME" = "Linux" ] ; then + LINUX_ARCH=$(uname -m) + if [ "${LINUX_ARCH}" = "i686" ] ; then + PLATFORM="linux_386" + elif [ "${LINUX_ARCH}" = "x86_64" ] ; then + PLATFORM="linux_amd64" + fi +fi + +mkdir -p ../prism/bin +LATEST=$(get_latest_release) +# URL="https://github.com/stoplightio/prism/releases/download/$LATEST/prism_$PLATFORM" +URL="https://github.com/stoplightio/prism/releases/download/v2.0.17/prism_$PLATFORM" +DEST=../prism/bin/prism + +# if [ -z $LATEST ] ; then +# echo "Error requesting. Download binary from ${URL}" +# exit 1 +# else +curl -L $URL -o $DEST +chmod +x $DEST +# fi +} + +run () { + echo "Running prism..." + cd ../prism/bin + ./prism mock --spec https://raw.githubusercontent.com/sendgrid/sendgrid-oai/master/oai_stoplight.json +} + +if [ -f ../prism/bin/prism ]; then + echo "Prism is already installed." + run +else + echo "Prism is not installed." + install + run +fi diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/AttachmentsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/AttachmentsTest.php new file mode 100644 index 0000000..007eba8 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/AttachmentsTest.php @@ -0,0 +1,45 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ +namespace SendGrid\Tests; + +use PHPUnit\Framework\TestCase; +use SendGrid\Mail\Attachment; + +/** + * This file tests attachments. + * + * @package SendGrid\Tests + */ +class AttachmentsTests extends TestCase +{ + public function testWillEncodeNonBase64String() { + + $attachment = new Attachment(); + $testString = 'Twilio Sendgrid is awesome!'; + + $attachment->setContent($testString); + + $this->assertEquals(base64_encode($testString), $attachment->getContent()); + } + + public function testWillNotEncodeBase64String() { + + $attachment = new Attachment(); + $testString = base64_encode('Twilio Sendgrid is awesome!'); + + $attachment->setContent($testString); + + $this->assertEquals($testString, $attachment->getContent()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/DynamicTemplateTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/DynamicTemplateTest.php new file mode 100644 index 0000000..d07d97d --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/DynamicTemplateTest.php @@ -0,0 +1,415 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Tests; + +// Test each use case that uses substitutions + +/** + * This class tests the dynamic/transactional template functionality for a /mail/send API call + * + * @package SendGrid\Tests + */ +class DynamicTemplateTest extends BaseTestClass +{ + + private $REQUEST_OBJECT_LEGACY = <<<'JSON' +{ + "content": [ + { + "type": "text/plain", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/html", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/calendar", + "value": "Party Time!!" + }, + { + "type": "text/calendar2", + "value": "Party Time 2!!" + } + ], + "from": { + "email": "test@example.com", + "name": "DX" + }, + "subject": "Sending with Twilio SendGrid is Fun and Global 2", + "personalizations": [ + { + "bcc": [ + { + "email": "test+7@example.com", + "name": "Example User7" + }, + { + "email": "test+8@example.com", + "name": "Example User8" + }, + { + "email": "test+9@example.com", + "name": "Example User9" + } + ], + "cc": [ + { + "email": "test+4@example.com", + "name": "Example User4" + }, + { + "email": "test+5@example.com", + "name": "Example User5" + }, + { + "email": "test+6@example.com", + "name": "Example User6" + } + ], + "substitutions": { + "%city1%": "Denver", + "%city2%": "Orange", + "%name1%": "Example Name 1", + "%name2%": "Example Name 2" + }, + "to": [ + { + "email": "test@example.com", + "name": "Example User" + }, + { + "email": "test+1@example.com", + "name": "Example User1" + }, + { + "email": "test+2@example.com", + "name": "Example User2" + }, + { + "email": "test+3@example.com", + "name": "Example User3" + } + ] + } + ], + "template_id": "13b8f94f-bcae-4ec6-b752-70d6cb59f932" +} +JSON; + + private $REQUEST_OBJECT = <<<'JSON' +{ + "content": [ + { + "type": "text/plain", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/html", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/calendar", + "value": "Party Time!!" + }, + { + "type": "text/calendar2", + "value": "Party Time 2!!" + } + ], + "from": { + "email": "test@example.com", + "name": "DX" + }, + "subject": "Sending with Twilio SendGrid is Fun and Global 2", + "personalizations": [ + { + "bcc": [ + { + "email": "test+7@example.com", + "name": "Example User7" + }, + { + "email": "test+8@example.com", + "name": "Example User8" + }, + { + "email": "test+9@example.com", + "name": "Example User9" + } + ], + "cc": [ + { + "email": "test+4@example.com", + "name": "Example User4" + }, + { + "email": "test+5@example.com", + "name": "Example User5" + }, + { + "email": "test+6@example.com", + "name": "Example User6" + } + ], + "dynamic_template_data": { + "%city1%": "Denver", + "%city2%": "Orange", + "%name1%": "Example Name 1", + "%name2%": "Example Name 2" + }, + "to": [ + { + "email": "test@example.com", + "name": "Example User" + }, + { + "email": "test+1@example.com", + "name": "Example User1" + }, + { + "email": "test+2@example.com", + "name": "Example User2" + }, + { + "email": "test+3@example.com", + "name": "Example User3" + } + ] + } + ], + "template_id": "d-13b8f94f-bcae-4ec6-b752-70d6cb59f932" +} +JSON; + + /** + * Test all parameters without using objects + */ + public function testKitchenSinkExampleWithoutObjectsAndLegacyTemplate() + { + $email = new \SendGrid\Mail\Mail(); + + // For a detailed description of each of these settings, + // please see the + // [documentation](https://sendgrid.com/docs/API_Reference/api_v3.html). + $email->setSubject("Sending with Twilio SendGrid is Fun 2"); + + $email->addTo("test@example.com", "Example User"); + $email->addTo("test+1@example.com", "Example User1"); + $toEmails = [ + "test+2@example.com" => "Example User2", + "test+3@example.com" => "Example User3" + ]; + $email->addTos($toEmails); + + $email->addCc("test+4@example.com", "Example User4"); + $ccEmails = [ + "test+5@example.com" => "Example User5", + "test+6@example.com" => "Example User6" + ]; + $email->addCcs($ccEmails); + + $email->addBcc("test+7@example.com", "Example User7"); + $bccEmails = [ + "test+8@example.com" => "Example User8", + "test+9@example.com" => "Example User9" + ]; + $email->addBccs($bccEmails); + + $email->addSubstitution("%name1%", "Example Name 1"); + $email->addSubstitution("%city1%", "Denver"); + $substitutions = [ + "%name2%" => "Example Name 2", + "%city2%" => "Orange" + ]; + $email->addSubstitutions($substitutions); + + // The values below this comment are global to entire message + + $email->setFrom("test@example.com", "DX"); + + $email->setGlobalSubject("Sending with Twilio SendGrid is Fun and Global 2"); + + $email->addContent( + "text/plain", + "and easy to do anywhere, even with PHP" + ); + $email->addContent( + "text/html", + "and easy to do anywhere, even with PHP" + ); + $contents = [ + "text/calendar" => "Party Time!!", + "text/calendar2" => "Party Time 2!!" + ]; + $email->addContents($contents); + + $email->setTemplateId("d-13b8f94f-bcae-4ec6-b752-70d6cb59f932"); + + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } + + /** + * Test all parameters without using objects with Dynamic Templates + */ + public function testKitchenSinkExampleWithoutObjectsAndDynamicTemplate() + { + $email = new \SendGrid\Mail\Mail(); + + // For a detailed description of each of these settings, + // please see the + // [documentation](https://sendgrid.com/docs/API_Reference/api_v3.html). + $email->setSubject("Sending with Twilio SendGrid is Fun 2"); + + $email->addTo("test@example.com", "Example User"); + $email->addTo("test+1@example.com", "Example User1"); + $toEmails = [ + "test+2@example.com" => "Example User2", + "test+3@example.com" => "Example User3" + ]; + $email->addTos($toEmails); + + $email->addCc("test+4@example.com", "Example User4"); + $ccEmails = [ + "test+5@example.com" => "Example User5", + "test+6@example.com" => "Example User6" + ]; + $email->addCcs($ccEmails); + + $email->addBcc("test+7@example.com", "Example User7"); + $bccEmails = [ + "test+8@example.com" => "Example User8", + "test+9@example.com" => "Example User9" + ]; + $email->addBccs($bccEmails); + + $email->addSubstitution("%name1%", "Example Name 1"); + $email->addSubstitution("%city1%", "Denver"); + $substitutions = [ + "%name2%" => "Example Name 2", + "%city2%" => "Orange" + ]; + $email->addSubstitutions($substitutions); + + // The values below this comment are global to entire message + + $email->setFrom("test@example.com", "DX"); + + $email->setGlobalSubject("Sending with Twilio SendGrid is Fun and Global 2"); + + $email->addContent( + "text/plain", + "and easy to do anywhere, even with PHP" + ); + $email->addContent( + "text/html", + "and easy to do anywhere, even with PHP" + ); + $contents = [ + "text/calendar" => "Party Time!!", + "text/calendar2" => "Party Time 2!!" + ]; + $email->addContents($contents); + + $email->setTemplateId("d-13b8f94f-bcae-4ec6-b752-70d6cb59f932"); + + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } + + /** + * Test all parameters using objects + */ + public function testKitchenSinkExampleWithObjectsAndLegacyTemplate() + { + $email = new \SendGrid\Mail\Mail(); + + // For a detailed description of each of these settings, + // please see the + // [documentation](https://sendgrid.com/docs/API_Reference/api_v3.html). + $email->setSubject( + new \SendGrid\Mail\Subject("Sending with Twilio SendGrid is Fun 2") + ); + + $email->addTo(new \SendGrid\Mail\To("test@example.com", "Example User")); + $email->addTo(new \SendGrid\Mail\To("test+1@example.com", "Example User1")); + $toEmails = [ + new \SendGrid\Mail\To("test+2@example.com", "Example User2"), + new \SendGrid\Mail\To("test+3@example.com", "Example User3") + ]; + $email->addTos($toEmails); + + $email->addCc(new \SendGrid\Mail\Cc("test+4@example.com", "Example User4")); + $ccEmails = [ + new \SendGrid\Mail\Cc("test+5@example.com", "Example User5"), + new \SendGrid\Mail\Cc("test+6@example.com", "Example User6") + ]; + $email->addCcs($ccEmails); + + $email->addBcc( + new \SendGrid\Mail\Bcc("test+7@example.com", "Example User7") + ); + $bccEmails = [ + new \SendGrid\Mail\Bcc("test+8@example.com", "Example User8"), + new \SendGrid\Mail\Bcc("test+9@example.com", "Example User9") + ]; + $email->addBccs($bccEmails); + + $email->addSubstitution( + new \SendGrid\Mail\Substitution("%name1%", "Example Name 1") + ); + $email->addSubstitution( + new \SendGrid\Mail\Substitution("%city1%", "Denver") + ); + $substitutions = [ + new \SendGrid\Mail\Substitution("%name2%", "Example Name 2"), + new \SendGrid\Mail\Substitution("%city2%", "Orange") + ]; + $email->addSubstitutions($substitutions); + + // The values below this comment are global to entire message + + $email->setFrom(new \SendGrid\Mail\From("test@example.com", "DX")); + + $email->setGlobalSubject( + new \SendGrid\Mail\Subject("Sending with Twilio SendGrid is Fun and Global 2") + ); + + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "and easy to do anywhere, even with PHP" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "and easy to do anywhere, even with PHP" + ); + $email->addContent($plainTextContent); + $email->addContent($htmlContent); + $contents = [ + new \SendGrid\Mail\Content("text/calendar", "Party Time!!"), + new \SendGrid\Mail\Content("text/calendar2", "Party Time 2!!") + ]; + $email->addContents($contents); + + $email->setTemplateId( + new \SendGrid\Mail\TemplateId("13b8f94f-bcae-4ec6-b752-70d6cb59f932") + ); + + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT_LEGACY); + $this->assertTrue($isEqual); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/FilesExistTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/FilesExistTest.php new file mode 100644 index 0000000..0ce586c --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/FilesExistTest.php @@ -0,0 +1,48 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Tests; + +use PHPUnit\Framework\TestCase; + +/** + * This class tests the existence of necessary files in this repo + * + * @package SendGrid\Tests + */ +class FilesExistTest extends TestCase +{ + /** + * This method tests that the required files exist in the repo + */ + public function testFilesArePresentInRepo() + { + $rootDir = __DIR__ . '/../..'; + $this->assertFileExists("$rootDir/docker/Dockerfile"); + //$this->assertFileExists("$rootDir/docker/docker-compose.yml"); + $this->assertFileExists("$rootDir/.codeclimate.yml"); + $this->assertFileExists("$rootDir/.env.sample"); + $this->assertFileExists("$rootDir/.github/ISSUE_TEMPLATE"); + $this->assertFileExists("$rootDir/.github/PULL_REQUEST_TEMPLATE"); + $this->assertFileExists("$rootDir/.gitignore"); + $this->assertFileExists("$rootDir/.travis.yml"); + $this->assertFileExists("$rootDir/CHANGELOG.md"); + $this->assertFileExists("$rootDir/CODE_OF_CONDUCT.md"); + $this->assertFileExists("$rootDir/LICENSE.md"); + $this->assertFileExists("$rootDir/README.md"); + $this->assertFileExists("$rootDir/TROUBLESHOOTING.md"); + $this->assertFileExists("$rootDir/USAGE.md"); + $this->assertFileExists("$rootDir/USE_CASES.md"); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/KitchenSinkTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/KitchenSinkTest.php new file mode 100644 index 0000000..28d047a --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/KitchenSinkTest.php @@ -0,0 +1,1229 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Tests; + +/** + * This class tests the request object generation for a /mail/send API call + * + * @package SendGrid\Tests + */ +class KitchenSinkTest extends BaseTestClass +{ + + private $REQUEST_OBJECT_DYNAMIC = <<<'JSON' +{ + "asm": { + "group_id": 1, + "groups_to_display": [ + 1, + 2, + 3, + 4 + ] + }, + "attachments": [ + { + "content": "YmFzZTY0IGVuY29kZWQgY29udGVudDE=", + "content_id": "Banner", + "disposition": "inline", + "filename": "banner.png", + "type": "image/png" + }, + { + "content": "YmFzZTY0IGVuY29kZWQgY29udGVudDI=", + "content_id": "Banner 3", + "disposition": "attachment", + "filename": "image/jpeg", + "type": "banner2.jpeg" + }, + { + "content": "YmFzZTY0IGVuY29kZWQgY29udGVudDM=", + "content_id": "Banner 3", + "disposition": "inline", + "filename": "image/gif", + "type": "banner3.gif" + } + ], + "batch_id": "MWQxZmIyODYtNjE1Ni0xMWU1LWI3ZTUtMDgwMDI3OGJkMmY2LWEzMmViMjYxMw", + "categories": [ + "Category 1", + "Category 2", + "Category 3" + ], + "content": [ + { + "type": "text/plain", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/html", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/calendar", + "value": "Party Time!!" + }, + { + "type": "text/calendar2", + "value": "Party Time 2!!" + } + ], + "from": { + "email": "test@example.com", + "name": "DX" + }, + "headers": { + "X-Day": "Monday", + "X-Month": "January", + "X-Year": "2017" + }, + "ip_pool_name": "23", + "mail_settings": { + "bcc": { + "email": "bcc@example.com", + "enable": true + }, + "bypass_list_management": { + "enable": true + }, + "footer": { + "enable": true, + "html": "Footer", + "text": "Footer" + }, + "sandbox_mode": { + "enable": true + }, + "spam_check": { + "enable": true, + "post_to_url": "http://mydomain.com", + "threshold": 1 + } + }, + "personalizations": [ + { + "bcc": [ + { + "email": "test+7@example.com", + "name": "Example User7" + }, + { + "email": "test+8@example.com", + "name": "Example User8" + }, + { + "email": "test+9@example.com", + "name": "Example User9" + } + ], + "cc": [ + { + "email": "test+4@example.com", + "name": "Example User4" + }, + { + "email": "test+5@example.com", + "name": "Example User5" + }, + { + "email": "test+6@example.com", + "name": "Example User6" + } + ], + "custom_args": { + "category": "name", + "marketing1": "false", + "marketing2": "true", + "transactional1": "true", + "transactional2": "false" + }, + "headers": { + "X-Test1": "Test1", + "X-Test2": "Test2", + "X-Test3": "Test3", + "X-Test4": "Test4" + }, + "send_at": 1461775051, + "dynamic_template_data": { + "object": { + "key1": "Key 1", + "key2": "Key 2" + }, + "boolean": false, + "array": [ + "index0", + "index1" + ], + "number": 1 + }, + "to": [ + { + "email": "test@example.com", + "name": "Example User" + }, + { + "email": "test+1@example.com", + "name": "Example User1" + }, + { + "email": "test+2@example.com", + "name": "Example User2" + }, + { + "email": "test+3@example.com", + "name": "Example User3" + } + ] + } + ], + "reply_to": { + "email": "dx+replyto2@example.com", + "name": "DX Team Reply To 2" + }, + "sections": { + "%section1%": "Substitution for Section 1 Tag", + "%section3%": "Substitution for Section 3 Tag", + "%section4%": "Substitution for Section 4 Tag" + }, + "subject": "Sending with Twilio SendGrid is Fun and Global 2", + "template_id": "d-13b8f94fbcae4ec6b75270d6cb59f932", + "tracking_settings": { + "click_tracking": { + "enable": true, + "enable_text": true + }, + "ganalytics": { + "enable": true, + "utm_campaign": "utm_campaign", + "utm_content": "utm_content", + "utm_medium": "utm_medium", + "utm_source": "utm_source", + "utm_term": "utm_term" + }, + "open_tracking": { + "enable": true, + "substitution_tag": "--sub--" + }, + "subscription_tracking": { + "enable": true, + "html": "subscribe", + "substitution_tag": "%%sub%%", + "text": "subscribe" + } + } +} +JSON; + + private $REQUEST_OBJECT = <<<'JSON' +{ + "asm": { + "group_id": 1, + "groups_to_display": [ + 1, + 2, + 3, + 4 + ] + }, + "attachments": [ + { + "content": "YmFzZTY0IGVuY29kZWQgY29udGVudDE=", + "content_id": "Banner", + "disposition": "inline", + "filename": "banner.png", + "type": "image/png" + }, + { + "content": "YmFzZTY0IGVuY29kZWQgY29udGVudDI=", + "content_id": "Banner 3", + "disposition": "attachment", + "filename": "image/jpeg", + "type": "banner2.jpeg" + }, + { + "content": "YmFzZTY0IGVuY29kZWQgY29udGVudDM=", + "content_id": "Banner 3", + "disposition": "inline", + "filename": "image/gif", + "type": "banner3.gif" + } + ], + "batch_id": "MWQxZmIyODYtNjE1Ni0xMWU1LWI3ZTUtMDgwMDI3OGJkMmY2LWEzMmViMjYxMw", + "categories": [ + "Category 1", + "Category 2", + "Category 3" + ], + "content": [ + { + "type": "text/plain", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/html", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/calendar", + "value": "Party Time!!" + }, + { + "type": "text/calendar2", + "value": "Party Time 2!!" + } + ], + "from": { + "email": "test@example.com", + "name": "DX" + }, + "headers": { + "X-Day": "Monday", + "X-Month": "January", + "X-Year": "2017" + }, + "ip_pool_name": "23", + "mail_settings": { + "bcc": { + "email": "bcc@example.com", + "enable": true + }, + "bypass_list_management": { + "enable": true + }, + "footer": { + "enable": true, + "html": "Footer", + "text": "Footer" + }, + "sandbox_mode": { + "enable": true + }, + "spam_check": { + "enable": true, + "post_to_url": "http://mydomain.com", + "threshold": 1 + } + }, + "personalizations": [ + { + "bcc": [ + { + "email": "test+7@example.com", + "name": "Example User7" + }, + { + "email": "test+8@example.com", + "name": "Example User8" + }, + { + "email": "test+9@example.com", + "name": "Example User9" + } + ], + "cc": [ + { + "email": "test+4@example.com", + "name": "Example User4" + }, + { + "email": "test+5@example.com", + "name": "Example User5" + }, + { + "email": "test+6@example.com", + "name": "Example User6" + } + ], + "custom_args": { + "category": "name", + "marketing1": "false", + "marketing2": "true", + "transactional1": "true", + "transactional2": "false" + }, + "headers": { + "X-Test1": "Test1", + "X-Test2": "Test2", + "X-Test3": "Test3", + "X-Test4": "Test4" + }, + "send_at": 1461775051, + "substitutions": { + "%city1%": "Denver", + "%city2%": "Orange", + "%name1%": "Example Name 1", + "%name2%": "Example Name 2" + }, + "to": [ + { + "email": "test@example.com", + "name": "Example User" + }, + { + "email": "test+1@example.com", + "name": "Example User1" + }, + { + "email": "test+2@example.com", + "name": "Example User2" + }, + { + "email": "test+3@example.com", + "name": "Example User3" + } + ] + } + ], + "reply_to": { + "email": "dx+replyto2@example.com", + "name": "DX Team Reply To 2" + }, + "sections": { + "%section1%": "Substitution for Section 1 Tag", + "%section3%": "Substitution for Section 3 Tag", + "%section4%": "Substitution for Section 4 Tag" + }, + "subject": "Sending with Twilio SendGrid is Fun and Global 2", + "template_id": "13b8f94f-bcae-4ec6-b752-70d6cb59f932", + "tracking_settings": { + "click_tracking": { + "enable": true, + "enable_text": true + }, + "ganalytics": { + "enable": true, + "utm_campaign": "utm_campaign", + "utm_content": "utm_content", + "utm_medium": "utm_medium", + "utm_source": "utm_source", + "utm_term": "utm_term" + }, + "open_tracking": { + "enable": true, + "substitution_tag": "--sub--" + }, + "subscription_tracking": { + "enable": true, + "html": "subscribe", + "substitution_tag": "%%sub%%", + "text": "subscribe" + } + } +} +JSON; + + /** + * Test all parameters without using objects + */ + public function testKitchenSinkExampleWithoutObjects() + { + $email = new \SendGrid\Mail\Mail(); + + // For a detailed description of each of these settings, + // please see the + // [documentation](https://sendgrid.com/docs/API_Reference/api_v3.html). + $email->setSubject("Sending with Twilio SendGrid is Fun 2"); + + $email->addTo("test@example.com", "Example User"); + $email->addTo("test+1@example.com", "Example User1"); + $toEmails = [ + "test+2@example.com" => "Example User2", + "test+3@example.com" => "Example User3" + ]; + $email->addTos($toEmails); + + $email->addCc("test+4@example.com", "Example User4"); + $ccEmails = [ + "test+5@example.com" => "Example User5", + "test+6@example.com" => "Example User6" + ]; + $email->addCcs($ccEmails); + + $email->addBcc("test+7@example.com", "Example User7"); + $bccEmails = [ + "test+8@example.com" => "Example User8", + "test+9@example.com" => "Example User9" + ]; + $email->addBccs($bccEmails); + + $email->addHeader("X-Test1", "Test1"); + $email->addHeader("X-Test2", "Test2"); + $headers = [ + "X-Test3" => "Test3", + "X-Test4" => "Test4", + ]; + $email->addHeaders($headers); + + $email->addSubstitution("%name1%", "Example Name 1"); + $email->addSubstitution("%city1%", "Denver"); + $substitutions = [ + "%name2%" => "Example Name 2", + "%city2%" => "Orange" + ]; + $email->addSubstitutions($substitutions); + + $email->addCustomArg("marketing1", "false"); + $email->addCustomArg("transactional1", "true"); + $email->addCustomArg("category", "name"); + $customArgs = [ + "marketing2" => "true", + "transactional2" => "false", + "category" => "name" + ]; + $email->addCustomArgs($customArgs); + + $email->setSendAt(1461775051); + + // The values below this comment are global to entire message + + $email->setFrom("test@example.com", "DX"); + + $email->setGlobalSubject("Sending with Twilio SendGrid is Fun and Global 2"); + + $email->addContent( + "text/plain", + "and easy to do anywhere, even with PHP" + ); + $email->addContent( + "text/html", + "and easy to do anywhere, even with PHP" + ); + $contents = [ + "text/calendar" => "Party Time!!", + "text/calendar2" => "Party Time 2!!" + ]; + $email->addContents($contents); + + $email->addAttachment( + "base64 encoded content1", + "image/png", + "banner.png", + "inline", + "Banner" + ); + $attachments = [ + [ + "base64 encoded content2", + "banner2.jpeg", + "image/jpeg", + "attachment", + "Banner 3" + ], + [ + "base64 encoded content3", + "banner3.gif", + "image/gif", + "inline", + "Banner 3" + ] + ]; + $email->addAttachments($attachments); + + $email->setTemplateId("13b8f94f-bcae-4ec6-b752-70d6cb59f932"); + + $email->addGlobalHeader("X-Day", "Monday"); + $globalHeaders = [ + "X-Month" => "January", + "X-Year" => "2017" + ]; + $email->addGlobalHeaders($globalHeaders); + + $email->addSection("%section1%", "Substitution for Section 1 Tag"); + $sections = [ + "%section3%" => "Substitution for Section 3 Tag", + "%section4%" => "Substitution for Section 4 Tag" + ]; + $email->addSections($sections); + + $email->addCategory("Category 1"); + $categories = [ + "Category 2", + "Category 3" + ]; + $email->addCategories($categories); + + $email->setBatchId( + "MWQxZmIyODYtNjE1Ni0xMWU1LWI3ZTUtMDgwMDI3OGJkMmY2LWEzMmViMjYxMw" + ); + + $email->setReplyTo("dx+replyto2@example.com", "DX Team Reply To 2"); + + $email->setAsm(1, [1, 2, 3, 4]); + + $email->setIpPoolName("23"); + + // Mail Settings + $email->setBccSettings(true, "bcc@example.com"); + $email->enableBypassListManagement(); + //$email->disableBypassListManagement(); + $email->setFooter(true, "Footer", "Footer"); + $email->enableSandBoxMode(); + //$email->disableSandBoxMode(); + $email->setSpamCheck(true, 1, "http://mydomain.com"); + + // Tracking Settings + $email->setClickTracking(true, true); + $email->setOpenTracking(true, "--sub--"); + $email->setSubscriptionTracking( + true, + "subscribe", + "subscribe", + "%%sub%%" + ); + $email->setGanalytics( + true, + "utm_source", + "utm_medium", + "utm_term", + "utm_content", + "utm_campaign" + ); + + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } + + /** + * Test all parameters without using objects with dynamic templates + */ + public function testKitchenSinkExampleWithoutObjectsWithDynamicTemplates() + { + $email = new \SendGrid\Mail\Mail(); + + // For a detailed description of each of these settings, + // please see the + // [documentation](https://sendgrid.com/docs/API_Reference/api_v3.html). + $email->setSubject("Sending with Twilio SendGrid is Fun 2"); + + $email->addTo("test@example.com", "Example User"); + $email->addTo("test+1@example.com", "Example User1"); + $toEmails = [ + "test+2@example.com" => "Example User2", + "test+3@example.com" => "Example User3" + ]; + $email->addTos($toEmails); + + $email->addCc("test+4@example.com", "Example User4"); + $ccEmails = [ + "test+5@example.com" => "Example User5", + "test+6@example.com" => "Example User6" + ]; + $email->addCcs($ccEmails); + + $email->addBcc("test+7@example.com", "Example User7"); + $bccEmails = [ + "test+8@example.com" => "Example User8", + "test+9@example.com" => "Example User9" + ]; + $email->addBccs($bccEmails); + + $email->addHeader("X-Test1", "Test1"); + $email->addHeader("X-Test2", "Test2"); + $headers = [ + "X-Test3" => "Test3", + "X-Test4" => "Test4", + ]; + $email->addHeaders($headers); + + $email->addDynamicTemplateData('object', [ + 'key1' => 'Key 1', + 'key2' => 'Key 2', + ]); + $email->addDynamicTemplateData('boolean', false); + $email->addDynamicTemplateData('array', [ + 'index0', + 'index1', + ]); + $email->addDynamicTemplateData('number', 1); + + $email->addCustomArg("marketing1", "false"); + $email->addCustomArg("transactional1", "true"); + $email->addCustomArg("category", "name"); + $customArgs = [ + "marketing2" => "true", + "transactional2" => "false", + "category" => "name" + ]; + $email->addCustomArgs($customArgs); + + $email->setSendAt(1461775051); + + // The values below this comment are global to entire message + + $email->setFrom("test@example.com", "DX"); + + $email->setGlobalSubject("Sending with Twilio SendGrid is Fun and Global 2"); + + $email->addContent( + "text/plain", + "and easy to do anywhere, even with PHP" + ); + $email->addContent( + "text/html", + "and easy to do anywhere, even with PHP" + ); + $contents = [ + "text/calendar" => "Party Time!!", + "text/calendar2" => "Party Time 2!!" + ]; + $email->addContents($contents); + + $email->addAttachment( + "base64 encoded content1", + "image/png", + "banner.png", + "inline", + "Banner" + ); + $attachments = [ + [ + "base64 encoded content2", + "banner2.jpeg", + "image/jpeg", + "attachment", + "Banner 3" + ], + [ + "base64 encoded content3", + "banner3.gif", + "image/gif", + "inline", + "Banner 3" + ] + ]; + $email->addAttachments($attachments); + + $email->setTemplateId("d-13b8f94fbcae4ec6b75270d6cb59f932"); + + $email->addGlobalHeader("X-Day", "Monday"); + $globalHeaders = [ + "X-Month" => "January", + "X-Year" => "2017" + ]; + $email->addGlobalHeaders($globalHeaders); + + $email->addSection("%section1%", "Substitution for Section 1 Tag"); + $sections = [ + "%section3%" => "Substitution for Section 3 Tag", + "%section4%" => "Substitution for Section 4 Tag" + ]; + $email->addSections($sections); + + $email->addCategory("Category 1"); + $categories = [ + "Category 2", + "Category 3" + ]; + $email->addCategories($categories); + + $email->setBatchId( + "MWQxZmIyODYtNjE1Ni0xMWU1LWI3ZTUtMDgwMDI3OGJkMmY2LWEzMmViMjYxMw" + ); + + $email->setReplyTo("dx+replyto2@example.com", "DX Team Reply To 2"); + + $email->setAsm(1, [1, 2, 3, 4]); + + $email->setIpPoolName("23"); + + // Mail Settings + $email->setBccSettings(true, "bcc@example.com"); + $email->enableBypassListManagement(); + //$email->disableBypassListManagement(); + $email->setFooter(true, "Footer", "Footer"); + $email->enableSandBoxMode(); + //$email->disableSandBoxMode(); + $email->setSpamCheck(true, 1, "http://mydomain.com"); + + // Tracking Settings + $email->setClickTracking(true, true); + $email->setOpenTracking(true, "--sub--"); + $email->setSubscriptionTracking( + true, + "subscribe", + "subscribe", + "%%sub%%" + ); + $email->setGanalytics( + true, + "utm_source", + "utm_medium", + "utm_term", + "utm_content", + "utm_campaign" + ); + + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT_DYNAMIC); + $this->assertTrue($isEqual); + } + + + /** + * Test all parameters using objects + */ + public function testKitchenSinkExampleWithObjects() + { + $email = new \SendGrid\Mail\Mail(); + + // For a detailed description of each of these settings, + // please see the + // [documentation](https://sendgrid.com/docs/API_Reference/api_v3.html). + $email->setSubject( + new \SendGrid\Mail\Subject("Sending with Twilio SendGrid is Fun 2") + ); + + $email->addTo(new \SendGrid\Mail\To("test@example.com", "Example User")); + $email->addTo(new \SendGrid\Mail\To("test+1@example.com", "Example User1")); + $toEmails = [ + new \SendGrid\Mail\To("test+2@example.com", "Example User2"), + new \SendGrid\Mail\To("test+3@example.com", "Example User3") + ]; + $email->addTos($toEmails); + + $email->addCc(new \SendGrid\Mail\Cc("test+4@example.com", "Example User4")); + $ccEmails = [ + new \SendGrid\Mail\Cc("test+5@example.com", "Example User5"), + new \SendGrid\Mail\Cc("test+6@example.com", "Example User6") + ]; + $email->addCcs($ccEmails); + + $email->addBcc( + new \SendGrid\Mail\Bcc("test+7@example.com", "Example User7") + ); + $bccEmails = [ + new \SendGrid\Mail\Bcc("test+8@example.com", "Example User8"), + new \SendGrid\Mail\Bcc("test+9@example.com", "Example User9") + ]; + $email->addBccs($bccEmails); + + $email->addHeader(new \SendGrid\Mail\Header("X-Test1", "Test1")); + $email->addHeader(new \SendGrid\Mail\Header("X-Test2", "Test2")); + $headers = [ + new \SendGrid\Mail\Header("X-Test3", "Test3"), + new \SendGrid\Mail\Header("X-Test4", "Test4") + ]; + $email->addHeaders($headers); + + $email->addSubstitution( + new \SendGrid\Mail\Substitution("%name1%", "Example Name 1") + ); + $email->addSubstitution( + new \SendGrid\Mail\Substitution("%city1%", "Denver") + ); + $substitutions = [ + new \SendGrid\Mail\Substitution("%name2%", "Example Name 2"), + new \SendGrid\Mail\Substitution("%city2%", "Orange") + ]; + $email->addSubstitutions($substitutions); + + $email->addCustomArg(new \SendGrid\Mail\CustomArg("marketing1", "false")); + $email->addCustomArg(new \SendGrid\Mail\CustomArg("transactional1", "true")); + $email->addCustomArg(new \SendGrid\Mail\CustomArg("category", "name")); + $customArgs = [ + new \SendGrid\Mail\CustomArg("marketing2", "true"), + new \SendGrid\Mail\CustomArg("transactional2", "false"), + new \SendGrid\Mail\CustomArg("category", "name") + ]; + $email->addCustomArgs($customArgs); + + $email->setSendAt(new \SendGrid\Mail\SendAt(1461775051)); + + // The values below this comment are global to entire message + + $email->setFrom(new \SendGrid\Mail\From("test@example.com", "DX")); + + $email->setGlobalSubject( + new \SendGrid\Mail\Subject("Sending with Twilio SendGrid is Fun and Global 2") + ); + + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "and easy to do anywhere, even with PHP" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "and easy to do anywhere, even with PHP" + ); + $email->addContent($plainTextContent); + $email->addContent($htmlContent); + $contents = [ + new \SendGrid\Mail\Content("text/calendar", "Party Time!!"), + new \SendGrid\Mail\Content("text/calendar2", "Party Time 2!!") + ]; + $email->addContents($contents); + + $email->addAttachment( + new \SendGrid\Mail\Attachment( + "base64 encoded content1", + "image/png", + "banner.png", + "inline", + "Banner" + ) + ); + $attachments = [ + new \SendGrid\Mail\Attachment( + "base64 encoded content2", + "banner2.jpeg", + "image/jpeg", + "attachment", + "Banner 3" + ), + new \SendGrid\Mail\Attachment( + "base64 encoded content3", + "banner3.gif", + "image/gif", + "inline", + "Banner 3" + ) + ]; + $email->addAttachments($attachments); + + $email->setTemplateId( + new \SendGrid\Mail\TemplateId("13b8f94f-bcae-4ec6-b752-70d6cb59f932") + ); + + $email->addGlobalHeader(new \SendGrid\Mail\Header("X-Day", "Monday")); + $globalHeaders = [ + new \SendGrid\Mail\Header("X-Month", "January"), + new \SendGrid\Mail\Header("X-Year", "2017") + ]; + $email->addGlobalHeaders($globalHeaders); + + $email->addSection( + new \SendGrid\Mail\Section( + "%section1%", + "Substitution for Section 1 Tag" + ) + ); + + $sections = [ + new \SendGrid\Mail\Section( + "%section3%", + "Substitution for Section 3 Tag" + ), + new \SendGrid\Mail\Section( + "%section4%", + "Substitution for Section 4 Tag" + ) + ]; + $email->addSections($sections); + + $email->addCategory(new \SendGrid\Mail\Category("Category 1")); + $categories = [ + new \SendGrid\Mail\Category("Category 2"), + new \SendGrid\Mail\Category("Category 3") + ]; + $email->addCategories($categories); + + $email->setBatchId( + new \SendGrid\Mail\BatchId( + "MWQxZmIyODYtNjE1Ni0xMWU1LWI3ZTUtMDgwMDI3OGJkMmY2LWEzMmViMjYxMw" + ) + ); + + $email->setReplyTo( + new \SendGrid\Mail\ReplyTo( + "dx+replyto2@example.com", + "DX Team Reply To 2" + ) + ); + + $asm = new \SendGrid\Mail\Asm( + new \SendGrid\Mail\GroupId(1), + new \SendGrid\Mail\GroupsToDisplay([1, 2, 3, 4]) + ); + $email->setAsm($asm); + + $email->setIpPoolName(new \SendGrid\Mail\IpPoolName("23")); + + $mail_settings = new \SendGrid\Mail\MailSettings(); + $mail_settings->setBccSettings( + new \SendGrid\Mail\BccSettings(true, "bcc@example.com") + ); + $mail_settings->setBypassListManagement( + new \SendGrid\Mail\BypassListManagement(true) + ); + $mail_settings->setFooter( + new \SendGrid\Mail\Footer(true, "Footer", "Footer") + ); + $mail_settings->setSandBoxMode(new \SendGrid\Mail\SandBoxMode(true)); + $mail_settings->setSpamCheck( + new \SendGrid\Mail\SpamCheck(true, 1, "http://mydomain.com") + ); + $email->setMailSettings($mail_settings); + + $tracking_settings = new \SendGrid\Mail\TrackingSettings(); + $tracking_settings->setClickTracking( + new \SendGrid\Mail\ClickTracking(true, true) + ); + $tracking_settings->setOpenTracking( + new \SendGrid\Mail\OpenTracking(true, "--sub--") + ); + $tracking_settings->setSubscriptionTracking( + new \SendGrid\Mail\SubscriptionTracking( + true, + "subscribe", + "subscribe", + "%%sub%%" + ) + ); + $tracking_settings->setGanalytics( + new \SendGrid\Mail\Ganalytics( + true, + "utm_source", + "utm_medium", + "utm_term", + "utm_content", + "utm_campaign" + ) + ); + $email->setTrackingSettings($tracking_settings); + + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } + + /** + * Test all parameters using objects with dynamic templates + */ + public function testKitchenSinkExampleWithObjectsWithDynamicTemplate() + { + $email = new \SendGrid\Mail\Mail(); + + // For a detailed description of each of these settings, + // please see the + // [documentation](https://sendgrid.com/docs/API_Reference/api_v3.html). + $email->setSubject( + new \SendGrid\Mail\Subject("Sending with Twilio SendGrid is Fun 2") + ); + + $email->addTo(new \SendGrid\Mail\To("test@example.com", "Example User")); + $email->addTo(new \SendGrid\Mail\To("test+1@example.com", "Example User1")); + $toEmails = [ + new \SendGrid\Mail\To("test+2@example.com", "Example User2"), + new \SendGrid\Mail\To("test+3@example.com", "Example User3") + ]; + $email->addTos($toEmails); + + $email->addCc(new \SendGrid\Mail\Cc("test+4@example.com", "Example User4")); + $ccEmails = [ + new \SendGrid\Mail\Cc("test+5@example.com", "Example User5"), + new \SendGrid\Mail\Cc("test+6@example.com", "Example User6") + ]; + $email->addCcs($ccEmails); + + $email->addBcc( + new \SendGrid\Mail\Bcc("test+7@example.com", "Example User7") + ); + $bccEmails = [ + new \SendGrid\Mail\Bcc("test+8@example.com", "Example User8"), + new \SendGrid\Mail\Bcc("test+9@example.com", "Example User9") + ]; + $email->addBccs($bccEmails); + + $email->addHeader(new \SendGrid\Mail\Header("X-Test1", "Test1")); + $email->addHeader(new \SendGrid\Mail\Header("X-Test2", "Test2")); + $headers = [ + new \SendGrid\Mail\Header("X-Test3", "Test3"), + new \SendGrid\Mail\Header("X-Test4", "Test4") + ]; + $email->addHeaders($headers); + + $email->addDynamicTemplateData( + new \SendGrid\Mail\Substitution('object', [ + 'key1' => 'Key 1', + 'key2' => 'Key 2', + ]) + ); + $email->addDynamicTemplateData( + new \SendGrid\Mail\Substitution('boolean', false) + ); + $email->addDynamicTemplateDatas([ + new \SendGrid\Mail\Substitution('array', [ + 'index0', + 'index1', + ]), + new \SendGrid\Mail\Substitution('number', 1), + ]); + + $email->addCustomArg(new \SendGrid\Mail\CustomArg("marketing1", "false")); + $email->addCustomArg(new \SendGrid\Mail\CustomArg("transactional1", "true")); + $email->addCustomArg(new \SendGrid\Mail\CustomArg("category", "name")); + $customArgs = [ + new \SendGrid\Mail\CustomArg("marketing2", "true"), + new \SendGrid\Mail\CustomArg("transactional2", "false"), + new \SendGrid\Mail\CustomArg("category", "name") + ]; + $email->addCustomArgs($customArgs); + + $email->setSendAt(new \SendGrid\Mail\SendAt(1461775051)); + + // The values below this comment are global to entire message + + $email->setFrom(new \SendGrid\Mail\From("test@example.com", "DX")); + + $email->setGlobalSubject( + new \SendGrid\Mail\Subject("Sending with Twilio SendGrid is Fun and Global 2") + ); + + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "and easy to do anywhere, even with PHP" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "and easy to do anywhere, even with PHP" + ); + $email->addContent($plainTextContent); + $email->addContent($htmlContent); + $contents = [ + new \SendGrid\Mail\Content("text/calendar", "Party Time!!"), + new \SendGrid\Mail\Content("text/calendar2", "Party Time 2!!") + ]; + $email->addContents($contents); + + $email->addAttachment( + new \SendGrid\Mail\Attachment( + "base64 encoded content1", + "image/png", + "banner.png", + "inline", + "Banner" + ) + ); + $attachments = [ + new \SendGrid\Mail\Attachment( + "base64 encoded content2", + "banner2.jpeg", + "image/jpeg", + "attachment", + "Banner 3" + ), + new \SendGrid\Mail\Attachment( + "base64 encoded content3", + "banner3.gif", + "image/gif", + "inline", + "Banner 3" + ) + ]; + $email->addAttachments($attachments); + + $email->setTemplateId( + new \SendGrid\Mail\TemplateId("d-13b8f94fbcae4ec6b75270d6cb59f932") + ); + + $email->addGlobalHeader(new \SendGrid\Mail\Header("X-Day", "Monday")); + $globalHeaders = [ + new \SendGrid\Mail\Header("X-Month", "January"), + new \SendGrid\Mail\Header("X-Year", "2017") + ]; + $email->addGlobalHeaders($globalHeaders); + + $email->addSection( + new \SendGrid\Mail\Section( + "%section1%", + "Substitution for Section 1 Tag" + ) + ); + + $sections = [ + new \SendGrid\Mail\Section( + "%section3%", + "Substitution for Section 3 Tag" + ), + new \SendGrid\Mail\Section( + "%section4%", + "Substitution for Section 4 Tag" + ) + ]; + $email->addSections($sections); + + $email->addCategory(new \SendGrid\Mail\Category("Category 1")); + $categories = [ + new \SendGrid\Mail\Category("Category 2"), + new \SendGrid\Mail\Category("Category 3") + ]; + $email->addCategories($categories); + + $email->setBatchId( + new \SendGrid\Mail\BatchId( + "MWQxZmIyODYtNjE1Ni0xMWU1LWI3ZTUtMDgwMDI3OGJkMmY2LWEzMmViMjYxMw" + ) + ); + + $email->setReplyTo( + new \SendGrid\Mail\ReplyTo( + "dx+replyto2@example.com", + "DX Team Reply To 2" + ) + ); + + $asm = new \SendGrid\Mail\Asm( + new \SendGrid\Mail\GroupId(1), + new \SendGrid\Mail\GroupsToDisplay([1, 2, 3, 4]) + ); + $email->setAsm($asm); + + $email->setIpPoolName(new \SendGrid\Mail\IpPoolName("23")); + + $mail_settings = new \SendGrid\Mail\MailSettings(); + $mail_settings->setBccSettings( + new \SendGrid\Mail\BccSettings(true, "bcc@example.com") + ); + $mail_settings->setBypassListManagement( + new \SendGrid\Mail\BypassListManagement(true) + ); + $mail_settings->setFooter( + new \SendGrid\Mail\Footer(true, "Footer", "Footer") + ); + $mail_settings->setSandBoxMode(new \SendGrid\Mail\SandBoxMode(true)); + $mail_settings->setSpamCheck( + new \SendGrid\Mail\SpamCheck(true, 1, "http://mydomain.com") + ); + $email->setMailSettings($mail_settings); + + $tracking_settings = new \SendGrid\Mail\TrackingSettings(); + $tracking_settings->setClickTracking( + new \SendGrid\Mail\ClickTracking(true, true) + ); + $tracking_settings->setOpenTracking( + new \SendGrid\Mail\OpenTracking(true, "--sub--") + ); + $tracking_settings->setSubscriptionTracking( + new \SendGrid\Mail\SubscriptionTracking( + true, + "subscribe", + "subscribe", + "%%sub%%" + ) + ); + $tracking_settings->setGanalytics( + new \SendGrid\Mail\Ganalytics( + true, + "utm_source", + "utm_medium", + "utm_term", + "utm_content", + "utm_campaign" + ) + ); + $email->setTrackingSettings($tracking_settings); + + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT_DYNAMIC); + $this->assertTrue($isEqual); + } +} \ No newline at end of file diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MailGetContentsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MailGetContentsTest.php new file mode 100644 index 0000000..cda8337 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MailGetContentsTest.php @@ -0,0 +1,38 @@ +setFrom("test@example.com", null); + $email->setSubject("Hello World from the Twilio SendGrid PHP Library"); + $email->addTo("test@example.com", "Test Person"); + + $email->addContent("text/html", "

    some text here

    "); + $email->addContent("text/plain", "some text here"); + + $this->assertEquals('text/plain', $email->getContents()[0]->getType()); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MailHelperTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MailHelperTest.php new file mode 100644 index 0000000..7a3487f --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MailHelperTest.php @@ -0,0 +1,84 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Tests; + +use SendGrid\Mail\EmailAddress as EmailAddress; + +/** + * This class tests email address encoding + * + * @package SendGrid\Tests + */ +class MailTest_Mail extends \PHPUnit\Framework\TestCase +{ + /** + * This method tests various types of unencoded emails + * + * @expectedException \SendGrid\Mail\TypeException + */ + public function testEmailName() + { + $email = new EmailAddress('test@example.com', 'John Doe'); + $json = json_encode($email->jsonSerialize()); + $this->assertEquals($json, '{"name":"John Doe","email":"test@example.com"}'); + + $email->setName(''); + $json = json_encode($email->jsonSerialize()); + $this->assertEquals($json, '{"email":"test@example.com"}'); + + $email->setName(null); + $json = json_encode($email->jsonSerialize()); + $this->assertEquals($json, '{"email":"test@example.com"}'); + + $email->setName('Doe, John'); + $json = json_encode($email->jsonSerialize()); + $this->assertEquals( + $json, + '{"name":"\\"Doe, John\\"","email":"test@example.com"}' + ); + + $email->setName('Doe; John'); + $json = json_encode($email->jsonSerialize()); + $this->assertEquals( + $json, + '{"name":"\\"Doe; John\\"","email":"test@example.com"}' + ); + + $email->setName('John "Billy" O\'Keeffe'); + $json = json_encode($email->jsonSerialize()); + $this->assertEquals( + $json, + '{"name":"John \\"Billy\\" O\'Keeffe","email":"test@example.com"}' + ); + + $email->setName('O\'Keeffe, John "Billy"'); + $json = json_encode($email->jsonSerialize()); + $this->assertEquals( + $json, + '{"name":"\\"O\'Keeffe, John \\\\\\"Billy\\\\\\"\\"","email":"test@example.com"}' + ); + } + + /** + * This method tests TypeException for wrong email address + * + * @expectedException \SendGrid\Mail\TypeException + */ + public function testEmailAddress() + { + $email = new EmailAddress(); + $email->setEmailAddress('test@example.com@wrong'); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MultipleEmailToMultipleRecipientsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MultipleEmailToMultipleRecipientsTest.php new file mode 100644 index 0000000..e168fd5 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/MultipleEmailToMultipleRecipientsTest.php @@ -0,0 +1,517 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Tests; + +/** + * This class tests the request object generation for a /mail/send API call + * + * @package SendGrid\Tests + */ +class MultipleEmailToMulipleRecipientsTest extends BaseTestClass +{ + + private $REQUEST_OBJECT = <<<'JSON' +{ + "content": [ + { + "type": "text/plain", + "value": "Hello -name-, your github is -github- sent at -time-" + }, + { + "type": "text/html", + "value": "Hello -name-, your github is here sent at -time-" + } + ], + "from": { + "email": "test@example.com", + "name": "Example User" + }, + "personalizations": [ + { + "subject": "Subject 1 -name-", + "substitutions": { + "-github-": "http://github.com/example_user1", + "-name-": "Example User 1", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test1@example.com", + "name": "Example User1" + } + ] + }, + { + "subject": "Subject 2 -name-", + "substitutions": { + "-github-": "http://github.com/example_user2", + "-name-": "Example User 2", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test2@example.com", + "name": "Example User2" + } + ] + }, + { + "substitutions": { + "-github-": "http://github.com/example_user3", + "-name-": "Example User 3", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test3@example.com", + "name": "Example User3" + } + ] + } + ], + "subject": "Hi -name-!" +} +JSON; + + private $REQUEST_OBJECT_2 = <<<'JSON' +{ + "content": [ + { + "type": "text/plain", + "value": "Hello -name-, your github is -github- sent at -time-" + }, + { + "type": "text/html", + "value": "Hello -name-, your github is here sent at -time-" + } + ], + "from": { + "email": "test@example.com", + "name": "Example User" + }, + "personalizations": [ + { + "subject": "Subject 1 -name-", + "substitutions": { + "-github-": "http://github.com/example_user1", + "-name-": "Example User 1", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test1@example.com", + "name": "Example User1" + } + ] + }, + { + "subject": "Subject 2 -name-", + "substitutions": { + "-github-": "http://github.com/example_user2", + "-name-": "Example User 2", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test2@example.com", + "name": "Example User2" + } + ] + }, + { + "substitutions": { + "-github-": "http://github.com/example_user3", + "-name-": "Example User 3", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test3@example.com", + "name": "Example User3" + } + ] + } + ] +} +JSON; + + private $REQUEST_OBJECT_3 = <<<'JSON' +{ + "content": [ + { + "type": "text/plain", + "value": "Hello -name-, your github is -github- sent at -time-" + }, + { + "type": "text/html", + "value": "Hello -name-, your github is here sent at -time-" + } + ], + "from": { + "email": "test@example.com", + "name": "Example User" + }, + "personalizations": [ + { + "subject": "Subject 1 -name-", + "dynamic_template_data": { + "-github-": "http://github.com/example_user1", + "-name-": "Example User 1", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test1@example.com", + "name": "Example User1" + } + ] + }, + { + "subject": "Subject 2 -name-", + "dynamic_template_data": { + "-github-": "http://github.com/example_user2", + "-name-": "Example User 2", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test2@example.com", + "name": "Example User2" + } + ] + }, + { + "dynamic_template_data": { + "-github-": "http://github.com/example_user3", + "-name-": "Example User 3", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test3@example.com", + "name": "Example User3" + } + ] + } + ], + "template_id": "d-13b8f94f-bcae-4ec6-b752-70d6cb59f932", + "subject": "Hi -name-!" +} +JSON; + + private $REQUEST_OBJECT_4 = <<<'JSON' +{ + "content": [ + { + "type": "text/plain", + "value": "Hello -name-, your github is -github- sent at -time-" + }, + { + "type": "text/html", + "value": "Hello -name-, your github is here sent at -time-" + } + ], + "from": { + "email": "test@example.com", + "name": "Example User" + }, + "personalizations": [ + { + "subject": "Subject 1 -name-", + "dynamic_template_data": { + "-github-": "http://github.com/example_user1", + "-name-": "Example User 1", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test1@example.com", + "name": "Example User1" + } + ] + }, + { + "subject": "Subject 2 -name-", + "dynamic_template_data": { + "-github-": "http://github.com/example_user2", + "-name-": "Example User 2", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test2@example.com", + "name": "Example User2" + } + ] + }, + { + "dynamic_template_data": { + "-github-": "http://github.com/example_user3", + "-name-": "Example User 3", + "-time-": "2018-05-03 23:10:29" + }, + "to": [ + { + "email": "test+test3@example.com", + "name": "Example User3" + } + ] + } + ], + "template_id": "d-13b8f94f-bcae-4ec6-b752-70d6cb59f932" +} +JSON; + + /** + * Test when we have individual subjects for each Personalization object + */ + public function testWithIndividualSubjects() + { + $from = new \SendGrid\Mail\From("test@example.com", "Example User"); + $tos = [ + new \SendGrid\Mail\To( + "test+test1@example.com", + "Example User1", + [ + '-name-' => 'Example User 1', + '-github-' => 'http://github.com/example_user1' + ], + "Subject 1 -name-" + ), + new \SendGrid\Mail\To( + "test+test2@example.com", + "Example User2", + [ + '-name-' => 'Example User 2', + '-github-' => 'http://github.com/example_user2' + ], + "Subject 2 -name-" + ), + new \SendGrid\Mail\To( + "test+test3@example.com", + "Example User3", + [ + '-name-' => 'Example User 3', + '-github-' => 'http://github.com/example_user3' + ] + ) + ]; + $subject = new \SendGrid\Mail\Subject("Hi -name-!"); // default subject + $globalSubstitutions = [ + '-time-' => "2018-05-03 23:10:29" + ]; + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "Hello -name-, your github is -github- sent at -time-" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "Hello -name-, your github is here sent at -time-" + ); + $email = new \SendGrid\Mail\Mail( + $from, + $tos, + $subject, // or array of subjects, these take precendence + $plainTextContent, + $htmlContent, + $globalSubstitutions + ); + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } + + /** + * Test when we have individual subjects using dynamic templates for each Personalization object + */ + public function testWithIndividualSubjectsDynamicTemplates() + { + $from = new \SendGrid\Mail\From("test@example.com", "Example User"); + $tos = [ + new \SendGrid\Mail\To( + "test+test1@example.com", + "Example User1", + [ + '-name-' => 'Example User 1', + '-github-' => 'http://github.com/example_user1' + ], + "Subject 1 -name-" + ), + new \SendGrid\Mail\To( + "test+test2@example.com", + "Example User2", + [ + '-name-' => 'Example User 2', + '-github-' => 'http://github.com/example_user2' + ], + "Subject 2 -name-" + ), + new \SendGrid\Mail\To( + "test+test3@example.com", + "Example User3", + [ + '-name-' => 'Example User 3', + '-github-' => 'http://github.com/example_user3' + ] + ) + ]; + $subject = new \SendGrid\Mail\Subject("Hi -name-!"); // default subject + $globalSubstitutions = [ + '-time-' => "2018-05-03 23:10:29" + ]; + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "Hello -name-, your github is -github- sent at -time-" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "Hello -name-, your github is here sent at -time-" + ); + $email = new \SendGrid\Mail\Mail( + $from, + $tos, + $subject, // or array of subjects, these take precendence + $plainTextContent, + $htmlContent, + $globalSubstitutions + ); + $email->setTemplateId("d-13b8f94f-bcae-4ec6-b752-70d6cb59f932"); + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT_3); + $this->assertTrue($isEqual); + } + + /** + * Test when we pass in an array of subjects + * + * @expectedException \SendGrid\Mail\TypeException + */ + public function testWithCollectionOfSubjects() + { + $from = new \SendGrid\Mail\From("test@example.com", "Example User"); + $tos = [ + new \SendGrid\Mail\To( + "test+test1@example.com", + "Example User1", + [ + '-name-' => 'Example User 1', + '-github-' => 'http://github.com/example_user1' + ], + "Example User1 -name-" + ), + new \SendGrid\Mail\To( + "test+test2@example.com", + "Example User2", + [ + '-name-' => 'Example User 2', + '-github-' => 'http://github.com/example_user2' + ], + "Example User2 -name-" + ), + new \SendGrid\Mail\To( + "test+test3@example.com", + "Example User3", + [ + '-name-' => 'Example User 3', + '-github-' => 'http://github.com/example_user3' + ] + ) + ]; + $subject = [ + "Subject 1 -name-", + "Subject 2 -name-" + ]; + $globalSubstitutions = [ + '-time-' => "2018-05-03 23:10:29" + ]; + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "Hello -name-, your github is -github- sent at -time-" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "Hello -name-, your github is here sent at -time-" + ); + $email = new \SendGrid\Mail\Mail( + $from, + $tos, + $subject, // or array of subjects, these take precendence + $plainTextContent, + $htmlContent, + $globalSubstitutions + ); + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT_2); + $this->assertTrue($isEqual); + } + + /** + * Test when we pass in an array of subjects + * + * @expectedException \SendGrid\Mail\TypeException + */ + public function testWithCollectionOfSubjectsDynamic() + { + $from = new \SendGrid\Mail\From("test@example.com", "Example User"); + $tos = [ + new \SendGrid\Mail\To( + "test+test1@example.com", + "Example User1", + [ + '-name-' => 'Example User 1', + '-github-' => 'http://github.com/example_user1' + ], + "Example User1 -name-" + ), + new \SendGrid\Mail\To( + "test+test2@example.com", + "Example User2", + [ + '-name-' => 'Example User 2', + '-github-' => 'http://github.com/example_user2' + ], + "Example User2 -name-" + ), + new \SendGrid\Mail\To( + "test+test3@example.com", + "Example User3", + [ + '-name-' => 'Example User 3', + '-github-' => 'http://github.com/example_user3' + ] + ) + ]; + $subject = [ + "Subject 1 -name-", + "Subject 2 -name-" + ]; + $globalSubstitutions = [ + '-time-' => "2018-05-03 23:10:29" + ]; + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "Hello -name-, your github is -github- sent at -time-" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "Hello -name-, your github is here sent at -time-" + ); + $email = new \SendGrid\Mail\Mail( + $from, + $tos, + $subject, // or array of subjects, these take precendence + $plainTextContent, + $htmlContent, + $globalSubstitutions + ); + $email->setTemplateId("d-13b8f94f-bcae-4ec6-b752-70d6cb59f932"); + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT_2); + $this->assertTrue($isEqual); + } + +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SendGridTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SendGridTest.php new file mode 100644 index 0000000..274e7aa --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SendGridTest.php @@ -0,0 +1,88 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Tests; + +/** + * This class tests the Twilio SendGrid Client + * + * @package SendGrid\Tests + */ +class SendGridTest extends BaseTestClass +{ + /** + * Test if the version is correct + */ + public function testVersionIsCorrect() + { + $this->assertEquals(\SendGrid::VERSION, '7.3.0'); + $version = json_decode( + file_get_contents(__DIR__ . '/../../composer.json') + )->version; + $this->assertEquals( + $version, + \SendGrid::VERSION + ); + } + + /** + * Test that we can connect to the Twilio SendGrid API + */ + public function testCanConnectToSendGridApi() + { + $sg = new \SendGrid(self::$apiKey); + $headers = [ + 'Authorization: Bearer ' . self::$apiKey, + 'User-Agent: sendgrid/' . $sg->version . ';php', + 'Accept: application/json' + ]; + + $this->assertEquals( + $sg->client->getHost(), + 'https://api.sendgrid.com', + '/v3' + ); + $this->assertEquals( + $sg->client->getHeaders(), + $headers + ); + $this->assertEquals($sg->client->getVersion(), '/v3'); + + $sg2 = new \SendGrid(self::$apiKey, ['host' => 'https://api.test.com']); + $this->assertEquals($sg2->client->getHost(), 'https://api.test.com'); + + $sg3 = new \SendGrid(self::$apiKey, ['curl' => ['foo' => 'bar']]); + $this->assertEquals(['foo' => 'bar'], $sg3->client->getCurlOptions()); + + $sg4 = new \SendGrid( + self::$apiKey, + ['curl' => [CURLOPT_PROXY => '127.0.0.1:8000']] + ); + $this->assertEquals( + $sg4->client->getCurlOptions(), + [10004 => '127.0.0.1:8000'] + ); + + $subuser = 'abcxyz@this.is.a.test.subuser'; + $headers[] = 'On-Behalf-Of: ' . $subuser; + $sg5 = new \SendGrid( + self::$apiKey, + ['impersonateSubuser' => $subuser] + ); + $this->assertSame( + $headers, + $sg5->client->getHeaders() + ); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SingleEmailToASingleRecipientTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SingleEmailToASingleRecipientTest.php new file mode 100644 index 0000000..ad9053d --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SingleEmailToASingleRecipientTest.php @@ -0,0 +1,98 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Tests; + +/** + * This class tests the request object generation for a /mail/send API call + * + * @package SendGrid\Tests + */ +class SingleEmailToASingleRecipientTest extends BaseTestClass +{ + + private $REQUEST_OBJECT = <<<'JSON' +{ + "personalizations": [ + { + "to": [ + { + "email": "test@example.com", + "name": "Example User" + } + ] + } + ], + "subject": "Sending with Twilio SendGrid is Fun", + "from": { + "email": "test@example.com", + "name": "Example User" + }, + "content": [ + { + "type": "text/plain", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/html", + "value": "and easy to do anywhere, even with PHP" + } + ] +} +JSON; + + /** + * Test all parameters using objects + */ + public function testWithObjects() + { + $from = new \SendGrid\Mail\From("test@example.com", "Example User"); + $subject = new \SendGrid\Mail\Subject("Sending with Twilio SendGrid is Fun"); + $to = new \SendGrid\Mail\To("test@example.com", "Example User"); + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "and easy to do anywhere, even with PHP" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "and easy to do anywhere, even with PHP" + ); + $email = new \SendGrid\Mail\Mail( + $from, + $to, + $subject, + $plainTextContent, + $htmlContent + ); + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } + + /** + * Test all parameters without using objects + */ + public function testWithoutObjects() + { + $email = new \SendGrid\Mail\Mail(); + $email->setFrom("test@example.com", "Example User"); + $email->setSubject("Sending with Twilio SendGrid is Fun"); + $email->addTo("test@example.com", "Example User"); + $email->addContent("text/plain", "and easy to do anywhere, even with PHP"); + $email->addContent( + "text/html", "and easy to do anywhere, even with PHP" + ); + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } +} diff --git a/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SingleEmailToMultipleRecipientsTest.php b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SingleEmailToMultipleRecipientsTest.php new file mode 100644 index 0000000..40b1b83 --- /dev/null +++ b/Postman/Postman-Mail/sendgrid/vendor/sendgrid/sendgrid/test/unit/SingleEmailToMultipleRecipientsTest.php @@ -0,0 +1,117 @@ + + * @copyright 2018-19 Twilio SendGrid + * @license https://opensource.org/licenses/MIT The MIT License + * @version GIT: + * @link http://packagist.org/packages/sendgrid/sendgrid + */ + +namespace SendGrid\Tests; + + +/** + * This class tests the request object generation for a /mail/send API call + * + * @package SendGrid\Tests + */ +class SingleEmailToMulipleRecipientsTest extends BaseTestClass +{ + + private $REQUEST_OBJECT = <<<'JSON' +{ + "personalizations": [ + { + "to": [ + { + "email": "test+test1@example.com", + "name": "Example User1" + }, + { + "email": "test+test2@example.com", + "name": "Example User2" + }, + { + "email": "test+test3@example.com", + "name": "Example User3" + } + ] + } + ], + "subject": "Sending with Twilio SendGrid is Fun", + "content": [ + { + "type": "text/plain", + "value": "and easy to do anywhere, even with PHP" + }, + { + "type": "text/html", + "value": "and easy to do anywhere, even with PHP" + } + ], + "from": { + "email": "test@example.com", + "name": "Example User" + } +} +JSON; + + + /** + * Test when we are using objects + */ + public function testWithObjects() + { + $from = new \SendGrid\Mail\From("test@example.com", "Example User"); + $tos = [ + new \SendGrid\Mail\To("test+test1@example.com", "Example User1"), + new \SendGrid\Mail\To("test+test2@example.com", "Example User2"), + new \SendGrid\Mail\To("test+test3@example.com", "Example User3") + ]; + $subject = new \SendGrid\Mail\Subject("Sending with Twilio SendGrid is Fun"); + $plainTextContent = new \SendGrid\Mail\PlainTextContent( + "and easy to do anywhere, even with PHP" + ); + $htmlContent = new \SendGrid\Mail\HtmlContent( + "and easy to do anywhere, even with PHP" + ); + $email = new \SendGrid\Mail\Mail( + $from, + $tos, + $subject, + $plainTextContent, + $htmlContent + ); + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } + + /** + * Test when we are not using objects + */ + public function testWithoutObjects() + { + $email = new \SendGrid\Mail\Mail(); + $email->setFrom("test@example.com", "Example User"); + $tos = [ + "test+test1@example.com" => "Example User1", + "test+test2@example.com" => "Example User2", + "test+test3@example.com" => "Example User3" + ]; + $email->addTos($tos); + $email->setSubject("Sending with Twilio SendGrid is Fun"); + $email->addContent("text/plain", "and easy to do anywhere, even with PHP"); + $email->addContent( + "text/html", "and easy to do anywhere, even with PHP" + ); + $json = json_encode($email->jsonSerialize()); + $isEqual = BaseTestClass::compareJSONObjects($json, $this->REQUEST_OBJECT); + $this->assertTrue($isEqual); + } +} diff --git a/Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php b/Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php new file mode 100644 index 0000000..1a207c8 --- /dev/null +++ b/Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php @@ -0,0 +1,358 @@ +logger = new PostmanLogger( get_class( $this ) ); + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->options = PostmanOptions::getInstance(); + + PostmanUtils::registerAdminMenu( $this, 'addEmailTestSubmenu' ); + + // hook on the init event + add_action( 'init', array( + $this, + 'on_init', + ) ); + + // initialize the scripts, stylesheets and form fields + add_action( 'admin_init', array( + $this, + 'on_admin_init', + ) ); + } + + /** + * Functions to execute on the init event + * + * "Typically used by plugins to initialize. The current user is already authenticated by this time." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_a_Typical_Request + */ + public function on_init() { + // register Ajax handlers + new PostmanSendTestEmailAjaxController(); + } + + /** + * Fires on the admin_init method + */ + public function on_admin_init() { + $this->registerStylesAndScripts(); + } + + /** + * Get the settings option array and print one of its values + */ + public function test_email_callback() { + printf( '', self::RECIPIENT_EMAIL_FIELD_NAME, wp_get_current_user()->user_email ); + } + + /** + * Register and add settings + */ + private function registerStylesAndScripts() { + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'registerStylesAndScripts()' ); + } + + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + + // register the stylesheet resource + wp_register_style( 'postman_send_test_email', plugins_url( 'Postman/Postman-Send-Test-Email/postman_send_test_email.css', $this->rootPluginFilenameAndPath ), PostmanViewController::POSTMAN_STYLE, $pluginData ['version'] ); + + // register the javascript resource + wp_register_script( 'postman_test_email_wizard_script', plugins_url( 'Postman/Postman-Send-Test-Email/postman_send_test_email.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + 'jquery_steps_script', + PostmanViewController::POSTMAN_SCRIPT, + ), $pluginData ['version'] ); + } + + /** + * Register the Email Test screen + */ + public function addEmailTestSubmenu() { + $page = add_submenu_page( null, sprintf( __( '%s Setup', 'post-smtp' ), __( 'Postman SMTP', 'post-smtp' ) ), __( 'Postman SMTP', 'post-smtp' ), Postman::MANAGE_POSTMAN_CAPABILITY_NAME, PostmanSendTestEmailController::EMAIL_TEST_SLUG, array( + $this, + 'outputTestEmailContent', + ) ); + // When the plugin options page is loaded, also load the stylesheet + add_action( 'admin_print_styles-' . $page, array( + $this, + 'enqueueEmailTestResources', + ) ); + } + + /** + */ + function enqueueEmailTestResources() { + wp_enqueue_style( 'jquery_steps_style' ); + wp_enqueue_style( PostmanViewController::POSTMAN_STYLE ); + wp_enqueue_style( 'postman_send_test_email' ); + wp_enqueue_script( 'postman_test_email_wizard_script' ); + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_email_test', array( + 'recipient' => '#' . self::RECIPIENT_EMAIL_FIELD_NAME, + 'not_started' => _x( 'In Outbox', 'Email Test Status', 'post-smtp' ), + 'sending' => _x( 'Sending...', 'Email Test Status', 'post-smtp' ), + 'success' => _x( 'Success', 'Email Test Status', 'post-smtp' ), + 'failed' => _x( 'Failed', 'Email Test Status', 'post-smtp' ), + 'ajax_error' => __( 'Ajax Error', 'post-smtp' ), + ) ); + } + + /** + */ + public function outputTestEmailContent() { + print '
    '; + + PostmanViewController::outputChildPageHeader( __( 'Send a Test Email', 'post-smtp' ) ); + + printf( '
    ', PostmanUtils::getSettingsPageUrl() ); + + wp_nonce_field('post-smtp', 'security' ); + + // Step 1 + printf( '
    %s
    ', __( 'Specify the Recipient', 'post-smtp' ) ); + print '
    '; + printf( '%s', __( 'Who is this message going to?', 'post-smtp' ) ); + printf( '

    %s', __( 'This utility allows you to send an email message for testing.', 'post-smtp' ) ); + print ' '; + /* translators: where %d is an amount of time, in seconds */ + printf( '%s

    ', sprintf( _n( 'If there is a problem, Postman will give up after %d second.', 'If there is a problem, Postman will give up after %d seconds.', $this->options->getReadTimeout(), 'post-smtp' ), $this->options->getReadTimeout() ) ); + printf( '', _x( 'Recipient Email Address', 'Configuration Input Field', 'post-smtp' ) ); + print $this->test_email_callback(); + print '
    '; + + // Step 2 + printf( '
    %s
    ', __( 'Send The Message', 'post-smtp' ) ); + print '
    '; + print ''; + print __( 'Sending the message:', 'post-smtp' ); + printf( ' %s', _x( 'In Outbox', 'Email Test Status', 'post-smtp' ) ); + print ''; + print '
    '; + printf( '

    ', __( 'Status', 'post-smtp' ) ); + print ''; + print '
    '; + print '
    '; + + // Step 3 + printf( '
    %s
    ', __( 'Session Transcript', 'post-smtp' ) ); + print '
    '; + printf( '%s', __( 'Examine the Session Transcript if you need to.', 'post-smtp' ) ); + printf( '

    %s

    ', __( 'This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password.', 'post-smtp' ) ); + print '
    '; + printf( '

    ', __( 'Session Transcript', 'post-smtp' ) ); + print ''; + print '
    '; + print '
    '; + + print '
    '; + print '
    '; + } +} + +/** + * + * @author jasonhendriks + */ +class PostmanSendTestEmailAjaxController extends PostmanAbstractAjaxHandler { + + /** + * Constructor + * + * @param PostmanOptions $options + * @param PostmanOAuthToken $authorizationToken + * @param PostmanConfigTextHelper $oauthScribe + */ + function __construct() { + parent::__construct(); + PostmanUtils::registerAjaxHandler( 'postman_send_test_email', $this, 'sendTestEmailViaAjax' ); + } + + /** + * Yes, this procedure is just for testing. + * + * @return boolean + */ + function test_mode() { + return true; + } + + /** + * This Ajax sends a test email + */ + function sendTestEmailViaAjax() { + + check_admin_referer('post-smtp', 'security'); + + // get the email address of the recipient from the HTTP Request + $email = $this->getRequestParameter( 'email' ); + + // get the name of the server from the HTTP Request + $serverName = PostmanUtils::postmanGetServerName(); + + /* translators: where %s is the domain name of the site */ + $subject = sprintf( _x( 'Postman SMTP Test (%s)', 'Test Email Subject', 'post-smtp' ), $serverName ); + + // Postman API: indicate to Postman this is just for testing + add_filter( 'postman_test_email', array( + $this, + 'test_mode', + ) ); + + // this header specifies that there are many parts (one text part, one html part) + $header = 'Content-Type: multipart/alternative;'; + + // createt the message content + $message = $this->createMessageContent(); + + // send the message + $success = wp_mail( $email, $subject, $message, $header ); + + // Postman API: remove the testing indicator + remove_filter( 'postman_test_email', array( + $this, + 'test_mode', + ) ); + + // Postman API: retrieve the result of sending this message from Postman + $result = apply_filters( 'postman_wp_mail_result', null ); + + // post-handling + if ( $success ) { + $this->logger->debug( 'Test Email delivered to server' ); + // the message was sent successfully, generate an appropriate message for the user + $statusMessage = sprintf( __( 'Your message was delivered (%d ms) to the SMTP server! Congratulations :)', 'post-smtp' ), $result ['time'] ); + + $this->logger->debug( 'statusmessage: ' . $statusMessage ); + + // compose the JSON response for the caller + $response = array( + 'message' => $statusMessage, + 'transcript' => $result ['transcript'], + ); + + // log the response + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'Ajax Response:' ); + $this->logger->trace( $response ); + } + + // send the JSON response + wp_send_json_success( $response ); + } else { + $this->logger->error( 'Test Email NOT delivered to server - ' . $result ['exception']->getCode() ); + // the message was NOT sent successfully, generate an appropriate message for the user + $statusMessage = $result ['exception']->getMessage(); + + $this->logger->debug( 'statusmessage: ' . $statusMessage ); + + // compose the JSON response for the caller + $response = array( + 'message' => $statusMessage, + 'transcript' => $result ['transcript'], + ); + + // log the response + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'Ajax Response:' ); + $this->logger->trace( $response ); + } + + // send the JSON response + wp_send_json_error( $response ); + } + } + + /** + * Create the multipart message content + * + * @return string + */ + private function createMessageContent() { + // Postman API: Get the plugin metadata + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + + /* + translators: where %s is the Postman plugin version number (e.g. 1.4) */ + // English - Mandarin - French - Hindi - Spanish - Portuguese - Russian - Japanese + // http://www.pinyin.info/tools/converter/chars2uninumbers.html + $greeting = 'Hello! - 你好 - Bonjour! - नमस्ते - ¡Hola! - Olá - Привет! - 今日は'; + $sentBy = sprintf( _x( 'Sent by Postman %s', 'Test Email Tagline', 'post-smtp' ), $pluginData ['version'] ); + $imageSource = __( 'Image source', 'post-smtp' ); + $withPermission = __( 'Used with permission', 'post-smtp' ); + $messageArray = array( + 'Content-Type: text/plain; charset = "UTF-8"', + 'Content-Transfer-Encoding: 8bit', + '', + 'Hello!', + '', + sprintf( '%s - https://wordpress.org/plugins/post-smtp/', $sentBy ), + '', + 'Content-Type: text/html; charset=UTF-8', + 'Content-Transfer-Encoding: quoted-printable', + '', + '', + '', + '', + '', + '', + '', + '', + '
    ', + ' ', + ' ', + ' ', + ' ', + ' ', + ' ', + '
    ', + ' ', + ' ', + ' ', + ' ', + ' ', + ' ', + '
    ', + '
    ', + sprintf( '
    %s
    ', $greeting ), + sprintf( '
    %s', $sentBy ), + '
    https://wordpress.org/plugins/post-smtp/', + '
    ', + '
    ', + '
    ', + sprintf( '
    %s: poofytoo.com - %s', $imageSource, $withPermission ), + '
    ', + '', + '', + ); + return implode( PostmanMessage::EOL, $messageArray ); + } +} diff --git a/Postman/Postman-Send-Test-Email/postman_send_test_email.css b/Postman/Postman-Send-Test-Email/postman_send_test_email.css new file mode 100644 index 0000000..40d612c --- /dev/null +++ b/Postman/Postman-Send-Test-Email/postman_send_test_email.css @@ -0,0 +1,3 @@ +.wizard>.content { + min-height: 26em; +} diff --git a/Postman/Postman-Send-Test-Email/postman_send_test_email.js b/Postman/Postman-Send-Test-Email/postman_send_test_email.js new file mode 100644 index 0000000..ab69d1f --- /dev/null +++ b/Postman/Postman-Send-Test-Email/postman_send_test_email.js @@ -0,0 +1,169 @@ +transcript = false; +jQuery(document).ready( + function() { + ready = 0; + jQuery(postman_email_test.recipient).focus(); + jQuery("#postman_test_email_wizard") + .steps( + { + forceMoveForward : true, + showFinishButtonAlways : true, + bodyTag : "fieldset", + headerTag : "h5", + transitionEffect : "slideLeft", + stepsOrientation : "vertical", + autoFocus : true, + labels : { + current : steps_current_step, + pagination : steps_pagination, + finish : steps_finish, + next : steps_next, + previous : steps_previous, + loading : steps_loading + }, + onStepChanging : function(event, currentIndex, + newIndex) { + return handleStepChange(event, + currentIndex, newIndex, + jQuery(this)); + + }, + onInit : function() { + jQuery(postman_email_test.recipient) + .focus(); + jQuery('li + li').addClass('disabled'); + }, + onStepChanged : function(event, currentIndex, + priorIndex) { + return postHandleStepChange(event, + currentIndex, priorIndex, + jQuery(this)); + }, + onFinishing : function(event, currentIndex) { + return true; + }, + onFinished : function(event, currentIndex) { + if (ready == 0) { + return false; + } else { + var form = jQuery(this); + form.submit(); + } + } + }).validate({ + errorPlacement : function(error, element) { + element.before(error); + } + }); + }); +function handleStepChange(event, currentIndex, newIndex, form) { + // Always allow going backward even if + // the current step contains invalid fields! + if (currentIndex > newIndex) { + return false; + } + + // Clean up if user went backward + // before + if (currentIndex < newIndex) { + // To remove error styles + jQuery(".body:eq(" + newIndex + ") label.error", form).remove(); + jQuery(".body:eq(" + newIndex + ") .error", form).removeClass("error"); + } + + // Disable validation on fields that + // are disabled or hidden. + form.validate().settings.ignore = ":disabled,:hidden"; + + // Start validation; Prevent going + // forward if false + valid = form.valid(); + if (!valid) { + return false; + } + + if (currentIndex === 0) { + ready = 0; + // this disables the finish button during the screen slide + jQuery('li').addClass('disabled'); + jQuery('#postman_test_message_status').html( + postman_email_test.not_started); + jQuery('#postman_test_message_status').css('color', ''); + jQuery('#postman_test_message_error_message').val(''); + jQuery('#postman_test_message_transcript').val(''); + hide(jQuery('#test-success')); + hide(jQuery('#test-fail')); + } else if (currentIndex === 1) { + return transcript; + } + + return true; +} +function postHandleStepChange(event, currentIndex, priorIndex, myself) { + if (currentIndex === 0) { + } else if (currentIndex === 1) { + // this is the second place I disable the finish button but Steps + // re-enables it after the screen slides + jQuery('li').addClass('disabled'); + var data = { + 'action' : 'postman_send_test_email', + 'email' : jQuery(postman_email_test.recipient).val(), + 'security' : jQuery('#security').val() + }; + jQuery('#postman_test_message_status').html(postman_email_test.sending); + jQuery('#postman_test_message_status').css('color', 'blue'); + // http://stackoverflow.com/questions/21987318/catch-handle-502-bad-gateway-error + jQuery + .ajax( + { + statusCode : { + 502 : function() { + alert('The server returned "HTTP Error 502 Bad gateway". Contact your hosting provider to resolve the error.'); + } + }, + method : "POST", + url : ajaxurl, + data : data + }).done(function(response) { + handleResponse(response); + }).fail( + function(response) { + // handle ajax failure + jQuery('#postman_test_message_status').html( + postman_email_test.ajax_error); + jQuery('#postman_test_message_status').css('color', + 'red'); + jQuery('#postman_test_message_error_message').val( + postman_ajax_msg.bad_response + ":\n\n" + + response.responseText); + jQuery('li + li').removeClass('disabled'); + }); + + } + function handleResponse(response) { + if (postmanValidateAjaxResponse(response)) { + if (response.data.transcript + && response.data.transcript.length != 0) { + // only enable the next button if there is a transcript + transcript = true; + jQuery('li').removeClass('disabled'); + } else { + jQuery('li + li').removeClass('disabled'); + } + if (response.success) { + jQuery('#postman_test_message_status').html( + postman_email_test.success); + jQuery('#postman_test_message_status').css('color', 'green'); + } else { + jQuery('#postman_test_message_status').html( + postman_email_test.failed); + jQuery('#postman_test_message_status').css('color', 'red'); + } + jQuery('#postman_test_message_error_message').val( + response.data.message); + jQuery('#postman_test_message_transcript').val( + response.data.transcript); + } + ready = 1; + } +} diff --git a/Postman/Postman.php b/Postman/Postman.php new file mode 100644 index 0000000..51b2ab1 --- /dev/null +++ b/Postman/Postman.php @@ -0,0 +1,498 @@ +rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + self::$rootPlugin = $rootPluginFilenameAndPath; + + // load the dependencies + require_once 'PostmanOptions.php'; + require_once 'PostmanState.php'; + require_once 'PostmanLogger.php'; + require_once 'PostmanUtils.php'; + require_once 'Postman-Mail/PostmanTransportRegistry.php'; + require_once 'Postman-Mail/PostmanDefaultModuleTransport.php'; + require_once 'Postman-Mail/PostmanSmtpModuleTransport.php'; + require_once 'Postman-Mail/PostmanGmailApiModuleTransport.php'; + require_once 'Postman-Mail/PostmanMandrillTransport.php'; + require_once 'Postman-Mail/PostmanSendGridTransport.php'; + require_once 'Postman-Mail/PostmanMailgunTransport.php'; + require_once 'PostmanOAuthToken.php'; + require_once 'PostmanWpMailBinder.php'; + require_once 'PostmanConfigTextHelper.php'; + require_once 'Postman-Email-Log/PostmanEmailLogPostType.php'; + require_once 'Postman-Mail/PostmanMyMailConnector.php'; + require_once 'Postman-Mail/PostmanContactForm7.php'; + require_once 'Phpmailer/PostsmtpMailer.php'; + //require_once 'Postman-Mail/PostmanWooCommerce.php'; + + // get plugin metadata - alternative to get_plugin_data + $this->pluginData = array( + 'name' => __( 'Postman SMTP', 'post-smtp' ), + 'version' => $version, + ); + + // register the plugin metadata filter (part of the Postman API) + add_filter( 'postman_get_plugin_metadata', array( + $this, + 'getPluginMetaData', + ) ); + + // create an instance of the logger + $this->logger = new PostmanLogger( get_class( $this ) ); + if ( $this->logger->isDebug() ) { + $this->logger->debug( sprintf( '%1$s v%2$s starting', $this->pluginData ['name'], $this->pluginData ['version'] ) ); + } + + if ( isset( $_REQUEST ['page'] ) && $this->logger->isTrace() ) { + $this->logger->trace( 'Current page: ' . sanitize_text_field($_REQUEST ['page']) ); + } + + // register the email transports + $this->registerTransports( $rootPluginFilenameAndPath ); + + // store an instance of the WpMailBinder + $this->wpMailBinder = PostmanWpMailBinder::getInstance(); + + $mailer = PostmanOptions::getInstance()->getSmtpMailer(); + $this->logger->trace( 'SMTP Mailer: ' . $mailer ); + + if ( $mailer && $mailer !== 'phpmailer') { + + // bind to wp_mail - this has to happen before the "init" action + // this design allows other plugins to register a Postman transport and call bind() + // bind may be called more than once + $this->wpMailBinder->bind(); + } else { + PostmanWpMailBinder::getInstance()->bound = true; + } + + // registers the custom post type for all callers + PostmanEmailLogPostType::automaticallyCreatePostType(); + + // run the DatastoreUpgrader any time there is a version mismatch + if ( PostmanState::getInstance()->getVersion() != $this->pluginData ['version'] ) { + // manually trigger the activation hook + if ( $this->logger->isInfo() ) { + $this->logger->info( sprintf( 'Upgrading datastore from version %s to %s', PostmanState::getInstance()->getVersion(), $this->pluginData ['version'] ) ); + } + require_once 'PostmanInstaller.php'; + $upgrader = new PostmanInstaller(); + $upgrader->activatePostman(); + } + + // MyMail integration + new PostmanMyMailConnector( $rootPluginFilenameAndPath ); + + // Contact form 7 + new Postsmtp_ContactForm7; + + // WooCommerce Integration + //new PostmanWoocommerce(); + + // register the shortcode handler on the add_shortcode event + add_shortcode( 'postman-version', array( + $this, + 'version_shortcode', + ) ); + + // hook on the plugins_loaded event + add_action( 'plugins_loaded', array( + $this, + 'on_plugins_loaded', + ) ); + + /** + * @todo: WPML say they fix the issue in version 3.9 + * https://wordpress.org/support/topic/error-in-pluggable-php173/#post-10021301 + */ + if ( get_option( 'icl_sitepress_version' ) && version_compare( get_option( 'icl_sitepress_version' ), '3.9', '<' ) ) { + + $active_plugins = (array)get_option('active_plugins', array()); + if (in_array('sitepress-multilingual-cms/sitepress.php', $active_plugins) && !get_option('postman_wpml_fixed')) { + add_action('admin_notices', array($this, 'post_smtp_wpml_admin_notice')); + } + } + + // hook on the wp_loaded event + add_action( 'wp_loaded', array( + $this, + 'on_wp_loaded', + ) ); + + // hook on the acivation event + register_activation_hook( $rootPluginFilenameAndPath, array( + $this, + 'on_activation', + ) ); + + // hook on the deactivation event + register_deactivation_hook( $rootPluginFilenameAndPath, array( + $this, + 'on_deactivation', + ) ); + + } + + + /** + * Functions to execute on the plugins_loaded event + * + * "After active plugins and pluggable functions are loaded" + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_a_Typical_Request + */ + public function on_plugins_loaded() { + // load the text domain + $this->loadTextDomain(); + + // register the setup_admin function on plugins_loaded because we need to call + // current_user_can to verify the capability of the current user + if ( PostmanUtils::isAdmin() && is_admin() ) { + $this->setup_admin(); + } + } + + /** + * Functions to execute on the wp_loaded event + * + * "After WordPress is fully loaded" + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_a_Typical_Request + */ + public function on_wp_loaded() { + // register the check for configuration errors on the wp_loaded hook, + // because we want it to run after the OAuth Grant Code check on the init hook + $this->check_for_configuration_errors(); + } + + /** + * Functions to execute on the register_activation_hook + * ref: https://codex.wordpress.org/Function_Reference/register_activation_hook + */ + public function on_activation() { + if ( $this->logger->isInfo() ) { + $this->logger->info( 'Activating plugin' ); + } + require_once 'PostmanInstaller.php'; + $upgrader = new PostmanInstaller(); + $upgrader->activatePostman(); + } + + /** + * Functions to execute on the register_deactivation_hook + * ref: https://codex.wordpress.org/Function_Reference/register_deactivation_hook + */ + public function on_deactivation() { + if ( $this->logger->isInfo() ) { + $this->logger->info( 'Deactivating plugin' ); + } + require_once 'PostmanInstaller.php'; + $upgrader = new PostmanInstaller(); + $upgrader->deactivatePostman(); + } + + /** + * If the user is on the WordPress Admin page, creates the Admin screens + */ + public function setup_admin() { + $this->logger->debug( 'Admin start-up sequence' ); + + $options = PostmanOptions::getInstance(); + $authToken = PostmanOAuthToken::getInstance(); + $rootPluginFilenameAndPath = $this->rootPluginFilenameAndPath; + + // load the dependencies + require_once 'PostmanMessageHandler.php'; + require_once 'PostmanAdminController.php'; + require_once 'Postman-Controller/PostmanWelcomeController.php'; + require_once 'Postman-Controller/PostmanDashboardWidgetController.php'; + require_once 'Postman-Controller/PostmanAdminPointer.php'; + require_once 'Postman-Email-Log/PostmanEmailLogController.php'; + require_once 'Postman-Connectivity-Test/PostmanConnectivityTestController.php'; + require_once 'Postman-Configuration/PostmanConfigurationController.php'; + require_once 'Postman-Send-Test-Email/PostmanSendTestEmailController.php'; + require_once 'Postman-Diagnostic-Test/PostmanDiagnosticTestController.php'; + + // create and store an instance of the MessageHandler + $this->messageHandler = new PostmanMessageHandler(); + + // create the Admin Controllers + new PostmanWelcomeController( $rootPluginFilenameAndPath ); + new PostmanDashboardWidgetController( $rootPluginFilenameAndPath, $options, $authToken, $this->wpMailBinder ); + new PostmanAdminController( $rootPluginFilenameAndPath, $options, $authToken, $this->messageHandler, $this->wpMailBinder ); + new PostmanEmailLogController( $rootPluginFilenameAndPath ); + new PostmanConnectivityTestController( $rootPluginFilenameAndPath ); + new PostmanConfigurationController( $rootPluginFilenameAndPath ); + new PostmanSendTestEmailController( $rootPluginFilenameAndPath ); + new PostmanDiagnosticTestController( $rootPluginFilenameAndPath ); + + // register the Postman signature (only if we're on a postman admin screen) on the in_admin_footer event + if ( PostmanUtils::isCurrentPagePostmanAdmin() ) { + add_action( 'in_admin_footer', array( + $this, + 'print_signature', + ) ); + } + } + + /** + * Check for configuration errors and displays messages to the user + */ + public function check_for_configuration_errors() { + $options = PostmanOptions::getInstance(); + $authToken = PostmanOAuthToken::getInstance(); + + // did Postman fail binding to wp_mail()? + if ( $this->wpMailBinder->isUnboundDueToException() ) { + // this message gets printed on ANY WordPress admin page, as it's a fatal error that + // may occur just by activating a new plugin + // log the fatal message + $this->logger->fatal( 'Postman: wp_mail has been declared by another plugin or theme, so you won\'t be able to use Postman until the conflict is resolved.' ); + + if ( PostmanUtils::isAdmin() && is_admin() ) { + // on any admin pages, show this error message + // I noticed the wpMandrill and SendGrid plugins have the exact same error message here + // I've adopted their error message as well, for shits and giggles .... :D + $reflFunc = new ReflectionFunction( 'wp_mail' ); + + $message = __( 'Postman: wp_mail has been declared by another plugin or theme, so you won\'t be able to use Postman until the conflict is resolved.', 'post-smtp' ); + + $plugin_full_path = $reflFunc->getFileName(); + + if ( strpos( $plugin_full_path, 'plugins' ) !== false ) { + + require_once ABSPATH . '/wp-admin/includes/plugin.php'; + + preg_match( '/([a-z]+\/[a-z]+\.php)$/', $plugin_full_path, $output_array ); + + $plugin_file = $output_array[1]; + $plugin_data = get_plugin_data( $plugin_full_path ); + + $deactivate_url = '' . __( 'Deactivate' ) . '
    '; + $message .= '
    Plugin Name: ' . $plugin_data['Name']; + $message .= '
    ' . $deactivate_url; + } + + $message .= '
    More info that may help - ' . $reflFunc->getFileName() . ':' . $reflFunc->getStartLine(); + + // PHPmailer Recommandation + ob_start(); + Postman::getMailerTypeRecommend(); + $message .= ob_get_clean(); + + $this->messageHandler->addError( $message ); + } + } else { + $transport = PostmanTransportRegistry::getInstance()->getCurrentTransport(); + $scribe = $transport->getScribe(); + + $virgin = $options->isNew(); + if ( ! $transport->isConfiguredAndReady() ) { + // if the configuration is broken, and the user has started to configure the plugin + // show this error message + $messages = $transport->getConfigurationMessages(); + foreach ( $messages as $message ) { + if ( $message ) { + // log the warning message + $this->logger->warn( sprintf( '%s Transport has a configuration problem: %s', $transport->getName(), $message ) ); + + if ( PostmanUtils::isAdmin() && PostmanUtils::isCurrentPagePostmanAdmin() ) { + // on pages that are Postman admin pages only, show this error message + $this->messageHandler->addError( $message ); + } + } + } + } + + // on pages that are NOT Postman admin pages only, show this error message + if ( PostmanUtils::isAdmin() && ! PostmanUtils::isCurrentPagePostmanAdmin() && ! $transport->isConfiguredAndReady() ) { + // on pages that are *NOT* Postman admin pages only.... + // if the configuration is broken show this error message + add_action( 'admin_notices', array( + $this, + 'display_configuration_required_warning', + ) ); + } + } + } + + public static function getMailerTypeRecommend() { + ?> +
    +

    Please notice

    +

    + Mailer Type.', 'post-smtp' ); ?>
    + TEST Post SMTP with the value PHPMailer.', 'post-smtp' ); ?>
    + PostSMTP.', 'post-smtp' ); ?>
    + +

    + how to set mailer type +
    +
    + +

    +
    + pluginData; + } + + /** + * This is the general message that Postman requires configuration, to warn users who think + * the plugin is ready-to-go as soon as it is activated. + * This message only goes away once the plugin is configured. + */ + public function display_configuration_required_warning() { + if ( PostmanUtils::isAdmin() ) { + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Displaying configuration required warning' ); + } + $msg = PostmanTransportRegistry::getInstance()->getReadyMessage(); + $message = sprintf( $msg['message'] ); + $goToSettings = sprintf( '%s', PostmanUtils::getSettingsPageUrl(), __( 'Settings', 'post-smtp' ) ); + $goToEmailLog = sprintf( '%s', _x( 'Email Log', 'The log of Emails that have been delivered', 'post-smtp' ) ); + if ( PostmanOptions::getInstance()->isMailLoggingEnabled() ) { + $goToEmailLog = sprintf( '%s', PostmanUtils::getEmailLogPageUrl(), $goToEmailLog ); + } + $message .= (sprintf( ' %s | %s', $goToEmailLog, $goToSettings )); + $message .= ''; + + $hide = get_option('postman_release_version' ); + + if ( $msg['error'] == true && ! $hide ) { + $this->messageHandler->printMessage( $message, 'postman-not-configured-notice notice notice-error is-dismissible' ); + } + } + } + + /** + * Register the email transports. + * + * The Gmail API used to be a separate plugin which was registered when that plugin + * was loaded. But now both the SMTP, Gmail API and other transports are registered here. + * + * @param mixed $pluginData + */ + private function registerTransports( $rootPluginFilenameAndPath ) { + $postman_transport_registry = PostmanTransportRegistry::getInstance(); + + $postman_transport_registry->registerTransport( new PostmanDefaultModuleTransport( $rootPluginFilenameAndPath ) ); + $postman_transport_registry->registerTransport( new PostmanSmtpModuleTransport( $rootPluginFilenameAndPath ) ); + $postman_transport_registry->registerTransport( new PostmanGmailApiModuleTransport( $rootPluginFilenameAndPath ) ); + $postman_transport_registry->registerTransport( new PostmanMandrillTransport( $rootPluginFilenameAndPath ) ); + $postman_transport_registry->registerTransport( new PostmanSendGridTransport( $rootPluginFilenameAndPath ) ); + $postman_transport_registry->registerTransport( new PostmanMailgunTransport( $rootPluginFilenameAndPath ) ); + + do_action( 'postsmtp_register_transport', $postman_transport_registry ); + } + + /** + * Print the Postman signature on the bottom of the page + * + * http://striderweb.com/nerdaphernalia/2008/06/give-your-wordpress-plugin-credit/ + */ + function print_signature() { + printf( '%s %s
    ', $this->pluginData ['name'], $this->pluginData ['version'] ); + } + + /** + * Loads the appropriate language file + */ + private function loadTextDomain() { + // had to hardcode the third parameter, Relative path to WP_PLUGIN_DIR, + // because __FILE__ returns the wrong path if the plugin is installed as a symlink + $shortLocale = substr( get_locale(), 0, 2 ); + if ( $shortLocale != 'en' ) { + $langDir = 'post-smtp/Postman/languages'; + $success = load_plugin_textdomain( 'post-smtp', false, $langDir ); + if ( $this->logger->isDebug() ) { + if ( $success ) { + $this->logger->debug( sprintf( 'local translation file loaded for locale=%s', get_locale() ) ); + } else { + $this->logger->debug( sprintf( 'failed to load local translation file: locale=%s file=%s/%s-%s.mo', get_locale(), $langDir, 'post-smtp', get_locale() ) ); + } + } + } + } + + /** + * Shortcode to return the current plugin version. + * + * From http://code.garyjones.co.uk/get-wordpress-plugin-version/ + * + * @return string Plugin version + */ + function version_shortcode() { + return $this->pluginData ['version']; + } +} + +if ( ! function_exists( 'str_getcsv' ) ) { + /** + * PHP version less than 5.3 don't have str_getcsv natively. + * + * @param mixed $string + * @return multitype: + */ + function str_getcsv( $string ) { + $logger = new PostmanLogger( 'postman-common-functions' ); + if ( $logger->isDebug() ) { + $logger->debug( 'Using custom str_getcsv' ); + } + return PostmanUtils::postman_strgetcsv_impl( $string ); + } +} diff --git a/Postman/PostmanAdminController.php b/Postman/PostmanAdminController.php new file mode 100644 index 0000000..1e43c6d --- /dev/null +++ b/Postman/PostmanAdminController.php @@ -0,0 +1,412 @@ +logger = new PostmanLogger( get_class( $this ) ); + $this->options = $options; + $this->authorizationToken = $authorizationToken; + $this->messageHandler = $messageHandler; + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->wpMailBinder = $binder; + + // check if the user saved data, and if validation was successful + $session = PostmanSession::getInstance(); + if ( $session->isSetAction() ) { + $this->logger->debug( sprintf( 'session action: %s', $session->getAction() ) ); + } + if ( $session->getAction() == PostmanInputSanitizer::VALIDATION_SUCCESS ) { + // unset the action + $session->unsetAction(); + // do a redirect on the init hook + $this->registerInitFunction( 'handleSuccessfulSave' ); + // add a saved message to be shown after the redirect + $this->messageHandler->addMessage( _x( 'Settings saved.', 'The plugin successfully saved new settings.', 'post-smtp' ) ); + return; + } else { + // unset the action in the failed case as well + $session->unsetAction(); + } + + // test to see if an OAuth authentication is in progress + if ( $session->isSetOauthInProgress() ) { + // there is only a three minute window that Postman will expect a Grant Code, once Grant is clicked by the user + $this->logger->debug( 'Looking for grant code' ); + if ( isset( $_GET ['code'] ) ) { + $this->logger->debug( 'Found authorization grant code' ); + + // queue the function that processes the incoming grant code + $this->registerInitFunction( 'handleAuthorizationGrant' ); + return; + } + } + do_action('post_smtp_handle_oauth', $this->messageHandler ); + + // continue to initialize the AdminController + add_action( 'init', array( + $this, + 'on_init', + ) ); + + // continue to initialize the AdminController + add_action( 'wpmu_options', array( + $this, + 'wpmu_options', + ) ); + + add_action( 'update_wpmu_options', array( + $this, + 'update_wpmu_options', + ) ); + + // Adds "Settings" link to the plugin action page + add_filter( 'plugin_action_links_' . plugin_basename( $this->rootPluginFilenameAndPath ), array( + $this, + 'postmanModifyLinksOnPluginsListPage', + ) ); + + require_once( 'PostmanPluginFeedback.php' ); + } + + + function wpmu_options() { + $options = get_site_option( PostmanOptions::POSTMAN_NETWORK_OPTIONS ); + ?> + + +

    + + + + + + + + + + + $value ) { + $options[$key] = sanitize_text_field( $value ); + + if ( $value == 'null' ) { + unset( $options[$key] ); + } + } + + update_site_option( PostmanOptions::POSTMAN_NETWORK_OPTIONS, $options ); + } else { + update_site_option( PostmanOptions::POSTMAN_NETWORK_OPTIONS, array() ); + } + } + + /** + * Functions to execute on the init event + * + * "Typically used by plugins to initialize. The current user is already authenticated by this time." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_a_Typical_Request + */ + public function on_init() { + // only administrators should be able to trigger this + if ( PostmanUtils::isAdmin() ) { + $transport = PostmanTransportRegistry::getInstance()->getCurrentTransport(); + $this->oauthScribe = $transport->getScribe(); + + // register content handlers + $viewController = new PostmanViewController( $this->rootPluginFilenameAndPath, $this->options, $this->authorizationToken, $this->oauthScribe, $this ); + + // register action handlers + $this->registerAdminPostAction( self::PURGE_DATA_SLUG, 'handlePurgeDataAction' ); + $this->registerAdminPostAction( self::IMPORT_SETTINGS_SLUG, 'importSettingsAction' ); + $this->registerAdminPostAction( PostmanUtils::REQUEST_OAUTH2_GRANT_SLUG, 'handleOAuthPermissionRequestAction' ); + + if ( PostmanUtils::isCurrentPagePostmanAdmin() ) { + $this->checkPreRequisites(); + } + } + } + + /** + * + */ + private function checkPreRequisites() { + $states = PostmanPreRequisitesCheck::getState(); + foreach ( $states as $state ) { + if ( ! $state ['ready'] ) { + /* Translators: where %1$s is the name of the library */ + $message = sprintf( __( 'This PHP installation requires the %1$s library.', 'post-smtp' ), $state ['name'] ); + if ( $state ['required'] ) { + $this->messageHandler->addError( $message ); + } else { + // $this->messageHandler->addWarning ( $message ); + } + } + } + } + + /** + * + * @param mixed $actionName + * @param mixed $callbackName + */ + private function registerInitFunction( $callbackName ) { + $this->logger->debug( 'Registering init function ' . $callbackName ); + add_action( 'init', array( + $this, + $callbackName, + ) ); + } + + /** + * Registers actions posted by am HTML FORM with the WordPress 'action' parameter + * + * @param mixed $actionName + * @param mixed $callbankName + */ + private function registerAdminPostAction( $actionName, $callbankName ) { + // $this->logger->debug ( 'Registering ' . $actionName . ' Action Post handler' ); + add_action( 'admin_post_' . $actionName, array( + $this, + $callbankName, + ) ); + } + + /** + * Add "Settings" link to the plugin action page + * + * @param mixed $links + * @return multitype: + */ + public function postmanModifyLinksOnPluginsListPage( $links ) { + // only administrators should be able to trigger this + if ( PostmanUtils::isAdmin() ) { + $mylinks = array( + sprintf( '%s', 'https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=yehuda@myinbox.in&item_name=Donation+for+PostSMTP', __( 'Donate', 'post-smtp' ) ), + sprintf( '%s', PostmanUtils::getSettingsPageUrl(), __( 'Settings', 'post-smtp' ) ), + sprintf( '%s', 'https://postmansmtp.com', __( 'Visit us', 'post-smtp' ) ), + ); + return array_merge( $mylinks, $links ); + } + } + + /** + * This function runs after a successful, error-free save + */ + public function handleSuccessfulSave() { + // WordPress likes to keep GET parameters around for a long time + // (something in the call to settings_fields() does this) + // here we redirect after a successful save to clear those parameters + PostmanUtils::redirect( PostmanUtils::POSTMAN_HOME_PAGE_RELATIVE_URL ); + } + + /** + * This function handle the request to import plugin data + */ + public function importSettingsAction() { + $this->logger->debug( 'is wpnonce import-settings?' ); + $success = true; + if ( wp_verify_nonce( $_REQUEST ['_wpnonce'], PostmanAdminController::IMPORT_SETTINGS_SLUG ) ) { + $success = PostmanOptions::getInstance()->import( sanitize_textarea_field($_POST ['settings']) ); + } else { + $success = false; + } + if ( ! $success ) { + $this->messageHandler->addError( __( 'There was an error importing the data.', 'post-smtp' ) ); + $this->logger->error( 'There was an error importing the data' ); + } + PostmanUtils::redirect( PostmanUtils::POSTMAN_HOME_PAGE_RELATIVE_URL ); + } + /** + * This function handle the request to purge plugin data + */ + public function handlePurgeDataAction() { + $this->logger->debug( 'is wpnonce purge-data?' ); + if ( wp_verify_nonce( $_REQUEST ['_wpnonce'], PostmanAdminController::PURGE_DATA_SLUG ) ) { + $this->logger->debug( 'Purging stored data' ); + delete_option( PostmanOptions::POSTMAN_OPTIONS ); + delete_option( PostmanOAuthToken::OPTIONS_NAME ); + delete_option( PostmanAdminController::TEST_OPTIONS ); + $logPurger = new PostmanEmailLogPurger(); + $logPurger->removeAll(); + $this->messageHandler->addMessage( __( 'Plugin data was removed.', 'post-smtp' ) ); + PostmanUtils::redirect( PostmanUtils::POSTMAN_HOME_PAGE_RELATIVE_URL ); + } + } + + /** + * Handles the authorization grant + */ + function handleAuthorizationGrant() { + $logger = $this->logger; + $options = $this->options; + $authorizationToken = $this->authorizationToken; + $logger->debug( 'Authorization in progress' ); + $transactionId = PostmanSession::getInstance()->getOauthInProgress(); + + // begin transaction + PostmanUtils::lock(); + + $authenticationManager = PostmanAuthenticationManagerFactory::getInstance()->createAuthenticationManager(); + try { + if ( $authenticationManager->processAuthorizationGrantCode( $transactionId ) ) { + $logger->debug( 'Authorization successful' ); + // save to database + $authorizationToken->save(); + $this->messageHandler->addMessage( __( 'The OAuth 2.0 authorization was successful. Ready to send e-mail.', 'post-smtp' ) ); + } else { + $this->messageHandler->addError( __( 'Your email provider did not grant Postman permission. Try again.', 'post-smtp' ) ); + } + } catch ( PostmanStateIdMissingException $e ) { + $this->messageHandler->addError( __( 'The grant code from Google had no accompanying state and may be a forgery', 'post-smtp' ) ); + } catch ( Exception $e ) { + $logger->error( 'Error: ' . get_class( $e ) . ' code=' . $e->getCode() . ' message=' . $e->getMessage() ); + /* translators: %s is the error message */ + $this->messageHandler->addError( sprintf( __( 'Error authenticating with this Client ID. [%s]', 'post-smtp' ), '' . $e->getMessage() . '' ) ); + } + + // clean-up + PostmanUtils::unlock(); + PostmanSession::getInstance()->unsetOauthInProgress(); + + // redirect home + PostmanUtils::redirect( PostmanUtils::POSTMAN_HOME_PAGE_RELATIVE_URL ); + } + + /** + * This method is called when a user clicks on a "Request Permission from Google" link. + * This link will create a remote API call for Google and redirect the user from WordPress to Google. + * Google will redirect back to WordPress after the user responds. + */ + public function handleOAuthPermissionRequestAction() { + $this->logger->debug( 'handling OAuth Permission request' ); + $authenticationManager = PostmanAuthenticationManagerFactory::getInstance()->createAuthenticationManager(); + $transactionId = $authenticationManager->generateRequestTransactionId(); + PostmanSession::getInstance()->setOauthInProgress( $transactionId ); + $authenticationManager->requestVerificationCode( $transactionId ); + } + } +} diff --git a/Postman/PostmanAjaxController.php b/Postman/PostmanAjaxController.php new file mode 100644 index 0000000..ad63464 --- /dev/null +++ b/Postman/PostmanAjaxController.php @@ -0,0 +1,68 @@ +logger = new PostmanLogger ( get_class ( $this ) ); + } + /** + * + * @param mixed $actionName + * @param mixed $callbackName + */ + protected function registerAjaxHandler($actionName, $class, $callbackName) { + if (is_admin ()) { + $fullname = 'wp_ajax_' . $actionName; + // $this->logger->debug ( 'Registering ' . 'wp_ajax_' . $fullname . ' Ajax handler' ); + add_action ( $fullname, array ( + $class, + $callbackName + ) ); + } + } + + /** + * + * @param mixed $parameterName + * @return mixed + */ + protected function getBooleanRequestParameter($parameterName) { + return filter_var ( $this->getRequestParameter ( $parameterName ), FILTER_VALIDATE_BOOLEAN ); + } + + /** + * + * @param mixed $parameterName + * @return mixed + */ + protected function getRequestParameter($parameterName) { + if (isset ( $_POST [$parameterName] )) { + if ( is_array($_POST [$parameterName] ) ) { + array_walk_recursive( $_POST [$parameterName], 'sanitize_text_field' ); + $value = $_POST [$parameterName]; + } else { + $value = sanitize_text_field($_POST[$parameterName]); + } + + $this->logger->trace ( sprintf ( 'Found parameter "%s"', $parameterName ) ); + $this->logger->trace ( $value ); + + return $value; + } + } + } +} + +require_once ('Postman-Controller/PostmanManageConfigurationAjaxHandler.php'); diff --git a/Postman/PostmanConfigTextHelper.php b/Postman/PostmanConfigTextHelper.php new file mode 100644 index 0000000..8ba5ef0 --- /dev/null +++ b/Postman/PostmanConfigTextHelper.php @@ -0,0 +1,308 @@ +Read Here', 'post-smtp' ), 'https://postmansmtp.com/how-to-configure-post-smtp-with-gmailgsuite-using-oauth/' ); + $text = sprintf( '%s! %s', $attention, $errorMessage ); + + return $text; + } + function isOauthHost() { + return false; + } + function isGoogle() { + return false; + } + function isMicrosoft() { + return false; + } + function isYahoo() { + return false; + } + public function getRequestPermissionLinkText() { + /* translators: where %s is the Email Service Owner (e.g. Google, Microsoft or Yahoo) */ + return sprintf( _x( 'Grant permission with %s', 'Command to initiate OAuth authentication', 'post-smtp' ), $this->getOwnerName() ); + } + } +} +if ( ! class_exists( 'PostmanGoogleOAuthScribe' ) ) { + class PostmanGoogleOAuthScribe extends PostmanAbstractConfigTextHelper { + public function isGoogle() { + return true; + } + function isOauthHost() { + return true; + } + public function getCallbackUrl() { + // see https://codex.wordpress.org/Function_Reference/admin_url#Related + return admin_url( 'options-general.php' ) . '?page=postman'; + } + function getCallbackDomain() { + $urlParts = parse_url( $this->getCallbackUrl() ); + if ( isset( $urlParts ['scheme'] ) && isset( $urlParts ['host'] ) ) { + return $urlParts ['scheme'] . '://' . $urlParts ['host']; + } else { + throw new Exception(); + } + } + public function getClientIdLabel() { + /* Translators: This description is specific to Google */ + return _x( 'Client ID', 'Name of the OAuth 2.0 Client ID', 'post-smtp' ); + } + public function getClientSecretLabel() { + /* Translators: This description is specific to Google */ + return _x( 'Client Secret', 'Name of the OAuth 2.0 Client Secret', 'post-smtp' ); + } + public function getCallbackUrlLabel() { + /* Translators: This description is specific to Google */ + return _x( 'Authorized redirect URI', 'Name of the Application Callback URI', 'post-smtp' ); + } + public function getCallbackDomainLabel() { + /* Translators: This description is specific to Google */ + return _x( 'Authorized JavaScript origins', 'Name of the Application Callback Domain', 'post-smtp' ); + } + public function getOwnerName() { + /* Translators: This description is specific to Google */ + return _x( 'Google', 'Name of the email service owner', 'post-smtp' ); + } + public function getServiceName() { + /* Translators: This description is specific to Google */ + return _x( 'Gmail', 'Name of the email service', 'post-smtp' ); + } + public function getApplicationDescription() { + /* Translators: This description is specific to Google */ + return _x( 'a Client ID for web application', 'Description of the email service OAuth 2.0 Application', 'post-smtp' ); + } + public function getApplicationPortalName() { + /* Translators: This description is specific to Google */ + return _x( 'Google Developers Console Gmail Wizard', 'Name of the email service portal', 'post-smtp' ); + } + public function getApplicationPortalUrl() { + return 'https://www.google.com/accounts/Logout?continue=https://console.developers.google.com/start/api?id=gmail'; + } + public function getOAuthPort() { + return 465; + } + public function getEncryptionType() { + return PostmanOptions::SECURITY_TYPE_SMTPS; + } + } +} +if ( ! class_exists( 'PostmanMicrosoftOAuthScribe' ) ) { + class PostmanMicrosoftOAuthScribe extends PostmanAbstractConfigTextHelper { + public function isMicrosoft() { + return true; + } + function isOauthHost() { + return true; + } + public function getCallbackUrl() { + return admin_url( 'options-general.php' ); + } + function getCallbackDomain() { + $urlParts = parse_url( $this->getCallbackUrl() ); + if ( isset( $urlParts ['host'] ) ) { + return $urlParts ['host']; + } else { + throw new Exception(); + } + } + public function getClientIdLabel() { + /* Translators: This description is specific to Microsoft */ + return _x( 'Client ID', 'Name of the OAuth 2.0 Client ID', 'post-smtp' ); + } + public function getClientSecretLabel() { + /* Translators: This description is specific to Microsoft */ + return _x( 'Client Secret', 'Name of the OAuth 2.0 Client Secret', 'post-smtp' ); + } + public function getCallbackUrlLabel() { + /* Translators: This description is specific to Microsoft */ + return _x( 'Redirect URL', 'Name of the Application Callback URI', 'post-smtp' ); + } + public function getCallbackDomainLabel() { + /* Translators: This description is specific to Microsoft */ + return _x( 'Root Domain', 'Name of the Application Callback Domain', 'post-smtp' ); + } + public function getOwnerName() { + /* Translators: This description is specific to Microsoft */ + return _x( 'Microsoft', 'Name of the email service owner', 'post-smtp' ); + } + public function getServiceName() { + /* Translators: This description is specific to Microsoft */ + return _x( 'Outlook.com', 'Name of the email service', 'post-smtp' ); + } + public function getApplicationDescription() { + /* Translators: This description is specific to Microsoft */ + return _x( 'an Application', 'Description of the email service OAuth 2.0 Application', 'post-smtp' ); + } + public function getApplicationPortalName() { + /* Translators: This description is specific to Microsoft */ + return _x( 'Microsoft Developer Center', 'Name of the email service portal', 'post-smtp' ); + } + public function getApplicationPortalUrl() { + return 'https://account.live.com/developers/applications/index'; + } + public function getOAuthPort() { + return 587; + } + public function getEncryptionType() { + return PostmanOptions::SECURITY_TYPE_STARTTLS; + } + } +} +if ( ! class_exists( 'PostmanYahooOAuthScribe' ) ) { + class PostmanYahooOAuthScribe extends PostmanAbstractConfigTextHelper { + public function isYahoo() { + return true; + } + function isOauthHost() { + return true; + } + public function getCallbackUrl() { + return admin_url( 'options-general.php' ) . '?page=postman'; + } + function getCallbackDomain() { + $urlParts = parse_url( $this->getCallbackUrl() ); + if ( isset( $urlParts ['host'] ) ) { + return $urlParts ['host']; + } else { + throw new Exception(); + } + } + public function getClientIdLabel() { + /* Translators: This description is specific to Yahoo */ + return _x( 'Client ID', 'Name of the OAuth 2.0 Client ID', 'post-smtp' ); + } + public function getClientSecretLabel() { + /* Translators: This description is specific to Yahoo */ + return _x( 'Client Secret', 'Name of the OAuth 2.0 Client Secret', 'post-smtp' ); + } + public function getCallbackUrlLabel() { + /* Translators: This description is specific to Yahoo */ + return _x( 'Home Page URL', 'Name of the Application Callback URI', 'post-smtp' ); + } + public function getCallbackDomainLabel() { + /* Translators: This description is specific to Yahoo */ + return _x( 'Callback Domain', 'Name of the Application Callback Domain', 'post-smtp' ); + } + public function getOwnerName() { + /* Translators: This description is specific to Yahoo */ + return _x( 'Yahoo', 'Name of the email service owner', 'post-smtp' ); + } + public function getServiceName() { + /* Translators: This description is specific to Yahoo */ + return _x( 'Yahoo Mail', 'Name of the email service', 'post-smtp' ); + } + public function getApplicationDescription() { + /* Translators: This description is specific to Yahoo */ + return _x( 'an Application', 'Description of the email service OAuth 2.0 Application', 'post-smtp' ); + } + public function getApplicationPortalName() { + /* Translators: This description is specific to Yahoo */ + return _x( 'Yahoo Developer Network', 'Name of the email service portal', 'post-smtp' ); + } + public function getApplicationPortalUrl() { + return 'https://developer.yahoo.com/apps/'; + } + public function getOAuthPort() { + return 465; + } + public function getEncryptionType() { + return PostmanOptions::SECURITY_TYPE_SMTPS; + } + } +} +if ( ! class_exists( 'PostmanNonOAuthScribe' ) ) { + class PostmanNonOAuthScribe extends PostmanAbstractConfigTextHelper { + protected $hostname; + public function __construct( $hostname ) { + $this->hostname = $hostname; + } + public function isGoogle() { + return PostmanUtils::endsWith( $this->hostname, 'gmail.com' ); + } + public function isMicrosoft() { + return PostmanUtils::endsWith( $this->hostname, 'live.com' ); + } + public function isYahoo() { + return PostmanUtils::endsWith( $this->hostname, 'yahoo.com' ); + } + public function getOAuthHelp() { + $text = __( 'Enter an Outgoing Mail Server with OAuth2 capabilities.', 'post-smtp' ); + return sprintf( '%s', $text ); + } + public function getCallbackUrl() { + return ''; + } + function getCallbackDomain() { + return ''; + } + public function getClientIdLabel() { + return _x( 'Client ID', 'Name of the OAuth 2.0 Client ID', 'post-smtp' ); + } + public function getClientSecretLabel() { + return _x( 'Client Secret', 'Name of the OAuth 2.0 Client Secret', 'post-smtp' ); + } + public function getCallbackUrlLabel() { + return _x( 'Redirect URI', 'Name of the Application Callback URI', 'post-smtp' ); + } + public function getCallbackDomainLabel() { + return _x( 'Website Domain', 'Name of the Application Callback Domain', 'post-smtp' ); + } + public function getOwnerName() { + return ''; + } + public function getServiceName() { + return ''; + } + public function getApplicationDescription() { + return ''; + } + public function getApplicationPortalName() { + return ''; + } + public function getApplicationPortalUrl() { + return ''; + } + public function getOAuthPort() { + return ''; + } + public function getEncryptionType() { + return ''; + } + public function getRequestPermissionLinkText() { + return __( 'Grant OAuth 2.0 Permission', 'post-smtp' ); + } + } +} diff --git a/Postman/PostmanEmailLogs.php b/Postman/PostmanEmailLogs.php new file mode 100644 index 0000000..b25bfbb --- /dev/null +++ b/Postman/PostmanEmailLogs.php @@ -0,0 +1,113 @@ +db = $wpdb; + } + + function install_table() { + + global $wpdb; + + $sql = "CREATE TABLE `{$wpdb->prefix}_{$this->db_name}` (
 + `id` bigint(20) NOT NULL AUTO_INCREMENT,
"; + + foreach ($this->fields as $field ) { + if ( $field == 'original_message' || $field == 'session_transcript' ) { + $sql .= "`" . $field . "` longtext DEFAULT NULL,"; + continue; + } + $sql .= "`" . $field . "` varchar(255) DEFAULT NULL,"; + } + $sql .= "PRIMARY KEY (`id`)) ENGINE=InnoDB CHARSET={$wpdb->charset} COLLATE={$wpdb->collate};
"; + + dbDelta( $sql ); + } + + public static function get_data( $post_id ) { + $fields = array(); + foreach ( self::$fields as $field ) { + $fields[$field][0] = get_post_meta( $post_id, $field, true ); + } + + return $fields; + } + + public static function get_fields() { + return self::$fields; + } + + function migrate_data() { + $args = array( + 'post_type' => 'postman_sent_mail', + 'posts_per_page' => -1, + ); + + $logs = new WP_Query($args); + + $failed_records = 0; + foreach ( $logs->posts as $log ) { + + foreach ($this->fields as $key ) { + $value = $this->get_meta( $log->ID, $key, true ); + + if ( $this->add_meta( $log->ID, $key, $value ) ) { + delete_post_meta( $log->ID, $key ); + } else { + $failed_records++; + } + } + } + } + + function load() { + $this->db->select(); + } + + /** + * @param array $data + */ + function save( $data ) { + $this->db->query( $this->db->prepare( + " + INSERT INTO $this->db_name + ( " . implode( ',', array_keys( $data ) ) . " ) + VALUES ( " . str_repeat( '%s', count( $data ) ) . " )", array_values( $data ) + ) ); + } + +} \ No newline at end of file diff --git a/Postman/PostmanInputSanitizer.php b/Postman/PostmanInputSanitizer.php new file mode 100644 index 0000000..75a0041 --- /dev/null +++ b/Postman/PostmanInputSanitizer.php @@ -0,0 +1,186 @@ +logger = new PostmanLogger( get_class( $this ) ); + $this->options = PostmanOptions::getInstance(); + } + + /** + * Sanitize each setting field as needed + * + * @param array $input + * Contains all settings fields as array keys + */ + public function sanitize( $input ) { + $this->logger->debug( 'Sanitizing data before storage' ); + + $new_input = array(); + $success = true; + + $this->sanitizeString( 'Encryption Type', PostmanOptions::SECURITY_TYPE, $input, $new_input ); + $this->sanitizeString( 'Hostname', PostmanOptions::HOSTNAME, $input, $new_input ); + if ( ! empty( $input [ PostmanOptions::PORT ] ) ) { + $port = absint( $input [ PostmanOptions::PORT ] ); + if ( $port > 0 ) { + $this->sanitizeInt( 'Port', PostmanOptions::PORT, $input, $new_input ); + } else { + $new_input [ PostmanOptions::PORT ] = $this->options->getPort(); + add_settings_error( PostmanOptions::PORT, PostmanOptions::PORT, 'Invalid TCP Port', 'error' ); + $success = false; + } + } + // check the auth type AFTER the hostname because we reset the hostname if auth is bad + $this->sanitizeString( 'From Email', PostmanOptions::MESSAGE_SENDER_EMAIL, $input, $new_input ); + // the wizard doesn't set an envelope sender, so we'll default it to From Email + $new_input [ PostmanOptions::ENVELOPE_SENDER ] = $new_input [ PostmanOptions::MESSAGE_SENDER_EMAIL ]; + $this->sanitizeString( 'Sender Email', PostmanOptions::ENVELOPE_SENDER, $input, $new_input ); + $this->sanitizeString( 'Transport Type', PostmanOptions::TRANSPORT_TYPE, $input, $new_input ); + $this->sanitizeString( 'SMTP Mailers', 'smtp_mailers', $input, $new_input ); + $this->sanitizeString( 'Authorization Type', PostmanOptions::AUTHENTICATION_TYPE, $input, $new_input ); + $this->sanitizeString( 'From Name', PostmanOptions::MESSAGE_SENDER_NAME, $input, $new_input ); + $this->sanitizeString( 'Client ID', PostmanOptions::CLIENT_ID, $input, $new_input ); + $this->sanitizeString( 'Client Secret', PostmanOptions::CLIENT_SECRET, $input, $new_input ); + $this->sanitizeString( 'Username', PostmanOptions::BASIC_AUTH_USERNAME, $input, $new_input ); + $this->sanitizePassword( 'Password', PostmanOptions::BASIC_AUTH_PASSWORD, $input, $new_input, $this->options->getPassword() ); + $this->sanitizePassword( 'Mandrill API Key', PostmanOptions::MANDRILL_API_KEY, $input, $new_input, $this->options->getMandrillApiKey() ); + $this->sanitizePassword( 'SendGrid API Key', PostmanOptions::SENDGRID_API_KEY, $input, $new_input, $this->options->getSendGridApiKey() ); + $this->sanitizePassword( 'Mailgun API Key', PostmanOptions::MAILGUN_API_KEY, $input, $new_input, $this->options->getMailgunApiKey() ); + $this->sanitizeString( 'Mailgun Domain Name', PostmanOptions::MAILGUN_DOMAIN_NAME, $input, $new_input ); + $this->sanitizeString( 'Reply-To', PostmanOptions::REPLY_TO, $input, $new_input ); + $this->sanitizeString( 'From Name Override', PostmanOptions::PREVENT_MESSAGE_SENDER_NAME_OVERRIDE, $input, $new_input ); + $this->sanitizeString( 'From Email Override', PostmanOptions::PREVENT_MESSAGE_SENDER_EMAIL_OVERRIDE, $input, $new_input ); + $this->sanitizeString( 'Disable Email Validation', PostmanOptions::DISABLE_EMAIL_VALIDAITON, $input, $new_input ); + $this->sanitizeString( 'Mailgun Europe Region', PostmanOptions::MAILGUN_REGION, $input, $new_input ); + $this->sanitizeString( 'Forced To Recipients', PostmanOptions::FORCED_TO_RECIPIENTS, $input, $new_input ); + $this->sanitizeString( 'Forced CC Recipients', PostmanOptions::FORCED_CC_RECIPIENTS, $input, $new_input ); + $this->sanitizeString( 'Forced BCC Recipients', PostmanOptions::FORCED_BCC_RECIPIENTS, $input, $new_input ); + $this->sanitizeString( 'Additional Headers', PostmanOptions::ADDITIONAL_HEADERS, $input, $new_input ); + $this->sanitizeInt( 'Read Timeout', PostmanOptions::READ_TIMEOUT, $input, $new_input ); + $this->sanitizeInt( 'Conenction Timeout', PostmanOptions::CONNECTION_TIMEOUT, $input, $new_input ); + $this->sanitizeInt( 'Log Level', PostmanOptions::LOG_LEVEL, $input, $new_input ); + $this->sanitizeString( 'Email Log Enabled', PostmanOptions::MAIL_LOG_ENABLED_OPTION, $input, $new_input ); + $this->sanitizeLogMax( 'Email Log Max Entries', PostmanOptions::MAIL_LOG_MAX_ENTRIES, $input, $new_input ); + $this->sanitizeString( 'Run Mode', PostmanOptions::RUN_MODE, $input, $new_input ); + $this->sanitizeString( 'Stealth Mode', PostmanOptions::STEALTH_MODE, $input, $new_input ); + $this->sanitizeInt( 'Transcript Size', PostmanOptions::TRANSCRIPT_SIZE, $input, $new_input ); + $this->sanitizeString( 'Temporary Directory', PostmanOptions::TEMPORARY_DIRECTORY, $input, $new_input ); + + // Notifications + $this->sanitizeString( 'Pushover Service', PostmanOptions::NOTIFICATION_SERVICE, $input, $new_input, $this->options->getNotificationService() ); + $this->sanitizePassword( 'Pushover Username', PostmanOptions::PUSHOVER_USER, $input, $new_input, $this->options->getPushoverUser() ); + $this->sanitizePassword( 'Pushover Token', PostmanOptions::PUSHOVER_TOKEN, $input, $new_input, $this->options->getPushoverToken() ); + $this->sanitizePassword( 'Slack Token', PostmanOptions::SLACK_TOKEN, $input, $new_input, $this->options->getSlackToken() ); + + // Chrome extension + $this->sanitizeString( 'Push Chrome Extension', PostmanOptions::NOTIFICATION_USE_CHROME, $input, $new_input ); + $this->sanitizePassword( 'Push Chrome Extension UID', PostmanOptions::NOTIFICATION_CHROME_UID, $input, $new_input, $this->options->getNotificationChromeUid() ); + + // Fallback + $this->sanitizeString( 'Use fallback', PostmanOptions::FALLBACK_SMTP_ENABLED, $input, $new_input ); + $this->sanitizeString( 'Fallback hostname', PostmanOptions::FALLBACK_SMTP_HOSTNAME, $input, $new_input ); + $this->sanitizeInt( 'Fallback port', PostmanOptions::FALLBACK_SMTP_PORT, $input, $new_input ); + $this->sanitizeString( 'Fallback security', PostmanOptions::FALLBACK_SMTP_SECURITY, $input, $new_input ); + $this->sanitizeString( 'Fallback auth', PostmanOptions::FALLBACK_SMTP_USE_AUTH, $input, $new_input ); + $this->sanitizeString( 'Fallback username', PostmanOptions::FALLBACK_FROM_EMAIL, $input, $new_input ); + $this->sanitizeString( 'Fallback username', PostmanOptions::FALLBACK_SMTP_USERNAME, $input, $new_input ); + $this->sanitizePassword( 'Fallback password', PostmanOptions::FALLBACK_SMTP_PASSWORD, $input, $new_input, $this->options->getFallbackPassword() ); + + $new_input = apply_filters( 'post_smtp_sanitize', $new_input, $input, $this ); + + if ( $new_input [ PostmanOptions::CLIENT_ID ] != $this->options->getClientId() || $new_input [ PostmanOptions::CLIENT_SECRET ] != $this->options->getClientSecret() || $new_input [ PostmanOptions::HOSTNAME ] != $this->options->getHostname() ) { + $this->logger->debug( 'Recognized new Client ID' ); + // the user entered a new client id and we should destroy the stored auth token + delete_option( PostmanOAuthToken::OPTIONS_NAME ); + } + + // can we create a tmp file? - this code is duplicated in ActivationHandler + PostmanUtils::deleteLockFile( $new_input [ PostmanOptions::TEMPORARY_DIRECTORY ] ); + $lockSuccess = PostmanUtils::createLockFile( $new_input [ PostmanOptions::TEMPORARY_DIRECTORY ] ); + // &= does not work as expected in my PHP + $lockSuccess = $lockSuccess && PostmanUtils::deleteLockFile( $new_input [ PostmanOptions::TEMPORARY_DIRECTORY ] ); + $this->logger->debug( 'FileLocking=' . $lockSuccess ); + PostmanState::getInstance()->setFileLockingEnabled( $lockSuccess ); + + if ( $success ) { + PostmanSession::getInstance()->setAction( self::VALIDATION_SUCCESS ); + } else { + PostmanSession::getInstance()->setAction( self::VALIDATION_FAILED ); + } + + return $new_input; + } + + public function sanitizeString( $desc, $key, $input, &$new_input ) { + if ( isset( $input [ $key ] ) ) { + $this->logSanitize( $desc, $input [ $key ] ); + $new_input [ $key ] = sanitize_text_field( trim( $input [ $key ] ) ); + } + } + + /** + * Sanitize a Basic Auth password, and base64-encode it + * + * @param mixed $desc + * @param mixed $key + * @param mixed $input + * @param mixed $new_input + */ + public function sanitizePassword( $desc, $key, $input, &$new_input, $existingPassword ) { + // WordPress calling Sanitize twice is a known issue + // https://core.trac.wordpress.org/ticket/21989 + $action = PostmanSession::getInstance()->getAction(); + // if $action is not empty, then sanitize has already run + if ( ! empty( $action ) ) { + // use the already encoded password in the $input + $new_input [ $key ] = $input [ $key ]; + // log it + $this->logger->debug( 'Warning, second sanitizePassword attempt detected' ); + } else if ( isset( $input [ $key ] ) ) { + if ( strlen( $input [ $key ] ) > 0 && preg_match( '/^\**$/', $input [ $key ] ) ) { + // if the password is all stars, then keep the existing password + $new_input [ $key ] = $existingPassword; + } else { + // otherwise the password is new, so trim it + $new_input [ $key ] = sanitize_text_field( trim( $input [ $key ] ) ); + } + // log it + $this->logSanitize( $desc, $new_input [ $key ] ); + // base-64 scramble password + $new_input [ $key ] = base64_encode( $new_input [ $key ] ); + } + $this->logger->debug( sprintf( 'Encoding %s as %s', $desc, $new_input [ $key ] ) ); + } + + private function sanitizeLogMax( $desc, $key, $input, &$new_input ) { + if ( isset( $input [ $key ] ) ) { + $value = absint( $input [ $key ] ); + if ( $value <= 0 ) { + $new_input [ $key ] = PostmanOptions::getInstance()->getMailLoggingMaxEntries(); + $h = new PostmanMessageHandler(); + $h->addError( sprintf( '%s %s', __( 'Maximum Log Entries', 'post-smtp' ), __( 'must be greater than 0', 'post-smtp' ) ) ); + } else { + $this->logSanitize( $desc, $input [ $key ] ); + $new_input [ $key ] = absint($value); + } + } + } + + private function sanitizeInt( $desc, $key, $input, &$new_input ) { + if ( isset( $input [ $key ] ) ) { + $this->logSanitize( $desc, $input [ $key ] ); + $new_input [ $key ] = absint( $input [ $key ] ); + } + } + private function logSanitize( $desc, $value ) { + $this->logger->trace( 'Sanitize ' . $desc . ' ' . $value ); + } + } +} diff --git a/Postman/PostmanInstaller.php b/Postman/PostmanInstaller.php new file mode 100644 index 0000000..01c6a07 --- /dev/null +++ b/Postman/PostmanInstaller.php @@ -0,0 +1,267 @@ +logger = new PostmanLogger( get_class( $this ) ); + } + + /** + * Handle activation of the plugin + */ + public function activatePostman() { + delete_option( 'postman_release_version' ); + delete_option( 'postman_dismiss_donation' ); + + $options = get_option( PostmanOptions::POSTMAN_OPTIONS ); + $args = array( + 'fallback_smtp_enabled' => 'no', + ); + + if ( empty( $options ) ) { + add_option( 'postman_options', $args ); + + } else { + if ( empty( $options['fallback_smtp_enabled'] ) ) { + $result = array_merge($options, $args); + update_option( PostmanOptions::POSTMAN_OPTIONS, $result ); + } + } + + if ( function_exists( 'is_multisite' ) && is_multisite() ) { + + $options['post_smtp_allow_overwrite'] = '1'; + update_site_option( PostmanOptions::POSTMAN_NETWORK_OPTIONS, $options ); + + // handle network activation + // from https://wordpress.org/support/topic/new-function-wp_get_sites?replies=11 + // run the activation function for each blog id + $old_blog = get_current_blog_id(); + // Get all blog ids + $subsites = get_sites(); + foreach ( $subsites as $subsite ) { + $this->logger->trace( 'multisite: switching to blog ' . $subsite->blog_id ); + switch_to_blog( $subsite->blog_id ); + $this->handleOptionUpdates(); + $this->addCapability(); + } + switch_to_blog( $old_blog ); + } else { + // handle single-site activation + $this->handleOptionUpdates(); + $this->addCapability(); + } + + //$this->add_activation_redirect(); + } + + function add_activation_redirect() { + + // Bail if activating from network, or bulk + if ( is_network_admin() || isset( $_GET['activate-multi'] ) ) { + return; } + + // Add the transient to redirect + //set_transient( '_post_activation_redirect', true, 30 ); + } + + /** + * Handle deactivation of the plugin + */ + public function deactivatePostman() { + if ( function_exists( 'is_multisite' ) && is_multisite() ) { + // handle network deactivation + // from https://wordpress.org/support/topic/new-function-wp_get_sites?replies=11 + // run the deactivation function for each blog id + $old_blog = get_current_blog_id(); + // Get all blog ids + $subsites = get_sites(); + foreach ( $subsites as $subsite ) { + $this->logger->trace( 'multisite: switching to blog ' . $subsite->blog_id ); + switch_to_blog( $subsite->blog_id ); + $this->removeCapability(); + } + switch_to_blog( $old_blog ); + } else { + // handle single-site deactivation + $this->removeCapability(); + } + } + + /** + * Add the capability to manage postman + */ + public function addCapability() { + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Adding admin capability' ); + } + // ref: https://codex.wordpress.org/Function_Reference/add_cap + // NB: This setting is saved to the database, so it might be better to run this on theme/plugin activation + // add the custom capability to the administrator role + $role = get_role( Postman::ADMINISTRATOR_ROLE_NAME ); + $role->add_cap( Postman::MANAGE_POSTMAN_CAPABILITY_NAME ); + $role->add_cap( Postman::MANAGE_POSTMAN_CAPABILITY_LOGS ); + } + + /** + * Remove the capability to manage postman + */ + public function removeCapability() { + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'Removing admin capability' ); + } + // ref: https://codex.wordpress.org/Function_Reference/add_cap + // NB: This setting is saved to the database, so it might be better to run this on theme/plugin activation + // remove the custom capability from the administrator role + $role = get_role( Postman::ADMINISTRATOR_ROLE_NAME ); + $role->remove_cap( Postman::MANAGE_POSTMAN_CAPABILITY_NAME ); + $role->remove_cap( Postman::MANAGE_POSTMAN_CAPABILITY_LOGS ); + } + + /** + * Handle activation of plugin + */ + private function handleOptionUpdates() { + $this->logger->debug( 'Activating plugin' ); + // prior to version 0.2.5, $authOptions did not exist + $authOptions = get_option( 'postman_auth_token' ); + $options = get_option( 'postman_options' ); + $postmanState = get_option( 'postman_state' ); + if ( empty( $authOptions ) && ! (empty( $options )) && ! empty( $options ['access_token'] ) ) { + $this->logger->debug( 'Upgrading database: copying Authorization token from postman_options to postman_auth_token' ); + // copy the variables from $options to $authToken + $authOptions ['access_token'] = $options ['access_token']; + $authOptions ['refresh_token'] = $options ['refresh_token']; + // there was a bug where we weren't setting the expiry time + if ( ! empty( $options ['auth_token_expires'] ) ) { + $authOptions ['auth_token_expires'] = $options ['auth_token_expires']; + } + update_option( 'postman_auth_token', $authOptions ); + } + if ( ! isset( $options ['authorization_type'] ) && ! isset( $options ['auth_type'] ) ) { + // prior to 1.0.0, access tokens were saved in authOptions without an auth type + // prior to 0.2.5, access tokens were save in options without an auth type + // either way, only oauth2 was supported + if ( isset( $authOptions ['access_token'] ) || isset( $options ['access_token'] ) ) { + $this->logger->debug( "Upgrading database: setting authorization_type to 'oauth2'" ); + $options ['authorization_type'] = 'oauth2'; + update_option( 'postman_options', $options ); + } + } + if ( ! isset( $options ['enc_type'] ) ) { + // prior to 1.3, encryption type was combined with authentication type + if ( isset( $options ['authorization_type'] ) ) { + $this->logger->debug( 'Upgrading database: creating auth_type and enc_type from authorization_type' ); + $authType = $options ['authorization_type']; + switch ( $authType ) { + case 'none' : + $options ['auth_type'] = 'none'; + $options ['enc_type'] = 'none'; + break; + case 'basic-ssl' : + $options ['auth_type'] = 'login'; + $options ['enc_type'] = 'ssl'; + break; + case 'basic-tls' : + $options ['auth_type'] = 'login'; + $options ['enc_type'] = 'tls'; + break; + case 'oauth2' : + $options ['auth_type'] = 'oauth2'; + $options ['enc_type'] = 'ssl'; + break; + default : + } + update_option( 'postman_options', $options ); + } + } + // prior to 1.3.3, the version identifier was not stored and the passwords were plaintext + if ( isset( $options ['enc_type'] ) && ! (isset( $options ['version'] ) || isset( $postmanState ['version'] )) ) { + $this->logger->debug( 'Upgrading database: added plugin version and encoding password' ); + $options ['version'] = '1.3.3'; + if ( isset( $options ['basic_auth_password'] ) ) { + $options ['basic_auth_password'] = base64_encode( $options ['basic_auth_password'] ); + } + update_option( 'postman_options', $options ); + } + // prior to 1.4.2, the transport was not identified and the auth token had no vendor + if ( isset( $options ['auth_type'] ) && ! isset( $options ['transport_type'] ) ) { + $this->logger->debug( 'Upgrading database: added transport_type and vendor_name' ); + $options ['transport_type'] = 'smtp'; + update_option( 'postman_options', $options ); + if ( isset( $authOptions ['access_token'] ) && isset( $options ['oauth_client_id'] ) ) { + // if there is a stored token.. + if ( PostmanUtils::endsWith( $options ['oauth_client_id'], 'googleusercontent.com' ) ) { + $authOptions ['vendor_name'] = 'google'; } else if ( strlen( $options ['oauth_client_id'] < strlen( $options ['oauth_client_secret'] ) ) ) { + $authOptions ['vendor_name'] = 'microsoft'; + } else { $authOptions ['vendor_name'] = 'yahoo'; } + update_option( 'postman_auth_token', $authOptions ); + } + } + + // for version 1.6.18, the envelope from was introduced + if ( ! empty( $options ['sender_email'] ) && empty( $options ['envelope_sender'] ) ) { + $this->logger->debug( 'Upgrading database: adding envelope_sender' ); + $options ['envelope_sender'] = $options ['sender_email']; + update_option( 'postman_options', $options ); + } + + if ( isset( $postmanState ['version'] ) && version_compare( $postmanState ['version'], '1.7.0', '<' ) ) { + if ( $options ['mail_log_max_entries'] == 10 ) { + $options ['mail_log_max_entries'] = 250; + } + $postmanStats = get_option( 'postman_stats' ); + $stateCleared = false; + if ( ! isset( $postmanState ['delivery_success_total'] ) && isset( $postmanStats ['delivery_success_total'] ) ) { + $postmanState ['delivery_success_total'] = $postmanStats ['delivery_success_total']; + $stateCleared = true; + } + if ( ! isset( $postmanState ['delivery_fail_total'] ) && isset( $postmanStats ['delivery_fail_total'] ) ) { + $postmanState ['delivery_fail_total'] = $postmanStats ['delivery_fail_total']; + $stateCleared = true; + } + if ( $stateCleared ) { + delete_option( 'postman_stats' ); + } + } + + // can we create a tmp file? - this code is duplicated in InputSanitizer + PostmanUtils::deleteLockFile(); + $lockSuccess = PostmanUtils::createLockFile(); + // &= does not work as expected in my PHP + $lockSuccess = $lockSuccess && PostmanUtils::deleteLockFile(); + $postmanState ['locking_enabled'] = $lockSuccess; + + // always update the version number + if ( ! isset( $postmanState ['install_date'] ) ) { + $this->logger->debug( 'Upgrading database: adding install_date' ); + $postmanState ['install_date'] = time(); + } + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + $postmanState ['version'] = $pluginData ['version']; + update_option( 'postman_state', $postmanState ); + delete_option( 'postman_session' ); + + // reload options + PostmanState::getInstance()->reload(); + PostmanOptions::getInstance()->reload(); + } +} diff --git a/Postman/PostmanLogFields.php b/Postman/PostmanLogFields.php new file mode 100644 index 0000000..04d24a4 --- /dev/null +++ b/Postman/PostmanLogFields.php @@ -0,0 +1,139 @@ + 'sanitize_text_field', + 'from_header' => [ 'PostmanLogFields', 'email_header_sanitize' ], + 'to_header' => [ 'PostmanLogFields', 'email_header_sanitize' ], + 'cc_header' => [ 'PostmanLogFields', 'email_header_sanitize' ], + 'bcc_header' => [ 'PostmanLogFields', 'email_header_sanitize' ], + 'reply_to_header' => [ 'PostmanLogFields', 'email_header_sanitize' ], + 'transport_uri' => 'sanitize_text_field', + 'original_to' => 'sanitize_text_field', + 'original_subject' => 'sanitize_text_field', + 'original_message' => '', // only sent to viewed + 'original_headers' => '', // only sent to viewed + 'session_transcript' => '', // escaped when viewed + ); + + private static $instance = null; + + public static function get_instance() { + if ( ! self::$instance ) { + self::$instance = new static(); + } + + return self::$instance; + } + + private function __construct() + { + + } + + public function get( $post_id ) { + $data = []; + foreach ( $this->fields as $key => $sanitize_callback ) { + $meta = get_post_meta( $post_id, $key, true ); + $data[$key][] = $this->maybe_json( $meta ); + } + + return $data; + } + + public function get_fields() { + return $this->fields; + } + + public function update( $post_id, $key, $value ) { + $sanitized = $this->sanitize( $key, $value ); + $encode = $this->encode( $sanitized ); + + update_post_meta( $post_id, $key, $encode ); + } + + private function maybe_json( $json ) { + + if ( is_array( $json ) ) { + return implode( ',', $json ); + } + + if ( $this->isJson( $json ) ) { + return implode( ',', json_decode( $json, true ) ); + } + + // Fallback + return maybe_unserialize( $json ); + } + + private function isJson($string) { + $result = json_decode($string, true); + $error = json_last_error(); + return ( $error == JSON_ERROR_NONE && ! is_null($result) && $result != $string ); + } + + private function sanitize( $key, $value ) { + + $callback = is_array( $value ) ? 'array_map' : 'call_user_func'; + + if ( ! empty( $this->fields[$key] ) ) { + return $callback( $this->fields[$key], $value ); + } + + return $value; + } + + private function sanitize_message( $message ) { + $allowed_tags = wp_kses_allowed_html( 'post' ); + $allowed_tags['style'] = array(); + + return wp_kses( $message, $allowed_tags ); + } + + private function encode( $value ) { + if ( is_array( $value ) ) { + return wp_json_encode( $value ); + } + + return $value; + } + + public function get_string_between($string, $start, $end){ + $string = ' ' . $string; + $ini = strpos($string, $start); + + if ($ini == 0) { + return ''; + } + + $ini += strlen($start); + $len = strpos($string, $end, $ini) - $ini; + + return substr($string, $ini, $len); + } + + public function email_header_sanitize($value) { + + $parts = explode( ',', $value ); + + $sanitized = []; + foreach ( $parts as $part ) { + + if ( strpos( $part, '<' ) !== false ) { + $email = $this->get_string_between( $part, '<', '>' ); + $clean_email = $this->sanitize_email($email); + preg_match('/(.*)"; + } + } + + return ! empty( $sanitized ) ? implode( ',', $sanitized ) : implode( ',', array_map( [ $this, 'sanitize_email'], $parts ) ); + } + + public function sanitize_email( $email ) { + return filter_var( $email, FILTER_SANITIZE_EMAIL ); + } +} + diff --git a/Postman/PostmanLogger.php b/Postman/PostmanLogger.php new file mode 100644 index 0000000..5454c60 --- /dev/null +++ b/Postman/PostmanLogger.php @@ -0,0 +1,73 @@ +name = $name; + $this->wpDebug = defined ( 'WP_DEBUG' ); + if (class_exists ( 'PostmanOptions' )) { + $this->logLevel = PostmanOptions::getInstance ()->getLogLevel (); + } else { + $this->logLevel = self::OFF_INT; + } + } + function trace($text) { + $this->printLog ( $text, self::TRACE_INT, 'TRACE' ); + } + function debug($text) { + $this->printLog ( $text, self::DEBUG_INT, 'DEBUG' ); + } + function info($text) { + $this->printLog ( $text, self::INFO_INT, 'INFO' ); + } + function warn($text) { + $this->printLog ( $text, self::WARN_INT, 'WARN' ); + } + function error($text) { + $this->printLog ( $text, self::ERROR_INT, 'ERROR' ); + } + function fatal($text) { + $this->printLog ( $text, self::FATAL_INT, 'FATAL' ); + } + /** + * better logging thanks to http://www.smashingmagazine.com/2011/03/08/ten-things-every-wordpress-plugin-developer-should-know/ + * + * @param mixed $intLogLevel + * @param mixed $logLevelName + */ + private function printLog($text, $intLogLevel, $logLevelName) { + if ($this->wpDebug && $intLogLevel >= $this->logLevel) { + if (is_array ( $text ) || is_object ( $text )) { + error_log ( $logLevelName . ' ' . $this->name . ': ' . print_r ( $text, true ) ); + } else { + error_log ( $logLevelName . ' ' . $this->name . ': ' . $text ); + } + } + } + public function isDebug() { + return self::DEBUG_INT >= $this->logLevel; + } + public function isTrace() { + return self::TRACE_INT >= $this->logLevel; + } + public function isInfo() { + return self::INFO_INT >= $this->logLevel; + } + } +} diff --git a/Postman/PostmanMessageHandler.php b/Postman/PostmanMessageHandler.php new file mode 100644 index 0000000..cd9220d --- /dev/null +++ b/Postman/PostmanMessageHandler.php @@ -0,0 +1,115 @@ +logger = new PostmanLogger ( get_class ( $this ) ); + + // we'll let the 'init' functions run first; some of them may end the request + add_action ( 'admin_notices', Array ( + $this, + 'displayAllMessages' + ) ); + } + + /** + * + * @param mixed $message + */ + public function addError($message) { + $this->storeMessage ( $message, 'error' ); + } + /** + * + * @param mixed $message + */ + public function addWarning($message) { + $this->storeMessage ( $message, 'warning' ); + } + /** + * + * @param mixed $message + */ + public function addMessage($message) { + $this->storeMessage ( $message, 'notify' ); + } + + /** + * store messages for display later + * + * @param mixed $message + * @param mixed $type + */ + private function storeMessage($message, $type) { + $messageArray = array (); + $oldMessageArray = PostmanSession::getInstance ()->getMessage (); + if ($oldMessageArray) { + $messageArray = $oldMessageArray; + } + $weGotIt = false; + foreach ( $messageArray as $storedMessage ) { + if ($storedMessage ['message'] === $message) { + $weGotIt = true; + } + } + if (! $weGotIt) { + $m = array ( + 'type' => $type, + 'message' => $message + ); + array_push ( $messageArray, $m ); + PostmanSession::getInstance ()->setMessage ( $messageArray ); + } + } + /** + * Retrieve the messages and show them + */ + public function displayAllMessages() { + $messageArray = PostmanSession::getInstance ()->getMessage (); + if ($messageArray) { + PostmanSession::getInstance ()->unsetMessage (); + foreach ( $messageArray as $m ) { + $type = $m ['type']; + switch ($type) { + case 'error' : + $className = self::ERROR_CLASS; + break; + case 'warning' : + $className = self::WARNING_CLASS; + break; + default : + $className = self::SUCCESS_CLASS; + break; + } + $message = $m ['message']; + $this->printMessage ( $message, $className ); + } + } + } + + /** + * putput message + * + * @param mixed $message + * @param mixed $className + */ + public function printMessage($message, $className) { + printf ( '

    %s

    ', $className, $message ); + } + } +} diff --git a/Postman/PostmanOAuthToken.php b/Postman/PostmanOAuthToken.php new file mode 100644 index 0000000..1cd9634 --- /dev/null +++ b/Postman/PostmanOAuthToken.php @@ -0,0 +1,89 @@ +load (); + } + + /** + * Is there a valid access token and refresh token + */ + public function isValid() { + $accessToken = $this->getAccessToken (); + $refreshToken = $this->getRefreshToken (); + return ! (empty ( $accessToken ) || empty ( $refreshToken )); + } + + /** + * Load the Postman OAuth token properties to the database + */ + private function load() { + $a = get_option ( PostmanOAuthToken::OPTIONS_NAME ); + $this->setAccessToken ( $a [PostmanOAuthToken::ACCESS_TOKEN] ); + $this->setRefreshToken ( $a [PostmanOAuthToken::REFRESH_TOKEN] ); + $this->setExpiryTime ( $a [PostmanOAuthToken::EXPIRY_TIME] ); + $this->setVendorName ( $a [PostmanOAuthToken::VENDOR_NAME] ); + } + + /** + * Save the Postman OAuth token properties to the database + */ + public function save() { + $a [PostmanOAuthToken::ACCESS_TOKEN] = $this->getAccessToken (); + $a [PostmanOAuthToken::REFRESH_TOKEN] = $this->getRefreshToken (); + $a [PostmanOAuthToken::EXPIRY_TIME] = $this->getExpiryTime (); + $a [PostmanOAuthToken::VENDOR_NAME] = $this->getVendorName (); + update_option ( PostmanOAuthToken::OPTIONS_NAME, $a ); + } + public function getVendorName() { + return $this->vendorName; + } + public function getExpiryTime() { + return $this->expiryTime; + } + public function getAccessToken() { + return $this->accessToken; + } + public function getRefreshToken() { + return $this->refreshToken; + } + public function setVendorName($name) { + $this->vendorName = sanitize_text_field ( $name ); + } + public function setExpiryTime($time) { + $this->expiryTime = sanitize_text_field ( $time ); + } + public function setAccessToken($token) { + $this->accessToken = sanitize_text_field ( $token ); + } + public function setRefreshToken($token) { + $this->refreshToken = sanitize_text_field ( $token ); + } + } +} \ No newline at end of file diff --git a/Postman/PostmanOptions.php b/Postman/PostmanOptions.php new file mode 100644 index 0000000..e2e78d6 --- /dev/null +++ b/Postman/PostmanOptions.php @@ -0,0 +1,679 @@ + 'PHPMailer', + 'postsmtp' => 'PostSMTP' + ]; + + public $is_fallback = false; + + // options data + private $options; + + // singleton instance + public static function getInstance() { + static $inst = null; + if ( $inst === null ) { + $inst = new PostmanOptions(); + } + return $inst; + } + + /** + * private constructor + */ + private function __construct() { + $this->load(); + } + + public function save() { + update_option( PostmanOptions::POSTMAN_OPTIONS, $this->options ); + } + + public function reload() { + $this->load(); + } + + public function load() { + + $options = get_option( self::POSTMAN_OPTIONS ); + + if ( is_multisite() ) { + $network_options = get_site_option( self::POSTMAN_NETWORK_OPTIONS ); + + $blog_id = get_current_blog_id(); + if ( isset( $network_options['post_smtp_global_settings'] ) ) { + $blog_id = apply_filters( 'post_smtp_default_site_option', 1 ); + } + + switch_to_blog($blog_id); + $options = get_option( self::POSTMAN_OPTIONS ); + restore_current_blog(); + } + + $this->options = $options; + } + + public function isNew() { + return ! isset( $this->options [ PostmanOptions::TRANSPORT_TYPE ] ); + } + public function isMailLoggingEnabled() { + $allowed = $this->isMailLoggingAllowed(); + $enabled = $this->getMailLoggingEnabled() == self::MAIL_LOG_ENABLED_OPTION_YES; + return $allowed && $enabled; + } + public function getTempDirectory() { + if ( isset( $this->options [ self::TEMPORARY_DIRECTORY ] ) ) { + return $this->options [ self::TEMPORARY_DIRECTORY ]; + } else { return self::DEFAULT_TEMP_DIRECTORY; } + } + public function isMailLoggingAllowed() { + return true; + } + public function isStealthModeEnabled() { + if ( isset( $this->options [ PostmanOptions::STEALTH_MODE ] ) ) { + return $this->options [ PostmanOptions::STEALTH_MODE ]; + } else { return self::DEFAULT_STEALTH_MODE; } + } + public function getMailLoggingEnabled() { + if ( isset( $this->options [ PostmanOptions::MAIL_LOG_ENABLED_OPTION ] ) ) { + return $this->options [ PostmanOptions::MAIL_LOG_ENABLED_OPTION ]; + } else { return self::DEFAULT_MAIL_LOG_ENABLED; } + } + public function getRunMode() { + if ( defined( 'POST_SMTP_RUN_MODE' ) ) { + return POST_SMTP_RUN_MODE; + } + + if ( isset( $this->options [ self::RUN_MODE ] ) ) { + return $this->options [ self::RUN_MODE ]; + } else { return self::DEFAULT_RUN_MODE; } + } + public function getMailLoggingMaxEntries() { + if ( isset( $this->options [ PostmanOptions::MAIL_LOG_MAX_ENTRIES ] ) ) { + return $this->options [ PostmanOptions::MAIL_LOG_MAX_ENTRIES ]; + } else { return self::DEFAULT_MAIL_LOG_ENTRIES; } + } + public function getTranscriptSize() { + if ( isset( $this->options [ PostmanOptions::TRANSCRIPT_SIZE ] ) ) { + return $this->options [ PostmanOptions::TRANSCRIPT_SIZE ]; + } else { return self::DEFAULT_TRANSCRIPT_SIZE; } + } + + public function getLogLevel() { + if ( isset( $this->options [ PostmanOptions::LOG_LEVEL ] ) ) { + return $this->options [ PostmanOptions::LOG_LEVEL ]; + } else { return self::DEFAULT_LOG_LEVEL; } + } + + public function getNotificationService() { + if ( isset( $this->options [ PostmanOptions::NOTIFICATION_SERVICE ] ) ) { + return $this->options [ PostmanOptions::NOTIFICATION_SERVICE ]; + } else { + return self::DEFAULT_NOTIFICATION_SERVICE; + } + } + + public function getForcedToRecipients() { + if ( isset( $this->options [ self::FORCED_TO_RECIPIENTS ] ) ) { + return $this->options [ self::FORCED_TO_RECIPIENTS ]; } + } + public function getForcedCcRecipients() { + if ( isset( $this->options [ self::FORCED_CC_RECIPIENTS ] ) ) { + return $this->options [ self::FORCED_CC_RECIPIENTS ]; } + } + public function getForcedBccRecipients() { + if ( isset( $this->options [ self::FORCED_BCC_RECIPIENTS ] ) ) { + return $this->options [ self::FORCED_BCC_RECIPIENTS ]; } + } + public function getAdditionalHeaders() { + if ( isset( $this->options [ self::ADDITIONAL_HEADERS ] ) ) { + return $this->options [ self::ADDITIONAL_HEADERS ]; } + } + public function getHostname() { + + if ( $this->is_fallback ) { + return $this->getFallbackHostname(); + } + + if ( isset( $this->options [ PostmanOptions::HOSTNAME ] ) ) { + return $this->options [ PostmanOptions::HOSTNAME ]; } + } + + public function getPort() { + + if ( $this->is_fallback ) { + return $this->getFallbackPort(); + } + + if ( isset( $this->options [ PostmanOptions::PORT ] ) ) { + return $this->options [ PostmanOptions::PORT ]; } + } + + public function getEnvelopeSender() { + + if ( $this->is_fallback ) { + return $this->getFallbackFromEmail(); + } + + if ( isset( $this->options [ PostmanOptions::ENVELOPE_SENDER ] ) ) { + return $this->options [ PostmanOptions::ENVELOPE_SENDER ]; } + } + + public function getMessageSenderEmail() { + + if ( $this->is_fallback ) { + return $this->getFallbackFromEmail(); + } + + if ( isset( $this->options [ PostmanOptions::MESSAGE_SENDER_EMAIL ] ) ) { + return $this->options [ PostmanOptions::MESSAGE_SENDER_EMAIL ]; } + } + + public function getFallbackFromEmail() { + if ( isset( $this->options [ PostmanOptions::FALLBACK_FROM_EMAIL ] ) ) { + return $this->options [ PostmanOptions::FALLBACK_FROM_EMAIL ]; } + } + + public function getMessageSenderName() { + if ( isset( $this->options [ PostmanOptions::MESSAGE_SENDER_NAME ] ) ) { + return $this->options [ PostmanOptions::MESSAGE_SENDER_NAME ]; } + } + public function getClientId() { + if ( isset( $this->options [ PostmanOptions::CLIENT_ID ] ) ) { + return $this->options [ PostmanOptions::CLIENT_ID ]; } + } + public function getClientSecret() { + if ( isset( $this->options [ PostmanOptions::CLIENT_SECRET ] ) ) { + return $this->options [ PostmanOptions::CLIENT_SECRET ]; } + } + + public function getTransportType() { + + if ( $this->is_fallback ) { + return 'smtp'; + } + + if ( isset( $this->options [ PostmanOptions::TRANSPORT_TYPE ] ) ) { + return $this->options [ PostmanOptions::TRANSPORT_TYPE ]; } + } + + public function getAuthenticationType() { + + if ( $this->is_fallback ) { + return $this->getFallbackAuth(); + } + + if ( isset( $this->options [ PostmanOptions::AUTHENTICATION_TYPE ] ) ) { + return $this->options [ PostmanOptions::AUTHENTICATION_TYPE ]; } + } + + public function getEncryptionType() { + + if ( $this->is_fallback ) { + return $this->getFallbackSecurity(); + } + + + if ( isset( $this->options [ PostmanOptions::SECURITY_TYPE ] ) ) { + return $this->options [ PostmanOptions::SECURITY_TYPE ]; + } + } + + public function getUsername() { + + if ( $this->is_fallback ) { + return $this->getFallbackUsername(); + } + + if ( defined( 'POST_SMTP_AUTH_USERNAME' ) ) { + return POST_SMTP_AUTH_USERNAME; + } + + if ( isset( $this->options [ PostmanOptions::BASIC_AUTH_USERNAME ] ) ) { + return $this->options [ PostmanOptions::BASIC_AUTH_USERNAME ]; + } + } + + public function getPassword() { + + if ( $this->is_fallback ) { + return $this->getFallbackPassword(); + } + + if ( defined( 'POST_SMTP_AUTH_PASSWORD' ) ) { + return POST_SMTP_AUTH_PASSWORD; + } + + if ( isset( $this->options [ PostmanOptions::BASIC_AUTH_PASSWORD ] ) ) { + return base64_decode( $this->options [ PostmanOptions::BASIC_AUTH_PASSWORD ] ); + } + } + + // Fallback + public function getFallbackIsEnabled() { + if ( isset( $this->options [ PostmanOptions::FALLBACK_SMTP_ENABLED ] ) ) { + return $this->options [ PostmanOptions::FALLBACK_SMTP_ENABLED ]; + } + return false; + } + + public function getFallbackHostname() { + if ( isset( $this->options [ PostmanOptions::FALLBACK_SMTP_HOSTNAME ] ) ) { + return $this->options [ PostmanOptions::FALLBACK_SMTP_HOSTNAME ]; + } + } + + public function getFallbackPort() { + if ( isset( $this->options [ PostmanOptions::FALLBACK_SMTP_PORT ] ) ) { + return $this->options [ PostmanOptions::FALLBACK_SMTP_PORT ]; + } + } + + public function getFallbackSecurity() { + if ( isset( $this->options [ PostmanOptions::FALLBACK_SMTP_SECURITY ] ) ) { + return $this->options [ PostmanOptions::FALLBACK_SMTP_SECURITY ]; + } + } + + public function getFallbackAuth() { + if ( isset( $this->options [ PostmanOptions::FALLBACK_SMTP_USE_AUTH ] ) ) { + return $this->options [ PostmanOptions::FALLBACK_SMTP_USE_AUTH ]; + } + } + + public function getFallbackUsername() { + if ( defined( 'POST_SMTP_FALLBACK_AUTH_USERNAME' ) ) { + return POST_SMTP_FALLBACK_AUTH_USERNAME; + } + + if ( isset( $this->options [ PostmanOptions::FALLBACK_SMTP_USERNAME ] ) ) { + return $this->options [ PostmanOptions::FALLBACK_SMTP_USERNAME ]; + } + } + + + public function getFallbackPassword() { + if ( defined( 'POST_SMTP_FALLBACK_AUTH_PASSWORD' ) ) { + return POST_SMTP_FALLBACK_AUTH_PASSWORD; + } + + if ( isset( $this->options [ PostmanOptions::FALLBACK_SMTP_PASSWORD ] ) ) { + return base64_decode( $this->options [ PostmanOptions::FALLBACK_SMTP_PASSWORD ] ); + } + } + + // End Fallback + + public function getMandrillApiKey() { + if ( defined( 'POST_SMTP_API_KEY' ) ) { + return POST_SMTP_API_KEY; + } + + if ( isset( $this->options [ PostmanOptions::MANDRILL_API_KEY ] ) ) { + return base64_decode( $this->options [ PostmanOptions::MANDRILL_API_KEY ] ); } + } + public function getSendGridApiKey() { + if ( defined( 'POST_SMTP_API_KEY' ) ) { + return POST_SMTP_API_KEY; + } + + if ( isset( $this->options [ PostmanOptions::SENDGRID_API_KEY ] ) ) { + return base64_decode( $this->options [ PostmanOptions::SENDGRID_API_KEY ] ); } + } + public function getMailgunApiKey() { + if ( defined( 'POST_SMTP_API_KEY' ) ) { + return POST_SMTP_API_KEY; + } + + if ( isset( $this->options [ PostmanOptions::MAILGUN_API_KEY ] ) ) { + return base64_decode( $this->options [ PostmanOptions::MAILGUN_API_KEY ] ); } + } + public function getMailgunDomainName() { + if ( isset( $this->options [ PostmanOptions::MAILGUN_DOMAIN_NAME ] ) ) { + return $this->options [ PostmanOptions::MAILGUN_DOMAIN_NAME ]; + } + } + + public function getMailgunRegion() { + if ( isset( $this->options [ PostmanOptions::MAILGUN_REGION ] ) ) { + return $this->options [ PostmanOptions::MAILGUN_REGION ]; + } + } + + public function getPushoverUser() { + if ( isset( $this->options [ PostmanOptions::PUSHOVER_USER ] ) ) { + return base64_decode( $this->options [ PostmanOptions::PUSHOVER_USER ] ); + } + } + + public function getPushoverToken() { + if ( isset( $this->options [ PostmanOptions::PUSHOVER_TOKEN ] ) ) { + return base64_decode( $this->options [ PostmanOptions::PUSHOVER_TOKEN ] ); + } + } + + public function getSlackToken() { + if ( isset( $this->options [ PostmanOptions::SLACK_TOKEN ] ) ) { + return base64_decode( $this->options [ PostmanOptions::SLACK_TOKEN ] ); + } + } + + public function useChromeExtension() { + if ( isset( $this->options [ PostmanOptions::NOTIFICATION_USE_CHROME ] ) ) { + return $this->options [ PostmanOptions::NOTIFICATION_USE_CHROME ]; + } + } + + public function getNotificationChromeUid() { + if ( isset( $this->options [ PostmanOptions::NOTIFICATION_CHROME_UID ] ) ) { + return base64_decode( $this->options [ PostmanOptions::NOTIFICATION_CHROME_UID ] ); + } + } + + public function getReplyTo() { + if ( isset( $this->options [ PostmanOptions::REPLY_TO ] ) ) { + return $this->options [ PostmanOptions::REPLY_TO ]; } + } + public function getConnectionTimeout() { + if ( ! empty( $this->options [ self::CONNECTION_TIMEOUT ] ) ) { + return $this->options [ self::CONNECTION_TIMEOUT ]; + } else { return self::DEFAULT_TCP_CONNECTION_TIMEOUT; } + } + public function getReadTimeout() { + if ( ! empty( $this->options [ self::READ_TIMEOUT ] ) ) { + return $this->options [ self::READ_TIMEOUT ]; + } else { return self::DEFAULT_TCP_READ_TIMEOUT; } + } + public function isPluginSenderNameEnforced() { + if ( $this->isNew() ) { + return self::DEFAULT_PLUGIN_MESSAGE_SENDER_NAME_ENFORCED; } + if ( isset( $this->options [ PostmanOptions::PREVENT_MESSAGE_SENDER_NAME_OVERRIDE ] ) ) { + return $this->options [ PostmanOptions::PREVENT_MESSAGE_SENDER_NAME_OVERRIDE ]; } + } + + public function isEmailValidationDisabled() { + if ( isset( $this->options [ PostmanOptions::DISABLE_EMAIL_VALIDAITON ] ) ) { + return $this->options [ PostmanOptions::DISABLE_EMAIL_VALIDAITON ]; } + } + + /** + * (non-PHPdoc) + * + * @see PostmanOptions::isSenderNameOverridePrevented() + * @deprecated by isPluginSenderNameEnforced + */ + public function isSenderNameOverridePrevented() { + return $this->isPluginSenderEmailEnforced(); + } + public function isPluginSenderEmailEnforced() { + + if ( $this->isNew() ) { + return self::DEFAULT_PLUGIN_MESSAGE_SENDER_EMAIL_ENFORCED; } + if ( isset( $this->options [ PostmanOptions::PREVENT_MESSAGE_SENDER_EMAIL_OVERRIDE ] ) ) { + return $this->options [ PostmanOptions::PREVENT_MESSAGE_SENDER_EMAIL_OVERRIDE ]; } + } + /** + * + * @deprecated by isPluginSenderEmailEnforced + */ + public function isSenderEmailOverridePrevented() { + return $this->isPluginSenderEmailEnforced(); + } + private function setSenderEmail( $senderEmail ) { + $this->options [ PostmanOptions::MESSAGE_SENDER_EMAIL ] = $senderEmail; + } + public function setMessageSenderEmailIfEmpty( $senderEmail ) { + if ( empty( $this->options [ PostmanOptions::MESSAGE_SENDER_EMAIL ] ) ) { + $this->setSenderEmail( $senderEmail ); + } + } + private function setSenderName( $senderName ) { + $this->options [ PostmanOptions::MESSAGE_SENDER_NAME ] = $senderName; + } + public function setMessageSenderNameIfEmpty( $senderName ) { + if ( empty( $this->options [ PostmanOptions::MESSAGE_SENDER_NAME ] ) ) { + $this->setSenderName( $senderName ); + } + } + + public function getSmtpMailer() { + if ( empty($this->options [ 'smtp_mailers' ]) ) { + return 'postsmtp'; + } + + return $this->options [ 'smtp_mailers' ]; + } + + public function isAuthTypePassword() { + return $this->isAuthTypeLogin() || $this->isAuthTypeCrammd5() || $this->isAuthTypePlain(); + } + public function isAuthTypeOAuth2() { + return PostmanOptions::AUTHENTICATION_TYPE_OAUTH2 == $this->getAuthenticationType(); + } + public function isAuthTypeLogin() { + return PostmanOptions::AUTHENTICATION_TYPE_LOGIN == $this->getAuthenticationType(); + } + public function isAuthTypePlain() { + return PostmanOptions::AUTHENTICATION_TYPE_PLAIN == $this->getAuthenticationType(); + } + public function isAuthTypeCrammd5() { + return PostmanOptions::AUTHENTICATION_TYPE_CRAMMD5 == $this->getAuthenticationType(); + } + public function isAuthTypeNone() { + return PostmanOptions::AUTHENTICATION_TYPE_NONE == $this->getAuthenticationType(); + } + /** + * + * @deprecated Required by the Postman Gmail Extension + * + * @see PostmanOptionsInterface::getSenderEmail() + */ + public function getSenderEmail() { + return $this->getMessageSenderEmail(); + } + /** + * + * @deprecated Required by the Postman Gmail Extension + * + * @see PostmanOptionsInterface::getSenderEmail() + */ + public function getSenderName() { + return $this->getMessageSenderName(); + } + + /** + * + * @return string + */ + public function export() { + if ( PostmanPreRequisitesCheck::checkZlibEncode() ) { + $data = $this->options; + $data ['version'] = PostmanState::getInstance()->getVersion(); + foreach ( PostmanTransportRegistry::getInstance()->getTransports() as $transport ) { + $data = $transport->prepareOptionsForExport( $data ); + } + $data = base64_encode( gzcompress( json_encode( $data ), 9 ) ); + return $data; + } + } + + /** + * + * @param mixed $data + */ + public function import( $data ) { + if ( PostmanPreRequisitesCheck::checkZlibEncode() ) { + $logger = new PostmanLogger( get_class( $this ) ); + $logger->debug( 'Importing Settings' ); + $base64 = $data; + $logger->trace( $base64 ); + $gz = base64_decode( $base64 ); + $logger->trace( $gz ); + $json = @gzuncompress( $gz ); + $logger->trace( $json ); + if ( ! empty( $json ) ) { + $data = json_decode( $json, true ); + $logger->trace( $data ); + { + // overwrite the current version with the version from the imported options + // this way database upgrading can occur + $postmanState = get_option( 'postman_state' ); + $postmanState ['version'] = $data ['version']; + $logger->trace( sprintf( 'Setting Postman version to %s', $postmanState ['version'] ) ); + assert( $postmanState ['version'] == $data ['version'] ); + update_option( 'postman_state', $postmanState ); + } + $this->options = $data; + $logger->info( 'Imported data' ); + $this->save(); + return true; + } else { + $logger->error( 'Could not import data - data error' ); + return false; + } + } + } + } +} diff --git a/Postman/PostmanPluginFeedback.php b/Postman/PostmanPluginFeedback.php new file mode 100644 index 0000000..95ea06f --- /dev/null +++ b/Postman/PostmanPluginFeedback.php @@ -0,0 +1,157 @@ + admin_url( 'admin-ajax.php' ) ) ); + wp_enqueue_script( 'post-feedback' ); + } + + function post_user_feedback() { + if ( ! check_ajax_referer() ) { + die( 'security error' ); + } + + $payload = array( + 'reason' => sanitize_text_field( $_POST['reason'] ), + 'other_input' => isset( $_POST['other_input'] ) ? sanitize_text_field( $_POST['other_input'] ) : '', + ); + + if ( isset( $_POST['support'] ) ) { + $payload['support']['email'] = sanitize_email( $_POST['support']['email'] ); + $payload['support']['title'] = sanitize_text_field( $_POST['support']['title'] ); + $payload['support']['text'] = sanitize_textarea_field( $_POST['support']['text'] ); + } + + $args = array( + 'body' => $payload, + 'timeout' => 20, + ); + $result = wp_remote_post( 'https://postmansmtp.com/feedback', $args ); + die( 'success' ); + } + + function admin_head() { + ?> + + + + x,ready=>true|false,required=true|false] + */ + public static function getState() { + $state = array (); + array_push ( $state, array ( + 'name' => 'iconv', + 'ready' => self::checkIconv (), + 'required' => true + ) ); + array_push ( $state, array ( + 'name' => 'spl_autoload', + 'ready' => self::checkSpl (), + 'required' => true + ) ); + array_push ( $state, array ( + 'name' => 'openssl', + 'ready' => self::checkOpenSsl (), + 'required' => false + ) ); + array_push ( $state, array ( + 'name' => 'sockets', + 'ready' => self::checkSockets (), + 'required' => false + ) ); + array_push ( $state, array ( + 'name' => 'allow_url_fopen', + 'ready' => self::checkAllowUrlFopen (), + 'required' => false + ) ); + array_push ( $state, array ( + 'name' => 'mcrypt', + 'ready' => self::checkMcrypt (), + 'required' => false + ) ); + array_push ( $state, array ( + 'name' => 'zlib_encode', + 'ready' => self::checkZlibEncode (), + 'required' => false + ) ); + return $state; + } + /** + * + * @return boolean + */ + public static function isReady() { + $states = self::getState (); + foreach ( $states as $state ) { + if ($state ['ready'] == false && $state ['required'] == true) { + return false; + } + } + + return true; + } + } +} \ No newline at end of file diff --git a/Postman/PostmanSession.php b/Postman/PostmanSession.php new file mode 100644 index 0000000..f1128b4 --- /dev/null +++ b/Postman/PostmanSession.php @@ -0,0 +1,95 @@ +logger = new PostmanLogger(get_class($this)); + $this->load(); + } + // + public function save() { + update_option ( self::SLUG, $this->options ); + } + public function reload() { + $this->load (); + } + private function load() { + $this->options = get_option ( self::SLUG ); + } + /** + * Shows the review feature of Postman up to thirty days after install + * + * @return boolean + */ + public function isTimeToReviewPostman() { + if (! empty ( $this->options [self::INSTALL_DATE] )) { + $successful = PostmanState::getInstance ()->getSuccessfulDeliveries () > 0; + $maxTime = $this->options [self::INSTALL_DATE] + self::TOO_LONG_SEC; + return $successful && time () <= $maxTime; + } + } + public function isFileLockingEnabled() { + if (isset ( $this->options [self::FILE_LOCKING_ENABLED] )) + return $this->options [self::FILE_LOCKING_ENABLED]; + else + return false; + } + public function setFileLockingEnabled($enabled) { + $this->options [self::FILE_LOCKING_ENABLED] = $enabled; + $this->save (); + } + public function getVersion() { + if (! empty ( $this->options [self::VERSION] )) { + return $this->options [self::VERSION]; + } + } + function getSuccessfulDeliveries() { + if (isset ( $this->options [PostmanState::DELIVERY_SUCCESS_TOTAL] )) + return $this->options [PostmanState::DELIVERY_SUCCESS_TOTAL]; + else + return 0; + } + function setSuccessfulDelivery($total) { + $this->options [PostmanState::DELIVERY_SUCCESS_TOTAL] = $total; + } + function incrementSuccessfulDelivery() { + $this->setSuccessfulDelivery ( $this->getSuccessfulDeliveries () + 1 ); + $this->logger->debug ( 'incrementing success count: ' . $this->getSuccessfulDeliveries () ); + $this->save (); + } + function getFailedDeliveries() { + if (isset ( $this->options [PostmanState::DELIVERY_FAILURE_TOTAL] )) + return $this->options [PostmanState::DELIVERY_FAILURE_TOTAL]; + else + return 0; + } + function setFailedDelivery($total) { + $this->options [PostmanState::DELIVERY_FAILURE_TOTAL] = $total; + } + function incrementFailedDelivery() { + $this->setFailedDelivery ( $this->getFailedDeliveries () + 1 ); + $this->logger->debug ( 'incrementing failure count: ' . $this->getFailedDeliveries () ); + $this->save (); + } + } +} \ No newline at end of file diff --git a/Postman/PostmanUtils.php b/Postman/PostmanUtils.php new file mode 100644 index 0000000..6f628ec --- /dev/null +++ b/Postman/PostmanUtils.php @@ -0,0 +1,482 @@ + PostmanOptions::getInstance()->getConnectionTimeout(), + 'headers' => $headers, + 'body' => $parameters, + ); + if ( PostmanUtils::$logger->isTrace() ) { + PostmanUtils::$logger->trace( sprintf( 'Posting to %s', $url ) ); + PostmanUtils::$logger->trace( 'Post header:' ); + PostmanUtils::$logger->trace( $headers ); + PostmanUtils::$logger->trace( 'Posting args:' ); + PostmanUtils::$logger->trace( $parameters ); + } + $response = wp_remote_post( $url, $args ); + + // pre-process the response + if ( is_wp_error( $response ) ) { + PostmanUtils::$logger->error( $response->get_error_message() ); + throw new Exception( 'Error executing wp_remote_post: ' . $response->get_error_message() ); + } else { + return $response; + } + } + /** + * A facade function that handles redirects. + * Inside WordPress we can use wp_redirect(). Outside WordPress, not so much. **Load it before postman-core.php** + * + * @param mixed $url + */ + static function redirect( $url ) { + // redirections back to THIS SITE should always be relative because of IIS bug + if ( PostmanUtils::$logger->isTrace() ) { + PostmanUtils::$logger->trace( sprintf( "Redirecting to '%s'", $url ) ); + } + wp_redirect( $url ); + exit(); + } + static function parseBoolean( $var ) { + return filter_var( $var, FILTER_VALIDATE_BOOLEAN ); + } + static function logMemoryUse( $startingMemory, $description ) { + PostmanUtils::$logger->trace( sprintf( $description . ' memory used: %s', PostmanUtils::roundBytes( memory_get_usage() - $startingMemory ) ) ); + } + + /** + * Rounds the bytes returned from memory_get_usage to smaller amounts used IEC binary prefixes + * See http://en.wikipedia.org/wiki/Binary_prefix + * + * @param mixed $size + * @return string + */ + static function roundBytes( $size ) { + $unit = array( + 'B', + 'KiB', + 'MiB', + 'GiB', + 'TiB', + 'PiB', + ); + return @round( $size / pow( 1024, ($i = floor( log( $size, 1024 ) )) ), 2 ) . ' ' . $unit [ $i ]; + } + + /** + * Unblock threads waiting on lock() + */ + static function unlock() { + if ( PostmanState::getInstance()->isFileLockingEnabled() ) { + PostmanUtils::deleteLockFile(); + } + } + + /** + * Processes will block on this method until unlock() is called + * Inspired by http://cubicspot.blogspot.ca/2010/10/forget-flock-and-system-v-semaphores.html + * + * @throws Exception + */ + static function lock() { + if ( PostmanState::getInstance()->isFileLockingEnabled() ) { + $attempts = 0; + while ( true ) { + // create the semaphore + $lock = PostmanUtils::createLockFile(); + if ( $lock ) { + // if we got the lock, return + return; + } else { + $attempts ++; + if ( $attempts >= 10 ) { + throw new Exception( sprintf( 'Could not create lockfile %s', '/tmp' . '/.postman.lock' ) ); + } + sleep( 1 ); + } + } + } + } + + static function lockFileExists() { + $path = PostmanUtils::calculateTemporaryLockPath( null ); + + return file_exists($path); + } + + static function deleteLockFile( $tempDirectory = null ) { + $path = PostmanUtils::calculateTemporaryLockPath( $tempDirectory ); + $success = @unlink( $path ); + if ( PostmanUtils::$logger->isTrace() ) { + PostmanUtils::$logger->trace( sprintf( 'Deleting file %s : %s', $path, $success ) ); + } + return $success; + } + static function createLockFile( $tempDirectory = null ) { + if ( self::lockFileExists() ) { + self::deleteLockFile(); + } + $path = PostmanUtils::calculateTemporaryLockPath( $tempDirectory ); + $success = @fopen( $path, 'xb' ); + if ( PostmanUtils::$logger->isTrace() ) { + PostmanUtils::$logger->trace( sprintf( 'Creating file %s : %s', $path, $success ) ); + } + return $success; + } + + /** + * Creates the pathname of the lockfile + * + * @param mixed $tempDirectory + * @return string + */ + private static function calculateTemporaryLockPath( $tempDirectory ) { + if ( empty( $tempDirectory ) ) { + $options = PostmanOptions::getInstance(); + $tempDirectory = $options->getTempDirectory(); + } + $fullPath = sprintf( '%s/.postman_%s.lock', $tempDirectory, self::generateUniqueLockKey() ); + return $fullPath; + } + + /** + * + * @return string + */ + private static function generateUniqueLockKey() { + // for single sites, use the network_site_url to generate the key because + // it is unique for every wordpress site unlike the blog ID which may be the same + $key = hash( 'crc32', network_site_url( '/' ) ); + // TODO for multisites + // if the subsite is sharing the config - use the network_site_url of site 0 + // if the subsite has its own config - use the network_site_url of the subsite + return $key; + } + + /** + * From http://stackoverflow.com/a/381275/4368109 + * + * @param mixed $text + * @return boolean + */ + public static function isEmpty( $text ) { + // Function for basic field validation (present and neither empty nor only white space + return ( ! isset( $text ) || trim( $text ) === ''); + } + + /** + * Warning! This can only be called on hook 'init' or later + */ + public static function isAdmin() { + /** + * is_admin() will return false when trying to access wp-login.php. + * is_admin() will return true when trying to make an ajax request. + * is_admin() will return true for calls to load-scripts.php and load-styles.php. + * is_admin() is not intended to be used for security checks. It will return true + * whenever the current URL is for a page on the admin side of WordPress. It does + * not check if the user is logged in, nor if the user even has access to the page + * being requested. It is a convenience function for plugins and themes to use for + * various purposes, but it is not suitable for validating secured requests. + * + * Good to know. + */ + $logger = PostmanUtils::$logger = new PostmanLogger( 'PostmanUtils' ); + if ( $logger->isTrace() ) { + $logger->trace( 'calling current_user_can' ); + } + return current_user_can( Postman::MANAGE_POSTMAN_CAPABILITY_NAME ) && is_admin(); + } + + /** + * Validate an e-mail address + * + * @param mixed $email + * @return string|bool + */ + static function validateEmail( $email ) { + if ( PostmanOptions::getInstance()->isEmailValidationDisabled() ) { + return true; + } + require_once 'Postman-Mail/Zend-1.12.10/Exception.php'; + require_once 'Postman-Mail/Zend-1.12.10/Registry.php'; + require_once 'Postman-Mail/Zend-1.12.10/Validate/Exception.php'; + require_once 'Postman-Mail/Zend-1.12.10/Validate/Interface.php'; + require_once 'Postman-Mail/Zend-1.12.10/Validate/Abstract.php'; + require_once 'Postman-Mail/Zend-1.12.10/Validate/Ip.php'; + require_once 'Postman-Mail/Zend-1.12.10/Validate/Hostname.php'; + require_once 'Postman-Mail/Zend-1.12.10/Validate/EmailAddress.php'; + if ( ! isset( PostmanUtils::$emailValidator ) ) { + PostmanUtils::$emailValidator = new Postman_Zend_Validate_EmailAddress(); + } + if ( strpos( $email, ',' ) !== false ) { + $emails = explode(',', $email); + $result = []; + foreach ( $emails as $email ) { + $result[] = PostmanUtils::$emailValidator->isValid( $email ); + } + + return ! in_array(false, $result ); + } + return PostmanUtils::$emailValidator->isValid( $email ); + } + + /** + * From http://stackoverflow.com/questions/13430120/str-getcsv-alternative-for-older-php-version-gives-me-an-empty-array-at-the-e + * + * @param mixed $string + * @return multitype: + */ + static function postman_strgetcsv_impl( $string ) { + $fh = fopen( 'php://temp', 'r+' ); + fwrite( $fh, $string ); + rewind( $fh ); + + $row = fgetcsv( $fh ); + + fclose( $fh ); + return $row; + } + + /** + * + * @return string|mixed + */ + static function postmanGetServerName() { + if ( ! empty( $_SERVER ['SERVER_NAME'] ) ) { + $serverName = sanitize_text_field($_SERVER ['SERVER_NAME']); + } else if ( ! empty( $_SERVER ['HTTP_HOST'] ) ) { + $serverName = sanitize_text_field($_SERVER ['HTTP_HOST']); + } else { + $serverName = 'localhost.localdomain'; + } + return $serverName; + } + + /** + * Does this hostname belong to Google? + * + * @param mixed $hostname + * @return boolean + */ + static function isGoogle( $hostname ) { + return PostmanUtils::endsWith( $hostname, 'gmail.com' ) || PostmanUtils::endsWith( $hostname, 'googleapis.com' ); + } + + /** + * + * @param mixed $actionName + * @param mixed $callbackName + */ + public static function registerAdminMenu( $viewController, $callbackName ) { + $logger = PostmanUtils::$logger; + if ( $logger->isTrace() ) { + $logger->trace( 'Registering admin menu ' . $callbackName ); + } + + add_action( 'admin_menu', array( + $viewController, + $callbackName, + ) ); + } + + /** + * + * @param mixed $actionName + * @param mixed $callbackName + */ + public static function registerAjaxHandler( $actionName, $class, $callbackName ) { + + if ( is_admin() ) { + $fullname = 'wp_ajax_' . $actionName; + // $this->logger->debug ( 'Registering ' . 'wp_ajax_' . $fullname . ' Ajax handler' ); + add_action( $fullname, array( + $class, + $callbackName, + ) ); + } + } + + /** + * + * @param mixed $parameterName + * @return mixed + */ + public static function getBooleanRequestParameter( $parameterName ) { + return filter_var( self::getRequestParameter( $parameterName ), FILTER_VALIDATE_BOOLEAN ); + } + + /** + * + * @param mixed $parameterName + * @return mixed + */ + public static function getRequestParameter( $parameterName ) { + $logger = PostmanUtils::$logger; + if ( isset( $_POST [ $parameterName ] ) ) { + $value = filter_var( $_POST [ $parameterName ], FILTER_SANITIZE_STRING ); + if ( $logger->isTrace() ) { + $logger->trace( sprintf( 'Found parameter "%s"', $parameterName ) ); + $logger->trace( $value ); + } + return $value; + } + } + + public static function getServerName() { + $host = 'localhost'; + + if (isset($_SERVER) and array_key_exists('SERVER_NAME', $_SERVER)) { + $host = $_SERVER['SERVER_NAME']; + } elseif (function_exists('gethostname') and gethostname() !== false) { + $host = gethostname(); + } elseif (php_uname('n') !== false) { + $host = php_uname('n'); + } + + return str_replace('www.', '', $host ); + } + + public static function getHost( $url ) { + $host = parse_url( trim( $url ), PHP_URL_HOST ); + + return str_replace('www.', '', $host ); + } +} +PostmanUtils::staticInit(); diff --git a/Postman/PostmanViewController.php b/Postman/PostmanViewController.php new file mode 100644 index 0000000..dfd4207 --- /dev/null +++ b/Postman/PostmanViewController.php @@ -0,0 +1,390 @@ +options = $options; + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->authorizationToken = $authorizationToken; + $this->oauthScribe = $oauthScribe; + $this->adminController = $adminController; + $this->logger = new PostmanLogger( get_class( $this ) ); + PostmanUtils::registerAdminMenu( $this, 'generateDefaultContent' ); + PostmanUtils::registerAdminMenu( $this, 'addPurgeDataSubmenu' ); + + // initialize the scripts, stylesheets and form fields + add_action( 'admin_init', array( $this, 'registerStylesAndScripts' ), 0 ); + add_action( 'wp_ajax_delete_lock_file', array( $this, 'delete_lock_file' ) ); + add_action( 'wp_ajax_dismiss_version_notify', array( $this, 'dismiss_version_notify' ) ); + add_action( 'wp_ajax_dismiss_donation_notify', array( $this, 'dismiss_donation_notify' ) ); + + //add_action( 'admin_init', array( $this, 'do_activation_redirect' ) ); + + } + + + function dismiss_version_notify() { + check_admin_referer( 'postsmtp', 'security' ); + + $result = update_option('postman_release_version', true ); + } + + function dismiss_donation_notify() { + check_admin_referer( 'postsmtp', 'security' ); + + $result = update_option('postman_dismiss_donation', true ); + } + + function delete_lock_file() { + check_admin_referer( 'postman', 'security' ); + + if ( ! PostmanUtils::lockFileExists() ) { + echo __('No lock file found.', 'post-smtp' ); + die(); + } + + echo PostmanUtils::deleteLockFile() == true ? __('Success, try to send test email.', 'post-smtp' ) : __('Failed, try again.', 'post-smtp' ); + die(); + } + + function do_activation_redirect() { + + // Bail if no activation redirect + if ( ! get_transient( '_post_activation_redirect' ) ) { + return; + } + + // Delete the redirect transient + delete_transient( '_post_activation_redirect' ); + + // Bail if activating from network, or bulk + if ( is_network_admin() || isset( $_GET['activate-multi'] ) ) { + return; + } + + // Bail if the current user cannot see the about page + if ( ! current_user_can( 'manage_options' ) ) { + return; + } + + // Redirect to bbPress about page + wp_safe_redirect( add_query_arg( array( 'page' => 'post-about' ), admin_url( 'index.php' ) ) ); + } + + public static function getPageUrl( $slug ) { + return PostmanUtils::getPageUrl( $slug ); + } + + /** + * Add options page + */ + public function generateDefaultContent() { + // This page will be under "Settings" + $pageTitle = sprintf( __( '%s Setup', 'post-smtp' ), __( 'Post SMTP', 'post-smtp' ) ); + $pluginName = __( 'Post SMTP', 'post-smtp' ); + $uniqueId = self::POSTMAN_MENU_SLUG; + $pageOptions = array( + $this, + 'outputDefaultContent', + ); + $mainPostmanSettingsPage = add_menu_page( $pageTitle, $pluginName, Postman::MANAGE_POSTMAN_CAPABILITY_NAME, $uniqueId, $pageOptions ); + // When the plugin options page is loaded, also load the stylesheet + add_action( 'admin_print_styles-' . $mainPostmanSettingsPage, array( + $this, + 'enqueueHomeScreenStylesheet', + ) ); + } + function enqueueHomeScreenStylesheet() { + wp_enqueue_style( PostmanViewController::POSTMAN_STYLE ); + wp_enqueue_script( PostmanViewController::POSTMAN_SCRIPT ); + } + + /** + * Register the Email Test screen + */ + public function addPurgeDataSubmenu() { + $page = add_submenu_page( null, sprintf( __( '%s Setup', 'post-smtp' ), __( 'Post SMTP', 'post-smtp' ) ), __( 'Post SMTP', 'post-smtp' ), Postman::MANAGE_POSTMAN_CAPABILITY_NAME, PostmanAdminController::MANAGE_OPTIONS_PAGE_SLUG, array( + $this, + 'outputPurgeDataContent', + ) ); + // When the plugin options page is loaded, also load the stylesheet + add_action( 'admin_print_styles-' . $page, array( + $this, + 'enqueueHomeScreenStylesheet', + ) ); + } + + /** + * Register and add settings + */ + public function registerStylesAndScripts() { + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'registerStylesAndScripts()' ); + } + // register the stylesheet and javascript external resources + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + wp_register_style( PostmanViewController::POSTMAN_STYLE, plugins_url( 'style/postman.css', $this->rootPluginFilenameAndPath ), null, $pluginData ['version'] ); + wp_register_style( 'jquery_ui_style', plugins_url( 'style/jquery-steps/jquery-ui.css', $this->rootPluginFilenameAndPath ), PostmanViewController::POSTMAN_STYLE, '1.1.0' ); + wp_register_style( 'jquery_steps_style', plugins_url( 'style/jquery-steps/jquery.steps.css', $this->rootPluginFilenameAndPath ), PostmanViewController::POSTMAN_STYLE, '1.1.0' ); + + wp_register_script( PostmanViewController::POSTMAN_SCRIPT, plugins_url( 'script/postman.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + 'jquery-ui-core', + 'jquery-ui-datepicker', + ), $pluginData ['version'] ); + wp_register_script( 'sprintf', plugins_url( 'script/sprintf/sprintf.min.js', $this->rootPluginFilenameAndPath ), null, '1.0.2' ); + wp_register_script( 'jquery_steps_script', plugins_url( 'script/jquery-steps/jquery.steps.min.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT + ), '1.1.0' ); + wp_register_script( 'jquery_validation', plugins_url( 'script/jquery-validate/jquery.validate.min.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT + ), '1.13.1' ); + + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_ajax_msg', array( + 'bad_response' => __( 'An unexpected error occurred', 'post-smtp' ), + 'corrupt_response' => __( 'Unexpected PHP messages corrupted the Ajax response', 'post-smtp' ), + ) ); + + wp_localize_script( 'jquery_steps_script', 'steps_current_step', 'steps_current_step' ); + wp_localize_script( 'jquery_steps_script', 'steps_pagination', 'steps_pagination' ); + wp_localize_script( 'jquery_steps_script', 'steps_finish', _x( 'Finish', 'Press this button to Finish this task', 'post-smtp' ) ); + wp_localize_script( 'jquery_steps_script', 'steps_next', _x( 'Next', 'Press this button to go to the next step', 'post-smtp' ) ); + wp_localize_script( 'jquery_steps_script', 'steps_previous', _x( 'Previous', 'Press this button to go to the previous step', 'post-smtp' ) ); + wp_localize_script( 'jquery_steps_script', 'steps_loading', 'steps_loading' ); + } + + /** + * Options page callback + */ + public function outputDefaultContent() { + // Set class property + print '
    '; + $this->displayTopNavigation(); + if ( ! PostmanPreRequisitesCheck::isReady() ) { + printf( '

    %s

    ', __( 'Postman is unable to run. Email delivery is being handled by WordPress (or another plugin).', 'post-smtp' ) ); + } else { + $ready_messsage = PostmanTransportRegistry::getInstance()->getReadyMessage(); + $statusMessage = $ready_messsage['message']; + if ( PostmanTransportRegistry::getInstance()->getActiveTransport()->isConfiguredAndReady() ) { + if ( $this->options->getRunMode() != PostmanOptions::RUN_MODE_PRODUCTION ) { + printf( '

    %s

    ', $statusMessage ); + } else { + printf( '

    %s

    ', $statusMessage ); + } + } else { + printf( '

    %s

    ', $statusMessage ); + } + $this->printDeliveryDetails(); + /* translators: where %d is the number of emails delivered */ + print '

    '; + printf( _n( 'Postman has delivered %d email.', 'Postman has delivered %d emails.', PostmanState::getInstance()->getSuccessfulDeliveries(), 'post-smtp' ), PostmanState::getInstance()->getSuccessfulDeliveries() ); + if ( $this->options->isMailLoggingEnabled() ) { + print ' '; + printf( __( 'The last %d email attempts are recorded in the log.', 'post-smtp' ), PostmanOptions::getInstance()->getMailLoggingMaxEntries(), PostmanUtils::getEmailLogPageUrl() ); + } + print '

    '; + } + if ( $this->options->isNew() ) { + printf( '

    %s

    ', __( 'Thank-you for choosing Postman!', 'post-smtp' ) ); + /* translators: where %s is the URL of the Setup Wizard */ + printf( '

    %s

    ', sprintf( __( 'Let\'s get started! All users are strongly encouraged to run the Setup Wizard.', 'post-smtp' ), $this->getPageUrl( PostmanConfigurationController::CONFIGURATION_WIZARD_SLUG ) ) ); + printf( '

    %s

    ', sprintf( __( 'Alternately, manually configure your own settings and/or modify advanced options.', 'post-smtp' ), $this->getPageUrl( PostmanConfigurationController::CONFIGURATION_SLUG ) ) ); + } else { + if ( PostmanState::getInstance()->isTimeToReviewPostman() && ! PostmanOptions::getInstance()->isNew() ) { + print '

    '; + /* translators: where %s is the URL to the WordPress.org review and ratings page */ + printf( '%s

    ', sprintf( __( 'Please consider leaving a review to help spread the word! :D', 'post-smtp' ), 'https://wordpress.org/support/view/plugin-reviews/post-smtp?filter=5' ) ); + } + printf( '

    %s :-)

    ', sprintf( __( 'Postman needs translators! Please take a moment to translate a few sentences on-line', 'post-smtp' ), 'https://translate.wordpress.org/projects/wp-plugins/post-smtp/stable' ) ); + } + printf( + '

    %s %s

    ', + __( 'New for v1.9.8! Fallback - setup a second delivery method when the first one is failing', 'post-smtp' ), + 'https://postmansmtp.com/post-smtp-1-9-7-the-smtp-fallback/', + __( 'Check the detailes here', 'post-smtp') + ); + } + + /** + */ + private function printDeliveryDetails() { + $currentTransport = PostmanTransportRegistry::getInstance()->getActiveTransport(); + $deliveryDetails = $currentTransport->getDeliveryDetails( $this->options ); + printf( '

    %s

    ', $deliveryDetails ); + } + + /** + * + * @param mixed $title + * @param string $slug + */ + public static function outputChildPageHeader( $title, $slug = '' ) { + printf( '

    %s

    ', sprintf( __( '%s Setup', 'post-smtp' ), __( 'Post SMTP', 'post-smtp' ) ) ); + printf( '
    ', $slug ); + print '
    '; + print '
    '; + print '
    '; + printf( '

    %s

    ', $title ); + print '
    '; + printf( '

    %s %s

    ', self::BACK_ARROW_SYMBOL, PostmanUtils::getSettingsPageUrl(), _x( 'Back To Main Menu', 'Return to main menu link', 'post-smtp' ) ); + print '
    '; + } + + /** + */ + public function outputPurgeDataContent() { + $importTitle = __( 'Import', 'post-smtp' ); + $exportTile = __( 'Export', 'post-smtp' ); + $resetTitle = __( 'Reset Plugin', 'post-smtp' ); + $options = $this->options; + print '
    '; + PostmanViewController::outputChildPageHeader( sprintf( '%s/%s/%s', $importTitle, $exportTile, $resetTitle ) ); + print '
    '; + printf( '

    %s

    ', $exportTile ); + printf( '

    %s

    ', __( 'Copy this data into another instance of Postman to duplicate the configuration.', 'post-smtp' ) ); + $data = ''; + if ( ! PostmanPreRequisitesCheck::checkZlibEncode() ) { + $extraDeleteButtonAttributes = sprintf( 'disabled="true"' ); + $data = ''; + } else { + $extraDeleteButtonAttributes = ''; + if ( ! $options->isNew() ) { + $data = $options->export(); + } + } + printf( '', $extraDeleteButtonAttributes, $data ); + print '
    '; + print '
    '; + printf( '

    %s

    ', $importTitle ); + print '
    '; + wp_nonce_field( PostmanAdminController::IMPORT_SETTINGS_SLUG ); + printf( '', PostmanAdminController::IMPORT_SETTINGS_SLUG ); + print '

    '; + printf( '%s', __( 'Paste data from another instance of Postman here to duplicate the configuration.', 'post-smtp' ) ); + if ( PostmanTransportRegistry::getInstance()->getSelectedTransport()->isOAuthUsed( PostmanOptions::getInstance()->getAuthenticationType() ) ) { + $warning = __( 'Warning', 'post-smtp' ); + $errorMessage = __( 'Using the same OAuth 2.0 Client ID and Client Secret from this site at the same time as another site will cause failures.', 'post-smtp' ); + printf( ' %s: %s', $warning, $errorMessage ); + } + print '

    '; + printf( '', $extraDeleteButtonAttributes ); + submit_button( __( 'Import', 'post-smtp' ), 'primary', 'import', true, $extraDeleteButtonAttributes ); + print '
    '; + print '
    '; + print '
    '; + printf( '

    %s

    ', $resetTitle ); + print '
    '; + wp_nonce_field( PostmanAdminController::PURGE_DATA_SLUG ); + printf( '', PostmanAdminController::PURGE_DATA_SLUG ); + printf( '

    %s

    %s

    ', __( 'This will purge all of Postman\'s settings, including account credentials and the email log.', 'post-smtp' ), __( 'Are you sure?', 'post-smtp' ) ); + $extraDeleteButtonAttributes = 'style="background-color:red;color:white"'; + if ( $this->options->isNew() ) { + $extraDeleteButtonAttributes .= ' disabled="true"'; + } + submit_button( $resetTitle, 'delete', 'submit', true, $extraDeleteButtonAttributes ); + print '
    '; + print '
    '; + print '
    '; + } + + /** + */ + private function displayTopNavigation() { + $version = PostmanState::getInstance()->getVersion(); + $show = get_option('postman_release_version' ); + printf( '

    %s

    ', sprintf( __( '%s Setup', 'post-smtp' ), __( 'Post SMTP', 'post-smtp' ) ) ); + + if ( ! $show && POST_SMTP_SHOW_RELEASE_MESSAGE ) { + echo ' +
    +

    + Version ' . $version . ' ' . POST_SMTP_RELEASE_MESSAGE . ': Read Here +

    + +
    '; + } + + include_once POST_SMTP_PATH . '/Postman/extra/donation.php'; + + echo ' + logger = new PostmanLogger( get_class( $this ) ); + require_once 'Postman-Mail/PostmanMessage.php'; + require_once 'Postman-Email-Log/PostmanEmailLogService.php'; + require_once 'Postman-Mail/PostmanMailEngine.php'; + require_once 'Postman-Auth/PostmanAuthenticationManagerFactory.php'; + require_once 'PostmanState.php'; + } + + /** + * This methods follows the wp_mail function interface, but implements it Postman-style. + * Exceptions are held for later inspection. + * An instance of PostmanState updates the success/fail tally. + * + * @param mixed $to + * @param mixed $subject + * @param mixed $body + * @param mixed $headers + * @param mixed $attachments + * @return boolean + */ + public function send( $to, $subject, $message, $headers = '', $attachments = array() ) { + + // initialize for sending + $this->init(); + + // build the message + $postmanMessage = $this->processWpMailCall( $to, $subject, $message, $headers, $attachments ); + + // build the email log entry + $log = new PostmanEmailLog(); + $log->originalTo = $to; + $log->originalSubject = $subject; + $log->originalMessage = $message; + $log->originalHeaders = $headers; + + // send the message and return the result + return $this->sendMessage( $postmanMessage, $log ); + } + + /** + * @param PostmanMessage $message + * @return PostmanMessage + */ + private function apply_default_headers( $message ) { + $headers[] = 'Message-ID: ' . $this->createMessageId(); + $message->addHeaders($headers); + } + + /** + * Creates the Message-ID + * + * @return string + */ + public function createMessageId() { + + $id = md5(uniqid(time())); + + if (isset($_SERVER["SERVER_NAME"])) { + $hostName = sanitize_text_field($_SERVER["SERVER_NAME"]); + } else { + $hostName = php_uname('n'); + } + + return $id . '@' . str_replace('www.', '', $hostName); + + } + + /** + * Builds a PostmanMessage based on the WordPress wp_mail parameters + * + * @param mixed $to + * @param mixed $subject + * @param mixed $message + * @param mixed $headers + * @param mixed $attachments + */ + private function processWpMailCall( $to, $subject, $message, $headers, $attachments ) { + $this->logger->trace( 'wp_mail parameters before applying WordPress wp_mail filter:' ); + $this->traceParameters( $to, $subject, $message, $headers, $attachments ); + + /** + * Filter the wp_mail() arguments. + * + * @since 1.5.4 + * + * @param array $args + * A compacted array of wp_mail() arguments, including the "to" email, + * subject, message, headers, and attachments values. + */ + $atts = apply_filters( 'wp_mail', compact( 'to', 'subject', 'message', 'headers', 'attachments' ) ); + if ( isset( $atts ['to'] ) ) { + $to = $atts ['to']; + } + + if ( isset( $atts ['subject'] ) ) { + $subject = $atts ['subject']; + } + + if ( isset( $atts ['message'] ) ) { + $message = $atts ['message']; + } + + if ( isset( $atts ['headers'] ) ) { + $headers = $atts ['headers']; + } + + if ( isset( $atts ['attachments'] ) ) { + $attachments = $atts ['attachments']; + } + + if ( ! is_array( $attachments ) ) { + $attachments = explode( "\n", str_replace( "\r\n", "\n", $attachments ) ); + } + + $this->logger->trace( 'wp_mail parameters after applying WordPress wp_mail filter:' ); + $this->traceParameters( $to, $subject, $message, $headers, $attachments ); + + // Postman API: register the response hook + add_filter( 'postman_wp_mail_result', array( + $this, + 'postman_wp_mail_result', + ) ); + + // create the message + $postmanMessage = $this->createNewMessage(); + $this->populateMessageFromWpMailParams( $postmanMessage, $to, $subject, $message, $headers, $attachments ); + + // return the message + return $postmanMessage; + } + + /** + * Creates a new instance of PostmanMessage with a pre-set From and Reply-To + * + * @return PostmanMessage + */ + public function createNewMessage() { + $message = new PostmanMessage(); + $options = PostmanOptions::getInstance(); + // the From is set now so that it can be overridden + $transport = PostmanTransportRegistry::getInstance()->getActiveTransport(); + $message->setFrom( $transport->getFromEmailAddress(), $transport->getFromName() ); + // the Reply-To is set now so that it can be overridden + $message->setReplyTo( $options->getReplyTo() ); + $message->setCharset( get_bloginfo( 'charset' ) ); + return $message; + } + + /** + * A convenient place for any code to inject a constructed PostmanMessage + * (for example, from MyMail) + * + * The body parts may be set already at this time. + * + * @param PostmanMessage $message + * @return boolean + */ + public function sendMessage( PostmanMessage $message, PostmanEmailLog $log ) { + + $this->apply_default_headers( $message ); + + // get the Options and AuthToken + $options = PostmanOptions::getInstance(); + $authorizationToken = PostmanOAuthToken::getInstance(); + + // get the transport and create the transportConfig and engine + $transport = PostmanTransportRegistry::getInstance()->getActiveTransport(); + + // create the Mail Engine + $engine = $transport->createMailEngine(); + + // add plugin-specific attributes to PostmanMessage + $message->addHeaders( $options->getAdditionalHeaders() ); + $message->addTo( $options->getForcedToRecipients() ); + $message->addCc( $options->getForcedCcRecipients() ); + $message->addBcc( $options->getForcedBccRecipients() ); + + // apply the WordPress filters + // may impact the from address, from email, charset and content-type + $message->applyFilters(); + //do_action_ref_array( 'phpmailer_init', array( &$message ) ); + + // create the body parts (if they are both missing) + if ( $message->isBodyPartsEmpty() ) { + $message->createBodyParts(); + } + + // is this a test run? + $testMode = apply_filters( 'postman_test_email', false ); + if ( $this->logger->isDebug() ) { + $this->logger->debug( 'testMode=' . $testMode ); + } + + // start the clock + $startTime = microtime( true ) * 1000; + + try { + + // prepare the message + $message->validate( $transport ); + + // send the message + if ( $options->getRunMode() == PostmanOptions::RUN_MODE_PRODUCTION ) { + if ( $transport->isLockingRequired() ) { + PostmanUtils::lock(); + // may throw an exception attempting to contact the OAuth2 provider + $this->ensureAuthtokenIsUpdated( $transport, $options, $authorizationToken ); + } + + $this->logger->debug( 'Sending mail' ); + // may throw an exception attempting to contact the SMTP server + $engine->send( $message ); + + // increment the success counter, unless we are just tesitng + if ( ! $testMode ) { + PostmanState::getInstance()->incrementSuccessfulDelivery(); + } + } + + // clean up + $this->postSend( $engine, $startTime, $options, $transport ); + + if ( $options->getRunMode() == PostmanOptions::RUN_MODE_PRODUCTION || $options->getRunMode() == PostmanOptions::RUN_MODE_LOG_ONLY ) { + // log the successful delivery + PostmanEmailLogService::getInstance()->writeSuccessLog( $log, $message, $engine->getTranscript(), $transport ); + } + + // return successful + return true; + } catch ( Exception $e ) { + // save the error for later + $this->exception = $e; + + // write the error to the PHP log + $this->logger->error( get_class( $e ) . ' code=' . $e->getCode() . ' message=' . trim( $e->getMessage() ) ); + + // increment the failure counter, unless we are just tesitng + if ( ! $testMode && $options->getRunMode() == PostmanOptions::RUN_MODE_PRODUCTION ) { + PostmanState::getInstance()->incrementFailedDelivery(); + } + + // clean up + $this->postSend( $engine, $startTime, $options, $transport ); + + if ( $options->getRunMode() == PostmanOptions::RUN_MODE_PRODUCTION || $options->getRunMode() == PostmanOptions::RUN_MODE_LOG_ONLY ) { + // log the failed delivery + PostmanEmailLogService::getInstance()->writeFailureLog( $log, $message, $engine->getTranscript(), $transport, $e->getMessage() ); + } + + // Fallback + if ( $this->fallback( $log, $message, $options ) ) { + + return true; + + } + + $mail_error_data = array( + 'to' => $message->getToRecipients(), + 'subject' => $message->getSubject(), + 'message' => $message->getBody(), + 'headers' => $message->getHeaders(), + 'attachments' => $message->getAttachments() + ); + $mail_error_data['phpmailer_exception_code'] = $e->getCode(); + + do_action( 'wp_mail_failed', new WP_Error( 'wp_mail_failed', $e->getMessage(), $mail_error_data ) ); + + // return failure + if ( PostmanOptions::getInstance()->getSmtpMailer() == 'phpmailer' ) { + throw new phpmailerException($e->getMessage(), $e->getCode()); + } + return false; + + } + } + + private function fallback( $log, $postMessage,$options ) { + + if ( ! $options->is_fallback && $options->getFallbackIsEnabled() && $options->getFallbackIsEnabled() == 'yes' ) { + + $options->is_fallback = true; + + $status = $this->sendMessage( $postMessage, $log ); + + $options->is_fallback = false; + + return $status; + + } else { + $options->is_fallback = false; + } + + return false; + } + + /** + * Clean up after sending the mail + * + * @param PostmanZendMailEngine $engine + * @param mixed $startTime + */ + private function postSend( PostmanMailEngine $engine, $startTime, PostmanOptions $options, PostmanModuleTransport $transport ) { + // save the transcript + $this->transcript = $engine->getTranscript(); + + // log the transcript + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'Transcript:' ); + $this->logger->trace( $this->transcript ); + } + + // delete the semaphore + if ( $transport->isLockingRequired() ) { + PostmanUtils::unlock(); + } + + // stop the clock + $endTime = microtime( true ) * 1000; + $this->totalTime = $endTime - $startTime; + } + + /** + * Returns the result of the last call to send() + * + * @return multitype:Exception NULL + */ + function postman_wp_mail_result() { + $result = array( + 'time' => $this->totalTime, + 'exception' => $this->exception, + 'transcript' => $this->transcript, + ); + return $result; + } + + /** + */ + private function ensureAuthtokenIsUpdated( PostmanModuleTransport $transport, PostmanOptions $options, PostmanOAuthToken $authorizationToken ) { + assert( ! empty( $transport ) ); + assert( ! empty( $options ) ); + assert( ! empty( $authorizationToken ) ); + // ensure the token is up-to-date + $this->logger->debug( 'Ensuring Access Token is up-to-date' ); + // interact with the Authentication Manager + $wpMailAuthManager = PostmanAuthenticationManagerFactory::getInstance()->createAuthenticationManager(); + if ( $wpMailAuthManager->isAccessTokenExpired() ) { + $this->logger->debug( 'Access Token has expired, attempting refresh' ); + $wpMailAuthManager->refreshToken(); + $authorizationToken->save(); + } + } + + /** + * Aggregates all the content into a Message to be sent to the MailEngine + * + * @param mixed $to + * @param mixed $subject + * @param mixed $body + * @param mixed $headers + * @param mixed $attachments + */ + private function populateMessageFromWpMailParams( PostmanMessage $message, $to, $subject, $body, $headers, $attachments ) { + $message->addHeaders( $headers ); + $message->setBody( $body ); + $message->setSubject( $subject ); + $message->addTo( $to ); + $message->setAttachments( $attachments ); + return $message; + } + + /** + * Trace the parameters to aid in debugging + * + * @param mixed $to + * @param mixed $subject + * @param mixed $body + * @param mixed $headers + * @param mixed $attachments + */ + private function traceParameters( $to, $subject, $message, $headers, $attachments ) { + $this->logger->trace( 'to:' ); + $this->logger->trace( $to ); + $this->logger->trace( 'subject:' ); + $this->logger->trace( $subject ); + $this->logger->trace( 'headers:' ); + $this->logger->trace( $headers ); + $this->logger->trace( 'attachments:' ); + $this->logger->trace( $attachments ); + $this->logger->trace( 'message:' ); + $this->logger->trace( $message ); + } + } +} diff --git a/Postman/PostmanWpMailBinder.php b/Postman/PostmanWpMailBinder.php new file mode 100644 index 0000000..575e1bb --- /dev/null +++ b/Postman/PostmanWpMailBinder.php @@ -0,0 +1,131 @@ +logger = new PostmanLogger ( get_class ( $this ) ); + + // load the dependencies + require_once 'PostmanWpMail.php'; + require_once 'PostmanOptions.php'; + require_once 'PostmanPreRequisitesCheck.php'; + + // register the bind status hook + add_filter ( 'postman_wp_mail_bind_status', array ( + $this, + 'postman_wp_mail_bind_status' + ) ); + } + + /** + * Return the Singleton instance + * + * @return PostmanWpMailBinder + */ + public static function getInstance() { + static $inst = null; + if ($inst === null) { + $inst = new PostmanWpMailBinder (); + } + return $inst; + } + + /** + * Returns the bind result + */ + public function postman_wp_mail_bind_status() { + $result = array ( + 'bound' => $this->bound, + 'bind_error' => $this->bindError + ); + return $result; + } + + /** + * Important: bind() may be called multiple times + * + * Replace wp_mail() after making sure: + * 1) the plugin has not already bound to wp_mail and + * 2) wp_mail is available for use + * 3) the plugin is properly configured. + * 4) the plugin's prerequisites are met. + */ + function bind() { + if (! $this->bound) { + $ready = true; + if (function_exists ( 'wp_mail' )) { + // If the function exists, it's probably because another plugin has + // replaced the pluggable function first, and we set an error flag. + // this is an error message because it is a Bind error + if ($this->logger->isTrace ()) { + $this->logger->trace ( 'wp_mail is already bound, Postman can not use it' ); + } + $this->bindError = true; + $ready = false; + } + if (! PostmanPreRequisitesCheck::isReady ()) { + // this is a debug message because it is not up to the Binder to report transport errors + if ($this->logger->isTrace ()) { + $this->logger->trace ( 'Prerequisite check failed' ); + } + $ready = false; + } + if ($ready) { + if ($this->logger->isTrace ()) { + $this->logger->trace ( 'Binding to wp_mail()' ); + } + $this->replacePluggableFunctionWpMail (); + } + } + } + + /** + * The code to replace the pluggable wp_mail() + * + * If the function does not exist, then the replacement was successful + * and we set a success flag. + */ + private function replacePluggableFunctionWpMail() { + /** + * The Postman drop-in replacement for the WordPress wp_mail() function + * + * @param string|array $to + * Array or comma-separated list of email addresses to send message. + * @param string $subject + * Email subject + * @param string $message + * Message contents + * @param string|array $headers + * Optional. Additional headers. + * @param string|array $attachments + * Optional. Files to attach. + * @return bool Whether the email contents were sent successfully. + */ + function wp_mail($to, $subject, $message, $headers = '', $attachments = array()) { + // create an instance of PostmanWpMail to send the message + $postmanWpMail = new PostmanWpMail (); + // send the mail + $result = $postmanWpMail->send ( $to, $subject, $message, $headers, $attachments ); + // return the result + return $result; + } + $this->logger->debug ( 'Bound to wp_mail()' ); + $this->bound = true; + } + public function isBound() { + return $this->bound; + } + public function isUnboundDueToException() { + return $this->bindError; + } + } +} \ No newline at end of file diff --git a/Postman/extra/donation.php b/Postman/extra/donation.php new file mode 100644 index 0000000..61fc3a9 --- /dev/null +++ b/Postman/extra/donation.php @@ -0,0 +1,19 @@ + +
    +

    It is hard to continue development and support for this free plugin without contributions from users like you.
    + If you enjoy using Post SMTP and find it useful, please consider making a donation.
    + Your donation will help encourage and support the plugin's continued development and better user support.

    +
    + + + + +
    + +
    + \ No newline at end of file diff --git a/Postman/extra/no-localhost-mails.php b/Postman/extra/no-localhost-mails.php new file mode 100644 index 0000000..0c45778 --- /dev/null +++ b/Postman/extra/no-localhost-mails.php @@ -0,0 +1,9 @@ +not let you send from an email address other than the one you authenticate with." +msgstr "Παρακαλούμε σημειώστε ότι για να αποφύγουν την κατάχρηση, πολλές υπηρεσίες e-mail δεν θα σας αφήσουν να αποστείλετε από διεύθυνση διαφορετική από αυτή με την οποία πιστοποιήστε (συνδέεστε)." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:317 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:49 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:112 +msgid "Email Address" +msgstr "Διεύθυνση e-mail" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:320 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:59 +msgid "Name" +msgstr "Όνομα" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:325 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:143 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:331 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:542 +msgid "Outgoing Mail Server Hostname" +msgstr "Όνομα Διακομιστή Εξερχόμενης Αλληλογραφίας" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:333 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:138 +#: Postman/PostmanViewController.php:294 +msgid "Connectivity Test" +msgstr "Τεστ Συνδεσιμότητας" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:335 +msgid "How will the connection to the mail server be established?" +msgstr "Πως θα γίνει η σύνδεση με τον MSA;" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:336 +msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows." +msgstr "Οι ρυθμίσεις της σύνδεσής σας εξαρτώνται από το τι προσφέρει ο πάροχος υπηρεσιών αλληλογραφίας και τι επιτρέπει ο πάροχος του WordPress σας." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +msgctxt "TCP Port Test Status" +msgid "Ready" +msgstr "Έτοιμο" + +#. Translators: Where %1$s is the socket identifier and %2$s is the +#. authentication type +#: Postman/Postman-Configuration/PostmanConfigurationController.php:345 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgctxt "A socket is the network term for host and port together" +msgid "Socket" +msgstr "Socket" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:346 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:354 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:223 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:177 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:351 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:356 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:372 +msgid "Authentication" +msgstr "Πιστοποίηση" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:349 +msgid "This configuration option will send your authorization credentials in the clear." +msgstr "Αυτή η επιλογή θα στείλει τα στοιχεία σύνδεσής σας χωρίς κρυπτογράφηση." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:356 +msgid "How will you prove your identity to the mail server?" +msgstr "Πως θα αποδείξετε την ταυτότητά σας στον MSA;" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:363 +msgctxt "The final step of the Wizard" +msgid "Finish" +msgstr "Τέλος" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:365 +msgctxt "Wizard Step Title" +msgid "You're Done!" +msgstr "Είστε Έτοιμοι!" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:367 +msgid "Click Finish to save these settings, then:" +msgstr "Κάντε κλικ στο Τέλος για να αποθηκεύσετε αυτές τις ρυθμίσεις, μετά:" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:369 +msgid "Grant permission with the Email Provider for Postman to send email and" +msgstr "Δώστε άδεια μέσω του παρόχου e-mail στο Postman να στέλνει μηνύματα και" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:370 +msgid "Send yourself a Test Email to make sure everything is working!" +msgstr "Στείλτε ένα Δοκιμαστικό Μήνυμα στον εαυτό σας για να βεβαιωθείτε ότι όλα δουλεύουν!" + +#. translators: where %s is the URL to the Connectivity Test page +#: Postman/Postman-Configuration/PostmanConfigurationController.php:514 +msgid "Postman can't find any way to send mail on your system. Run a connectivity test." +msgstr "Το Postman δεν μπορεί να εντοπίσει κάποιο τρόπο αποστολής ηλ. ταχυδρομείου στο σύστημά σας. Κάντε ένα τεστ συνδεσιμότητας." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:33 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Transport" +msgstr "Μέθοδος αποστολής" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:38 +msgctxt "(i.e.) What kind is it?" +msgid "Type" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:44 +msgctxt "The Message Sender Email Address" +msgid "From Address" +msgstr "Ηλ. Διεύθυνση Μηνύματος Από" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:70 +msgid "Additional Email Addresses" +msgstr "Επιπλέον διευθύνσεις e-mail" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:75 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:220 +msgid "Reply-To" +msgstr "Απάντηση σε" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:80 +msgid "To Recipient(s)" +msgstr "Παραλήπτης(ες)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:85 +msgid "Carbon Copy Recipient(s)" +msgstr "Κοινοποίηση σε" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:90 +msgid "Blind Carbon Copy Recipient(s)" +msgstr "Κρυφή Κοινοποίηση σε" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:96 +msgid "Additional Headers" +msgstr "Επιπλέον Κεφαλίδες" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:101 +msgid "Custom Headers" +msgstr "Προσαρμοσμένες Κεφαλίδες" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:107 +msgid "Validation" +msgstr "Επικύρωση" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:118 +msgid "Email Log Settings" +msgstr "Ρυθμίσεις Καταγραφής E-mail" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:123 +msgid "Enable Logging" +msgstr "Ενεργοποίηση Καταγραφής" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:128 +#: Postman/PostmanInputSanitizer.php:137 +msgid "Maximum Log Entries" +msgstr "Μέγιστος Αριθμός Καταχωρήσεων Καταγραφής" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:133 +msgid "Maximum Transcript Size" +msgstr "Μέγιστος Αριθμός Γραμμών σε μια Μεταγραφή" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:139 +msgid "Network Settings" +msgstr "Ρυθμίσεις Δικτύου" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:144 +msgctxt "Configuration Input Field" +msgid "TCP Connection Timeout (sec)" +msgstr "Λήξη χρονικού ορίου σύνδεσης TCP (sec)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:149 +msgctxt "Configuration Input Field" +msgid "TCP Read Timeout (sec)" +msgstr "Λήξη χρονικού ορίου ανάγνωσης TCP (sec)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:155 +msgctxt "Configuration Section Title" +msgid "Miscellaneous Settings" +msgstr "Διάφορες Ρυθμίσεις" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:160 +msgctxt "Configuration Input Field" +msgid "PHP Log Level" +msgstr "Επίπεδο Καταγραφής PHP" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:165 +msgctxt "Configuration Input Field" +msgid "Delivery Mode" +msgstr "Τρόπος Παράδοσης" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:170 +msgctxt "This mode removes the Postman X-Mailer signature from emails" +msgid "Stealth Mode" +msgstr "Με απόκρυψη" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:175 +msgid "Temporary Directory" +msgstr "Προσωρινός Κατάλογος" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:186 +msgid "Choose SMTP or a vendor-specific API:" +msgstr "Επιλέξτε SMTP ή API συγκεκριμένου παρόχου:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:189 +msgid "Configure the delivery audit log:" +msgstr "Διαμορφώστε την καταγραφή αξιολόγησης παράδοσης:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:196 +msgid "This address, like the letterhead printed on a letter, identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Other plugins, especially Contact Forms, may override this field to be your visitor's address." +msgstr "Η διεύθυνση Μήνυμα Από είναι αυτή που βλέπει ο παραλήπτης ως αποστολέα. Αλλάξτε τη όταν στέλνετε εκ μέρους κάποιου άλλου, παραδείγματος χάριν για να χρησιμοποιήσετε τη δυνατότητα Αποστολή Αλληλογραιας Ως της Google. Τα θέματα και άλλα πρόσθετα επιτρέπεται να τροποποιούν αυτό το πεδίο." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:203 +msgid "Separate multiple to/cc/bcc recipients with commas." +msgstr "Διαχωρίστε πολλαπλούς παραλήπτεςπρος/κοιν./κρυφ.κοιν. με κόμματα." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:210 +msgid "Increase the timeouts if your host is intermittenly failing to send mail. Be careful, this also correlates to how long your user must wait if the mail server is unreachable." +msgstr "Αυξήστε τα χρονικά όρια λήξης αν ο διακομιστής σας αποτυγχάνει κατά περιόδους να αποστείλει αλληλογραφία. Προσέξτε όμως, αυτό επίσης σχετίζεται και με το πόσο χρόνο θα πρέπει να περιμένει ο χρήστης σας αν ο διακομιστής δεν αποκρίνεται." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:221 +msgid "Specify custom headers (e.g. X-MC-Tags: wordpress-site-A), one per line. Use custom headers with caution as they can negatively affect your Spam score." +msgstr "Καθορίστε προσαρμοσμένες κεφαλίδες (π.χ. X-MC-Tags: wordpress-site-A), μία σε κάθε γραμμή. Χρησιμοποιήστε τις με προσοχή καθώς μπορεί να επηρεάσουν αρνητικά την Spam βαθμολογία σας." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:228 +msgid "E-mail addresses can be validated before sending e-mail, however this may fail with some newer domains." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:254 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:276 +msgid "Prevent plugins and themes from changing this" +msgstr "Απαγορεύστε σε πρόσθετα και θέματα να το αλλάζουν αυτό" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:261 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:405 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:244 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:195 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:409 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:416 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:459 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:467 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:475 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:482 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:530 +msgid "Required" +msgstr "Απαιτούμενα" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:268 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:531 +msgid "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +msgstr "Η διεύθυνση Φάκελος Από αφορά τον κάτοχο του λογαριασμού στον διακομιστή SMTP." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:289 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:108 +msgid "Yes" +msgstr "Ναι" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:290 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:109 +msgid "No" +msgstr "Όχι" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:300 +msgid "Change this value if you can't see the beginning of the transcript because your messages are too big." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:343 +msgid "Disable e-mail validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:350 +msgid "Log Level specifies the level of detail written to the WordPress Debug log - view the log with Debug." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:353 +msgid "Off" +msgstr "Κλείσιμο" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:354 +msgid "Trace" +msgstr "Ανίχνευση" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:355 +msgid "Debug" +msgstr "Εύρεση σφαλμάτων" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:356 +msgid "Info" +msgstr "Πληροφορίες" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:358 +msgid "Error" +msgstr "Σφάλμα" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:366 +msgid "Delivery mode offers options useful for developing or testing." +msgstr "Η κατάσταση Παράδοση προσφέρει επιλογές χρήσιμες για ανάπτυξη ή δοκιμές." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:369 +msgctxt "When the server is online to the public, this is \"Production\" mode" +msgid "Log Email and Send" +msgstr "Καταγραφή E-mail και Αποστολή" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:370 +msgid "Log Email and Delete" +msgstr "Καταγραφή Email και Διαγραφή" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:371 +msgid "Delete All Emails" +msgstr "Διαγραφή Όλων των E-mail" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:375 +msgid "Remove the Postman X-Header signature from messages" +msgstr "Αφαίρεση της υπογραφής Postman X-Header από τα μηνύματα" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:378 +msgid "Lockfiles are written here to prevent users from triggering an OAuth 2.0 token refresh at the same time." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:381 +msgid "Valid" +msgstr "Έγκυρο" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:383 +msgid "Invalid" +msgstr "Άκυρο" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:105 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:109 +msgctxt "The \"please wait\" message" +msgid "Checking.." +msgstr "Γίνεται έλεγχος.." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:106 +msgctxt "The port is open" +msgid "Open" +msgstr "Ανοιχτή" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:107 +msgctxt "The port is closed" +msgid "Closed" +msgstr "Κλειστή" + +#. translators: where %d is a port number +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:111 +msgid "No outbound route between this site and the Internet on Port %d." +msgstr "Δεν υπάρχει εξερχόμενη διαδρομή μεταξύ αυτού του ιστότοπου και του Διαδικτύου στη θύρα %d." + +#. translators: where %d is a port number and %s is a hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:113 +msgid "Port %d is open, but not to %s." +msgstr "Η θύρα %d είναι ανοιχτή αλλά όχι προς %s." + +#. translators: where %d is the port number and %s is the hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:115 +msgid "Port %d can be used for SMTP to %s." +msgstr "Η θύρα %d μπορεί να χρησιμοποιηθεί για SMTP προς %s." + +#. translators: where %d is a port number and %s is the URL for the Postman +#. Gmail Extension +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:118 +msgid "Port %d can be used with the %s." +msgstr "Η θύρα %d μπορεί να χρησιμοποιηθεί για αποστολή email με το %s." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:141 +msgid "This test determines which well-known ports are available for Postman to use." +msgstr "Αυτή η δοκιμή βρίσκει ποιες από τις γνωστές θύρες είναι διαθέσιμες για να τις χρησιμοποιήσει το Postman." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:145 +msgctxt "Button Label" +msgid "Begin Test" +msgstr "Έναρξη Δοκιμής" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:162 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:152 +msgid "Status" +msgstr "Κατάσταση" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Service Available" +msgstr "Διαθέσιμη Υπηρεσία" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Server ID" +msgstr "" + +#. Translators: Meaning "Not Applicable" +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:155 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:260 +msgid "n/a" +msgstr "δ/υ" + +#. Translators: Where %s is the name of the service providing Internet +#. connectivity test +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:160 +msgid "According to %s" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:163 +msgid "Summary" +msgstr "Σύνοψη" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:168 +msgid "A test with \"No\" Service Available indicates one or more of these issues:" +msgstr "Θύρα με Διαθέσιμη Υπηρεσία \"Όχι\" υποδεικνύει ένα ή περισσότερα από αυτά τα προβλήματα:" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:170 +msgid "Your web host has placed a firewall between this site and the Internet" +msgstr "Ο πάροχος διακομιστή έχει θέσει ένα firewall μεταξύ αυτού του ιστοτόπου και του Διαδικτύου" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:171 +msgid "The SMTP hostname is wrong or the mail server does not provide service on this port" +msgstr "Το όνομα διακομιστή SMTP είναι λάθος ή ο διακομιστής αλληλογραφίας δεν παρέχει υπηρεσίες σε αυτή τη θύρα" + +#. translators: where (1) is the URL and (2) is the system +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:173 +msgid "Your %2$s configuration is preventing outbound connections" +msgstr "Η διαμόρφωση της %2$s σας εμποδίζει τις εξερχόμενες συνδέσεις" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:177 +msgid "If the issues above can not be resolved, your last option is to configure Postman to use an email account managed by your web host with an SMTP server managed by your web host." +msgstr "Αν τα παραπάνω προβλήματα δεν μπορούν να επιλυθούν, η τελευταία σας επιλογή είναι να ρυθμίσετε το Postman να χρησιμοποιήσει ένα λογαριασμό e-mail που να τον διαχειρίζεται ο πάροχος του διακομιστή διαδικτύου σας με έναν διακομιστή SMTP που να τον χειρίζεται ο πάροχος." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:82 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman.php:317 +msgctxt "The log of Emails that have been delivered" +msgid "Email Log" +msgstr "Αρχείο Καταγραφής e-mail" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:95 +msgid "Error: Postman is missing a required PHP library." +msgstr "Σφάλμα: απουσιάζει μια απαιτούμενη από το Postman βιβλιοθήκη PHP." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:97 +#: Postman/Postman.php:257 +msgid "Postman: wp_mail has been declared by another plugin or theme, so you won't be able to use Postman until the conflict is resolved." +msgstr "Postman: έχει δηλωθεί το wp_mail από άλλο πρόσθετο ή θέμα, έτσι δεν θα μπορέσετε να χρησιμοποιήσετε το Postman μέχρι να λυθεί η διένεξη." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:100 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:229 +msgid "Postman is in non-Production mode and is dumping all emails." +msgstr "Postman είναι σε μη-Παραγωγική κατάσταση και απορρίπτει όλα τα e-mail." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:102 +msgid "Postman is configured and has delivered %d email." +msgid_plural "Postman is configured and has delivered %d emails." +msgstr[0] "Postman is configured and has delivered %d email." +msgstr[1] "Το Postman είναι ρυθμισμένο και έχει παραδώσει %d emails." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:104 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:234 +msgid "Postman is not configured and is mimicking out-of-the-box WordPress email delivery." +msgstr "Το Postman δεν είναι διαμορφωμένο και μιμείται την παράδοση e-mail του WordPress ως έχει." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:116 +msgid "Postman is operating in per-site mode." +msgstr "Το Postman είναι σε κατάσταση λειτουργίας ανά-ιστότοπο." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:102 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:107 +#: Postman/PostmanViewController.php:295 +msgid "Diagnostic Test" +msgstr "Διαγνωστικό Τεστ" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:104 +msgid "Are you having issues with Postman?" +msgstr "Αντιμετωπίζετε προβλήματα με το Postman;" + +#. translators: where %1$s and %2$s are the URLs to the Troubleshooting and +#. Support Forums on WordPress.org +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:106 +msgid "Please check the troubleshooting and error messages page and the support forum." +msgstr "Παρακαλούμε ελέγξτε τη σελίδα αντιμετώπιση προβλημάτων και μηνύματα σφάλματος και το φόρουμ υποστήριξης." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:108 +msgid "If you write for help, please include the following:" +msgstr "Αν ζητήσετε βοήθεια, παρακαλούμε συμπεριλάβετε τα ακόλουθα:" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:90 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:242 +msgid "Your message was delivered (%d ms) to the SMTP server! Congratulations :)" +msgstr "Το μήνυμά σας παραδόθηκε (%d ms) στο διακομιστή SMTP! Συγχαρητήρια :)" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:156 +msgid "Mail Log Entries were deleted." +msgstr "Οι καταχωρήσεις της καταγραφής αλληλογραφίας διαγράφηκαν." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:179 +msgid "Mail Log Entry was deleted." +msgstr "Η καταχώρηση της καταγραφής αλληλογραφίας διαγράφηκε." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:204 +msgctxt "Who is this message From?" +msgid "From" +msgstr "Από" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:208 +msgctxt "Who is this message To?" +msgid "To" +msgstr "Προς" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:212 +msgctxt "Who is this message Cc'd to?" +msgid "Cc" +msgstr "Κοιν." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:216 +msgctxt "Who is this message Bcc'd to?" +msgid "Bcc" +msgstr "Κρυφ. Κοιν." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:222 +msgctxt "What is the date today?" +msgid "Date" +msgstr "Ημερομηνία" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:223 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:161 +msgctxt "What is the subject of this message?" +msgid "Subject" +msgstr "Θέμα" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:226 +msgctxt "What is the unique URI of the configuration?" +msgid "Delivery-URI" +msgstr "URI-Παράδοσης" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:253 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:161 +msgid "This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +msgstr "Αυτή είναι η συζήτηση μεταξύ του Postman και του SMTP διακομιστή σας. Μπορεί να είναι χρήσιμη για διάγνωση προβλημάτων. ΜΗΝ τη δημοσιεύσετε διαδικτυακά, μπορεί να περιέχει τον κωδικό του λογαριασμού σας." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +msgid "%s Email Log" +msgstr "Καταγραφή email του %s" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:301 +msgid "Email was successfully resent (but without attachments)" +msgstr "" + +#. Translators: Where %s is an error message +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:303 +msgid "Email could not be resent. Error: %s" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:304 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:110 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:112 +msgid "Resend" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:339 +msgid "This is a record of deliveries made to the mail server. It does not neccessarily indicate sucessful delivery to the recipient." +msgstr "Αυτό είναι ένα αρχείο παραδόσεων που έγιναν στον Mail Submission Agent (MSA). Δεν σημαίνει απαραίτητα ότι παραδόθηκαν επιτυχώς στον παραλήπτη." + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:37 +msgctxt "The group of Emails that have been delivered" +msgid "Sent Emails" +msgstr "Απεσταλμένα" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:38 +msgctxt "An Email that has been delivered" +msgid "Sent Email" +msgstr "Απεσταλμένο" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +msgid "An empty subject line can result in delivery failure." +msgstr "Προειδοποίηση: Κενή γραμμή θέματος μπορεί να καταλήξει σε αποτυχία παράδοσης." + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:196 +msgid ".. +%d more" +msgstr ".. +%d ακόμη" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:99 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:223 +msgctxt "Delete an item from the email log" +msgid "Delete" +msgstr "Διαγραφή" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:100 +msgctxt "View an item from the email log" +msgid "View" +msgstr "Προβολή" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:104 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:106 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:158 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:163 +msgid "Session Transcript" +msgstr "Μεταγραφή Συνεδρίας" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:163 +msgctxt "When was this email sent?" +msgid "Delivery Time" +msgstr "Χρόνος Παράδοσης" + +#. Translators: where %s indicates the relative time from now +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:332 +msgctxt "A relative time as in \"five days ago\"" +msgid "%s ago" +msgstr "πριν %s" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:338 +msgid "Sent" +msgstr "Απεσταλμένα" + +#: Postman/Postman-Mail/PostmanDefaultModuleTransport.php:107 +msgid "Default" +msgstr "προεπιλογή" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:102 +msgid "Gmail API" +msgstr "Gmail API" + +#. translators: where (1) is the secure icon and (2) is the transport name +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:152 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:135 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:79 +msgid "Postman will send mail via the %1$s %2$s." +msgstr "" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:166 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:117 +msgid "You have configured OAuth 2.0 authentication, but have not received permission to use it." +msgstr "Έχετε ρυθμίσει την πιστοποίηση OAuth 2.0 αλλά δεν έχετε λάβει άδεια να τη χρησιμοποιήσετε." + +#. translators: where variables are (1) transport name (2) host and (3) port +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:206 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:181 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:125 +msgid "Postman recommends the %1$s to host %2$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:221 +#: Postman/Postman-Mail/PostmanModuleTransport.php:713 +msgid "OAuth 2.0 (requires Client ID and Client Secret)" +msgstr "OAuth 2.0 (απαιτεί Client ID και Client Secret)" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:44 +msgid "Mandrill API" +msgstr "Mandrill API" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:147 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:101 +msgid "API Key can not be empty" +msgstr "Το κλειδί API δεν μπορεί να είναι κενό." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:151 +#: Postman/Postman-Mail/PostmanModuleTransport.php:578 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:105 +msgid "Message From Address can not be empty" +msgstr "" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:194 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:228 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:271 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:148 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:182 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:222 +msgid "API Key" +msgstr "Κλειδί API" + +#. Translators: Where (1) is the service URL and (2) is the service name and +#. (3) is a api key URL +#: Postman/Postman-Mail/PostmanMandrillTransport.php:238 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:189 +msgid "Create an account at %2$s and enter an API key below." +msgstr "Δημιουργήστε ένα λογαριασμό στο %2$s και εισάγετε ένα κλειδί API παρακάτω." + +#. translators: where (1) is the transport type, (2) is the host, and (3) is +#. the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 +#. using OAuth 2.0 authentication.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:506 +msgid "Postman will send mail via %1$s to %2$s using %3$s authentication." +msgstr "Το Postman θα στέλνει e-mail μέσω του %1$s στο %2$s με πιστοποίηση %3$s." + +#. translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s +#. is the encryption type (e.g. SSL or TLS) +#: Postman/Postman-Mail/PostmanModuleTransport.php:534 +msgctxt "as in \"There is no Spoon\"" +msgid "no" +msgstr "καμία" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:553 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:366 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:584 +msgid "Password" +msgstr "Κωδικός" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:584 +msgid "OAuth 2.0 authentication requires a %1$s and %2$s." +msgstr "" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:706 +msgid "Password (requires username and password)" +msgstr "Κωδικός (απαιτεί όνομα χρήστη και κωδικό)" + +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 +msgid "MyMail: Change the delivery method in the %s!" +msgstr "" + +#: Postman/Postman-Mail/PostmanSendGridTransport.php:39 +msgid "SendGrid API" +msgstr "SendGrid API" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:95 +msgid "Outgoing Mail Server Hostname and Port can not be empty." +msgstr "Το όνομα του διακομιστή εξερχομένων e-mail και η θύρα δεν μπορεί να είναι κενά." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:99 +msgid "Envelope-From Email Address can not be empty" +msgstr "Η Διεύθυνση Αποστολέα Φακέλου και η Διεύθυνση Αποστολέα Μηνύματος δεν μπορούν να είναι κενές." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:103 +msgid "Username and password can not be empty." +msgstr "Η πιστοποίηση με κωδικό (Απλή/Σύνδεση/CRAM-MD5) απαιτεί όνομα χρήστη και κωδικό." + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:109 +msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server." +msgstr "Η πιστοποίηση OAuth 2.0 απαιτεί ένα υποστηριζόμενο Διακομιστή Εξερχόμενης Αλληλογραφίας με δυνατότητες OAuth 2.0, %1$s και%2$s." + +#. translators: where %1$s is a description of the transport (eg. SMTPS-SSL), +#. %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is +#. the TCP port (eg. 465), %4$d is the hostname +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:269 +msgid "Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:326 +msgid "Transport Settings" +msgstr "Ρυθμίσεις Μεταφοράς" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:336 +msgid "Outgoing Mail Server Port" +msgstr "Θύρα Διακομιστή Εξερχόμενης Αλληλογραφίας" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:341 +msgid "Envelope-From Email Address" +msgstr "Διεύθυνση Αποστολέα Φακέλου" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:346 +msgctxt "Configuration Input Field" +msgid "Security" +msgstr "Ασφάλεια" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:361 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:580 +msgid "Username" +msgstr "Όνομα χρήστη" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:402 +msgid "Configure the communication with the mail server." +msgstr "Διαμορφώστε την επικοινωνία με τον Mail Submission Agent (MSA):" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:449 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:579 +msgid "Enter the account credentials." +msgstr "Εισάγετε τα στοιχεία σας σύνδεσης." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:457 +msgid "The Username is usually the same as the Envelope-From Email Address." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:511 +msgid "Error computing your domain root - please enter it manually" +msgstr "Σφάλμα υπολογισμού του root του τομέα σας - παρακαλούμε βάλτε το χειροκίνητα" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:532 +msgid "For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:539 +msgctxt "Wizard Step Title" +msgid "Which host will relay the mail?" +msgstr "Ποιος διακομιστής θα μεταδώσει το μήνυμα;" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:540 +msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. This server is specific to your email account, and if you don't know what to use, ask your email service provider." +msgstr "Αυτός είναι ο Διακομιστής Εξερχόμενης Αλληλογραφίας (SMTP) ή ο Mail Submission Agent (MSA), στους οποίους το Postman μεταφέρει την παράδοση της αλληλογραφίας. Αυτός ο διακομιστής είναι συγκεκριμένος " + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:541 +msgid "Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, require that you use their mail accounts with their mail servers, and prevent you from using others." +msgstr "Σημειώστε ότι πολλοί πάροχοι WordPress, όπως οι GoDaddy, Bluehost και Dreamhost, απαιτούν να χρησιμοποιήσετε τους δικούς τους λογαριασμούς αλληλογραφίας με τους δικούς τους διακομιστές και εμποδίζουν τη χρήση άλλων." + +#. Translators: Where (%s) is the name of the web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:547 +msgid "Your email address requires access to a remote SMTP server blocked by %s." +msgstr "Η διεύθυνση email σας απαιτεί πρόσβαση σε απομακρυσμένο διακομιστή SMTP που αποκλείεται από το %s." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:548 +msgid "If you have access to cPanel, enable the Remote Mail Exchanger." +msgstr "" + +#. Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the +#. web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:551 +msgid "If you own this domain, make sure it has an SPF record authorizing %2$s as a relay, or you will have delivery problems." +msgstr "Αν σας ανήκει αυτός ο τομέας, βεβαιωθείτε ότι έχει μια καταχώρηση SPF που εξουσιοδοτεί το %2$s ως διαμεσολαβητή αλλιώς θα έχετε προβλήματα παράδοσης." + +#: Postman/Postman-Mail/PostmanTransportRegistry.php:231 +msgid "Postman is configured." +msgstr "Το Postman ρυθμίστηκε." + +#: Postman/Postman-Mail/PostmanZendMailEngine.php:209 +msgid "Communication Error [334] - make sure the Envelope From email is the same account used to create the Client ID." +msgstr "Σφάλμα Επικοινωνίας [334] - βεβαιωθείτε ότι το e-mail στο Φάκελος Από είναι το ίδιο με του λογαριασμού που χρησιμοποιήθηκε για τη δημιουργία του Client ID." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:115 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:149 +msgctxt "Email Test Status" +msgid "In Outbox" +msgstr "Στα Εξερχόμενα" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:116 +msgctxt "Email Test Status" +msgid "Sending..." +msgstr "Αποστολή..." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:117 +msgctxt "Email Test Status" +msgid "Success" +msgstr "Επιτυχής" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:118 +msgctxt "Email Test Status" +msgid "Failed" +msgstr "Απέτυχε" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:119 +msgid "Ajax Error" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:128 +#: Postman/PostmanViewController.php:273 Postman/PostmanViewController.php:275 +msgid "Send a Test Email" +msgstr "Αποστολή Δοκιμαστικού E-mail" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:133 +msgid "Specify the Recipient" +msgstr "Ορίστε τον Παραλήπτη" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:135 +msgid "Who is this message going to?" +msgstr "Σε ποιον πηγαίνει το μήνυμα;" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:136 +msgid "This utility allows you to send an email message for testing." +msgstr "Αυτή η υπηρεσία σας επιτρέπει να στείλετε ένα e-mail για δοκιμή." + +#. translators: where %d is an amount of time, in seconds +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:139 +msgid "If there is a problem, Postman will give up after %d second." +msgid_plural "If there is a problem, Postman will give up after %d seconds." +msgstr[0] "Αν υπάρχει πρόβλημα, το Postman θα εγκαταλείψει μετά από %d δευτερόλεπτο." +msgstr[1] "Αν υπάρχει πρόβλημα, το Postman θα εγκαταλείψει μετά από %d δευτερόλεπτα." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:140 +msgctxt "Configuration Input Field" +msgid "Recipient Email Address" +msgstr "Διεύθυνση e-mail παραλήπτη" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:145 +msgid "Send The Message" +msgstr "Αποστολή Μηνύματος" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:148 +msgid "Sending the message:" +msgstr "Το μήνυμα αποστέλλεται:" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:160 +msgid "Examine the Session Transcript if you need to." +msgstr "Εξετάστε τη Μεταγραφή Συνεδρίας SMTP αν χρειάζεται." + +#. translators: where %s is the domain name of the site +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:212 +msgctxt "Test Email Subject" +msgid "Postman SMTP Test (%s)" +msgstr "Δοκιμή SMTP του Postman (%s)" + +#. translators: where %s is the Postman plugin version number (e.g. 1.4) +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:299 +msgctxt "Test Email Tagline" +msgid "Sent by Postman %s" +msgstr "Στάλθηκε από το Postman %s" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:300 +msgid "Image source" +msgstr "Πηγή εικόνας" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:301 +msgid "Used with permission" +msgstr "Χρήση με άδεια" + +#: Postman/PostmanAdminController.php:111 +msgctxt "The plugin successfully saved new settings." +msgid "Settings saved." +msgstr "Οι ρυθμίσεις αποθηκεύτηκαν." + +#. Translators: where %1$s is the name of the library +#: Postman/PostmanAdminController.php:178 +msgid "This PHP installation requires the %1$s library." +msgstr "Αυτή η εγκατάσταση της PHP απαιτεί τη βιβλιοθήκη %1$s." + +#: Postman/PostmanAdminController.php:253 +msgid "There was an error importing the data." +msgstr "" + +#: Postman/PostmanAdminController.php:270 +msgid "Plugin data was removed." +msgstr "Τα δεδομένα του πρόσθετου αφαιρέθηκαν." + +#: Postman/PostmanAdminController.php:294 +msgid "The OAuth 2.0 authorization was successful. Ready to send e-mail." +msgstr "Η πιστοποίηση OAuth 2.0 ήταν επιτυχής. Έτοιμοι για αποστολή e-mail." + +#: Postman/PostmanAdminController.php:296 +msgid "Your email provider did not grant Postman permission. Try again." +msgstr "Ο πάροχος του email σας δεν έδωσε άδεια στο Postman. Δοκιμάστε ξανά." + +#: Postman/PostmanAdminController.php:299 +msgid "The grant code from Google had no accompanying state and may be a forgery" +msgstr "Ο κώδικας που δόθηκε από τη Google δεν είχε συνοδευτική κατάσταση και μπορεί να είναι πλαστός" + +#. translators: %s is the error message +#: Postman/PostmanAdminController.php:303 +msgid "Error authenticating with this Client ID. [%s]" +msgstr "Σφάλμα πιστοποίησης με αυτό το Client ID. [%s]" + +#: Postman/PostmanConfigTextHelper.php:31 +msgid "Attention" +msgstr "Προσοχή" + +#. translators: parameters available are 1=portal-url, 2=portal-name, +#. 3=clientId-name, 4=clientSecret-name, 5=callbackUrl, 6=service-name, +#. 7=portal-application (e.g. Open the Google Developer Console, create a +#. Client ID for web application using the URL's displayed below, and copy the +#. Client ID and Client Secret here.) +#: Postman/PostmanConfigTextHelper.php:33 +msgid "Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +msgstr "Ανοίξτε το %2$s, δημιουργήστε %7$s με τις τιμές που εμφανίζονται παρακάτω και αντιγράψτε τα παραγόμενα %3$s και %4$s εδώ." + +#. translators: parameters available are 1=clientId-name, 2=service-name, +#. 3=FAQ-URL, 4=Video-URL (e.g. See How do I get a Google Client ID? in the +#. F.A.Q.) +#: Postman/PostmanConfigTextHelper.php:36 +msgid "See How do I get a %1$s %2$s? in the F.A.Q. or watch our How-To video 📺." +msgstr "Δείτε το How do I get a %1$s %2$s? στις F.A.Q. ή παρακολουθήστε το How-To βίντεό μας 📺." + +#. translators: where %s is the Email Service Owner (e.g. Google, Microsoft or +#. Yahoo) +#: Postman/PostmanConfigTextHelper.php:54 +msgctxt "Command to initiate OAuth authentication" +msgid "Grant permission with %s" +msgstr "Δώστε άδεια με %s" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:80 +#: Postman/PostmanConfigTextHelper.php:142 +#: Postman/PostmanConfigTextHelper.php:204 +#: Postman/PostmanConfigTextHelper.php:271 +msgctxt "Name of the OAuth 2.0 Client ID" +msgid "Client ID" +msgstr "Client ID" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:84 +#: Postman/PostmanConfigTextHelper.php:146 +#: Postman/PostmanConfigTextHelper.php:208 +#: Postman/PostmanConfigTextHelper.php:274 +msgctxt "Name of the OAuth 2.0 Client Secret" +msgid "Client Secret" +msgstr "Client Secret" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:88 +msgctxt "Name of the Application Callback URI" +msgid "Authorized redirect URI" +msgstr "URI για εξουσιοδοτημένη ανακατεύθυνση" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:92 +msgctxt "Name of the Application Callback Domain" +msgid "Authorized JavaScript origins" +msgstr "Εξουσιοδοτημένες προελεύσεις Javascript" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:96 +msgctxt "Name of the email service owner" +msgid "Google" +msgstr "Google" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:100 +msgctxt "Name of the email service" +msgid "Gmail" +msgstr "Gmail" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:104 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "a Client ID for web application" +msgstr "ένα Client ID για διαδικτυακή εφαρμογή" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:108 +msgctxt "Name of the email service portal" +msgid "Google Developers Console Gmail Wizard" +msgstr "Google Developers Console Gmail Wizard" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:150 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URL" +msgstr "URL ανακατεύθυνσης" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:154 +msgctxt "Name of the Application Callback Domain" +msgid "Root Domain" +msgstr "Τομέας Root" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:158 +msgctxt "Name of the email service owner" +msgid "Microsoft" +msgstr "Microsoft" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:162 +msgctxt "Name of the email service" +msgid "Outlook.com" +msgstr "Outlook.com" + +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:166 +#: Postman/PostmanConfigTextHelper.php:228 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "an Application" +msgstr "μια Εφαρμογή" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:170 +msgctxt "Name of the email service portal" +msgid "Microsoft Developer Center" +msgstr "Microsoft Developer Center" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:212 +msgctxt "Name of the Application Callback URI" +msgid "Home Page URL" +msgstr "URL Αρχικής Σελίδας" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:216 +msgctxt "Name of the Application Callback Domain" +msgid "Callback Domain" +msgstr "Τομέας Επανάκλησης (Callback)" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:220 +msgctxt "Name of the email service owner" +msgid "Yahoo" +msgstr "Yahoo" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:224 +msgctxt "Name of the email service" +msgid "Yahoo Mail" +msgstr "Yahoo Mail" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:232 +msgctxt "Name of the email service portal" +msgid "Yahoo Developer Network" +msgstr "Yahoo Developer Network" + +#: Postman/PostmanConfigTextHelper.php:261 +msgid "Enter an Outgoing Mail Server with OAuth2 capabilities." +msgstr "Εισάγετε ένα Διακομιστή Εξερχόμενης Αλληλογραφίας που υποστηρίζει OAuth2." + +#: Postman/PostmanConfigTextHelper.php:277 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URI" +msgstr "URI ανακατεύθυνσης" + +#: Postman/PostmanConfigTextHelper.php:280 +msgctxt "Name of the Application Callback Domain" +msgid "Website Domain" +msgstr "Τομέας Ιστότοπου" + +#: Postman/PostmanConfigTextHelper.php:304 +msgid "Grant OAuth 2.0 Permission" +msgstr "Δώστε Άδεια OAuth 2.0" + +#: Postman/PostmanInputSanitizer.php:137 +msgid "must be greater than 0" +msgstr "πρέπει να είναι μεγαλύτερη από 0" + +#: Postman/PostmanViewController.php:112 +msgid "An unexpected error occurred" +msgstr "" + +#: Postman/PostmanViewController.php:113 +msgid "Unexpected PHP messages corrupted the Ajax response" +msgstr "Μη αναμενόμενα μηνύματα PHP αλλοίωσαν την απόκριση του Ajax" + +#: Postman/PostmanViewController.php:118 +msgctxt "Press this button to Finish this task" +msgid "Finish" +msgstr "Τέλος" + +#: Postman/PostmanViewController.php:119 +msgctxt "Press this button to go to the next step" +msgid "Next" +msgstr "Επόμενο" + +#: Postman/PostmanViewController.php:120 +msgctxt "Press this button to go to the previous step" +msgid "Previous" +msgstr "Προηγούμενο" + +#: Postman/PostmanViewController.php:132 +msgid "Postman is unable to run. Email delivery is being handled by WordPress (or another plugin)." +msgstr "Το Postman δεν μπορεί να εκτελεστεί. Η παράδοση των e-mail γίνεται από το WordPress (ή άλλο πρόσθετο)." + +#. translators: where %d is the number of emails delivered +#: Postman/PostmanViewController.php:147 +msgid "Postman has delivered %d email." +msgid_plural "Postman has delivered %d emails." +msgstr[0] "Το Postman έχει παραδώσει %d email για εσάς." +msgstr[1] "Το Postman έχει παραδώσει %d email για εσάς." + +#: Postman/PostmanViewController.php:150 +msgid "The last %d email attempts are recorded in the log." +msgstr "Προβολή αρχείου καταγραφής" + +#: Postman/PostmanViewController.php:155 +msgid "Thank-you for choosing Postman!" +msgstr "Ευχαριστούμε που επιλέξατε το Postman!" + +#. translators: where %s is the URL of the Setup Wizard +#: Postman/PostmanViewController.php:157 +msgid "Let's get started! All users are strongly encouraged to run the Setup Wizard." +msgstr "Ας ξεκινήσουμε! Προτείνουμε όλοι οι χρήστες να εκτελέσουν τον Οδηγό Ρύθμισης." + +#: Postman/PostmanViewController.php:158 +msgid "Alternately, manually configure your own settings and/or modify advanced options." +msgstr "Εναλλακτικά, διαμορφώστε χειροκίνητα τις δικές σας ρυθμίσεις και/ή τροποποιήστε τις επιλογές για προχωρημένους." + +#. translators: where %s is the URL to the WordPress.org review and ratings +#. page +#: Postman/PostmanViewController.php:163 +msgid "Please consider leaving a review to help spread the word! :D" +msgstr "Παρακαλούμε αφήστε μια κριτική για να βοηθήσετε να γίνει γνωστό! :D" + +#: Postman/PostmanViewController.php:165 +msgid "Postman needs translators! Please take a moment to translate a few sentences on-line" +msgstr "" + +#: Postman/PostmanViewController.php:167 +msgid "New for v1.7! Send mail with the Mandrill or SendGrid APIs." +msgstr "" + +#: Postman/PostmanViewController.php:191 +msgctxt "Return to main menu link" +msgid "Back To Main Menu" +msgstr "Πίσω στο Κεντρικό Μενού" + +#: Postman/PostmanViewController.php:198 Postman/PostmanViewController.php:233 +#: Postman/PostmanViewController.php:284 +msgid "Import" +msgstr "Εισαγωγή" + +#: Postman/PostmanViewController.php:199 Postman/PostmanViewController.php:285 +msgid "Export" +msgstr "Εξαγωγή" + +#: Postman/PostmanViewController.php:200 Postman/PostmanViewController.php:286 +msgid "Reset Plugin" +msgstr "" + +#: Postman/PostmanViewController.php:206 +msgid "Copy this data into another instance of Postman to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:225 +msgid "Paste data from another instance of Postman here to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:228 +msgid "Using the same OAuth 2.0 Client ID and Client Secret from this site at the same time as another site will cause failures." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "This will purge all of Postman's settings, including account credentials and the email log." +msgstr "Αυτό θα εκκαθαρίσει όλες τις ρυθμίσεις του Postman, συμπεριλαμβανομένων των στοιχείων σύνδεσης λογαριασμών και του αρχείου καταγραφής email." + +#: Postman/PostmanViewController.php:241 +msgid "Are you sure?" +msgstr "Είστε βέβαιοι;" + +#: Postman/PostmanViewController.php:261 +msgid "Configuration" +msgstr "Ρύθμιση" + +#: Postman/PostmanViewController.php:262 +msgid "Start the Wizard" +msgstr "Εκκίνηση του Οδηγού" + +#: Postman/PostmanViewController.php:263 +msgid "Show All Settings" +msgstr "" + +#: Postman/PostmanViewController.php:266 +msgctxt "Main Menu" +msgid "Actions" +msgstr "Ενέργειες" + +#: Postman/PostmanViewController.php:292 +msgctxt "Main Menu" +msgid "Troubleshooting" +msgstr "Αντιμετώπιση προβλημάτων" + +#: Postman/PostmanViewController.php:296 +msgid "Online Support" +msgstr "Διαδικτυακή Υποστήριξη" + +#. Plugin URI of the plugin/theme +msgid "https://wordpress.org/plugins/postman-smtp/" +msgstr "https://wordpress.org/plugins/postman-smtp/" + +#. Description of the plugin/theme +msgid "Email not reliable? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +msgstr "Το e-mail σας δεν είναι αξιόπιστο; Το Postman είναι το πρώτο και το μοναδικό πρόσθετο SMTP του WordPress που υλοποιεί πιστοποίηση OAuth 2.0 για Gmail, Hotmail και Yahoo Mail. Η ρύθμιση είναι παιχνιδάκι με τον Οδηγό Διαμόρφωσης και την ενσωματωμένη Δοκιμή Θύρας. Απολαύστε παράδοση e-mail χωρίς άγχος ακόμα και αν αλλάξει ο κωδικός σας!" + +#. Author of the plugin/theme +msgid "Jason Hendriks" +msgstr "Jason Hendriks" + +#. Author URI of the plugin/theme +msgid "http://www.codingmonkey.ca" +msgstr "http://www.codingmonkey.ca" + +#~ msgid "Change the delivery method on the %s!" +#~ msgstr "Αλλαγή της μεθόδου παράδοσης στο %s!" + +#~ msgid "Configure the plugin." +#~ msgstr "Διαμορφώστε το πρόσθετο." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Test Your Setup" +#~ msgstr "Ελέγξτε τις ρυθμίσεις σας" + +#~ msgctxt "eg. TCP Port 25" +#~ msgid "Port" +#~ msgstr "Θύρα" + +#~ msgid "New for v1.6! Email Log" +#~ msgstr "Νέο για την v1.6! Καταγραφή e-mail" + +#~ msgid "Enable to save a copy of all your emails. Great for troubleshooting or as a backup for messages that get lost. Access the Email Log in the Tools menu." +#~ msgstr "Ενεργοποιήστε για αποθήκευση ενός αντιγράφου όλων των e-mail σας. Εξαιρετικό για εντοπισμό προβλημάτων ή για αντίγραφο ασφαλείας μηνυμάτων που χάνονται. Βρείτε την Καταγραφή e-mail στο μενού Εργαλεία." + +#~ msgctxt "The configuration page of the plugin" +#~ msgid "Settings" +#~ msgstr "Ρυθμίσεις" + +#~ msgid "Postman is not handling email delivery." +#~ msgstr "Το Postman δεν διαχειρίζεται την παράδοση e-mail." + +#~ msgctxt "As in type used: None" +#~ msgid "None" +#~ msgstr "Κανένας" + +#~ msgctxt "Who do we reply to?" +#~ msgid "Reply-To" +#~ msgstr "Απάντηση σε" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +#~ msgstr "Αυτή είναι η συζήτηση μεταξύ του Postman και του SMTP διακομιστή σας. Μπορεί να είναι χρήσιμη για διάγνωση προβλημάτων. ΜΗΝ τη δημοσιεύσετε διαδικτυακά, μπορεί να περιέχει τον κωδικό του λογαριασμού σας." + +#~ msgid "Postman Email Log" +#~ msgstr "Καταγραφή email του Postman" + +#~ msgid "This is a record of deliveries made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Αυτό είναι ένα αρχείο παραδόσεων που έγιναν στον Mail Submission Agent (MSA). Δεν σημαίνει απαραίτητα ότι παραδόθηκαν επιτυχώς στον παραλήπτη." + +#~ msgid "Warning: An empty subject line can result in delivery failure." +#~ msgstr "Προειδοποίηση: Κενή γραμμή θέματος μπορεί να καταλήξει σε αποτυχία παράδοσης." + +#~ msgctxt "View the transcript of an item from the email log" +#~ msgid "Transcript" +#~ msgstr "Μεταγραφή" + +#~ msgctxt "Attempt to resend this email" +#~ msgid "Resend" +#~ msgstr "Επαναποστολή" + +#~ msgctxt "Was sending this email successful or not?" +#~ msgid "Status" +#~ msgstr "Κατάσταση" + +#~ msgctxt "Transport Name" +#~ msgid "Gmail API" +#~ msgstr "Gmail API" + +#~ msgctxt "Authentication Type is OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgid "Postman will send mail via the 🔐Gmail API using %s authentication." +#~ msgstr "To Postman θα στέλνει e-mail μέσω του 🔐Gmail API με χρήση πιστοποίησης %s." + +#~ msgid "OAuth 2.0 authentication requires a Client ID and Client Secret." +#~ msgstr "Η πιστοποίηση OAuth 2.0 απαιτεί ένα Client ID και Client Secret." + +#~ msgid "Envelope From Address and Message From Address can not be empty." +#~ msgstr "Η Διεύθυνση Αποστολέα Φακέλου και η Διεύθυνση Αποστολέα Μηνύματος δεν μπορούν να είναι κενές." + +#~ msgid "Postman recommends Gmail API configuration on port %d" +#~ msgstr "Το Postman προτείνει τη ρύθμιση του Gmail API στη θύρα %d" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP" +#~ msgstr "SMTP" + +#~ msgctxt "as in \"There is no Authentication\"" +#~ msgid "no" +#~ msgstr "καμία" + +#~ msgctxt "As in type used: CRAM-MD5" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "As in type used: Login" +#~ msgid "Login" +#~ msgstr "Σύνδεση" + +#~ msgctxt "As in type used: Plain" +#~ msgid "Plain" +#~ msgstr "Απλή" + +#~ msgctxt "This authentication type is password-based" +#~ msgid "Password (%s)" +#~ msgstr "Κωδικός (%s)" + +#~ msgid "Password authentication (Plain/Login/CRAM-MD5) requires a username and password." +#~ msgstr "Η πιστοποίηση με κωδικό (Απλή/Σύνδεση/CRAM-MD5) απαιτεί όνομα χρήστη και κωδικό." + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, %1$s, and %2$s." +#~ msgstr "Η πιστοποίηση OAuth 2.0 απαιτεί ένα υποστηριζόμενο Διακομιστή Εξερχόμενης Αλληλογραφίας με δυνατότητες OAuth 2.0, %1$s και%2$s." + +#~ msgid "Your recommended settings are %1$s with %2$s authentication to host %4$s on port %3$d." +#~ msgstr "Οι προτεινόμενες ρυθμίσεις σας είναι %1$s με πιστοποίηση %2$s στο διακομιστή %4$s στη θύρα %3$d." + +#~ msgid "The selected transport '%s' is unavailable. The external plugin was probably deactivated." +#~ msgstr "Η επιλεγμένη μέθοδος '%s' δεν είναι διαθέσιμη. Το εξωτερικό πρόσθετο πιθανώς απενεργοποιήθηκε." + +#~ msgid "WordPress is still handling email delivery, not Postman." +#~ msgstr "Το Postman δεν διαχειρίζεται την παράδοση e-mail." + +#~ msgctxt "The Transport is the method for sending mail, SMTP or API" +#~ msgid "Transport" +#~ msgstr "Μέθοδος αποστολής" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport Settings" +#~ msgstr "Ρυθμίσεις μεθόδου αποστολής" + +#~ msgctxt "Authentication proves the user's identity" +#~ msgid "Authentication" +#~ msgstr "Πιστοποίηση" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Username" +#~ msgstr "Όνομα χρήστη" + +#~ msgctxt "The Envelope Sender Email Address" +#~ msgid "Envelope From Address" +#~ msgstr "Ηλ. Διεύθυνση Φακέλου Από" + +#~ msgctxt "The Message Sender Email Address" +#~ msgid "Message From Address" +#~ msgstr "Ηλ. Διεύθυνση Μηνύματος Από" + +#~ msgctxt "The email address to address replies to" +#~ msgid "Reply-To" +#~ msgstr "Ηλ. Διεύθυνση Απάντησης Σε" + +#~ msgid "Maximum Number of Log Entries" +#~ msgstr "Μέγιστος Αριθμός Καταχωρήσεων Καταγραφής" + +#~ msgid "Maximum Number of Lines in a Transcript" +#~ msgstr "Μέγιστος Αριθμός Γραμμών σε μια Μεταγραφή" + +#~ msgid "Configure the communication with the Mail Submission Agent (MSA):" +#~ msgstr "Διαμορφώστε την επικοινωνία με τον Mail Submission Agent (MSA):" + +#~ msgid "Enter the account username (email address) and password:" +#~ msgstr "Εισάγετε το όνομα χρήστη του λογαριασμού (διεύθυνση e-mail) και τον κωδικό:" + +#~ msgid "This will purge all of Postman's settings, including SMTP server info, username/password and OAuth Credentials." +#~ msgstr "Αυτό θα διαγράψει όλες τις ρυθμίσεις του Postman, συμπεριλαμβανομένων των πληροφοριών διακομιστή SMTP, ονόματος χρήστη/κωδικού και Στοιχείων Ταυτοποίησης OAuth." + +#~ msgid "Log Level specifies the level of detail written to the WordPress log - view the log with Debug. Delivery mode offers options useful for developing or testing." +#~ msgstr "Το επίπεδο καταγραφής καθορίζει το επίπεδο λεπτομέρειας που καταγράφεται στο WordPress - δείτε το αρχείο καταγραφής με Αποσφαλμάτωση. Η κατάσταση Παράδοση προσφέρει επιλογές χρήσιμες για ανάπτυξη ή δοκιμές." + +#~ msgctxt "Log Level" +#~ msgid "Off" +#~ msgstr "Καμία" + +#~ msgctxt "Log Level" +#~ msgid "Trace" +#~ msgstr "Ανίχνευση" + +#~ msgctxt "Log Level" +#~ msgid "Debug" +#~ msgstr "Αποσφαλμάτωση" + +#~ msgctxt "Log Level" +#~ msgid "Info" +#~ msgstr "Πληροφορίες" + +#~ msgctxt "Log Level" +#~ msgid "Warning" +#~ msgstr "Προειδοποίηση" + +#~ msgctxt "Log Level" +#~ msgid "Error" +#~ msgstr "Σφάλμα" + +#~ msgid "Attention! Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +#~ msgstr "Προσοχή! Ανοίξτε το %2$s, δημιουργήστε %7$s με τις τιμές που εμφανίζονται παρακάτω και αντιγράψτε τα παραγόμενα %3$s και %4$s εδώ." + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Grant OAuth Permission" +#~ msgstr "Δώστε Άδεια OAuth" + +#~ msgid " must be greater than 0" +#~ msgstr "πρέπει να είναι μεγαλύτερη από 0" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup" +#~ msgstr "Ρύθμιση του Postman" + +#~ msgid "Having trouble? You can ask for help on our Support Forum. To get the help you need quickly, please post the Diagnostic Data with your question. You can also check the FAQ and Error Messages pages for answers." +#~ msgstr "Αντιμετωπίζετε προβλήματα; Μπορείτε να ζητήσετε βοήθεια στο Φόρουμ ΥΠοστήριξης. Για να πάρετε τη βοήθεια που θέλετε γρήγορα, παρακαλούμε συμπεριλάβετε τα Διαγνωστικά Δεδομένα στην ερώτησή σας. Μπορείτε επίσης να δείτε τις Συχνές Ερωησεις και τις σελίδες Μηνύματα Σφάλματος για απαντήσεις." + +#~ msgctxt "Email Test Status" +#~ msgid "Ajax Error" +#~ msgstr "Σφάλμα Ajax" + +#~ msgid "Unexpected PHP messages corrupted the Ajax response:" +#~ msgstr "Μη αναμενόμενα μηνύματα PHP αλλοίωσαν την απόκριση του Ajax:" + +#~ msgid "Warning: connected to %1$s instead of %2$s." +#~ msgstr "Προειδοποίηση: συνδέθηκε στον %1$s αντί για τον %2$s." + +#~ msgid "Port %d can be used to send Gmail with the Gmail API." +#~ msgstr "Η θύρα %d μπορεί να χρησιμοποιηθεί για αποστολή Gmail με το Gmail API." + +#~ msgid "WordPress (or another plugin) is currently handling email delivery, not Postman." +#~ msgstr "Το WordPress (ή άλλο πρόσθετο) διαχειρίζεται την παράδοση e-mail αυτή τη στιγμή, όχι το Postman." + +#~ msgctxt "Page Title" +#~ msgid "Manual Configuration" +#~ msgstr "Χειροκίνητη Διαμόρφωση" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Account" +#~ msgstr "Λογαριαμός" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Message" +#~ msgstr "Μήνυμα" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Logging" +#~ msgstr "Σύνδεση" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Advanced" +#~ msgstr "Για Προχωρημένους" + +#~ msgid "Delete plugin settings" +#~ msgstr "Διαγραφή ρυθμίσεων προσθέτου" + +#~ msgid "This will purge all of Postman's settings, including account credentials and the mail log." +#~ msgstr "Αυτό θα εκκαθαρίσει όλες τις ρυθμίσεις του Postman, συμπεριλαμβανομένων των στοιχείων σύνδεσης λογαριασμών και του αρχείου καταγραφής email." + +#~ msgctxt "Button Label" +#~ msgid "Delete All Data" +#~ msgstr "Διαγραφή Όλων των Δεδομένων" + +#~ msgctxt "A testing tool which determines connectivity to the Internet" +#~ msgid "Connectivity Test" +#~ msgstr "Τεστ Συνδεσιμότητας" + +#~ msgctxt "The port number" +#~ msgid "Port %s" +#~ msgstr "Θύρα %s" + +#~ msgctxt "Is it possible to create network connections to the Internet?" +#~ msgid "Outbound to Internet" +#~ msgstr "Εξερχόμενη σύνδεση προς το Διαδίκτυο" + +#~ msgctxt "What service is available?" +#~ msgid "Service Available" +#~ msgstr "Διαθέσιμη Υπηρεσία" + +#~ msgctxt "What is this server's ID?" +#~ msgid "ID" +#~ msgstr "ID" + +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgctxt "Short for Authentication" +#~ msgid "Auth" +#~ msgstr "Πιστοπ." + +#~ msgctxt "Authentication Type" +#~ msgid "None" +#~ msgstr "Καμμία" + +#~ msgid "* Port 443 tests against googleapis.com, not the SMTP hostname you enter." +#~ msgstr "* Η θύρα 443 τεστάρει για το googleapis.com, όχι για το όνομα διακομιστή SMTP που εισάγετε." + +#~ msgid "A port with Service Available \"No\" indicates one or more of these issues:" +#~ msgstr "Θύρα με Διαθέσιμη Υπηρεσία \"Όχι\" υποδεικνύει ένα ή περισσότερα από αυτά τα προβλήματα:" + +#~ msgid "Your PHP configuration is preventing outbound connections" +#~ msgstr "Η διαμόρφωση της PHP σας εμποδίζει τις εξερχόμενες συνδέσεις" + +#~ msgid "Your WordPress configuration is preventing outbound connections" +#~ msgstr "Η διαμόρφωση του WordPress σας εμποδίζει εξερχόμενες συνδέσεις" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "Show Advanced Configuration" +#~ msgstr "Εμφάνιση Διαμόρφωσης για Προχωρημένους" + +#~ msgid "Disable" +#~ msgstr "Απενεργοποίηση" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup Wizard" +#~ msgstr "Οδηγός Ρύθμισης του Postman" + +#~ msgid "Error: Your email address requires access to a remote SMTP server blocked by GoDaddy. Use a different e-mail address." +#~ msgstr "Σφάλμα: Η διεύθυνση email σας απαιτεί πρόσβαση σε απομακρυσμένο διακομιστή SMTP που αποκλείεται από το GoDaddy. Χρησιμοποιήστε διαφορετική διεύθυνση e-mail." + +#~ msgid "Warning: If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems." +#~ msgstr "Προειδοποίηση: Αν σας ανήκει αυτός ο τομέας, βεβαιωθείτε ότι έχει μια καταχώρηση SPF που εξουσιοδοτεί το GoDaddy ως διαμεσολαβητή αλλιώς θα έχετε προβλήματα παράδοσης." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will the connection to the MSA be established?" +#~ msgstr "Πως θα γίνει η σύνδεση με τον MSA;" + +#~ msgid "Warning: This configuration option will send your authorization credentials in the clear." +#~ msgstr "Προειδοποίηση: Αυτή η επιλογή θα στείλει τα στοιχεία σύνδεσής σας χωρίς κρυπτογράφηση." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will you prove your identity to the MSA?" +#~ msgstr "Πως θα αποδείξετε την ταυτότητά σας στον MSA;" + +#~ msgid "Enter your credentials. Your username is often your email address." +#~ msgstr "Εισάγετε τα στοιχεία σας σύνδεσης. Το όνομα χρήστη συχνά είναι το e-mail σας." + +#~ msgid "Examine the SMTP Session Transcript if you need to." +#~ msgstr "Εξετάστε τη Μεταγραφή Συνεδρίας SMTP αν χρειάζεται." + +#~ msgid "SMTP Session Transcript" +#~ msgstr "Μεταγραφή Συνεδρίας SMTP" + +#~ msgid "Welcome" +#~ msgstr "Καλώς ήλθατε" + +#~ msgid "The Envelope From address identifies the account owner to the SMTP server." +#~ msgstr "Η διεύθυνση Φάκελος Από αφορά τον κάτοχο του λογαριασμού στον διακομιστή SMTP." + +#~ msgid "The Message From address identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Themes and other plugins, especially Contact Forms, are permitted to modify this field." +#~ msgstr "Η διεύθυνση Μήνυμα Από είναι αυτή που βλέπει ο παραλήπτης ως αποστολέα. Αλλάξτε τη όταν στέλνετε εκ μέρους κάποιου άλλου, παραδείγματος χάριν για να χρησιμοποιήσετε τη δυνατότητα Αποστολή Αλληλογραιας Ως της Google. Τα θέματα και άλλα πρόσθετα επιτρέπεται να τροποποιούν αυτό το πεδίο." + +#~ msgid "Postman has delivered %d email for you." +#~ msgid_plural "Postman has delivered %d emails for you." +#~ msgstr[0] "Το Postman έχει παραδώσει %d email για εσάς." +#~ msgstr[1] "Το Postman έχει παραδώσει %d email για εσάς." + +#~ msgid "View the log" +#~ msgstr "Προβολή αρχείου καταγραφής" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Import/Export" +#~ msgstr "Εισαγωγή/Εξαγωγή" diff --git a/Postman/languages/postman-smtp-fr_FR.mo b/Postman/languages/postman-smtp-fr_FR.mo new file mode 100644 index 0000000..49edcd9 Binary files /dev/null and b/Postman/languages/postman-smtp-fr_FR.mo differ diff --git a/Postman/languages/postman-smtp-fr_FR.po b/Postman/languages/postman-smtp-fr_FR.po new file mode 100644 index 0000000..922eb88 --- /dev/null +++ b/Postman/languages/postman-smtp-fr_FR.po @@ -0,0 +1,2529 @@ +# Copyright (C) 2015 Postman SMTP +# This file is distributed under the same license as the Postman SMTP package. +msgid "" +msgstr "" +"Project-Id-Version: Postman SMTP 1.4.1\n" +"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/postman-smtp\n" +"POT-Creation-Date: 2015-11-08 17:20-0500\n" +"PO-Revision-Date: 2015-11-09 01:44-0500\n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: fr_CA\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 1.8.6\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:94 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:348 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:357 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:99 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:545 +#: Postman/PostmanViewController.php:227 +msgid "Warning" +msgstr "Attention" + +#. translators: where %s is the name of the SMTP server +#: Postman/Postman-Configuration/PostmanConfigurationController.php:96 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +msgid "connected to %1$s instead of %2$s." +msgstr "connecté à %1$s au lieu de %2$s." + +#. translators: where %d is a port number +#: Postman/Postman-Configuration/PostmanConfigurationController.php:98 +msgid "You are about to configure OAuth 2.0 with an IP address instead of a domain name. This is not permitted. Either assign a real domain name to your site or add a fake one in your local host file." +msgstr "Vous êtes sur le point de configurer OAuth 2.0 avec une adresse IP dans l'URL qui échouera. Soit attribuer un nom de domaine pour votre site ou ajouter un faux dans le fichier hôte de votre machine locale." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/PostmanViewController.php:53 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "%s Setup" +msgstr "Réglages de %s" + +#. Plugin Name of the plugin/theme +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:57 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:70 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:176 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/Postman.php:61 Postman/PostmanViewController.php:53 +#: Postman/PostmanViewController.php:54 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "Postman SMTP" +msgstr "Postman SMTP" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:196 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:81 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 Postman/Postman.php:316 +#: Postman/PostmanAdminController.php:225 +msgid "Settings" +msgstr "Réglages" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:198 +msgid "Account" +msgstr "Compte" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:199 +msgid "Message" +msgstr "Texte" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:200 +msgid "Logging" +msgstr "Journalisation" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:201 +msgid "Advanced" +msgstr "Avancée" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:263 +msgid "Setup Wizard" +msgstr "Setup Wizard" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:296 +msgctxt "Wizard Step Title" +msgid "Import Configuration" +msgstr "Importer configuration" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:298 +msgctxt "Wizard Step Title" +msgid "Import configuration from another plugin?" +msgstr "Importer configuration d'un autre plugin?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:299 +msgid "If you had a working configuration with another Plugin, the Setup Wizard can begin with those settings." +msgstr "Si vous aviez une configuration de travail avec un autre plugin, l'assistant d'installation peut commencer avec ces paramètres." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:301 +#: Postman/Postman-Mail/PostmanModuleTransport.php:720 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:425 +msgid "None" +msgstr "Aucun" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:312 +msgctxt "Wizard Step Title" +msgid "Sender Details" +msgstr "Sender Détails" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:314 +msgctxt "Wizard Step Title" +msgid "Who is the mail coming from?" +msgstr "Qui est le courrier en provenance?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:315 +msgid "Enter the email address and name you'd like to send mail as." +msgstr "Entrez l'adresse e-mail et le nom que vous souhaitez envoyer un mail comme." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:316 +msgid "Please note that to prevent abuse, many email services will not let you send from an email address other than the one you authenticate with." +msgstr "Veuillez noter que pour combattre le Spam, plusieurs services de messagerie ne permettrons pas l'envoi d'un message provenant d'une autre adresse que la vôtre." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:317 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:49 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:112 +msgid "Email Address" +msgstr "Adresse e-mail" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:320 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:59 +msgid "Name" +msgstr "Nom" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:325 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:143 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:331 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:542 +msgid "Outgoing Mail Server Hostname" +msgstr "Nom d'Hôte du serveur SMTP" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:333 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:138 +#: Postman/PostmanViewController.php:294 +msgid "Connectivity Test" +msgstr "Test de connectivité" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:335 +msgid "How will the connection to the mail server be established?" +msgstr "Comment la connexion au ASC sera créé?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:336 +msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows." +msgstr "Vos paramètres de connexion dépendent sur les offres de ce que votre fournisseur de services de messagerie, et ce que votre hôte WordPress permet." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +msgctxt "TCP Port Test Status" +msgid "Ready" +msgstr "Prêt" + +#. Translators: Where %1$s is the socket identifier and %2$s is the +#. authentication type +#: Postman/Postman-Configuration/PostmanConfigurationController.php:345 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgctxt "A socket is the network term for host and port together" +msgid "Socket" +msgstr "Socket" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:346 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:354 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:223 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:177 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:351 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:356 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:372 +msgid "Authentication" +msgstr "Authentification" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:349 +msgid "This configuration option will send your authorization credentials in the clear." +msgstr "Cette option de configuration envoie vos informations d'identification de l'autorisation en clair." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:356 +msgid "How will you prove your identity to the mail server?" +msgstr "Comment allez-vous prouver votre identité à la ASC?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:363 +msgctxt "The final step of the Wizard" +msgid "Finish" +msgstr "Fin" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:365 +msgctxt "Wizard Step Title" +msgid "You're Done!" +msgstr "Vous avez fini!" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:367 +msgid "Click Finish to save these settings, then:" +msgstr "Cliquer sur Fin pour sauver ces réglages, ensuite:" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:369 +msgid "Grant permission with the Email Provider for Postman to send email and" +msgstr "Accorder l'autorisation avec le fournisseur de messagerie pour Postman, envoyer des e-mails et" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:370 +msgid "Send yourself a Test Email to make sure everything is working!" +msgstr "Envoyez-vous un message test pour vérifier que tout fonctionne!" + +#. translators: where %s is the URL to the Connectivity Test page +#: Postman/Postman-Configuration/PostmanConfigurationController.php:514 +msgid "Postman can't find any way to send mail on your system. Run a connectivity test." +msgstr "Postman ne peut pas trouver un moyen pour envoyer des messages sur votre système. Faire un test de connexion de port." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:33 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Transport" +msgstr "Transport" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:38 +msgctxt "(i.e.) What kind is it?" +msgid "Type" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:44 +msgctxt "The Message Sender Email Address" +msgid "From Address" +msgstr "Adresse d'expéditeur du message" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:70 +msgid "Additional Email Addresses" +msgstr "Adresses e-mail supplémentaires" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:75 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:220 +msgid "Reply-To" +msgstr "Reply-To" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:80 +msgid "To Recipient(s)" +msgstr "Récipiendaires To" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:85 +msgid "Carbon Copy Recipient(s)" +msgstr "Récipiendaires Carbon Copy" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:90 +msgid "Blind Carbon Copy Recipient(s)" +msgstr "Récipiendaires Blind Carbon Copy" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:96 +msgid "Additional Headers" +msgstr "Têtes additionnels" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:101 +msgid "Custom Headers" +msgstr "Têtes personnalisés" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:107 +msgid "Validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:118 +msgid "Email Log Settings" +msgstr "Paramètres Niveau du journal" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:123 +msgid "Enable Logging" +msgstr "Activer la journalisation" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:128 +#: Postman/PostmanInputSanitizer.php:137 +msgid "Maximum Log Entries" +msgstr "Entrées de journal de courrier ont été supprimées." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:133 +msgid "Maximum Transcript Size" +msgstr "Taille de la transcription (Total des lignes)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:139 +msgid "Network Settings" +msgstr "Paramètres réseau" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:144 +msgctxt "Configuration Input Field" +msgid "TCP Connection Timeout (sec)" +msgstr "Délai d'attente de connexion (sec)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:149 +msgctxt "Configuration Input Field" +msgid "TCP Read Timeout (sec)" +msgstr "Délai pour l'interrogation des données (sec)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:155 +msgctxt "Configuration Section Title" +msgid "Miscellaneous Settings" +msgstr "Paramètres divers" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:160 +msgctxt "Configuration Input Field" +msgid "PHP Log Level" +msgstr "Niveau de Log PHP" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:165 +msgctxt "Configuration Input Field" +msgid "Delivery Mode" +msgstr "Mode de livraison" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:170 +msgctxt "This mode removes the Postman X-Mailer signature from emails" +msgid "Stealth Mode" +msgstr "Mode Furtif" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:175 +msgid "Temporary Directory" +msgstr "Dossier temporaire" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:186 +msgid "Choose SMTP or a vendor-specific API:" +msgstr "Choisir le SMTP ou une API spécifique au fournisseur :" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:189 +msgid "Configure the delivery audit log:" +msgstr "Configurer le journal d'audit de livraison:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:196 +msgid "This address, like the letterhead printed on a letter, identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Other plugins, especially Contact Forms, may override this field to be your visitor's address." +msgstr "Cette adresse, comme le en-tête imprimé sur une lettre, identifie l'expéditeur au destinataire. Changer lorsque vous envoyez au nom de quelqu'un d'autre, par exemple pour utiliser Google Send Mail As fonctionnalité. Autres plugins, en particulier les formulaires de contact, peut l'emporter ce domaine pour être l'adresse de votre visiteur." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:203 +msgid "Separate multiple to/cc/bcc recipients with commas." +msgstr "Séparer les to/cc/bcc destinataires par des virgules." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:210 +msgid "Increase the timeouts if your host is intermittenly failing to send mail. Be careful, this also correlates to how long your user must wait if the mail server is unreachable." +msgstr "Augmenter le temp de lecture si votre hôte échoue à envoyer du courrier à répétitions. Attention, cette action est en corrélation avec le temps d'attente que subira l'usager si votre serveur de courrier est injoignable." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:221 +msgid "Specify custom headers (e.g. X-MC-Tags: wordpress-site-A), one per line. Use custom headers with caution as they can negatively affect your Spam score." +msgstr "Spécifiez têtes personnalisés (par exemple X-MC-Tags: wordpress site-A), un par ligne. Utilisez-têtes personnalisés avec prudence, car ils peuvent nuire à votre score de spam." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:228 +msgid "E-mail addresses can be validated before sending e-mail, however this may fail with some newer domains." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:254 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:276 +msgid "Prevent plugins and themes from changing this" +msgstr "Empêcher des plugins et des thèmes de modifier ceci" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:261 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:405 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:244 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:195 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:409 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:416 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:459 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:467 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:475 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:482 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:530 +msgid "Required" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:268 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:531 +msgid "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +msgstr "Cette adresse, comme le adresse de retour imprimé sur une enveloppe, identifie le propriétaire du compte sur le serveur SMTP." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:289 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:108 +msgid "Yes" +msgstr "Oui" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:290 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:109 +msgid "No" +msgstr "Non" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:300 +msgid "Change this value if you can't see the beginning of the transcript because your messages are too big." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:343 +msgid "Disable e-mail validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:350 +msgid "Log Level specifies the level of detail written to the WordPress Debug log - view the log with Debug." +msgstr "Niveau du journal spécifie le niveau de détail écrite dans les fichiers journaux de WordPress et PHP. Mode de livraison offre des options utiles dans un environnement de développement." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:353 +msgid "Off" +msgstr "Aucun" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:354 +msgid "Trace" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:355 +msgid "Debug" +msgstr "Debug" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:356 +msgid "Info" +msgstr "Information" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:358 +msgid "Error" +msgstr "Erreur" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:366 +msgid "Delivery mode offers options useful for developing or testing." +msgstr "Cette fonction vous permet d'envoyer un message en test." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:369 +msgctxt "When the server is online to the public, this is \"Production\" mode" +msgid "Log Email and Send" +msgstr "Journal E-mail et envoyer" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:370 +msgid "Log Email and Delete" +msgstr "Journal E-mail et Supprimer" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:371 +msgid "Delete All Emails" +msgstr "Supprimez toutes les e-mails" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:375 +msgid "Remove the Postman X-Header signature from messages" +msgstr "Supprimer la signature de l'en-tête X facteur de messages" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:378 +msgid "Lockfiles are written here to prevent users from triggering an OAuth 2.0 token refresh at the same time." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:381 +msgid "Valid" +msgstr "Valide" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:383 +msgid "Invalid" +msgstr "Invalide" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:105 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:109 +msgctxt "The \"please wait\" message" +msgid "Checking.." +msgstr "Vérification.." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:106 +msgctxt "The port is open" +msgid "Open" +msgstr "Ouvert" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:107 +msgctxt "The port is closed" +msgid "Closed" +msgstr "Fermé" + +#. translators: where %d is a port number +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:111 +msgid "No outbound route between this site and the Internet on Port %d." +msgstr "Aucun itinéraire sortant entre ce site et de l'Internet sur le Port %d." + +#. translators: where %d is a port number and %s is a hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:113 +msgid "Port %d is open, but not to %s." +msgstr "Port %d est ouvert, mais pas a %s." + +#. translators: where %d is the port number and %s is the hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:115 +msgid "Port %d can be used for SMTP to %s." +msgstr "Port %d peut être utilisé pour SMTP %s." + +#. translators: where %d is a port number and %s is the URL for the Postman +#. Gmail Extension +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:118 +msgid "Port %d can be used with the %s." +msgstr "Port %d peut servir à envoyer les courriels avec le %s." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:141 +msgid "This test determines which well-known ports are available for Postman to use." +msgstr "Ce test détermine les ports bien connus sont disponibles pour Postman à utiliser." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:145 +msgctxt "Button Label" +msgid "Begin Test" +msgstr "Commencer le test" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:162 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:152 +msgid "Status" +msgstr "Statut" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Service Available" +msgstr "Service Disponible" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Server ID" +msgstr "ID de Serveur" + +#. Translators: Meaning "Not Applicable" +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:155 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:260 +msgid "n/a" +msgstr "n/a" + +#. Translators: Where %s is the name of the service providing Internet +#. connectivity test +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:160 +msgid "According to %s" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:163 +msgid "Summary" +msgstr "Summary" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:168 +msgid "A test with \"No\" Service Available indicates one or more of these issues:" +msgstr "Un port Fermé peut vouloir dire ceci:" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:170 +msgid "Your web host has placed a firewall between this site and the Internet" +msgstr "L'Hôte à mis en place un Firewall entre ce site et le serveur SMTP" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:171 +msgid "The SMTP hostname is wrong or the mail server does not provide service on this port" +msgstr "Le nom d'hôte SMTP est erronée ou le serveur de messagerie ne fournit pas de service sur ce port" + +#. translators: where (1) is the URL and (2) is the system +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:173 +msgid "Your %2$s configuration is preventing outbound connections" +msgstr "Votre configuration de %2$s empêche les connexions sortantes" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:177 +msgid "If the issues above can not be resolved, your last option is to configure Postman to use an email account managed by your web host with an SMTP server managed by your web host." +msgstr "Si les questions ci-dessus ne peuvent pas être résolues, votre dernière option consiste à configurer postier pour utiliser un compte de messagerie géré par votre hôte web avec un serveur SMTP géré par votre hébergeur." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:82 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman.php:317 +msgctxt "The log of Emails that have been delivered" +msgid "Email Log" +msgstr "Niveau du journal" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:95 +msgid "Error: Postman is missing a required PHP library." +msgstr "Postman manque une bibliothèque PHP requise." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:97 +#: Postman/Postman.php:257 +msgid "Postman: wp_mail has been declared by another plugin or theme, so you won't be able to use Postman until the conflict is resolved." +msgstr "Erreur: Postman est correctement configuré, mais le thème actuel ou un autre plugin empêche service." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:100 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:229 +msgid "Postman is in non-Production mode and is dumping all emails." +msgstr "Postman est en mode non-production." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:102 +msgid "Postman is configured and has delivered %d email." +msgid_plural "Postman is configured and has delivered %d emails." +msgstr[0] "Postman est configuré et a livré %d e-mail." +msgstr[1] "Postman est configuré et a livré %d e-mails." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:104 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:234 +msgid "Postman is not configured and is mimicking out-of-the-box WordPress email delivery." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:116 +msgid "Postman is operating in per-site mode." +msgstr "Postier fonctionne en mode par-site." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:102 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:107 +#: Postman/PostmanViewController.php:295 +msgid "Diagnostic Test" +msgstr "Test de diagnostic" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:104 +msgid "Are you having issues with Postman?" +msgstr "Rencontrez-vous des problèmes avec Postman?" + +#. translators: where %1$s and %2$s are the URLs to the Troubleshooting and +#. Support Forums on WordPress.org +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:106 +msgid "Please check the troubleshooting and error messages page and the support forum." +msgstr "Consultez la page des messages de dépannage et d'erreur et le forum de support." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:108 +msgid "If you write for help, please include the following:" +msgstr "Si vous écrivez à l'aide, se il vous plaît inclure les informations de diagnostic suivant:" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:90 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:242 +msgid "Your message was delivered (%d ms) to the SMTP server! Congratulations :)" +msgstr "Votre message à été livrer (%d ms) au serveur SMTP! Félicitations :)" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:156 +msgid "Mail Log Entries were deleted." +msgstr "Entrées de journal de courrier ont été supprimées." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:179 +msgid "Mail Log Entry was deleted." +msgstr "Entrée du journal des messages a été supprimée." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:204 +msgctxt "Who is this message From?" +msgid "From" +msgstr "De" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:208 +msgctxt "Who is this message To?" +msgid "To" +msgstr "A" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:212 +msgctxt "Who is this message Cc'd to?" +msgid "Cc" +msgstr "Cc" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:216 +msgctxt "Who is this message Bcc'd to?" +msgid "Bcc" +msgstr "Bcc" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:222 +msgctxt "What is the date today?" +msgid "Date" +msgstr "Date" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:223 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:161 +msgctxt "What is the subject of this message?" +msgid "Subject" +msgstr "Sujet" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:226 +msgctxt "What is the unique URI of the configuration?" +msgid "Delivery-URI" +msgstr "Livraison-URI" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:253 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:161 +msgid "This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +msgstr "C'est la conversation entre Postman et votre serveur SMTP. Il peut être utile pour diagnostiquer les problèmes. NE PAS poster en ligne, il peut contenir votre mot de passe sous forme codée." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +msgid "%s Email Log" +msgstr "Niveau du journal de %s" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:301 +msgid "Email was successfully resent (but without attachments)" +msgstr "" + +#. Translators: Where %s is an error message +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:303 +msgid "Email could not be resent. Error: %s" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:304 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:110 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:112 +msgid "Resend" +msgstr "Renvoyer" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:339 +msgid "This is a record of deliveries made to the mail server. It does not neccessarily indicate sucessful delivery to the recipient." +msgstr "Il s'agit d'un record de tentatives de remise faite à l'Agent de Submission Courrier (ASC). Il n'indique pas nécessairement sucessful remise au destinataire." + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:37 +msgctxt "The group of Emails that have been delivered" +msgid "Sent Emails" +msgstr "Courriels envoyés" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:38 +msgctxt "An Email that has been delivered" +msgid "Sent Email" +msgstr "Courriel envoyé" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +msgid "An empty subject line can result in delivery failure." +msgstr "Une ligne d'objet vide peut provoquer l'échec de la livraison." + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:196 +msgid ".. +%d more" +msgstr ".. et %d plus" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:99 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:223 +msgctxt "Delete an item from the email log" +msgid "Delete" +msgstr "Supprimer" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:100 +msgctxt "View an item from the email log" +msgid "View" +msgstr "Voir" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:104 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:106 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:158 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:163 +msgid "Session Transcript" +msgstr "Session Transcription" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:163 +msgctxt "When was this email sent?" +msgid "Delivery Time" +msgstr "Délai de livraison" + +#. Translators: where %s indicates the relative time from now +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:332 +msgctxt "A relative time as in \"five days ago\"" +msgid "%s ago" +msgstr "Il ya %s" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:338 +msgid "Sent" +msgstr "Envoyé" + +#: Postman/Postman-Mail/PostmanDefaultModuleTransport.php:107 +msgid "Default" +msgstr "Défaut" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:102 +msgid "Gmail API" +msgstr "API de Gmail" + +#. translators: where (1) is the secure icon and (2) is the transport name +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:152 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:135 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:79 +msgid "Postman will send mail via the %1$s %2$s." +msgstr "" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:166 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:117 +msgid "You have configured OAuth 2.0 authentication, but have not received permission to use it." +msgstr "Vous avez configuré l'authentification OAuth 2.0, mais ne avons pas reçu la permission de l'utiliser." + +#. translators: where variables are (1) transport name (2) host and (3) port +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:206 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:181 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:125 +msgid "Postman recommends the %1$s to host %2$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:221 +#: Postman/Postman-Mail/PostmanModuleTransport.php:713 +msgid "OAuth 2.0 (requires Client ID and Client Secret)" +msgstr "OAuth 2.0 (nécessite ID de client et le client secret)" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:44 +msgid "Mandrill API" +msgstr "API de Mandrill" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:147 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:101 +msgid "API Key can not be empty" +msgstr "La clef API ne peut pas être vide." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:151 +#: Postman/Postman-Mail/PostmanModuleTransport.php:578 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:105 +msgid "Message From Address can not be empty" +msgstr "Adresse d'expéditeur du message ne peut être vide." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:194 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:228 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:271 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:148 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:182 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:222 +msgid "API Key" +msgstr "Clé d’API" + +#. Translators: Where (1) is the service URL and (2) is the service name and +#. (3) is a api key URL +#: Postman/Postman-Mail/PostmanMandrillTransport.php:238 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:189 +msgid "Create an account at %2$s and enter an API key below." +msgstr "" + +#. translators: where (1) is the transport type, (2) is the host, and (3) is +#. the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 +#. using OAuth 2.0 authentication.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:506 +msgid "Postman will send mail via %1$s to %2$s using %3$s authentication." +msgstr "Postman va envoyer le courrier par %1$s à %2$s en utilisant l'authentification %3$s." + +#. translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s +#. is the encryption type (e.g. SSL or TLS) +#: Postman/Postman-Mail/PostmanModuleTransport.php:534 +msgctxt "as in \"There is no Spoon\"" +msgid "no" +msgstr "non" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:553 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:366 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:584 +msgid "Password" +msgstr "Password" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:584 +msgid "OAuth 2.0 authentication requires a %1$s and %2$s." +msgstr "" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:706 +msgid "Password (requires username and password)" +msgstr "Mot de passe (nécessite nom d'utilisateur et mot de passe)" + +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 +msgid "MyMail: Change the delivery method in the %s!" +msgstr "" + +#: Postman/Postman-Mail/PostmanSendGridTransport.php:39 +msgid "SendGrid API" +msgstr "API de SendGrid" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:95 +msgid "Outgoing Mail Server Hostname and Port can not be empty." +msgstr "Sortant Mail Server Hostname et Port ne peuvent pas être vide." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:99 +msgid "Envelope-From Email Address can not be empty" +msgstr "Adresse d'expéditeur d'enveloppe ne peut être vide." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:103 +msgid "Username and password can not be empty." +msgstr "" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:109 +msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server." +msgstr "" + +#. translators: where %1$s is a description of the transport (eg. SMTPS-SSL), +#. %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is +#. the TCP port (eg. 465), %4$d is the hostname +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:269 +msgid "Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:326 +msgid "Transport Settings" +msgstr "Réglages de Transport" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:336 +msgid "Outgoing Mail Server Port" +msgstr "Port du serveur SMTP" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:341 +msgid "Envelope-From Email Address" +msgstr "Adresse d'expéditeur d'enveloppe" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:346 +msgctxt "Configuration Input Field" +msgid "Security" +msgstr "Sécurité " + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:361 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:580 +msgid "Username" +msgstr "Identifiant" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:402 +msgid "Configure the communication with the mail server." +msgstr "Configurer la communication avec Agent de Submission Courrier (ASC)." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:449 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:579 +msgid "Enter the account credentials." +msgstr "Entrez vos informations d'identification." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:457 +msgid "The Username is usually the same as the Envelope-From Email Address." +msgstr "Votre nom d'utilisateur est sans doutes votre adresse de messagerie." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:511 +msgid "Error computing your domain root - please enter it manually" +msgstr "Erreur de compilation de votre serveur souche - entrez le manuellement" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:532 +msgid "For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:539 +msgctxt "Wizard Step Title" +msgid "Which host will relay the mail?" +msgstr "Quel hôte sera relayer le courrier?" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:540 +msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. This server is specific to your email account, and if you don't know what to use, ask your email service provider." +msgstr "C'est le serveur de courrier sortant (SMTP), ou Agent de Submission Courrier (ASC), dont les représentants postier courrier à. Ces serveurs sont spécifiques à votre compte de messagerie et si vous ne savez pas quoi utiliser, demandent à votre fournisseur de service de messagerie." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:541 +msgid "Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, require that you use their mail accounts with their mail servers, and prevent you from using others." +msgstr "Notez que de nombreux hôtes de WordPress, comme GoDaddy, Bluehost et Dreamhost, nécessitent d'utiliser leurs comptes de messagerie avec leurs serveurs de messagerie et vous empêche d'utiliser d'autres." + +#. Translators: Where (%s) is the name of the web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:547 +msgid "Your email address requires access to a remote SMTP server blocked by %s." +msgstr "Votre adresse e-mail nécessite l'accès à un serveur SMTP distant bloqué par %s." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:548 +msgid "If you have access to cPanel, enable the Remote Mail Exchanger." +msgstr "" + +#. Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the +#. web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:551 +msgid "If you own this domain, make sure it has an SPF record authorizing %2$s as a relay, or you will have delivery problems." +msgstr "Si vous possédez ce domaine, assurez-vous qu'il a un enregistrement SPF autorisant %2$s comme un relais, ou vous aurez des problèmes de livraison." + +#: Postman/Postman-Mail/PostmanTransportRegistry.php:231 +msgid "Postman is configured." +msgstr "Postman est configuré." + +#: Postman/Postman-Mail/PostmanZendMailEngine.php:209 +msgid "Communication Error [334] - make sure the Envelope From email is the same account used to create the Client ID." +msgstr "Erreur de communications [334] - Assurez-vous que l'adresse d'envoi appartient au compte qui a fourni le consentement de OAuth 2.0." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:115 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:149 +msgctxt "Email Test Status" +msgid "In Outbox" +msgstr "Dans la boîte d'envoi" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:116 +msgctxt "Email Test Status" +msgid "Sending..." +msgstr "Envoi..." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:117 +msgctxt "Email Test Status" +msgid "Success" +msgstr "Succès" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:118 +msgctxt "Email Test Status" +msgid "Failed" +msgstr "Echoué" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:119 +msgid "Ajax Error" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:128 +#: Postman/PostmanViewController.php:273 Postman/PostmanViewController.php:275 +msgid "Send a Test Email" +msgstr "Envoyer un message test" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:133 +msgid "Specify the Recipient" +msgstr "Choisir un récipiandaire" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:135 +msgid "Who is this message going to?" +msgstr "Qui est ce message pour?" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:136 +msgid "This utility allows you to send an email message for testing." +msgstr "Cette fonction vous permet d'envoyer un message en test." + +#. translators: where %d is an amount of time, in seconds +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:139 +msgid "If there is a problem, Postman will give up after %d second." +msgid_plural "If there is a problem, Postman will give up after %d seconds." +msgstr[0] "S'il rencontre un problème, Postman abandonnera la tâche après %d second." +msgstr[1] "S'il rencontre un problème, Postman abandonnera la tâche après %d secondes." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:140 +msgctxt "Configuration Input Field" +msgid "Recipient Email Address" +msgstr "Adresse d'envoi" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:145 +msgid "Send The Message" +msgstr "Envoyez le Message" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:148 +msgid "Sending the message:" +msgstr "Envoi du message:" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:160 +msgid "Examine the Session Transcript if you need to." +msgstr "Examinez la session SMTP Transcription si vous devez." + +#. translators: where %s is the domain name of the site +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:212 +msgctxt "Test Email Subject" +msgid "Postman SMTP Test (%s)" +msgstr "Test SMTP de Postman (%s)" + +#. translators: where %s is the Postman plugin version number (e.g. 1.4) +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:299 +msgctxt "Test Email Tagline" +msgid "Sent by Postman %s" +msgstr "Envoyé par Postman %s" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:300 +msgid "Image source" +msgstr "Source de l'image" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:301 +msgid "Used with permission" +msgstr "Utilisé avec permission" + +#: Postman/PostmanAdminController.php:111 +msgctxt "The plugin successfully saved new settings." +msgid "Settings saved." +msgstr "Options enregistrées." + +#. Translators: where %1$s is the name of the library +#: Postman/PostmanAdminController.php:178 +msgid "This PHP installation requires the %1$s library." +msgstr "Cette installation de PHP nécessite la %1$s bibliothèque." + +#: Postman/PostmanAdminController.php:253 +msgid "There was an error importing the data." +msgstr "" + +#: Postman/PostmanAdminController.php:270 +msgid "Plugin data was removed." +msgstr "Tous les paramètres des plugins ont été enlevés." + +#: Postman/PostmanAdminController.php:294 +msgid "The OAuth 2.0 authorization was successful. Ready to send e-mail." +msgstr "L'autorisation de OAuth 2.0 a réussi. Prêt à envoyer des messages électroniques." + +#: Postman/PostmanAdminController.php:296 +msgid "Your email provider did not grant Postman permission. Try again." +msgstr "Votre fournisseur de messagerie n'a pas accordé la permission à Postman. Réessayez. " + +#: Postman/PostmanAdminController.php:299 +msgid "The grant code from Google had no accompanying state and may be a forgery" +msgstr "Le code de subvention de Google n'avait pas l'état d'accompagnement et peut être un faux" + +#. translators: %s is the error message +#: Postman/PostmanAdminController.php:303 +msgid "Error authenticating with this Client ID. [%s]" +msgstr "Erreur authentification avec cet ID de Client. [%s]" + +#: Postman/PostmanConfigTextHelper.php:31 +msgid "Attention" +msgstr "Faites attention" + +#. translators: parameters available are 1=portal-url, 2=portal-name, +#. 3=clientId-name, 4=clientSecret-name, 5=callbackUrl, 6=service-name, +#. 7=portal-application (e.g. Open the Google Developer Console, create a +#. Client ID for web application using the URL's displayed below, and copy the +#. Client ID and Client Secret here.) +#: Postman/PostmanConfigTextHelper.php:33 +msgid "Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +msgstr "Ouvrez le %2$s, créer %7$s avec les valeurs affichées ci-dessous, et copiez les générés %3$s et %4$s ici." + +#. translators: parameters available are 1=clientId-name, 2=service-name, +#. 3=FAQ-URL, 4=Video-URL (e.g. See How do I get a Google Client ID? in the +#. F.A.Q.) +#: Postman/PostmanConfigTextHelper.php:36 +msgid "See How do I get a %1$s %2$s? in the F.A.Q. or watch our How-To video 📺." +msgstr "Voir Comment faire un %1$s %2$s? dans la F.A.Q. ou regarder notre 📺 vidéo How-to." + +#. translators: where %s is the Email Service Owner (e.g. Google, Microsoft or +#. Yahoo) +#: Postman/PostmanConfigTextHelper.php:54 +msgctxt "Command to initiate OAuth authentication" +msgid "Grant permission with %s" +msgstr "Accorder l'autorisation avec %s" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:80 +#: Postman/PostmanConfigTextHelper.php:142 +#: Postman/PostmanConfigTextHelper.php:204 +#: Postman/PostmanConfigTextHelper.php:271 +msgctxt "Name of the OAuth 2.0 Client ID" +msgid "Client ID" +msgstr "ID du client" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:84 +#: Postman/PostmanConfigTextHelper.php:146 +#: Postman/PostmanConfigTextHelper.php:208 +#: Postman/PostmanConfigTextHelper.php:274 +msgctxt "Name of the OAuth 2.0 Client Secret" +msgid "Client Secret" +msgstr "Secret du client" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:88 +msgctxt "Name of the Application Callback URI" +msgid "Authorized redirect URI" +msgstr "Authorized redirect URI" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:92 +msgctxt "Name of the Application Callback Domain" +msgid "Authorized JavaScript origins" +msgstr "Authorized JavaScript origins" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:96 +msgctxt "Name of the email service owner" +msgid "Google" +msgstr "Google" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:100 +msgctxt "Name of the email service" +msgid "Gmail" +msgstr "Gmail" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:104 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "a Client ID for web application" +msgstr "un ID de client pour une application web." + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:108 +msgctxt "Name of the email service portal" +msgid "Google Developers Console Gmail Wizard" +msgstr "Console de développement Google" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:150 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URL" +msgstr "Rediriger URL" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:154 +msgctxt "Name of the Application Callback Domain" +msgid "Root Domain" +msgstr "Domaine Souche" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:158 +msgctxt "Name of the email service owner" +msgid "Microsoft" +msgstr "Microsoft" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:162 +msgctxt "Name of the email service" +msgid "Outlook.com" +msgstr "Outlook.com" + +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:166 +#: Postman/PostmanConfigTextHelper.php:228 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "an Application" +msgstr "un programme" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:170 +msgctxt "Name of the email service portal" +msgid "Microsoft Developer Center" +msgstr "Centre de Développement Microsoft" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:212 +msgctxt "Name of the Application Callback URI" +msgid "Home Page URL" +msgstr "URL de la Page d'Acceuil" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:216 +msgctxt "Name of the Application Callback Domain" +msgid "Callback Domain" +msgstr "Domaine de retour d'appel" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:220 +msgctxt "Name of the email service owner" +msgid "Yahoo" +msgstr "Yahoo" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:224 +msgctxt "Name of the email service" +msgid "Yahoo Mail" +msgstr "Yahoo Mail" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:232 +msgctxt "Name of the email service portal" +msgid "Yahoo Developer Network" +msgstr "Réseau de Développement de Yahoo" + +#: Postman/PostmanConfigTextHelper.php:261 +msgid "Enter an Outgoing Mail Server with OAuth2 capabilities." +msgstr "Adhérer à un serveur d'envoi avec des compatibilitées OAuth 2.0." + +#: Postman/PostmanConfigTextHelper.php:277 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URI" +msgstr "Rediriger URI" + +#: Postman/PostmanConfigTextHelper.php:280 +msgctxt "Name of the Application Callback Domain" +msgid "Website Domain" +msgstr "Nom de domaine web" + +#: Postman/PostmanConfigTextHelper.php:304 +msgid "Grant OAuth 2.0 Permission" +msgstr "Demander l'autorisation de OAuth 2.0" + +#: Postman/PostmanInputSanitizer.php:137 +msgid "must be greater than 0" +msgstr "doit être supérieur à 0" + +#: Postman/PostmanViewController.php:112 +msgid "An unexpected error occurred" +msgstr "" + +#: Postman/PostmanViewController.php:113 +msgid "Unexpected PHP messages corrupted the Ajax response" +msgstr "" + +#: Postman/PostmanViewController.php:118 +msgctxt "Press this button to Finish this task" +msgid "Finish" +msgstr "Fin" + +#: Postman/PostmanViewController.php:119 +msgctxt "Press this button to go to the next step" +msgid "Next" +msgstr "Prochain" + +#: Postman/PostmanViewController.php:120 +msgctxt "Press this button to go to the previous step" +msgid "Previous" +msgstr "Précédent" + +#: Postman/PostmanViewController.php:132 +msgid "Postman is unable to run. Email delivery is being handled by WordPress (or another plugin)." +msgstr "WordPress (ou un autre plugin) gère actuellement la livraison d'email, pas Postman." + +#. translators: where %d is the number of emails delivered +#: Postman/PostmanViewController.php:147 +msgid "Postman has delivered %d email." +msgid_plural "Postman has delivered %d emails." +msgstr[0] "Postier a livré %d courriel." +msgstr[1] "Postier a livré %d courriels." + +#: Postman/PostmanViewController.php:150 +msgid "The last %d email attempts are recorded in the log." +msgstr "Les derniers %d tentatives email sont enregistrés dans le journal." + +#: Postman/PostmanViewController.php:155 +msgid "Thank-you for choosing Postman!" +msgstr "Merci d'avoir choisi Postman!" + +#. translators: where %s is the URL of the Setup Wizard +#: Postman/PostmanViewController.php:157 +msgid "Let's get started! All users are strongly encouraged to run the Setup Wizard." +msgstr "Commençons! Tout les utilisateurs sont fortements encouragés à commencer mettre en marche le Setup Wizard." + +#: Postman/PostmanViewController.php:158 +msgid "Alternately, manually configure your own settings and/or modify advanced options." +msgstr "Alternativement, configurer manuellement vos propres paramètres et / ou modifier les options avancées." + +#. translators: where %s is the URL to the WordPress.org review and ratings +#. page +#: Postman/PostmanViewController.php:163 +msgid "Please consider leaving a review to help spread the word! :D" +msgstr "Se il vous plaît envisager de laisser une critique de Postman SMTP pour aider à passer le mot! :D" + +#: Postman/PostmanViewController.php:165 +msgid "Postman needs translators! Please take a moment to translate a few sentences on-line" +msgstr "" + +#: Postman/PostmanViewController.php:167 +msgid "New for v1.7! Send mail with the Mandrill or SendGrid APIs." +msgstr "" + +#: Postman/PostmanViewController.php:191 +msgctxt "Return to main menu link" +msgid "Back To Main Menu" +msgstr "Retour au menu principal" + +#: Postman/PostmanViewController.php:198 Postman/PostmanViewController.php:233 +#: Postman/PostmanViewController.php:284 +msgid "Import" +msgstr "Import" + +#: Postman/PostmanViewController.php:199 Postman/PostmanViewController.php:285 +msgid "Export" +msgstr "Export" + +#: Postman/PostmanViewController.php:200 Postman/PostmanViewController.php:286 +msgid "Reset Plugin" +msgstr "" + +#: Postman/PostmanViewController.php:206 +msgid "Copy this data into another instance of Postman to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:225 +msgid "Paste data from another instance of Postman here to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:228 +msgid "Using the same OAuth 2.0 Client ID and Client Secret from this site at the same time as another site will cause failures." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "This will purge all of Postman's settings, including account credentials and the email log." +msgstr "Cette purge tous les paramètres du postier, y compris les informations d'identification de compte et le journal de la messagerie." + +#: Postman/PostmanViewController.php:241 +msgid "Are you sure?" +msgstr "En êtes-vous sûre?" + +#: Postman/PostmanViewController.php:261 +msgid "Configuration" +msgstr "Configuration" + +#: Postman/PostmanViewController.php:262 +msgid "Start the Wizard" +msgstr "Mettre en marche le Wizard" + +#: Postman/PostmanViewController.php:263 +msgid "Show All Settings" +msgstr "" + +#: Postman/PostmanViewController.php:266 +msgctxt "Main Menu" +msgid "Actions" +msgstr "Actions" + +#: Postman/PostmanViewController.php:292 +msgctxt "Main Menu" +msgid "Troubleshooting" +msgstr "Dépannage" + +#: Postman/PostmanViewController.php:296 +msgid "Online Support" +msgstr "Assistance en ligne" + +#. Plugin URI of the plugin/theme +msgid "https://wordpress.org/plugins/postman-smtp/" +msgstr "https://fr.wordpress.org/plugins/postman-smtp/" + +#. Description of the plugin/theme +msgid "Email not reliable? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +msgstr "Email ne fonctionne pas? Postman est le premier et seul plugin WordPress SMTP pour mettre en œuvre la sécurité OAuth 2.0 pour Gmail et Hotmail. L'installation est un jeu d'enfant avec l'assistant de configuration et intégrée Port Tester. Profitez de la livraison sans souci, même si les modifications de mot de passe!" + +#. Author of the plugin/theme +msgid "Jason Hendriks" +msgstr "Jason Hendriks" + +#. Author URI of the plugin/theme +msgid "http://www.codingmonkey.ca" +msgstr "http://www.codingmonkey.ca" + +#~ msgid "Change the delivery method on the %s!" +#~ msgstr "Changer la méthode de livraison sur la %s!" + +#~ msgid "Configure the plugin." +#~ msgstr "Configurez le plugin" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Test Your Setup" +#~ msgstr "Tester votre configuration" + +#~ msgctxt "eg. TCP Port 25" +#~ msgid "Port" +#~ msgstr "Port" + +#~ msgid "New for v1.6! Email Log" +#~ msgstr "Du nouveau pour v1.6! Journal de courriel" + +#~ msgid "Enable to save a copy of all your emails. Great for troubleshooting or as a backup for messages that get lost. Access the Email Log in the Tools menu." +#~ msgstr "Permettre d'enregistrer une copie de tous vos emails. Idéal pour le dépannage ou une sauvegarde des messages qui se perdent. Accéder au journal des Email dans le menu Outils." + +#~ msgctxt "The configuration page of the plugin" +#~ msgid "Settings" +#~ msgstr "Réglages" + +#~ msgid "Postman is not handling email delivery." +#~ msgstr "Postman n'intercepte pas les demandes de courrier." + +#~ msgctxt "As in type used: None" +#~ msgid "None" +#~ msgstr "Aucun" + +#~ msgctxt "Who do we reply to?" +#~ msgid "Reply-To" +#~ msgstr "Reply-To" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +#~ msgstr "C'est la conversation entre Postman et votre serveur SMTP. Il peut être utile pour diagnostiquer les problèmes. NE PAS poster en ligne, il peut contenir votre mot de passe sous forme codée." + +#~ msgid "Postman Email Log" +#~ msgstr "Niveau du journal" + +#~ msgid "This is a record of deliveries made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Il s'agit d'un record de tentatives de remise faite à l'Agent de Submission Courrier (ASC). Il n'indique pas nécessairement sucessful remise au destinataire." + +#~ msgid "Warning: An empty subject line can result in delivery failure." +#~ msgstr "Attention: Une ligne d'objet vide peut provoquer l'échec de la livraison." + +#~ msgctxt "View the transcript of an item from the email log" +#~ msgid "Transcript" +#~ msgstr "Transcription" + +#~ msgctxt "Attempt to resend this email" +#~ msgid "Resend" +#~ msgstr "Renvoyer" + +#~ msgctxt "Was sending this email successful or not?" +#~ msgid "Status" +#~ msgstr "Statut" + +#~ msgctxt "Transport Name" +#~ msgid "Gmail API" +#~ msgstr "Gmail API" + +#~ msgctxt "Authentication Type is OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2,0" + +#~ msgid "Postman will send mail via the 🔐Gmail API using %s authentication." +#~ msgstr "Postier enverra des mails via l'🔐Gmail API en utilisant l'authentification de %s." + +#~ msgid "OAuth 2.0 authentication requires a Client ID and Client Secret." +#~ msgstr "L'authentification OAuth 2.0 requiert un ID de Client, et un Secret du client." + +#~ msgid "Envelope From Address and Message From Address can not be empty." +#~ msgstr "Adresse d'expéditeur d'enveloppe et adresse d'expéditeur du message ne peut être vide." + +#~ msgid "Postman recommends Gmail API configuration on port %d" +#~ msgstr "Recommande configuration API Gmail sur le port %d" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP" +#~ msgstr "SMTP" + +#~ msgctxt "as in \"There is no Authentication\"" +#~ msgid "no" +#~ msgstr "non" + +#~ msgctxt "As in type used: CRAM-MD5" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "As in type used: Login" +#~ msgid "Login" +#~ msgstr "Login" + +#~ msgctxt "As in type used: Plain" +#~ msgid "Plain" +#~ msgstr "Vide" + +#~ msgctxt "This authentication type is password-based" +#~ msgid "Password (%s)" +#~ msgstr "Mot de Passe (%s)" + +#~ msgid "Password authentication (Plain/Login/CRAM-MD5) requires a username and password." +#~ msgstr "L'authentification par mot de passe (plaine / Connexion / CRAMMD5) nécessite un nom d'utilisateur et mot de passe." + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, %1$s, and %2$s." +#~ msgstr "Attention: L'authentification OAuth 2.0 requiert un serveur d'envoi valide avec OAuth 2.0, un adresse d'expédition, un %1$s, et un %2$s." + +#~ msgid "Your recommended settings are %1$s with %2$s authentication to host %4$s on port %3$d." +#~ msgstr "Vos paramètres recommandés sont%1$s avec l'authentification de 2% $ pour organiser%4$s sur le port% 3 $ d." + +#~ msgid "The selected transport '%s' is unavailable. The external plugin was probably deactivated." +#~ msgstr "Le transport sélectionné '%s' ne est pas disponible. Le plugin externe a été probablement désactivée." + +#~ msgid "WordPress is still handling email delivery, not Postman." +#~ msgstr "Postman n'intercepte pas les demandes de courrier." + +#~ msgctxt "The Transport is the method for sending mail, SMTP or API" +#~ msgid "Transport" +#~ msgstr "Transport" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport Settings" +#~ msgstr "Réglages de Transport" + +#~ msgctxt "Authentication proves the user's identity" +#~ msgid "Authentication" +#~ msgstr "Authentification" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Username" +#~ msgstr "Nom d'Utilisateur" + +#~ msgctxt "The Envelope Sender Email Address" +#~ msgid "Envelope From Address" +#~ msgstr "Adresse d'expéditeur d'enveloppe" + +#~ msgctxt "The Message Sender Email Address" +#~ msgid "Message From Address" +#~ msgstr "Adresse d'expéditeur du message" + +#~ msgctxt "The email address to address replies to" +#~ msgid "Reply-To" +#~ msgstr "Reply-To" + +#~ msgid "Maximum Number of Log Entries" +#~ msgstr "Entrées de journal de courrier ont été supprimées." + +#~ msgid "Maximum Number of Lines in a Transcript" +#~ msgstr "Taille de la transcription (Total des lignes)" + +#~ msgid "Configure the communication with the Mail Submission Agent (MSA):" +#~ msgstr "Configurer la communication avec Agent de Submission Courrier (ASC):" + +#~ msgid "Enter the account username (email address) and password:" +#~ msgstr "Entrer le nom d'utilisateur (adresse de messagerie) et mot de passe." + +#~ msgid "This will purge all of Postman's settings, including SMTP server info, username/password and OAuth Credentials." +#~ msgstr "Cette action réinitialiser a tous les réglages de Postman, incluant les informations du serveur SMTP, nom d'utilisateur/mot de passe et l'accréditation OAuth." + +#~ msgid "Log Level specifies the level of detail written to the WordPress log - view the log with Debug. Delivery mode offers options useful for developing or testing." +#~ msgstr "Niveau du journal spécifie le niveau de détail dans le journal de WordPress - afficher le journal avec Debug. Mode de livraison propose des options utiles pour le développement ou de test." + +#~ msgctxt "Log Level" +#~ msgid "Off" +#~ msgstr "Off" + +#~ msgctxt "Log Level" +#~ msgid "Trace" +#~ msgstr "Trace" + +#~ msgctxt "Log Level" +#~ msgid "Debug" +#~ msgstr "Début" + +#~ msgctxt "Log Level" +#~ msgid "Info" +#~ msgstr "Info" + +#~ msgctxt "Log Level" +#~ msgid "Warning" +#~ msgstr "Warning" + +#~ msgctxt "Log Level" +#~ msgid "Error" +#~ msgstr "Error" + +#~ msgid "Attention! Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +#~ msgstr "Attention! Ouvrez le %2$s, créer %7$s avec les valeurs affichées ci-dessous, et copiez les générés %3$s et %4$s ici." + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Grant OAuth Permission" +#~ msgstr "Demander l'autorisation de OAuth." + +#~ msgid " must be greater than 0" +#~ msgstr "doit être supérieur à 0" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup" +#~ msgstr "Réglages de Postman" + +#~ msgid "Welcome" +#~ msgstr "Bienvenue" + +#~ msgid "This is the Settings page for Postman, an SMTP mailer that delivers email from your WordPress site to the Internet. From here you can configure the plugin, and access testing and diagnostic tools." +#~ msgstr "Il s'agit de la page Paramètres du postier, un mailer SMTP qui fournit courriel provenant de votre site WordPress à l'Internet. De là, vous pouvez configurer le plugin et accéder aux outils de tests et de Diagnostics." + +#~ msgid "Having trouble? You can ask for help on our Support Forum. To get the help you need quickly, please post the Diagnostic Data with your question. You can also check the FAQ and Error Messages pages for answers." +#~ msgstr "Avoir l'ennui ? Vous pouvez demander de l'aide sur notre Forum de Support. Pour obtenir l'aide dont vous avez besoin rapidement, veuillez publier les Données de Diagnostic avec votre question. Vous pouvez également consulter les pages FAQ et Messages d'erreur pour obtenir des réponses." + +#~ msgid "The Email Test will send an email to you. If the test fails, the full SMTP session transcript is available to you.

    Receiving a single test email does not indicate perfect configuration. Some services may dump your email into a black-hole or mark it as Spam if you:" +#~ msgstr "Le Test Email enverra un e-mail pour vous. Si le test échoue, la transcription complète de session SMTP est à votre disposition.

    Recevez un e-mail de test unique n'indique pas la configuration parfaite. Certains services peuvent vider votre e-mail dans un trou noir ou le marquer comme Spam si vous :" + +#~ msgid "Violate an SPF record" +#~ msgstr "Violer un enregistrement SPF" + +#~ msgid "You must use the SMTP server (MSA) approved by your domain to deliver your mail. (eg.) a @gmail.com sender address requires that authentication and delivery always be through smtp.gmail.com." +#~ msgstr "Vous devez utiliser le serveur SMTP (ASC), approuvé par votre nom de domaine pour votre courrier entrant. Par exemple, une adresse de l'expéditeur @gmail.com exige que l'authentification et la livraison toujours par smtp.gmail.com." + +#~ msgctxt "Forge as in a forgery (fake) is made" +#~ msgid "Forge the From Address" +#~ msgstr "Forger l'adresse" + +#~ msgid "Spoofing, when it results in an SPF violation, will get your message binned. Use your own address as the sender (From:) in every email." +#~ msgstr "Spoofing , quand il aboutit à une violation SPF, va faire passer votre message mis en cellule. Utilisez votre propre adresse comme expéditeur (De :) dans chaque email. " + +#~ msgid "Consolidates details of your setup to aid the author in debugging problems, including: operating system details, WordPress configuration, Postman configuration, network connectivity and your domain's primary MX and SPF records. Your private authorization credentials are masked." +#~ msgstr "Consolide détails de votre installation pour aider l'auteur dans le débogage des problèmes, y compris: les détails du système d'exploitation, la configuration, la configuration WordPress Postman, la connectivité réseau et primaires enregistrements MX et SPF de votre domaine. Vos informations d'identification d'autorisation privées sont masquées." + +#~ msgid "The Connectivity Test will report this site's ability to reach a mail server, and interrogate the mail server for it's capabilities." +#~ msgstr "Le Test de connectivité sera rapport capacité de ce site pour atteindre un serveur de messagerie et interroger le serveur de messagerie pour ses capacités." + +#~ msgctxt "Is it possible to create network connections to the Internet?" +#~ msgid "Outbound to Internet" +#~ msgstr "Sortant à Internet" + +#~ msgid "This tests the ability to make outbound connections from your site to the Internet in general. If the result is Closed, then there is a communication problem with the Internet, like a firewall." +#~ msgstr "Il teste la capacité de faire les connexions sortantes de votre site Internet en général. Si le résultat est fermé, puis il y a un problème de communication avec l'Internet, comme un pare-feu." + +#~ msgctxt "What service is available?" +#~ msgid "Service Available" +#~ msgstr "Service Disponible" + +#~ msgid "This shows the service found for a particular host/port. Possible successful results are SMTP, SMTPS (secure) and HTTPS (secure). If the result is No and the hostname you entered is correct, there was a communication problem with the mail server, like a firewall." +#~ msgstr "Cela montre le service trouvé pour un hôte/port particulier. Résultats positifs possibles sont le SMTP, SMTPS (sécurisé) et HTTPS (sécurisé). Si le résultat est non, et le nom d'hôte que vous avez entré est correct, il y avait un problème de communication avec le serveur de messagerie, comme un pare-feu." + +#~ msgctxt "What is this server's ID?" +#~ msgid "ID" +#~ msgstr "ID" + +#~ msgid "Some hosts redirect mail traffic to their own mail server, breaking authentication and SPF verification. This is revealed by an incorrect server identity." +#~ msgstr "Certains hébergeurs de redirigent le trafic de courrier à leur propre serveur de messagerie, rupture d'authentification et de vérification SPF. Ceci est révélé par une identité de serveur incorrect." + +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgid "This indicates whether the server supports protocol-level security. Either STARTTLS, SMTPS or HTTPS is required for secure transmission of your credentials." +#~ msgstr "Ceci indique si le serveur prend en charge la sécurité au niveau du protocole. STARTTLS, SMTPS ou HTTPS est requis pour la transmission sécurisée de vos informations d'identification." + +#~ msgctxt "Short for Authentication" +#~ msgid "Auth" +#~ msgstr "Auth" + +#~ msgid "This indicates the authenication methods that the server supports. All are password-based, except for OAuth 2.0, which is token-based." +#~ msgstr "Ceci indique les méthodes d'authentification que le serveur prend en charge. Tous sont par mot de passe, à l'exception de OAuth 2.0, qui est basée sur les jetons." + +#~ msgctxt "A testing tool which determines connectivity to the Internet" +#~ msgid "Connectivity Test" +#~ msgstr "Test de connectivité" + +#~ msgctxt "Email Test Status" +#~ msgid "Ajax Error" +#~ msgstr "Erreur AJAX" + +#~ msgid "Unexpected PHP messages corrupted the Ajax response:" +#~ msgstr "Les messages PHP inattendus corrompu la réponse Ajax :" + +#~ msgid "Warning: connected to %1$s instead of %2$s." +#~ msgstr "Avertissement: connecté à %1$s au lieu de %2$s." + +#~ msgid "Port %d can be used to send Gmail with the Gmail API." +#~ msgstr "Port %d peut servir à envoyer Gmail avec l'API de Gmail." + +#~ msgid "WordPress (or another plugin) is currently handling email delivery, not Postman." +#~ msgstr "WordPress (ou un autre plugin) gère actuellement la livraison d'email, pas Postman." + +#~ msgctxt "Page Title" +#~ msgid "Manual Configuration" +#~ msgstr "Configuration manuelle" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Account" +#~ msgstr "Compte" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Message" +#~ msgstr "Message" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Logging" +#~ msgstr "Journalisation" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Advanced" +#~ msgstr "Paramètres avancés" + +#~ msgid "Delete plugin settings" +#~ msgstr "Supprimer les réglages de l'extension" + +#~ msgid "This will purge all of Postman's settings, including account credentials and the mail log." +#~ msgstr "Cette purge tous les paramètres du postier, y compris les informations d'identification de compte et le journal de la messagerie." + +#~ msgctxt "Button Label" +#~ msgid "Delete All Data" +#~ msgstr "Supprimer toutes les données" + +#~ msgctxt "The port number" +#~ msgid "Port %s" +#~ msgstr "Port %s" + +#~ msgctxt "Authentication Type" +#~ msgid "None" +#~ msgstr "Aucun" + +#~ msgid "* Port 443 tests against googleapis.com, not the SMTP hostname you enter." +#~ msgstr "* Port 443 teste contre googleapis.com, pas le nom d'hôte SMTP vous entrez." + +#~ msgid "A port with Service Available \"No\" indicates one or more of these issues:" +#~ msgstr "Un port Fermé peut vouloir dire ceci:" + +#~ msgid "Your PHP configuration is preventing outbound connections" +#~ msgstr "Votre configuration de PHP empêche les connexions sortantes" + +#~ msgid "Your WordPress configuration is preventing outbound connections" +#~ msgstr "Votre configuration de WordPress empêche les connexions sortantes" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "Show Advanced Configuration" +#~ msgstr "Configuration avancée" + +#~ msgid "Disable" +#~ msgstr "Désactiver" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup Wizard" +#~ msgstr "Setup Wizard de Postman" + +#~ msgid "Error: Your email address requires access to a remote SMTP server blocked by GoDaddy. Use a different e-mail address." +#~ msgstr "Erreur: Votre adresse e-mail nécessite l'accès à un serveur SMTP distant bloqué par GoDaddy. Utilisez une adresse e-mail différente." + +#~ msgid "Warning: If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems." +#~ msgstr "Attention: Si vous possédez ce domaine, assurez-vous qu'il a un enregistrement SPF autorisant GoDaddy comme un relais, ou vous aurez des problèmes de livraison." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will the connection to the MSA be established?" +#~ msgstr "Comment la connexion au ASC sera créé?" + +#~ msgid "Warning: This configuration option will send your authorization credentials in the clear." +#~ msgstr "AVERTISSEMENT : Cette option de configuration envoie vos informations d'identification de l'autorisation en clair." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will you prove your identity to the MSA?" +#~ msgstr "Comment allez-vous prouver votre identité à la ASC?" + +#~ msgid "Enter your credentials. Your username is often your email address." +#~ msgstr "Entrez vos informations d'identification. Votre nom d'utilisateur est souvent votre adresse email." + +#~ msgid "Examine the SMTP Session Transcript if you need to." +#~ msgstr "Examinez la session SMTP Transcription si vous devez." + +#~ msgid "SMTP Session Transcript" +#~ msgstr "Transcription de la session SMTP" + +#~ msgid "The Envelope From address identifies the account owner to the SMTP server." +#~ msgstr "L'adresse d'expéditeur d'enveloppe identifie le propriétaire du compte sur le serveur SMTP." + +#~ msgid "The Message From address identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Themes and other plugins, especially Contact Forms, are permitted to modify this field." +#~ msgstr "L'adresse d'expéditeur du message identifie l'expéditeur au destinataire. Changer cela lorsque vous envoyez au nom de quelqu'un d'autre, par exemple d'utiliser Envoyer Mail en tant que fonctionnalité Google. Thèmes et autres plugins, notamment les formulaires de Contact, sont autorisés à modifier ce champ." + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful for developing or testing." +#~ msgstr "Niveau du journal spécifie le niveau de détail écrite dans les fichiers journaux de WordPress et PHP. Mode de livraison offre des options utiles dans un environnement de développement." + +#~ msgid "The server returned an unexpected result:" +#~ msgstr "Le serveur a renvoyé un résultat inattendu et non valide :" + +#~ msgid "Postman has delivered %d email for you." +#~ msgid_plural "Postman has delivered %d emails for you." +#~ msgstr[0] "Postman a livré %d e-mail pour vous." +#~ msgstr[1] "Postman a livré %d e-mails pour vous." + +#~ msgid "View the log" +#~ msgstr "Niveau du journal" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "configure manually" +#~ msgstr "configurer manuellement" + +#~ msgid "The server returned an unexpected and invalid result:" +#~ msgstr "Le serveur a renvoyé un résultat inattendu et non valide :" + +#~ msgid "Communication Error [334] - make sure the Sender Email belongs to the account which provided the OAuth 2.0 consent." +#~ msgstr "Erreur de communications [334] - Assurez-vous que l'adresse d'envoi appartient au compte qui a fourni le consentement de OAuth 2.0." + +#~ msgid "https://profiles.wordpress.org/jasonhendriks/" +#~ msgstr "https://profiles.wordpress.org/jasonhendriks/" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your shared secret (password) in encoded form." +#~ msgstr "C'est la conversation entre Postman et votre serveur SMTP. Il peut être utile pour diagnostiquer les problèmes. NE PAS poster en ligne, il peut contenir votre mot de passe sous forme codée." + +#~ msgid "Choose the Recipient" +#~ msgstr "Choisir un récipiandaire" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Email Address" +#~ msgstr "Adresse e-mail" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Name" +#~ msgstr "Nom" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Envelope From Address" +#~ msgstr "Adresse d'expéditeur d'enveloppe" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Message From Address" +#~ msgstr "Adresse d'expéditeur du message" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Email Addresses" +#~ msgstr "Adresses e-mail supplémentaires" + +#~ msgctxt "Configuration Input Field" +#~ msgid "To Recipient(s)" +#~ msgstr "Pour destinataire(s)" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Carbon Copy Recipient(s)" +#~ msgstr "Récipiendaires Carbon Copy" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Blind Carbon Copy Recipient(s)" +#~ msgstr "Récipiendaires Blind Carbon Copy" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Headers" +#~ msgstr "Têtes additionnels" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Custom Headers" +#~ msgstr "Têtes personnalisés" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Enable Logging" +#~ msgstr "Activer la journalisation" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Log Entries Limit" +#~ msgstr "Limite d'entrées de journal" + +#~ msgctxt "The maximum number of lines of the SMTP transcript" +#~ msgid "Transcript Size (Total Lines)" +#~ msgstr "Taille de la transcription (Total des lignes)" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Network Settings" +#~ msgstr "Paramètres réseau" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Envelope From" +#~ msgstr "Enveloppe De" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Message From" +#~ msgstr "Message De" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Addresses" +#~ msgstr "Adresses supplémentaires" + +#~ msgid "The Gmail API transport requires a Sender Email Address, Client ID and Client Secret." +#~ msgstr "Le Gmail API nécessite un transport à l'expéditeur Adresse courriel, numéro de client et client secret." + +#~ msgid "Outgoing Mail Server Hostname/Port and Sender Email Address can not be empty." +#~ msgstr "Sortant Mail Server Hostname/Port et adresse Email de l'expéditeur ne peuvent pas être vide." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Sender" +#~ msgstr "l'Expéditeur" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Email Address" +#~ msgstr "Adresse de l'expéditeur" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Name" +#~ msgstr "Nom de l'expéditeur" + +#~ msgid "The Sender sets both the envelope Mail-From and the message From header. However, the From header can be modified by another plugin (e.g. for setting a visitor's email address from a Contact Form)." +#~ msgstr "L'expéditeur définit les deux l'enveloppe Mail-From et l'en-tête From message. Toutefois, l'en-tête From peut être modifié par un autre plugin (par exemple pour mettre en adresse e-mail du visiteur d'un formulaire de Contact)." + +#~ msgid "Force this in the From header for all messages" +#~ msgstr "Forcer cet expéditeur pour tous les messages" + +#~ msgid "Communication Error [334] - make sure the Sender Email belongs to the account which provided the %s OAuth 2.0 consent." +#~ msgstr "Erreur de communications [334] - Assurez-vous que l'adresse d'envoi appartient au compte qui a fourni le consentement %s de OAuth 2.0." + +#~ msgid "Please note that to combat Spam, many email services will not let you send from an email address other than the one you authenticate with." +#~ msgstr "Veuillez noter que pour combattre le Spam, plusieurs services de messagerie ne permettrons pas l'envoi d'un message provenant d'une autre adresse que la vôtre." + +#~ msgctxt "Who is this message from?" +#~ msgid "From" +#~ msgstr "De" + +#~ msgctxt "Who is this message to?" +#~ msgid "To" +#~ msgstr "A" + +#~ msgctxt "Name of the email service portal" +#~ msgid "Google Developer Console" +#~ msgstr "Console de développement Google" + +#~ msgid "Please check the troubleshooting and error messages page and the support forum.
    If you write for help, please include the following:" +#~ msgstr "Consultez la page des messages de dépannage et d'erreur et le forum de support.
    Si vous écrivez à l'aide, se il vous plaît inclure les informations de diagnostic suivant:" + +#~ msgid "Postman will send mail via the Gmail API using %s authentication." +#~ msgstr "Postier enverra des mails via l'Gmail API en utilisant l'authentification de %s." + +#~ msgctxt "Transport Name" +#~ msgid "SMTPS" +#~ msgstr "SMTPS" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP-STARTTLS" +#~ msgstr "SMTP-STARTTLS" + +#~ msgid "The message sender is used as the default From: address." +#~ msgstr "L'expéditeur du message est utilisé comme De: adresse." + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful in a development environment." +#~ msgstr "Niveau du journal spécifie le niveau de détail écrite dans les fichiers journaux de WordPress et PHP. Mode de livraison offre des options utiles dans un environnement de développement." + +#~ msgid "Force this Sender Name for all messages" +#~ msgstr "Forcer ce nom d'expéditeur pour tous les messages" + +#~ msgid "Force this Sender Email Address for all messages" +#~ msgstr "Forcer cette adresse E-mail de l'expéditeur pour tous les messages" + +#~ msgid "Please note: When composing email, some WordPress plugins and themes may set an unauthorized sender email address causing rejection with services like Yahoo Mail. If you experience problems, enable \"Force this Sender Email Address for all messages\" in the settings." +#~ msgstr "Veuillez noter : quand composer par courriel, à certains thèmes et plugins WordPress peut fixer un expéditeur non autorisé e-mail adresse rejet causant avec des services comme Yahoo Mail. Si vous rencontrez des problèmes, activez « Cette adresse E-mail de l'expéditeur pour tous les messages de Force » dans les paramètres." + +#~ msgctxt "Encryption Type" +#~ msgid "SSL (SMTPS)" +#~ msgstr "SSL (SMTPS)" + +#~ msgctxt "Encryption Type" +#~ msgid "TLS (StartTLS)" +#~ msgstr "TLS (StartTLS)" + +#~ msgid "The impossible is possible; sending through wp_mail() failed, but sending through internal engine succeeded." +#~ msgstr "L'impossible est possible; l'envoi avec wp_mail() à échoué, mais l'envoi interne à réussi." + +#~ msgid "Error: Postman is properly configured, but the current theme or another plugin is preventing service." +#~ msgstr "Erreur: Postman est correctement configuré, mais le thème actuel ou un autre plugin empêche service." + +#~ msgid "See How do I get a %6$s %3$s? in the F.A.Q. for help." +#~ msgstr "Visitez le Comment puis je avoir un %3$s de %6$s? dans la F.A.Q. pour de l'assistance." + +#~ msgctxt "Short for \"Diagnostic Information\"" +#~ msgid "Diagnostic Info" +#~ msgstr "Diagnostic Infos" + +#~ msgctxt "Details about the system" +#~ msgid "Diagnostic Information" +#~ msgstr "Informations de diagnostic" + +#~ msgid "Run a Connectivity Test" +#~ msgstr "Faire un test de connexion de port" + +#~ msgid "The most common transport is SMTP:" +#~ msgstr "Le transport le plus couramment est SMTP :" + +#~ msgid "Email not working? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +#~ msgstr "Email ne fonctionne pas? Postman est le premier et seul plugin WordPress SMTP pour mettre en œuvre la sécurité OAuth 2.0 pour Gmail et Hotmail. L'installation est un jeu d'enfant avec l'assistant de configuration et intégrée Port Tester. Profitez de la livraison sans souci, même si les modifications de mot de passe!" + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles." +#~ msgstr "Log Level spécifie le niveau de détail par écrit les fichiers journaux et WordPress PHP." + +#~ msgctxt "When the server is online to the public, this is \"Production\" mode" +#~ msgid "Production" +#~ msgstr "Production" + +#~ msgid "Log Emails, then Dump" +#~ msgstr "Connectez-mails, puis déposez." + +#~ msgid "Dump All Emails" +#~ msgstr "Supprimez toutes les e-mails" + +#~ msgid "This is a record of delivery attempts made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Il s'agit d'un record de tentatives de remise faite à l'Agent de Submission Courrier (ASC). Il n'indique pas nécessairement sucessful remise au destinataire." + +#~ msgid "Error authenticating with this Client ID - please create a new one. [%s]" +#~ msgstr "Erreur authentification avec cet ID client - s'l vous plaît, en créer un nouveau. [%s]" + +#~ msgid "Warning: connected to %1$s instead of %2$s. This may be a problem." +#~ msgstr "Avertissement: connecté à %1$s au lieu de %2$s. Cela peut être un problème." + +#~ msgid "Outgoing Mail Server (SMTP) and Port can not be empty." +#~ msgstr "Serveur de courrier sortant (SMTP) et Port ne peut être vide." + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, Sender Email Address, %1$s, and %2$s." +#~ msgstr "Attention: L'authentification OAuth 2.0 requiert un serveur d'envoi valide avec OAuth 2.0, un adresse d'expédition, un %1$s, et un %2$s." + +#~ msgid "Postman is properly configured, but another plugin has taken over the mail service. Deactivate the other plugin." +#~ msgstr "Postman à été configuré correctement, mais une autre extension a pris le contrôle de la messagerie. Désactivez l'autre extension." + +#~ msgctxt "postman-smtp" +#~ msgid "OAuth 2.0 (requires Client ID and Client Secret)" +#~ msgstr "OAuth 2.0 (nécessite ID de client et le client secret)" + +#~ msgid "Warning: Expected to reach %1$s but %2$s answered instead, something may be wrong." +#~ msgstr "ATTENTION : Devrait atteindre %1$s %2$s a répondu à la place, quelque chose peut être un problème." + +#~ msgid "Postman is missing a required PHP library." +#~ msgstr "Postman manque une bibliothèque PHP requise." + +#~ msgctxt "as in \"No Authentication\"" +#~ msgid "No" +#~ msgstr "Non" + +#~ msgid "Your recommended settings are %1$s with %2$s authentication on port %3$d." +#~ msgstr "Recommandons %1$s avec l'authentification de %2$s sur le port %3$d." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Logging Settings" +#~ msgstr "Paramètres de journalisation" + +#~ msgid "Attention! Open the %2$s, create %7$s using the URL's displayed below, and copy the %3$s and %4$s here." +#~ msgstr "Faites attention! Ouvrez %2$s, créer %7$s en utilisant l'URL qui apparaît ci-dessous, puis copiez le %3$s et le %4$s ici.\"" + +#~ msgid "Please wait for the port test to finish" +#~ msgstr "S'il vous plaît attendre la fin du test de port" + +#~ msgid "Warning: Your email address belongs to %1$s, but you are not using the %1$s SMTP server. Mail delivery will not be reliable." +#~ msgstr "AVERTISSEMENT : Votre adresse e-mail appartient à %1$s, mais vous n'utilisez pas le serveur SMTP de %1$s. La distribution du courrier ne sera pas fiable." + +#~ msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. These servers are specific to your email account, and if you don't know what to use, ask your email service provider." +#~ msgstr "C'est le serveur de courrier sortant (SMTP), ou Agent de Submission Courrier (ASC), dont les représentants postier courrier à. Ces serveurs sont spécifiques à votre compte de messagerie et si vous ne savez pas quoi utiliser, demandent à votre fournisseur de service de messagerie." + +#~ msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows. Postman will attempt to determine which options are available to you." +#~ msgstr "Le nom d'hôte du serveur et le port, vous pouvez utiliser est une combinaison de ce que votre service de courrier offres des fournisseurs, et ce que votre hôte WordPress permet. Postman tentera de déterminer les options qui se offrent à vous." + +#~ msgid "Configuration will proceed on socket %1$s using %2$s authentication." +#~ msgstr "Configuration procédera sur le socket %1$s en utilisant l'authentification de %2$s." + +#~ msgid "Forge the From Address" +#~ msgstr "Forger l'adresse" + +#~ msgctxt "The port number" +#~ msgid "Port %d" +#~ msgstr "Port %d" + +#~ msgctxt "Authentication Type" +#~ msgid "Plain" +#~ msgstr "Vide" + +#~ msgctxt "Authentication Type" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2,0" + +#~ msgctxt "As in type used: OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2,0" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Test" +#~ msgstr "Test" + +#~ msgctxt "Port Test" +#~ msgid "Port %s" +#~ msgstr "Port %s" + +#~ msgctxt "Authentication Type" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "Authentication Type" +#~ msgid "Login" +#~ msgstr "Login" + +#~ msgctxt "Page Title" +#~ msgid "Send a Test Email" +#~ msgstr "Envoyer un message test" + +#~ msgctxt "Postman Dashboard Widget Title" +#~ msgid "Postman SMTP" +#~ msgstr "Postman SMTP" + +#~ msgctxt "Dashboard Widget Settings Link label" +#~ msgid "Settings" +#~ msgstr "Réglages" + +#~ msgctxt "Authentication Type is Password" +#~ msgid "Password" +#~ msgstr "Password" + +#~ msgctxt "Authentication Type" +#~ msgid "no" +#~ msgstr "non" + +#~ msgctxt "Authentication Type" +#~ msgid "Password (%s)" +#~ msgstr "Mot de Passe (%s)" + +#~ msgctxt "Plugin Action Links" +#~ msgid "Settings" +#~ msgstr "Réglages" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport" +#~ msgstr "Transport" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Transport" +#~ msgstr "Transport" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Outgoing Mail Server Hostname" +#~ msgstr "Nom d'Hôte du serveur SMTP" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Outgoing Mail Server Port" +#~ msgstr "Port du serveur SMTP" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Authentication" +#~ msgstr "Authentification" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Authentication" +#~ msgstr "Authentification" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Password" +#~ msgstr "Mot de Passe" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Reply-To" +#~ msgstr "Reply-To" + +#~ msgctxt "Encryption Type" +#~ msgid "None" +#~ msgstr "Aucun" + +#~ msgctxt "Encryption Type" +#~ msgid "SSL" +#~ msgstr "SSL" + +#~ msgctxt "Encryption Type" +#~ msgid "TLS" +#~ msgstr "TLS" + +#~ msgctxt "Name of the OAuth 2.0 Client Secret" +#~ msgid "Client secret" +#~ msgstr "Secret du client" + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Request OAuth Permission" +#~ msgstr "Demander l'autorisation de OAuth." + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Checking.." +#~ msgstr "Vérification.." + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Open" +#~ msgstr "Ouvert" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Closed" +#~ msgstr "Fermé" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Done." +#~ msgstr "Fini." + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Yes" +#~ msgstr "Oui" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "No" +#~ msgstr "Non" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Port" +#~ msgstr "Port" + +#~ msgctxt "Please Wait, the screen is loading." +#~ msgid "Loading ..." +#~ msgstr "Attendez ..." + +#~ msgctxt "Connectivity Test Table" +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgctxt "Wizard Label" +#~ msgid "Loading ..." +#~ msgstr "Attendez ..." + +#~ msgctxt "Main Menu" +#~ msgid "Settings" +#~ msgstr "Réglages" + +#~ msgctxt "Button Label" +#~ msgid "Start the Wizard" +#~ msgstr "Mettre en marche le Wizard" + +#~ msgctxt "Main Menu" +#~ msgid "Run a Connectivity Test" +#~ msgstr "Faire un test de connexion de port" + +#~ msgctxt "Main Menu" +#~ msgid "Online Support" +#~ msgstr "Assistance en ligne" + +#~ msgctxt "Plugin to Import Configuration from" +#~ msgid "None" +#~ msgstr "Aucun" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Email Name" +#~ msgstr "Nom de l'Expéditeur" + +#~ msgctxt "Wizard Step Title" +#~ msgid "Outgoing Mail Server Hostname" +#~ msgstr "Nom d'Hôte du serveur SMTP" + +#~ msgctxt "Wizard Step Title" +#~ msgid "Authentication" +#~ msgstr "Authentification" + +#~ msgctxt "The end of the Wizard" +#~ msgid "Finish" +#~ msgstr "Fin" + +#~ msgid "Status Message" +#~ msgstr "Message d'état" + +#~ msgid "Delete" +#~ msgstr "Supprimer" + +#~ msgid "View" +#~ msgstr "Voir" + +#~ msgid "Subject" +#~ msgstr "Sujet" + +#~ msgid "Delivery Time" +#~ msgstr "Délai de livraison" + +#~ msgid "To" +#~ msgstr "A" + +#~ msgid "Delivery-URI" +#~ msgstr "Livraison-URI" + +#~ msgid "The transport is normally SMTP, though new transports will become available in the form of APIs:" +#~ msgstr "Le transport est normalement SMTP, bien que les nouveaux transports deviendra disponibles sous forme d'API :" + +#~ msgctxt "Wizard Label" +#~ msgid "current step:" +#~ msgstr "étape en cours:" + +#~ msgctxt "Wizard Label" +#~ msgid "Pagination" +#~ msgstr "Pagination" + +#~ msgctxt "Wizard Label" +#~ msgid "Finish" +#~ msgstr "Fin" + +#~ msgctxt "Wizard Label" +#~ msgid "Next" +#~ msgstr "Prochain" + +#~ msgctxt "Wizard Label" +#~ msgid "Previous" +#~ msgstr "Précédent" + +#~ msgctxt "Wizard Step Title" +#~ msgid "Finish" +#~ msgstr "Fin" + +#~ msgid "Date" +#~ msgstr "Date" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Delete plugin settings" +#~ msgstr "Supprimer les réglages de l'extension" + +#~ msgctxt "Page Title" +#~ msgid "Postman Settings" +#~ msgstr "Réglages de Postman" + +#~ msgid "Configure Manually" +#~ msgstr "Configurer manuellement" + +#~ msgid "Diagnostic Info" +#~ msgstr "Diagnostic Infos" + +#~ msgctxt "Page Title" +#~ msgid "Delete plugin settings" +#~ msgstr "Supprimer les réglages de l'Extension" + +#~ msgctxt "Page Title" +#~ msgid "Connectivity Test" +#~ msgstr "Test de connectivité" + +#~ msgctxt "Page Title" +#~ msgid "Diagnostic Info" +#~ msgstr "Diagnostic Infos" + +#~ msgid "Please check the troubleshooting and error messages page and the support forum.
    If you write for help, please include the following diagnostic information:" +#~ msgstr "Consultez la page des messages de dépannage et d'erreur et le forum de support.
    Si vous écrivez à l'aide, se il vous plaît inclure les informations de diagnostic suivant:" + +#~ msgctxt "Page Title" +#~ msgid "Diagnostic Information" +#~ msgstr "Informations de diagnostic" + +#~ msgctxt "Main Menu" +#~ msgid "Get Started" +#~ msgstr "Commencez" + +#~ msgctxt "Main Menu" +#~ msgid "configure manually" +#~ msgstr "configurer manuellement" + +#~ msgctxt "Main Menu" +#~ msgid "Delete plugin settings" +#~ msgstr "Supprimer les réglages de l'extension" + +#~ msgctxt "Wizard Step Title" +#~ msgid "Connectivity Test" +#~ msgstr "Test de connectivité" + +#~ msgctxt "Wizard Action" +#~ msgid "Connectivity Test" +#~ msgstr "Test de connectivité" + +#~ msgid "Password authentication (Plain/Login/CRAMMD5) requires a username and password." +#~ msgstr "L'authentification par mot de passe (plaine / Connexion / CRAMMD5) nécessite un nom d'utilisateur et mot de passe." + +#~ msgid "All plugin settings were removed." +#~ msgstr "Tous les paramètres des plugins ont été enlevés." + +#~ msgctxt "Configuration Input Field" +#~ msgid "Log Level" +#~ msgstr "Niveau du journal" + +#, fuzzy +#~ msgid "The default transport is SMTP." +#~ msgstr "Le transport par défaut est SMTP." + +#~ msgid "Select the transport to use:" +#~ msgstr "Un ou plusieurs extension (s) a installé transports supplémentaires:" + +#~ msgid "Select the authentication method, security type, and enter the Mail Submission Agent (MSA) hostname and port:" +#~ msgstr "Sélectionnez la méthode d'authentification et entrez le nom du serveur SMTP et le port:" + +#~ msgid "Enter the username (email address) and password you use to send email" +#~ msgstr "Entrer le nom d'utilisateur (adresse de messagerie) et mot de passe que vous utilisez pour envoyer du courrier électronique." + +#~ msgid "The message sender is used as the From: address." +#~ msgstr "L'expéditeur du message est utilisé comme De: adresse." + +#~ msgid "The Reply-To overrides the Sender when the recipient composes a reply. Separate multiple to/cc/bcc recipients with commas." +#~ msgstr "Le Reply-To remplace le expéditeur lorsque le destinataire compose une réponse. Séparer les to/cc/bcc destinataires par des virgules." + +#~ msgid "Prevent the Sender Name from being overridden" +#~ msgstr "Prévenir l'expéditeur Nom d'être surchargée" + +#~ msgid "Prevent the Sender Email Address from being overridden" +#~ msgstr "Empêcher l'adresse email de l'expéditeur d'être surchargée" + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Request permission from %s" +#~ msgstr "Demandez la permission à %s" + +#~ msgctxt "Name of the Application Callback Domain" +#~ msgid "Javascript Origins" +#~ msgstr "Origines du Javascript" + +#~ msgctxt "Name of the OAuth 2.0 Client ID" +#~ msgid "Consumer Key" +#~ msgstr "Clé-Client" + +#~ msgctxt "Name of the OAuth 2.0 Client Secret" +#~ msgid "Consumer Secret" +#~ msgstr "Secret Client" + +#~ msgid "Port %d is blocked. Contact your host for a solution, such as using their local SMTP server or opening the port." +#~ msgstr "Port %d est bloqué. Contactez votre hôte pour une solution, comme l'utilisation de leur serveur SMTP local ou l'ouverture du port." + +#~ msgid "Port %d can't send mail with %s. Try a different SMTP server." +#~ msgstr "Port %d ne peut pas envoyer des messages avec %s. Essayez un autre serveur SMTP." + +#~ msgid "Port %d can be used to send Gmail with the Postman Gmail Extension." +#~ msgstr "Port %d peut être utilisé pour envoyer Gmail avec le Postman Gmail Extension." + +#~ msgid "Port %d is blocked. Contact your host for a solution, such as opening the port." +#~ msgstr "Port %d est bloqué. Contactez votre hôte pour une solution, comme l'ouverture du port." + +#~ msgid "No ports are available for this SMTP server. Try a different SMTP host or contact your WordPress host for their specific solution." +#~ msgstr "Aucuns ports disponibles pour ce serveur SMTP. Essayez un hôte SMTP différent ou contactez votre hôte WordPress pour une solution spécifique." + +#~ msgid "Please note: When composing email, other WordPress plugins and themes are forbidden from overriding the sender email address." +#~ msgstr "Notez bien: En composant votre message, d'autres thèmes ou extensions de WordPress risque d'écraser le nom de l'expéditeur seulement." + +#~ msgid "Please note: When composing email, other WordPress plugins and themes may override the sender name and email address causing rejection with some email services, such as Yahoo Mail. If you experience problems, try leaving the sender email address empty in these plugins or themes." +#~ msgstr "Notez bien: En composant votre message, d'autres thèmes ou extensions de WordPress risque d'écraser le nom de l'expéditeur et l'adresse de messagerie, causant un rejet de certains service de messagerie, comme Yahoo Mail. Si vous avez un problème, laissez le champ d'adresse d'envoi vide pour ces extensions ou thèmes." + +#~ msgid "Postman has delivered %d email for you!" +#~ msgid_plural "Postman has delivered %d emails for you!" +#~ msgstr[0] "Postman a livré %d e-mail pour vous!" +#~ msgstr[1] "Postman a livré %d e-mails pour vous!" + +#~ msgid "Please consider leaving a review of Postman SMTP to help spread the word about the new way to send email from WordPress! :D" +#~ msgstr "Se il vous plaît envisager de laisser une critique de Postman SMTP pour aider à passer le mot à propos de la nouvelle façon d'envoyer des courriels à partir de WordPress! :D" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Outbound to Internet" +#~ msgstr "Sortant à Internet" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Service Available" +#~ msgstr "Service Disponible" + +#~ msgid "Conclusion" +#~ msgstr "Conclusion" + +#~ msgid "A Closed port indicates one or more of these issues:" +#~ msgstr "Un port Fermé peut vouloir dire ceci:" + +#~ msgid "Your host has placed a firewall between this site and the Internet" +#~ msgstr "L'Hôte à mis en place un Firewall entre ce site et le serveur SMTP" + +#~ msgctxt "Page Title" +#~ msgid "Tips and Diagnostic Info" +#~ msgstr "Conseils et diagnostic Infos" + +#~ msgid "Please enter the email address and name you'd like to send mail from." +#~ msgstr "Entrez l'adresse de messagerie et pseudo dont vous désiré envoyer des messages." + +#~ msgid "Please note that to combat Spam, many email services will not let you send from an e-mail address other than the one you authenticate with in step 5." +#~ msgstr "Veuillez noter que pour combattre le Spam, plusieurs services de messagerie ne permettrons pas l'envoi d'un message provenant d'une autre adresse que la vôtre.\"" + +#~ msgid "This is the local Outgoing Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. These servers are normally specific to the email account you have, and if you don't know which server to use, ask your email service provider.

    If possible, the Wizard will pre-fill this field based on the e-mail address you entered." +#~ msgstr "C'est le serveur, aussi connu comme une Agent de Submission Courrier (ASC), qui Postman utilisé pour vous livrer votre courrier. Si possible, Postman tentera de déterminer ce nom d'hôte basé sur l'adresse e-mail." + +#~ msgid "Enter your credentials. Your username is most likely your email address." +#~ msgstr "Votre nom d'utilisateur est sans doutes votre adresse de messagerie." + +#~ msgid "Request permission from the Email Provider to allow Postman to send email and" +#~ msgstr "Demandez la permission à votre service de messagerie de permettre à Postman d'envoyer du courrier puis" + +#~ msgctxt "OAuthentication Type is OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgctxt "Authentication Type" +#~ msgid "Password" +#~ msgstr "Password" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Auth" +#~ msgstr "Auth" + +#~ msgctxt "Configuration Input Field" +#~ msgid "SMTP Server Hostname" +#~ msgstr "Nom d'Hôte du serveur SMTP" + +#~ msgctxt "Configuration Input Field" +#~ msgid "SMTP Server Port" +#~ msgstr "Port du serveur SMTP" + +#~ msgid "Select the authentication method and enter the SMTP server hostname and port:" +#~ msgstr "Sélectionnez la méthode d'authentification et entrez le nom du serveur SMTP et le port:" + +#~ msgctxt "Wizard Step Title" +#~ msgid "SMTP Server Hostname" +#~ msgstr "Nom d'Hôte du serveur SMTP" + +#~ msgid "Your connection to the SMTP server depends on what your email service provider offers, and what your WordPress host allows. Postman will attempt to determine which options are available to you." +#~ msgstr "Le nom d'hôte du serveur et le port, vous pouvez utiliser est une combinaison de ce que votre service de courrier offres des fournisseurs, et ce que votre hôte WordPress permet. Postman tentera de déterminer les options qui se offrent à vous." + +#~ msgid "This is the Outgoing Mail Server, also known as a Mail Submission Agent (MSA), that Postman will use to deliver your mail. If possible, Postman will try to determine this hostname based on the e-mail address." +#~ msgstr "C'est le serveur, aussi connu comme une Courrier Submission Agent (CSA), qui Postman utilisé pour vous livrer votre courrier. Si possible, Postman tentera de déterminer ce nom d'hôte basé sur l'adresse e-mail." + +#~ msgid "You are about to configure OAuth 2.0 with an IP address in the URL which will fail. Either assign a real domain name to your site or add a fake one in your local machine's host file." +#~ msgstr "Vous êtes sur le point de configurer OAuth 2.0 avec une adresse IP dans l'URL qui échouera. Soit attribuer un nom de domaine pour votre site ou ajouter un faux dans le fichier hôte de votre machine locale." + +#~ msgid "This test determines which well-known sockets are available for Postman to use." +#~ msgstr "Ce test détermine les prises bien connus sont disponibles pour Postman à utiliser." + +#~ msgid "You will receive an email from Postman with the subject \"WordPress Postman SMTP Test.\"" +#~ msgstr "Vous recevrez un message de Postman avec l'objet suivant \"WordPress Postman SMTP Test.\"" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Checking.. " +#~ msgstr "Vérification.. " + +#~ msgid "Please considering leaving a review of Postman SMTP to help spread the word about the new way to send email from WordPress! :D" +#~ msgstr "Se il vous plaît envisager de laisser une critique de Postman SMTP pour aider à passer le mot à propos de la nouvelle façon d'envoyer des courriels à partir de WordPress! :D" + +#~ msgctxt "Test Email Subject" +#~ msgid "WordPress Postman SMTP Test" +#~ msgstr "Test SMTP de WordPress Postman" + +#~ msgctxt "Test Email Tagline" +#~ msgid "Sent by Postman v%s" +#~ msgstr "Envoyé par Postman v%s" + +#~ msgid "Sent by Postman %s" +#~ msgstr "Envoyé par Postman %s" + +#~ msgid "Port 443 can be used to send Gmail with the Postman Gmail Extension." +#~ msgstr "Port 443 peut être utilisé pour envoyer Gmail avec le Postman Gmail Extension." + +#~ msgid "Port 443 is blocked. Contact your host for a solution, such as opening the port." +#~ msgstr "Port 443 est bloqué. Contactez votre hôte pour une solution, comme l'ouverture du port." + +#~ msgctxt "Main Menu" +#~ msgid "Send a Test Email" +#~ msgstr "Envoyer un message test" + +#~ msgid "Tips and Diagnostic Info" +#~ msgstr "Conseils et diagnostic Infos" + +#~ msgid "In Outbox" +#~ msgstr "Dans la boîte d'envoi" diff --git a/Postman/languages/postman-smtp-it_IT.mo b/Postman/languages/postman-smtp-it_IT.mo new file mode 100644 index 0000000..e56feca Binary files /dev/null and b/Postman/languages/postman-smtp-it_IT.mo differ diff --git a/Postman/languages/postman-smtp-it_IT.po b/Postman/languages/postman-smtp-it_IT.po new file mode 100644 index 0000000..df8a03d --- /dev/null +++ b/Postman/languages/postman-smtp-it_IT.po @@ -0,0 +1,2397 @@ +# Copyright (C) 2015 Postman SMTP +# This file is distributed under the same license as the Postman SMTP package. +msgid "" +msgstr "" +"Project-Id-Version: Postman SMTP 1.4.2\n" +"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/postman-smtp\n" +"POT-Creation-Date: 2015-11-08 17:19-0500\n" +"PO-Revision-Date: 2015-11-09 01:31-0500\n" +"Last-Translator: Andrea Greco \n" +"Language-Team: \n" +"Language: it_IT\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 1.8.6\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:94 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:348 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:357 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:99 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:545 +#: Postman/PostmanViewController.php:227 +msgid "Warning" +msgstr "Avviso" + +#. translators: where %s is the name of the SMTP server +#: Postman/Postman-Configuration/PostmanConfigurationController.php:96 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +msgid "connected to %1$s instead of %2$s." +msgstr "collegati a %1$s invece di %2$s." + +#. translators: where %d is a port number +#: Postman/Postman-Configuration/PostmanConfigurationController.php:98 +msgid "You are about to configure OAuth 2.0 with an IP address instead of a domain name. This is not permitted. Either assign a real domain name to your site or add a fake one in your local host file." +msgstr "Stai per configurare OAuth 2.0 con un indirizzo IP nell'URL che fallirà. O assegnare un vero nome di dominio per il tuo sito o aggiungere un falso in file host del computer locale." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/PostmanViewController.php:53 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "%s Setup" +msgstr "Impostazioni %s" + +#. Plugin Name of the plugin/theme +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:57 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:70 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:176 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/Postman.php:61 Postman/PostmanViewController.php:53 +#: Postman/PostmanViewController.php:54 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "Postman SMTP" +msgstr "Postman SMTP" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:196 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:81 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 Postman/Postman.php:316 +#: Postman/PostmanAdminController.php:225 +msgid "Settings" +msgstr "Optioni" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:198 +msgid "Account" +msgstr "Account" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:199 +msgid "Message" +msgstr "Messaggio" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:200 +msgid "Logging" +msgstr "Registrazione" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:201 +msgid "Advanced" +msgstr "Configurazione avanzata" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:263 +msgid "Setup Wizard" +msgstr "Preparare Procedura Guidata" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:296 +msgctxt "Wizard Step Title" +msgid "Import Configuration" +msgstr "Importa configurazione" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:298 +msgctxt "Wizard Step Title" +msgid "Import configuration from another plugin?" +msgstr "Importa configurazione da un altro plugin?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:299 +msgid "If you had a working configuration with another Plugin, the Setup Wizard can begin with those settings." +msgstr "Se tu avessi una configurazione di lavoro con un'altra Plugin, l'installazione guidata può iniziare con queste impostazioni." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:301 +#: Postman/Postman-Mail/PostmanModuleTransport.php:720 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:425 +msgid "None" +msgstr "Nessuno" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:312 +msgctxt "Wizard Step Title" +msgid "Sender Details" +msgstr "Sender Dettagli" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:314 +msgctxt "Wizard Step Title" +msgid "Who is the mail coming from?" +msgstr "Chi è la posta proveniente da?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:315 +msgid "Enter the email address and name you'd like to send mail as." +msgstr "Inserisci per favore l'indirizzo email e il nome dal quale vuoi inviare la posta." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:316 +msgid "Please note that to prevent abuse, many email services will not let you send from an email address other than the one you authenticate with." +msgstr "Si prega di notare che per combattere lo spam, molti servizi di posta elettronica non consentono l’ invio da un indirizzo e-mail diverso dal proprio." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:317 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:49 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:112 +msgid "Email Address" +msgstr "Indirizzo Email" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:320 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:59 +msgid "Name" +msgstr "Nome" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:325 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:143 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:331 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:542 +msgid "Outgoing Mail Server Hostname" +msgstr "Nome host server SMTP" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:333 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:138 +#: Postman/PostmanViewController.php:294 +msgid "Connectivity Test" +msgstr "Test di connettività" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:335 +msgid "How will the connection to the mail server be established?" +msgstr "Come verrà stabilita la connessione al MSA?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:336 +msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows." +msgstr "Il nome host del server e la porta si può usare è una combinazione di ciò che le vostre offerte fornitore di servizi di posta, e che cosa il vostro ospite WordPress permette. Postman tenterà di determinare quali opzioni sono a vostra disposizione." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +msgctxt "TCP Port Test Status" +msgid "Ready" +msgstr "È Pronta" + +#. Translators: Where %1$s is the socket identifier and %2$s is the +#. authentication type +#: Postman/Postman-Configuration/PostmanConfigurationController.php:345 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgctxt "A socket is the network term for host and port together" +msgid "Socket" +msgstr "Presa" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:346 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:354 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:223 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:177 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:351 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:356 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:372 +msgid "Authentication" +msgstr "Autenticazione" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:349 +msgid "This configuration option will send your authorization credentials in the clear." +msgstr "Questa opzione di configurazione invierà le credenziali di autorizzazione in chiaro." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:356 +msgid "How will you prove your identity to the mail server?" +msgstr "Come pensate di dimostrare la propria identità per la MSA?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:363 +msgctxt "The final step of the Wizard" +msgid "Finish" +msgstr "Finito" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:365 +msgctxt "Wizard Step Title" +msgid "You're Done!" +msgstr "Gioco è fatto!" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:367 +msgid "Click Finish to save these settings, then:" +msgstr "Fare clic su Fine per salvare le impostazioni, quindi:" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:369 +msgid "Grant permission with the Email Provider for Postman to send email and" +msgstr "Richiedi il permesso dal provider di posta elettronica per consentire a Postman di inviare e-mail e" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:370 +msgid "Send yourself a Test Email to make sure everything is working!" +msgstr "Inviati un messaggio di prova per accertarti che tutto funzioni!" + +#. translators: where %s is the URL to the Connectivity Test page +#: Postman/Postman-Configuration/PostmanConfigurationController.php:514 +msgid "Postman can't find any way to send mail on your system. Run a connectivity test." +msgstr "Postman non riesce a trovare un modo per inviare la posta sul proprio sistema. Eseguire un test di connettività." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:33 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Transport" +msgstr "Trasporto" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:38 +msgctxt "(i.e.) What kind is it?" +msgid "Type" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:44 +msgctxt "The Message Sender Email Address" +msgid "From Address" +msgstr "Messaggio Mittente Indirizzo" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:70 +msgid "Additional Email Addresses" +msgstr "Indirizzi Aggiuntivi" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:75 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:220 +msgid "Reply-To" +msgstr "Reply-To" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:80 +msgid "To Recipient(s)" +msgstr "Al destinatario(s)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:85 +msgid "Carbon Copy Recipient(s)" +msgstr "Carbon Copy Destinatario(s)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:90 +msgid "Blind Carbon Copy Recipient(s)" +msgstr "Blind Carbon Copy Destinatario(s)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:96 +msgid "Additional Headers" +msgstr "Intestazioni Aggiuntive" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:101 +msgid "Custom Headers" +msgstr "Intestazioni Personalizzate" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:107 +msgid "Validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:118 +msgid "Email Log Settings" +msgstr "Impostazioni del registro di e-mail" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:123 +msgid "Enable Logging" +msgstr "Abilita registrazione" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:128 +#: Postman/PostmanInputSanitizer.php:137 +msgid "Maximum Log Entries" +msgstr "Numero max, elementi registro" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:133 +msgid "Maximum Transcript Size" +msgstr "Dimensione di trascrizione (linee totale)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:139 +msgid "Network Settings" +msgstr "Impostazioni di rete" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:144 +msgctxt "Configuration Input Field" +msgid "TCP Connection Timeout (sec)" +msgstr "Timeout connessione TCP (sec)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:149 +msgctxt "Configuration Input Field" +msgid "TCP Read Timeout (sec)" +msgstr "Leggi Timeout TCP (sec)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:155 +msgctxt "Configuration Section Title" +msgid "Miscellaneous Settings" +msgstr "Impostazioni varie" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:160 +msgctxt "Configuration Input Field" +msgid "PHP Log Level" +msgstr "Livello di registrazione PHP" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:165 +msgctxt "Configuration Input Field" +msgid "Delivery Mode" +msgstr "Modalità di consegna" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:170 +msgctxt "This mode removes the Postman X-Mailer signature from emails" +msgid "Stealth Mode" +msgstr "Modalità stealth" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:175 +msgid "Temporary Directory" +msgstr "Cartella temporanea" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:186 +msgid "Choose SMTP or a vendor-specific API:" +msgstr "Scegliere un fornitore-specifiche API o SMTP:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:189 +msgid "Configure the delivery audit log:" +msgstr "Configurare il registro di controllo della consegna:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:196 +msgid "This address, like the letterhead printed on a letter, identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Other plugins, especially Contact Forms, may override this field to be your visitor's address." +msgstr "Questo indirizzo, come il intestata stampato su una lettera, identifica il mittente al destinatario. Modificare questo quando si sta inviando a nome di qualcun altro, per esempio per utilizzare Google Send Mail As caratteristica. Altri plugin, in particolare moduli di contatto, possono sovrascrivere questo campo per essere l'indirizzo del vostro ospite." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:203 +msgid "Separate multiple to/cc/bcc recipients with commas." +msgstr "Separare più a/cc/ destinatariCcn con virgole." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:210 +msgid "Increase the timeouts if your host is intermittenly failing to send mail. Be careful, this also correlates to how long your user must wait if the mail server is unreachable." +msgstr "Aumentare il timeout di lettura se il tuo host riesce ad inviare i messaggi solo in maniera intermittènte. Attenzione, questo è correlato anche a quanto tempo il tuo utente deve attendere se il server di posta non è raggiungibile." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:221 +msgid "Specify custom headers (e.g. X-MC-Tags: wordpress-site-A), one per line. Use custom headers with caution as they can negatively affect your Spam score." +msgstr "Specificare le intestazioni personalizzate (ad esempio X-MC-Tags: wordpress-site-A), uno per riga. Utilizzare intestazioni personalizzate con cautela in quanto possono influenzare negativamente il tuo punteggio Spam." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:228 +msgid "E-mail addresses can be validated before sending e-mail, however this may fail with some newer domains." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:254 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:276 +msgid "Prevent plugins and themes from changing this" +msgstr "Impedire di modificare questo plugin e temi" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:261 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:405 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:244 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:195 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:409 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:416 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:459 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:467 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:475 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:482 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:530 +msgid "Required" +msgstr "Obbligatorio" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:268 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:531 +msgid "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +msgstr "Questo indirizzo, come il indirizzo di ritorno stampato su una busta, identifica il proprietario dell'account al server SMTP." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:289 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:108 +msgid "Yes" +msgstr "Si" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:290 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:109 +msgid "No" +msgstr "No" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:300 +msgid "Change this value if you can't see the beginning of the transcript because your messages are too big." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:343 +msgid "Disable e-mail validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:350 +msgid "Log Level specifies the level of detail written to the WordPress Debug log - view the log with Debug." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:353 +msgid "Off" +msgstr "Disattivo" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:354 +msgid "Trace" +msgstr "Trace" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:355 +msgid "Debug" +msgstr "Debug" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:356 +msgid "Info" +msgstr "Info" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:358 +msgid "Error" +msgstr "Errore" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:366 +msgid "Delivery mode offers options useful for developing or testing." +msgstr "Modalità di consegna offre opzioni utili per lo sviluppo o il test." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:369 +msgctxt "When the server is online to the public, this is \"Production\" mode" +msgid "Log Email and Send" +msgstr "Registro Email e invia" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:370 +msgid "Log Email and Delete" +msgstr "Registro Email e cancella" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:371 +msgid "Delete All Emails" +msgstr "Elimina tutti i dati" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:375 +msgid "Remove the Postman X-Header signature from messages" +msgstr "Rimuovere la firma del postino X-Header da messaggi" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:378 +msgid "Lockfiles are written here to prevent users from triggering an OAuth 2.0 token refresh at the same time." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:381 +msgid "Valid" +msgstr "Valido" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:383 +msgid "Invalid" +msgstr "Non valido" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:105 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:109 +msgctxt "The \"please wait\" message" +msgid "Checking.." +msgstr "Verificando.." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:106 +msgctxt "The port is open" +msgid "Open" +msgstr "Aperto" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:107 +msgctxt "The port is closed" +msgid "Closed" +msgstr "Chiuso" + +#. translators: where %d is a port number +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:111 +msgid "No outbound route between this site and the Internet on Port %d." +msgstr "Nessun percorso in uscita tra questo sito e Internet sulla porta %d." + +#. translators: where %d is a port number and %s is a hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:113 +msgid "Port %d is open, but not to %s." +msgstr "Porta %d è aperta, ma non a %s." + +#. translators: where %d is the port number and %s is the hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:115 +msgid "Port %d can be used for SMTP to %s." +msgstr "Port %d può essere utilizzato per SMTP per %s." + +#. translators: where %d is a port number and %s is the URL for the Postman +#. Gmail Extension +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:118 +msgid "Port %d can be used with the %s." +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:141 +msgid "This test determines which well-known ports are available for Postman to use." +msgstr "Questo test determina quali sono disponibili per Postman usare prese noti." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:145 +msgctxt "Button Label" +msgid "Begin Test" +msgstr "Inizia test" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:162 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:152 +msgid "Status" +msgstr "Stato" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Service Available" +msgstr "Servizio disponibile" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Server ID" +msgstr "" + +#. Translators: Meaning "Not Applicable" +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:155 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:260 +msgid "n/a" +msgstr "n/d" + +#. Translators: Where %s is the name of the service providing Internet +#. connectivity test +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:160 +msgid "According to %s" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:163 +msgid "Summary" +msgstr "Sommario" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:168 +msgid "A test with \"No\" Service Available indicates one or more of these issues:" +msgstr "Una porta No indica:" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:170 +msgid "Your web host has placed a firewall between this site and the Internet" +msgstr "Il tuo host ha inserito un firewall tra il sito e il server SMTP oppure" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:171 +msgid "The SMTP hostname is wrong or the mail server does not provide service on this port" +msgstr "Il nome host SMTP è errato o il server di posta non fornisce il servizio su questa porta" + +#. translators: where (1) is the URL and (2) is the system +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:173 +msgid "Your %2$s configuration is preventing outbound connections" +msgstr "Il tuo configurazione di %2$s sta impedendo le connessioni in uscita" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:177 +msgid "If the issues above can not be resolved, your last option is to configure Postman to use an email account managed by your web host with an SMTP server managed by your web host." +msgstr "Se non è possibile risolvere i problemi di cui sopra, l'ultima opzione consiste nel configurare il postino per utilizzare un account di posta elettronica gestiti dal tuo host web con un server SMTP gestito dal tuo host web." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:82 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman.php:317 +msgctxt "The log of Emails that have been delivered" +msgid "Email Log" +msgstr "Livello di registrazione" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:95 +msgid "Error: Postman is missing a required PHP library." +msgstr "Postman manca una libreria PHP richiesta." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:97 +#: Postman/Postman.php:257 +msgid "Postman: wp_mail has been declared by another plugin or theme, so you won't be able to use Postman until the conflict is resolved." +msgstr "Errore: Postino è configurato correttamente, ma il tema corrente o un altro plugin sta impedendo il servizio." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:100 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:229 +msgid "Postman is in non-Production mode and is dumping all emails." +msgstr "Postino è in modalità Non di produzione ed è dumping tutte le email." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:102 +msgid "Postman is configured and has delivered %d email." +msgid_plural "Postman is configured and has delivered %d emails." +msgstr[0] "Postman è configurato e ha consegnato %d e-mail." +msgstr[1] "Postman è configurato e ha consegnato %d e-mail." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:104 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:234 +msgid "Postman is not configured and is mimicking out-of-the-box WordPress email delivery." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:116 +msgid "Postman is operating in per-site mode." +msgstr "Postino sta operando in modalità per sito." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:102 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:107 +#: Postman/PostmanViewController.php:295 +msgid "Diagnostic Test" +msgstr "Consigli e informazioni di diagnostica" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:104 +msgid "Are you having issues with Postman?" +msgstr "Stai avendo problemi con Postman?" + +#. translators: where %1$s and %2$s are the URLs to the Troubleshooting and +#. Support Forums on WordPress.org +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:106 +msgid "Please check the troubleshooting and error messages page and the support forum." +msgstr "Controllare la pagina di risoluzione dei problemi e messaggi di errore e il forum di supporto." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:108 +msgid "If you write for help, please include the following:" +msgstr "Se si scrive per un aiuto, si prega di includere le seguenti informazioni di diagnostica:" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:90 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:242 +msgid "Your message was delivered (%d ms) to the SMTP server! Congratulations :)" +msgstr "Il tuo messaggio è stato consegnato (%d ms) al server SMTP! Congratulazioni :)" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:156 +msgid "Mail Log Entries were deleted." +msgstr "Le voci del Log di posta sono state cancellate." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:179 +msgid "Mail Log Entry was deleted." +msgstr "Voce di Log di posta è stato eliminato." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:204 +msgctxt "Who is this message From?" +msgid "From" +msgstr "Dal" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:208 +msgctxt "Who is this message To?" +msgid "To" +msgstr "A" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:212 +msgctxt "Who is this message Cc'd to?" +msgid "Cc" +msgstr "Cc" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:216 +msgctxt "Who is this message Bcc'd to?" +msgid "Bcc" +msgstr "Bcc" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:222 +msgctxt "What is the date today?" +msgid "Date" +msgstr "Data" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:223 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:161 +msgctxt "What is the subject of this message?" +msgid "Subject" +msgstr "Oggetto" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:226 +msgctxt "What is the unique URI of the configuration?" +msgid "Delivery-URI" +msgstr "Consegna-URI" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:253 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:161 +msgid "This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +msgstr "Questa è la conversazione tra postino e il server SMTP. Può essere utile per la diagnosi dei problemi. NON pubblicarlo on-line, si può contenere la password in forma codificata." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +msgid "%s Email Log" +msgstr "%s Email Log" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:301 +msgid "Email was successfully resent (but without attachments)" +msgstr "" + +#. Translators: Where %s is an error message +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:303 +msgid "Email could not be resent. Error: %s" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:304 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:110 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:112 +msgid "Resend" +msgstr "Invia di nuovo" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:339 +msgid "This is a record of deliveries made to the mail server. It does not neccessarily indicate sucessful delivery to the recipient." +msgstr "Questo è un record di consegna tentativi fatti a posta presentazione agente (MSA). Non indica necessariamente sucessful consegna al destinatario." + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:37 +msgctxt "The group of Emails that have been delivered" +msgid "Sent Emails" +msgstr "E-mail inviate" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:38 +msgctxt "An Email that has been delivered" +msgid "Sent Email" +msgstr "E-mail inviata" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +msgid "An empty subject line can result in delivery failure." +msgstr "Un oggetto vuoto può causare la mancata consegna." + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:196 +msgid ".. +%d more" +msgstr ".. e altro %d." + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:99 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:223 +msgctxt "Delete an item from the email log" +msgid "Delete" +msgstr "Elimina" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:100 +msgctxt "View an item from the email log" +msgid "View" +msgstr "Vista" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:104 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:106 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:158 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:163 +msgid "Session Transcript" +msgstr "Trascrizione della Sessione SMTP" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:163 +msgctxt "When was this email sent?" +msgid "Delivery Time" +msgstr "Tempo di consegna" + +#. Translators: where %s indicates the relative time from now +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:332 +msgctxt "A relative time as in \"five days ago\"" +msgid "%s ago" +msgstr "%s fa" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:338 +msgid "Sent" +msgstr "Inviato" + +#: Postman/Postman-Mail/PostmanDefaultModuleTransport.php:107 +msgid "Default" +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:102 +msgid "Gmail API" +msgstr "Gmail API" + +#. translators: where (1) is the secure icon and (2) is the transport name +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:152 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:135 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:79 +msgid "Postman will send mail via the %1$s %2$s." +msgstr "Postman invierà mail tramite il %1$s %2$s." + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:166 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:117 +msgid "You have configured OAuth 2.0 authentication, but have not received permission to use it." +msgstr "Hai configurato l'autenticazione OAuth 2.0, ma non hai ricevuto il permesso per l'utilizzo." + +#. translators: where variables are (1) transport name (2) host and (3) port +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:206 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:181 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:125 +msgid "Postman recommends the %1$s to host %2$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:221 +#: Postman/Postman-Mail/PostmanModuleTransport.php:713 +msgid "OAuth 2.0 (requires Client ID and Client Secret)" +msgstr "OAuth 2.0 (richiede un ID Client e Client segreto)" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:44 +msgid "Mandrill API" +msgstr "Mandrill API" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:147 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:101 +msgid "API Key can not be empty" +msgstr "" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:151 +#: Postman/Postman-Mail/PostmanModuleTransport.php:578 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:105 +msgid "Message From Address can not be empty" +msgstr "Messaggio Mittente Indirizzo non può essere vuoto." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:194 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:228 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:271 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:148 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:182 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:222 +msgid "API Key" +msgstr "" + +#. Translators: Where (1) is the service URL and (2) is the service name and +#. (3) is a api key URL +#: Postman/Postman-Mail/PostmanMandrillTransport.php:238 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:189 +msgid "Create an account at %2$s and enter an API key below." +msgstr "" + +#. translators: where (1) is the transport type, (2) is the host, and (3) is +#. the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 +#. using OAuth 2.0 authentication.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:506 +msgid "Postman will send mail via %1$s to %2$s using %3$s authentication." +msgstr "Postman invierà la posta via %1$s al %2$s utilizzando %3$s autenticazione." + +#. translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s +#. is the encryption type (e.g. SSL or TLS) +#: Postman/Postman-Mail/PostmanModuleTransport.php:534 +msgctxt "as in \"There is no Spoon\"" +msgid "no" +msgstr "no" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:553 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:366 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:584 +msgid "Password" +msgstr "Password" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:584 +msgid "OAuth 2.0 authentication requires a %1$s and %2$s." +msgstr "L’ autenticazione OAuth 2.0 richiede un %1$s e %2$s." + +#: Postman/Postman-Mail/PostmanModuleTransport.php:706 +msgid "Password (requires username and password)" +msgstr "Password (richiede nome utente e password)" + +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 +msgid "MyMail: Change the delivery method in the %s!" +msgstr "" + +#: Postman/Postman-Mail/PostmanSendGridTransport.php:39 +msgid "SendGrid API" +msgstr "SendGrid API" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:95 +msgid "Outgoing Mail Server Hostname and Port can not be empty." +msgstr "Server Posta in Uscita (SMTP) e Porta non possono essere vuoti." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:99 +msgid "Envelope-From Email Address can not be empty" +msgstr "Busta Mittente Indirizzo non può essere vuoto." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:103 +msgid "Username and password can not be empty." +msgstr "L'autenticazione password (Plain / Login / CRAMMD5) richiede un nome utente e una password." + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:109 +msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server." +msgstr "L’ autenticazione OAuth 2.0 richiede un server cha abbia la funzione per la posta in uscita OAuth 2.0 abilitata, Indirizzo e-mail del mittente." + +#. translators: where %1$s is a description of the transport (eg. SMTPS-SSL), +#. %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is +#. the TCP port (eg. 465), %4$d is the hostname +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:269 +msgid "Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:326 +msgid "Transport Settings" +msgstr "Impostazioni di trasporto" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:336 +msgid "Outgoing Mail Server Port" +msgstr "Porta Server SMTP" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:341 +msgid "Envelope-From Email Address" +msgstr "Busta mittente Indirizzo" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:346 +msgctxt "Configuration Input Field" +msgid "Security" +msgstr "Sicurezza" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:361 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:580 +msgid "Username" +msgstr "Nome Utente" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:402 +msgid "Configure the communication with the mail server." +msgstr "Configurare la comunicazione con il Mail Submission Agent (MSA):" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:449 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:579 +msgid "Enter the account credentials." +msgstr "Inserisci le tue credenziali." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:457 +msgid "The Username is usually the same as the Envelope-From Email Address." +msgstr "Il nome utente è più probabile il tuo indirizzo email." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:511 +msgid "Error computing your domain root - please enter it manually" +msgstr "Errore nello stabilire la tua root di dominio - per favore inseriscila manualmente" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:532 +msgid "For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:539 +msgctxt "Wizard Step Title" +msgid "Which host will relay the mail?" +msgstr "Che accoglienza si inoltrare la posta?" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:540 +msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. This server is specific to your email account, and if you don't know what to use, ask your email service provider." +msgstr "Questo è il server di posta in uscita, noto anche come un Invio posta Agent, che Postman userà per consegnare la posta. Se possibile, Postman cercherà di determinare questo nome host in base all'indirizzo e-mail." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:541 +msgid "Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, require that you use their mail accounts with their mail servers, and prevent you from using others." +msgstr "Nota che molti ospiti di WordPress, come GoDaddy, Bluehost e Dreamhost, richiedono di utilizzare il loro account di posta con i loro server di posta e ti impedisce di utilizzare gli altri." + +#. Translators: Where (%s) is the name of the web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:547 +msgid "Your email address requires access to a remote SMTP server blocked by %s." +msgstr "Tua e-mail indirizzo richiede l'accesso a un server SMTP remoto bloccato da %s." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:548 +msgid "If you have access to cPanel, enable the Remote Mail Exchanger." +msgstr "" + +#. Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the +#. web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:551 +msgid "If you own this domain, make sure it has an SPF record authorizing %2$s as a relay, or you will have delivery problems." +msgstr "Se possedete questo dominio, assicurarsi che dispone di un record SPF che autorizza %2$s come un relè, o avrete problemi di consegna." + +#: Postman/Postman-Mail/PostmanTransportRegistry.php:231 +msgid "Postman is configured." +msgstr "Postman è configurato." + +#: Postman/Postman-Mail/PostmanZendMailEngine.php:209 +msgid "Communication Error [334] - make sure the Envelope From email is the same account used to create the Client ID." +msgstr "Errore di comunicazione [334] - assicurarsi che il Mittente Email appartenga allo stesso profilo per il quale e' concesso il consenso OAuth 2.0." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:115 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:149 +msgctxt "Email Test Status" +msgid "In Outbox" +msgstr "Posta in uscita" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:116 +msgctxt "Email Test Status" +msgid "Sending..." +msgstr "Invio.." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:117 +msgctxt "Email Test Status" +msgid "Success" +msgstr "Eseguito" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:118 +msgctxt "Email Test Status" +msgid "Failed" +msgstr "Errore" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:119 +msgid "Ajax Error" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:128 +#: Postman/PostmanViewController.php:273 Postman/PostmanViewController.php:275 +msgid "Send a Test Email" +msgstr "Invia una mail di prova" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:133 +msgid "Specify the Recipient" +msgstr "Scegliere il destinatario" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:135 +msgid "Who is this message going to?" +msgstr "Chi è questo messaggio sta per?" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:136 +msgid "This utility allows you to send an email message for testing." +msgstr "Questa utilità consente di inviare un messaggio di posta elettronica per il test." + +#. translators: where %d is an amount of time, in seconds +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:139 +msgid "If there is a problem, Postman will give up after %d second." +msgid_plural "If there is a problem, Postman will give up after %d seconds." +msgstr[0] "Se c'è un problema, Postman si interromperà dopo %d secondo." +msgstr[1] "Se c'è un problema, Postman si interromperà dopo %d secondi." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:140 +msgctxt "Configuration Input Field" +msgid "Recipient Email Address" +msgstr "Destinatario Indirizzo e-mail" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:145 +msgid "Send The Message" +msgstr "Inviare il messaggio" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:148 +msgid "Sending the message:" +msgstr "Invio del messaggio in corso:" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:160 +msgid "Examine the Session Transcript if you need to." +msgstr "Esaminare la sessione SMTP Trascrizione se è necessario." + +#. translators: where %s is the domain name of the site +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:212 +msgctxt "Test Email Subject" +msgid "Postman SMTP Test (%s)" +msgstr "Postman test SMTP (%s)" + +#. translators: where %s is the Postman plugin version number (e.g. 1.4) +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:299 +msgctxt "Test Email Tagline" +msgid "Sent by Postman %s" +msgstr "Inviato da Postman %s" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:300 +msgid "Image source" +msgstr "Origine immagine" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:301 +msgid "Used with permission" +msgstr "Usato con permesso" + +#: Postman/PostmanAdminController.php:111 +msgctxt "The plugin successfully saved new settings." +msgid "Settings saved." +msgstr "Impostazioni salvate" + +#. Translators: where %1$s is the name of the library +#: Postman/PostmanAdminController.php:178 +msgid "This PHP installation requires the %1$s library." +msgstr "Questa installazione PHP richiede la %1$s library." + +#: Postman/PostmanAdminController.php:253 +msgid "There was an error importing the data." +msgstr "" + +#: Postman/PostmanAdminController.php:270 +msgid "Plugin data was removed." +msgstr "Tutte le impostazioni del plugin sono stati rimossi." + +#: Postman/PostmanAdminController.php:294 +msgid "The OAuth 2.0 authorization was successful. Ready to send e-mail." +msgstr "L'autorizzazione di OAuth 2.0 ha avuto successo. Pronto per inviare e-mail." + +#: Postman/PostmanAdminController.php:296 +msgid "Your email provider did not grant Postman permission. Try again." +msgstr "Il tuo provider di posta elettronica non ha permesso l’ accesso a Postman. Riprova." + +#: Postman/PostmanAdminController.php:299 +msgid "The grant code from Google had no accompanying state and may be a forgery" +msgstr "Il codice di accesso di Google non ha corrispondenza e potrebbe essere falso" + +#. translators: %s is the error message +#: Postman/PostmanAdminController.php:303 +msgid "Error authenticating with this Client ID. [%s]" +msgstr "Errore di autenticazione con questo Client ID. [%s]" + +#: Postman/PostmanConfigTextHelper.php:31 +msgid "Attention" +msgstr "Attenzione" + +#. translators: parameters available are 1=portal-url, 2=portal-name, +#. 3=clientId-name, 4=clientSecret-name, 5=callbackUrl, 6=service-name, +#. 7=portal-application (e.g. Open the Google Developer Console, create a +#. Client ID for web application using the URL's displayed below, and copy the +#. Client ID and Client Secret here.) +#: Postman/PostmanConfigTextHelper.php:33 +msgid "Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +msgstr "Apri il %2$s, creato %7$s usando l' URL mostrato di seguito, e copia i %3$s and %4$s qui." + +#. translators: parameters available are 1=clientId-name, 2=service-name, +#. 3=FAQ-URL, 4=Video-URL (e.g. See How do I get a Google Client ID? in the +#. F.A.Q.) +#: Postman/PostmanConfigTextHelper.php:36 +msgid "See How do I get a %1$s %2$s? in the F.A.Q. or watch our How-To video 📺." +msgstr "Vedere come a ottenere un %1$s %2$s? nella F.A.Q. o Guarda i nostri how-to dei 📺." + +#. translators: where %s is the Email Service Owner (e.g. Google, Microsoft or +#. Yahoo) +#: Postman/PostmanConfigTextHelper.php:54 +msgctxt "Command to initiate OAuth authentication" +msgid "Grant permission with %s" +msgstr "Richiesta permesso di %s" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:80 +#: Postman/PostmanConfigTextHelper.php:142 +#: Postman/PostmanConfigTextHelper.php:204 +#: Postman/PostmanConfigTextHelper.php:271 +msgctxt "Name of the OAuth 2.0 Client ID" +msgid "Client ID" +msgstr "Client ID" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:84 +#: Postman/PostmanConfigTextHelper.php:146 +#: Postman/PostmanConfigTextHelper.php:208 +#: Postman/PostmanConfigTextHelper.php:274 +msgctxt "Name of the OAuth 2.0 Client Secret" +msgid "Client Secret" +msgstr "Client Secret" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:88 +msgctxt "Name of the Application Callback URI" +msgid "Authorized redirect URI" +msgstr "Authorized redirect URI" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:92 +msgctxt "Name of the Application Callback Domain" +msgid "Authorized JavaScript origins" +msgstr "Authorized JavaScript origins" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:96 +msgctxt "Name of the email service owner" +msgid "Google" +msgstr "Google" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:100 +msgctxt "Name of the email service" +msgid "Gmail" +msgstr "Gmail" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:104 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "a Client ID for web application" +msgstr "un ID client per applicazioni web" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:108 +msgctxt "Name of the email service portal" +msgid "Google Developers Console Gmail Wizard" +msgstr "Guidata di Gmail di Google gli sviluppatori Console" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:150 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URL" +msgstr "URL di reindirizzamento" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:154 +msgctxt "Name of the Application Callback Domain" +msgid "Root Domain" +msgstr "Root di dominio" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:158 +msgctxt "Name of the email service owner" +msgid "Microsoft" +msgstr "Microsoft" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:162 +msgctxt "Name of the email service" +msgid "Outlook.com" +msgstr "Outlook.com" + +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:166 +#: Postman/PostmanConfigTextHelper.php:228 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "an Application" +msgstr "una Applicazione" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:170 +msgctxt "Name of the email service portal" +msgid "Microsoft Developer Center" +msgstr "Microsoft Developer Center" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:212 +msgctxt "Name of the Application Callback URI" +msgid "Home Page URL" +msgstr "Indirizzo URL Home Page" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:216 +msgctxt "Name of the Application Callback Domain" +msgid "Callback Domain" +msgstr "Callback Domain" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:220 +msgctxt "Name of the email service owner" +msgid "Yahoo" +msgstr "Yahoo" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:224 +msgctxt "Name of the email service" +msgid "Yahoo Mail" +msgstr "Yahoo Mail" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:232 +msgctxt "Name of the email service portal" +msgid "Yahoo Developer Network" +msgstr "Yahoo Developer Network" + +#: Postman/PostmanConfigTextHelper.php:261 +msgid "Enter an Outgoing Mail Server with OAuth2 capabilities." +msgstr "Inserisci un server di posta in uscita con funzionalità OAuth2." + +#: Postman/PostmanConfigTextHelper.php:277 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URI" +msgstr "URI reindirizzamento" + +#: Postman/PostmanConfigTextHelper.php:280 +msgctxt "Name of the Application Callback Domain" +msgid "Website Domain" +msgstr "Nome di dominio website" + +#: Postman/PostmanConfigTextHelper.php:304 +msgid "Grant OAuth 2.0 Permission" +msgstr "Autorizzazioni Grant OAuth 2.0" + +#: Postman/PostmanInputSanitizer.php:137 +msgid "must be greater than 0" +msgstr "deve essere maggiore di 0" + +#: Postman/PostmanViewController.php:112 +msgid "An unexpected error occurred" +msgstr "" + +#: Postman/PostmanViewController.php:113 +msgid "Unexpected PHP messages corrupted the Ajax response" +msgstr "" + +#: Postman/PostmanViewController.php:118 +msgctxt "Press this button to Finish this task" +msgid "Finish" +msgstr "Finito" + +#: Postman/PostmanViewController.php:119 +msgctxt "Press this button to go to the next step" +msgid "Next" +msgstr "Il Prossimo" + +#: Postman/PostmanViewController.php:120 +msgctxt "Press this button to go to the previous step" +msgid "Previous" +msgstr "Precedente" + +#: Postman/PostmanViewController.php:132 +msgid "Postman is unable to run. Email delivery is being handled by WordPress (or another plugin)." +msgstr "" + +#. translators: where %d is the number of emails delivered +#: Postman/PostmanViewController.php:147 +msgid "Postman has delivered %d email." +msgid_plural "Postman has delivered %d emails." +msgstr[0] "Postman ha consegnato %d e-mail." +msgstr[1] "Postman ha consegnato %d e-mail." + +#: Postman/PostmanViewController.php:150 +msgid "The last %d email attempts are recorded in the log." +msgstr "I tentativi di posta elettronica ultimi %d sono registrati nel registro." + +#: Postman/PostmanViewController.php:155 +msgid "Thank-you for choosing Postman!" +msgstr "Grazie per aver scelto Postman!" + +#. translators: where %s is the URL of the Setup Wizard +#: Postman/PostmanViewController.php:157 +msgid "Let's get started! All users are strongly encouraged to run the Setup Wizard." +msgstr "Cominciamo! Tutti gli utenti sono fortemente incoraggiati a iniziare eseguendo l' installazione guidata." + +#: Postman/PostmanViewController.php:158 +msgid "Alternately, manually configure your own settings and/or modify advanced options." +msgstr "In alternativa, configurare manualmente le proprie impostazioni e / o modificare le opzioni avanzate." + +#. translators: where %s is the URL to the WordPress.org review and ratings +#. page +#: Postman/PostmanViewController.php:163 +msgid "Please consider leaving a review to help spread the word! :D" +msgstr "Si prega di considerare di lasciare una recensione per aiutare a diffondere la parola! : D" + +#: Postman/PostmanViewController.php:165 +msgid "Postman needs translators! Please take a moment to translate a few sentences on-line" +msgstr "" + +#: Postman/PostmanViewController.php:167 +msgid "New for v1.7! Send mail with the Mandrill or SendGrid APIs." +msgstr "" + +#: Postman/PostmanViewController.php:191 +msgctxt "Return to main menu link" +msgid "Back To Main Menu" +msgstr "Tornare al menu principale" + +#: Postman/PostmanViewController.php:198 Postman/PostmanViewController.php:233 +#: Postman/PostmanViewController.php:284 +msgid "Import" +msgstr "Importare" + +#: Postman/PostmanViewController.php:199 Postman/PostmanViewController.php:285 +msgid "Export" +msgstr "Esportazione" + +#: Postman/PostmanViewController.php:200 Postman/PostmanViewController.php:286 +msgid "Reset Plugin" +msgstr "Ripristina Plugin" + +#: Postman/PostmanViewController.php:206 +msgid "Copy this data into another instance of Postman to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:225 +msgid "Paste data from another instance of Postman here to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:228 +msgid "Using the same OAuth 2.0 Client ID and Client Secret from this site at the same time as another site will cause failures." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "This will purge all of Postman's settings, including account credentials and the email log." +msgstr "Questo sarà eliminare tutte le impostazioni del postino, comprese le credenziali dell'account e il log di posta." + +#: Postman/PostmanViewController.php:241 +msgid "Are you sure?" +msgstr "Sei sicuro?" + +#: Postman/PostmanViewController.php:261 +msgid "Configuration" +msgstr "Configurazione" + +#: Postman/PostmanViewController.php:262 +msgid "Start the Wizard" +msgstr "Avviare la procedura guidata" + +#: Postman/PostmanViewController.php:263 +msgid "Show All Settings" +msgstr "Configurare Manualmente" + +#: Postman/PostmanViewController.php:266 +msgctxt "Main Menu" +msgid "Actions" +msgstr "Azioni" + +#: Postman/PostmanViewController.php:292 +msgctxt "Main Menu" +msgid "Troubleshooting" +msgstr "Risoluzione Dei Problemi" + +#: Postman/PostmanViewController.php:296 +msgid "Online Support" +msgstr "Supporto Online" + +#. Plugin URI of the plugin/theme +msgid "https://wordpress.org/plugins/postman-smtp/" +msgstr "https://it.wordpress.org/plugins/postman-smtp/" + +#. Description of the plugin/theme +msgid "Email not reliable? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +msgstr "La Email non funziona? Postman è il primo e unico plugin WordPress SMTP per implementare lo standard di sicurezza OAuth 2.0 per Gmail e Hotmail. L'installazione è un gioco da ragazzi con la procedura guidata di configurazione e Tester Port integrata. Godetevi la consegna senza problemi, anche se effettuate una modifica della password!" + +#. Author of the plugin/theme +msgid "Jason Hendriks" +msgstr "Jason Hendriks" + +#. Author URI of the plugin/theme +msgid "http://www.codingmonkey.ca" +msgstr "http://www.codingmonkey.ca" + +#~ msgid "Change the delivery method on the %s!" +#~ msgstr "Cambiare il metodo di consegna sul %s!" + +#~ msgid "Configure the plugin." +#~ msgstr "Configura il plugin." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Test Your Setup" +#~ msgstr "Verifica La Tua Configurazione" + +#~ msgctxt "eg. TCP Port 25" +#~ msgid "Port" +#~ msgstr "Porta" + +#~ msgid "Port %d can be used to send email with the %s." +#~ msgstr "Porta %d può essere utilizzata per l'API di %s." + +#~ msgctxt "as in \"There is no Authentication\"" +#~ msgid "no" +#~ msgstr "no" + +#~ msgctxt "Log Level" +#~ msgid "Off" +#~ msgstr "Off" + +#~ msgctxt "Log Level" +#~ msgid "Trace" +#~ msgstr "Trace" + +#~ msgctxt "Log Level" +#~ msgid "Debug" +#~ msgstr "Debug" + +#~ msgctxt "Log Level" +#~ msgid "Info" +#~ msgstr "Info" + +#~ msgctxt "Log Level" +#~ msgid "Warning" +#~ msgstr "Warning" + +#~ msgctxt "Log Level" +#~ msgid "Error" +#~ msgstr "Error" + +#~ msgid "New for v1.6! Email Log" +#~ msgstr "Nuovo per v 1.6! E-mail Log" + +#~ msgid "Enable to save a copy of all your emails. Great for troubleshooting or as a backup for messages that get lost. Access the Email Log in the Tools menu." +#~ msgstr "Permettono di salvare una copia di tutte le tue email. Grande per la risoluzione dei problemi o come backup per i messaggi che si perdono. Accedere al Registro di Email nel menu strumenti." + +#~ msgctxt "The configuration page of the plugin" +#~ msgid "Settings" +#~ msgstr "Impostazioni" + +#~ msgid "Postman is not handling email delivery." +#~ msgstr "Postman è non movimentazione consegna della posta." + +#~ msgctxt "As in type used: None" +#~ msgid "None" +#~ msgstr "Nessuno" + +#~ msgctxt "Who do we reply to?" +#~ msgid "Reply-To" +#~ msgstr "Reply-To" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +#~ msgstr "Questa è la conversazione tra postino e il server SMTP. Può essere utile per la diagnosi dei problemi. NON pubblicarlo on-line, si può contenere la password in forma codificata." + +#~ msgid "Postman Email Log" +#~ msgstr "Postino Email Log" + +#~ msgid "This is a record of deliveries made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Questo è un record di consegna tentativi fatti a posta presentazione agente (MSA). Non indica necessariamente sucessful consegna al destinatario." + +#~ msgid "Warning: An empty subject line can result in delivery failure." +#~ msgstr "Attenzione: un oggetto vuoto può causare la mancata consegna." + +#~ msgctxt "View the transcript of an item from the email log" +#~ msgid "Transcript" +#~ msgstr "Trascrizione" + +#~ msgctxt "Attempt to resend this email" +#~ msgid "Resend" +#~ msgstr "Invia di nuovo" + +#~ msgctxt "Was sending this email successful or not?" +#~ msgid "Status" +#~ msgstr "Status" + +#~ msgctxt "Transport Name" +#~ msgid "Gmail API" +#~ msgstr "Gmail API" + +#~ msgctxt "Authentication Type is OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgid "Postman will send mail via the 🔐Gmail API using %s authentication." +#~ msgstr "Postman invierà mail tramite il 🔐API Gmail utilizzando l'autenticazione %s." + +#~ msgid "OAuth 2.0 authentication requires a Client ID and Client Secret." +#~ msgstr "L'autenticazione OAuth 2.0 un mittente Indirizzo e-mail, ID client e client segreto." + +#~ msgid "Envelope From Address and Message From Address can not be empty." +#~ msgstr "Busta Mittente Indirizzo e Messaggio Mittente Indirizzo non può essere vuoto." + +#~ msgid "Postman recommends Gmail API configuration on port %d" +#~ msgstr "Postman raccomanda configurazione API Gmail sulla porta %d" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP" +#~ msgstr "SMTP" + +#~ msgctxt "As in type used: CRAM-MD5" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "As in type used: Login" +#~ msgid "Login" +#~ msgstr "Accesso" + +#~ msgctxt "As in type used: Plain" +#~ msgid "Plain" +#~ msgstr "Intero" + +#~ msgctxt "This authentication type is password-based" +#~ msgid "Password (%s)" +#~ msgstr "Password (%s)" + +#~ msgid "Password authentication (Plain/Login/CRAM-MD5) requires a username and password." +#~ msgstr "L'autenticazione password (Plain / Login / CRAMMD5) richiede un nome utente e una password." + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, %1$s, and %2$s." +#~ msgstr "L’ autenticazione OAuth 2.0 richiede un server cha abbia la funzione per la posta in uscita OAuth 2.0 abilitata, Indirizzo e-mail del mittente, %1$s, e %2$s." + +#~ msgid "Your recommended settings are %1$s with %2$s authentication to host %4$s on port %3$d." +#~ msgstr "Postman raccomanda %1$s con l'autenticazione %2$s sulla porta %3$d." + +#~ msgid "The selected transport '%s' is unavailable. The external plugin was probably deactivated." +#~ msgstr "La scelta del trasporto '%s' non è disponibile. Il plugin esterno è stato probabilmente disattivato." + +#~ msgid "WordPress is still handling email delivery, not Postman." +#~ msgstr "Postman è non movimentazione consegna della posta." + +#~ msgctxt "The Transport is the method for sending mail, SMTP or API" +#~ msgid "Transport" +#~ msgstr "Trasporto" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport Settings" +#~ msgstr "Impostazioni di trasporto" + +#~ msgctxt "Authentication proves the user's identity" +#~ msgid "Authentication" +#~ msgstr "Autenticazione" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Username" +#~ msgstr "Nome Utente" + +#~ msgctxt "The Envelope Sender Email Address" +#~ msgid "Envelope From Address" +#~ msgstr "Busta mittente Indirizzo" + +#~ msgctxt "The Message Sender Email Address" +#~ msgid "Message From Address" +#~ msgstr "Messaggio Mittente Indirizzo" + +#~ msgctxt "The email address to address replies to" +#~ msgid "Reply-To" +#~ msgstr "Reply-To" + +#~ msgid "Maximum Number of Log Entries" +#~ msgstr "Limite di voci di registro" + +#~ msgid "Maximum Number of Lines in a Transcript" +#~ msgstr "Dimensione di trascrizione (linee totale)" + +#~ msgid "Configure the communication with the Mail Submission Agent (MSA):" +#~ msgstr "Configurare la comunicazione con il Mail Submission Agent (MSA):" + +#~ msgid "Enter the account username (email address) and password:" +#~ msgstr "Inserire il nome utente (indirizzo e-mail) e la password:" + +#~ msgid "This will purge all of Postman's settings, including SMTP server info, username/password and OAuth Credentials." +#~ msgstr "Questo eliminerà tutte le impostazioni di Postman, comprese informazioni server SMTP, nome utente / password e credenziali OAuth." + +#~ msgid "Log Level specifies the level of detail written to the WordPress log - view the log with Debug. Delivery mode offers options useful for developing or testing." +#~ msgstr "Livello di log specifica il livello di dettaglio scritto alle WordPress lo - visualizzare il registro con Debug. Modalità di consegna offre opzioni utili per lo sviluppo o il test." + +#~ msgid "Attention! Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +#~ msgstr "Attenzione! Apri il %2$s, creato %7$s usando l' URL mostrato di seguito, e copia i %3$s and %4$s qui" + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Grant OAuth Permission" +#~ msgstr "Autorizzazioni Grant OAuth" + +#~ msgid " must be greater than 0" +#~ msgstr "deve essere maggiore di 0" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup" +#~ msgstr "Impostazioni Postman" + +#~ msgid "Welcome" +#~ msgstr "Ciao" + +#~ msgid "This is the Settings page for Postman, an SMTP mailer that delivers email from your WordPress site to the Internet. From here you can configure the plugin, and access testing and diagnostic tools." +#~ msgstr "Questa è la pagina di impostazioni per il postino, un mailer SMTP che offre e-mail dal vostro sito WordPress a Internet. Da qui è possibile configurare il plugin e accedere agli strumenti di test e diagnostici." + +#~ msgid "Having trouble? You can ask for help on our Support Forum. To get the help you need quickly, please post the Diagnostic Data with your question. You can also check the FAQ and Error Messages pages for answers." +#~ msgstr "Hai problemi? Può chiedere aiuto sul nostro Forum di supporto. Per ottenere l'aiuto che necessario rapidamente, si prega di inviare i Dati di diagnostica con la tua domanda. È inoltre possibile controllare le pagine FAQ e Messaggi di errore per le risposte." + +#~ msgid "The Email Test will send an email to you. If the test fails, the full SMTP session transcript is available to you.

    Receiving a single test email does not indicate perfect configuration. Some services may dump your email into a black-hole or mark it as Spam if you:" +#~ msgstr "Il Test Email invierà un'e-mail a voi. Se il test fallisce, la trascrizione della sessione SMTP completa è a vostra disposizione.

    Ricezione di una singolo test mail non indica perfetta configurazione. Alcuni servizi possono scaricare tua email in un buco nero o contrassegnarlo come Spam se si:" + +#~ msgid "Violate an SPF record" +#~ msgstr "Violare un record SPF" + +#~ msgid "You must use the SMTP server (MSA) approved by your domain to deliver your mail. (eg.) a @gmail.com sender address requires that authentication and delivery always be through smtp.gmail.com." +#~ msgstr "È necessario utilizzare il server SMTP (MSA) approvato dal tuo dominio per consegnare la posta. (es.) un indirizzo del mittente @gmail.com richiede che l'autenticazione e la consegna sia sempre attraverso smtp.gmail.com." + +#~ msgctxt "Forge as in a forgery (fake) is made" +#~ msgid "Forge the From Address" +#~ msgstr "Forgiare l'indirizzo" + +#~ msgid "Spoofing, when it results in an SPF violation, will get your message binned. Use your own address as the sender (From:) in every email." +#~ msgstr "Spoofing, quando si traduce in una violazione di SPF, otterrà il tuo messaggio cestinata. Utilizzare il proprio indirizzo come mittente (da:) in ogni email." + +#~ msgid "Consolidates details of your setup to aid the author in debugging problems, including: operating system details, WordPress configuration, Postman configuration, network connectivity and your domain's primary MX and SPF records. Your private authorization credentials are masked." +#~ msgstr "Consolida i dettagli del vostro setup per aiutare l'autore nel debug di problemi, tra cui: dettagli del sistema operativo, WordPress configurazione, configurazione di postino, connettività di rete e record SPF e MX primario del dominio. Le credenziali di autorizzazione privata sono mascherate." + +#~ msgid "The Connectivity Test will report this site's ability to reach a mail server, and interrogate the mail server for it's capabilities." +#~ msgstr "Il Test di connettività si segnala la capacità di questo sito per raggiungere un server di posta e interrogare il server di posta per è capacità." + +#~ msgctxt "Is it possible to create network connections to the Internet?" +#~ msgid "Outbound to Internet" +#~ msgstr "In uscita a Internet" + +#~ msgid "This tests the ability to make outbound connections from your site to the Internet in general. If the result is Closed, then there is a communication problem with the Internet, like a firewall." +#~ msgstr "Questo test la capacità di fare connessioni in uscita dal tuo sito per Internet in generale. Se il risultato è chiuso, poi c'è un problema di comunicazione con Internet, come un firewall." + +#~ msgctxt "What service is available?" +#~ msgid "Service Available" +#~ msgstr "Servizio disponibile" + +#~ msgid "This shows the service found for a particular host/port. Possible successful results are SMTP, SMTPS (secure) and HTTPS (secure). If the result is No and the hostname you entered is correct, there was a communication problem with the mail server, like a firewall." +#~ msgstr "Questo dimostra il servizio trovato per una particolare host/porta. Possibili risultati di successo sono SMTP, SMTPS (sicuro) e HTTPS (sicuro). Se il risultato è No e il nome host che hai inserito è corretto, c'era un problema di comunicazione con il server di posta, come un firewall." + +#~ msgctxt "What is this server's ID?" +#~ msgid "ID" +#~ msgstr "ID" + +#~ msgid "Some hosts redirect mail traffic to their own mail server, breaking authentication and SPF verification. This is revealed by an incorrect server identity." +#~ msgstr "Alcuni host reindirizzare il traffico di posta elettronica al proprio server di posta, rompendo l'autenticazione e verifica SPF. Lo rivela un'identità server errato." + +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgid "This indicates whether the server supports protocol-level security. Either STARTTLS, SMTPS or HTTPS is required for secure transmission of your credentials." +#~ msgstr "Indica se il server supporta il protocollo di livello di sicurezza. STARTTLS SMTPS o, HTTPS è necessaria per la trasmissione sicura delle vostre credenziali." + +#~ msgctxt "Short for Authentication" +#~ msgid "Auth" +#~ msgstr "Aut" + +#~ msgid "This indicates the authenication methods that the server supports. All are password-based, except for OAuth 2.0, which is token-based." +#~ msgstr "Ciò indica i metodi di autenticazione in modo che il server supporta. Tutti sono basati su password, ad eccezione di OAuth 2.0, che è basata su token." + +#~ msgctxt "A testing tool which determines connectivity to the Internet" +#~ msgid "Connectivity Test" +#~ msgstr "Test di connettività" + +#~ msgctxt "Email Test Status" +#~ msgid "Ajax Error" +#~ msgstr "Ajax Errore" + +#~ msgid "Unexpected PHP messages corrupted the Ajax response:" +#~ msgstr "Messaggi PHP imprevisti danneggiati la risposta Ajax:" + +#~ msgid "Warning: connected to %1$s instead of %2$s." +#~ msgstr "Attenzione: collegati a %1$s invece di %2$s." + +#~ msgid "Port %d can be used to send Gmail with the Gmail API." +#~ msgstr "Porta %d può essere utilizzata per inviare Gmail con l'API di Gmail." + +#~ msgid "WordPress (or another plugin) is currently handling email delivery, not Postman." +#~ msgstr "WordPress (o un altro plugin) è al momento gestendo consegna di posta elettronica, non Postman." + +#~ msgctxt "Page Title" +#~ msgid "Manual Configuration" +#~ msgstr "Configurazione manuale" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Account" +#~ msgstr "Conto" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Message" +#~ msgstr "Messaggio" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Logging" +#~ msgstr "Registrazione" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Advanced" +#~ msgstr "Impostazioni Avanzate" + +#~ msgid "Delete plugin settings" +#~ msgstr "Elimina impostazioni del plugin" + +#~ msgid "This will purge all of Postman's settings, including account credentials and the mail log." +#~ msgstr "Questo sarà eliminare tutte le impostazioni del postino, comprese le credenziali dell'account e il log di posta." + +#~ msgctxt "Button Label" +#~ msgid "Delete All Data" +#~ msgstr "Elimina tutti i dati" + +#~ msgctxt "The port number" +#~ msgid "Port %s" +#~ msgstr "Porta %s" + +#~ msgctxt "Authentication Type" +#~ msgid "None" +#~ msgstr "Nessuno" + +#~ msgid "* Port 443 tests against googleapis.com, not the SMTP hostname you enter." +#~ msgstr "* Porta 443 prove contro googleapis.com, non il nome host SMTP si entra." + +#~ msgid "A port with Service Available \"No\" indicates one or more of these issues:" +#~ msgstr "Una porta No indica:" + +#~ msgid "Your PHP configuration is preventing outbound connections" +#~ msgstr "Il tuo configurazione di PHP sta impedendo le connessioni in uscita" + +#~ msgid "Your WordPress configuration is preventing outbound connections" +#~ msgstr "Il tuo configurazione WordPress sta impedendo le connessioni in uscita" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "Show Advanced Configuration" +#~ msgstr "Configurazione Avanzata" + +#~ msgid "Disable" +#~ msgstr "Disattivare" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup Wizard" +#~ msgstr "Preparare Procedura Guidata Postman" + +#~ msgid "Error: Your email address requires access to a remote SMTP server blocked by GoDaddy. Use a different e-mail address." +#~ msgstr "Errore: tua e-mail indirizzo richiede l'accesso a un server SMTP remoto bloccato da GoDaddy. Utilizzare un indirizzo di posta elettronica diverso." + +#~ msgid "Warning: If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems." +#~ msgstr "Attenzione: Se possedete questo dominio, assicurarsi che dispone di un record SPF che autorizza GoDaddy come un relè, o avrete problemi di consegna." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will the connection to the MSA be established?" +#~ msgstr "Come verrà stabilita la connessione al MSA?" + +#~ msgid "Warning: This configuration option will send your authorization credentials in the clear." +#~ msgstr "Attenzione: Questa opzione di configurazione invierà le credenziali di autorizzazione in chiaro." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will you prove your identity to the MSA?" +#~ msgstr "Come pensate di dimostrare la propria identità per la MSA?" + +#~ msgid "Enter your credentials. Your username is often your email address." +#~ msgstr "Inserisci le tue credenziali. Il nome utente è più probabile il tuo indirizzo email." + +#~ msgid "Examine the SMTP Session Transcript if you need to." +#~ msgstr "Esaminare la sessione SMTP Trascrizione se è necessario." + +#~ msgid "SMTP Session Transcript" +#~ msgstr "Trascrizione della Sessione SMTP" + +#~ msgid "The Envelope From address identifies the account owner to the SMTP server." +#~ msgstr "La busta mittente Indirizzoda il proprietario dell'account al server SMTP." + +#~ msgid "The Message From address identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Themes and other plugins, especially Contact Forms, are permitted to modify this field." +#~ msgstr "Il messaggio mittente indirizzo identifica il mittente al destinatario. Modificare questo quando stai inviando a nome di qualcun altro, ad esempio per utilizzare la funzione di Google Invia Mail come . Temi e altri plugin, soprattutto forme di contatto, sono autorizzati a modificare questo campo." + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful for developing or testing." +#~ msgstr "Livello di registro specifica il livello di dettaglio, scritto per i file di registro di WordPress e PHP. Modalità di consegna offre opzioni utili in un ambiente di sviluppo." + +#~ msgid "The server returned an unexpected result:" +#~ msgstr "Il server ha restituito un risultato inaspettato e non valido:" + +#~ msgid "Postman has delivered %d email for you." +#~ msgid_plural "Postman has delivered %d emails for you." +#~ msgstr[0] "Postman ha consegnato %d e-mail per voi!" +#~ msgstr[1] "Postman ha consegnato %d e-mail per voi!" + +#~ msgid "View the log" +#~ msgstr "Visualizza log" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "configure manually" +#~ msgstr "configurare manualmente" + +#~ msgid "The server returned an unexpected and invalid result:" +#~ msgstr "Il server ha restituito un risultato inaspettato e non valido:" + +#~ msgid "Communication Error [334] - make sure the Sender Email belongs to the account which provided the OAuth 2.0 consent." +#~ msgstr "Errore di comunicazione [334] - assicurarsi che il Mittente Email appartenga allo stesso profilo per il quale e' concesso il consenso OAuth 2.0." + +#~ msgid "https://profiles.wordpress.org/jasonhendriks/" +#~ msgstr "https://profiles.wordpress.org/jasonhendriks/" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your shared secret (password) in encoded form." +#~ msgstr "Questa è la conversazione tra postino e il server SMTP. Può essere utile per la diagnosi dei problemi. NON pubblicarlo on-line, si può contenere la password in forma codificata." + +#~ msgid "Choose the Recipient" +#~ msgstr "Scegliere il destinatario" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Email Address" +#~ msgstr "Indirizzo Email" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Name" +#~ msgstr "Nome" + +#~ msgid "The Gmail API transport requires a Sender Email Address, Client ID and Client Secret." +#~ msgstr "Il trasporto API Gmail richiede un mittente Indirizzo e-mail, ID client e client segreto." + +#~ msgid "Outgoing Mail Server Hostname/Port and Sender Email Address can not be empty." +#~ msgstr "Server Posta in Uscita (SMTP), Porta e in indirizzo Email mittente non possono essere vuoti." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Sender" +#~ msgstr "Mittente" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Email Address" +#~ msgstr "Mittente Indirizzo e-mail" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Name" +#~ msgstr "Nome Mittente" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Addresses" +#~ msgstr "Indirizzi Aggiuntivi" + +#~ msgctxt "Configuration Input Field" +#~ msgid "To Recipient(s)" +#~ msgstr "Al destinatario(s)" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Carbon Copy Recipient(s)" +#~ msgstr "Carbon Copy Destinatario(s)" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Blind Carbon Copy Recipient(s)" +#~ msgstr "Blind Carbon Copy Destinatario(s)" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Headers" +#~ msgstr "Intestazioni Aggiuntive" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Custom Headers" +#~ msgstr "Intestazioni Personalizzate" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Enable Logging" +#~ msgstr "Abilita registrazione" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Log Entries Limit" +#~ msgstr "Limite di voci di registro" + +#~ msgctxt "The maximum number of lines of the SMTP transcript" +#~ msgid "Transcript Size (Total Lines)" +#~ msgstr "Dimensione di trascrizione (linee totale)" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Network Settings" +#~ msgstr "Impostazioni di rete" + +#~ msgid "The Sender sets both the envelope Mail-From and the message From header. However, the From header can be modified by another plugin (e.g. for setting a visitor's email address from a Contact Form)." +#~ msgstr "Il mittente imposta entrambi la busta Posta-da e dall'intestazione del messaggio. Tuttavia, è possibile modificare l'intestazione da un altro plugin (ad es. per l'impostazione indirizzo email di un visitatore da un modulo di contatto)." + +#~ msgid "Force this in the From header for all messages" +#~ msgstr "Questa forza nell'intestazione da per tutti i messaggi" + +#~ msgid "Communication Error [334] - make sure the Sender Email belongs to the account which provided the %s OAuth 2.0 consent." +#~ msgstr "Errore di comunicazione [334] - assicurarsi che il Mittente Email appartenga allo stesso profilo per il quale e' concesso il consenso %s OAuth 2.0." + +#~ msgid "Please note that to combat Spam, many email services will not let you send from an email address other than the one you authenticate with." +#~ msgstr "Si prega di notare che per combattere lo spam, molti servizi di posta elettronica non consentono l’ invio da un indirizzo e-mail diverso dal proprio." + +#~ msgctxt "Who is this message from?" +#~ msgid "From" +#~ msgstr "Dal" + +#~ msgctxt "Who is this message to?" +#~ msgid "To" +#~ msgstr "A" + +#~ msgctxt "Name of the email service portal" +#~ msgid "Google Developer Console" +#~ msgstr "Google Developer Console" + +#~ msgid "Please check the troubleshooting and error messages page and the support forum.
    If you write for help, please include the following:" +#~ msgstr "Controllare la pagina di risoluzione dei problemi e messaggi di errore e il forum di supporto.
    Se si scrive per un aiuto, si prega di includere le seguenti informazioni di diagnostica:" + +#~ msgid "Postman will send mail via the Gmail API using %s authentication." +#~ msgstr "Postman invierà mail tramite il API Gmail utilizzando l'autenticazione %s." + +#~ msgctxt "Transport Name" +#~ msgid "SMTPS" +#~ msgstr "SMTPS" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP-STARTTLS" +#~ msgstr "SMTP-STARTTLS" + +#~ msgid "The message sender is used as the default From: address." +#~ msgstr "Il mittente del messaggio viene utilizzato come Da: indirizzo." + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful in a development environment." +#~ msgstr "Livello di registro specifica il livello di dettaglio, scritto per i file di registro di WordPress e PHP. Modalità di consegna offre opzioni utili in un ambiente di sviluppo." + +#~ msgid "Force this Sender Name for all messages" +#~ msgstr "Forzare questo nome mittente per tutti i messaggi" + +#~ msgid "Force this Sender Email Address for all messages" +#~ msgstr "Questo indirizzo di Email del mittente per tutti i messaggi di forza" + +#~ msgid "Please note: When composing email, some WordPress plugins and themes may set an unauthorized sender email address causing rejection with services like Yahoo Mail. If you experience problems, enable \"Force this Sender Email Address for all messages\" in the settings." +#~ msgstr "Si prega di notare: quando comporre e-mail, alcuni plugin di WordPress e temi può impostare un mittente non autorizzato e-mail Indirizzo causando rigetto con servizi come Yahoo Mail. Se si verificano problemi, attivare \"Forzare questo indirizzo di Email del mittente per tutti i messaggi\" nelle impostazioni." + +#~ msgctxt "Encryption Type" +#~ msgid "SSL (SMTPS)" +#~ msgstr "SSL" + +#~ msgctxt "Encryption Type" +#~ msgid "TLS (StartTLS)" +#~ msgstr "TLS" + +#~ msgid "The impossible is possible; sending through wp_mail() failed, but sending through internal engine succeeded." +#~ msgstr "L'impossibile è possibile; l' invio tramite wp_mail() non è riuscito, ma l'invio attraverso il motore interno è riuscito." + +#~ msgid "Error: Postman is properly configured, but the current theme or another plugin is preventing service." +#~ msgstr "Errore: Postino è configurato correttamente, ma il tema corrente o un altro plugin sta impedendo il servizio." + +#~ msgid "See How do I get a %6$s %3$s? in the F.A.Q. for help." +#~ msgstr "Vedi Come faccio a %6$s %3$s? nelle FAQ per aiuto." + +#~ msgctxt "Short for \"Diagnostic Information\"" +#~ msgid "Diagnostic Info" +#~ msgstr "Consigli e informazioni di diagnostica" + +#~ msgctxt "Details about the system" +#~ msgid "Diagnostic Information" +#~ msgstr "Informazioni diagnostiche" + +#~ msgid "Run a Connectivity Test" +#~ msgstr "Eseguire un test di connettività" + +#~ msgid "The most common transport is SMTP:" +#~ msgstr "SMTP è il trasporto più comune:" + +#~ msgid "Email not working? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +#~ msgstr "La Email non funziona? Postman è il primo e unico plugin WordPress SMTP per implementare lo standard di sicurezza OAuth 2.0 per Gmail e Hotmail. L'installazione è un gioco da ragazzi con la procedura guidata di configurazione e Tester Port integrata. Godetevi la consegna senza problemi, anche se effettuate una modifica della password!" + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles." +#~ msgstr "Livello di log specifica la quantità di uscita dettaglio per i WordPress e file di log di PHP." + +#~ msgctxt "When the server is online to the public, this is \"Production\" mode" +#~ msgid "Production" +#~ msgstr "Produzione" + +#~ msgid "Log Emails, then Dump" +#~ msgstr "Login email, quindi il Dump" + +#~ msgid "Dump All Emails" +#~ msgstr "Elimina tutti i dati" + +#~ msgid "This is a record of delivery attempts made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Questo è un record di consegna tentativi fatti a posta presentazione agente (MSA). Non indica necessariamente sucessful consegna al destinatario." + +#~ msgid "Error authenticating with this Client ID - please create a new one. [%s]" +#~ msgstr "Errore di autenticazione con questo ID cliente - si prega di creare un nuovo. [%s]" + +#~ msgid "Warning: connected to %1$s instead of %2$s. This may be a problem." +#~ msgstr "Attenzione: collegati a %1$s invece di %2$s. Questo può essere un problema." + +#~ msgid "Outgoing Mail Server (SMTP) and Port can not be empty." +#~ msgstr "Server Posta in Uscita (SMTP) e Porta non possono essere vuoti." + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, Sender Email Address, %1$s, and %2$s." +#~ msgstr "L’ autenticazione OAuth 2.0 richiede un server cha abbia la funzione per la posta in uscita OAuth 2.0 abilitata, Indirizzo e-mail del mittente, %1$s, e %2$s." + +#~ msgid "Postman is properly configured, but another plugin has taken over the mail service. Deactivate the other plugin." +#~ msgstr "Postman è configurato correttamente, ma un altro plugin è ripreso il servizio di posta elettronica. Disattivare l'altro plugin." + +#~ msgctxt "postman-smtp" +#~ msgid "OAuth 2.0 (requires Client ID and Client Secret)" +#~ msgstr "OAuth 2.0 (richiede un ID Client e Client segreto)" + +#~ msgctxt "Authentication Type is Password" +#~ msgid "Password" +#~ msgstr "Password" + +#~ msgctxt "Authentication Type" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgctxt "Authentication Type" +#~ msgid "no" +#~ msgstr "no" + +#~ msgctxt "Authentication Type" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "Authentication Type" +#~ msgid "Login" +#~ msgstr "Accesso" + +#~ msgctxt "Authentication Type" +#~ msgid "Plain" +#~ msgstr "Intero" + +#~ msgctxt "Authentication Type" +#~ msgid "Password (%s)" +#~ msgstr "Password (%s)" + +#~ msgid "Password authentication (Plain/Login/CRAMMD5) requires a username and password." +#~ msgstr "L'autenticazione password (Plain / Login / CRAMMD5) richiede un nome utente e una password." + +#~ msgid "Your recommended settings are %1$s with %2$s authentication on port %3$d." +#~ msgstr "Postman raccomanda %1$s con l'autenticazione %2$s sulla porta %3$d." + +#~ msgctxt "Postman Dashboard Widget Title" +#~ msgid "Postman SMTP" +#~ msgstr "Postman SMTP" + +#~ msgctxt "Dashboard Widget Settings Link label" +#~ msgid "Settings" +#~ msgstr "Impostazioni" + +#~ msgid "Postman is missing a required PHP library." +#~ msgstr "Postman manca una libreria PHP richiesta." + +#~ msgctxt "Plugin Action Links" +#~ msgid "Settings" +#~ msgstr "Impostazioni" + +#~ msgid "All plugin settings were removed." +#~ msgstr "Tutte le impostazioni del plugin sono stati rimossi." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport" +#~ msgstr "Trasporto" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Transport" +#~ msgstr "Trasporto" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Authentication" +#~ msgstr "Autenticazione" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Outgoing Mail Server Hostname" +#~ msgstr "Nome host server SMTP" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Outgoing Mail Server Port" +#~ msgstr "Porta Server SMTP" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Authentication" +#~ msgstr "Autenticazione" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Password" +#~ msgstr "Password" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Reply-To" +#~ msgstr "Reply-To" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Log Level" +#~ msgstr "Livello di registrazione" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Delete plugin settings" +#~ msgstr "Elimina impostazioni del plugin" + +#, fuzzy +#~ msgid "The default transport is SMTP." +#~ msgstr "Il trasporto predefinito è SMTP." + +#~ msgid "Select the transport to use:" +#~ msgstr "Uno o più di estensione (s) ha installato trasporti aggiuntivi:" + +#~ msgid "Select the authentication method, security type, and enter the Mail Submission Agent (MSA) hostname and port:" +#~ msgstr "Selezionare il metodo di autenticazione e immettere il nome host e la porta del server SMTP:" + +#~ msgid "Enter the username (email address) and password you use to send email" +#~ msgstr "Inserire il nome utente (indirizzo e-mail) e la password utilizzati per l'invio di posta elettronica" + +#~ msgid "The message sender is used as the From: address." +#~ msgstr "Il mittente del messaggio viene utilizzato come Da: indirizzo." + +#~ msgid "The Reply-To overrides the Sender when the recipient composes a reply. Separate multiple to/cc/bcc recipients with commas." +#~ msgstr "Il Reply-To sostituisce il mittente quando il destinatario compone una risposta. Separare più to/cc/bcc destinatari con le virgole." + +#~ msgctxt "Encryption Type" +#~ msgid "None" +#~ msgstr "Nessuno" + +#~ msgctxt "Encryption Type" +#~ msgid "SSL" +#~ msgstr "SSL" + +#~ msgctxt "Encryption Type" +#~ msgid "TLS" +#~ msgstr "TLS" + +#~ msgid "Prevent the Sender Name from being overridden" +#~ msgstr "Evitare che il nome mittente venga sovrascritto" + +#~ msgid "Prevent the Sender Email Address from being overridden" +#~ msgstr "Impedire l'indirizzo email del mittente venga sovrascritto" + +#~ msgid "Attention! Open the %2$s, create %7$s using the URL's displayed below, and copy the %3$s and %4$s here." +#~ msgstr "Attenzione! Apri il %2$s, creato %7$s usando l' URL mostrato di seguito, e copia i %3$s and %4$s qui" + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Request permission from %s" +#~ msgstr "Richiesta permesso di" + +#~ msgctxt "Name of the Application Callback Domain" +#~ msgid "Javascript Origins" +#~ msgstr "Javascript Origins" + +#~ msgctxt "Name of the OAuth 2.0 Client Secret" +#~ msgid "Client secret" +#~ msgstr "Client secret" + +#~ msgctxt "Name of the OAuth 2.0 Client ID" +#~ msgid "Consumer Key" +#~ msgstr "Consumer Key" + +#~ msgctxt "Name of the OAuth 2.0 Client Secret" +#~ msgid "Consumer Secret" +#~ msgstr "Consumer Secret" + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Request OAuth Permission" +#~ msgstr "Richiesta autorizzazione OAuth" + +#~ msgctxt "Page Title" +#~ msgid "Postman Settings" +#~ msgstr "Impostazioni Postman" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Checking.." +#~ msgstr "Verificando.." + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Open" +#~ msgstr "Aperto" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Closed" +#~ msgstr "Chiuso" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Done." +#~ msgstr "Fatto." + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Yes" +#~ msgstr "Si" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "No" +#~ msgstr "No" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Port" +#~ msgstr "Porta" + +#~ msgid "Port %d is blocked. Contact your host for a solution, such as using their local SMTP server or opening the port." +#~ msgstr "Port %d è bloccato. Contattate il vostro ospite per una soluzione, come ad esempio utilizzando il loro server SMTP locale o aprire la porta." + +#~ msgid "Port %d can't send mail with %s. Try a different SMTP server." +#~ msgstr "Port %d non è possibile inviare la posta con il %s. Provare un server SMTP diverso." + +#~ msgid "Port %d can be used to send Gmail with the Postman Gmail Extension." +#~ msgstr "Port %d può essere utilizzato per inviare Gmail con il Postman Gmail Extension." + +#~ msgid "Port %d is blocked. Contact your host for a solution, such as opening the port." +#~ msgstr "Port %d è bloccato. Contattate il vostro ospite per una soluzione, come l'apertura della porta." + +#~ msgid "Please wait for the port test to finish" +#~ msgstr "Attendere per il test della porta per finire" + +#~ msgid "No ports are available for this SMTP server. Try a different SMTP host or contact your WordPress host for their specific solution." +#~ msgstr "Nessuna porta disponibile per il server SMTP. Provare un host SMTP diverso oppure contattare il tuo host WordPress per una soluzione specifica." + +#~ msgctxt "Wizard Label" +#~ msgid "current step:" +#~ msgstr "passo corrente:" + +#~ msgctxt "Wizard Label" +#~ msgid "Pagination" +#~ msgstr "Paginatura" + +#~ msgctxt "Wizard Label" +#~ msgid "Finish" +#~ msgstr "Finitura" + +#~ msgctxt "Wizard Label" +#~ msgid "Next" +#~ msgstr "Il Prossimo" + +#~ msgctxt "Wizard Label" +#~ msgid "Previous" +#~ msgstr "Precedente" + +#~ msgctxt "Wizard Label" +#~ msgid "Loading ..." +#~ msgstr "Caricamento ..." + +#~ msgid "Please note: When composing email, other WordPress plugins and themes are forbidden from overriding the sender email address." +#~ msgstr "Si prega di notare: Durante la composizione di una e-mail, altri plugin WordPress o temi possono modificare unicamente il nome del mittente" + +#~ msgid "Please note: When composing email, other WordPress plugins and themes may override the sender name and email address causing rejection with some email services, such as Yahoo Mail. If you experience problems, try leaving the sender email address empty in these plugins or themes." +#~ msgstr "Si prega di notare: Durante la composizione di una e-mail, altri plugin WordPress o temi possono modificare il nome del mittente e l'indirizzo e-mail causando un rifiuto del messaggio con alcuni servizi di posta elettronica, come Yahoo Mail. In caso di problemi, provare a lasciare l'indirizzo email del mittente vuoto in questi plugin o temi." + +#~ msgid "Postman has delivered %d email for you!" +#~ msgid_plural "Postman has delivered %d emails for you!" +#~ msgstr[0] "Postman ha consegnato %d e-mail per voi!" +#~ msgstr[1] "Postman ha consegnato %d e-mail per voi!" + +#~ msgid "Please consider leaving a review of Postman SMTP to help spread the word about the new way to send email from WordPress! :D" +#~ msgstr "Si prega di considerare di lasciare un commento di Postman SMTP per aiutare
    diffondere la parola circa il nuovo modo per inviare e-mail da WordPress! : D" + +#~ msgctxt "Page Title" +#~ msgid "Delete plugin settings" +#~ msgstr "Elimina impostazioni del plugin" + +#~ msgctxt "Page Title" +#~ msgid "Connectivity Test" +#~ msgstr "Connettività di prova" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Test" +#~ msgstr "Test" + +#~ msgctxt "Port Test" +#~ msgid "Port %s" +#~ msgstr "Porta %s" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Outbound to Internet" +#~ msgstr "In uscita a Internet" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Service Available" +#~ msgstr "Servizio disponibile" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgid "Conclusion" +#~ msgstr "Conclusione" + +#~ msgid "A Closed port indicates one or more of these issues:" +#~ msgstr "Una porta Chiusa indica:" + +#~ msgid "Your host has placed a firewall between this site and the Internet" +#~ msgstr "Il tuo host ha inserito un firewall tra il sito e il server SMTP oppure" + +#~ msgctxt "Page Title" +#~ msgid "Tips and Diagnostic Info" +#~ msgstr "Consigli e informazioni di diagnostica" + +#~ msgid "Please check the troubleshooting and error messages page and the support forum.
    If you write for help, please include the following diagnostic information:" +#~ msgstr "Controllare la pagina di risoluzione dei problemi e messaggi di errore e il forum di supporto.
    Se si scrive per un aiuto, si prega di includere le seguenti informazioni di diagnostica:" + +#~ msgctxt "Page Title" +#~ msgid "Diagnostic Information" +#~ msgstr "Informazioni diagnostiche" + +#~ msgctxt "Main Menu" +#~ msgid "Get Started" +#~ msgstr "Inizia" + +#~ msgctxt "Button Label" +#~ msgid "Start the Wizard" +#~ msgstr "Avviare la procedura guidata" + +#~ msgctxt "Main Menu" +#~ msgid "configure manually" +#~ msgstr "configurare manualmente" + +#~ msgctxt "Page Title" +#~ msgid "Send a Test Email" +#~ msgstr "Invia una mail di prova" + +#~ msgctxt "Main Menu" +#~ msgid "Delete plugin settings" +#~ msgstr "Elimina impostazioni del plugin" + +#~ msgctxt "Main Menu" +#~ msgid "Run a Connectivity Test" +#~ msgstr "Eseguire un test di connettività" + +#~ msgctxt "Main Menu" +#~ msgid "Online Support" +#~ msgstr "Supporto Online" + +#~ msgctxt "Plugin to Import Configuration from" +#~ msgid "None" +#~ msgstr "Nessuno" + +#~ msgid "Please enter the email address and name you'd like to send mail from." +#~ msgstr "Inserisci per favore l'indirizzo email e il nome dal quale vuoi inviare la posta." + +#~ msgid "Please note that to combat Spam, many email services will not let you send from an e-mail address other than the one you authenticate with in step 5." +#~ msgstr "Si prega di notare che per combattere lo spam, molti servizi di posta elettronica non consentono l’ invio da un indirizzo e-mail diverso dal proprio." + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Email Name" +#~ msgstr "Nome Mittente Email" + +#~ msgctxt "Wizard Step Title" +#~ msgid "Outgoing Mail Server Hostname" +#~ msgstr "Nome host server SMTP" + +#~ msgid "This is the local Outgoing Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. These servers are normally specific to the email account you have, and if you don't know which server to use, ask your email service provider.

    If possible, the Wizard will pre-fill this field based on the e-mail address you entered." +#~ msgstr "Questo è il server di posta in uscita, noto anche come un Invio posta Agent, che Postman userà per consegnare la posta. Se possibile, Postman cercherà di determinare questo nome host in base all'indirizzo e-mail." + +#~ msgctxt "Wizard Step Title" +#~ msgid "Connectivity Test" +#~ msgstr "Connettività di prova" + +#~ msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows. Postman will attempt to determine which options are available to you." +#~ msgstr "Il nome host del server e la porta si può usare è una combinazione di ciò che le vostre offerte fornitore di servizi di posta, e che cosa il vostro ospite WordPress permette. Postman tenterà di determinare quali opzioni sono a vostra disposizione." + +#~ msgctxt "Wizard Action" +#~ msgid "Connectivity Test" +#~ msgstr "Test di connettività" + +#~ msgid "Configuration will proceed on socket %1$s using %2$s authentication." +#~ msgstr "Configurazione procederà sulla presa %1$s utilizzando l'autenticazione %2$s." + +#~ msgctxt "Wizard Step Title" +#~ msgid "Authentication" +#~ msgstr "Autenticazione" + +#~ msgid "Enter your credentials. Your username is most likely your email address." +#~ msgstr "Inserisci le tue credenziali. Il nome utente è più probabile il tuo indirizzo email." + +#~ msgctxt "Wizard Step Title" +#~ msgid "Finish" +#~ msgstr "Finito" + +#~ msgid "Request permission from the Email Provider to allow Postman to send email and" +#~ msgstr "Richiedi il permesso dal provider di posta elettronica per consentire a Postman di inviare e-mail e" + +#~ msgid "Status Message" +#~ msgstr "Stato Messaggio" + +#~ msgctxt "Authentication Type" +#~ msgid "Password" +#~ msgstr "Password" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Auth" +#~ msgstr "Aut" + +#~ msgctxt "Configuration Input Field" +#~ msgid "SMTP Server Hostname" +#~ msgstr "SMTP Server Hostname" + +#~ msgctxt "Configuration Input Field" +#~ msgid "SMTP Server Port" +#~ msgstr "SMTP Porta Server" + +#~ msgid "Select the authentication method and enter the SMTP server hostname and port:" +#~ msgstr "Selezionare il metodo di autenticazione e immettere il nome host e la porta del server SMTP:" + +#~ msgctxt "Wizard Step Title" +#~ msgid "SMTP Server Hostname" +#~ msgstr "SMTP Server Hostname" + +#~ msgid "Your connection to the SMTP server depends on what your email service provider offers, and what your WordPress host allows. Postman will attempt to determine which options are available to you." +#~ msgstr "Il nome host del server e la porta si può usare è una combinazione di ciò che le vostre offerte fornitore di servizi di posta, e che cosa il vostro ospite WordPress permette. Postman tenterà di determinare quali opzioni sono a vostra disposizione." + +#~ msgid "This is the Outgoing Mail Server, also known as a Mail Submission Agent (MSA), that Postman will use to deliver your mail. If possible, Postman will try to determine this hostname based on the e-mail address." +#~ msgstr "Questo è il server di posta in uscita, noto anche come un Invio posta Agent (MSA), che Postman userà per consegnare la posta. Se possibile, Postman cercherà di determinare questo nome host in base all'indirizzo e-mail." + +#~ msgid "You are about to configure OAuth 2.0 with an IP address in the URL which will fail. Either assign a real domain name to your site or add a fake one in your local machine's host file." +#~ msgstr "Stai per configurare OAuth 2.0 con un indirizzo IP nell'URL che fallirà. O assegnare un vero nome di dominio per il tuo sito o aggiungere un falso in file host del computer locale." + +#~ msgid "This test determines which well-known sockets are available for Postman to use." +#~ msgstr "Questo test determina quali sono disponibili per Postman usare prese noti." diff --git a/Postman/languages/postman-smtp-nl_NL.mo b/Postman/languages/postman-smtp-nl_NL.mo new file mode 100644 index 0000000..c657bd7 Binary files /dev/null and b/Postman/languages/postman-smtp-nl_NL.mo differ diff --git a/Postman/languages/postman-smtp-nl_NL.po b/Postman/languages/postman-smtp-nl_NL.po new file mode 100644 index 0000000..dfa9fc7 --- /dev/null +++ b/Postman/languages/postman-smtp-nl_NL.po @@ -0,0 +1,1914 @@ +# Copyright (C) 2015 Postman SMTP +# This file is distributed under the same license as the Postman SMTP package. +msgid "" +msgstr "" +"Project-Id-Version: Postman SMTP 1.6.11\n" +"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/postman-smtp\n" +"POT-Creation-Date: 2015-11-08 17:17-0500\n" +"PO-Revision-Date: 2015-11-09 01:15-0500\n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: nl_NL\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"X-Generator: Poedit 1.8.6\n" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:94 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:348 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:357 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:99 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:545 +#: Postman/PostmanViewController.php:227 +msgid "Warning" +msgstr "Waarschuwing" + +#. translators: where %s is the name of the SMTP server +#: Postman/Postman-Configuration/PostmanConfigurationController.php:96 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +msgid "connected to %1$s instead of %2$s." +msgstr "connect naar %1$s in plaast van %2$s." + +#. translators: where %d is a port number +#: Postman/Postman-Configuration/PostmanConfigurationController.php:98 +msgid "You are about to configure OAuth 2.0 with an IP address instead of a domain name. This is not permitted. Either assign a real domain name to your site or add a fake one in your local host file." +msgstr "Je gaat OAuth 2.0 configureren met een IP adres in plaats van een domeinnaam. Dit is niet toegestaan. Of verwijz een echte domeinnaam naar je site of voeg een imitatie in je local hoste file." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/PostmanViewController.php:53 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "%s Setup" +msgstr "%s Setup" + +#. Plugin Name of the plugin/theme +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:57 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:70 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:176 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/Postman.php:61 Postman/PostmanViewController.php:53 +#: Postman/PostmanViewController.php:54 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "Postman SMTP" +msgstr "Postman SMTP" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:196 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:81 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 Postman/Postman.php:316 +#: Postman/PostmanAdminController.php:225 +msgid "Settings" +msgstr "Configuratie" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:198 +msgid "Account" +msgstr "Account" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:199 +msgid "Message" +msgstr "Bericht" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:200 +msgid "Logging" +msgstr "Statistieken" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:201 +msgid "Advanced" +msgstr "Verbetering" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:263 +msgid "Setup Wizard" +msgstr "Instellingen wizard" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:296 +msgctxt "Wizard Step Title" +msgid "Import Configuration" +msgstr "Configuratie importeren" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:298 +msgctxt "Wizard Step Title" +msgid "Import configuration from another plugin?" +msgstr "Configuratie van een ander plugin importeren?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:299 +msgid "If you had a working configuration with another Plugin, the Setup Wizard can begin with those settings." +msgstr "Indien je een werkende configuratie had met een andere plugin, kun je de instellingen wizard gebruiken om die instellingen over te nemen." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:301 +#: Postman/Postman-Mail/PostmanModuleTransport.php:720 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:425 +msgid "None" +msgstr "Geen" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:312 +msgctxt "Wizard Step Title" +msgid "Sender Details" +msgstr "Afzender details" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:314 +msgctxt "Wizard Step Title" +msgid "Who is the mail coming from?" +msgstr "Van wie komt de mail ?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:315 +msgid "Enter the email address and name you'd like to send mail as." +msgstr "Vul het emailadres en naam in die je als verzending wenst" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:316 +msgid "Please note that to prevent abuse, many email services will not let you send from an email address other than the one you authenticate with." +msgstr "Houdt er rekening mee dat vanwege de spam bestrijding diverse e-mailservices het niet toestaan om vanaf een andere 'from' e-mailberichten te versturen dan diegene waarmee deze geautoriseerd is." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:317 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:49 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:112 +msgid "Email Address" +msgstr "E-mailadres" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:320 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:59 +msgid "Name" +msgstr "Naam" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:325 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:143 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:331 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:542 +msgid "Outgoing Mail Server Hostname" +msgstr "Uitgaande Mail Server Hostname" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:333 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:138 +#: Postman/PostmanViewController.php:294 +msgid "Connectivity Test" +msgstr "Verbinding testen" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:335 +msgid "How will the connection to the mail server be established?" +msgstr "Hoe zal de verbining met MSA wordene vastgesteld?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:336 +msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows." +msgstr "Je verbindingsinstellingen zijn afhankelijk van wat je e-mail service provider biedt, en wat de WordPress hosting provider toestaat." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +msgctxt "TCP Port Test Status" +msgid "Ready" +msgstr "Gereed" + +#. Translators: Where %1$s is the socket identifier and %2$s is the +#. authentication type +#: Postman/Postman-Configuration/PostmanConfigurationController.php:345 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgctxt "A socket is the network term for host and port together" +msgid "Socket" +msgstr "Socket" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:346 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:354 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:223 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:177 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:351 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:356 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:372 +msgid "Authentication" +msgstr "Authenticatie" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:349 +msgid "This configuration option will send your authorization credentials in the clear." +msgstr "Deze configuratie instelling zal je authenticatie gegevens onveilig versturen." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:356 +msgid "How will you prove your identity to the mail server?" +msgstr "Hoe ga je je indentiteit aan de de MSA bewijzen?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:363 +msgctxt "The final step of the Wizard" +msgid "Finish" +msgstr "Gereed" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:365 +msgctxt "Wizard Step Title" +msgid "You're Done!" +msgstr "Je bent klaar !" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:367 +msgid "Click Finish to save these settings, then:" +msgstr "Druk op Finish om de instellingen op te slaan, dan:" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:369 +msgid "Grant permission with the Email Provider for Postman to send email and" +msgstr "De permissie voor met je email provider zijn toegekend voor Postman om mail te verzenden en " + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:370 +msgid "Send yourself a Test Email to make sure everything is working!" +msgstr "Jezelf een testbericht versturen om te zien of alles werkt!" + +#. translators: where %s is the URL to the Connectivity Test page +#: Postman/Postman-Configuration/PostmanConfigurationController.php:514 +msgid "Postman can't find any way to send mail on your system. Run a connectivity test." +msgstr "Postman kan met geen mogelijkheid een mail verzenden via jouw systeem. Voer een verbindings test." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:33 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Transport" +msgstr "Transport" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:38 +msgctxt "(i.e.) What kind is it?" +msgid "Type" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:44 +msgctxt "The Message Sender Email Address" +msgid "From Address" +msgstr "Bericht Zender Adres" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:70 +msgid "Additional Email Addresses" +msgstr "Annvullende adressen" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:75 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:220 +msgid "Reply-To" +msgstr "Antwoord-Aan" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:80 +msgid "To Recipient(s)" +msgstr "Aan ontvanger(s)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:85 +msgid "Carbon Copy Recipient(s)" +msgstr "Carbon Copy Ontvangers" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:90 +msgid "Blind Carbon Copy Recipient(s)" +msgstr "Blind Carbon Copy Ontvanger (s)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:96 +msgid "Additional Headers" +msgstr "Aanvullende Headers" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:101 +msgid "Custom Headers" +msgstr "Aangepaste Headers" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:107 +msgid "Validation" +msgstr "Validatie" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:118 +msgid "Email Log Settings" +msgstr "Email Log instellingen" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:123 +msgid "Enable Logging" +msgstr "Toegestane Logging" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:128 +#: Postman/PostmanInputSanitizer.php:137 +msgid "Maximum Log Entries" +msgstr "Limiet Log toegang" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:133 +msgid "Maximum Transcript Size" +msgstr "Transcript grootte" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:139 +msgid "Network Settings" +msgstr "Netwerk Instellingen" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:144 +msgctxt "Configuration Input Field" +msgid "TCP Connection Timeout (sec)" +msgstr "TCP connectie Timeout (sec)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:149 +msgctxt "Configuration Input Field" +msgid "TCP Read Timeout (sec)" +msgstr "TCP uitlees Timeout (sec)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:155 +msgctxt "Configuration Section Title" +msgid "Miscellaneous Settings" +msgstr "Overige Instellingen" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:160 +msgctxt "Configuration Input Field" +msgid "PHP Log Level" +msgstr "PHP Log niveau" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:165 +msgctxt "Configuration Input Field" +msgid "Delivery Mode" +msgstr "Overdrachts modus" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:170 +msgctxt "This mode removes the Postman X-Mailer signature from emails" +msgid "Stealth Mode" +msgstr "Stealth Modus" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:175 +msgid "Temporary Directory" +msgstr "Tijdelijke gegevensmap" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:186 +msgid "Choose SMTP or a vendor-specific API:" +msgstr "Kies SMTP of een vendor-specifieke API" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:189 +msgid "Configure the delivery audit log:" +msgstr "De delivery audit log configureren:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:196 +msgid "This address, like the letterhead printed on a letter, identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Other plugins, especially Contact Forms, may override this field to be your visitor's address." +msgstr "Dit adres, net als de briefhoofd gedrukt op een brief, identificeert de zender naar de ontvanger. Verander dit wanneer u verzendt namens iemand anders, bijvoorbeeld om Google's Send Mail As functie. Andere plugins, vooral contact formulieren, kan dit gebied voorrang aan het adres van uw bezoeker." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:203 +msgid "Separate multiple to/cc/bcc recipients with commas." +msgstr "Scheidt de meerdere ontvangers naar/cc/bcc met een komma" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:210 +msgid "Increase the timeouts if your host is intermittenly failing to send mail. Be careful, this also correlates to how long your user must wait if the mail server is unreachable." +msgstr "Vergroot de Timeouts als je Host email onderbrekend verzend. Wees voorzichtig, dit houd ook verband met de tijd dat je gebruikers moeten wachten als de mail server onbereikbaar is." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:221 +msgid "Specify custom headers (e.g. X-MC-Tags: wordpress-site-A), one per line. Use custom headers with caution as they can negatively affect your Spam score." +msgstr "Geef de standaard Headers (e.g. X-MC-Tags: wordpress-site-A, een per regel, Gebruik standaard Headers met behoedzaamheid omdat ze een negatief effect op je Spam scoren." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:228 +msgid "E-mail addresses can be validated before sending e-mail, however this may fail with some newer domains." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:254 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:276 +msgid "Prevent plugins and themes from changing this" +msgstr "Plugins en thema's te verhinderen dit wijzigen" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:261 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:405 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:244 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:195 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:409 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:416 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:459 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:467 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:475 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:482 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:530 +msgid "Required" +msgstr "Benodigd" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:268 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:531 +msgid "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +msgstr "Dit adres, net als de retouradres afgedrukt op een envelop, identificeert de eigenaar van de account op de SMTP-server." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:289 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:108 +msgid "Yes" +msgstr "Ja" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:290 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:109 +msgid "No" +msgstr "Nee" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:300 +msgid "Change this value if you can't see the beginning of the transcript because your messages are too big." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:343 +msgid "Disable e-mail validation" +msgstr "E-mail bevestiging uitschakelen" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:350 +msgid "Log Level specifies the level of detail written to the WordPress Debug log - view the log with Debug." +msgstr "Livello di registro specifica il livello di dettaglio, scritto per i file di registro di WordPress e PHP. Modalità di consegna offre opzioni utili in un ambiente di sviluppo." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:353 +msgid "Off" +msgstr "Uit" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:354 +msgid "Trace" +msgstr "Trace" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:355 +msgid "Debug" +msgstr "Verhelpen" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:356 +msgid "Info" +msgstr "Informatie" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:358 +msgid "Error" +msgstr "Error" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:366 +msgid "Delivery mode offers options useful for developing or testing." +msgstr "Delivery-modus biedt opties nuttig zijn voor de ontwikkeling of het testen." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:369 +msgctxt "When the server is online to the public, this is \"Production\" mode" +msgid "Log Email and Send" +msgstr "Log email en verzend" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:370 +msgid "Log Email and Delete" +msgstr "Log email en verwijder" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:371 +msgid "Delete All Emails" +msgstr "Alle e-mailberichten verwijderen" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:375 +msgid "Remove the Postman X-Header signature from messages" +msgstr "De Postman X-Header ondertekening verwijderen uit de berichten" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:378 +msgid "Lockfiles are written here to prevent users from triggering an OAuth 2.0 token refresh at the same time." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:381 +msgid "Valid" +msgstr "Geldig" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:383 +msgid "Invalid" +msgstr "Onjuist" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:105 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:109 +msgctxt "The \"please wait\" message" +msgid "Checking.." +msgstr "Checking.." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:106 +msgctxt "The port is open" +msgid "Open" +msgstr "Open" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:107 +msgctxt "The port is closed" +msgid "Closed" +msgstr "Gesloten" + +#. translators: where %d is a port number +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:111 +msgid "No outbound route between this site and the Internet on Port %d." +msgstr "De uitgaande route tussen deze site en internet op port %d." + +#. translators: where %d is a port number and %s is a hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:113 +msgid "Port %d is open, but not to %s." +msgstr "Poort %d is open, maar niet voor %s." + +#. translators: where %d is the port number and %s is the hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:115 +msgid "Port %d can be used for SMTP to %s." +msgstr "Poort %d kan gebruikt worden voor SMTP naar %s." + +#. translators: where %d is a port number and %s is the URL for the Postman +#. Gmail Extension +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:118 +msgid "Port %d can be used with the %s." +msgstr "Poort %d kan voor verzenden gebruikt worden met email met de %s." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:141 +msgid "This test determines which well-known ports are available for Postman to use." +msgstr "Deze test bepaald welke bekende porrten beschikbaar zijn om Postman te gebruiken." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:145 +msgctxt "Button Label" +msgid "Begin Test" +msgstr "Test starten" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:162 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:152 +msgid "Status" +msgstr "Toestand" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Service Available" +msgstr "Dienst beschikbaar" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Server ID" +msgstr "" + +#. Translators: Meaning "Not Applicable" +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:155 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:260 +msgid "n/a" +msgstr "n/a" + +#. Translators: Where %s is the name of the service providing Internet +#. connectivity test +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:160 +msgid "According to %s" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:163 +msgid "Summary" +msgstr "Samenvatting" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:168 +msgid "A test with \"No\" Service Available indicates one or more of these issues:" +msgstr "Een met service beschikbare poort \"Nee\"geeft een of meer problemen aan:" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:170 +msgid "Your web host has placed a firewall between this site and the Internet" +msgstr "Je webhost heeft een firewaqll geplaats tussen deze site en internet" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:171 +msgid "The SMTP hostname is wrong or the mail server does not provide service on this port" +msgstr "De SMTP hostnaam is verkeerd of de email server biedt geen service aan op deze poort" + +#. translators: where (1) is the URL and (2) is the system +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:173 +msgid "Your %2$s configuration is preventing outbound connections" +msgstr "Je %2$s configuratie voorkomt uitgaande verbindingen" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:177 +msgid "If the issues above can not be resolved, your last option is to configure Postman to use an email account managed by your web host with an SMTP server managed by your web host." +msgstr "Als de bovenstaande problemen niet kunnen worden opgelost, is je laatste optie om Postman te configureren met een e-mailaccount die wordt beheerd door je hosting provider met een SMTP die ook wordt beheerd door je hosting provider." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:82 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman.php:317 +msgctxt "The log of Emails that have been delivered" +msgid "Email Log" +msgstr "E-mail Log" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:95 +msgid "Error: Postman is missing a required PHP library." +msgstr "Fout: Postman mist een vereist PHP bibliotheek." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:97 +#: Postman/Postman.php:257 +msgid "Postman: wp_mail has been declared by another plugin or theme, so you won't be able to use Postman until the conflict is resolved." +msgstr "Postman: wp_mail is in gebruik door een andere plugin of thema, hierdoor kunt u Postman niet gebruiken totdat het conflict is opgelost." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:100 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:229 +msgid "Postman is in non-Production mode and is dumping all emails." +msgstr "Postman is in Niet-productieve modus en verwijders alle e-mails." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:102 +msgid "Postman is configured and has delivered %d email." +msgid_plural "Postman is configured and has delivered %d emails." +msgstr[0] "Postman is geconfigureerd en %d heeft een bericht verzonden." +msgstr[1] "Postman is geconfigureerd en %d berichten zijn verzonden." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:104 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:234 +msgid "Postman is not configured and is mimicking out-of-the-box WordPress email delivery." +msgstr "Postman is niet geconfigureerd en de bootst de out-of-the-box WordPress afhandeling na." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:116 +msgid "Postman is operating in per-site mode." +msgstr "Postman is in bedrijfs per-site modus" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:102 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:107 +#: Postman/PostmanViewController.php:295 +msgid "Diagnostic Test" +msgstr "Diagnostic Test" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:104 +msgid "Are you having issues with Postman?" +msgstr "Heb je problemen met Postman?" + +#. translators: where %1$s and %2$s are the URLs to the Troubleshooting and +#. Support Forums on WordPress.org +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:106 +msgid "Please check the troubleshooting and error messages page and the support forum." +msgstr "Controleer de probleem oplossingen en foutmeldingen pagina en de support forum." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:108 +msgid "If you write for help, please include the following:" +msgstr "Als je om hulp vraagt, voeg dan aub het volgende toe:" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:90 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:242 +msgid "Your message was delivered (%d ms) to the SMTP server! Congratulations :)" +msgstr "Je bericht is verzonden (%d ms) naar de SMTP server! Gefeliciteerd :)" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:156 +msgid "Mail Log Entries were deleted." +msgstr "'Mail Log'-gegevens zijn verwijderd." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:179 +msgid "Mail Log Entry was deleted." +msgstr "'Mail Log'-gegevens zijn verwijderd." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:204 +msgctxt "Who is this message From?" +msgid "From" +msgstr "Afzender" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:208 +msgctxt "Who is this message To?" +msgid "To" +msgstr "Ontvanger" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:212 +msgctxt "Who is this message Cc'd to?" +msgid "Cc" +msgstr "Cc" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:216 +msgctxt "Who is this message Bcc'd to?" +msgid "Bcc" +msgstr "Bcc" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:222 +msgctxt "What is the date today?" +msgid "Date" +msgstr "Datum" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:223 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:161 +msgctxt "What is the subject of this message?" +msgid "Subject" +msgstr "Onderwerp" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:226 +msgctxt "What is the unique URI of the configuration?" +msgid "Delivery-URI" +msgstr "Leverings -URI" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:253 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:161 +msgid "This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +msgstr "Dit is een onderhoud tussen Postman en je SMTP server. Dit kan nuttig zijn voor diagnostische problemen. Post het NIETonline, het kan je geheime password in encoded form bevatten." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +msgid "%s Email Log" +msgstr "%s E-mail Log" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:301 +msgid "Email was successfully resent (but without attachments)" +msgstr "" + +#. Translators: Where %s is an error message +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:303 +msgid "Email could not be resent. Error: %s" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:304 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:110 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:112 +msgid "Resend" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:339 +msgid "This is a record of deliveries made to the mail server. It does not neccessarily indicate sucessful delivery to the recipient." +msgstr "Dit is een rapportage van ontvangstbevestiging die gemeld is bij Mail Submission Agent (MSA). Het geeft niet noodzakelijk aan of een bericht succesvol afgeleverd is bij de ontvanger." + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:37 +msgctxt "The group of Emails that have been delivered" +msgid "Sent Emails" +msgstr "Verzonden berichten" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:38 +msgctxt "An Email that has been delivered" +msgid "Sent Email" +msgstr "Verzonden bericht" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +msgid "An empty subject line can result in delivery failure." +msgstr "Een lege onderwerpregel kan resulteren in de levering mislukking." + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:196 +msgid ".. +%d more" +msgstr "..+%d meer" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:99 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:223 +msgctxt "Delete an item from the email log" +msgid "Delete" +msgstr "Verwijderen" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:100 +msgctxt "View an item from the email log" +msgid "View" +msgstr "Bekijken" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:104 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:106 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:158 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:163 +msgid "Session Transcript" +msgstr "Transcript session" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:163 +msgctxt "When was this email sent?" +msgid "Delivery Time" +msgstr "Overdrachts tijd" + +#. Translators: where %s indicates the relative time from now +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:332 +msgctxt "A relative time as in \"five days ago\"" +msgid "%s ago" +msgstr "%s geleden" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:338 +msgid "Sent" +msgstr "Verzenden" + +#: Postman/Postman-Mail/PostmanDefaultModuleTransport.php:107 +msgid "Default" +msgstr "Standaardwaarde" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:102 +msgid "Gmail API" +msgstr "Gmail API" + +#. translators: where (1) is the secure icon and (2) is the transport name +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:152 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:135 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:79 +msgid "Postman will send mail via the %1$s %2$s." +msgstr "Postman invierà mail tramite il %1$s %2$s." + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:166 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:117 +msgid "You have configured OAuth 2.0 authentication, but have not received permission to use it." +msgstr "Je hebt de authenticatie OAuth 2.0 geconfigureerd , maar je hebt erg een toestemming voor gekregen om het te gebruiken." + +#. translators: where variables are (1) transport name (2) host and (3) port +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:206 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:181 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:125 +msgid "Postman recommends the %1$s to host %2$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:221 +#: Postman/Postman-Mail/PostmanModuleTransport.php:713 +msgid "OAuth 2.0 (requires Client ID and Client Secret)" +msgstr "OAuth 2.0 (vereist Client ID en Client Secret)" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:44 +msgid "Mandrill API" +msgstr "Mandrill API" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:147 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:101 +msgid "API Key can not be empty" +msgstr "API-sleutel mag niet leeg zijn." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:151 +#: Postman/Postman-Mail/PostmanModuleTransport.php:578 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:105 +msgid "Message From Address can not be empty" +msgstr "Bericht Zender Adres mag niet leeg zijn." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:194 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:228 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:271 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:148 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:182 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:222 +msgid "API Key" +msgstr "API-sleutel" + +#. Translators: Where (1) is the service URL and (2) is the service name and +#. (3) is a api key URL +#: Postman/Postman-Mail/PostmanMandrillTransport.php:238 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:189 +msgid "Create an account at %2$s and enter an API key below." +msgstr "Een acccount aanmaken bij %2$s en de API-sleutel hieronder invoegen." + +#. translators: where (1) is the transport type, (2) is the host, and (3) is +#. the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 +#. using OAuth 2.0 authentication.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:506 +msgid "Postman will send mail via %1$s to %2$s using %3$s authentication." +msgstr "Postman zal mail verzenden via %1$s naar %2$s met %3$s gebruikmakende van authenticatie" + +#. translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s +#. is the encryption type (e.g. SSL or TLS) +#: Postman/Postman-Mail/PostmanModuleTransport.php:534 +msgctxt "as in \"There is no Spoon\"" +msgid "no" +msgstr "Nee" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:553 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:366 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:584 +msgid "Password" +msgstr "Password" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:584 +msgid "OAuth 2.0 authentication requires a %1$s and %2$s." +msgstr "OAuth 2.0 authenticatie vereist %1$s en %2$s." + +#: Postman/Postman-Mail/PostmanModuleTransport.php:706 +msgid "Password (requires username and password)" +msgstr "Pasword (vereist een gebruikersnaam en password)" + +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 +msgid "MyMail: Change the delivery method in the %s!" +msgstr "" + +#: Postman/Postman-Mail/PostmanSendGridTransport.php:39 +msgid "SendGrid API" +msgstr "SendGrid API" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:95 +msgid "Outgoing Mail Server Hostname and Port can not be empty." +msgstr "Uitgaande Mail Server Hostname/Port kan niet leeg blijven." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:99 +msgid "Envelope-From Email Address can not be empty" +msgstr "Envelop Zender Adres mag niet leeg zijn." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:103 +msgid "Username and password can not be empty." +msgstr "Een gebruikersnaam en password is vereist voor Password authenticatie" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:109 +msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server." +msgstr "OAuth 2.0 authenticatie vereist een ondersteunend OAuth 2.0-capable Uitgaande mail server." + +#. translators: where %1$s is a description of the transport (eg. SMTPS-SSL), +#. %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is +#. the TCP port (eg. 465), %4$d is the hostname +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:269 +msgid "Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:326 +msgid "Transport Settings" +msgstr "Transport Settings" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:336 +msgid "Outgoing Mail Server Port" +msgstr "Uitgaande Mail Server Port" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:341 +msgid "Envelope-From Email Address" +msgstr "Envelop Zender Adres" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:346 +msgctxt "Configuration Input Field" +msgid "Security" +msgstr "Beveiliging" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:361 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:580 +msgid "Username" +msgstr "Gebruikersnaam" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:402 +msgid "Configure the communication with the mail server." +msgstr "Configureer de communicatie met de mail Submission Agent (MSA)" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:449 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:579 +msgid "Enter the account credentials." +msgstr "Voer je referenties in." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:457 +msgid "The Username is usually the same as the Envelope-From Email Address." +msgstr "Meestal is je email adres je gebruikersnaam." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:511 +msgid "Error computing your domain root - please enter it manually" +msgstr "Fout met het berekenen van je domein root. Vul dit handmatig in." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:532 +msgid "For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:539 +msgctxt "Wizard Step Title" +msgid "Which host will relay the mail?" +msgstr "Welke host zal de email doorgeven?" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:540 +msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. This server is specific to your email account, and if you don't know what to use, ask your email service provider." +msgstr "Dit is de uitgaande (SMTP) mail server, of Mail Submissie Agent (MSA), waarnaar Postman e-mailafhandeling zal delegeren. Deze server is specifiek voor jouw e-mailaccount, als je niet weet welke te kiezen, vraag dit dan na bij je e-mail serviceprovider." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:541 +msgid "Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, require that you use their mail accounts with their mail servers, and prevent you from using others." +msgstr "Houdt er rekening mee dat veel Wordpress hosts, zoals GoDaddy, Bluehost en Dream host, eisen dat je hun mail account met hun mail server gebruikt, en willen voorkomen dat je een andere gebruikt" + +#. Translators: Where (%s) is the name of the web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:547 +msgid "Your email address requires access to a remote SMTP server blocked by %s." +msgstr "je emailadres vereist toegang tot de SMTP server geblokkeerd door %s." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:548 +msgid "If you have access to cPanel, enable the Remote Mail Exchanger." +msgstr "" + +#. Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the +#. web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:551 +msgid "If you own this domain, make sure it has an SPF record authorizing %2$s as a relay, or you will have delivery problems." +msgstr "Als je eigenaar bent van dit domein, zorg er dan voor dat je SPF record authorisatie %2$s hebt als een relay, anders zul je mail bezorging problemen ondervinden." + +#: Postman/Postman-Mail/PostmanTransportRegistry.php:231 +msgid "Postman is configured." +msgstr "Postman is geconfigureerd" + +#: Postman/Postman-Mail/PostmanZendMailEngine.php:209 +msgid "Communication Error [334] - make sure the Envelope From email is the same account used to create the Client ID." +msgstr "Communicatie Fout [334] - Wees er zeker van dat de email zender toestemming heeft bij het betreffende account OAuth 2.0." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:115 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:149 +msgctxt "Email Test Status" +msgid "In Outbox" +msgstr "Uitgaande mailbox" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:116 +msgctxt "Email Test Status" +msgid "Sending..." +msgstr "Verzenden" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:117 +msgctxt "Email Test Status" +msgid "Success" +msgstr "Succes" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:118 +msgctxt "Email Test Status" +msgid "Failed" +msgstr "Mislukt" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:119 +msgid "Ajax Error" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:128 +#: Postman/PostmanViewController.php:273 Postman/PostmanViewController.php:275 +msgid "Send a Test Email" +msgstr "Een testbericht versturen" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:133 +msgid "Specify the Recipient" +msgstr "Kies de ontvanger" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:135 +msgid "Who is this message going to?" +msgstr "Naar wie gaat dit bericht?" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:136 +msgid "This utility allows you to send an email message for testing." +msgstr "Deze functionaliteit staat je toe om een testbericht te versturen." + +#. translators: where %d is an amount of time, in seconds +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:139 +msgid "If there is a problem, Postman will give up after %d second." +msgid_plural "If there is a problem, Postman will give up after %d seconds." +msgstr[0] "Als er een probleem is Postman geeft het dan na %d seconden op" +msgstr[1] "Als er problemen zijn, zal Postman het na %d seconden opgeven" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:140 +msgctxt "Configuration Input Field" +msgid "Recipient Email Address" +msgstr "Ontvanger E-mailadres" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:145 +msgid "Send The Message" +msgstr "Het bericht versturen" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:148 +msgid "Sending the message:" +msgstr "Het bericht wordt verzonden" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:160 +msgid "Examine the Session Transcript if you need to." +msgstr "Beoordeel de sessie-transcriptie als gewenst." + +#. translators: where %s is the domain name of the site +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:212 +msgctxt "Test Email Subject" +msgid "Postman SMTP Test (%s)" +msgstr "Postman SMTP Test (%s)" + +#. translators: where %s is the Postman plugin version number (e.g. 1.4) +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:299 +msgctxt "Test Email Tagline" +msgid "Sent by Postman %s" +msgstr "Verzonden door Postman %s" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:300 +msgid "Image source" +msgstr "Afbeeldings bron" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:301 +msgid "Used with permission" +msgstr "Gebruikt met toestemming" + +#: Postman/PostmanAdminController.php:111 +msgctxt "The plugin successfully saved new settings." +msgid "Settings saved." +msgstr "Instellingen opgeslagen" + +#. Translators: where %1$s is the name of the library +#: Postman/PostmanAdminController.php:178 +msgid "This PHP installation requires the %1$s library." +msgstr "Deze PHP installatie vereist de %1$s libary" + +#: Postman/PostmanAdminController.php:253 +msgid "There was an error importing the data." +msgstr "" + +#: Postman/PostmanAdminController.php:270 +msgid "Plugin data was removed." +msgstr "Data van de plugin is verwijderd" + +#: Postman/PostmanAdminController.php:294 +msgid "The OAuth 2.0 authorization was successful. Ready to send e-mail." +msgstr "De Oauthen 2.0 autorisatie was succesvol. Gereed om email te verzenden" + +#: Postman/PostmanAdminController.php:296 +msgid "Your email provider did not grant Postman permission. Try again." +msgstr "Je email provider staat geen Postman permissies toe. Probeer nogmaals." + +#: Postman/PostmanAdminController.php:299 +msgid "The grant code from Google had no accompanying state and may be a forgery" +msgstr "De permissie Code van Google heeft geen bijbehorende state en zou een vervalsing kunnen zijn." + +#. translators: %s is the error message +#: Postman/PostmanAdminController.php:303 +msgid "Error authenticating with this Client ID. [%s]" +msgstr "Fout authencitatie met de Client ID " + +#: Postman/PostmanConfigTextHelper.php:31 +msgid "Attention" +msgstr "Attentie" + +#. translators: parameters available are 1=portal-url, 2=portal-name, +#. 3=clientId-name, 4=clientSecret-name, 5=callbackUrl, 6=service-name, +#. 7=portal-application (e.g. Open the Google Developer Console, create a +#. Client ID for web application using the URL's displayed below, and copy the +#. Client ID and Client Secret here.) +#: Postman/PostmanConfigTextHelper.php:33 +msgid "Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +msgstr "Open de %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." + +#. translators: parameters available are 1=clientId-name, 2=service-name, +#. 3=FAQ-URL, 4=Video-URL (e.g. See How do I get a Google Client ID? in the +#. F.A.Q.) +#: Postman/PostmanConfigTextHelper.php:36 +msgid "See How do I get a %1$s %2$s? in the F.A.Q. or watch our How-To video 📺." +msgstr "ZieHoe krijg ik een %1$s %2$s? in de F.A.Q. of of zie onze How-To video 📺." + +#. translators: where %s is the Email Service Owner (e.g. Google, Microsoft or +#. Yahoo) +#: Postman/PostmanConfigTextHelper.php:54 +msgctxt "Command to initiate OAuth authentication" +msgid "Grant permission with %s" +msgstr "Permissie toestaan met %s" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:80 +#: Postman/PostmanConfigTextHelper.php:142 +#: Postman/PostmanConfigTextHelper.php:204 +#: Postman/PostmanConfigTextHelper.php:271 +msgctxt "Name of the OAuth 2.0 Client ID" +msgid "Client ID" +msgstr "Klant iD" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:84 +#: Postman/PostmanConfigTextHelper.php:146 +#: Postman/PostmanConfigTextHelper.php:208 +#: Postman/PostmanConfigTextHelper.php:274 +msgctxt "Name of the OAuth 2.0 Client Secret" +msgid "Client Secret" +msgstr "Klant secret" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:88 +msgctxt "Name of the Application Callback URI" +msgid "Authorized redirect URI" +msgstr "Geautorizeerde redirect URI" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:92 +msgctxt "Name of the Application Callback Domain" +msgid "Authorized JavaScript origins" +msgstr "Authorized JavaScript origins" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:96 +msgctxt "Name of the email service owner" +msgid "Google" +msgstr "Google" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:100 +msgctxt "Name of the email service" +msgid "Gmail" +msgstr "Gmail" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:104 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "a Client ID for web application" +msgstr "Een klant ID voor webapplicatie" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:108 +msgctxt "Name of the email service portal" +msgid "Google Developers Console Gmail Wizard" +msgstr "Google ontwikkelaar console" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:150 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URL" +msgstr "Redirect URL" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:154 +msgctxt "Name of the Application Callback Domain" +msgid "Root Domain" +msgstr "Root Domein" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:158 +msgctxt "Name of the email service owner" +msgid "Microsoft" +msgstr "Microsoft" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:162 +msgctxt "Name of the email service" +msgid "Outlook.com" +msgstr "Outlook.com" + +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:166 +#: Postman/PostmanConfigTextHelper.php:228 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "an Application" +msgstr "Een aplicatie" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:170 +msgctxt "Name of the email service portal" +msgid "Microsoft Developer Center" +msgstr "Microsoft ontwikkel centrum" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:212 +msgctxt "Name of the Application Callback URI" +msgid "Home Page URL" +msgstr "Start pagina URL" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:216 +msgctxt "Name of the Application Callback Domain" +msgid "Callback Domain" +msgstr "Callback domein" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:220 +msgctxt "Name of the email service owner" +msgid "Yahoo" +msgstr "Yahoo" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:224 +msgctxt "Name of the email service" +msgid "Yahoo Mail" +msgstr "Yahoo email" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:232 +msgctxt "Name of the email service portal" +msgid "Yahoo Developer Network" +msgstr "Yahoo ontwikkelaar Netwerk" + +#: Postman/PostmanConfigTextHelper.php:261 +msgid "Enter an Outgoing Mail Server with OAuth2 capabilities." +msgstr "Enter een uitgaande Mail Server met OAuth2 geschiktheid" + +#: Postman/PostmanConfigTextHelper.php:277 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URI" +msgstr "Redirect URI" + +#: Postman/PostmanConfigTextHelper.php:280 +msgctxt "Name of the Application Callback Domain" +msgid "Website Domain" +msgstr "Website domein" + +#: Postman/PostmanConfigTextHelper.php:304 +msgid "Grant OAuth 2.0 Permission" +msgstr "Oauth 2.0 toestemming geven" + +#: Postman/PostmanInputSanitizer.php:137 +msgid "must be greater than 0" +msgstr "Moet groter zijn als 0" + +#: Postman/PostmanViewController.php:112 +msgid "An unexpected error occurred" +msgstr "" + +#: Postman/PostmanViewController.php:113 +msgid "Unexpected PHP messages corrupted the Ajax response" +msgstr "Onverwachte PHP Ajax reactie beschadigde berichten:" + +#: Postman/PostmanViewController.php:118 +msgctxt "Press this button to Finish this task" +msgid "Finish" +msgstr "Gereed" + +#: Postman/PostmanViewController.php:119 +msgctxt "Press this button to go to the next step" +msgid "Next" +msgstr "Volgende" + +#: Postman/PostmanViewController.php:120 +msgctxt "Press this button to go to the previous step" +msgid "Previous" +msgstr "Vorige" + +#: Postman/PostmanViewController.php:132 +msgid "Postman is unable to run. Email delivery is being handled by WordPress (or another plugin)." +msgstr "Postman kan niet draaien. E-mailverwerking wordt gedaan door WordPress (of een andere plugin)." + +#. translators: where %d is the number of emails delivered +#: Postman/PostmanViewController.php:147 +msgid "Postman has delivered %d email." +msgid_plural "Postman has delivered %d emails." +msgstr[0] "Postman heeft %d bericht afgeleverd." +msgstr[1] "Postman heeft %d berichten afgeleverd." + +#: Postman/PostmanViewController.php:150 +msgid "The last %d email attempts are recorded in the log." +msgstr "De laatste %d verzendpogingen zijn opgenomen in het log." + +#: Postman/PostmanViewController.php:155 +msgid "Thank-you for choosing Postman!" +msgstr "Hartelijk dank voor het gebruik van Postman !" + +#. translators: where %s is the URL of the Setup Wizard +#: Postman/PostmanViewController.php:157 +msgid "Let's get started! All users are strongly encouraged to run the Setup Wizard." +msgstr "Laten we beginnen! Alle gerbuikers worden aangemoedigd om de installatie wizard uit te voeren" + +#: Postman/PostmanViewController.php:158 +msgid "Alternately, manually configure your own settings and/or modify advanced options." +msgstr "Anders, handmatig uw eigen instellingen configureren en/of wijzigen van geavanceerde opties." + +#. translators: where %s is the URL to the WordPress.org review and ratings +#. page +#: Postman/PostmanViewController.php:163 +msgid "Please consider leaving a review to help spread the word! :D" +msgstr "Kun je aub een beoordeling achterlaten Om zo het woord te verspreiden ! :D" + +#: Postman/PostmanViewController.php:165 +msgid "Postman needs translators! Please take a moment to translate a few sentences on-line" +msgstr "" + +#: Postman/PostmanViewController.php:167 +msgid "New for v1.7! Send mail with the Mandrill or SendGrid APIs." +msgstr "" + +#: Postman/PostmanViewController.php:191 +msgctxt "Return to main menu link" +msgid "Back To Main Menu" +msgstr "Terug naar Hoofdmenu" + +#: Postman/PostmanViewController.php:198 Postman/PostmanViewController.php:233 +#: Postman/PostmanViewController.php:284 +msgid "Import" +msgstr "Importeren" + +#: Postman/PostmanViewController.php:199 Postman/PostmanViewController.php:285 +msgid "Export" +msgstr "Exporteren" + +#: Postman/PostmanViewController.php:200 Postman/PostmanViewController.php:286 +msgid "Reset Plugin" +msgstr "Reset Plugin" + +#: Postman/PostmanViewController.php:206 +msgid "Copy this data into another instance of Postman to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:225 +msgid "Paste data from another instance of Postman here to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:228 +msgid "Using the same OAuth 2.0 Client ID and Client Secret from this site at the same time as another site will cause failures." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "This will purge all of Postman's settings, including account credentials and the email log." +msgstr "Dit zal alle instellingen van Postman opschonen, inclusief account referenties en de email log." + +#: Postman/PostmanViewController.php:241 +msgid "Are you sure?" +msgstr "Weet je het zeker?" + +#: Postman/PostmanViewController.php:261 +msgid "Configuration" +msgstr "Instellingen" + +#: Postman/PostmanViewController.php:262 +msgid "Start the Wizard" +msgstr "Start de assistent " + +#: Postman/PostmanViewController.php:263 +msgid "Show All Settings" +msgstr "" + +#: Postman/PostmanViewController.php:266 +msgctxt "Main Menu" +msgid "Actions" +msgstr "Acties" + +#: Postman/PostmanViewController.php:292 +msgctxt "Main Menu" +msgid "Troubleshooting" +msgstr "Probleem oplossing" + +#: Postman/PostmanViewController.php:296 +msgid "Online Support" +msgstr "Online hulp" + +#. Plugin URI of the plugin/theme +msgid "https://wordpress.org/plugins/postman-smtp/" +msgstr "https://nl.wordpress.org/plugins/postman-smtp/" + +#. Description of the plugin/theme +msgid "Email not reliable? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +msgstr "E-mail niet betrouwbaar? Postman is de eerste en enige WordPress SMTP plugin die OAuth 2.0 implementeert voor Gmail, Hotmail en Yahoo mail. Het configureren is eenvoudig met de geïntegreerde Configuratie Wizard en Poort Tester. Geniet van een zorgeloze levering, zelfs wanneer je je wachtwoord veranderd!" + +#. Author of the plugin/theme +msgid "Jason Hendriks" +msgstr "Jason Hendriks" + +#. Author URI of the plugin/theme +msgid "http://www.codingmonkey.ca" +msgstr "http://www.codingmonkey.ca" + +#~ msgid "Change the delivery method on the %s!" +#~ msgstr "Wijzig de levering methode op %s!" + +#~ msgid "Configure the plugin." +#~ msgstr "De plugin configureren." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Test Your Setup" +#~ msgstr "Je setup testen" + +#~ msgctxt "eg. TCP Port 25" +#~ msgid "Port" +#~ msgstr "Poort" + +#~ msgctxt "as in \"There is no Authentication\"" +#~ msgid "no" +#~ msgstr "Nee" + +#~ msgctxt "Log Level" +#~ msgid "Off" +#~ msgstr "Off" + +#~ msgctxt "Log Level" +#~ msgid "Trace" +#~ msgstr "Trace" + +#~ msgctxt "Log Level" +#~ msgid "Debug" +#~ msgstr "Debug" + +#~ msgctxt "Log Level" +#~ msgid "Info" +#~ msgstr "Info" + +#~ msgctxt "Log Level" +#~ msgid "Warning" +#~ msgstr "Waarschuwing" + +#~ msgctxt "Log Level" +#~ msgid "Error" +#~ msgstr "Error" + +#~ msgid "Port %d can be used to send email with the %s." +#~ msgstr "Poort %d kan voor verzenden gebruikt worden met email met de %s." + +#~ msgid "New for v1.6! Email Log" +#~ msgstr "Nieuw voor v1.6! Email Log" + +#~ msgid "Enable to save a copy of all your emails. Great for troubleshooting or as a backup for messages that get lost. Access the Email Log in the Tools menu." +#~ msgstr "Inschakelen om een kopie van al uw e-mails te op te slaan. Ideaal voor het oplossen van problemen of als een back-up voor berichten die verloren gaan. Toegang tot het logboek E-mail in het menu Extra." + +#~ msgctxt "The configuration page of the plugin" +#~ msgid "Settings" +#~ msgstr "Instellingen" + +#~ msgid "Postman is not handling email delivery." +#~ msgstr "Postman is behandelt geen e-mail levering." + +#~ msgctxt "As in type used: None" +#~ msgid "None" +#~ msgstr "Geen" + +#~ msgctxt "Who do we reply to?" +#~ msgid "Reply-To" +#~ msgstr "Antwoord -Aan" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +#~ msgstr "Dit is een onderhoud tussen Postman en je SMTP server. Dit kan nuttig zijn voor diagnostische problemen.Post het NIETonline, het kan je geheime password in encoded form bevatten" + +#~ msgid "Postman Email Log" +#~ msgstr "Postman Email Log" + +#~ msgid "This is a record of deliveries made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Dit is een Mail Submission Agent (MSA)verslag " + +#~ msgid "Warning: An empty subject line can result in delivery failure." +#~ msgstr "Waarschuwing: Een lege onderwerpregel kan resulteren in de levering mislukking." + +#~ msgctxt "View the transcript of an item from the email log" +#~ msgid "Transcript" +#~ msgstr "Transcriptie" + +#~ msgctxt "Attempt to resend this email" +#~ msgid "Resend" +#~ msgstr "Verstuur opnieuw" + +#~ msgctxt "Was sending this email successful or not?" +#~ msgid "Status" +#~ msgstr "Status" + +#~ msgctxt "Transport Name" +#~ msgid "Gmail API" +#~ msgstr "Gmail API" + +#~ msgctxt "Authentication Type is OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgid "Postman will send mail via the 🔐Gmail API using %s authentication." +#~ msgstr "Postman invierà mail tramite il 🔐 API Gmail utilizzando l'autenticazione %s." + +#~ msgid "OAuth 2.0 authentication requires a Client ID and Client Secret." +#~ msgstr "Authenticatie OAuth 2.0 vereist een Zender Email Adres, Klant ID en Klant secret." + +#~ msgid "Envelope From Address and Message From Address can not be empty." +#~ msgstr "Envelop Zender Adres en Bericht Zender Adres mag niet leeg zijn." + +#~ msgid "Postman recommends Gmail API configuration on port %d" +#~ msgstr "Postman raadt Gmail API configuratie op port %d aan" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP" +#~ msgstr "SMTP" + +#~ msgctxt "As in type used: CRAM-MD5" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "As in type used: Login" +#~ msgid "Login" +#~ msgstr "Login" + +#~ msgctxt "As in type used: Plain" +#~ msgid "Plain" +#~ msgstr "Vlak" + +#~ msgctxt "This authentication type is password-based" +#~ msgid "Password (%s)" +#~ msgstr "Password (%5)" + +#~ msgid "Password authentication (Plain/Login/CRAM-MD5) requires a username and password." +#~ msgstr "Een gebruikersnaam en password is vereist voor Password authenticatie" + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, %1$s, and %2$s." +#~ msgstr "OAuth 2.0 authenticatie vereist een ondersteunend OAuth 2.0-capable Uitgaande mail server %1$s, en %2$s" + +#~ msgid "Your recommended settings are %1$s with %2$s authentication to host %4$s on port %3$d." +#~ msgstr "Je aanbevolen instellingen zijn %1$s met %2$s authenticatie voor host %4$s van port %3$d" + +#~ msgid "The selected transport '%s' is unavailable. The external plugin was probably deactivated." +#~ msgstr "Het geselecteerde transport '%s' is niet beschikbaar. De externe plugin was waarschijnlijk gedeactiveerd" + +#~ msgid "WordPress is still handling email delivery, not Postman." +#~ msgstr "Postman is behandelt geen e-mail levering." + +#~ msgctxt "The Transport is the method for sending mail, SMTP or API" +#~ msgid "Transport" +#~ msgstr "Verzending/overbrenging" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport Settings" +#~ msgstr "Verzend settings" + +#~ msgctxt "Authentication proves the user's identity" +#~ msgid "Authentication" +#~ msgstr "Authencitatie" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Username" +#~ msgstr "Gebruikersnaam" + +#~ msgctxt "The Envelope Sender Email Address" +#~ msgid "Envelope From Address" +#~ msgstr "Envelop Zender Adres" + +#~ msgctxt "The Message Sender Email Address" +#~ msgid "Message From Address" +#~ msgstr "Bericht Zender Adres" + +#~ msgctxt "The email address to address replies to" +#~ msgid "Reply-To" +#~ msgstr "Antwoord -Aan" + +#~ msgid "Maximum Number of Log Entries" +#~ msgstr "Limiet Log toegang" + +#~ msgid "Maximum Number of Lines in a Transcript" +#~ msgstr "Transcript grootte" + +#~ msgid "Configure the communication with the Mail Submission Agent (MSA):" +#~ msgstr "Configureer de communicatie met de mail Submission Agent (MSA)" + +#~ msgid "Enter the account username (email address) and password:" +#~ msgstr "Vul de acount gebruikersnaam (email adres) en password in:" + +#~ msgid "This will purge all of Postman's settings, including SMTP server info, username/password and OAuth Credentials." +#~ msgstr "Dit zal alle Postman instelingen opschonen, inclusief SMTP info server, gebruikersnaam/paswoord en OAuth credentials" + +#~ msgid "Log Level specifies the level of detail written to the WordPress log - view the log with Debug. Delivery mode offers options useful for developing or testing." +#~ msgstr "Inloggen Level bepaalt de mate van detail geschreven naar de WordPress-logbestand - Het logboek met Debug. Delivery-modus biedt opties nuttig zijn voor de ontwikkeling of het testen." + +#~ msgid "Attention! Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +#~ msgstr "Attentie! Open de %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Grant OAuth Permission" +#~ msgstr "Oauth toestemming geven" + +#~ msgid " must be greater than 0" +#~ msgstr "moet groter dan 0 zijn" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup" +#~ msgstr "Postman Setup" + +#~ msgid "Welcome" +#~ msgstr "Welkom" + +#~ msgid "This is the Settings page for Postman, an SMTP mailer that delivers email from your WordPress site to the Internet. From here you can configure the plugin, and access testing and diagnostic tools." +#~ msgstr "Dit is de instellingen pagina van Postman, een SMTP mailer die emails van je WordPress site naar internet zend. Vanaf hier kun je de plugin configureren, met toegangs test en diagnostic tools." + +#~ msgid "Having trouble? You can ask for help on our Support Forum. To get the help you need quickly, please post the Diagnostic Data with your question. You can also check the FAQ and Error Messages pages for answers." +#~ msgstr "Zijn er problemen? Je kunt hulp vragen op onze Support Forum. Om sneñ geholpen te worden, post aub de Diagnostic Data met je vragen.Check ook de FAQ en Error Messages paginas voor antwoorden" + +#~ msgid "The Email Test will send an email to you. If the test fails, the full SMTP session transcript is available to you.

    Receiving a single test email does not indicate perfect configuration. Some services may dump your email into a black-hole or mark it as Spam if you:" +#~ msgstr "De email test zal je een email sturen. Als de test mislukt, de volledige SMTP sessie transcript is dan beschikbaar voor je." + +#~ msgid "Violate an SPF record" +#~ msgstr "Forceer een SPF record" + +#~ msgid "You must use the SMTP server (MSA) approved by your domain to deliver your mail. (eg.) a @gmail.com sender address requires that authentication and delivery always be through smtp.gmail.com." +#~ msgstr "Je moet de SMTP server (SMA) gebruiken die is toegekend om je mail te kunnen leveren. (eg) a @gmail.com het zend adres vereist dat de authorisatie en levering altijd via smtp.gmail.com gaat. " + +# Forge is namaak o vervalsing/vervals..as if you have to make a fake From address?. the= de From= Van and address =adres.. +#~ msgctxt "Forge as in a forgery (fake) is made" +#~ msgid "Forge the From Address" +#~ msgstr "Vervals het Van adres " + +#~ msgid "Spoofing, when it results in an SPF violation, will get your message binned. Use your own address as the sender (From:) in every email." +#~ msgstr "Spoofing, als het in een SPF aanval resulteert, will get your message binned.Gebruik je eigen adres als zender (Van:) in iedere email." + +#~ msgid "Consolidates details of your setup to aid the author in debugging problems, including: operating system details, WordPress configuration, Postman configuration, network connectivity and your domain's primary MX and SPF records. Your private authorization credentials are masked." +#~ msgstr "Geconsolideerde details van je installatie van de hulp aan de auteur voor de problemen bij de opsporingsfout, inclusief: details van het operatie systeem, Wordpress instelllingen, Configuarie POstman, Netwerk aansluiting en je primary MX en SPF domein records. Je prive authorisatie credentials zijn afgeschermd." + +#~ msgid "The Connectivity Test will report this site's ability to reach a mail server, and interrogate the mail server for it's capabilities." +#~ msgstr "De aansluitbaarheids Test zal een raport geven over de ability bereik van de mail server, en zal de mail server interrogeren voor z'n vermogen" + +#~ msgctxt "Is it possible to create network connections to the Internet?" +#~ msgid "Outbound to Internet" +#~ msgstr "Outbound naar Internet" + +#~ msgid "This tests the ability to make outbound connections from your site to the Internet in general. If the result is Closed, then there is a communication problem with the Internet, like a firewall." +#~ msgstr "Dit test de mogelijkheid om de uitgaande verbinding van je site naar internet in het algemeen. Als het resultaat gesloten is/word, dan is er een communicatie problemen met internet, dit kan een firewall zijn" + +#~ msgctxt "What service is available?" +#~ msgid "Service Available" +#~ msgstr "Dienst beschikbaar" + +#~ msgid "This shows the service found for a particular host/port. Possible successful results are SMTP, SMTPS (secure) and HTTPS (secure). If the result is No and the hostname you entered is correct, there was a communication problem with the mail server, like a firewall." +#~ msgstr "Dit showt de gevonden service van een bepaalde Host/Poort. Mogelijke succesvolle resultaten zijn SMTP, SMTPS (secure) en HTTPS (secure). Als het resultaat is NEE en de hostnaam die je hebt ingevuld is correct, dan is er een communicatie probleeem met de mailserver, zoals een firewall." + +#~ msgctxt "What is this server's ID?" +#~ msgid "ID" +#~ msgstr "ID" + +#~ msgid "Some hosts redirect mail traffic to their own mail server, breaking authentication and SPF verification. This is revealed by an incorrect server identity." +#~ msgstr "Sommige Hosts leiden het verkeer om naar hun eigen mailserver, door de authenticatie en SPF verificatie te breken. Dit blijkt bij een onjuiste server indentitiet." + +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgid "This indicates whether the server supports protocol-level security. Either STARTTLS, SMTPS or HTTPS is required for secure transmission of your credentials." +#~ msgstr "Dit geeft de server support protocol-level veiligheid aan. In beide gevallen STARTTLS, SMTP, of HTTPS is een beveiligde transmissie vereist van je referenties." + +#~ msgctxt "Short for Authentication" +#~ msgid "Auth" +#~ msgstr "Auth" + +#~ msgid "This indicates the authenication methods that the server supports. All are password-based, except for OAuth 2.0, which is token-based." +#~ msgstr "Dit geeft de authenticatie methodes aan van de server supports. Ze zijn op pasworden gebaseerd, behalve voor 0AYRH 2.0, , welke token-based is." + +#~ msgctxt "A testing tool which determines connectivity to the Internet" +#~ msgid "Connectivity Test" +#~ msgstr "Aansluitings test" + +#~ msgctxt "Email Test Status" +#~ msgid "Ajax Error" +#~ msgstr "Ajax fout" + +#~ msgid "Unexpected PHP messages corrupted the Ajax response:" +#~ msgstr "Onverwachte PHP berichten beschadigd de Ajax-reactie:" + +#~ msgid "Warning: connected to %1$s instead of %2$s." +#~ msgstr "Waarschuwing: connect naar %1$s in plaast van %2$s." + +#~ msgid "Port %d can be used to send Gmail with the Gmail API." +#~ msgstr "Poort %d kan voor verzenden gebruikt worden met Gmail met de Gmail API." + +#~ msgid "WordPress (or another plugin) is currently handling email delivery, not Postman." +#~ msgstr "WordPress (of een andere plugin) is momenteel in behandeling e-maillevering, niet Postman." + +#~ msgctxt "Page Title" +#~ msgid "Manual Configuration" +#~ msgstr "Handmatige configuratie" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Account" +#~ msgstr "Account" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Message" +#~ msgstr "Bericht" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Logging" +#~ msgstr "Inloggen" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Advanced" +#~ msgstr "Geavanceerd" + +#~ msgid "Delete plugin settings" +#~ msgstr "Verwijder plugin instellingen" + +#~ msgid "This will purge all of Postman's settings, including account credentials and the mail log." +#~ msgstr "Dit zal alle instellingen van Postman opschonen, inclusief account referenties en de email log." + +#~ msgctxt "Button Label" +#~ msgid "Delete All Data" +#~ msgstr "Alle gegevens verwijderen" + +#~ msgctxt "The port number" +#~ msgid "Port %s" +#~ msgstr "Poort %s" + +#~ msgctxt "Authentication Type" +#~ msgid "None" +#~ msgstr "Geen" + +#~ msgid "* Port 443 tests against googleapis.com, not the SMTP hostname you enter." +#~ msgstr "*Poort 443 test tegen googleapis.com, niet de SMTP naam die je hebt ingevoerd" + +#~ msgid "A port with Service Available \"No\" indicates one or more of these issues:" +#~ msgstr "Een met service beschikbare poort \"Nee\"geeft een of meer problemen aan " + +#~ msgid "Your PHP configuration is preventing outbound connections" +#~ msgstr "Je PHP configuratie voorkomt uitgaande verbindingen" + +#~ msgid "Your WordPress configuration is preventing outbound connections" +#~ msgstr "Je WordPress configuratie voorkomt uitgaande verbindingen" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "Show Advanced Configuration" +#~ msgstr "Geavanceerde instellingen" + +#~ msgid "Disable" +#~ msgstr "Uitschakelen" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup Wizard" +#~ msgstr "Postman instellingen wizard" + +#~ msgid "Error: Your email address requires access to a remote SMTP server blocked by GoDaddy. Use a different e-mail address." +#~ msgstr "Fout: je emailadres vereist toegang tot de SMTP server geblokkeerd door GoDaddy. Gebruik een ander e-mail adres." + +#~ msgid "Warning: If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems." +#~ msgstr "Waarschuwing: Als je eigenaar bent van dit domein, zorg er dan voor dat je SPF record authorisatie GoDaddy hebt als een relay, anders zul je mail bezorging problemen ondervinden." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will the connection to the MSA be established?" +#~ msgstr "Hoe zal de verbining met MSA wordene vastgesteld" + +#~ msgid "Warning: This configuration option will send your authorization credentials in the clear." +#~ msgstr "Waarschuwing: Deze configuratie optie zal je een referentie authorisatie zenden " + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will you prove your identity to the MSA?" +#~ msgstr "Hoe ga je je indentiteit aan de de MSA bewijzen?" + +#~ msgid "Enter your credentials. Your username is often your email address." +#~ msgstr "Voer je referenties in. Meestal is je email adres je gebruikersnaam." + +#~ msgid "Examine the SMTP Session Transcript if you need to." +#~ msgstr "Indien je wenst kun je de SMTP sessie examineren" + +#~ msgid "SMTP Session Transcript" +#~ msgstr "SMTP Transcript sessie" + +#~ msgid "The Envelope From address identifies the account owner to the SMTP server." +#~ msgstr "De Envelop Zender Adres identificeert de eigenaar van de account op de SMTP-server." + +#~ msgid "The Message From address identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Themes and other plugins, especially Contact Forms, are permitted to modify this field." +#~ msgstr "Het Bericht Zender Adres identificeert de afzender naar de ontvanger. Dit veranderen als u verzendt namens iemand anders, bijvoorbeeld om Google Mail verzenden als functie te gebruiken. Thema's en andere plugins, vooral Contact formulieren, zijn toegestaan om dit veld wijzigen." + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful for developing or testing." +#~ msgstr "Livello di registro specifica il livello di dettaglio, scritto per i file di registro di WordPress e PHP. Modalità di consegna offre opzioni utili in un ambiente di sviluppo." + +#~ msgid "The server returned an unexpected result:" +#~ msgstr "De server heeft een onverwachte en invalid resultaat geretourneerd" + +#~ msgid "Postman has delivered %d email for you." +#~ msgid_plural "Postman has delivered %d emails for you." +#~ msgstr[0] "Postman heeft %d email bezorgd voor je." +#~ msgstr[1] "Postman heeft %d emails bezorgd voor je." + +#~ msgid "View the log" +#~ msgstr "Bekijk je log" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "configure manually" +#~ msgstr "Handmatig configureren" + +#~ msgid "The server returned an unexpected and invalid result:" +#~ msgstr "De server heeft een onverwachte en invalid resultaat geretourneerd" + +#~ msgid "Communication Error [334] - make sure the Sender Email belongs to the account which provided the OAuth 2.0 consent." +#~ msgstr "Communicatie Fout [334] - Wees er zeker van dat de email zender toestemming heeft bij het betreffende account OAuth 2.0." + +#~ msgid "https://profiles.wordpress.org/jasonhendriks/" +#~ msgstr "https://profiles.wordpress.org/jasonhendriks/" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your shared secret (password) in encoded form." +#~ msgstr "Dit is een onderhoud tussen Postman en je SMTP server. Dit kan nuttig zijn voor diagnostische problemen.Post het NIETonline, het kan je geheime password in encoded form bevatten" + +#~ msgid "Choose the Recipient" +#~ msgstr "Kies de ontvanger" + +#~ msgid "The Gmail API transport requires a Sender Email Address, Client ID and Client Secret." +#~ msgstr "Gmail API transport vereist een Zender Email Adres, Klant ID en Klant secret. " + +#~ msgid "Outgoing Mail Server Hostname/Port and Sender Email Address can not be empty." +#~ msgstr "Uitgaande Mail Server Hostname/Port en zender email adres kan niet leeg blijven." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Sender" +#~ msgstr "Verzender" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Email Address" +#~ msgstr "Email adres zender" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Name" +#~ msgstr "Naam afzender" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Addresses" +#~ msgstr "Annvullende adressen" + +#~ msgctxt "Configuration Input Field" +#~ msgid "To Recipient(s)" +#~ msgstr "Aan ontvanger(s)" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Carbon Copy Recipient(s)" +#~ msgstr "Carbon Copy Ontvangers" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Blind Carbon Copy Recipient(s)" +#~ msgstr "BCC" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Headers" +#~ msgstr "Aanvullende Headers" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Custom Headers" +#~ msgstr "Aangepaste Headers" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Enable Logging" +#~ msgstr "Toegestane Logging" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Log Entries Limit" +#~ msgstr "Limiet Log toegang" + +#~ msgctxt "The maximum number of lines of the SMTP transcript" +#~ msgid "Transcript Size (Total Lines)" +#~ msgstr "Transcript grootte" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Network Settings" +#~ msgstr "Netwerk Instellingen" + +#~ msgid "The Sender sets both the envelope Mail-From and the message From header. However, the From header can be modified by another plugin (e.g. for setting a visitor's email address from a Contact Form)." +#~ msgstr "De afzender stelt zowel de envelop Mail (uit ) en van de berichtkop. Echter, de van -header kan worden gewijzigd door een andere plugin (bv. voor het instellen van een bezoeker e-mailadres van een Contact-formulier)." + +#~ msgid "Force this in the From header for all messages" +#~ msgstr "Krijgsmacht zulks in de header van voor alle berichten" + +#~ msgid "Communication Error [334] - make sure the Sender Email belongs to the account which provided the %s OAuth 2.0 consent." +#~ msgstr "Communicatie Fout [334] - Wees er zeker van dat de email zender toestemming heeft bij het betreffende account %s 0Auth 2.0 " + +#~ msgid "Please note that to combat Spam, many email services will not let you send from an email address other than the one you authenticate with." +#~ msgstr "Houdt er rekening mee dat door de spam bestrijding, zullen veel email diensten je geen andere email laten verzenden dan met degene waarvoor je authenticatie hebt" + +#~ msgctxt "Who is this message from?" +#~ msgid "From" +#~ msgstr "Afzender" + +#~ msgctxt "Who is this message to?" +#~ msgid "To" +#~ msgstr "Ontvanger" + +#~ msgctxt "Name of the email service portal" +#~ msgid "Google Developer Console" +#~ msgstr "Google ontwikkelaar console" + +#~ msgid "Please check the troubleshooting and error messages page and the support forum.
    If you write for help, please include the following:" +#~ msgstr "Controleer de probleem oplossingen en foutmeldingen pagina en de support forum.
    Als je om hulp vraagt, voeg dan aub het volgende toe:" + +#~ msgid "Postman will send mail via the Gmail API using %s authentication." +#~ msgstr "Postman zal de email verzenden via Gmail APIgebruik %s authenticatie" + +#~ msgctxt "Transport Name" +#~ msgid "SMTPS" +#~ msgstr "SMTP" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP-STARTTLS" +#~ msgstr "SMTP-STARTTLS" + +#~ msgid "The message sender is used as the default From: address." +#~ msgstr "De bericht zender zal als standaard gebruikt worden Van:adres" + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful in a development environment." +#~ msgstr "Log niveau specificeert het niveau van de gedetailleerde geschreven WordPress en PHP logfiles. De verzend modus geeft bruikbare mogelijkheiden in een ontwikkelings omgeving" + +#~ msgid "Force this Sender Name for all messages" +#~ msgstr "Gebruik (force) deze verzendnaam voor alle berichten" + +#~ msgid "Force this Sender Email Address for all messages" +#~ msgstr "Gebruik (force) dit emailadres voor alle berichten" + +#~ msgid "Please note: When composing email, some WordPress plugins and themes may set an unauthorized sender email address causing rejection with services like Yahoo Mail. If you experience problems, enable \"Force this Sender Email Address for all messages\" in the settings." +#~ msgstr "Let Op:Bij het samenstellen van email, kunnen sommige WordPress plugins en Thema's een onbevoegde email afzender in stellen waardoor zich afwijzingen met diensten zoals Yahoo mail voordoen. Als je problemen ondervindt, enable ''force deze email afzender voor alle berichten'' in de instellingen." diff --git a/Postman/languages/postman-smtp-ru_RU.mo b/Postman/languages/postman-smtp-ru_RU.mo new file mode 100644 index 0000000..835844d Binary files /dev/null and b/Postman/languages/postman-smtp-ru_RU.mo differ diff --git a/Postman/languages/postman-smtp-ru_RU.po b/Postman/languages/postman-smtp-ru_RU.po new file mode 100644 index 0000000..4f24037 --- /dev/null +++ b/Postman/languages/postman-smtp-ru_RU.po @@ -0,0 +1,1778 @@ +# Copyright (C) 2015 Postman SMTP +# This file is distributed under the same license as the Postman SMTP package. +msgid "" +msgstr "" +"Project-Id-Version: Postman SMTP 1.6.23d\n" +"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/postman-smtp\n" +"POT-Creation-Date: 2015-11-08 17:14-0500\n" +"PO-Revision-Date: 2015-11-08 17:16-0500\n" +"Last-Translator: Дмитрий Кобзев \n" +"Language-Team: Новости Горного Алтая \n" +"Language: ru_RU\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 1.8.6\n" +"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n" +"X-Poedit-SourceCharset: UTF-8\n" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:94 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:348 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:357 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:99 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:545 +#: Postman/PostmanViewController.php:227 +msgid "Warning" +msgstr "Предупреждение" + +#. translators: where %s is the name of the SMTP server +#: Postman/Postman-Configuration/PostmanConfigurationController.php:96 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +msgid "connected to %1$s instead of %2$s." +msgstr "подключение к %1$s вместо %2$s." + +#. translators: where %d is a port number +#: Postman/Postman-Configuration/PostmanConfigurationController.php:98 +msgid "You are about to configure OAuth 2.0 with an IP address instead of a domain name. This is not permitted. Either assign a real domain name to your site or add a fake one in your local host file." +msgstr "Нельзя настроить OAuth 2.0, указав вместо домена IP-адрес. Нужно указать реальное доменное имя вашего сайта или добавить псевдоним в файле localhost на вашем сервере." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/PostmanViewController.php:53 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "%s Setup" +msgstr "Настройки %s" + +#. Plugin Name of the plugin/theme +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:57 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:70 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:176 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/Postman.php:61 Postman/PostmanViewController.php:53 +#: Postman/PostmanViewController.php:54 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "Postman SMTP" +msgstr "Почтовик SMTP" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:196 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:81 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 Postman/Postman.php:316 +#: Postman/PostmanAdminController.php:225 +msgid "Settings" +msgstr "Настройки" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:198 +msgid "Account" +msgstr "Счёт" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:199 +msgid "Message" +msgstr "Текст сообщения" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:200 +msgid "Logging" +msgstr "Журналы" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:201 +msgid "Advanced" +msgstr "Дополнительные" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:263 +msgid "Setup Wizard" +msgstr "Мастер установки Почтовика" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:296 +msgctxt "Wizard Step Title" +msgid "Import Configuration" +msgstr "Импорт настроек" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:298 +msgctxt "Wizard Step Title" +msgid "Import configuration from another plugin?" +msgstr "Импорт настройки из другого плагина?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:299 +msgid "If you had a working configuration with another Plugin, the Setup Wizard can begin with those settings." +msgstr "Если у вас есть работающие настройки другого плагина, Мастер установки может использовать их." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:301 +#: Postman/Postman-Mail/PostmanModuleTransport.php:720 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:425 +msgid "None" +msgstr "Нет" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:312 +msgctxt "Wizard Step Title" +msgid "Sender Details" +msgstr "Детали отправителя" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:314 +msgctxt "Wizard Step Title" +msgid "Who is the mail coming from?" +msgstr "От чьего имени будут отправляться письма?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:315 +msgid "Enter the email address and name you'd like to send mail as." +msgstr "Укажите адрес электронной почти и имя отправителя." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:316 +msgid "Please note that to prevent abuse, many email services will not let you send from an email address other than the one you authenticate with." +msgstr "Обратите внимание, что для предотвращения злоупотреблений, многие почтовые службы не позволяют отправлять письма с адресов, не закрепленных за вами." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:317 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:49 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:112 +msgid "Email Address" +msgstr "Адрес эклектронной почты" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:320 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:59 +msgid "Name" +msgstr "Имя" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:325 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:143 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:331 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:542 +msgid "Outgoing Mail Server Hostname" +msgstr "Сервер исходящей почты (хост)" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:333 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:138 +#: Postman/PostmanViewController.php:294 +msgid "Connectivity Test" +msgstr "Проверка подключений" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:335 +msgid "How will the connection to the mail server be established?" +msgstr "Каким образом будет устанавливаться подключение к MSA?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:336 +msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows." +msgstr "Параметры подключения зависит от предложения поставщика услуг электронной почты, а также от настроек вашего сайта." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +msgctxt "TCP Port Test Status" +msgid "Ready" +msgstr "Готово" + +#. Translators: Where %1$s is the socket identifier and %2$s is the +#. authentication type +#: Postman/Postman-Configuration/PostmanConfigurationController.php:345 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgctxt "A socket is the network term for host and port together" +msgid "Socket" +msgstr "Socket" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:346 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:354 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:223 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:177 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:351 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:356 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:372 +msgid "Authentication" +msgstr "Аутентификация" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:349 +msgid "This configuration option will send your authorization credentials in the clear." +msgstr "Этот параметр будет отправлять учетные данные авторизации в ясной." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:356 +msgid "How will you prove your identity to the mail server?" +msgstr "Каким образом будет происходить ваша идентификация на MSA?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:363 +msgctxt "The final step of the Wizard" +msgid "Finish" +msgstr "Завершить" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:365 +msgctxt "Wizard Step Title" +msgid "You're Done!" +msgstr "Сделано!" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:367 +msgid "Click Finish to save these settings, then:" +msgstr "Нажмите кнопку Завершить чтобы сохранить настройки, а затем:" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:369 +msgid "Grant permission with the Email Provider for Postman to send email and" +msgstr "Предоставить разрешения для Почтовика на отправку электронной почты и" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:370 +msgid "Send yourself a Test Email to make sure everything is working!" +msgstr "Отправить себе проверочное письмо чтобы убедиться, что все работает правильно!" + +#. translators: where %s is the URL to the Connectivity Test page +#: Postman/Postman-Configuration/PostmanConfigurationController.php:514 +msgid "Postman can't find any way to send mail on your system. Run a connectivity test." +msgstr "Почтовик не может обнаружить в вашей системе способ отправки почты. Запуск проверки подключения." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:33 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Transport" +msgstr "Транспорт" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:38 +msgctxt "(i.e.) What kind is it?" +msgid "Type" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:44 +msgctxt "The Message Sender Email Address" +msgid "From Address" +msgstr "Адрес" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:70 +msgid "Additional Email Addresses" +msgstr "Дополнительные адреса электронной почты" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:75 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:220 +msgid "Reply-To" +msgstr "Ответ на адрес" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:80 +msgid "To Recipient(s)" +msgstr "Для получателя(ей)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:85 +msgid "Carbon Copy Recipient(s)" +msgstr "Копии" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:90 +msgid "Blind Carbon Copy Recipient(s)" +msgstr "Скрытые копии" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:96 +msgid "Additional Headers" +msgstr "Дополнительные заголовки" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:101 +msgid "Custom Headers" +msgstr "Пользовательские заголовки" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:107 +msgid "Validation" +msgstr "Валидация" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:118 +msgid "Email Log Settings" +msgstr "Настройки журнала событий" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:123 +msgid "Enable Logging" +msgstr "Включить запись в журнал" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:128 +#: Postman/PostmanInputSanitizer.php:137 +msgid "Maximum Log Entries" +msgstr "Максимальное число записей в журнале" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:133 +msgid "Maximum Transcript Size" +msgstr "Максимальное число строк в служебных данных" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:139 +msgid "Network Settings" +msgstr "Настройки сети" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:144 +msgctxt "Configuration Input Field" +msgid "TCP Connection Timeout (sec)" +msgstr "Время ожидания TCP (в секундах)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:149 +msgctxt "Configuration Input Field" +msgid "TCP Read Timeout (sec)" +msgstr "Время ожидания чтения TCP (в секундах)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:155 +msgctxt "Configuration Section Title" +msgid "Miscellaneous Settings" +msgstr "Прочие настройки" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:160 +msgctxt "Configuration Input Field" +msgid "PHP Log Level" +msgstr "Уровень журнала PHP" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:165 +msgctxt "Configuration Input Field" +msgid "Delivery Mode" +msgstr "Способ доставки" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:170 +msgctxt "This mode removes the Postman X-Mailer signature from emails" +msgid "Stealth Mode" +msgstr "Скрытый режим" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:175 +msgid "Temporary Directory" +msgstr "Временный каталог" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:186 +msgid "Choose SMTP or a vendor-specific API:" +msgstr "Выберите SMTP или API конкретного производителя:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:189 +msgid "Configure the delivery audit log:" +msgstr "Настройка журнала проверки доставки:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:196 +msgid "This address, like the letterhead printed on a letter, identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Other plugins, especially Contact Forms, may override this field to be your visitor's address." +msgstr "Данные в поле Message-From указывают получателю обратный адрес. Измените эти данные, если вы отправляете письма от имени другого пользователя. Темы и другие плагины, например плагины обратной связи, могут изменить данные этого поля." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:203 +msgid "Separate multiple to/cc/bcc recipients with commas." +msgstr "Разделите несколько получателей/копий/ получателейскрытых копий запятыми." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:210 +msgid "Increase the timeouts if your host is intermittenly failing to send mail. Be careful, this also correlates to how long your user must wait if the mail server is unreachable." +msgstr "Если ваш сервер не отправляет письма, можно увеличить время ожидания ответа. Будьте внимательны - это значение будет определять, как пользователю предстоит ждать, если почтовый сервер недоступен." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:221 +msgid "Specify custom headers (e.g. X-MC-Tags: wordpress-site-A), one per line. Use custom headers with caution as they can negatively affect your Spam score." +msgstr "Укажите настраиваемые заголовки (например X-MC-Tags: wordpress-site-A) по одному на строке. Эти заголовки следует использовать с осторожностью, поскольку неправильное заполнение может повлиять на определение ваших писем как спам." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:228 +msgid "E-mail addresses can be validated before sending e-mail, however this may fail with some newer domains." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:254 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:276 +msgid "Prevent plugins and themes from changing this" +msgstr "Предотвратить изменение настроек другими плагинами и темами." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:261 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:405 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:244 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:195 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:409 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:416 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:459 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:467 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:475 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:482 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:530 +msgid "Required" +msgstr "Необходим" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:268 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:531 +msgid "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +msgstr "Адрес в поле Envelope-From идентифицирует владельца учетной записи для сервера исходящей почты." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:289 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:108 +msgid "Yes" +msgstr "Да" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:290 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:109 +msgid "No" +msgstr "Нет" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:300 +msgid "Change this value if you can't see the beginning of the transcript because your messages are too big." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:343 +msgid "Disable e-mail validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:350 +msgid "Log Level specifies the level of detail written to the WordPress Debug log - view the log with Debug." +msgstr "Глубина детализации журнала событий определяет детали, которые записываются в журналы WordPress и PHP. Эти данные могут быть полезны для разработки или проверки." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:353 +msgid "Off" +msgstr "Откл" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:354 +msgid "Trace" +msgstr "Отслеживание" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:355 +msgid "Debug" +msgstr "Наладить" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:356 +msgid "Info" +msgstr "Подробно" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:358 +msgid "Error" +msgstr "Ошибка" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:366 +msgid "Delivery mode offers options useful for developing or testing." +msgstr "Эти данные могут быть полезны для разработки или проверки." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:369 +msgctxt "When the server is online to the public, this is \"Production\" mode" +msgid "Log Email and Send" +msgstr "Протоколировать и отправить" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:370 +msgid "Log Email and Delete" +msgstr "Протоколировать и удалить" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:371 +msgid "Delete All Emails" +msgstr "Удалить все письма" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:375 +msgid "Remove the Postman X-Header signature from messages" +msgstr "Удалить все записи Почтовика в заголовке писем" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:378 +msgid "Lockfiles are written here to prevent users from triggering an OAuth 2.0 token refresh at the same time." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:381 +msgid "Valid" +msgstr "Действительная" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:383 +msgid "Invalid" +msgstr "Ключ неверен" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:105 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:109 +msgctxt "The \"please wait\" message" +msgid "Checking.." +msgstr "Проверка…" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:106 +msgctxt "The port is open" +msgid "Open" +msgstr "Открыт" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:107 +msgctxt "The port is closed" +msgid "Closed" +msgstr "Закрыт" + +#. translators: where %d is a port number +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:111 +msgid "No outbound route between this site and the Internet on Port %d." +msgstr "Невозможно установить связь между сайтом и сетью Интернет через порт %d." + +#. translators: where %d is a port number and %s is a hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:113 +msgid "Port %d is open, but not to %s." +msgstr "Порт %d открыт, но не для %s." + +#. translators: where %d is the port number and %s is the hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:115 +msgid "Port %d can be used for SMTP to %s." +msgstr "Порт %d может быть использован для SMTP на %s." + +#. translators: where %d is a port number and %s is the URL for the Postman +#. Gmail Extension +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:118 +msgid "Port %d can be used with the %s." +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:141 +msgid "This test determines which well-known ports are available for Postman to use." +msgstr "Эта проверка покажет, какие порты доступны для использования." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:145 +msgctxt "Button Label" +msgid "Begin Test" +msgstr "Начать проверку" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:162 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:152 +msgid "Status" +msgstr "Статус" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Service Available" +msgstr "Услуга доступна" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Server ID" +msgstr "" + +#. Translators: Meaning "Not Applicable" +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:155 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:260 +msgid "n/a" +msgstr "не определено" + +#. Translators: Where %s is the name of the service providing Internet +#. connectivity test +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:160 +msgid "According to %s" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:163 +msgid "Summary" +msgstr "Итог" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:168 +msgid "A test with \"No\" Service Available indicates one or more of these issues:" +msgstr "Недоступность портов означает наличие одной или более из этих проблем:" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:170 +msgid "Your web host has placed a firewall between this site and the Internet" +msgstr "Владелец хостинга установил firewall между сайтом и интернетом" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:171 +msgid "The SMTP hostname is wrong or the mail server does not provide service on this port" +msgstr "Неверно указано имя SMTP-сервера или сервер не предоставляет доступ к этому порту" + +#. translators: where (1) is the URL and (2) is the system +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:173 +msgid "Your %2$s configuration is preventing outbound connections" +msgstr "Настройки %2$s не допускают исходящие соединения" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:177 +msgid "If the issues above can not be resolved, your last option is to configure Postman to use an email account managed by your web host with an SMTP server managed by your web host." +msgstr "Если эти проблемы невозможно устранить, вам необходимо настроить Почтовик на использование учетной записи электронной почты вашего сервера в соответствии с конфигурацией вашего хостинга." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:82 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman.php:317 +msgctxt "The log of Emails that have been delivered" +msgid "Email Log" +msgstr "Журнал событий" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:95 +msgid "Error: Postman is missing a required PHP library." +msgstr "Ошибка: Для работы плагина не хватает библиотеки РНР." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:97 +#: Postman/Postman.php:257 +msgid "Postman: wp_mail has been declared by another plugin or theme, so you won't be able to use Postman until the conflict is resolved." +msgstr "В системе установлен плагин или тема, которая конфликтует с этой версией Postman SMTP. Плагин не будет работать до тех пор, пока вы не устраните конфликт." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:100 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:229 +msgid "Postman is in non-Production mode and is dumping all emails." +msgstr "Почтовик находится в не рабочем режиме и игнорирует письма." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:102 +msgid "Postman is configured and has delivered %d email." +msgid_plural "Postman is configured and has delivered %d emails." +msgstr[0] "Почтовик настроен и отправил %d письмо." +msgstr[1] "Почтовик настроен и отправил %d письма." +msgstr[2] "Почтовик настроен и отправил %d писем." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:104 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:234 +msgid "Postman is not configured and is mimicking out-of-the-box WordPress email delivery." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:116 +msgid "Postman is operating in per-site mode." +msgstr "Почтовик работает в односайтовом режиме." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:102 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:107 +#: Postman/PostmanViewController.php:295 +msgid "Diagnostic Test" +msgstr "Диагностика" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:104 +msgid "Are you having issues with Postman?" +msgstr "У вас возникли проблемы с Почтовиком?" + +#. translators: where %1$s and %2$s are the URLs to the Troubleshooting and +#. Support Forums on WordPress.org +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:106 +msgid "Please check the troubleshooting and error messages page and the support forum." +msgstr "Пожалуйста, изучите страницу устранения неполадок и сообщения об ошибках, а также наш форум." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:108 +msgid "If you write for help, please include the following:" +msgstr "При обращении в службу поддержки укажите следующие данные:" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:90 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:242 +msgid "Your message was delivered (%d ms) to the SMTP server! Congratulations :)" +msgstr "Ваше сообщение было доставлено до SMTP-сервера за %d милисекунд. Ура!" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:156 +msgid "Mail Log Entries were deleted." +msgstr "Журнал событий удален." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:179 +msgid "Mail Log Entry was deleted." +msgstr "Журнал событий был удален." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:204 +msgctxt "Who is this message From?" +msgid "From" +msgstr "От кого" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:208 +msgctxt "Who is this message To?" +msgid "To" +msgstr "Кому" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:212 +msgctxt "Who is this message Cc'd to?" +msgid "Cc" +msgstr "Копия" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:216 +msgctxt "Who is this message Bcc'd to?" +msgid "Bcc" +msgstr "Скрытая копия" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:222 +msgctxt "What is the date today?" +msgid "Date" +msgstr "Дата" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:223 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:161 +msgctxt "What is the subject of this message?" +msgid "Subject" +msgstr "Тема" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:226 +msgctxt "What is the unique URI of the configuration?" +msgid "Delivery-URI" +msgstr "Доставка URI" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:253 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:161 +msgid "This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +msgstr "Это обмен сообщениями между Почтовиком и сервером SMTP. Эта информация поможет установить причину проблем. НЕ ПУБЛИКУЙТЕ эти данные в открытом доступе, поскольку они содержат пароль от вашей учетной записи." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +msgid "%s Email Log" +msgstr "Журнал событий %s" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:301 +msgid "Email was successfully resent (but without attachments)" +msgstr "" + +#. Translators: Where %s is an error message +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:303 +msgid "Email could not be resent. Error: %s" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:304 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:110 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:112 +msgid "Resend" +msgstr "Отправить вновь" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:339 +msgid "This is a record of deliveries made to the mail server. It does not neccessarily indicate sucessful delivery to the recipient." +msgstr "Это список писем, которые отправлялись с помощью Почтовика. Обратите внимание, что попадание письма в этот список не означает, что оно было доставлено адресату." + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:37 +msgctxt "The group of Emails that have been delivered" +msgid "Sent Emails" +msgstr "Отправленные письма" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:38 +msgctxt "An Email that has been delivered" +msgid "Sent Email" +msgstr "Отправленное письмо" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +msgid "An empty subject line can result in delivery failure." +msgstr "незаполненное поле Тема может быть причиной неуспешной отправки почты." + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:196 +msgid ".. +%d more" +msgstr ".. +%d более" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:99 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:223 +msgctxt "Delete an item from the email log" +msgid "Delete" +msgstr "Удалить" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:100 +msgctxt "View an item from the email log" +msgid "View" +msgstr "Просмотреть" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:104 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:106 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:158 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:163 +msgid "Session Transcript" +msgstr "Расшифровка сессии" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:163 +msgctxt "When was this email sent?" +msgid "Delivery Time" +msgstr "Отправлено" + +#. Translators: where %s indicates the relative time from now +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:332 +msgctxt "A relative time as in \"five days ago\"" +msgid "%s ago" +msgstr "%s назад" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:338 +msgid "Sent" +msgstr "Отправлено" + +#: Postman/Postman-Mail/PostmanDefaultModuleTransport.php:107 +msgid "Default" +msgstr "Дефолт" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:102 +msgid "Gmail API" +msgstr "Gmail API" + +#. translators: where (1) is the secure icon and (2) is the transport name +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:152 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:135 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:79 +msgid "Postman will send mail via the %1$s %2$s." +msgstr "Почтовик будет отправлять почту через %1$s %2$s с помощью проверки подлинности %s." + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:166 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:117 +msgid "You have configured OAuth 2.0 authentication, but have not received permission to use it." +msgstr "Вы настроили аутентификацию OAuth 2.0, но не получили разрешение на его использование." + +#. translators: where variables are (1) transport name (2) host and (3) port +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:206 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:181 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:125 +msgid "Postman recommends the %1$s to host %2$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:221 +#: Postman/Postman-Mail/PostmanModuleTransport.php:713 +msgid "OAuth 2.0 (requires Client ID and Client Secret)" +msgstr "OAuth 2.0 (требуется идентификатор клиента и секретный ключ)" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:44 +msgid "Mandrill API" +msgstr "Mandrill API" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:147 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:101 +msgid "API Key can not be empty" +msgstr "API-ключ не может быть пустым." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:151 +#: Postman/Postman-Mail/PostmanModuleTransport.php:578 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:105 +msgid "Message From Address can not be empty" +msgstr "Поля Envelope From и Message From не могут быть пустыми." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:194 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:228 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:271 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:148 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:182 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:222 +msgid "API Key" +msgstr "API-ключ" + +#. Translators: Where (1) is the service URL and (2) is the service name and +#. (3) is a api key URL +#: Postman/Postman-Mail/PostmanMandrillTransport.php:238 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:189 +msgid "Create an account at %2$s and enter an API key below." +msgstr "Создайте аккаунт на %2$s и введите ниже API-ключ." + +#. translators: where (1) is the transport type, (2) is the host, and (3) is +#. the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 +#. using OAuth 2.0 authentication.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:506 +msgid "Postman will send mail via %1$s to %2$s using %3$s authentication." +msgstr "Почтальон отправляет почту через %1$s на %2$s, используя в качестве аутентификации %3$s." + +#. translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s +#. is the encryption type (e.g. SSL or TLS) +#: Postman/Postman-Mail/PostmanModuleTransport.php:534 +msgctxt "as in \"There is no Spoon\"" +msgid "no" +msgstr "нет" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:553 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:366 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:584 +msgid "Password" +msgstr "Пароль" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:584 +msgid "OAuth 2.0 authentication requires a %1$s and %2$s." +msgstr "Для аутентификации OAuth 2.0 потребуется идентификатор клиента и секретный ключ." + +#: Postman/Postman-Mail/PostmanModuleTransport.php:706 +msgid "Password (requires username and password)" +msgstr "Пароль (требуется имя пользователя и пароль)" + +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 +msgid "MyMail: Change the delivery method in the %s!" +msgstr "" + +#: Postman/Postman-Mail/PostmanSendGridTransport.php:39 +msgid "SendGrid API" +msgstr "SendGrid API" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:95 +msgid "Outgoing Mail Server Hostname and Port can not be empty." +msgstr "Название сервера исходящей почты и номер порт не могут быть пустыми." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:99 +msgid "Envelope-From Email Address can not be empty" +msgstr "Поля Envelope From не могут быть пустыми." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:103 +msgid "Username and password can not be empty." +msgstr "Аутентификация по паролю (Простая / Логин / CRAM-MD5) требует имя пользователя и пароль." + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:109 +msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server." +msgstr "Для аутентификации OAuth 2.0 требуется сервер исходящей почты, который поддерживает этот метод." + +#. translators: where %1$s is a description of the transport (eg. SMTPS-SSL), +#. %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is +#. the TCP port (eg. 465), %4$d is the hostname +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:269 +msgid "Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:326 +msgid "Transport Settings" +msgstr "Настройки отправки" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:336 +msgid "Outgoing Mail Server Port" +msgstr "Сервер исходящей почты (порт)" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:341 +msgid "Envelope-From Email Address" +msgstr "Поля Envelope From" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:346 +msgctxt "Configuration Input Field" +msgid "Security" +msgstr "Безопасность" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:361 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:580 +msgid "Username" +msgstr "Имя пользователя" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:402 +msgid "Configure the communication with the mail server." +msgstr "Настройки связи с Mail Submission Agent (MSA):" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:449 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:579 +msgid "Enter the account credentials." +msgstr "Укажите ваши учетные данные." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:457 +msgid "The Username is usually the same as the Envelope-From Email Address." +msgstr "Имя пользователя зачастую совпадает с адресом электронной почты." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:511 +msgid "Error computing your domain root - please enter it manually" +msgstr "Ошибка определения вашего домена - укажите его вручную" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:532 +msgid "For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:539 +msgctxt "Wizard Step Title" +msgid "Which host will relay the mail?" +msgstr "Какой хост будет ретранслировать почту?" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:540 +msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. This server is specific to your email account, and if you don't know what to use, ask your email service provider." +msgstr "SMTP-сервер или MSA, через которой Почтовик будет отправлять письма. Если вы не знаете, что именно использовать, утоните у поставщика услуг электронной почты." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:541 +msgid "Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, require that you use their mail accounts with their mail servers, and prevent you from using others." +msgstr "Обратите внимание, что многие хостеры (GoDaddy, Dreamhost, Bluehost) требуют, чтобы вы использовали учетные записи на их почтовых серверах." + +#. Translators: Where (%s) is the name of the web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:547 +msgid "Your email address requires access to a remote SMTP server blocked by %s." +msgstr "ваш адрес требует доступ к серверу SMTP, который заблокирован %s." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:548 +msgid "If you have access to cPanel, enable the Remote Mail Exchanger." +msgstr "" + +#. Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the +#. web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:551 +msgid "If you own this domain, make sure it has an SPF record authorizing %2$s as a relay, or you will have delivery problems." +msgstr "Если вы являетесь владельцем этого домена, убедитесь, что он имеет запись SPF, разрешающие %2$s быть ретранслятором, иначе у вас возникнут проблемы с доставкой почты." + +#: Postman/Postman-Mail/PostmanTransportRegistry.php:231 +msgid "Postman is configured." +msgstr "Почтовик настроен." + +#: Postman/Postman-Mail/PostmanZendMailEngine.php:209 +msgid "Communication Error [334] - make sure the Envelope From email is the same account used to create the Client ID." +msgstr "Ошибка связи [334] - убедитесь, что данные Envelope From совпадают с идентификатором учетной записи." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:115 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:149 +msgctxt "Email Test Status" +msgid "In Outbox" +msgstr "В исходящих" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:116 +msgctxt "Email Test Status" +msgid "Sending..." +msgstr "Отправляется…" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:117 +msgctxt "Email Test Status" +msgid "Success" +msgstr "Успешно" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:118 +msgctxt "Email Test Status" +msgid "Failed" +msgstr "Неудачно" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:119 +msgid "Ajax Error" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:128 +#: Postman/PostmanViewController.php:273 Postman/PostmanViewController.php:275 +msgid "Send a Test Email" +msgstr "Отправить тестовое письмо." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:133 +msgid "Specify the Recipient" +msgstr "Укажите получателя" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:135 +msgid "Who is this message going to?" +msgstr "Кому адресовано сообщение?" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:136 +msgid "This utility allows you to send an email message for testing." +msgstr "Эта утилита отправляет сообщения электронной почты для проверки связи." + +#. translators: where %d is an amount of time, in seconds +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:139 +msgid "If there is a problem, Postman will give up after %d second." +msgid_plural "If there is a problem, Postman will give up after %d seconds." +msgstr[0] "Если возникла проблема, то Почтовик прекратит попытки через %d секунду." +msgstr[1] "Если возникла проблема, то Почтовик прекратит попытки через %d секунды." +msgstr[2] "Если возникла проблема, то Почтовик прекратит попытки через %d секунд." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:140 +msgctxt "Configuration Input Field" +msgid "Recipient Email Address" +msgstr "Адрес получателя" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:145 +msgid "Send The Message" +msgstr "Отправить сообщение" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:148 +msgid "Sending the message:" +msgstr "Сообщение отправляется:" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:160 +msgid "Examine the Session Transcript if you need to." +msgstr "Если необходимо, изучите расшифровку сессии SMTP." + +#. translators: where %s is the domain name of the site +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:212 +msgctxt "Test Email Subject" +msgid "Postman SMTP Test (%s)" +msgstr "Проверка связи от Почтовика (%s)" + +#. translators: where %s is the Postman plugin version number (e.g. 1.4) +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:299 +msgctxt "Test Email Tagline" +msgid "Sent by Postman %s" +msgstr "Отправлено Почтовиком %s" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:300 +msgid "Image source" +msgstr "Источник изображения" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:301 +msgid "Used with permission" +msgstr "Используется с разрешения" + +#: Postman/PostmanAdminController.php:111 +msgctxt "The plugin successfully saved new settings." +msgid "Settings saved." +msgstr "Настройки сохранены." + +#. Translators: where %1$s is the name of the library +#: Postman/PostmanAdminController.php:178 +msgid "This PHP installation requires the %1$s library." +msgstr "Необходимо наличие библиотеки %1$s." + +#: Postman/PostmanAdminController.php:253 +msgid "There was an error importing the data." +msgstr "" + +#: Postman/PostmanAdminController.php:270 +msgid "Plugin data was removed." +msgstr "Данные удалены." + +#: Postman/PostmanAdminController.php:294 +msgid "The OAuth 2.0 authorization was successful. Ready to send e-mail." +msgstr "Авторизация по протоколу OAuth 2.0 прошла успешно. Система готова к отправке электронной почты." + +#: Postman/PostmanAdminController.php:296 +msgid "Your email provider did not grant Postman permission. Try again." +msgstr "Поставщик услуг электронной почты не дает Почтовику необходимых привилегий. Попробуйте еще раз." + +#: Postman/PostmanAdminController.php:299 +msgid "The grant code from Google had no accompanying state and may be a forgery" +msgstr "Этот код от Google может быть поддельным" + +#. translators: %s is the error message +#: Postman/PostmanAdminController.php:303 +msgid "Error authenticating with this Client ID. [%s]" +msgstr "Ошибка аутентификации с этим ID." + +#: Postman/PostmanConfigTextHelper.php:31 +msgid "Attention" +msgstr "Внимание" + +#. translators: parameters available are 1=portal-url, 2=portal-name, +#. 3=clientId-name, 4=clientSecret-name, 5=callbackUrl, 6=service-name, +#. 7=portal-application (e.g. Open the Google Developer Console, create a +#. Client ID for web application using the URL's displayed below, and copy the +#. Client ID and Client Secret here.) +#: Postman/PostmanConfigTextHelper.php:33 +msgid "Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +msgstr "Внимание! Откройте %2$s, создайте %7$s, указав нижеприведенные значения, затем скопируйте сгенерированные %3$s и %4$s сюда." + +#. translators: parameters available are 1=clientId-name, 2=service-name, +#. 3=FAQ-URL, 4=Video-URL (e.g. See How do I get a Google Client ID? in the +#. F.A.Q.) +#: Postman/PostmanConfigTextHelper.php:36 +msgid "See How do I get a %1$s %2$s? in the F.A.Q. or watch our How-To video 📺." +msgstr "Смотри Как я могу получить %1$s %2$s? в разделе F.A.Q. или в специальном видео-туре 📺." + +#. translators: where %s is the Email Service Owner (e.g. Google, Microsoft or +#. Yahoo) +#: Postman/PostmanConfigTextHelper.php:54 +msgctxt "Command to initiate OAuth authentication" +msgid "Grant permission with %s" +msgstr "Предоставить разрешение для %s" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:80 +#: Postman/PostmanConfigTextHelper.php:142 +#: Postman/PostmanConfigTextHelper.php:204 +#: Postman/PostmanConfigTextHelper.php:271 +msgctxt "Name of the OAuth 2.0 Client ID" +msgid "Client ID" +msgstr "Идентификатор (ID) клиента" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:84 +#: Postman/PostmanConfigTextHelper.php:146 +#: Postman/PostmanConfigTextHelper.php:208 +#: Postman/PostmanConfigTextHelper.php:274 +msgctxt "Name of the OAuth 2.0 Client Secret" +msgid "Client Secret" +msgstr "Секретный ключ (Client Secret)" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:88 +msgctxt "Name of the Application Callback URI" +msgid "Authorized redirect URI" +msgstr "Перенаправление для авторизации" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:92 +msgctxt "Name of the Application Callback Domain" +msgid "Authorized JavaScript origins" +msgstr "JavaScript для авторизации" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:96 +msgctxt "Name of the email service owner" +msgid "Google" +msgstr "Google" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:100 +msgctxt "Name of the email service" +msgid "Gmail" +msgstr "Gmail" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:104 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "a Client ID for web application" +msgstr "Client ID для вэб-приложения" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:108 +msgctxt "Name of the email service portal" +msgid "Google Developers Console Gmail Wizard" +msgstr "Мастер консоли разработчиков Gmail" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:150 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URL" +msgstr "Перенаправление" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:154 +msgctxt "Name of the Application Callback Domain" +msgid "Root Domain" +msgstr "Корневой домен" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:158 +msgctxt "Name of the email service owner" +msgid "Microsoft" +msgstr "Microsoft" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:162 +msgctxt "Name of the email service" +msgid "Outlook.com" +msgstr "Outlook.com" + +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:166 +#: Postman/PostmanConfigTextHelper.php:228 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "an Application" +msgstr "приложение" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:170 +msgctxt "Name of the email service portal" +msgid "Microsoft Developer Center" +msgstr "Центр разработчиков Microsoft" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:212 +msgctxt "Name of the Application Callback URI" +msgid "Home Page URL" +msgstr "Ссылка на главную страницу" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:216 +msgctxt "Name of the Application Callback Domain" +msgid "Callback Domain" +msgstr "Callback Domain" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:220 +msgctxt "Name of the email service owner" +msgid "Yahoo" +msgstr "Yahoo" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:224 +msgctxt "Name of the email service" +msgid "Yahoo Mail" +msgstr "Yahoo Mail" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:232 +msgctxt "Name of the email service portal" +msgid "Yahoo Developer Network" +msgstr "Сеть разработчиков Yahoo" + +#: Postman/PostmanConfigTextHelper.php:261 +msgid "Enter an Outgoing Mail Server with OAuth2 capabilities." +msgstr "Укажите сервер исходящей почты с возможностями OAuth2." + +#: Postman/PostmanConfigTextHelper.php:277 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URI" +msgstr "Перенаправление" + +#: Postman/PostmanConfigTextHelper.php:280 +msgctxt "Name of the Application Callback Domain" +msgid "Website Domain" +msgstr "Домен сайта" + +#: Postman/PostmanConfigTextHelper.php:304 +msgid "Grant OAuth 2.0 Permission" +msgstr "Привилегии OAuth 2.0" + +#: Postman/PostmanInputSanitizer.php:137 +msgid "must be greater than 0" +msgstr "должно быть больше 0" + +#: Postman/PostmanViewController.php:112 +msgid "An unexpected error occurred" +msgstr "" + +#: Postman/PostmanViewController.php:113 +msgid "Unexpected PHP messages corrupted the Ajax response" +msgstr "Неожиданные сообщения PHP повередили ответ Ajax" + +#: Postman/PostmanViewController.php:118 +msgctxt "Press this button to Finish this task" +msgid "Finish" +msgstr "Завершить" + +#: Postman/PostmanViewController.php:119 +msgctxt "Press this button to go to the next step" +msgid "Next" +msgstr "Далее" + +#: Postman/PostmanViewController.php:120 +msgctxt "Press this button to go to the previous step" +msgid "Previous" +msgstr "Назад" + +#: Postman/PostmanViewController.php:132 +msgid "Postman is unable to run. Email delivery is being handled by WordPress (or another plugin)." +msgstr "Postman не работает. Письма доставляются WordPress (или другим плагином)." + +#. translators: where %d is the number of emails delivered +#: Postman/PostmanViewController.php:147 +msgid "Postman has delivered %d email." +msgid_plural "Postman has delivered %d emails." +msgstr[0] "Почтовик доставил%d письмо." +msgstr[1] "Почтовик доставил%d письма." +msgstr[2] "Почтовик доставил%d писем." + +#: Postman/PostmanViewController.php:150 +msgid "The last %d email attempts are recorded in the log." +msgstr "" + +#: Postman/PostmanViewController.php:155 +msgid "Thank-you for choosing Postman!" +msgstr "Спасибо, что выбрали Почтовик!" + +#. translators: where %s is the URL of the Setup Wizard +#: Postman/PostmanViewController.php:157 +msgid "Let's get started! All users are strongly encouraged to run the Setup Wizard." +msgstr "Давайте начнем! Настоятельно рекомендуется использовать мастер настройки." + +#: Postman/PostmanViewController.php:158 +msgid "Alternately, manually configure your own settings and/or modify advanced options." +msgstr "" + +#. translators: where %s is the URL to the WordPress.org review and ratings +#. page +#: Postman/PostmanViewController.php:163 +msgid "Please consider leaving a review to help spread the word! :D" +msgstr "Пожалуйста, оставте ваш отзыв." + +#: Postman/PostmanViewController.php:165 +msgid "Postman needs translators! Please take a moment to translate a few sentences on-line" +msgstr "" + +#: Postman/PostmanViewController.php:167 +msgid "New for v1.7! Send mail with the Mandrill or SendGrid APIs." +msgstr "" + +#: Postman/PostmanViewController.php:191 +msgctxt "Return to main menu link" +msgid "Back To Main Menu" +msgstr "Вернуться в главное меню" + +#: Postman/PostmanViewController.php:198 Postman/PostmanViewController.php:233 +#: Postman/PostmanViewController.php:284 +msgid "Import" +msgstr "Импортировать" + +#: Postman/PostmanViewController.php:199 Postman/PostmanViewController.php:285 +msgid "Export" +msgstr "Выгрузить" + +#: Postman/PostmanViewController.php:200 Postman/PostmanViewController.php:286 +msgid "Reset Plugin" +msgstr "" + +#: Postman/PostmanViewController.php:206 +msgid "Copy this data into another instance of Postman to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:225 +msgid "Paste data from another instance of Postman here to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:228 +msgid "Using the same OAuth 2.0 Client ID and Client Secret from this site at the same time as another site will cause failures." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "This will purge all of Postman's settings, including account credentials and the email log." +msgstr "Это приведет к удалению всех данных Почтовика, включая информацию о серверах, логинах, паролях и методах аутентификации." + +#: Postman/PostmanViewController.php:241 +msgid "Are you sure?" +msgstr "Вы уверены?" + +#: Postman/PostmanViewController.php:261 +msgid "Configuration" +msgstr "Настройки" + +#: Postman/PostmanViewController.php:262 +msgid "Start the Wizard" +msgstr "Запустить мастер настройки" + +#: Postman/PostmanViewController.php:263 +msgid "Show All Settings" +msgstr "Показать дополнительные настройки" + +#: Postman/PostmanViewController.php:266 +msgctxt "Main Menu" +msgid "Actions" +msgstr "Действия" + +#: Postman/PostmanViewController.php:292 +msgctxt "Main Menu" +msgid "Troubleshooting" +msgstr "Поиск неисправностей" + +#: Postman/PostmanViewController.php:296 +msgid "Online Support" +msgstr "Онлайн поддержка" + +#. Plugin URI of the plugin/theme +msgid "https://wordpress.org/plugins/postman-smtp/" +msgstr "https://wordpress.org/plugins/postman-smtp/" + +#. Description of the plugin/theme +msgid "Email not reliable? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +msgstr "Проблемы с электронной почтой? Почтовик - первый плагин для WordPress для отправки почти с использованием OAuth 2.0 для Gmail, Hotmail и Yahoo Mail. Установка плагина очень проста." + +#. Author of the plugin/theme +msgid "Jason Hendriks" +msgstr "Jason Хендрикс" + +#. Author URI of the plugin/theme +msgid "http://www.codingmonkey.ca" +msgstr "http://www.codingmonkey.ca" + +#~ msgid "Change the delivery method on the %s!" +#~ msgstr "Измените способ доставки на %s!" + +#~ msgid "Configure the plugin." +#~ msgstr "Настройка плагина." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Test Your Setup" +#~ msgstr "Проверка настроек" + +#~ msgctxt "eg. TCP Port 25" +#~ msgid "Port" +#~ msgstr "Порт" + +#~ msgctxt "as in \"There is no Authentication\"" +#~ msgid "no" +#~ msgstr "нет" + +#~ msgctxt "Log Level" +#~ msgid "Off" +#~ msgstr "Выкл" + +#~ msgctxt "Log Level" +#~ msgid "Trace" +#~ msgstr "Отслеживание" + +#~ msgctxt "Log Level" +#~ msgid "Debug" +#~ msgstr "Отладка" + +#~ msgctxt "Log Level" +#~ msgid "Info" +#~ msgstr "Сведения" + +#~ msgctxt "Log Level" +#~ msgid "Warning" +#~ msgstr "Предупреждение" + +#~ msgctxt "Log Level" +#~ msgid "Error" +#~ msgstr "Ошибка" + +#~ msgid "Port %d can be used to send email with the %s." +#~ msgstr "Порт %d может использоваться для отправки почты через %s." + +#~ msgid "Warning: An empty subject line can result in delivery failure." +#~ msgstr "незаполненное поле Тема может быть причиной неуспешной отправки почты." + +#~ msgid "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +#~ msgstr "Адрес в поле Envelope-From идентифицирует владельца учетной записи для сервера исходящей почты." + +#~ msgid "Warning: connected to %1$s instead of %2$s." +#~ msgstr "Предупреждение: подключение к %1$s вместо %2$s." + +#~ msgid "Warning: This configuration option will send your authorization credentials in the clear." +#~ msgstr "Внимание: Этот параметр будет отправлять учетные данные авторизации в ясной." + +#~ msgid "The Envelope-From Email Address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +#~ msgstr "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." + +#~ msgctxt "View the transcript of an item from the email log" +#~ msgid "Transcript" +#~ msgstr "Служебные данные" + +#~ msgid "Error: Your email address requires access to a remote SMTP server blocked by GoDaddy. Use a different e-mail address." +#~ msgstr "Ошибка: ваш адрес требует доступ к серверу SMTP, который заблокирован GoDaddy. Используйте другой адрес электронной почты." + +#~ msgid "Warning: If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems. If you have access to cPanel, enable the Remote Mail Exchanger." +#~ msgstr "Внимание: Если вы являетесь владельцем этого домена, убедитесь, что он имеет запись SPF, разрешающие GoDaddy быть ретранслятором, иначе у вас возникнут проблемы с доставкой почты." + +#~ msgid "Enter your credentials. Your username is often your email address." +#~ msgstr "Укажите ваши учетные данные. Имя пользователя зачастую совпадает с адресом электронной почты." + +#~ msgid "Attention! Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +#~ msgstr "Внимание! Откройте %2$s, создайте %7$s, указав нижеприведенные значения, затем скопируйте сгенерированные %3$s и %4$s сюда." + +#~ msgid "Maximum Number of Log Entries" +#~ msgstr "Максимальное число записей в журнале" + +#~ msgid "New for v1.6! Email Log" +#~ msgstr "Новое в версии 1.6! Журнал событий" + +#~ msgid "Enable to save a copy of all your emails. Great for troubleshooting or as a backup for messages that get lost. Access the Email Log in the Tools menu." +#~ msgstr "Включить сохранение копий ваших писем. Отлично подходит для поиска неисправностей или восстановления писем, которые вы утеряете. Доступ к Журналу событий через меню «Инструменты»." + +#~ msgctxt "The configuration page of the plugin" +#~ msgid "Settings" +#~ msgstr "Настройки" + +#~ msgid "Postman is not handling email delivery." +#~ msgstr "Почтовик не занимается доставкой почты." + +#~ msgctxt "As in type used: None" +#~ msgid "None" +#~ msgstr "Ничего" + +#~ msgctxt "Who do we reply to?" +#~ msgid "Reply-To" +#~ msgstr "Ответ на адрес" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +#~ msgstr "Это обмен сообщениями между Почтовиком и сервером SMTP. Эта информация поможет установить причину проблем. НЕ ПУБЛИКУЙТЕ эти данные в открытом доступе, поскольку они содержат пароль от вашей учетной записи." + +#~ msgid "Postman Email Log" +#~ msgstr "Журнал Почтовика" + +#~ msgid "This is a record of deliveries made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Это список писем, которые отправлялись с помощью Почтовика. Обратите внимание, что попадание письма в этот список не означает, что оно было доставлено адресату." + +#~ msgctxt "Attempt to resend this email" +#~ msgid "Resend" +#~ msgstr "Отправить вновь" + +#~ msgctxt "Was sending this email successful or not?" +#~ msgid "Status" +#~ msgstr "Состояние" + +#~ msgctxt "Transport Name" +#~ msgid "Gmail API" +#~ msgstr "Gmail API" + +#~ msgctxt "Authentication Type is OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgid "Postman will send mail via the 🔐Gmail API using %s authentication." +#~ msgstr "Почтовик будет отправлять почту через API 🔐Gmail с помощью проверки подлинности %s." + +#~ msgid "OAuth 2.0 authentication requires a Client ID and Client Secret." +#~ msgstr "Для аутентификации OAuth 2.0 потребуется идентификатор клиента и секретный ключ." + +#~ msgid "Envelope From Address and Message From Address can not be empty." +#~ msgstr "Поля Envelope From и Message From не могут быть пустыми." + +#~ msgid "Postman recommends Gmail API configuration on port %d" +#~ msgstr "Почтовик рекомендует настроить Gmail API на порт %d" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP" +#~ msgstr "SMTP" + +#~ msgctxt "As in type used: CRAM-MD5" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "As in type used: Login" +#~ msgid "Login" +#~ msgstr "Логин" + +#~ msgctxt "As in type used: Plain" +#~ msgid "Plain" +#~ msgstr "Простой" + +#~ msgctxt "This authentication type is password-based" +#~ msgid "Password (%s)" +#~ msgstr "Пароль (%s)" + +#~ msgid "Password authentication (Plain/Login/CRAM-MD5) requires a username and password." +#~ msgstr "Аутентификация по паролю (Простая / Логин / CRAM-MD5) требует имя пользователя и пароль." + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, %1$s, and %2$s." +#~ msgstr "Для аутентификации OAuth 2.0 требуется сервер исходящей почты, который поддерживает этот метод." + +#~ msgid "Your recommended settings are %1$s with %2$s authentication to host %4$s on port %3$d." +#~ msgstr "Рекомендуемые для вас настройки: %1$s с аутентификацией %2$s для сервера %4$s и порта %3$d." + +#~ msgid "The selected transport '%s' is unavailable. The external plugin was probably deactivated." +#~ msgstr "Выбранный метод '%s' недоступен. Внешний плагин отключен." + +#~ msgid "WordPress is still handling email delivery, not Postman." +#~ msgstr "Отправка почты все еще осуществляется внутренними средствами WordPress, а не Почтовиком." + +#~ msgctxt "The Transport is the method for sending mail, SMTP or API" +#~ msgid "Transport" +#~ msgstr "Метод отправки" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport Settings" +#~ msgstr "Настройки отправки" + +#~ msgctxt "Authentication proves the user's identity" +#~ msgid "Authentication" +#~ msgstr "Аутентификация" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Username" +#~ msgstr "Имя пользователя" + +#~ msgctxt "The Envelope Sender Email Address" +#~ msgid "Envelope From Address" +#~ msgstr "Адрес Envelope-From" + +#~ msgctxt "The Message Sender Email Address" +#~ msgid "Message From Address" +#~ msgstr "Адрес Message-From" + +#~ msgctxt "The email address to address replies to" +#~ msgid "Reply-To" +#~ msgstr "Reply-To" + +#~ msgid "Maximum Number of Lines in a Transcript" +#~ msgstr "Максимальное число строк в служебных данных" + +#~ msgid "Configure the communication with the Mail Submission Agent (MSA):" +#~ msgstr "Настройки связи с Mail Submission Agent (MSA):" + +#~ msgid "Enter the account username (email address) and password:" +#~ msgstr "Укажите имя пользователя (адрес электронной почты) и пароль:" + +#~ msgid "This will purge all of Postman's settings, including SMTP server info, username/password and OAuth Credentials." +#~ msgstr "Это приведет к удалению всех данных Почтовика, включая информацию о серверах, логинах, паролях и методах аутентификации." + +#~ msgid "The Envelope From address identifies the account owner to the SMTP server." +#~ msgstr "Адрес в поле Envelope-From идентифицирует владельца учетной записи для сервера исходящей почты." + +#~ msgid "The Message From address identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Themes and other plugins, especially Contact Forms, are permitted to modify this field." +#~ msgstr "Данные в поле Message-From указывают получателю обратный адрес. Измените эти данные, если вы отправляете письма от имени другого пользователя. Темы и другие плагины, например плагины обратной связи, могут изменить данные этого поля." + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful for developing or testing." +#~ msgstr "Глубина детализации журнала событий определяет детали, которые записываются в журналы WordPress и PHP. Эти данные могут быть полезны для разработки или проверки." + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Grant OAuth Permission" +#~ msgstr "Привилегии OAuth" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup" +#~ msgstr "Настройки Почтовика" + +#~ msgid "Welcome" +#~ msgstr "Добро пожаловать" + +#~ msgid "This is the Settings page for Postman, an SMTP mailer that delivers email from your WordPress site to the Internet. From here you can configure the plugin, and access testing and diagnostic tools." +#~ msgstr "Это страница настроек Почтовика - системы, которая позволит вам отправлять письма через SMTP с вашего сайта. Здесь вы можете настроить плагин, проверить его работу и изучить отладочную информацию." + +#~ msgid "Having trouble? You can ask for help on our Support Forum. To get the help you need quickly, please post the Diagnostic Data with your question. You can also check the FAQ and Error Messages pages for answers." +#~ msgstr "Возникли проблемы? Вы можете обратиться за помощью на нашем форуме . Чтобы получить необходимую вам помощь быстро, пожалуйста, приведите данные диагностики. Вы также можете изучить Справку и сообщения об ошибках." + +#~ msgid "The Email Test will send an email to you. If the test fails, the full SMTP session transcript is available to you.

    Receiving a single test email does not indicate perfect configuration. Some services may dump your email into a black-hole or mark it as Spam if you:" +#~ msgstr "Вам будет отправлено проверочное письмо. Если проверка не будет пройдена, вы сможете изучить журнал SMTP-сессии.

    Получение одного тестового письма не означает, что конфигурация настроена идеально. Некоторые почтовые сервисы могут воспринимать письма с этого сайта как спам, если вы:" + +#~ msgid "Violate an SPF record" +#~ msgstr "Нарушили запись SPF" + +#~ msgid "You must use the SMTP server (MSA) approved by your domain to deliver your mail. (eg.) a @gmail.com sender address requires that authentication and delivery always be through smtp.gmail.com." +#~ msgstr "Вы должны использовать SMTP-сервер (MSA) домена, чтобы доставить почту. Например, нужно указывать адрес имя_пользователя@Gmail.com для того, чтобы отправлять почту через smtp.gmail.com." + +#~ msgctxt "Forge as in a forgery (fake) is made" +#~ msgid "Forge the From Address" +#~ msgstr "Формирование адреса отправителя" + +#~ msgid "Spoofing, when it results in an SPF violation, will get your message binned. Use your own address as the sender (From:) in every email." +#~ msgstr "Подменять, когда это приводит к нарушению доставки. Использовать свой собственный адрес в качестве отправителя (от:) в каждом сообщении электронной почты." + +#~ msgid "Consolidates details of your setup to aid the author in debugging problems, including: operating system details, WordPress configuration, Postman configuration, network connectivity and your domain's primary MX and SPF records. Your private authorization credentials are masked." +#~ msgstr "Объединяет сведения о ваших настройках для помощи в решении проблем, в том числе: операционная система, конфигурация WordPress, Почтовика, подключение к сети, записи MX и SPF вашего домена. Данные авторизации скрываются." + +#~ msgid "The Connectivity Test will report this site's ability to reach a mail server, and interrogate the mail server for it's capabilities." +#~ msgstr "Поверка подключения выявит способность сайта достигнуть почтового сервера и получить от него ответ." + +#~ msgctxt "Is it possible to create network connections to the Internet?" +#~ msgid "Outbound to Internet" +#~ msgstr "Исходящие подключении к интернету" + +#~ msgid "This tests the ability to make outbound connections from your site to the Internet in general. If the result is Closed, then there is a communication problem with the Internet, like a firewall." +#~ msgstr "С помощью этого теста будет проверена возможность исходящего соединения вашего сайта с интернетом. Если исходящая связь не будет установлена, необходимо проверить возможные причины, например, firewall." + +#~ msgctxt "What service is available?" +#~ msgid "Service Available" +#~ msgstr "Услуга доступна" + +#~ msgid "This shows the service found for a particular host/port. Possible successful results are SMTP, SMTPS (secure) and HTTPS (secure). If the result is No and the hostname you entered is correct, there was a communication problem with the mail server, like a firewall." +#~ msgstr "Здесь указаны протоколы для конкретного хоста/порта. Успешные результаты - HTTPS, SMTP и SMTPS. Если результат другой и имя хоста не совпадает, значит существует проблема связи с почтовым сервером, например firewall." + +#~ msgctxt "What is this server's ID?" +#~ msgid "ID" +#~ msgstr "ID" + +#~ msgid "Some hosts redirect mail traffic to their own mail server, breaking authentication and SPF verification. This is revealed by an incorrect server identity." +#~ msgstr "Некоторые хосты перенаправляют письма на свой собственный сервер, нарушая тем самым аутентификацию и проверку SPF." + +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgid "This indicates whether the server supports protocol-level security. Either STARTTLS, SMTPS or HTTPS is required for secure transmission of your credentials." +#~ msgstr "Здесь показано, какой уровень безопасности поддерживается протоколом. Для корректной передачи данных необходимы STARTTLS, SMTPS или HTTPS." + +#~ msgctxt "Short for Authentication" +#~ msgid "Auth" +#~ msgstr "Auth" + +#~ msgid "This indicates the authenication methods that the server supports. All are password-based, except for OAuth 2.0, which is token-based." +#~ msgstr "Здесь показано, какой метод аутентификации поддерживает сервер. Все они основаны на проверке пароля за исключением OAuth 2.0, которому необходима проверка на основе секретных ключей." + +#~ msgctxt "A testing tool which determines connectivity to the Internet" +#~ msgid "Connectivity Test" +#~ msgstr "Проверка подключений" + +#~ msgid "The server returned an unexpected result:" +#~ msgstr "Сервер вернул неожиданный результат:" + +#~ msgid "Port %d can be used to send Gmail with the Gmail API." +#~ msgstr "Порт %d может использоваться для отправки почты через Gmail." + +#~ msgid "Postman has delivered %d email for you." +#~ msgid_plural "Postman has delivered %d emails for you." +#~ msgstr[0] "Почтовик доставил%d письмо." +#~ msgstr[1] "Почтовик доставил%d письма." +#~ msgstr[2] "Почтовик доставил%d писем." + +#~ msgid "View the log" +#~ msgstr "Просмотреть журнал" + +#~ msgctxt "Page Title" +#~ msgid "Manual Configuration" +#~ msgstr "Ручная настройка" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Account" +#~ msgstr "Учетная запись" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Message" +#~ msgstr "Сообщение" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Logging" +#~ msgstr "Протоколирование" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Advanced" +#~ msgstr "Расширенные настройки" + +#~ msgid "Delete plugin settings" +#~ msgstr "Удалить настройки" + +#~ msgid "This will purge all of Postman's settings, including account credentials and the mail log." +#~ msgstr "В результате будут безвозвратно удалены все настройки Почтовика, включая настройки серверов и журнал." + +#~ msgctxt "Button Label" +#~ msgid "Delete All Data" +#~ msgstr "Удалить все данные" + +#~ msgctxt "The port number" +#~ msgid "Port %s" +#~ msgstr "Порт %s" + +#~ msgctxt "Authentication Type" +#~ msgid "None" +#~ msgstr "Нет" + +#~ msgid "* Port 443 tests against googleapis.com, not the SMTP hostname you enter." +#~ msgstr "* Порт 443 не прошел проверку googleapis.com, не указано имя хоста SMTP." + +#~ msgid "A port with Service Available \"No\" indicates one or more of these issues:" +#~ msgstr "Недоступность портов означает наличие одной или более из этих проблем:" + +#~ msgid "Your PHP configuration is preventing outbound connections" +#~ msgstr "Настройки PHP не допускают исходящие соединения" + +#~ msgid "Your WordPress configuration is preventing outbound connections" +#~ msgstr "Настройки WordPress не допускают исходящие соединения" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "configure manually" +#~ msgstr "настройка вручную" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup Wizard" +#~ msgstr "Мастер установки Почтовика" + +#~ msgid "Warning: If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems." +#~ msgstr "Внимание: Если вы являетесь владельцем этого домена, убедитесь, что он имеет запись SPF, разрешающие GoDaddy быть ретранслятором, иначе у вас возникнут проблемы с доставкой почты." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will the connection to the MSA be established?" +#~ msgstr "Каким образом будет устанавливаться подключение к MSA?" + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will you prove your identity to the MSA?" +#~ msgstr "Каким образом будет происходить ваша идентификация на MSA?" + +#~ msgid "Examine the SMTP Session Transcript if you need to." +#~ msgstr "Если необходимо, изучите расшифровку сессии SMTP." + +#~ msgid "SMTP Session Transcript" +#~ msgstr "Расшифровка сессии SMTP." diff --git a/Postman/languages/postman-smtp-tr_TR.mo b/Postman/languages/postman-smtp-tr_TR.mo new file mode 100644 index 0000000..c4d5b12 Binary files /dev/null and b/Postman/languages/postman-smtp-tr_TR.mo differ diff --git a/Postman/languages/postman-smtp-tr_TR.po b/Postman/languages/postman-smtp-tr_TR.po new file mode 100644 index 0000000..bd8ca6d --- /dev/null +++ b/Postman/languages/postman-smtp-tr_TR.po @@ -0,0 +1,2381 @@ +# Copyright (C) 2015 Postman SMTP +# This file is distributed under the same license as the Postman SMTP package. +msgid "" +msgstr "" +"Project-Id-Version: Postman SMTP 1.5.7\n" +"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/postman-smtp\n" +"POT-Creation-Date: 2015-11-08 17:12-0500\n" +"PO-Revision-Date: 2015-11-09 01:27-0500\n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: tr_TR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=1; plural=0;\n" +"X-Generator: Poedit 1.8.6\n" +"X-Poedit-SourceCharset: UTF-8\n" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:94 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:348 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:357 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:99 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:545 +#: Postman/PostmanViewController.php:227 +msgid "Warning" +msgstr "Uyarı" + +#. translators: where %s is the name of the SMTP server +#: Postman/Postman-Configuration/PostmanConfigurationController.php:96 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +msgid "connected to %1$s instead of %2$s." +msgstr "%1$s %2$s yerine bağlı." + +#. translators: where %d is a port number +#: Postman/Postman-Configuration/PostmanConfigurationController.php:98 +msgid "You are about to configure OAuth 2.0 with an IP address instead of a domain name. This is not permitted. Either assign a real domain name to your site or add a fake one in your local host file." +msgstr "OAuth 2.0 için alanadı yerine IP adresi kullanmaya çalışıyorsunuz. Bu mümkün değildir. Gerçek bir alanadı belirtebilir ya da yalnızca localhost'unuz için gerçek olmayan bir alanadı kullanmanız gerekmektedir." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/PostmanViewController.php:53 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "%s Setup" +msgstr "%s Ayarları" + +#. Plugin Name of the plugin/theme +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:57 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:70 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:176 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/Postman.php:61 Postman/PostmanViewController.php:53 +#: Postman/PostmanViewController.php:54 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "Postman SMTP" +msgstr "Postman SMTP" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:196 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:81 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 Postman/Postman.php:316 +#: Postman/PostmanAdminController.php:225 +msgid "Settings" +msgstr "Seçenekler" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:198 +msgid "Account" +msgstr "Hesap" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:199 +msgid "Message" +msgstr "Mesaj" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:200 +msgid "Logging" +msgstr "Kayıt" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:201 +msgid "Advanced" +msgstr "Geliştirilmiş" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:263 +msgid "Setup Wizard" +msgstr "Kurulum Sihirbazı" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:296 +msgctxt "Wizard Step Title" +msgid "Import Configuration" +msgstr "Ayarları İçeri Aktar" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:298 +msgctxt "Wizard Step Title" +msgid "Import configuration from another plugin?" +msgstr "Ayarları diğer eklentiden aktar?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:299 +msgid "If you had a working configuration with another Plugin, the Setup Wizard can begin with those settings." +msgstr "Diğer bir çalışan eklentiniz varsa, Kurulum Sihirbazı tüm ayarlarınızı içeri aktaracaktır." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:301 +#: Postman/Postman-Mail/PostmanModuleTransport.php:720 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:425 +msgid "None" +msgstr "Hiçbiri" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:312 +msgctxt "Wizard Step Title" +msgid "Sender Details" +msgstr "Gönderen Bilgisi" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:314 +msgctxt "Wizard Step Title" +msgid "Who is the mail coming from?" +msgstr "Email kimden gidecek?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:315 +msgid "Enter the email address and name you'd like to send mail as." +msgstr "Lütfen gönderen email adresi ve ismi belirtiniz." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:316 +msgid "Please note that to prevent abuse, many email services will not let you send from an email address other than the one you authenticate with." +msgstr "Lütfen şunu da not edin, birçok email servisi asla kendi emailizden farklı bir email adına gönderim yapmanıza izin vermez." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:317 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:49 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:112 +msgid "Email Address" +msgstr "E-Mail Adresi." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:320 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:59 +msgid "Name" +msgstr "Adı" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:325 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:143 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:331 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:542 +msgid "Outgoing Mail Server Hostname" +msgstr "SMTP Sunucusu" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:333 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:138 +#: Postman/PostmanViewController.php:294 +msgid "Connectivity Test" +msgstr "Bağlantı Testi" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:335 +msgid "How will the connection to the mail server be established?" +msgstr "Giden Posta Sunucusu'na nasıl bağlanılacak?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:336 +msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows." +msgstr "Bağlantı ayarlarınızı ne e-posta servis sağlayıcınıza sunar ve ne senin WordPress ana verir bağlıdır." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +msgctxt "TCP Port Test Status" +msgid "Ready" +msgstr "Hazır" + +#. Translators: Where %1$s is the socket identifier and %2$s is the +#. authentication type +#: Postman/Postman-Configuration/PostmanConfigurationController.php:345 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgctxt "A socket is the network term for host and port together" +msgid "Socket" +msgstr "Soket" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:346 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:354 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:223 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:177 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:351 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:356 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:372 +msgid "Authentication" +msgstr "Kimlik Doğrulama Ayarları" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:349 +msgid "This configuration option will send your authorization credentials in the clear." +msgstr "Bu yapılandırma seçeneği açık yetkilendirme kimlik bilgileri gönderir." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:356 +msgid "How will you prove your identity to the mail server?" +msgstr "Kendinizi Giden Posta Sunucusu'na nasıl tanıtacaksınız?" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:363 +msgctxt "The final step of the Wizard" +msgid "Finish" +msgstr "Tamamla" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:365 +msgctxt "Wizard Step Title" +msgid "You're Done!" +msgstr "Harika!" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:367 +msgid "Click Finish to save these settings, then:" +msgstr "Tamamla butonuna basarak tüm ayarlarınızı kaydedin, sonra:" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:369 +msgid "Grant permission with the Email Provider for Postman to send email and" +msgstr "Email hizmeti aldığınız servisten Postman'a yetki verinki email gönderebilsin." + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:370 +msgid "Send yourself a Test Email to make sure everything is working!" +msgstr "Ve unutmadan kendinize Test Email'i göndererek herşeyin yolunda olup olmadığına bakın!" + +#. translators: where %s is the URL to the Connectivity Test page +#: Postman/Postman-Configuration/PostmanConfigurationController.php:514 +msgid "Postman can't find any way to send mail on your system. Run a connectivity test." +msgstr "Postman sisteminizden email gönderemiyor. Lütfen buraya tıklayarak bağlantı testi yapın." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:33 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Transport" +msgstr "İçe Aktarma" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:38 +msgctxt "(i.e.) What kind is it?" +msgid "Type" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:44 +msgctxt "The Message Sender Email Address" +msgid "From Address" +msgstr "İleti Gönderen Adresi" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:70 +msgid "Additional Email Addresses" +msgstr "Ek Email Adresleri" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:75 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:220 +msgid "Reply-To" +msgstr "Yanıt" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:80 +msgid "To Recipient(s)" +msgstr "Alıcı(lar)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:85 +msgid "Carbon Copy Recipient(s)" +msgstr "Karbon Kopya Alıcı(lar)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:90 +msgid "Blind Carbon Copy Recipient(s)" +msgstr "Gizli Alıcı(lar)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:96 +msgid "Additional Headers" +msgstr "Ek Üstbilgiler" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:101 +msgid "Custom Headers" +msgstr "Özel Üstbilgiler" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:107 +msgid "Validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:118 +msgid "Email Log Settings" +msgstr "E-posta günlüğü ayarları" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:123 +msgid "Enable Logging" +msgstr "Etkinleştir" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:128 +#: Postman/PostmanInputSanitizer.php:137 +msgid "Maximum Log Entries" +msgstr "Günlük girişleri sınırlama" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:133 +msgid "Maximum Transcript Size" +msgstr "Transkript boyutu (Toplam satır)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:139 +msgid "Network Settings" +msgstr "Network Ayarları" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:144 +msgctxt "Configuration Input Field" +msgid "TCP Connection Timeout (sec)" +msgstr "TCP Bağlantı Zaman Aşımı (sn)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:149 +msgctxt "Configuration Input Field" +msgid "TCP Read Timeout (sec)" +msgstr "TCP Tanımlama Zaman Aşımı (sn)" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:155 +msgctxt "Configuration Section Title" +msgid "Miscellaneous Settings" +msgstr "Diğer Ayarlar" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:160 +msgctxt "Configuration Input Field" +msgid "PHP Log Level" +msgstr "Hata Kaydı" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:165 +msgctxt "Configuration Input Field" +msgid "Delivery Mode" +msgstr "Teslimat modu" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:170 +msgctxt "This mode removes the Postman X-Mailer signature from emails" +msgid "Stealth Mode" +msgstr "Gizli modu" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:175 +msgid "Temporary Directory" +msgstr "Geçici Dizin" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:186 +msgid "Choose SMTP or a vendor-specific API:" +msgstr "SMTP veya satıcıya özel API seçin:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:189 +msgid "Configure the delivery audit log:" +msgstr "Teslimat denetim günlüğünü yapılandırın:" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:196 +msgid "This address, like the letterhead printed on a letter, identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Other plugins, especially Contact Forms, may override this field to be your visitor's address." +msgstr "Bir mektup basılmış Antetli Kağıt gibi bu adresi alıcı gönderene tanımlar. Örneğin Google’nın Posta gönder özelliğini kullanmak için başkasının adına gönderirken bu değiştirin. Diğer eklentileri, özellikle ilgili kişi formlarınızı, ziyaretçinizin adres olarak bu alan geçersiz kılabilir." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:203 +msgid "Separate multiple to/cc/bcc recipients with commas." +msgstr "Virgül ile ayırarak to/cc/bcc bölümlerine fazla kişi ekleyebilirsiniz." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:210 +msgid "Increase the timeouts if your host is intermittenly failing to send mail. Be careful, this also correlates to how long your user must wait if the mail server is unreachable." +msgstr "Eğer sunucunuz email gönderiminde kesintiler yaşıyorsa bu limiti arttırınız. Dikkat, bu durum aynı zamanda sunucunuzun kullanıcı bekletme süresiyle bağlantılıdır." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:221 +msgid "Specify custom headers (e.g. X-MC-Tags: wordpress-site-A), one per line. Use custom headers with caution as they can negatively affect your Spam score." +msgstr "Her satıra bir adet olmak koşuluyla özel üstbilgi girebilirsiniz (örn: X-MC-Tags: wordpress-site-A). Özel üstbilgi girmeniz bazen Spam gönderim skorunuzu olumsuz yönde etkileyebilir." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:228 +msgid "E-mail addresses can be validated before sending e-mail, however this may fail with some newer domains." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:254 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:276 +msgid "Prevent plugins and themes from changing this" +msgstr "Eklentileri ve temaları bu değiştirmelerini engelleme" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:261 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:405 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:244 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:195 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:409 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:416 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:459 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:467 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:475 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:482 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:530 +msgid "Required" +msgstr "Zorunlu" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:268 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:531 +msgid "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +msgstr "Bir zarfı yazdırabilirsiniz İade adresi gibi bu adresi SMTP sunucusuna hesap sahibi tanımlar." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:289 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:108 +msgid "Yes" +msgstr "Evet" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:290 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:109 +msgid "No" +msgstr "Hayır" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:300 +msgid "Change this value if you can't see the beginning of the transcript because your messages are too big." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:343 +msgid "Disable e-mail validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:350 +msgid "Log Level specifies the level of detail written to the WordPress Debug log - view the log with Debug." +msgstr "Günlük düzeyini WordPress günlüğüne ayrıntı düzeyini belirtir - Debugile günlüğünü görüntüleme. Teslimat modu geliştirme veya sınama için yararlı seçenekleri sunar." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:353 +msgid "Off" +msgstr "Kapalı" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:354 +msgid "Trace" +msgstr "Trace" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:355 +msgid "Debug" +msgstr "Hata Çözümle" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:356 +msgid "Info" +msgstr "Bilgilendirme" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:358 +msgid "Error" +msgstr "Hata" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:366 +msgid "Delivery mode offers options useful for developing or testing." +msgstr "Teslimat modu geliştirme veya sınama için yararlı seçenekleri sunar." + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:369 +msgctxt "When the server is online to the public, this is \"Production\" mode" +msgid "Log Email and Send" +msgstr "Üretim" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:370 +msgid "Log Email and Delete" +msgstr "E-posta giriş, o zaman dökümü" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:371 +msgid "Delete All Emails" +msgstr "Herşeyi Sıfırla" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:375 +msgid "Remove the Postman X-Header signature from messages" +msgstr "Postacı X-üstbilgi imzası gelen iletileri kaldırma" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:378 +msgid "Lockfiles are written here to prevent users from triggering an OAuth 2.0 token refresh at the same time." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:381 +msgid "Valid" +msgstr "Geçerli" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:383 +msgid "Invalid" +msgstr "Geçersiz" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:105 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:109 +msgctxt "The \"please wait\" message" +msgid "Checking.." +msgstr "Kontrol ediliyor.." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:106 +msgctxt "The port is open" +msgid "Open" +msgstr "Açık" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:107 +msgctxt "The port is closed" +msgid "Closed" +msgstr "Kapalı" + +#. translators: where %d is a port number +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:111 +msgid "No outbound route between this site and the Internet on Port %d." +msgstr "Bu site ve Internet üzerinde %d bağlantı arasında giden bir yol yok." + +#. translators: where %d is a port number and %s is a hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:113 +msgid "Port %d is open, but not to %s." +msgstr "%D bağlantı noktası açık, ancak değil %s." + +#. translators: where %d is the port number and %s is the hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:115 +msgid "Port %d can be used for SMTP to %s." +msgstr "%d portunu kullanarak %s sunucusundan SMTP için gönderim yapabilirsiniz." + +#. translators: where %d is a port number and %s is the URL for the Postman +#. Gmail Extension +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:118 +msgid "Port %d can be used with the %s." +msgstr "%s ile %d portunu kullanarak email ile gönderim yapabilirsiniz." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:141 +msgid "This test determines which well-known ports are available for Postman to use." +msgstr "Bu test Postman'ın kullanabileceği kullanımı yaygın portları taramak içindir." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:145 +msgctxt "Button Label" +msgid "Begin Test" +msgstr "Testi Başlat" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:162 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:152 +msgid "Status" +msgstr "Durum" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Service Available" +msgstr "Servis Kullanılabilir" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Server ID" +msgstr "" + +#. Translators: Meaning "Not Applicable" +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:155 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:260 +msgid "n/a" +msgstr "yok" + +#. Translators: Where %s is the name of the service providing Internet +#. connectivity test +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:160 +msgid "According to %s" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:163 +msgid "Summary" +msgstr "Özet" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:168 +msgid "A test with \"No\" Service Available indicates one or more of these issues:" +msgstr "Kapalı port:" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:170 +msgid "Your web host has placed a firewall between this site and the Internet" +msgstr "Hosting hesabınızda site ile SMTP server arasında güvenlik duvarı var." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:171 +msgid "The SMTP hostname is wrong or the mail server does not provide service on this port" +msgstr "SMTP ana bilgisayar adı yanlış ya da posta sunucusunun bu bağlantı noktasında hizmet sağlamaz" + +#. translators: where (1) is the URL and (2) is the system +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:173 +msgid "Your %2$s configuration is preventing outbound connections" +msgstr "%2$s ayarlarınız dışarıya giden bağlantıları önlüyor (allow-url-fopen)" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:177 +msgid "If the issues above can not be resolved, your last option is to configure Postman to use an email account managed by your web host with an SMTP server managed by your web host." +msgstr "Yukarıdaki sorunlar çözülmüş değil, son seçenek postacı web barındırıcınız tarafından yönetilen bir SMTP sunucusu ile web barındırıcınız tarafından yönetilen bir e-posta hesabı kullanacak şekilde yapılandırmak olduğunu." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:82 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman.php:317 +msgctxt "The log of Emails that have been delivered" +msgid "Email Log" +msgstr "E-posta günlüğü" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:95 +msgid "Error: Postman is missing a required PHP library." +msgstr "Postman gerek duyduğu bir PHP kütüphanesine ulaşamıyor." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:97 +#: Postman/Postman.php:257 +msgid "Postman: wp_mail has been declared by another plugin or theme, so you won't be able to use Postman until the conflict is resolved." +msgstr "Postman başarıyla kuruldu, fakat şu anda farklı bir mail servisi kullanıyorsunuz. Diğer eklentiyi deaktif ediniz." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:100 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:229 +msgid "Postman is in non-Production mode and is dumping all emails." +msgstr "Postacı Olmayan üretim modunda ise ve tüm e-postalar atıyor." + +# turkish doesn’t has s letter on calculations ;) +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:102 +msgid "Postman is configured and has delivered %d email." +msgid_plural "Postman is configured and has delivered %d emails." +msgstr[0] "Postman ayarlandı ve %d adet emaili başarıyla gönderdi." + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:104 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:234 +msgid "Postman is not configured and is mimicking out-of-the-box WordPress email delivery." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:116 +msgid "Postman is operating in per-site mode." +msgstr "Postacı site başına modunda çalışıyor." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:102 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:107 +#: Postman/PostmanViewController.php:295 +msgid "Diagnostic Test" +msgstr "Tanılama bilgisi" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:104 +msgid "Are you having issues with Postman?" +msgstr "Postman ile alakalı sorununuz var mı?" + +#. translators: where %1$s and %2$s are the URLs to the Troubleshooting and +#. Support Forums on WordPress.org +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:106 +msgid "Please check the troubleshooting and error messages page and the support forum." +msgstr "Lütfen hata ve sorun çözme sayfası ya da destek forumlarına göz atın." + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:108 +msgid "If you write for help, please include the following:" +msgstr "Yardım almak için lütfen tanı bilgisini de foruma yazınız:" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:90 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:242 +msgid "Your message was delivered (%d ms) to the SMTP server! Congratulations :)" +msgstr "Mesajınız SMTP sunucusuna gönderildi (%d ms)! Tebrikler :)" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:156 +msgid "Mail Log Entries were deleted." +msgstr "Posta günlük girdileri silindi." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:179 +msgid "Mail Log Entry was deleted." +msgstr "Posta günlük girdisi silindi." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:204 +msgctxt "Who is this message From?" +msgid "From" +msgstr "Şundan" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:208 +msgctxt "Who is this message To?" +msgid "To" +msgstr "Şuraya" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:212 +msgctxt "Who is this message Cc'd to?" +msgid "Cc" +msgstr "Cc" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:216 +msgctxt "Who is this message Bcc'd to?" +msgid "Bcc" +msgstr "Bcc" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:222 +msgctxt "What is the date today?" +msgid "Date" +msgstr "Tarih" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:223 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:161 +msgctxt "What is the subject of this message?" +msgid "Subject" +msgstr "Konu" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:226 +msgctxt "What is the unique URI of the configuration?" +msgid "Delivery-URI" +msgstr "Teslimat-URI" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:253 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:161 +msgid "This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +msgstr "SMTP sunucunuz ve Postman arasındaki diyaloğu buradan takip edebilirsiniz. Bu sorunların teşhisinde size yol gösterebilir. DİKKAT bunu herhangi biriyle paylaşmayın. İçerisinde size özel gizli anahtar (şifre) bilgileri olabilir." + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +msgid "%s Email Log" +msgstr "%s Email Logu" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:301 +msgid "Email was successfully resent (but without attachments)" +msgstr "" + +#. Translators: Where %s is an error message +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:303 +msgid "Email could not be resent. Error: %s" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:304 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:110 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:112 +msgid "Resend" +msgstr "Yeniden gönder" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:339 +msgid "This is a record of deliveries made to the mail server. It does not neccessarily indicate sucessful delivery to the recipient." +msgstr "Bu posta teslimi Aracısı (MSA) yapılan teslim girişimleri kaydıdır. Sucessful alıcıya teslim için mutlaka göstermez." + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:37 +msgctxt "The group of Emails that have been delivered" +msgid "Sent Emails" +msgstr "Gönderilen e-posta" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:38 +msgctxt "An Email that has been delivered" +msgid "Sent Email" +msgstr "Gönderilen e-posta" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +msgid "An empty subject line can result in delivery failure." +msgstr "Bir boş konu satırı teslimat başarısızlıkla sonuçlanabilir." + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:196 +msgid ".. +%d more" +msgstr ".. ve %d daha fazla." + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:99 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:223 +msgctxt "Delete an item from the email log" +msgid "Delete" +msgstr "Sil" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:100 +msgctxt "View an item from the email log" +msgid "View" +msgstr "Görüntüle" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:104 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:106 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:158 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:163 +msgid "Session Transcript" +msgstr "Durum Detayı" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:163 +msgctxt "When was this email sent?" +msgid "Delivery Time" +msgstr "Teslimat" + +#. Translators: where %s indicates the relative time from now +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:332 +msgctxt "A relative time as in \"five days ago\"" +msgid "%s ago" +msgstr "%s önce" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:338 +msgid "Sent" +msgstr "Gönderildi" + +#: Postman/Postman-Mail/PostmanDefaultModuleTransport.php:107 +msgid "Default" +msgstr "Öntanımlı" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:102 +msgid "Gmail API" +msgstr "Gmail API" + +#. translators: where (1) is the secure icon and (2) is the transport name +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:152 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:135 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:79 +msgid "Postman will send mail via the %1$s %2$s." +msgstr "Postman emailleri %1$s %2$s'ın kimlik doğrulama metodu ile gönderecek." + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:166 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:117 +msgid "You have configured OAuth 2.0 authentication, but have not received permission to use it." +msgstr "OAuth 2.0 konfigürasyonunu yaptınız ancak henüz gönderim için yetkilendirilmediniz." + +#. translators: where variables are (1) transport name (2) host and (3) port +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:206 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:181 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:125 +msgid "Postman recommends the %1$s to host %2$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:221 +#: Postman/Postman-Mail/PostmanModuleTransport.php:713 +msgid "OAuth 2.0 (requires Client ID and Client Secret)" +msgstr "OAuth 2.0 (müşteri kimliği ve istemci gizli gerektirir)" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:44 +msgid "Mandrill API" +msgstr "Mandrill API" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:147 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:101 +msgid "API Key can not be empty" +msgstr "" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:151 +#: Postman/Postman-Mail/PostmanModuleTransport.php:578 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:105 +msgid "Message From Address can not be empty" +msgstr "Zarf gönderici adresi ve ileti gönderen adresi boş olamaz." + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:194 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:228 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:271 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:148 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:182 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:222 +msgid "API Key" +msgstr "" + +#. Translators: Where (1) is the service URL and (2) is the service name and +#. (3) is a api key URL +#: Postman/Postman-Mail/PostmanMandrillTransport.php:238 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:189 +msgid "Create an account at %2$s and enter an API key below." +msgstr "" + +#. translators: where (1) is the transport type, (2) is the host, and (3) is +#. the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 +#. using OAuth 2.0 authentication.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:506 +msgid "Postman will send mail via %1$s to %2$s using %3$s authentication." +msgstr "Postman %1$s adresinden %2$s adresine %3$s metoduyla email gönderecek." + +#. translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s +#. is the encryption type (e.g. SSL or TLS) +#: Postman/Postman-Mail/PostmanModuleTransport.php:534 +msgctxt "as in \"There is no Spoon\"" +msgid "no" +msgstr "hayir" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:553 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:366 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:584 +msgid "Password" +msgstr "Şifre" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:584 +msgid "OAuth 2.0 authentication requires a %1$s and %2$s." +msgstr "OAuth 2.0 metodu işlemi %1$s ve %2$s (şifre) istemekte." + +#: Postman/Postman-Mail/PostmanModuleTransport.php:706 +msgid "Password (requires username and password)" +msgstr "Şifre (kullanıcı adı ve parola gerekli)" + +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 +msgid "MyMail: Change the delivery method in the %s!" +msgstr "" + +#: Postman/Postman-Mail/PostmanSendGridTransport.php:39 +msgid "SendGrid API" +msgstr "SendGrid API" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:95 +msgid "Outgoing Mail Server Hostname and Port can not be empty." +msgstr "Giden Mail Sunucusu (SMTP) ve Port belirtmeniz gerekmektedir, boş bırakılamaz." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:99 +msgid "Envelope-From Email Address can not be empty" +msgstr "Zarf gönderici adresi ve ileti gönderen adresi boş olamaz." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:103 +msgid "Username and password can not be empty." +msgstr "Şifre metodu (Plain/Login/CRAMMD5) için kullanıcı adı ve şifre belirtmeniz gerekmektedir." + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:109 +msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server." +msgstr "OAuth 2.0 metodu ile gönderim için OAuth 2.0 destekleyen bir Giden Mail Sunucusu." + +#. translators: where %1$s is a description of the transport (eg. SMTPS-SSL), +#. %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is +#. the TCP port (eg. 465), %4$d is the hostname +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:269 +msgid "Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:326 +msgid "Transport Settings" +msgstr "İçe Aktarım Ayarları" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:336 +msgid "Outgoing Mail Server Port" +msgstr "SMTP Portu" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:341 +msgid "Envelope-From Email Address" +msgstr "Zarf Gönderici Adresi" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:346 +msgctxt "Configuration Input Field" +msgid "Security" +msgstr "Güvenlik" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:361 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:580 +msgid "Username" +msgstr "Kullanıcı Adı" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:402 +msgid "Configure the communication with the mail server." +msgstr "Kimlik doğrulama metodunu seçip SMTP sunucu ve port bilgilerini giriniz:" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:449 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:579 +msgid "Enter the account credentials." +msgstr "Email göndermek için kullanıcı adınızı (ya da email adresi) ve şifrenizi giriniz" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:457 +msgid "The Username is usually the same as the Envelope-From Email Address." +msgstr "Kullanıcı adınız genellikle email adresinizdir." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:511 +msgid "Error computing your domain root - please enter it manually" +msgstr "Domain adından dizin alınırken hata oluştu - lütfen el ile giriniz" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:532 +msgid "For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:539 +msgctxt "Wizard Step Title" +msgid "Which host will relay the mail?" +msgstr "Hangi sunucudan gönderim yapılacak?" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:540 +msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. This server is specific to your email account, and if you don't know what to use, ask your email service provider." +msgstr "Giden (SMTP) posta sunucusu veya posta gönderme aracı (MSA), hangi postacı delege teslimatı için posta bu. Bu sunucu e-posta hesabınıza özgü ve kullanımı ne bilmiyorsanız, e-posta servis sağlayıcınıza sorun." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:541 +msgid "Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, require that you use their mail accounts with their mail servers, and prevent you from using others." +msgstr "Not GoDaddy, Bluehost ve Dreamhost, gibi birçok WordPress ana posta hesaplarını kendi posta sunucularıyla kullanmak ve başkalarının kullanmasını engellemek gerekir." + +#. Translators: Where (%s) is the name of the web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:547 +msgid "Your email address requires access to a remote SMTP server blocked by %s." +msgstr "%s tarafından engellenen bir uzak SMTP sunucusunun e-posta adresi gerektirir erişim." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:548 +msgid "If you have access to cPanel, enable the Remote Mail Exchanger." +msgstr "" + +#. Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the +#. web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:551 +msgid "If you own this domain, make sure it has an SPF record authorizing %2$s as a relay, or you will have delivery problems." +msgstr "Bu etki alanına sahipseniz, geçişi olarak bir SPF kaydı %2$s yetkisi var. veya teslim sorunları olacaktır emin olun." + +#: Postman/Postman-Mail/PostmanTransportRegistry.php:231 +msgid "Postman is configured." +msgstr "Postman ayarlandı." + +#: Postman/Postman-Mail/PostmanZendMailEngine.php:209 +msgid "Communication Error [334] - make sure the Envelope From email is the same account used to create the Client ID." +msgstr "Bağlantı Hatası [334] - gönderen email adresinin OAuth 2.0 email gönderimine izin verdiğinden emin olun." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:115 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:149 +msgctxt "Email Test Status" +msgid "In Outbox" +msgstr "Gönderilecek" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:116 +msgctxt "Email Test Status" +msgid "Sending..." +msgstr "Gönderiliyor..." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:117 +msgctxt "Email Test Status" +msgid "Success" +msgstr "Başarılı" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:118 +msgctxt "Email Test Status" +msgid "Failed" +msgstr "Gönderilemedi" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:119 +msgid "Ajax Error" +msgstr "Ajax hata" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:128 +#: Postman/PostmanViewController.php:273 Postman/PostmanViewController.php:275 +msgid "Send a Test Email" +msgstr "Test Emaili Gönder" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:133 +msgid "Specify the Recipient" +msgstr "Alıcı Belirtin" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:135 +msgid "Who is this message going to?" +msgstr "Bu email kime gidiyor?" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:136 +msgid "This utility allows you to send an email message for testing." +msgstr "Bu araç sayesinde test emaili gönderebilirsiniz." + +# turkish doesn’t has s letter on calculations ;) +#. translators: where %d is an amount of time, in seconds +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:139 +msgid "If there is a problem, Postman will give up after %d second." +msgid_plural "If there is a problem, Postman will give up after %d seconds." +msgstr[0] "Eğer bir problem varsa Postman %d saniye sonra vazgeçecek." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:140 +msgctxt "Configuration Input Field" +msgid "Recipient Email Address" +msgstr "Alıcı Email Adresi" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:145 +msgid "Send The Message" +msgstr "Gönder" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:148 +msgid "Sending the message:" +msgstr "Email gönderiliyor:" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:160 +msgid "Examine the Session Transcript if you need to." +msgstr "İhtiyacınız olması durumunda SMTP Durum Detayını inceleyebilirsiniz." + +#. translators: where %s is the domain name of the site +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:212 +msgctxt "Test Email Subject" +msgid "Postman SMTP Test (%s)" +msgstr "Postman SMTP Test (%s)" + +#. translators: where %s is the Postman plugin version number (e.g. 1.4) +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:299 +msgctxt "Test Email Tagline" +msgid "Sent by Postman %s" +msgstr "Postman %s tarafından gönderildi" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:300 +msgid "Image source" +msgstr "Resim kaynağı" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:301 +msgid "Used with permission" +msgstr "Izni ile kullanılır" + +#: Postman/PostmanAdminController.php:111 +msgctxt "The plugin successfully saved new settings." +msgid "Settings saved." +msgstr "Ayarlar kaydedildi." + +#. Translators: where %1$s is the name of the library +#: Postman/PostmanAdminController.php:178 +msgid "This PHP installation requires the %1$s library." +msgstr "Postman gerek duyduğu bir PHP kütüphanesine ulaşamıyor %1$s." + +#: Postman/PostmanAdminController.php:253 +msgid "There was an error importing the data." +msgstr "" + +#: Postman/PostmanAdminController.php:270 +msgid "Plugin data was removed." +msgstr "Tüm ayarlar sıfırlandı." + +#: Postman/PostmanAdminController.php:294 +msgid "The OAuth 2.0 authorization was successful. Ready to send e-mail." +msgstr "OAuth 2.0 yetkilendirmesi başarılı oldu. E-posta göndermek için hazır." + +#: Postman/PostmanAdminController.php:296 +msgid "Your email provider did not grant Postman permission. Try again." +msgstr "Email servis sağlayınız Postman'a izin vermiyor. Tekrar deneyin." + +#: Postman/PostmanAdminController.php:299 +msgid "The grant code from Google had no accompanying state and may be a forgery" +msgstr "Google onay kodu hatalı ya da ortada bir yanlış anlaşılma var." + +#. translators: %s is the error message +#: Postman/PostmanAdminController.php:303 +msgid "Error authenticating with this Client ID. [%s]" +msgstr "Hata bu istemci kimliği doğrulama [%s]" + +#: Postman/PostmanConfigTextHelper.php:31 +msgid "Attention" +msgstr "Dikkat" + +#. translators: parameters available are 1=portal-url, 2=portal-name, +#. 3=clientId-name, 4=clientSecret-name, 5=callbackUrl, 6=service-name, +#. 7=portal-application (e.g. Open the Google Developer Console, create a +#. Client ID for web application using the URL's displayed below, and copy the +#. Client ID and Client Secret here.) +#: Postman/PostmanConfigTextHelper.php:33 +msgid "Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +msgstr "%2$s'u açarak %7$s adımından web uygulaması için hesap oluşturduktan sonra %3$s ve %4$s anahtar kodunuzu buraya yapıştırın." + +#. translators: parameters available are 1=clientId-name, 2=service-name, +#. 3=FAQ-URL, 4=Video-URL (e.g. See How do I get a Google Client ID? in the +#. F.A.Q.) +#: Postman/PostmanConfigTextHelper.php:36 +msgid "See How do I get a %1$s %2$s? in the F.A.Q. or watch our How-To video 📺." +msgstr "Bkz: %1$s %2$s nasıl gidebilirim? SSS veya bizim nasıl yapılır video 📺 izlemek." + +#. translators: where %s is the Email Service Owner (e.g. Google, Microsoft or +#. Yahoo) +#: Postman/PostmanConfigTextHelper.php:54 +msgctxt "Command to initiate OAuth authentication" +msgid "Grant permission with %s" +msgstr "%s tarafından izin iste" + +# no need to translate - its generic +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:80 +#: Postman/PostmanConfigTextHelper.php:142 +#: Postman/PostmanConfigTextHelper.php:204 +#: Postman/PostmanConfigTextHelper.php:271 +msgctxt "Name of the OAuth 2.0 Client ID" +msgid "Client ID" +msgstr "Client ID" + +# no need to translate - its generic +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:84 +#: Postman/PostmanConfigTextHelper.php:146 +#: Postman/PostmanConfigTextHelper.php:208 +#: Postman/PostmanConfigTextHelper.php:274 +msgctxt "Name of the OAuth 2.0 Client Secret" +msgid "Client Secret" +msgstr "Client Secret" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:88 +msgctxt "Name of the Application Callback URI" +msgid "Authorized redirect URI" +msgstr "Redirect URI" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:92 +msgctxt "Name of the Application Callback Domain" +msgid "Authorized JavaScript origins" +msgstr "Javascript Origins" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:96 +msgctxt "Name of the email service owner" +msgid "Google" +msgstr "Google" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:100 +msgctxt "Name of the email service" +msgid "Gmail" +msgstr "Gmail" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:104 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "a Client ID for web application" +msgstr "web uygulaması için Client ID" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:108 +msgctxt "Name of the email service portal" +msgid "Google Developers Console Gmail Wizard" +msgstr "Google Developer Konsolu" + +# no need to translate - its generic +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:150 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URL" +msgstr "Redirect URL" + +# no need to translate - its generic +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:154 +msgctxt "Name of the Application Callback Domain" +msgid "Root Domain" +msgstr "Root Domain" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:158 +msgctxt "Name of the email service owner" +msgid "Microsoft" +msgstr "Microsoft" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:162 +msgctxt "Name of the email service" +msgid "Outlook.com" +msgstr "Outlook.com" + +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:166 +#: Postman/PostmanConfigTextHelper.php:228 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "an Application" +msgstr "Uygulaması" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:170 +msgctxt "Name of the email service portal" +msgid "Microsoft Developer Center" +msgstr "Microsoft Developer Merkezi" + +# no need to translate - its generic +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:212 +msgctxt "Name of the Application Callback URI" +msgid "Home Page URL" +msgstr "Home Page URL" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:216 +msgctxt "Name of the Application Callback Domain" +msgid "Callback Domain" +msgstr "Callback Domain" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:220 +msgctxt "Name of the email service owner" +msgid "Yahoo" +msgstr "Yahoo" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:224 +msgctxt "Name of the email service" +msgid "Yahoo Mail" +msgstr "Yahoo Mail" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:232 +msgctxt "Name of the email service portal" +msgid "Yahoo Developer Network" +msgstr "Yahoo Developer Network" + +#: Postman/PostmanConfigTextHelper.php:261 +msgid "Enter an Outgoing Mail Server with OAuth2 capabilities." +msgstr "OAuth2 desteği olan bir Giden Mail Sunucusu belirtiniz." + +# no need to translate - its generic +#: Postman/PostmanConfigTextHelper.php:277 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URI" +msgstr "Redirect URI" + +#: Postman/PostmanConfigTextHelper.php:280 +msgctxt "Name of the Application Callback Domain" +msgid "Website Domain" +msgstr "Callback Domain Adresi" + +#: Postman/PostmanConfigTextHelper.php:304 +msgid "Grant OAuth 2.0 Permission" +msgstr "OAuth 2.0 Yetki Ver" + +#: Postman/PostmanInputSanitizer.php:137 +msgid "must be greater than 0" +msgstr "0’dan büyük olmalıdır" + +#: Postman/PostmanViewController.php:112 +msgid "An unexpected error occurred" +msgstr "" + +#: Postman/PostmanViewController.php:113 +msgid "Unexpected PHP messages corrupted the Ajax response" +msgstr "Beklenmeyen PHP Ajax tepki mesajları bozuk:" + +#: Postman/PostmanViewController.php:118 +msgctxt "Press this button to Finish this task" +msgid "Finish" +msgstr "Bitir" + +#: Postman/PostmanViewController.php:119 +msgctxt "Press this button to go to the next step" +msgid "Next" +msgstr "Sonraki" + +#: Postman/PostmanViewController.php:120 +msgctxt "Press this button to go to the previous step" +msgid "Previous" +msgstr "Geri" + +#: Postman/PostmanViewController.php:132 +msgid "Postman is unable to run. Email delivery is being handled by WordPress (or another plugin)." +msgstr "Şu anda WordPress (veya başka bir eklenti) e-posta dağıtımı, değil Postman." + +#. translators: where %d is the number of emails delivered +#: Postman/PostmanViewController.php:147 +msgid "Postman has delivered %d email." +msgid_plural "Postman has delivered %d emails." +msgstr[0] "Postman %d e-posta teslim etti." + +#: Postman/PostmanViewController.php:150 +msgid "The last %d email attempts are recorded in the log." +msgstr "Son %d e-posta girişimleri günlüğüne." + +#: Postman/PostmanViewController.php:155 +msgid "Thank-you for choosing Postman!" +msgstr "Postman'ı seçtiğiniz için teşekkür ederiz!" + +#. translators: where %s is the URL of the Setup Wizard +#: Postman/PostmanViewController.php:157 +msgid "Let's get started! All users are strongly encouraged to run the Setup Wizard." +msgstr "Haydi başlayalım! Tüm yeni kullanıcılarımıza önerimiz Hızlı Kurulum Sihirbazını başlatmaları." + +#: Postman/PostmanViewController.php:158 +msgid "Alternately, manually configure your own settings and/or modify advanced options." +msgstr "Alternatif olarak, el ile yapılandırmanız , kendi ayarlarını ve/veya gelişmiş seçenekleri değiştirebilirsiniz." + +#. translators: where %s is the URL to the WordPress.org review and ratings +#. page +#: Postman/PostmanViewController.php:163 +msgid "Please consider leaving a review to help spread the word! :D" +msgstr "Eğer bu ücretsiz ve tatlı hizmetimizi sevdiyseniz buraya tıklayarak
    yorum eklerseniz çok seviniriz. Bu sayede birçok insan WordPress için bu yeni servisi tanır! :D" + +#: Postman/PostmanViewController.php:165 +msgid "Postman needs translators! Please take a moment to translate a few sentences on-line" +msgstr "" + +#: Postman/PostmanViewController.php:167 +msgid "New for v1.7! Send mail with the Mandrill or SendGrid APIs." +msgstr "" + +#: Postman/PostmanViewController.php:191 +msgctxt "Return to main menu link" +msgid "Back To Main Menu" +msgstr "Ana Menüye Dön" + +#: Postman/PostmanViewController.php:198 Postman/PostmanViewController.php:233 +#: Postman/PostmanViewController.php:284 +msgid "Import" +msgstr "İçeri Aktar" + +#: Postman/PostmanViewController.php:199 Postman/PostmanViewController.php:285 +msgid "Export" +msgstr "Dışarı Aktar" + +#: Postman/PostmanViewController.php:200 Postman/PostmanViewController.php:286 +msgid "Reset Plugin" +msgstr "Eklentiyi Sıfırla" + +#: Postman/PostmanViewController.php:206 +msgid "Copy this data into another instance of Postman to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:225 +msgid "Paste data from another instance of Postman here to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:228 +msgid "Using the same OAuth 2.0 Client ID and Client Secret from this site at the same time as another site will cause failures." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "This will purge all of Postman's settings, including account credentials and the email log." +msgstr "Bu yaptığınız tüm Postman ayarlarını silecektir. SMTP sunucu bilgileri, kullanıcı/şifre ve OAuth bilgileri dahildir." + +#: Postman/PostmanViewController.php:241 +msgid "Are you sure?" +msgstr "Emin misiniz?" + +#: Postman/PostmanViewController.php:261 +msgid "Configuration" +msgstr "Yapılandırma" + +#: Postman/PostmanViewController.php:262 +msgid "Start the Wizard" +msgstr "Kurulum Sihirbazını Başlat" + +#: Postman/PostmanViewController.php:263 +msgid "Show All Settings" +msgstr "el ile ayarla" + +#: Postman/PostmanViewController.php:266 +msgctxt "Main Menu" +msgid "Actions" +msgstr "Eylemler" + +#: Postman/PostmanViewController.php:292 +msgctxt "Main Menu" +msgid "Troubleshooting" +msgstr "Sorun Giderme" + +#: Postman/PostmanViewController.php:296 +msgid "Online Support" +msgstr "Online Destek" + +#. Plugin URI of the plugin/theme +msgid "https://wordpress.org/plugins/postman-smtp/" +msgstr "https://wordpress.org/plugins/postman-smtp/" + +#. Description of the plugin/theme +msgid "Email not reliable? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +msgstr "Email sisteminiz çalışmıyor mu? Postman; Gmail, Hotmail ve Yahoo Mail için OAuth 2.0 destekli ilk WordPress SMTP eklentisidir. Kurulumu ise Kurulum Sihirbazı ve Port Test araçları ile çok basittir. Şifrenizi değiştirseniz dahi kesintisiz email gönderiminin keyfini çıkarın!" + +#. Author of the plugin/theme +msgid "Jason Hendriks" +msgstr "Jason Hendriks" + +#. Author URI of the plugin/theme +msgid "http://www.codingmonkey.ca" +msgstr "http://www.codingmonkey.ca" + +#~ msgid "Change the delivery method on the %s!" +#~ msgstr "Teslimat yöntemini değiştirme %s!" + +#~ msgid "Configure the plugin." +#~ msgstr "Eklentiyi ayarla." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Test Your Setup" +#~ msgstr "Kurulumu Test Edin" + +#~ msgctxt "eg. TCP Port 25" +#~ msgid "Port" +#~ msgstr "Portu" + +#~ msgctxt "as in \"There is no Authentication\"" +#~ msgid "no" +#~ msgstr "hayir" + +#~ msgctxt "Log Level" +#~ msgid "Off" +#~ msgstr "Off" + +#~ msgctxt "Log Level" +#~ msgid "Trace" +#~ msgstr "Trace" + +#~ msgctxt "Log Level" +#~ msgid "Debug" +#~ msgstr "Debug" + +#~ msgctxt "Log Level" +#~ msgid "Info" +#~ msgstr "Info" + +#~ msgctxt "Log Level" +#~ msgid "Warning" +#~ msgstr "Warning" + +#~ msgctxt "Log Level" +#~ msgid "Error" +#~ msgstr "Error" + +#~ msgid "Port %d can be used to send email with the %s." +#~ msgstr "%s ile %d portunu kullanarak email ile gönderim yapabilirsiniz." + +#~ msgid "New for v1.6! Email Log" +#~ msgstr "Yeni v1.6 için! E-posta günlüğü" + +#~ msgid "Enable to save a copy of all your emails. Great for troubleshooting or as a backup for messages that get lost. Access the Email Log in the Tools menu." +#~ msgstr "Tüm e-postalar bir kopyasını kaydetmek için etkinleştirin. Büyük sorun giderme veya kaybolma iletiler için bir yedek olarak. Araçlar menüsünde e-posta günlük erişmek." + +#~ msgctxt "The configuration page of the plugin" +#~ msgid "Settings" +#~ msgstr "Ayarlar" + +#~ msgid "Postman is not handling email delivery." +#~ msgstr "Postman email gönderimlerinizdeki aktif eklenti değil." + +#~ msgctxt "As in type used: None" +#~ msgid "None" +#~ msgstr "Hiçbiri" + +#~ msgctxt "Who do we reply to?" +#~ msgid "Reply-To" +#~ msgstr "Yanıt" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +#~ msgstr "SMTP sunucunuz ve Postman arasındaki diyaloğu buradan takip edebilirsiniz. Bu sorunların teşhisinde size yol gösterebilir. DİKKAT bunu herhangi biriyle paylaşmayın. İçerisinde size özel gizli anahtar (şifre) bilgileri olabilir." + +#~ msgid "Postman Email Log" +#~ msgstr "Postacı e-posta günlüğü" + +#~ msgid "This is a record of deliveries made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Bu posta teslimi Aracısı (MSA) yapılan teslim girişimleri kaydıdır. Sucessful alıcıya teslim için mutlaka göstermez." + +#~ msgid "Warning: An empty subject line can result in delivery failure." +#~ msgstr "Uyarı: Bir boş konu satırı teslimat başarısızlıkla sonuçlanabilir." + +#~ msgctxt "View the transcript of an item from the email log" +#~ msgid "Transcript" +#~ msgstr "Transkript" + +#~ msgctxt "Attempt to resend this email" +#~ msgid "Resend" +#~ msgstr "Yeniden gönder" + +#~ msgctxt "Was sending this email successful or not?" +#~ msgid "Status" +#~ msgstr "Durum" + +#~ msgctxt "Transport Name" +#~ msgid "Gmail API" +#~ msgstr "Gmail API" + +#~ msgctxt "Authentication Type is OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgid "Postman will send mail via the 🔐Gmail API using %s authentication." +#~ msgstr "Postman emailleri 🔐Gmail API'ın %s kimlik doğrulama metodu ile gönderecek." + +#~ msgid "OAuth 2.0 authentication requires a Client ID and Client Secret." +#~ msgstr "OAuth 2.0 metodu işlemi Client ID ve Client Secret (şifre) istemekte." + +#~ msgid "Envelope From Address and Message From Address can not be empty." +#~ msgstr "Zarf gönderici adresi ve ileti gönderen adresi boş olamaz." + +#~ msgid "Postman recommends Gmail API configuration on port %d" +#~ msgstr "Postman Gmail API konfigürasyonu için %d nolu portu ayarlamanızı öneriyor." + +#~ msgctxt "Transport Name" +#~ msgid "SMTP" +#~ msgstr "SMTP" + +#~ msgctxt "As in type used: CRAM-MD5" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "As in type used: Login" +#~ msgid "Login" +#~ msgstr "Login" + +#~ msgctxt "As in type used: Plain" +#~ msgid "Plain" +#~ msgstr "Plain" + +#~ msgctxt "This authentication type is password-based" +#~ msgid "Password (%s)" +#~ msgstr "Şifre (%s)" + +#~ msgid "Password authentication (Plain/Login/CRAM-MD5) requires a username and password." +#~ msgstr "Şifre metodu (Plain/Login/CRAMMD5) için kullanıcı adı ve şifre belirtmeniz gerekmektedir." + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, %1$s, and %2$s." +#~ msgstr "OAuth 2.0 metodu ile gönderim için OAuth 2.0 destekleyen bir Giden Mail Sunucusu, %1$s, ve %2$s." + +#~ msgid "Your recommended settings are %1$s with %2$s authentication to host %4$s on port %3$d." +#~ msgstr "Önerilen ayarları %1$s %2$s host %4$s bağlantı noktası %3$ d üzerinde kimlik doğrulaması ile vardır." + +#~ msgid "The selected transport '%s' is unavailable. The external plugin was probably deactivated." +#~ msgstr "Seçtiğiniz iletim türü kullanılamıyor. Harici eklenti büyük ihtimalle devre dışı." + +#~ msgid "WordPress is still handling email delivery, not Postman." +#~ msgstr "Postman email gönderimlerinizdeki aktif eklenti değil." + +#~ msgctxt "The Transport is the method for sending mail, SMTP or API" +#~ msgid "Transport" +#~ msgstr "İçe Aktarma" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport Settings" +#~ msgstr "İçe Aktarım Ayarları" + +#~ msgctxt "Authentication proves the user's identity" +#~ msgid "Authentication" +#~ msgstr "Kimlik Doğrulama Ayarları" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Username" +#~ msgstr "Kullanıcı Adı" + +#~ msgctxt "The Envelope Sender Email Address" +#~ msgid "Envelope From Address" +#~ msgstr "Zarf Gönderici Adresi" + +#~ msgctxt "The Message Sender Email Address" +#~ msgid "Message From Address" +#~ msgstr "İleti Gönderen Adresi" + +#~ msgctxt "The email address to address replies to" +#~ msgid "Reply-To" +#~ msgstr "Yanıt" + +#~ msgid "Maximum Number of Log Entries" +#~ msgstr "Günlük girişleri sınırlama" + +#~ msgid "Maximum Number of Lines in a Transcript" +#~ msgstr "Transkript boyutu (Toplam satır)" + +#~ msgid "Configure the communication with the Mail Submission Agent (MSA):" +#~ msgstr "Kimlik doğrulama metodunu seçip SMTP sunucu ve port bilgilerini giriniz:" + +#~ msgid "Enter the account username (email address) and password:" +#~ msgstr "Email göndermek için kullanıcı adınızı (ya da email adresi) ve şifrenizi giriniz" + +#~ msgid "This will purge all of Postman's settings, including SMTP server info, username/password and OAuth Credentials." +#~ msgstr "Bu yaptığınız tüm Postman ayarlarını silecektir. SMTP sunucu bilgileri, kullanıcı/şifre ve OAuth bilgileri dahildir." + +#~ msgid "Log Level specifies the level of detail written to the WordPress log - view the log with Debug. Delivery mode offers options useful for developing or testing." +#~ msgstr "Günlük düzeyini WordPress günlüğüne ayrıntı düzeyini belirtir - Debugile günlüğünü görüntüleme. Teslimat modu geliştirme veya sınama için yararlı seçenekleri sunar." + +#~ msgid "Attention! Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +#~ msgstr "Dikkat! %2$s'u açarak %7$s adımından web uygulaması için hesap oluşturduktan sonra %3$s ve %4$s anahtar kodunuzu buraya yapıştırın." + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Grant OAuth Permission" +#~ msgstr "OAuth Yetki Ver" + +#~ msgid " must be greater than 0" +#~ msgstr "0’dan büyük olmalıdır" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup" +#~ msgstr "Postman Ayarları" + +#~ msgid "Welcome" +#~ msgstr "Hoşgeldin" + +#~ msgid "This is the Settings page for Postman, an SMTP mailer that delivers email from your WordPress site to the Internet. From here you can configure the plugin, and access testing and diagnostic tools." +#~ msgstr "Postacı, e-posta WordPress site Internet'e teslim eden bir SMTP posta ayarları sayfasında bu. Buradan eklenti yapılandırma ve sınama ve tanı araçları erişebilirsiniz." + +#~ msgid "Having trouble? You can ask for help on our Support Forum. To get the help you need quickly, please post the Diagnostic Data with your question. You can also check the FAQ and Error Messages pages for answers." +#~ msgstr "Sorun mu yaşıyorsunuz? Bizim Destek Forumuyardım isteyebilirsin. Hızlı bir şekilde gereken yardımı almak için Tanı veri soru gönderin. Cevaplar için SSS ve Hata mesajları sayfaları da kontrol edebilirsiniz." + +#~ msgid "The Email Test will send an email to you. If the test fails, the full SMTP session transcript is available to you.

    Receiving a single test email does not indicate perfect configuration. Some services may dump your email into a black-hole or mark it as Spam if you:" +#~ msgstr "E-posta sınama e-posta size göndereceğiz. Sınama başarısız olursa, tam SMTP oturumu transkript için kullanılabilir.

    Bir tek sınama e-posta alma mükemmel yapılandırma olduğunu göstermez. Bazı hizmetler e-posta bir kara deliğe dökümü veya Eğer Spam olarak işaretle sana:" + +#~ msgid "Violate an SPF record" +#~ msgstr "SPF kaydı ihlal" + +#~ msgid "You must use the SMTP server (MSA) approved by your domain to deliver your mail. (eg.) a @gmail.com sender address requires that authentication and delivery always be through smtp.gmail.com." +#~ msgstr "E-posta teslim etmek için etki alanı tarafından onaylanan SMTP sunucusu (MSA) kullanmanız gerekir. (örn.) @gmail.com gönderenin adresini, kimlik doğrulama ve teslim her zaman smtp.gmail.com olmasını gerektirir." + +#~ msgctxt "Forge as in a forgery (fake) is made" +#~ msgid "Forge the From Address" +#~ msgstr "Hatalı 'Kime' adresi" + +#~ msgid "Spoofing, when it results in an SPF violation, will get your message binned. Use your own address as the sender (From:) in every email." +#~ msgstr "SPF ihlaline sonuçlandığında sızdırma, binned iletinizi alacak. Gönderen olarak adresinize kullanın (From:) her e-posta." + +#~ msgid "Consolidates details of your setup to aid the author in debugging problems, including: operating system details, WordPress configuration, Postman configuration, network connectivity and your domain's primary MX and SPF records. Your private authorization credentials are masked." +#~ msgstr "Yazar gibi sorunlar, hata ayıklamaya yardımcı olmak için kurulum ayrıntılarını birleştirir: işletim sistemi ayrıntıları, WordPress yapılandırma, postacı yapılandırma, ağ bağlantısı ve alan adınızın birincil MX ve SPF kayıtları. Özel yetkilendirme kimlik bilgilerinizi maskelenir." + +#~ msgid "The Connectivity Test will report this site's ability to reach a mail server, and interrogate the mail server for it's capabilities." +#~ msgstr "Bağlantı sınaması bu sitenin yeteneği bir posta sunucusuna bildirir ve posta sunucusu için bu yeteneklerini sorgulamak." + +#~ msgctxt "Is it possible to create network connections to the Internet?" +#~ msgid "Outbound to Internet" +#~ msgstr "Internete Bağlantı" + +#~ msgid "This tests the ability to make outbound connections from your site to the Internet in general. If the result is Closed, then there is a communication problem with the Internet, like a firewall." +#~ msgstr "Bu, genel Internet sitenizden giden bağlantılar yapma yeteneğini sınar. Sonuç kapalıysa, sonra bir güvenlik duvarı gibi Internet ile bir iletişim sorunu işte." + +#~ msgctxt "What service is available?" +#~ msgid "Service Available" +#~ msgstr "Servis Kullanılabilir" + +#~ msgid "This shows the service found for a particular host/port. Possible successful results are SMTP, SMTPS (secure) and HTTPS (secure). If the result is No and the hostname you entered is correct, there was a communication problem with the mail server, like a firewall." +#~ msgstr "Bu hizmet için belirli bir konak/port bulundu gösterir. Olası başarılı sonuçlar, SMTP, SMTPS (güvenli) ve HTTPS (güvenli) vardır. Eğer sonuç No ve girdiğiniz ana bilgisayar adının doğru olduğundan, posta sunucusu gibi bir güvenlik duvarı ile bir iletişim sorunu oldu." + +#~ msgctxt "What is this server's ID?" +#~ msgid "ID" +#~ msgstr "ID" + +#~ msgid "Some hosts redirect mail traffic to their own mail server, breaking authentication and SPF verification. This is revealed by an incorrect server identity." +#~ msgstr "Bazı ev sahibi kendi posta sunucusuna, kimlik doğrulama ve SPF doğrulama posta trafiğini yeniden yönlendirebilir. Bu bir yanlış sunucu kimlik tarafından ortaya çıkıyor." + +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgid "This indicates whether the server supports protocol-level security. Either STARTTLS, SMTPS or HTTPS is required for secure transmission of your credentials." +#~ msgstr "Bu sunucu protokol düzeyinde güvenlik destekleyip desteklemediğini gösterir. STARTTLS, SMTPS veya HTTPS kimlik bilgilerinizi güvenli iletimi için gereklidir." + +#~ msgctxt "Short for Authentication" +#~ msgid "Auth" +#~ msgstr "Kimlik" + +#~ msgid "This indicates the authenication methods that the server supports. All are password-based, except for OAuth 2.0, which is token-based." +#~ msgstr "Bu sunucunun desteklediği AUTHENICATION yöntemleri gösterir. Tüm hangi belirteci tabanlı, parola tabanlı ve OAuth 2.0 hariç." + +#~ msgctxt "A testing tool which determines connectivity to the Internet" +#~ msgid "Connectivity Test" +#~ msgstr "Bağlantı Testi" + +#~ msgctxt "Email Test Status" +#~ msgid "Ajax Error" +#~ msgstr "Ajax hata" + +#~ msgid "Unexpected PHP messages corrupted the Ajax response:" +#~ msgstr "Beklenmeyen PHP mesajları Ajax yanıt bozuk:" + +#~ msgid "Warning: connected to %1$s instead of %2$s." +#~ msgstr "Uyarı: %1$s %2$s yerine bağlı." + +#~ msgid "Port %d can be used to send Gmail with the Gmail API." +#~ msgstr "Gmail API ile %d portunu kullanarak Gmail ile gönderim yapabilirsiniz." + +#~ msgid "WordPress (or another plugin) is currently handling email delivery, not Postman." +#~ msgstr "Şu anda WordPress (veya başka bir eklenti) e-posta dağıtımı, değil Postman." + +#~ msgctxt "Page Title" +#~ msgid "Manual Configuration" +#~ msgstr "Manuel Yapılandırma" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Account" +#~ msgstr "Hesap" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Message" +#~ msgstr "Mesaj" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Logging" +#~ msgstr "Kereste eldesi" + +#~ msgctxt "Manual Configuration Tab Label" +#~ msgid "Advanced" +#~ msgstr "Ayarlar" + +#~ msgid "Delete plugin settings" +#~ msgstr "Eklenti ayarlarını sil" + +#~ msgid "This will purge all of Postman's settings, including account credentials and the mail log." +#~ msgstr "Bu yaptığınız tüm Postman ayarlarını silecektir. SMTP sunucu bilgileri, kullanıcı/şifre ve OAuth bilgileri dahildir." + +#~ msgctxt "Button Label" +#~ msgid "Delete All Data" +#~ msgstr "Herşeyi Sıfırla" + +#~ msgctxt "The port number" +#~ msgid "Port %s" +#~ msgstr "Port %s" + +#~ msgctxt "Authentication Type" +#~ msgid "None" +#~ msgstr "Hiçbiri" + +#~ msgid "* Port 443 tests against googleapis.com, not the SMTP hostname you enter." +#~ msgstr "* Bağlantı noktası 443 googleapis.com karşı değil girdiğiniz SMTP hostname test eder." + +#~ msgid "A port with Service Available \"No\" indicates one or more of these issues:" +#~ msgstr "Kapalı port:" + +# i’ve added (allow-url-fopen) because being clear about what user has to look at +#~ msgid "Your PHP configuration is preventing outbound connections" +#~ msgstr "PHP ayarlarınız dışarıya giden bağlantıları önlüyor (allow-url-fopen)" + +#~ msgid "Your WordPress configuration is preventing outbound connections" +#~ msgstr "WordPress ayarlarınız dışarıya giden bağlantıları önlüyor " + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "Show Advanced Configuration" +#~ msgstr "Gelişmiş yapılandırmasını göster" + +#~ msgid "Disable" +#~ msgstr "Devre dışı bırak" + +#~ msgctxt "Page Title" +#~ msgid "Postman Setup Wizard" +#~ msgstr "Postman Kurulum Sihirbazı" + +#~ msgid "Error: Your email address requires access to a remote SMTP server blocked by GoDaddy. Use a different e-mail address." +#~ msgstr "Hata: GoDaddy tarafından engellenen bir uzak SMTP sunucusunun e-posta adresi gerektirir erişim. Farklı e-posta adresi kullanın." + +#~ msgid "Warning: If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems." +#~ msgstr "Uyarı: Bu etki alanına sahipseniz, geçişi olarak bir SPF kaydı GoDaddy yetkisi var. veya teslim sorunları olacaktır emin olun." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will the connection to the MSA be established?" +#~ msgstr "Giden Posta Sunucusu'na nasıl bağlanılacak?" + +#~ msgid "Warning: This configuration option will send your authorization credentials in the clear." +#~ msgstr "Uyarı: Bu yapılandırma seçeneği açık yetkilendirme kimlik bilgileri gönderir." + +#~ msgctxt "Wizard Step Title" +#~ msgid "How will you prove your identity to the MSA?" +#~ msgstr "Kendinizi Giden Posta Sunucusu'na nasıl tanıtacaksınız?" + +#~ msgid "Enter your credentials. Your username is often your email address." +#~ msgstr "Bilgilerinizi giriniz. Kullanıcı adınız genellikle email adresinizdir." + +#~ msgid "Examine the SMTP Session Transcript if you need to." +#~ msgstr "İhtiyacınız olması durumunda SMTP Durum Detayını inceleyebilirsiniz." + +#~ msgid "SMTP Session Transcript" +#~ msgstr "SMTP Durum Detayı" + +#~ msgid "The Envelope From address identifies the account owner to the SMTP server." +#~ msgstr "Zarf gönderici adresi üzerinden SMTP sunucusuna hesap sahibi tanımlar." + +#~ msgid "The Message From address identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Themes and other plugins, especially Contact Forms, are permitted to modify this field." +#~ msgstr "İleti gönderen adresi için tanımlar. Örneğin Google'nın Posta gönder özelliğini kullanmak için başkasının adına gönderirken bu değiştirin. Temalar ve diğer eklentileri, özellikle ilgili kişi formlarınızı, bu alan değiştirmek için izin verilmektedir." + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful for developing or testing." +#~ msgstr "Loglama Seviyesi WordPress ve PHP için logların detaylı olup olmamasını belirler." + +#~ msgid "The server returned an unexpected result:" +#~ msgstr "Sunucu beklenmedik ve geçersiz bir sonuç döndürdü:" + +#~ msgid "Postman has delivered %d email for you." +#~ msgid_plural "Postman has delivered %d emails for you." +#~ msgstr[0] "Postman sizin için %d adet email iletti!" + +#~ msgid "View the log" +#~ msgstr "Günlüğünü görüntüle" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "configure manually" +#~ msgstr "el ile ayarla" + +#~ msgid "The server returned an unexpected and invalid result:" +#~ msgstr "Sunucu beklenmedik ve geçersiz bir sonuç döndürdü:" + +#~ msgid "Communication Error [334] - make sure the Sender Email belongs to the account which provided the OAuth 2.0 consent." +#~ msgstr "Bağlantı Hatası [334] - gönderen email adresinin OAuth 2.0 email gönderimine izin verdiğinden emin olun." + +#~ msgid "https://profiles.wordpress.org/jasonhendriks/" +#~ msgstr "https://profiles.wordpress.org/jasonhendriks/" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your shared secret (password) in encoded form." +#~ msgstr "SMTP sunucunuz ve Postman arasındaki diyaloğu buradan takip edebilirsiniz. Bu sorunların teşhisinde size yol gösterebilir. DİKKAT bunu herhangi biriyle paylaşmayın. İçerisinde size özel gizli anahtar (şifre) bilgileri olabilir." + +#~ msgid "Choose the Recipient" +#~ msgstr "Alıcı Belirtin" + +#~ msgid "The Gmail API transport requires a Sender Email Address, Client ID and Client Secret." +#~ msgstr "Gmail API transfer işlemi Gönderen Email Adresi, Client ID, ve Client Secret (şifre) istemekte." + +#~ msgid "Outgoing Mail Server Hostname/Port and Sender Email Address can not be empty." +#~ msgstr "Giden Mail Sunucusu (SMTP), Port ve Gönderen Email Adresi belirtmeniz gerekmektedir, boş bırakılamaz." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Sender" +#~ msgstr "Gönderen" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Email Address" +#~ msgstr "Gönderen Email Adresi" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Name" +#~ msgstr "Gönderen Adı" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Addresses" +#~ msgstr "Ek Email Adresleri" + +#~ msgctxt "Configuration Input Field" +#~ msgid "To Recipient(s)" +#~ msgstr "Alıcı(lar)" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Carbon Copy Recipient(s)" +#~ msgstr "Karbon Kopya Alıcı(lar)" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Blind Carbon Copy Recipient(s)" +#~ msgstr "Gizli Alıcı(lar)" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Additional Headers" +#~ msgstr "Ek Üstbilgiler" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Custom Headers" +#~ msgstr "Özel Üstbilgiler" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Enable Logging" +#~ msgstr "Etkinleştir" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Log Entries Limit" +#~ msgstr "Günlük girişleri sınırlama" + +#~ msgctxt "The maximum number of lines of the SMTP transcript" +#~ msgid "Transcript Size (Total Lines)" +#~ msgstr "Transkript boyutu (Toplam satır)" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Network Settings" +#~ msgstr "Network Ayarları" + +#~ msgid "The Sender sets both the envelope Mail-From and the message From header. However, the From header can be modified by another plugin (e.g. for setting a visitor's email address from a Contact Form)." +#~ msgstr "Her iki zarf gönderici ayarlar - Gönderen ve üzerinden ileti üstbilgisi. Ancak, gelen üstbilgi (örneğin bir ziyaretçinin e-posta adresi iletişim formu ayarlamak için) başka bir eklenti tarafından değiştirilebilir." + +#~ msgid "Force this in the From header for all messages" +#~ msgstr "Bu başlıktaki gelen tüm iletiler için zorla" + +#~ msgid "Communication Error [334] - make sure the Sender Email belongs to the account which provided the %s OAuth 2.0 consent." +#~ msgstr "Bağlantı Hatası [334] - gönderen email adresinin %s OAuth 2.0 email gönderimine izin verdiğinden emin olun." + +#~ msgid "Please note that to combat Spam, many email services will not let you send from an email address other than the one you authenticate with." +#~ msgstr "Lütfen şunu da not edin, birçok email servisi asla kendi emailizden farklı bir email adına gönderim yapmanıza izin vermez." + +#~ msgctxt "Who is this message from?" +#~ msgid "From" +#~ msgstr "Şundan" + +#~ msgctxt "Who is this message to?" +#~ msgid "To" +#~ msgstr "Şuraya" + +#~ msgctxt "Name of the email service portal" +#~ msgid "Google Developer Console" +#~ msgstr "Google Developer Konsolu" + +#~ msgid "Please check the troubleshooting and error messages page and the support forum.
    If you write for help, please include the following:" +#~ msgstr "Lütfen hata ve sorun çözme sayfası ya da destek forumlarına göz atın.
    Yardım almak için lütfen tanı bilgisini de foruma yazınız:" + +#~ msgid "Postman will send mail via the Gmail API using %s authentication." +#~ msgstr "Postman emailleri Gmail API'ın %s kimlik doğrulama metodu ile gönderecek." + +#~ msgctxt "Transport Name" +#~ msgid "SMTPS" +#~ msgstr "SMTPS" + +#~ msgctxt "Transport Name" +#~ msgid "SMTP-STARTTLS" +#~ msgstr "SMTP-STARTTLS" + +#~ msgid "The message sender is used as the default From: address." +#~ msgstr "Mesaj gönderen bilgisi Gönderen: adresinden alınacaktır." + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles. Delivery mode offers options useful in a development environment." +#~ msgstr "Loglama Seviyesi WordPress ve PHP için logların detaylı olup olmamasını belirler." + +#~ msgid "Force this Sender Name for all messages" +#~ msgstr "Gönderen adının geçersiz kılınmasını önle" + +#~ msgid "Force this Sender Email Address for all messages" +#~ msgstr "Gönderen email adresinin geçersiz kılınmasını önle" + +#~ msgid "Please note: When composing email, some WordPress plugins and themes may set an unauthorized sender email address causing rejection with services like Yahoo Mail. If you experience problems, enable \"Force this Sender Email Address for all messages\" in the settings." +#~ msgstr "Lütfen dikkat: Email gönderimi sırasında diğer Eklentiler ya da Temalar gönderen adını ya da email adresini değiştirebildiği için bazı email servislerine gönderim yapamayabilirsiniz (örn: Yahoo Mail). Eğer problem yaşarsanız gönderen email adresini diğer eklentilerin ve temaların ayarlarından boş bırakınız." + +#~ msgctxt "Encryption Type" +#~ msgid "SSL (SMTPS)" +#~ msgstr "SSL (SMTPS)" + +#~ msgctxt "Encryption Type" +#~ msgid "TLS (StartTLS)" +#~ msgstr "TLS (StartTLS)" + +#~ msgid "The impossible is possible; sending through wp_mail() failed, but sending through internal engine succeeded." +#~ msgstr "İmkansız diye birşey yoktur; emailinizin gönderimi wp_mail() ile başarısız oldu ancak sunucudaki email sistemiyle gönderildi." + +#~ msgid "Error: Postman is properly configured, but the current theme or another plugin is preventing service." +#~ msgstr "Postman başarıyla kuruldu, fakat şu anda farklı bir mail servisi kullanıyorsunuz. Diğer eklentiyi deaktif ediniz." + +#~ msgid "See How do I get a %6$s %3$s? in the F.A.Q. for help." +#~ msgstr "SSS'lardaki %6$s %3$s nasıl alınır? adımından yardım alabilirsiniz." + +#~ msgctxt "Short for \"Diagnostic Information\"" +#~ msgid "Diagnostic Info" +#~ msgstr "Tanılama bilgisi" + +#~ msgctxt "Details about the system" +#~ msgid "Diagnostic Information" +#~ msgstr "Tanı Bilgisi" + +#~ msgid "Run a Connectivity Test" +#~ msgstr "Bağlantı Testini Başlat" + +#~ msgid "The most common transport is SMTP:" +#~ msgstr "En çok kullanılan ulaşım SMTP's:" + +#~ msgid "Email not working? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +#~ msgstr "Email sisteminiz çalışmıyor mu? Postman; Gmail, Hotmail ve Yahoo Mail için OAuth 2.0 destekli ilk WordPress SMTP eklentisidir. Kurulumu ise Kurulum Sihirbazı ve Port Test araçları ile çok basittir. Şifrenizi değiştirseniz dahi kesintisiz email gönderiminin keyfini çıkarın!" + +#~ msgid "Log Level specifies the level of detail written to the WordPress and PHP logfiles." +#~ msgstr "Loglama Seviyesi WordPress ve PHP için logların detaylı olup olmamasını belirler." + +#~ msgctxt "When the server is online to the public, this is \"Production\" mode" +#~ msgid "Production" +#~ msgstr "Üretim" + +#~ msgid "Log Emails, then Dump" +#~ msgstr "E-posta giriş, o zaman dökümü" + +#~ msgid "Dump All Emails" +#~ msgstr "Herşeyi Sıfırla" + +#~ msgid "This is a record of delivery attempts made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "Bu posta teslimi Aracısı (MSA) yapılan teslim girişimleri kaydıdır. Sucessful alıcıya teslim için mutlaka göstermez." + +#~ msgid "Error authenticating with this Client ID - please create a new one. [%s]" +#~ msgstr "Bu hesap ile doğrulama sırasında hata oluştu - lütfen yeni bir tane oluşturun. [%s]" + +#~ msgid "Warning: connected to %1$s instead of %2$s. This may be a problem." +#~ msgstr "Uyarı: %1$s %2$s yerine bağlı. Bu bir sorun olabilir." + +#~ msgid "Outgoing Mail Server (SMTP) and Port can not be empty." +#~ msgstr "Giden Mail Sunucusu (SMTP) ve Port boş bırakılamaz." + +#~ msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server, Sender Email Address, %1$s, and %2$s." +#~ msgstr "OAuth 2.0 metodu ile gönderim için OAuth 2.0 destekleyen bir Giden Mail Sunucusu, Gönderen Email Adresi belirtmeniz gerekmektedir, %1$s, ve %2$s." + +#~ msgid "Postman is properly configured, but another plugin has taken over the mail service. Deactivate the other plugin." +#~ msgstr "Postman başarıyla kuruldu, fakat şu anda farklı bir mail servisi kullanıyorsunuz. Diğer eklentiyi deaktif ediniz." + +#~ msgctxt "postman-smtp" +#~ msgid "OAuth 2.0 (requires Client ID and Client Secret)" +#~ msgstr "OAuth 2.0 (müşteri kimliği ve istemci gizli gerektirir)" + +#~ msgid "Postman is missing a required PHP library." +#~ msgstr "Postman gerek duyduğu bir PHP kütüphanesine ulaşamıyor." + +#~ msgctxt "as in \"No Authentication\"" +#~ msgid "No" +#~ msgstr "Hayır" + +#~ msgid "Your recommended settings are %1$s with %2$s authentication on port %3$d." +#~ msgstr "Postman, %2$s ile %1$s metodu için port olarak %3$d kullanmanızı öneriyor." + +#~ msgid "Attention! Open the %2$s, create %7$s using the URL's displayed below, and copy the %3$s and %4$s here." +#~ msgstr "Dikkat! %2$s'u açarak %7$s adımından web uygulaması için hesap oluşturduktan sonra %3$s ve %4$s anahtar kodunuzu buraya yapıştırın." + +#~ msgid "Please wait for the port test to finish" +#~ msgstr "Lütfen port testinin bitmesini bekleyiniz" + +#~ msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. These servers are specific to your email account, and if you don't know what to use, ask your email service provider." +#~ msgstr "Postman MSA (Mail Submission Agent) olarak da bilinen belirteceğiniz bu Giden Posta Sunucusu üzerinden email gönderecektir. Eğer mümkünse Postman bunu belirttiğiniz email adresinden bulmaya çalışacak." + +#~ msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows. Postman will attempt to determine which options are available to you." +#~ msgstr "Giden Posta Sunucusu adresini ve portu email servisini aldığınız yer belirler, WordPress hostunuz onaylar. Postman şimdi size en uygun ayarları bulmaya çalışacak." + +#~ msgid "Configuration will proceed on socket %1$s using %2$s authentication." +#~ msgstr "Konfigürasyon %1$s soketi için %2$s kimlik doğrulama metoduyla devam edecek." + +#~ msgctxt "The port number" +#~ msgid "Port %d" +#~ msgstr "%d Portunu" + +#~ msgctxt "Authentication Type" +#~ msgid "Plain" +#~ msgstr "Plain" + +#~ msgctxt "Authentication Type" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgctxt "As in type used: OAuth 2.0" +#~ msgid "OAuth 2.0" +#~ msgstr "OAuth 2.0" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Test" +#~ msgstr "Test" + +#~ msgctxt "Port Test" +#~ msgid "Port %s" +#~ msgstr "Port %s" + +#~ msgctxt "Authentication Type is Password" +#~ msgid "Password" +#~ msgstr "Şifre" + +#~ msgctxt "Authentication Type" +#~ msgid "no" +#~ msgstr "hayır" + +#~ msgctxt "Authentication Type" +#~ msgid "CRAM-MD5" +#~ msgstr "CRAM-MD5" + +#~ msgctxt "Authentication Type" +#~ msgid "Login" +#~ msgstr "Login" + +#~ msgctxt "Authentication Type" +#~ msgid "Password (%s)" +#~ msgstr "Şifre (%s)" + +#~ msgid "Password authentication (Plain/Login/CRAMMD5) requires a username and password." +#~ msgstr "Şifre metodu (Plain/Login/CRAMMD5) için kullanıcı adı ve şifre belirtmeniz gerekmektedir." + +#~ msgctxt "Postman Dashboard Widget Title" +#~ msgid "Postman SMTP" +#~ msgstr "Postman SMTP" + +#~ msgctxt "Dashboard Widget Settings Link label" +#~ msgid "Settings" +#~ msgstr "Ayarlar" + +#~ msgctxt "Dashboard Widget Settings Link label" +#~ msgid "Email Log" +#~ msgstr "Email Logu" + +#~ msgctxt "Plugin Action Links" +#~ msgid "Settings" +#~ msgstr "Ayarlar" + +#~ msgid "All plugin settings were removed." +#~ msgstr "Tüm ayarlar sıfırlandı." + +#~ msgctxt "Configuration Section Title" +#~ msgid "Transport" +#~ msgstr "İçe Aktarma" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Transport" +#~ msgstr "İçe Aktarma" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Authentication" +#~ msgstr "Kimlik Doğrulama" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Outgoing Mail Server Hostname" +#~ msgstr "SMTP Sunucusu" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Outgoing Mail Server Port" +#~ msgstr "SMTP Portu" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Authentication" +#~ msgstr "Kimlik Doğrulama" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Password" +#~ msgstr "Şifre\t" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Reply-To" +#~ msgstr "Yanıt" + +#~ msgctxt "Configuration Input Field" +#~ msgid "Log Level" +#~ msgstr "Hata Kaydı" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Delete plugin settings" +#~ msgstr "Eklenti ayarlarını sil" + +#~ msgid "The default transport is SMTP." +#~ msgstr "Kullanılan gönderim şekli SMTP." + +#~ msgid "Select the transport to use:" +#~ msgstr "Gönderim şeklini seçiniz:" + +#~ msgid "Select the authentication method, security type, and enter the Mail Submission Agent (MSA) hostname and port:" +#~ msgstr "Kimlik doğrulama metodunu seçip SMTP sunucu ve port bilgilerini giriniz:" + +#~ msgid "Enter the username (email address) and password you use to send email" +#~ msgstr "Email göndermek için kullanıcı adınızı (ya da email adresi) ve şifrenizi giriniz" + +#~ msgid "The message sender is used as the From: address." +#~ msgstr "Mesaj gönderen bilgisi Gönderen: adresinden alınacaktır." + +#~ msgid "The Reply-To overrides the Sender when the recipient composes a reply. Separate multiple to/cc/bcc recipients with commas." +#~ msgstr "Yanıt gelmesi durumunda Gönderen:'e değil, Yanıtla: bölümünde belirteceğiniz adrese gider. Virgül ile ayırarak to/cc/bcc bölümlerine fazla kişi ekleyebilirsiniz." + +#~ msgctxt "Encryption Type" +#~ msgid "None" +#~ msgstr "Hiçbiri" + +#~ msgctxt "Encryption Type" +#~ msgid "SSL" +#~ msgstr "SSL" + +#~ msgctxt "Encryption Type" +#~ msgid "TLS" +#~ msgstr "TLS" + +#~ msgid "Prevent the Sender Name from being overridden" +#~ msgstr "Gönderen adının geçersiz kılınmasını önle" + +#~ msgid "Prevent the Sender Email Address from being overridden" +#~ msgstr "Gönderen email adresinin geçersiz kılınmasını önle" + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Request permission from %s" +#~ msgstr "%s tarafından izin iste" + +# no need to translate - its generic +#~ msgctxt "Name of the Application Callback Domain" +#~ msgid "Javascript Origins" +#~ msgstr "Javascript Origins" + +# no need to translate - its generic +#~ msgctxt "Name of the OAuth 2.0 Client Secret" +#~ msgid "Client secret" +#~ msgstr "Client secret" + +# no need to translate - its generic +#~ msgctxt "Name of the OAuth 2.0 Client ID" +#~ msgid "Consumer Key" +#~ msgstr "Consumer Key" + +# no need to translate - its generic +#~ msgctxt "Name of the OAuth 2.0 Client Secret" +#~ msgid "Consumer Secret" +#~ msgstr "Consumer Secret" + +#~ msgctxt "Command to initiate OAuth authentication" +#~ msgid "Request OAuth Permission" +#~ msgstr "OAuth Yetki Ver" + +#~ msgctxt "Page Title" +#~ msgid "Postman Settings" +#~ msgstr "Postman Ayarları" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Checking.." +#~ msgstr "Kontrol ediliyor.." + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Open" +#~ msgstr "Açık" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Closed" +#~ msgstr "Kapalı" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Done." +#~ msgstr "Harika." + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Yes" +#~ msgstr "Evet" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "No" +#~ msgstr "Hayır" + +#~ msgctxt "TCP Port Test Status" +#~ msgid "Port" +#~ msgstr "Portu" + +#~ msgid "Port %d is blocked. Contact your host for a solution, such as using their local SMTP server or opening the port." +#~ msgstr "%d numaralı port engellenmiş. Hosting hizmeti aldığınız firma ile görüşerek port açılımını sağlayabilirsiniz." + +#~ msgid "Port %d can't send mail with %s. Try a different SMTP server." +#~ msgstr "%d portunu kullanarak %s sunucusundan email gönderilemedi. Lütfen farklı bir SMTP server seçiniz." + +#~ msgid "Port %d can be used to send Gmail with the Postman Gmail Extension." +#~ msgstr "Postman Gmail Eklentisi ile %d portunu kullanarak Gmail ile gönderim yapabilirsiniz." + +#~ msgid "Port %d is blocked. Contact your host for a solution, such as opening the port." +#~ msgstr "%d numaralı port engelli. Hosting firmanız ile iletişim kurarak portu açtırabilirsiniz." + +#~ msgid "No ports are available for this SMTP server. Try a different SMTP host or contact your WordPress host for their specific solution." +#~ msgstr "Bu SMTP server için herhangi bir port uygun değil. Farklı bir SMTP host deneyebilir ya da WordPress servisini aldığınız hosting ile çözüm sağlamaları için görüşebilirsiniz. " + +#~ msgctxt "Wizard Label" +#~ msgid "current step:" +#~ msgstr "şu anki adım:" + +#~ msgctxt "Wizard Label" +#~ msgid "Pagination" +#~ msgstr "Adım" + +#~ msgctxt "Wizard Label" +#~ msgid "Finish" +#~ msgstr "Bitir" + +#~ msgctxt "Wizard Label" +#~ msgid "Next" +#~ msgstr "Sonraki" + +#~ msgctxt "Wizard Label" +#~ msgid "Previous" +#~ msgstr "Geri" + +#~ msgctxt "Wizard Label" +#~ msgid "Loading ..." +#~ msgstr "Yükleniyor..." + +#~ msgid "Please note: When composing email, other WordPress plugins and themes are forbidden from overriding the sender email address." +#~ msgstr "Lütfen dikkat: Email gönderimi sırasında diğer Eklentiler ya da Temalar gönderen adını değiştirebilir. Bunu kendi içlerinden değiştirebilirsiniz." + +#~ msgid "Please note: When composing email, other WordPress plugins and themes may override the sender name and email address causing rejection with some email services, such as Yahoo Mail. If you experience problems, try leaving the sender email address empty in these plugins or themes." +#~ msgstr "Lütfen dikkat: Email gönderimi sırasında diğer Eklentiler ya da Temalar gönderen adını ya da email adresini değiştirebildiği için bazı email servislerine gönderim yapamayabilirsiniz (örn: Yahoo Mail). Eğer problem yaşarsanız gönderen email adresini diğer eklentilerin ve temaların ayarlarından boş bırakınız." + +#~ msgid "Postman has delivered %d email for you!" +#~ msgid_plural "Postman has delivered %d emails for you!" +#~ msgstr[0] "Postman sizin için %d adet email iletti!" + +#~ msgid "Please consider leaving a review of Postman SMTP to help spread the word about the new way to send email from WordPress! :D" +#~ msgstr "Eğer bu ücretsiz ve tatlı hizmetimizi sevdiyseniz buraya tıklayarak
    yorum eklerseniz çok seviniriz. Bu sayede birçok insan WordPress için bu yeni servisi tanır! :D" + +#~ msgctxt "Page Title" +#~ msgid "Delete plugin settings" +#~ msgstr "Eklenti ayarlarını sıfırla" + +#~ msgctxt "Page Title" +#~ msgid "Connectivity Test" +#~ msgstr "Bağlantı Testi" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Outbound to Internet" +#~ msgstr "Internete Bağlantı" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "Service Available" +#~ msgstr "Servis Kullanılabilir" + +#~ msgctxt "Connectivity Test Table" +#~ msgid "STARTTLS" +#~ msgstr "STARTTLS" + +#~ msgid "Conclusion" +#~ msgstr "Sonuç" + +#~ msgid "A Closed port indicates one or more of these issues:" +#~ msgstr "Kapalı port:" + +#~ msgid "Your host has placed a firewall between this site and the Internet" +#~ msgstr "Hosting hesabınızda site ile SMTP server arasında güvenlik duvarı var." + +#~ msgctxt "Page Title" +#~ msgid "Tips and Diagnostic Info" +#~ msgstr "İpuçları ve Tanı Bilgileri" + +#~ msgid "Please check the troubleshooting and error messages page and the support forum.
    If you write for help, please include the following diagnostic information:" +#~ msgstr "Lütfen hata ve sorun çözme sayfası ya da destek forumlarına göz atın.
    Yardım almak için lütfen tanı bilgisini de foruma yazınız:" + +#~ msgctxt "Page Title" +#~ msgid "Diagnostic Information" +#~ msgstr "Tanı Bilgisi" + +#~ msgctxt "Main Menu" +#~ msgid "Get Started" +#~ msgstr "Haydi Başlayalım" + +#~ msgctxt "Button Label" +#~ msgid "Start the Wizard" +#~ msgstr "Kurulum Sihirbazını Başlat" + +#~ msgctxt "Main Menu" +#~ msgid "configure manually" +#~ msgstr "el ile ayarla" + +#~ msgctxt "Page Title" +#~ msgid "Send a Test Email" +#~ msgstr "Test Emaili Gönder" + +#~ msgctxt "Main Menu" +#~ msgid "Delete plugin settings" +#~ msgstr "Eklenti ayarlarını sıfırla" + +#~ msgctxt "Main Menu" +#~ msgid "Run a Connectivity Test" +#~ msgstr "Bağlantı Testini Başlat" + +#~ msgctxt "Main Menu" +#~ msgid "Online Support" +#~ msgstr "Online Destek" + +#~ msgctxt "Plugin to Import Configuration from" +#~ msgid "None" +#~ msgstr "Hiçbiri" + +#~ msgid "Please enter the email address and name you'd like to send mail from." +#~ msgstr "Lütfen gönderen email adresi ve ismi belirtiniz." + +#~ msgid "Please note that to combat Spam, many email services will not let you send from an e-mail address other than the one you authenticate with in step 5." +#~ msgstr "Lütfen şunu da not edin, birçok email servisi asla kendi emailizden farklı bir email adına gönderim yapmanıza izin vermez." + +#~ msgctxt "Configuration Input Field" +#~ msgid "Sender Email Name" +#~ msgstr "Gönderen Email Adresi" + +#~ msgctxt "Wizard Step Title" +#~ msgid "Outgoing Mail Server Hostname" +#~ msgstr "SMTP Sunucusu" + +#~ msgid "This is the local Outgoing Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. These servers are normally specific to the email account you have, and if you don't know which server to use, ask your email service provider.

    If possible, the Wizard will pre-fill this field based on the e-mail address you entered." +#~ msgstr "Postman MSA (Mail Submission Agent) olarak da bilinen belirteceğiniz bu Giden Posta Sunucusu üzerinden email gönderecektir. Eğer mümkünse Postman bunu belirttiğiniz email adresinden bulmaya çalışacak." + +#~ msgctxt "Wizard Step Title" +#~ msgid "Connectivity Test" +#~ msgstr "Bağlantı Testi" + +#~ msgctxt "Wizard Action" +#~ msgid "Connectivity Test" +#~ msgstr "Bağlantı Testi" + +#~ msgctxt "Wizard Step Title" +#~ msgid "Authentication" +#~ msgstr "Kimlik Doğrulama" + +#~ msgid "Enter your credentials. Your username is most likely your email address." +#~ msgstr "Bilgilerinizi giriniz. Kullanıcı adınız genellikle email adresinizdir." + +#~ msgctxt "Wizard Step Title" +#~ msgid "Finish" +#~ msgstr "Tamamla" + +#~ msgid "Request permission from the Email Provider to allow Postman to send email and" +#~ msgstr "Email hizmeti aldığınız servisten Postman'a yetki verinki email gönderebilsin." + +#~ msgid "Status Message" +#~ msgstr "Durum: " diff --git a/Postman/languages/postman-smtp-zh_CN.mo b/Postman/languages/postman-smtp-zh_CN.mo new file mode 100644 index 0000000..160df0a Binary files /dev/null and b/Postman/languages/postman-smtp-zh_CN.mo differ diff --git a/Postman/languages/postman-smtp-zh_CN.po b/Postman/languages/postman-smtp-zh_CN.po new file mode 100644 index 0000000..13caa0e --- /dev/null +++ b/Postman/languages/postman-smtp-zh_CN.po @@ -0,0 +1,1511 @@ +# Translation of Stable (latest release) in Chinese (China) +# This file is distributed under the same license as the Stable (latest release) package. +msgid "" +msgstr "" +"Project-Id-Version: Stable (latest release)\n" +"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/postman-smtp\n" +"POT-Creation-Date: 2015-11-08 17:10-0500\n" +"PO-Revision-Date: 2015-11-09 01:02-0500\n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: zh_CN\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=1; plural=0;\n" +"X-Generator: Poedit 1.8.6\n" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:94 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:348 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:357 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:99 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:545 +#: Postman/PostmanViewController.php:227 +msgid "Warning" +msgstr "警告" + +#. translators: where %s is the name of the SMTP server +#: Postman/Postman-Configuration/PostmanConfigurationController.php:96 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +msgid "connected to %1$s instead of %2$s." +msgstr "连接到 %1$s 而不是 %2$s。" + +#. translators: where %d is a port number +#: Postman/Postman-Configuration/PostmanConfigurationController.php:98 +msgid "You are about to configure OAuth 2.0 with an IP address instead of a domain name. This is not permitted. Either assign a real domain name to your site or add a fake one in your local host file." +msgstr "你将使用 IP 地址而不是域名配置 OAuth 2.0。这并不被允许。请为你的站点分配一个真实的域名，或者在本地 host 文件添加一个虚拟域名。" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/PostmanViewController.php:53 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "%s Setup" +msgstr "%s 安装" + +#. Plugin Name of the plugin/theme +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:57 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:70 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:176 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/Postman.php:61 Postman/PostmanViewController.php:53 +#: Postman/PostmanViewController.php:54 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "Postman SMTP" +msgstr "Postman SMTP" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:196 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:81 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 Postman/Postman.php:316 +#: Postman/PostmanAdminController.php:225 +msgid "Settings" +msgstr "設定" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:198 +msgid "Account" +msgstr "账户" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:199 +msgid "Message" +msgstr "内容" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:200 +msgid "Logging" +msgstr "记录日志" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:201 +msgid "Advanced" +msgstr "高级设置" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:263 +msgid "Setup Wizard" +msgstr "安装向导" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:296 +msgctxt "Wizard Step Title" +msgid "Import Configuration" +msgstr "导入配置" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:298 +msgctxt "Wizard Step Title" +msgid "Import configuration from another plugin?" +msgstr "从另外插件导入配置？" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:299 +msgid "If you had a working configuration with another Plugin, the Setup Wizard can begin with those settings." +msgstr "如果你有一个另外插件的配置文件，安装向导可以使用那些设置。" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:301 +#: Postman/Postman-Mail/PostmanModuleTransport.php:720 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:425 +msgid "None" +msgstr "无" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:312 +msgctxt "Wizard Step Title" +msgid "Sender Details" +msgstr "发件人信息" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:314 +msgctxt "Wizard Step Title" +msgid "Who is the mail coming from?" +msgstr "邮件来自谁？" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:315 +msgid "Enter the email address and name you'd like to send mail as." +msgstr "输入发送邮件时使用的邮件地址和名字。" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:316 +msgid "Please note that to prevent abuse, many email services will not let you send from an email address other than the one you authenticate with." +msgstr "请注意，为了避免混淆，很多邮件服务不允许你使用除验证的那个邮箱以外的地址。" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:317 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:49 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:112 +msgid "Email Address" +msgstr "电邮地址" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:320 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:59 +msgid "Name" +msgstr "名字" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:325 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:143 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:331 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:542 +msgid "Outgoing Mail Server Hostname" +msgstr "发送邮件服务器主机名" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:333 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:138 +#: Postman/PostmanViewController.php:294 +msgid "Connectivity Test" +msgstr "连接测试" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:335 +msgid "How will the connection to the mail server be established?" +msgstr "如何确立到 MSA 的连接？" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:336 +msgid "Your connection settings depend on what your email service provider offers, and what your WordPress host allows." +msgstr "你的连接设置取决于邮件服务提供商的提供，以及你的 WordPress 托管商的许可。" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +msgctxt "TCP Port Test Status" +msgid "Ready" +msgstr "Ready" + +#. Translators: Where %1$s is the socket identifier and %2$s is the +#. authentication type +#: Postman/Postman-Configuration/PostmanConfigurationController.php:345 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgctxt "A socket is the network term for host and port together" +msgid "Socket" +msgstr "Socket" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:346 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:354 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:223 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:177 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:351 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:356 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:372 +msgid "Authentication" +msgstr "验证" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:349 +msgid "This configuration option will send your authorization credentials in the clear." +msgstr "该配置项将会发送你的验证凭证。" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:356 +msgid "How will you prove your identity to the mail server?" +msgstr "如何向 MSA 证明你的标识？" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:363 +msgctxt "The final step of the Wizard" +msgid "Finish" +msgstr "完成" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:365 +msgctxt "Wizard Step Title" +msgid "You're Done!" +msgstr "已经完成！" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:367 +msgid "Click Finish to save these settings, then:" +msgstr "点击完成保存设置，然后：" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:369 +msgid "Grant permission with the Email Provider for Postman to send email and" +msgstr "向邮件提供商申请授权，以便 Postman 发送邮件" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:370 +msgid "Send yourself a Test Email to make sure everything is working!" +msgstr "发送测试邮件，确保所有设置正确！" + +#. translators: where %s is the URL to the Connectivity Test page +#: Postman/Postman-Configuration/PostmanConfigurationController.php:514 +msgid "Postman can't find any way to send mail on your system. Run a connectivity test." +msgstr "Postman 在你的系统上无法找到任何发送邮件的方法。运行连接测试。" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:33 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Transport" +msgstr "交通" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:38 +msgctxt "(i.e.) What kind is it?" +msgid "Type" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:44 +msgctxt "The Message Sender Email Address" +msgid "From Address" +msgstr "消息发件人地址" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:70 +msgid "Additional Email Addresses" +msgstr "额外的邮件地址" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:75 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:220 +msgid "Reply-To" +msgstr "回复" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:80 +msgid "To Recipient(s)" +msgstr "收件人" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:85 +msgid "Carbon Copy Recipient(s)" +msgstr "抄送收件人" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:90 +msgid "Blind Carbon Copy Recipient(s)" +msgstr "匿名抄送收件人" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:96 +msgid "Additional Headers" +msgstr "附加头" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:101 +msgid "Custom Headers" +msgstr "自定义头" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:107 +msgid "Validation" +msgstr "Validation" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:118 +msgid "Email Log Settings" +msgstr "邮件日志设置" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:123 +msgid "Enable Logging" +msgstr "启用日志" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:128 +#: Postman/PostmanInputSanitizer.php:137 +msgid "Maximum Log Entries" +msgstr "日志最大数量" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:133 +msgid "Maximum Transcript Size" +msgstr "传输最大行数" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:139 +msgid "Network Settings" +msgstr "网络设置" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:144 +msgctxt "Configuration Input Field" +msgid "TCP Connection Timeout (sec)" +msgstr "TCP 连接超时（秒）" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:149 +msgctxt "Configuration Input Field" +msgid "TCP Read Timeout (sec)" +msgstr "TCP 读取超时（秒）" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:155 +msgctxt "Configuration Section Title" +msgid "Miscellaneous Settings" +msgstr "其它设置" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:160 +msgctxt "Configuration Input Field" +msgid "PHP Log Level" +msgstr "PHP 日志级别" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:165 +msgctxt "Configuration Input Field" +msgid "Delivery Mode" +msgstr "发送模式" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:170 +msgctxt "This mode removes the Postman X-Mailer signature from emails" +msgid "Stealth Mode" +msgstr "Stealth 模式" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:175 +msgid "Temporary Directory" +msgstr "Temporary 模式" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:186 +msgid "Choose SMTP or a vendor-specific API:" +msgstr "选择 SMTP 或提供者的 API：" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:189 +msgid "Configure the delivery audit log:" +msgstr "配置发送审计日志：" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:196 +msgid "This address, like the letterhead printed on a letter, identifies the sender to the recipient. Change this when you are sending on behalf of someone else, for example to use Google's Send Mail As feature. Other plugins, especially Contact Forms, may override this field to be your visitor's address." +msgstr "该地址类似于印在信纸上的信头，用于向收信人标识寄信人。当你在发送时，修改该值，以代表另外的人，例如为了使用 Google 的 Send Mail As 特性。其它插件，特别是 Contact Forms，可能会使用访问者的地址覆盖该值。" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:203 +msgid "Separate multiple to/cc/bcc recipients with commas." +msgstr "使用逗号分隔多个 to/cc/bcc 收件人。" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:210 +msgid "Increase the timeouts if your host is intermittenly failing to send mail. Be careful, this also correlates to how long your user must wait if the mail server is unreachable." +msgstr "如果你的主机经常发送邮件失败，请增加超时。注意，如果邮件服务器不可到达，这也会增加用户的等待时间。" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:221 +msgid "Specify custom headers (e.g. X-MC-Tags: wordpress-site-A), one per line. Use custom headers with caution as they can negatively affect your Spam score." +msgstr "每行一个自定义头（例如 X-MC-Tags: wordpress-site-A）。小心使用自定义头，因为它们可能会影响垃圾邮件评分。" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:228 +msgid "E-mail addresses can be validated before sending e-mail, however this may fail with some newer domains." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:254 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:276 +msgid "Prevent plugins and themes from changing this" +msgstr "阻止插件和主题修改" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:261 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:405 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:244 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:195 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:409 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:416 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:459 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:467 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:475 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:482 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:530 +msgid "Required" +msgstr "需要" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:268 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:531 +msgid "This address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +msgstr "该地址类似于印在信封上面的回信地址，用于向 SMTP 服务器标识账户所有者。" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:289 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:108 +msgid "Yes" +msgstr "是" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:290 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:109 +msgid "No" +msgstr "否" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:300 +msgid "Change this value if you can't see the beginning of the transcript because your messages are too big." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:343 +msgid "Disable e-mail validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:350 +msgid "Log Level specifies the level of detail written to the WordPress Debug log - view the log with Debug." +msgstr "日志级别指定写入到 WordPress 日志的详细信息的级别。使用 Debug 查看日志。Delivery 模式提供了帮助开发和测试的有用设置。" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:353 +msgid "Off" +msgstr "關閉" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:354 +msgid "Trace" +msgstr "Trace" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:355 +msgid "Debug" +msgstr "调试" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:356 +msgid "Info" +msgstr "信息" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:358 +msgid "Error" +msgstr "错误" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:366 +msgid "Delivery mode offers options useful for developing or testing." +msgstr "Delivery 模式提供了帮助开发和测试的有用设置。" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:369 +msgctxt "When the server is online to the public, this is \"Production\" mode" +msgid "Log Email and Send" +msgstr "记录邮件和发送" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:370 +msgid "Log Email and Delete" +msgstr "记录邮件并删除" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:371 +msgid "Delete All Emails" +msgstr "删除所有邮件" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:375 +msgid "Remove the Postman X-Header signature from messages" +msgstr "从消息中移除 Postman X-Header 签名" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:378 +msgid "Lockfiles are written here to prevent users from triggering an OAuth 2.0 token refresh at the same time." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:381 +msgid "Valid" +msgstr "有效" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:383 +msgid "Invalid" +msgstr "错误" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:105 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:109 +msgctxt "The \"please wait\" message" +msgid "Checking.." +msgstr "正在检测.." + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:106 +msgctxt "The port is open" +msgid "Open" +msgstr "打开" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:107 +msgctxt "The port is closed" +msgid "Closed" +msgstr "关闭" + +#. translators: where %d is a port number +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:111 +msgid "No outbound route between this site and the Internet on Port %d." +msgstr "本站与 Internet 在端口 %d 之间没有路由。" + +#. translators: where %d is a port number and %s is a hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:113 +msgid "Port %d is open, but not to %s." +msgstr "端口 %d 已经打开，但是不能 %s。" + +#. translators: where %d is the port number and %s is the hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:115 +msgid "Port %d can be used for SMTP to %s." +msgstr "端口 %d 可以供 SMTP 到 %s。" + +#. translators: where %d is a port number and %s is the URL for the Postman +#. Gmail Extension +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:118 +msgid "Port %d can be used with the %s." +msgstr "端口 %d 可以通过 %s 发送 email。" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:141 +msgid "This test determines which well-known ports are available for Postman to use." +msgstr "测试确定 Postman 可以使用的一般端口。" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:145 +msgctxt "Button Label" +msgid "Begin Test" +msgstr "开始测试" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:162 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:152 +msgid "Status" +msgstr "情况" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Service Available" +msgstr "可用的服务" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Server ID" +msgstr "" + +#. Translators: Meaning "Not Applicable" +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:155 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:260 +msgid "n/a" +msgstr "无" + +#. Translators: Where %s is the name of the service providing Internet +#. connectivity test +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:160 +msgid "According to %s" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:163 +msgid "Summary" +msgstr "概要" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:168 +msgid "A test with \"No\" Service Available indicates one or more of these issues:" +msgstr "端口与 Service Available \"No\" 表示下列一个或多个问题：" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:170 +msgid "Your web host has placed a firewall between this site and the Internet" +msgstr "web 主机在本站与 Internet 之间设置了防火墙" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:171 +msgid "The SMTP hostname is wrong or the mail server does not provide service on this port" +msgstr "SMTP 主机名错误，或邮件服务器没有在该端口提供服务" + +#. translators: where (1) is the URL and (2) is the system +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:173 +msgid "Your %2$s configuration is preventing outbound connections" +msgstr "%2$s 设置阻止了出站连接" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:177 +msgid "If the issues above can not be resolved, your last option is to configure Postman to use an email account managed by your web host with an SMTP server managed by your web host." +msgstr "如果上述问题没有解决，最后可选设置是，配置 Postman 使用一个你自己的运行有 SMTP 服务器的 web 主机的邮件账号。" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:82 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman.php:317 +msgctxt "The log of Emails that have been delivered" +msgid "Email Log" +msgstr "邮件日志" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:95 +msgid "Error: Postman is missing a required PHP library." +msgstr "错误：Postman 无法找到一个必须的 PHP 库。" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:97 +#: Postman/Postman.php:257 +msgid "Postman: wp_mail has been declared by another plugin or theme, so you won't be able to use Postman until the conflict is resolved." +msgstr "Postman：另外的插件或主题已经声明了 wp_mail，无法启用 Postman，除非该冲突解决。" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:100 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:229 +msgid "Postman is in non-Production mode and is dumping all emails." +msgstr "Postman 运行在 非生产环境，所有邮件都会被记录。" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:102 +msgid "Postman is configured and has delivered %d email." +msgid_plural "Postman is configured and has delivered %d emails." +msgstr[0] "Postman 已经配置完毕，已经发送了 %d 封邮件。" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:104 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:234 +msgid "Postman is not configured and is mimicking out-of-the-box WordPress email delivery." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:116 +msgid "Postman is operating in per-site mode." +msgstr "Postman 运行在 per-site 模式。" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:102 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:107 +#: Postman/PostmanViewController.php:295 +msgid "Diagnostic Test" +msgstr "诊断测试" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:104 +msgid "Are you having issues with Postman?" +msgstr "对 Postman 有问题？" + +#. translators: where %1$s and %2$s are the URLs to the Troubleshooting and +#. Support Forums on WordPress.org +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:106 +msgid "Please check the troubleshooting and error messages page and the support forum." +msgstr "请查看解决故障和错误消息页面以及支持论坛。" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:108 +msgid "If you write for help, please include the following:" +msgstr "如果你寻求帮助，请包含以下内容：" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:90 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:242 +msgid "Your message was delivered (%d ms) to the SMTP server! Congratulations :)" +msgstr "你的消息已经被发送到 SMTP 服务器（%d ms）！祝贺 :)" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:156 +msgid "Mail Log Entries were deleted." +msgstr "邮件日志已被删除。" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:179 +msgid "Mail Log Entry was deleted." +msgstr "邮件日志已被删除。" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:204 +msgctxt "Who is this message From?" +msgid "From" +msgstr "发件人" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:208 +msgctxt "Who is this message To?" +msgid "To" +msgstr "收件人" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:212 +msgctxt "Who is this message Cc'd to?" +msgid "Cc" +msgstr "抄送" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:216 +msgctxt "Who is this message Bcc'd to?" +msgid "Bcc" +msgstr "隐藏抄送" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:222 +msgctxt "What is the date today?" +msgid "Date" +msgstr "日期" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:223 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:161 +msgctxt "What is the subject of this message?" +msgid "Subject" +msgstr "主题" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:226 +msgctxt "What is the unique URI of the configuration?" +msgid "Delivery-URI" +msgstr "发送 URI" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:253 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:161 +msgid "This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +msgstr "这是 Postman 和你自己的 SMTP 服务器之间的相互转换，对于诊断问题很有帮助。不要在线上使用，因为可能包含你的账户密码。" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +msgid "%s Email Log" +msgstr "%s 邮件日志" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:301 +msgid "Email was successfully resent (but without attachments)" +msgstr "" + +#. Translators: Where %s is an error message +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:303 +msgid "Email could not be resent. Error: %s" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:304 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:110 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:112 +msgid "Resend" +msgstr "重新发送" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:339 +msgid "This is a record of deliveries made to the mail server. It does not neccessarily indicate sucessful delivery to the recipient." +msgstr "这是为 Mail Submission Agent (MSA) 提供的发送记录，并不代表已经成功发送给收件人。" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:37 +msgctxt "The group of Emails that have been delivered" +msgid "Sent Emails" +msgstr "已发送邮件" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:38 +msgctxt "An Email that has been delivered" +msgid "Sent Email" +msgstr "已发送邮件" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +msgid "An empty subject line can result in delivery failure." +msgstr "空白的主题行可能会导致发送失败。" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:196 +msgid ".. +%d more" +msgstr ".. +%d 更多" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:99 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:223 +msgctxt "Delete an item from the email log" +msgid "Delete" +msgstr "删除" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:100 +msgctxt "View an item from the email log" +msgid "View" +msgstr "查看" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:104 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:106 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:158 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:163 +msgid "Session Transcript" +msgstr "会话副本" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:163 +msgctxt "When was this email sent?" +msgid "Delivery Time" +msgstr "发送时间" + +#. Translators: where %s indicates the relative time from now +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:332 +msgctxt "A relative time as in \"five days ago\"" +msgid "%s ago" +msgstr "%s 之前" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:338 +msgid "Sent" +msgstr "已发送" + +#: Postman/Postman-Mail/PostmanDefaultModuleTransport.php:107 +msgid "Default" +msgstr "缺省" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:102 +msgid "Gmail API" +msgstr "Gmail API" + +#. translators: where (1) is the secure icon and (2) is the transport name +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:152 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:135 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:79 +msgid "Postman will send mail via the %1$s %2$s." +msgstr "Postman 将通过 %1$s %2$s 使用 %s 验证发送邮件。" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:166 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:117 +msgid "You have configured OAuth 2.0 authentication, but have not received permission to use it." +msgstr "已经设置好 QAuth 2.0 验证，但是没有收到使用权限。" + +#. translators: where variables are (1) transport name (2) host and (3) port +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:206 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:181 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:125 +msgid "Postman recommends the %1$s to host %2$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:221 +#: Postman/Postman-Mail/PostmanModuleTransport.php:713 +msgid "OAuth 2.0 (requires Client ID and Client Secret)" +msgstr "QAuth 2.0（要求 Client ID 和 Client Secret）" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:44 +msgid "Mandrill API" +msgstr "Mandrill API" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:147 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:101 +msgid "API Key can not be empty" +msgstr "" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:151 +#: Postman/Postman-Mail/PostmanModuleTransport.php:578 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:105 +msgid "Message From Address can not be empty" +msgstr "信封发件人地址和消息发件人地址不能为空。" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:194 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:228 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:271 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:148 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:182 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:222 +msgid "API Key" +msgstr "" + +#. Translators: Where (1) is the service URL and (2) is the service name and +#. (3) is a api key URL +#: Postman/Postman-Mail/PostmanMandrillTransport.php:238 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:189 +msgid "Create an account at %2$s and enter an API key below." +msgstr "" + +#. translators: where (1) is the transport type, (2) is the host, and (3) is +#. the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 +#. using OAuth 2.0 authentication.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:506 +msgid "Postman will send mail via %1$s to %2$s using %3$s authentication." +msgstr "Postman 将通过 %1$s 向 %2$s 使用 %3$s 验证方式发送邮件。" + +#. translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s +#. is the encryption type (e.g. SSL or TLS) +#: Postman/Postman-Mail/PostmanModuleTransport.php:534 +msgctxt "as in \"There is no Spoon\"" +msgid "no" +msgstr "没有" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:553 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:366 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:584 +msgid "Password" +msgstr "密码" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:584 +msgid "OAuth 2.0 authentication requires a %1$s and %2$s." +msgstr "OAuth 2.0 验证需要 %1$s 和 %2$s。" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:706 +msgid "Password (requires username and password)" +msgstr "密码（要求用户名和密码）" + +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 +msgid "MyMail: Change the delivery method in the %s!" +msgstr "" + +#: Postman/Postman-Mail/PostmanSendGridTransport.php:39 +msgid "SendGrid API" +msgstr "SendGrid API" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:95 +msgid "Outgoing Mail Server Hostname and Port can not be empty." +msgstr "发送邮件服务器主机名和端口不能为空。" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:99 +msgid "Envelope-From Email Address can not be empty" +msgstr "信封发件人地址和消息发件人地址不能为空。" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:103 +msgid "Username and password can not be empty." +msgstr "密码验证（Plain/Login/CRAM-MD5）要求用户名和密码。" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:109 +msgid "OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing Mail Server." +msgstr "OAuth 2.0 验证要求兼容 OAuth 2.0 的发送邮件服务器。" + +#. translators: where %1$s is a description of the transport (eg. SMTPS-SSL), +#. %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is +#. the TCP port (eg. 465), %4$d is the hostname +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:269 +msgid "Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d." +msgstr "你的推荐设置是使用 %2$s 验证的 %1$s，主机为 %4$s，端口号 %3$d。" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:326 +msgid "Transport Settings" +msgstr "传输设置" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:336 +msgid "Outgoing Mail Server Port" +msgstr "发送邮件服务器端口" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:341 +msgid "Envelope-From Email Address" +msgstr "信封发件人地址" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:346 +msgctxt "Configuration Input Field" +msgid "Security" +msgstr "安全" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:361 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:580 +msgid "Username" +msgstr "用户名" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:402 +msgid "Configure the communication with the mail server." +msgstr "设置与 Mail Submission Agent (MSA) 的通讯：" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:449 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:579 +msgid "Enter the account credentials." +msgstr "输入账户用户名（邮件地址）和密码." + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:457 +msgid "The Username is usually the same as the Envelope-From Email Address." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:511 +msgid "Error computing your domain root - please enter it manually" +msgstr "无法计算域名的根，请手动输入" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:532 +msgid "For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:539 +msgctxt "Wizard Step Title" +msgid "Which host will relay the mail?" +msgstr "哪个主机回复邮件？" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:540 +msgid "This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), which Postman delegates mail delivery to. This server is specific to your email account, and if you don't know what to use, ask your email service provider." +msgstr "这是 Postman 代理发送邮件的出站（SMTP）邮件服务器，或者 Mail Submission Agent (MSA)。该服务器由邮件账户指定，如果你不知道该使用什么，询问你的邮件服务提供商。" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:541 +msgid "Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, require that you use their mail accounts with their mail servers, and prevent you from using others." +msgstr "注意，很多 WordPress 托管商，比如 GoDaddy、Bluehost 和 Dreamhost，要求你使用他们的邮件帐户和邮件服务器，并且不允许你使用另外的。" + +#. Translators: Where (%s) is the name of the web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:547 +msgid "Your email address requires access to a remote SMTP server blocked by %s." +msgstr "你的邮件地址要求访问一个被 %s 阻止的远程 SMTP 服务器。" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:548 +msgid "If you have access to cPanel, enable the Remote Mail Exchanger." +msgstr "" + +#. Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the +#. web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:551 +msgid "If you own this domain, make sure it has an SPF record authorizing %2$s as a relay, or you will have delivery problems." +msgstr "如果你拥有这个域名，确保它有 SPF record authorizing GoDaddy 作为回复，否则你可能会有发送的问题。" + +#: Postman/Postman-Mail/PostmanTransportRegistry.php:231 +msgid "Postman is configured." +msgstr "Postman 配置完成。" + +#: Postman/Postman-Mail/PostmanZendMailEngine.php:209 +msgid "Communication Error [334] - make sure the Envelope From email is the same account used to create the Client ID." +msgstr "通信错误 [334] - 确认信封发件人邮件地址与创建 Client ID 的地址是同一个。" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:115 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:149 +msgctxt "Email Test Status" +msgid "In Outbox" +msgstr "发件箱" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:116 +msgctxt "Email Test Status" +msgid "Sending..." +msgstr "正在发送..." + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:117 +msgctxt "Email Test Status" +msgid "Success" +msgstr "成功" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:118 +msgctxt "Email Test Status" +msgid "Failed" +msgstr "失败" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:119 +msgid "Ajax Error" +msgstr "Ajax 错误" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:128 +#: Postman/PostmanViewController.php:273 Postman/PostmanViewController.php:275 +msgid "Send a Test Email" +msgstr "发送测试邮件" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:133 +msgid "Specify the Recipient" +msgstr "指定收件人" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:135 +msgid "Who is this message going to?" +msgstr "这条消息将发送给谁？" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:136 +msgid "This utility allows you to send an email message for testing." +msgstr "这个工具允许你发送邮件消息进行测试。" + +#. translators: where %d is an amount of time, in seconds +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:139 +msgid "If there is a problem, Postman will give up after %d second." +msgid_plural "If there is a problem, Postman will give up after %d seconds." +msgstr[0] "如果有问题，Postman 将在 %d 秒后放弃。" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:140 +msgctxt "Configuration Input Field" +msgid "Recipient Email Address" +msgstr "收件人地址" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:145 +msgid "Send The Message" +msgstr "发送消息" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:148 +msgid "Sending the message:" +msgstr "发送消息：" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:160 +msgid "Examine the Session Transcript if you need to." +msgstr "如果需要，检查 SMTP 会话副本。" + +#. translators: where %s is the domain name of the site +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:212 +msgctxt "Test Email Subject" +msgid "Postman SMTP Test (%s)" +msgstr "Postman SMTP 测试 (%s)" + +#. translators: where %s is the Postman plugin version number (e.g. 1.4) +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:299 +msgctxt "Test Email Tagline" +msgid "Sent by Postman %s" +msgstr "通过 Postman %s 发送" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:300 +msgid "Image source" +msgstr "图片源" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:301 +msgid "Used with permission" +msgstr "授权使用" + +#: Postman/PostmanAdminController.php:111 +msgctxt "The plugin successfully saved new settings." +msgid "Settings saved." +msgstr "设置已保存。" + +#. Translators: where %1$s is the name of the library +#: Postman/PostmanAdminController.php:178 +msgid "This PHP installation requires the %1$s library." +msgstr "PHP 安装要求 %1$s。" + +#: Postman/PostmanAdminController.php:253 +msgid "There was an error importing the data." +msgstr "" + +#: Postman/PostmanAdminController.php:270 +msgid "Plugin data was removed." +msgstr "插件数据已被移除。" + +#: Postman/PostmanAdminController.php:294 +msgid "The OAuth 2.0 authorization was successful. Ready to send e-mail." +msgstr "OAuth 2.0 验证成功。准备发送邮件。" + +#: Postman/PostmanAdminController.php:296 +msgid "Your email provider did not grant Postman permission. Try again." +msgstr "你的邮件提供商没有给 Postman 授权。请重新尝试。" + +#: Postman/PostmanAdminController.php:299 +msgid "The grant code from Google had no accompanying state and may be a forgery" +msgstr "来自 Google 的授权码没有匹配的状态，可能是伪造的" + +#. translators: %s is the error message +#: Postman/PostmanAdminController.php:303 +msgid "Error authenticating with this Client ID. [%s]" +msgstr "该 Client ID 验证错误。[%s]" + +#: Postman/PostmanConfigTextHelper.php:31 +msgid "Attention" +msgstr "注意" + +#. translators: parameters available are 1=portal-url, 2=portal-name, +#. 3=clientId-name, 4=clientSecret-name, 5=callbackUrl, 6=service-name, +#. 7=portal-application (e.g. Open the Google Developer Console, create a +#. Client ID for web application using the URL's displayed below, and copy the +#. Client ID and Client Secret here.) +#: Postman/PostmanConfigTextHelper.php:33 +msgid "Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +msgstr "打开 %2$s，使用下面列出的值创建 %7$s，复制生成的 %3$s 并且 %4$s 这里。" + +#. translators: parameters available are 1=clientId-name, 2=service-name, +#. 3=FAQ-URL, 4=Video-URL (e.g. See How do I get a Google Client ID? in the +#. F.A.Q.) +#: Postman/PostmanConfigTextHelper.php:36 +msgid "See How do I get a %1$s %2$s? in the F.A.Q. or watch our How-To video 📺." +msgstr "详见 F.A.Q. 中的我怎样获得 %1$s %2$s？，或者观看我们的 How-To 视频 📺。" + +#. translators: where %s is the Email Service Owner (e.g. Google, Microsoft or +#. Yahoo) +#: Postman/PostmanConfigTextHelper.php:54 +msgctxt "Command to initiate OAuth authentication" +msgid "Grant permission with %s" +msgstr "使用 %s 授权" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:80 +#: Postman/PostmanConfigTextHelper.php:142 +#: Postman/PostmanConfigTextHelper.php:204 +#: Postman/PostmanConfigTextHelper.php:271 +msgctxt "Name of the OAuth 2.0 Client ID" +msgid "Client ID" +msgstr "Client ID" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:84 +#: Postman/PostmanConfigTextHelper.php:146 +#: Postman/PostmanConfigTextHelper.php:208 +#: Postman/PostmanConfigTextHelper.php:274 +msgctxt "Name of the OAuth 2.0 Client Secret" +msgid "Client Secret" +msgstr "Client Secret" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:88 +msgctxt "Name of the Application Callback URI" +msgid "Authorized redirect URI" +msgstr "已授权的重定向 URI" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:92 +msgctxt "Name of the Application Callback Domain" +msgid "Authorized JavaScript origins" +msgstr "已授权的 JavaScript 源" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:96 +msgctxt "Name of the email service owner" +msgid "Google" +msgstr "Google" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:100 +msgctxt "Name of the email service" +msgid "Gmail" +msgstr "Gmail" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:104 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "a Client ID for web application" +msgstr "web 应用程序的 Client ID" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:108 +msgctxt "Name of the email service portal" +msgid "Google Developers Console Gmail Wizard" +msgstr "Google Developers Console Gmail Wizard" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:150 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URL" +msgstr "重定向 URL" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:154 +msgctxt "Name of the Application Callback Domain" +msgid "Root Domain" +msgstr "根域名" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:158 +msgctxt "Name of the email service owner" +msgid "Microsoft" +msgstr "Microsoft" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:162 +msgctxt "Name of the email service" +msgid "Outlook.com" +msgstr "Outlook.com" + +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:166 +#: Postman/PostmanConfigTextHelper.php:228 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "an Application" +msgstr "应用程序" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:170 +msgctxt "Name of the email service portal" +msgid "Microsoft Developer Center" +msgstr "Microsoft Developer Center" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:212 +msgctxt "Name of the Application Callback URI" +msgid "Home Page URL" +msgstr "主页 URL" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:216 +msgctxt "Name of the Application Callback Domain" +msgid "Callback Domain" +msgstr "回调域名" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:220 +msgctxt "Name of the email service owner" +msgid "Yahoo" +msgstr "Yahoo" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:224 +msgctxt "Name of the email service" +msgid "Yahoo Mail" +msgstr "Yahoo Mail" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:232 +msgctxt "Name of the email service portal" +msgid "Yahoo Developer Network" +msgstr "Yahoo Developer Network" + +#: Postman/PostmanConfigTextHelper.php:261 +msgid "Enter an Outgoing Mail Server with OAuth2 capabilities." +msgstr "输入兼容 OAuth2 的发送邮件服务器。" + +#: Postman/PostmanConfigTextHelper.php:277 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URI" +msgstr "重定向 URI" + +#: Postman/PostmanConfigTextHelper.php:280 +msgctxt "Name of the Application Callback Domain" +msgid "Website Domain" +msgstr "网站域名" + +#: Postman/PostmanConfigTextHelper.php:304 +msgid "Grant OAuth 2.0 Permission" +msgstr "OAuth 2.0 授权" + +#: Postman/PostmanInputSanitizer.php:137 +msgid "must be greater than 0" +msgstr "必须大于 0" + +#: Postman/PostmanViewController.php:112 +msgid "An unexpected error occurred" +msgstr "" + +#: Postman/PostmanViewController.php:113 +msgid "Unexpected PHP messages corrupted the Ajax response" +msgstr "" + +#: Postman/PostmanViewController.php:118 +msgctxt "Press this button to Finish this task" +msgid "Finish" +msgstr "完成" + +#: Postman/PostmanViewController.php:119 +msgctxt "Press this button to go to the next step" +msgid "Next" +msgstr "下一步" + +#: Postman/PostmanViewController.php:120 +msgctxt "Press this button to go to the previous step" +msgid "Previous" +msgstr "上一步" + +#: Postman/PostmanViewController.php:132 +msgid "Postman is unable to run. Email delivery is being handled by WordPress (or another plugin)." +msgstr "Postman 没有 处理邮件发送。" + +#. translators: where %d is the number of emails delivered +#: Postman/PostmanViewController.php:147 +msgid "Postman has delivered %d email." +msgid_plural "Postman has delivered %d emails." +msgstr[0] "Postman 已经发送了 %d 封邮件。" + +#: Postman/PostmanViewController.php:150 +msgid "The last %d email attempts are recorded in the log." +msgstr "最新的 %d 封邮件记录在 该日志。" + +#: Postman/PostmanViewController.php:155 +msgid "Thank-you for choosing Postman!" +msgstr "感谢选择 Postman！" + +#. translators: where %s is the URL of the Setup Wizard +#: Postman/PostmanViewController.php:157 +msgid "Let's get started! All users are strongly encouraged to run the Setup Wizard." +msgstr "开始吧！我们强烈推荐运行安装向导。" + +#: Postman/PostmanViewController.php:158 +msgid "Alternately, manually configure your own settings and/or modify advanced options." +msgstr "另外，手动配置你自己的参数和高级设置。" + +#. translators: where %s is the URL to the WordPress.org review and ratings +#. page +#: Postman/PostmanViewController.php:163 +msgid "Please consider leaving a review to help spread the word! :D" +msgstr "请考虑留言帮助推广！:D" + +#: Postman/PostmanViewController.php:165 +msgid "Postman needs translators! Please take a moment to translate a few sentences on-line" +msgstr "" + +#: Postman/PostmanViewController.php:167 +msgid "New for v1.7! Send mail with the Mandrill or SendGrid APIs." +msgstr "" + +#: Postman/PostmanViewController.php:191 +msgctxt "Return to main menu link" +msgid "Back To Main Menu" +msgstr "返回到主菜单" + +#: Postman/PostmanViewController.php:198 Postman/PostmanViewController.php:233 +#: Postman/PostmanViewController.php:284 +msgid "Import" +msgstr "汇入" + +#: Postman/PostmanViewController.php:199 Postman/PostmanViewController.php:285 +msgid "Export" +msgstr "出口" + +#: Postman/PostmanViewController.php:200 Postman/PostmanViewController.php:286 +msgid "Reset Plugin" +msgstr "重置插件" + +#: Postman/PostmanViewController.php:206 +msgid "Copy this data into another instance of Postman to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:225 +msgid "Paste data from another instance of Postman here to duplicate the configuration." +msgstr "" + +#: Postman/PostmanViewController.php:228 +msgid "Using the same OAuth 2.0 Client ID and Client Secret from this site at the same time as another site will cause failures." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "This will purge all of Postman's settings, including account credentials and the email log." +msgstr "这将清除 Postman 的所有设置，包括账户信息和邮件日志。" + +#: Postman/PostmanViewController.php:241 +msgid "Are you sure?" +msgstr "确定吗？" + +#: Postman/PostmanViewController.php:261 +msgid "Configuration" +msgstr "配置" + +#: Postman/PostmanViewController.php:262 +msgid "Start the Wizard" +msgstr "开始向导" + +#: Postman/PostmanViewController.php:263 +msgid "Show All Settings" +msgstr "手动配置" + +#: Postman/PostmanViewController.php:266 +msgctxt "Main Menu" +msgid "Actions" +msgstr "动作" + +#: Postman/PostmanViewController.php:292 +msgctxt "Main Menu" +msgid "Troubleshooting" +msgstr "解决故障" + +#: Postman/PostmanViewController.php:296 +msgid "Online Support" +msgstr "在线支持" + +#. Plugin URI of the plugin/theme +msgid "https://wordpress.org/plugins/postman-smtp/" +msgstr "https://cn.wordpress.org/plugins/postman-smtp/" + +#. Description of the plugin/theme +msgid "Email not reliable? Postman is the first and only WordPress SMTP plugin to implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze with the Configuration Wizard and integrated Port Tester. Enjoy worry-free delivery even if your password changes!" +msgstr "邮件不可信？Postman 是第一个也是唯一一个为 Gmail，Hotmail 和 Yahoo Mail 实现了 OAuth 2.0 的 WordPress SMTP 插件。使用配置向导和集成的端口测试工具可以轻而易举的安装。尽情享受什么都不用担心的发送，即使你修改了密码！" + +#. Author of the plugin/theme +msgid "Jason Hendriks" +msgstr "Jason Hendriks" + +#. Author URI of the plugin/theme +msgid "http://www.codingmonkey.ca" +msgstr "http://www.codingmonkey.ca" + +#~ msgid "Change the delivery method on the %s!" +#~ msgstr "在 %s 修改发送方法！" + +#~ msgid "Configure the plugin." +#~ msgstr "配置插件。" + +#~ msgctxt "Configuration Section Title" +#~ msgid "Test Your Setup" +#~ msgstr "测试安装信息" + +#~ msgctxt "eg. TCP Port 25" +#~ msgid "Port" +#~ msgstr "端口" + +#~ msgid "Port %d can be used to send email with the %s." +#~ msgstr "端口 %d 可以通过 %s 发送 email。" + +#~ msgctxt "as in \"There is no Authentication\"" +#~ msgid "no" +#~ msgstr "没有" + +#~ msgctxt "Log Level" +#~ msgid "Off" +#~ msgstr "Off" + +#~ msgctxt "Log Level" +#~ msgid "Trace" +#~ msgstr "Trace" + +#~ msgctxt "Log Level" +#~ msgid "Debug" +#~ msgstr "Debug" + +#~ msgctxt "Log Level" +#~ msgid "Info" +#~ msgstr "Info" + +#~ msgctxt "Log Level" +#~ msgid "Warning" +#~ msgstr "警告" + +#~ msgctxt "Log Level" +#~ msgid "Error" +#~ msgstr "Error" + +#~ msgid "Warning: An empty subject line can result in delivery failure." +#~ msgstr "警告：空白的主题行可能会导致发送失败。" + +#~ msgid "The Envelope-From Email Address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +#~ msgstr "该地址类似于印在信封上面的回信地址，用于向 SMTP 服务器标识账户所有者。" + +#~ msgid "Warning: connected to %1$s instead of %2$s." +#~ msgstr "警告：连接到 %1$s 而不是 %2$s。" + +#~ msgid "Warning: This configuration option will send your authorization credentials in the clear." +#~ msgstr "警告：该配置项将会发送你的验证凭证。" + +#~ msgid " must be greater than 0" +#~ msgstr "必须大于 0" + +#~ msgid "If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems. If you have access to cPanel, enable the Remote Mail Exchanger." +#~ msgstr "如果你拥有这个域名，确保它有 SPF record authorizing GoDaddy 作为回复，否则你可能会有发送的问题。" + +#~ msgid "Error: Your email address requires access to a remote SMTP server blocked by GoDaddy. Use a different e-mail address." +#~ msgstr "错误：你的邮件地址要求访问一个被 GoDaddy 阻止的远程 SMTP 服务器。使用另外的电子邮件地址。" + +#~ msgid "Enter your credentials. Your username is often your email address." +#~ msgstr "输入账户用户名（邮件地址）和密码：" + +#~ msgid "Envelope Email Address can not be empty" +#~ msgstr "信封发件人地址和消息发件人地址不能为空。" + +#~ msgid "Envelope Email Address" +#~ msgstr "信封发件人地址" + +#~ msgid "The Envelope Email Address, like the return address printed on an envelope, identifies the account owner to the SMTP server." +#~ msgstr "该地址类似于印在信封上面的回信地址，用于向 SMTP 服务器标识账户所有者。" + +#~ msgid "Warning: If you own this domain, make sure it has an SPF record authorizing GoDaddy as a relay, or you will have delivery problems. If you have access to cPanel, enable the Remote Mail Exchanger." +#~ msgstr "警告：如果你拥有这个域名，确保它有 SPF record authorizing GoDaddy 作为回复，否则你可能会有发送的问题。" + +#~ msgid "Attention! Open the %2$s, create %7$s with the values displayed below, and copy the generated %3$s and %4$s here." +#~ msgstr "注意！打开 %2$s，使用下面列出的值创建 %7$s，复制生成的 %3$s 并且 %4$s 这里。" + +#~ msgid "Maximum Number of Log Entries" +#~ msgstr "日志最大数量" + +#~ msgid "%s SMTP Setup" +#~ msgstr "%s SMTP 安装" + +#~ msgctxt "View the transcript of an item from the email log" +#~ msgid "Transcript" +#~ msgstr "副本" + +#~ msgid "Log Level specifies the level of detail written to the WordPress log - view the log with Debug. Delivery mode offers options useful for developing or testing." +#~ msgstr "日志级别指定写入到 WordPress 日志的详细信息的级别。使用 Debug 查看日志。Delivery 模式提供了帮助开发和测试的有用设置。" + +#~ msgctxt "Email Test Status" +#~ msgid "Ajax Error" +#~ msgstr "Ajax 错误" + +#~ msgid "Unexpected PHP messages corrupted the Ajax response:" +#~ msgstr "PHP 错误信息中断了 Ajax 响应:" + +#~ msgctxt "Adjust the Postman settings by hand" +#~ msgid "Show Advanced Configuration" +#~ msgstr "现实高级设置" + +#~ msgid "Disable" +#~ msgstr "禁用" + +#~ msgctxt "As in type used: None" +#~ msgid "None" +#~ msgstr "无" + +#~ msgctxt "Who do we reply to?" +#~ msgid "Reply-To" +#~ msgstr "回复" + +#~ msgid "This is the conversation between Postman and your SMTP server. It can be useful for diagnosing problems. DO NOT post it on-line, it may contain your account password." +#~ msgstr "这是 Postman 和你自己的 SMTP 服务器之间的相互转换，对于诊断问题很有帮助。不要在线上使用，因为可能包含你的账户密码。" + +#~ msgid "This is a record of deliveries made to the Mail Submission Agent (MSA). It does not neccessarily indicate sucessful delivery to the recipient." +#~ msgstr "这是为 Mail Submission Agent (MSA) 提供的发送记录，并不代表已经成功发送给收件人。" + +#~ msgid "Postman is not handling email delivery." +#~ msgstr "WordPress（或其它插件）正在处理邮件发送，不是 Postman。" diff --git a/Postman/languages/postman-smtp.pot b/Postman/languages/postman-smtp.pot new file mode 100644 index 0000000..1f3c701 --- /dev/null +++ b/Postman/languages/postman-smtp.pot @@ -0,0 +1,1498 @@ +# Copyright (C) 2015 Postman SMTP +# This file is distributed under the same license as the Postman SMTP package. +msgid "" +msgstr "" +"Project-Id-Version: Postman SMTP 1.7.1\n" +"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/postman-smtp\n" +"POT-Creation-Date: 2015-11-08 22:09:18+00:00\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"PO-Revision-Date: 2015-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:94 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:348 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:357 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:99 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:545 +#: Postman/PostmanViewController.php:227 +msgid "Warning" +msgstr "" + +#. translators: where %s is the name of the SMTP server +#: Postman/Postman-Configuration/PostmanConfigurationController.php:96 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:116 +msgid "connected to %1$s instead of %2$s." +msgstr "" + +#. translators: where %d is a port number +#: Postman/Postman-Configuration/PostmanConfigurationController.php:98 +msgid "" +"You are about to configure OAuth 2.0 with an IP address instead of a domain " +"name. This is not permitted. Either assign a real domain name to your site " +"or add a fake one in your local host file." +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/PostmanViewController.php:53 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "%s Setup" +msgstr "" + +#. #-#-#-#-# plugin.pot (Postman SMTP 1.7.1) #-#-#-#-# +#. Plugin Name of the plugin/theme +#: Postman/Postman-Configuration/PostmanConfigurationController.php:132 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:157 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:83 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:57 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:70 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:81 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:176 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:95 +#: Postman/Postman.php:61 Postman/PostmanViewController.php:53 +#: Postman/PostmanViewController.php:54 Postman/PostmanViewController.php:76 +#: Postman/PostmanViewController.php:184 Postman/PostmanViewController.php:256 +msgid "Postman SMTP" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:196 +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:81 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 Postman/Postman.php:316 +#: Postman/PostmanAdminController.php:225 +msgid "Settings" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:198 +msgid "Account" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:199 +msgid "Message" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:200 +msgid "Logging" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:201 +msgid "Advanced" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:263 +msgid "Setup Wizard" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:296 +msgctxt "Wizard Step Title" +msgid "Import Configuration" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:298 +msgctxt "Wizard Step Title" +msgid "Import configuration from another plugin?" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:299 +msgid "" +"If you had a working configuration with another Plugin, the Setup Wizard can " +"begin with those settings." +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:301 +#: Postman/Postman-Mail/PostmanModuleTransport.php:720 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:425 +msgid "None" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:312 +msgctxt "Wizard Step Title" +msgid "Sender Details" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:314 +msgctxt "Wizard Step Title" +msgid "Who is the mail coming from?" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:315 +msgid "Enter the email address and name you'd like to send mail as." +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:316 +msgid "" +"Please note that to prevent abuse, many email services will not let " +"you send from an email address other than the one you authenticate with." +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:317 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:49 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:112 +msgid "Email Address" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:320 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:59 +msgid "Name" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:325 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:143 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:331 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:542 +msgid "Outgoing Mail Server Hostname" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:333 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:138 +#: Postman/PostmanViewController.php:294 +msgid "Connectivity Test" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:335 +msgid "How will the connection to the mail server be established?" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:336 +msgid "" +"Your connection settings depend on what your email service provider offers, " +"and what your WordPress host allows." +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:337 +msgctxt "TCP Port Test Status" +msgid "Ready" +msgstr "" + +#. Translators: Where %1$s is the socket identifier and %2$s is the +#. authentication type +#: Postman/Postman-Configuration/PostmanConfigurationController.php:345 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgctxt "A socket is the network term for host and port together" +msgid "Socket" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:346 +#: Postman/Postman-Configuration/PostmanConfigurationController.php:354 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:223 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:177 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:351 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:356 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:372 +msgid "Authentication" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:349 +msgid "" +"This configuration option will send your authorization credentials in the " +"clear." +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:356 +msgid "How will you prove your identity to the mail server?" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:363 +msgctxt "The final step of the Wizard" +msgid "Finish" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:365 +msgctxt "Wizard Step Title" +msgid "You're Done!" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:367 +msgid "Click Finish to save these settings, then:" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:369 +msgid "Grant permission with the Email Provider for Postman to send email and" +msgstr "" + +#: Postman/Postman-Configuration/PostmanConfigurationController.php:370 +msgid "Send yourself a Test Email to make sure everything is working!" +msgstr "" + +#. translators: where %s is the URL to the Connectivity Test page +#: Postman/Postman-Configuration/PostmanConfigurationController.php:514 +msgid "" +"Postman can't find any way to send mail on your system. Run a connectivity test." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:33 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Transport" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:38 +msgctxt "(i.e.) What kind is it?" +msgid "Type" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:44 +msgctxt "The Message Sender Email Address" +msgid "From Address" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:70 +msgid "Additional Email Addresses" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:75 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:220 +msgid "Reply-To" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:80 +msgid "To Recipient(s)" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:85 +msgid "Carbon Copy Recipient(s)" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:90 +msgid "Blind Carbon Copy Recipient(s)" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:96 +msgid "Additional Headers" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:101 +msgid "Custom Headers" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:107 +msgid "Validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:118 +msgid "Email Log Settings" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:123 +msgid "Enable Logging" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:128 +#: Postman/PostmanInputSanitizer.php:137 +msgid "Maximum Log Entries" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:133 +msgid "Maximum Transcript Size" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:139 +msgid "Network Settings" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:144 +msgctxt "Configuration Input Field" +msgid "TCP Connection Timeout (sec)" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:149 +msgctxt "Configuration Input Field" +msgid "TCP Read Timeout (sec)" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:155 +msgctxt "Configuration Section Title" +msgid "Miscellaneous Settings" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:160 +msgctxt "Configuration Input Field" +msgid "PHP Log Level" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:165 +msgctxt "Configuration Input Field" +msgid "Delivery Mode" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:170 +msgctxt "This mode removes the Postman X-Mailer signature from emails" +msgid "Stealth Mode" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:175 +msgid "Temporary Directory" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:186 +msgid "Choose SMTP or a vendor-specific API:" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:189 +msgid "Configure the delivery audit log:" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:196 +msgid "" +"This address, like the letterhead printed on a letter, identifies the " +"sender to the recipient. Change this when you are sending on behalf of " +"someone else, for example to use Google's Send Mail As " +"feature. Other plugins, especially Contact Forms, may override this field to " +"be your visitor's address." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:203 +msgid "" +"Separate multiple to/cc/bcc recipients with commas." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:210 +msgid "" +"Increase the timeouts if your host is intermittenly failing to send mail. Be " +"careful, this also correlates to how long your user must wait if the mail " +"server is unreachable." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:221 +msgid "" +"Specify custom headers (e.g. X-MC-Tags: wordpress-site-A), one " +"per line. Use custom headers with caution as they can negatively affect your " +"Spam score." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:228 +msgid "" +"E-mail addresses can be validated before sending e-mail, however this may " +"fail with some newer domains." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:254 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:276 +msgid "Prevent plugins and themes from changing this" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:261 +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:405 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:244 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:195 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:409 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:416 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:459 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:467 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:475 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:482 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:530 +msgid "Required" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:268 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:531 +msgid "" +"This address, like the return address printed on an envelope, " +"identifies the account owner to the SMTP server." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:289 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:108 +msgid "Yes" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:290 +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:109 +msgid "No" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:300 +msgid "" +"Change this value if you can't see the beginning of the transcript because " +"your messages are too big." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:343 +msgid "Disable e-mail validation" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:350 +msgid "" +"Log Level specifies the level of detail written to the WordPress Debug log - view the log with Debug." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:353 +msgid "Off" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:354 +msgid "Trace" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:355 +msgid "Debug" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:356 +msgid "Info" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:358 +msgid "Error" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:366 +msgid "Delivery mode offers options useful for developing or testing." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:369 +msgctxt "When the server is online to the public, this is \"Production\" mode" +msgid "Log Email and Send" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:370 +msgid "Log Email and Delete" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:371 +msgid "Delete All Emails" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:375 +msgid "Remove the Postman X-Header signature from messages" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:378 +msgid "" +"Lockfiles are written here to prevent users from triggering an OAuth 2.0 " +"token refresh at the same time." +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:381 +msgid "Valid" +msgstr "" + +#: Postman/Postman-Configuration/PostmanRegisterConfigurationSettings.php:383 +msgid "Invalid" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:105 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:109 +msgctxt "The \"please wait\" message" +msgid "Checking.." +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:106 +msgctxt "The port is open" +msgid "Open" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:107 +msgctxt "The port is closed" +msgid "Closed" +msgstr "" + +#. translators: where %d is a port number +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:111 +msgid "No outbound route between this site and the Internet on Port %d." +msgstr "" + +#. translators: where %d is a port number and %s is a hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:113 +msgid "Port %d is open, but not to %s." +msgstr "" + +#. translators: where %d is the port number and %s is the hostname +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:115 +msgid "Port %d can be used for SMTP to %s." +msgstr "" + +#. translators: where %d is a port number and %s is the URL for the Postman +#. Gmail Extension +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:118 +msgid "Port %d can be used with the %s." +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:141 +msgid "" +"This test determines which well-known ports are available for Postman to use." +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:145 +msgctxt "Button Label" +msgid "Begin Test" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:162 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:152 +msgid "Status" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Service Available" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:148 +msgid "Server ID" +msgstr "" + +#. Translators: Meaning "Not Applicable" +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:155 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:260 +msgid "n/a" +msgstr "" + +#. Translators: Where %s is the name of the service providing Internet +#. connectivity test +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:160 +msgid "According to %s" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:163 +msgid "Summary" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:168 +msgid "" +"A test with \"No\" Service Available " +"indicates one or more of these issues:" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:170 +msgid "Your web host has placed a firewall between this site and the Internet" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:171 +msgid "" +"The SMTP hostname is wrong or the mail server does not provide service on " +"this port" +msgstr "" + +#. translators: where (1) is the URL and (2) is the system +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:173 +msgid "" +"Your %2$s configuration is preventing outbound " +"connections" +msgstr "" + +#: Postman/Postman-Connectivity-Test/PostmanConnectivityTestController.php:177 +msgid "" +"If the issues above can not be resolved, your last option is to configure " +"Postman to use an email account managed by your web host with an SMTP server " +"managed by your web host." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:82 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman.php:317 +msgctxt "The log of Emails that have been delivered" +msgid "Email Log" +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:95 +msgid "Error: Postman is missing a required PHP library." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:97 +#: Postman/Postman.php:257 +msgid "" +"Postman: wp_mail has been declared by another plugin or theme, so you won't " +"be able to use Postman until the conflict is resolved." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:100 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:229 +msgid "Postman is in non-Production mode and is dumping all emails." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:102 +msgid "" +"Postman is configured and has delivered " +"%d email." +msgid_plural "" +"Postman is configured and has delivered " +"%d emails." +msgstr[0] "" +msgstr[1] "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:104 +#: Postman/Postman-Mail/PostmanTransportRegistry.php:234 +msgid "" +"Postman is not configured and is mimicking out-of-the-box WordPress " +"email delivery." +msgstr "" + +#: Postman/Postman-Controller/PostmanDashboardWidgetController.php:116 +msgid "Postman is operating in per-site mode." +msgstr "" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:102 +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:107 +#: Postman/PostmanViewController.php:295 +msgid "Diagnostic Test" +msgstr "" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:104 +msgid "Are you having issues with Postman?" +msgstr "" + +#. translators: where %1$s and %2$s are the URLs to the Troubleshooting and +#. Support Forums on WordPress.org +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:106 +msgid "" +"Please check the troubleshooting and error messages " +"page and the support forum." +msgstr "" + +#: Postman/Postman-Diagnostic-Test/PostmanDiagnosticTestController.php:108 +msgid "If you write for help, please include the following:" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:90 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:242 +msgid "" +"Your message was delivered (%d ms) to the SMTP server! Congratulations :)" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:156 +msgid "Mail Log Entries were deleted." +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:179 +msgid "Mail Log Entry was deleted." +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:204 +msgctxt "Who is this message From?" +msgid "From" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:208 +msgctxt "Who is this message To?" +msgid "To" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:212 +msgctxt "Who is this message Cc'd to?" +msgid "Cc" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:216 +msgctxt "Who is this message Bcc'd to?" +msgid "Bcc" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:222 +msgctxt "What is the date today?" +msgid "Date" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:223 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:161 +msgctxt "What is the subject of this message?" +msgid "Subject" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:226 +msgctxt "What is the unique URI of the configuration?" +msgid "Delivery-URI" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:253 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:161 +msgid "" +"This is the conversation between Postman and the mail server. It can be " +"useful for diagnosing problems. DO NOT post it on-line, it may " +"contain your account password." +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:284 +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:333 +msgid "%s Email Log" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:301 +msgid "Email was successfully resent (but without attachments)" +msgstr "" + +#. Translators: Where %s is an error message +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:303 +msgid "Email could not be resent. Error: %s" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:304 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:110 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:112 +msgid "Resend" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogController.php:339 +msgid "" +"This is a record of deliveries made to the mail server. It does not " +"neccessarily indicate sucessful delivery to the recipient." +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:37 +msgctxt "The group of Emails that have been delivered" +msgid "Sent Emails" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogPostType.php:38 +msgctxt "An Email that has been delivered" +msgid "Sent Email" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:75 +msgid "An empty subject line can result in delivery failure." +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogService.php:196 +msgid ".. +%d more" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:99 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:223 +msgctxt "Delete an item from the email log" +msgid "Delete" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:100 +msgctxt "View an item from the email log" +msgid "View" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:104 +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:106 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:158 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:163 +msgid "Session Transcript" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:163 +msgctxt "When was this email sent?" +msgid "Delivery Time" +msgstr "" + +#. Translators: where %s indicates the relative time from now +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:332 +msgctxt "A relative time as in \"five days ago\"" +msgid "%s ago" +msgstr "" + +#: Postman/Postman-Email-Log/PostmanEmailLogView.php:338 +msgid "Sent" +msgstr "" + +#: Postman/Postman-Mail/PostmanDefaultModuleTransport.php:107 +msgid "Default" +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:102 +msgid "Gmail API" +msgstr "" + +#. translators: where (1) is the secure icon and (2) is the transport name +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:152 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:135 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:79 +msgid "Postman will send mail via the %1$s %2$s." +msgstr "" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:166 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:117 +msgid "" +"You have configured OAuth 2.0 authentication, but have not received " +"permission to use it." +msgstr "" + +#. translators: where variables are (1) transport name (2) host and (3) port +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:206 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:181 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:125 +msgid "Postman recommends the %1$s to host %2$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanGmailApiModuleTransport.php:221 +#: Postman/Postman-Mail/PostmanModuleTransport.php:713 +msgid "OAuth 2.0 (requires Client ID and Client Secret)" +msgstr "" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:44 +msgid "Mandrill API" +msgstr "" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:147 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:101 +msgid "API Key can not be empty" +msgstr "" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:151 +#: Postman/Postman-Mail/PostmanModuleTransport.php:578 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:105 +msgid "Message From Address can not be empty" +msgstr "" + +#: Postman/Postman-Mail/PostmanMandrillTransport.php:194 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:228 +#: Postman/Postman-Mail/PostmanMandrillTransport.php:271 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:148 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:182 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:222 +msgid "API Key" +msgstr "" + +#. Translators: Where (1) is the service URL and (2) is the service name and +#. (3) is a api key URL +#: Postman/Postman-Mail/PostmanMandrillTransport.php:238 +#: Postman/Postman-Mail/PostmanSendGridTransport.php:189 +msgid "" +"Create an account at %2$s and enter an API key below." +msgstr "" + +#. translators: where (1) is the transport type, (2) is the host, and (3) is +#. the Authentication Type (e.g. Postman will send mail via smtp.gmail.com:465 +#. using OAuth 2.0 authentication.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:506 +msgid "Postman will send mail via %1$s to %2$s using %3$s authentication." +msgstr "" + +#. translators: where %1$s is the Transport type (e.g. SMTP or SMTPS) and %2$s +#. is the encryption type (e.g. SSL or TLS) +#: Postman/Postman-Mail/PostmanModuleTransport.php:534 +msgctxt "as in \"There is no Spoon\"" +msgid "no" +msgstr "" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:553 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:366 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:584 +msgid "Password" +msgstr "" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanModuleTransport.php:584 +msgid "OAuth 2.0 authentication requires a %1$s and %2$s." +msgstr "" + +#: Postman/Postman-Mail/PostmanModuleTransport.php:706 +msgid "Password (requires username and password)" +msgstr "" + +#: Postman/Postman-Mail/PostmanMyMailConnector.php:200 +#: Postman/Postman-Mail/PostmanMyMailConnector.php:217 +msgid "MyMail: Change the delivery method in the %s!" +msgstr "" + +#: Postman/Postman-Mail/PostmanSendGridTransport.php:39 +msgid "SendGrid API" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:95 +msgid "Outgoing Mail Server Hostname and Port can not be empty." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:99 +msgid "Envelope-From Email Address can not be empty" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:103 +msgid "Username and password can not be empty." +msgstr "" + +#. translators: %1$s is the Client ID label, and %2$s is the Client Secret +#. label (e.g. Warning: OAuth 2.0 authentication requires an OAuth 2.0-capable +#. Outgoing Mail Server, Sender Email Address, Client ID, and Client Secret.) +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:109 +msgid "" +"OAuth 2.0 authentication requires a supported OAuth 2.0-capable Outgoing " +"Mail Server." +msgstr "" + +#. translators: where %1$s is a description of the transport (eg. SMTPS-SSL), +#. %2$s is a description of the authentication (eg. Password-CRAMMD5), %3$d is +#. the TCP port (eg. 465), %4$d is the hostname +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:269 +msgid "" +"Postman recommends %1$s with %2$s authentication to host %4$s on port %3$d." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:326 +msgid "Transport Settings" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:336 +msgid "Outgoing Mail Server Port" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:341 +msgid "Envelope-From Email Address" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:346 +msgctxt "Configuration Input Field" +msgid "Security" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:361 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:580 +msgid "Username" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:402 +msgid "Configure the communication with the mail server." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:449 +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:579 +msgid "Enter the account credentials." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:457 +msgid "The Username is usually the same as the Envelope-From Email Address." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:511 +msgid "Error computing your domain root - please enter it manually" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:532 +msgid "" +"For reliable delivery, this domain must specify an SPF record permitting the use of the SMTP server named above." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:539 +msgctxt "Wizard Step Title" +msgid "Which host will relay the mail?" +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:540 +msgid "" +"This is the Outgoing (SMTP) Mail Server, or Mail Submission Agent (MSA), " +"which Postman delegates mail delivery to. This server is specific to your " +"email account, and if you don't know what to use, ask your email service " +"provider." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:541 +msgid "" +"Note that many WordPress hosts, such as GoDaddy, Bluehost and Dreamhost, " +"require that you use their mail accounts with their mail servers, and " +"prevent you from using others." +msgstr "" + +#. Translators: Where (%s) is the name of the web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:547 +msgid "" +"Your email address requires access to a remote SMTP server blocked by " +"%s." +msgstr "" + +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:548 +msgid "If you have access to cPanel, enable the Remote Mail Exchanger." +msgstr "" + +#. Translators: Where (%1$s) is the SPF-info URL and (%2$s) is the name of the +#. web host +#: Postman/Postman-Mail/PostmanSmtpModuleTransport.php:551 +msgid "" +"If you own this domain, make sure it has an SPF record " +"authorizing %2$s as a relay, or you will have delivery problems." +msgstr "" + +#: Postman/Postman-Mail/PostmanTransportRegistry.php:231 +msgid "Postman is configured." +msgstr "" + +#: Postman/Postman-Mail/PostmanZendMailEngine.php:209 +msgid "" +"Communication Error [334] - make sure the Envelope From email is the same " +"account used to create the Client ID." +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:115 +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:149 +msgctxt "Email Test Status" +msgid "In Outbox" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:116 +msgctxt "Email Test Status" +msgid "Sending..." +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:117 +msgctxt "Email Test Status" +msgid "Success" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:118 +msgctxt "Email Test Status" +msgid "Failed" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:119 +msgid "Ajax Error" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:128 +#: Postman/PostmanViewController.php:273 Postman/PostmanViewController.php:275 +msgid "Send a Test Email" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:133 +msgid "Specify the Recipient" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:135 +msgid "Who is this message going to?" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:136 +msgid "This utility allows you to send an email message for testing." +msgstr "" + +#. translators: where %d is an amount of time, in seconds +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:139 +msgid "If there is a problem, Postman will give up after %d second." +msgid_plural "If there is a problem, Postman will give up after %d seconds." +msgstr[0] "" +msgstr[1] "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:140 +msgctxt "Configuration Input Field" +msgid "Recipient Email Address" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:145 +msgid "Send The Message" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:148 +msgid "Sending the message:" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:160 +msgid "Examine the Session Transcript if you need to." +msgstr "" + +#. translators: where %s is the domain name of the site +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:212 +msgctxt "Test Email Subject" +msgid "Postman SMTP Test (%s)" +msgstr "" + +#. translators: where %s is the Postman plugin version number (e.g. 1.4) +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:299 +msgctxt "Test Email Tagline" +msgid "Sent by Postman %s" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:300 +msgid "Image source" +msgstr "" + +#: Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php:301 +msgid "Used with permission" +msgstr "" + +#: Postman/PostmanAdminController.php:111 +msgctxt "The plugin successfully saved new settings." +msgid "Settings saved." +msgstr "" + +#. Translators: where %1$s is the name of the library +#: Postman/PostmanAdminController.php:178 +msgid "This PHP installation requires the %1$s library." +msgstr "" + +#: Postman/PostmanAdminController.php:253 +msgid "There was an error importing the data." +msgstr "" + +#: Postman/PostmanAdminController.php:270 +msgid "Plugin data was removed." +msgstr "" + +#: Postman/PostmanAdminController.php:294 +msgid "The OAuth 2.0 authorization was successful. Ready to send e-mail." +msgstr "" + +#: Postman/PostmanAdminController.php:296 +msgid "Your email provider did not grant Postman permission. Try again." +msgstr "" + +#: Postman/PostmanAdminController.php:299 +msgid "" +"The grant code from Google had no accompanying state and may be a forgery" +msgstr "" + +#. translators: %s is the error message +#: Postman/PostmanAdminController.php:303 +msgid "Error authenticating with this Client ID. [%s]" +msgstr "" + +#: Postman/PostmanConfigTextHelper.php:31 +msgid "Attention" +msgstr "" + +#. translators: parameters available are 1=portal-url, 2=portal-name, +#. 3=clientId-name, 4=clientSecret-name, 5=callbackUrl, 6=service-name, +#. 7=portal-application (e.g. Open the Google Developer Console, create a +#. Client ID for web application using the URL's displayed below, and copy the +#. Client ID and Client Secret here.) +#: Postman/PostmanConfigTextHelper.php:33 +msgid "" +"Open the %2$s, create %7$s with " +"the values displayed below, and copy the generated %3$s and %4$s here." +msgstr "" + +#. translators: parameters available are 1=clientId-name, 2=service-name, +#. 3=FAQ-URL, 4=Video-URL (e.g. See How do I get a Google Client ID? in the +#. F.A.Q.) +#: Postman/PostmanConfigTextHelper.php:36 +msgid "" +"See How do I get a %1$s %2$s? in the F." +"A.Q. or watch our How-To video 📺." +msgstr "" + +#. translators: where %s is the Email Service Owner (e.g. Google, Microsoft or +#. Yahoo) +#: Postman/PostmanConfigTextHelper.php:54 +msgctxt "Command to initiate OAuth authentication" +msgid "Grant permission with %s" +msgstr "" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:80 +#: Postman/PostmanConfigTextHelper.php:142 +#: Postman/PostmanConfigTextHelper.php:204 +#: Postman/PostmanConfigTextHelper.php:271 +msgctxt "Name of the OAuth 2.0 Client ID" +msgid "Client ID" +msgstr "" + +#. Translators: This description is specific to Google +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:84 +#: Postman/PostmanConfigTextHelper.php:146 +#: Postman/PostmanConfigTextHelper.php:208 +#: Postman/PostmanConfigTextHelper.php:274 +msgctxt "Name of the OAuth 2.0 Client Secret" +msgid "Client Secret" +msgstr "" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:88 +msgctxt "Name of the Application Callback URI" +msgid "Authorized redirect URI" +msgstr "" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:92 +msgctxt "Name of the Application Callback Domain" +msgid "Authorized JavaScript origins" +msgstr "" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:96 +msgctxt "Name of the email service owner" +msgid "Google" +msgstr "" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:100 +msgctxt "Name of the email service" +msgid "Gmail" +msgstr "" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:104 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "a Client ID for web application" +msgstr "" + +#. Translators: This description is specific to Google +#: Postman/PostmanConfigTextHelper.php:108 +msgctxt "Name of the email service portal" +msgid "Google Developers Console Gmail Wizard" +msgstr "" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:150 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URL" +msgstr "" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:154 +msgctxt "Name of the Application Callback Domain" +msgid "Root Domain" +msgstr "" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:158 +msgctxt "Name of the email service owner" +msgid "Microsoft" +msgstr "" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:162 +msgctxt "Name of the email service" +msgid "Outlook.com" +msgstr "" + +#. Translators: This description is specific to Microsoft +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:166 +#: Postman/PostmanConfigTextHelper.php:228 +msgctxt "Description of the email service OAuth 2.0 Application" +msgid "an Application" +msgstr "" + +#. Translators: This description is specific to Microsoft +#: Postman/PostmanConfigTextHelper.php:170 +msgctxt "Name of the email service portal" +msgid "Microsoft Developer Center" +msgstr "" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:212 +msgctxt "Name of the Application Callback URI" +msgid "Home Page URL" +msgstr "" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:216 +msgctxt "Name of the Application Callback Domain" +msgid "Callback Domain" +msgstr "" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:220 +msgctxt "Name of the email service owner" +msgid "Yahoo" +msgstr "" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:224 +msgctxt "Name of the email service" +msgid "Yahoo Mail" +msgstr "" + +#. Translators: This description is specific to Yahoo +#: Postman/PostmanConfigTextHelper.php:232 +msgctxt "Name of the email service portal" +msgid "Yahoo Developer Network" +msgstr "" + +#: Postman/PostmanConfigTextHelper.php:261 +msgid "Enter an Outgoing Mail Server with OAuth2 capabilities." +msgstr "" + +#: Postman/PostmanConfigTextHelper.php:277 +msgctxt "Name of the Application Callback URI" +msgid "Redirect URI" +msgstr "" + +#: Postman/PostmanConfigTextHelper.php:280 +msgctxt "Name of the Application Callback Domain" +msgid "Website Domain" +msgstr "" + +#: Postman/PostmanConfigTextHelper.php:304 +msgid "Grant OAuth 2.0 Permission" +msgstr "" + +#: Postman/PostmanInputSanitizer.php:137 +msgid "must be greater than 0" +msgstr "" + +#: Postman/PostmanViewController.php:112 +msgid "An unexpected error occurred" +msgstr "" + +#: Postman/PostmanViewController.php:113 +msgid "Unexpected PHP messages corrupted the Ajax response" +msgstr "" + +#: Postman/PostmanViewController.php:118 +msgctxt "Press this button to Finish this task" +msgid "Finish" +msgstr "" + +#: Postman/PostmanViewController.php:119 +msgctxt "Press this button to go to the next step" +msgid "Next" +msgstr "" + +#: Postman/PostmanViewController.php:120 +msgctxt "Press this button to go to the previous step" +msgid "Previous" +msgstr "" + +#: Postman/PostmanViewController.php:132 +msgid "" +"Postman is unable to run. Email delivery is being handled by WordPress (or " +"another plugin)." +msgstr "" + +#. translators: where %d is the number of emails delivered +#: Postman/PostmanViewController.php:147 +msgid "Postman has delivered %d email." +msgid_plural "" +"Postman has delivered %d emails." +msgstr[0] "" +msgstr[1] "" + +#: Postman/PostmanViewController.php:150 +msgid "The last %d email attempts are recorded in the log." +msgstr "" + +#: Postman/PostmanViewController.php:155 +msgid "Thank-you for choosing Postman!" +msgstr "" + +#. translators: where %s is the URL of the Setup Wizard +#: Postman/PostmanViewController.php:157 +msgid "" +"Let's get started! All users are strongly encouraged to run " +"the Setup Wizard." +msgstr "" + +#: Postman/PostmanViewController.php:158 +msgid "" +"Alternately, manually configure your own settings and/or " +"modify advanced options." +msgstr "" + +#. translators: where %s is the URL to the WordPress.org review and ratings +#. page +#: Postman/PostmanViewController.php:163 +msgid "" +"Please consider leaving a review to help spread the " +"word! :D" +msgstr "" + +#: Postman/PostmanViewController.php:165 +msgid "" +"Postman needs translators! Please take a moment to translate " +"a few sentences on-line" +msgstr "" + +#: Postman/PostmanViewController.php:167 +msgid "" +"New for v1.7! Send mail " +"with the Mandrill or SendGrid APIs." +msgstr "" + +#: Postman/PostmanViewController.php:191 +msgctxt "Return to main menu link" +msgid "Back To Main Menu" +msgstr "" + +#: Postman/PostmanViewController.php:198 Postman/PostmanViewController.php:233 +#: Postman/PostmanViewController.php:284 +msgid "Import" +msgstr "" + +#: Postman/PostmanViewController.php:199 Postman/PostmanViewController.php:285 +msgid "Export" +msgstr "" + +#: Postman/PostmanViewController.php:200 Postman/PostmanViewController.php:286 +msgid "Reset Plugin" +msgstr "" + +#: Postman/PostmanViewController.php:206 +msgid "" +"Copy this data into another instance of Postman to duplicate the " +"configuration." +msgstr "" + +#: Postman/PostmanViewController.php:225 +msgid "" +"Paste data from another instance of Postman here to duplicate the " +"configuration." +msgstr "" + +#: Postman/PostmanViewController.php:228 +msgid "" +"Using the same OAuth 2.0 Client ID and Client Secret from this site at the " +"same time as another site will cause failures." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "" +"This will purge all of Postman's settings, including account credentials and " +"the email log." +msgstr "" + +#: Postman/PostmanViewController.php:241 +msgid "Are you sure?" +msgstr "" + +#: Postman/PostmanViewController.php:261 +msgid "Configuration" +msgstr "" + +#: Postman/PostmanViewController.php:262 +msgid "Start the Wizard" +msgstr "" + +#: Postman/PostmanViewController.php:263 +msgid "Show All Settings" +msgstr "" + +#: Postman/PostmanViewController.php:266 +msgctxt "Main Menu" +msgid "Actions" +msgstr "" + +#: Postman/PostmanViewController.php:292 +msgctxt "Main Menu" +msgid "Troubleshooting" +msgstr "" + +#: Postman/PostmanViewController.php:296 +msgid "Online Support" +msgstr "" + +#. Plugin URI of the plugin/theme +msgid "https://wordpress.org/plugins/postman-smtp/" +msgstr "" + +#. Description of the plugin/theme +msgid "" +"Email not reliable? Postman is the first and only WordPress SMTP plugin to " +"implement OAuth 2.0 for Gmail, Hotmail and Yahoo Mail. Setup is a breeze " +"with the Configuration Wizard and integrated Port Tester. Enjoy worry-free " +"delivery even if your password changes!" +msgstr "" + +#. Author of the plugin/theme +msgid "Jason Hendriks" +msgstr "" + +#. Author URI of the plugin/theme +msgid "http://www.codingmonkey.ca" +msgstr "" diff --git a/Postman/notifications/INotify.php b/Postman/notifications/INotify.php new file mode 100644 index 0000000..f40548d --- /dev/null +++ b/Postman/notifications/INotify.php @@ -0,0 +1,7 @@ +notify = $notify; + } + + public function send( $message, $log ) { + $this->notify->send_message( $message ); + } + + public function push_to_chrome($message) { + $push_chrome = PostmanOptions::getInstance()->useChromeExtension(); + + if ( $push_chrome ) { + $uid = PostmanOptions::getInstance()->getNotificationChromeUid(); + + if ( empty( $uid ) ) { + return; + } + + $url = 'https://postmansmtp.com/chrome/' . $uid; + + $args = array( + 'body' => array( + 'message' => $message + ) + ); + + $response = wp_remote_post( $url , $args ); + } + } +} \ No newline at end of file diff --git a/Postman/notifications/PostmanPushoverNotify.php b/Postman/notifications/PostmanPushoverNotify.php new file mode 100644 index 0000000..14ef7d2 --- /dev/null +++ b/Postman/notifications/PostmanPushoverNotify.php @@ -0,0 +1,34 @@ +getPushoverToken(); + $user_key = $options->getPushoverUser(); + + $args = array( + 'body' => array( + "token" => $app_token, + "user" => $user_key, + "message" => $message, + ) + ); + + $result = wp_remote_post( $api_url, $args ); + + if ( is_wp_error($result) ) { + error_log( __CLASS__ . ': ' . $result->get_error_message() ); + } + + $body = json_decode( wp_remote_retrieve_body( $result ), true ); + if ( $body['status'] == 0 ) { + error_log( __CLASS__ . ': ' . print_r( $body, true ) ); + } + } +} \ No newline at end of file diff --git a/Postman/notifications/PostmanSlackNotify.php b/Postman/notifications/PostmanSlackNotify.php new file mode 100644 index 0000000..5b6fae3 --- /dev/null +++ b/Postman/notifications/PostmanSlackNotify.php @@ -0,0 +1,39 @@ +getSlackToken(); + + $headers = array( + 'content-type' => 'application/json' + ); + + $body = array( + 'text' => $message + ); + + $args = array( + 'headers' => $headers, + 'body' => json_encode($body) + ); + + $result = wp_remote_post( $api_url, $args ); + + if ( is_wp_error($result) ) { + error_log( __CLASS__ . ': ' . $result->get_error_message() ); + } + + $code = wp_remote_retrieve_response_code( $result ); + $message = wp_remote_retrieve_response_message( $result ); + + if ( $code != 200 && $message !== 'OK' ) { + error_log( __CLASS__ . ': ' . $message ); + } + } +} \ No newline at end of file -- cgit v1.2.3