Documentation

9 files changed, 581 insertions, 0 deletions

diff --git a/include/tgbot/net/HttpClient.h b/include/tgbot/net/HttpClient.h
new file mode 100644
index 0000000..d39e108
--- /dev/null
+++ b/include/tgbot/net/HttpClient.h
@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_HTTPCLIENT_H
+#define TGBOT_HTTPCLIENT_H
+
+#include <string>
+
+#include <boost/asio.hpp>
+
+#include "tgbot/net/Url.h"
+#include "tgbot/net/HttpReqArg.h"
+#include "tgbot/net/HttpParser.h"
+
+namespace TgBot {
+
+/**
+ * This class makes http requests.
+ * @ingroup net
+ */
+class HttpClient {
+
+public:
+	/**
+	 * Returns instance which lives during all application lifetime.
+	 */
+    static HttpClient& getInstance();
+
+    /**
+     * Sends a request to the url.
+     * If there's no args specified, a GET request will be sent, otherwise a POST request will be sent.
+     * If at least 1 arg is marked as file, the content type of a request will be multipart/form-data, otherwise it will be application/x-www-form-urlencoded.
+     */
+    std::string makeRequest(const Url& url, const std::vector<HttpReqArg>& args);
+
+private:
+    boost::asio::io_service _ioService;
+};
+
+}
+
+#endif //TGBOT_HTTPCLIENT_H
diff --git a/include/tgbot/net/HttpParser.h b/include/tgbot/net/HttpParser.h
new file mode 100644
index 0000000..dcb857b
--- /dev/null
+++ b/include/tgbot/net/HttpParser.h
@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_HTTPPARSER_H
+#define TGBOT_HTTPPARSER_H
+
+#include <string>
+#include <map>
+
+#include "tgbot/net/Url.h"
+#include "tgbot/net/HttpReqArg.h"
+
+namespace TgBot {
+
+class HttpParser {
+
+public:
+    static HttpParser& getInstance();
+
+    std::string generateRequest(const Url& url, const std::vector<HttpReqArg>& args, bool isKeepAlive = false);
+    std::string generateMultipartFormData(const std::vector<HttpReqArg>& args, const std::string& bondary);
+    std::string generateMultipartBoundary(const std::vector<HttpReqArg>& args);
+    std::string generateWwwFormUrlencoded(const std::vector<HttpReqArg>& args);
+    std::string generateResponse(const std::string& data, const std::string& mimeType = "text/plain", short unsigned statusCode = 200, const std::string& statusStr = "OK", bool isKeepAlive = false);
+
+    inline std::string parseRequest(const std::string& data, std::map<std::string, std::string>& headers) {
+        return parseHttp(true, data, headers);
+    }
+
+    inline std::string parseRequest(const std::string& data) {
+        return parseHttp(true, data);
+    }
+
+    inline std::string parseResponse(const std::string& data, std::map<std::string, std::string>& headers) {
+        return parseHttp(false, data, headers);
+    }
+
+    inline std::string parseResponse(const std::string& data) {
+        return parseHttp(false, data);
+    }
+
+private:
+    std::string parseHttp(bool isRequest, const std::string& data, std::map<std::string, std::string>& headers);
+    std::string parseHttp(bool isRequest, const std::string& data);
+};
+
+}
+
+#endif //TGBOT_HTTPPARSER_H
diff --git a/include/tgbot/net/HttpReqArg.h b/include/tgbot/net/HttpReqArg.h
new file mode 100644
index 0000000..d70e8b5
--- /dev/null
+++ b/include/tgbot/net/HttpReqArg.h
@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_HTTPPARAMETER_H
+#define TGBOT_HTTPPARAMETER_H
+
+#include <string>
+
+#include <boost/lexical_cast.hpp>
+
+namespace TgBot {
+
+/**
+ * This class represents argument in POST http requests.
+ * @ingroup net
+ */
+class HttpReqArg {
+
+public:
+    template<typename T>
+    HttpReqArg(const std::string& name, const T& value, bool isFile = false, const std::string& mimeType = "text/plain") :
+            name(name), value(boost::lexical_cast<std::string>(value)), isFile(isFile), mimeType(mimeType)
+    {
+    }
+
+    /**
+     * Name of an argument.
+     */
+    std::string name;
+
+    /**
+     * Value of an argument.
+     */
+    std::string value;
+
+    /**
+     * Should be true if an argument value hold some file contents
+     */
+    bool isFile = false;
+
+    /**
+     * Mime type of an argument value. This field makes sense only if isFile is true.
+     */
+    std::string mimeType = "text/plain";
+};
+
+}
+
+
+#endif //TGBOT_HTTPPARAMETER_H
diff --git a/include/tgbot/net/HttpServer.h b/include/tgbot/net/HttpServer.h
new file mode 100644
index 0000000..0a66900
--- /dev/null
+++ b/include/tgbot/net/HttpServer.h
@@ -0,0 +1,103 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_HTTPSERVER_H
+#define TGBOT_HTTPSERVER_H
+
+#include <string>
+
+#include <boost/asio.hpp>
+
+#include "tgbot/net/HttpParser.h"
+
+namespace TgBot {
+
+/**
+ * This class handles HTTP requests from the Internet.
+ * @ingroup net
+ */
+template<typename Protocol>
+class HttpServer {
+
+private:
+    class Connection;
+
+public:
+    typedef std::function<std::string (const std::string&, const std::map<std::string, std::string>)> ServerHandler;
+
+    HttpServer(std::shared_ptr<boost::asio::basic_socket_acceptor<Protocol>>& acceptor, const ServerHandler& handler) : _acceptor(acceptor), _handler(handler) {
+    }
+
+    /**
+     * Starts receiving new connections.
+     */
+    void start() {
+        std::shared_ptr<boost::asio::basic_stream_socket<Protocol>> socket(new boost::asio::basic_stream_socket<Protocol>(acceptor->get_io_service()));
+        std::shared_ptr<Connection<Protocol>> connection(new Connection<Protocol>(socket, _handler));
+        acceptor->async_accept(*connection->socket, [this, connection]() {
+            connection->start();
+            start();
+        });
+        _ioService.run();
+    }
+
+    /**
+     * Stops receiving new connections.
+     */
+    void stop() {
+        _ioService.stop();
+    }
+
+private:
+    template<typename Protocol>
+    class Connection {
+
+    public:
+        Connection(std::shared_ptr<boost::asio::basic_stream_socket<Protocol>>& socket, const ServerHandler& handler) : socket(socket), _handler(handler) {
+            boost::asio::socket_base::keep_alive option(true);
+            socket.set_option(option);
+        }
+
+        void start() {
+            data.reserve(10240);
+            socket->async_receive(data, [this]() {
+                std::map<std::string, std::string> headers;
+                std::string body = HttpParser::parseResponse(data, headers);
+                socket->async_send(_handler(body, headers));
+            });
+        }
+
+        std::shared_ptr<boost::asio::basic_stream_socket<Protocol>> socket;
+        std::string data;
+
+    private:
+        const ServerHandler _handler;
+    };
+
+    boost::asio::io_service _ioService;
+    std::shared_ptr<boost::asio::basic_socket_acceptor<Protocol>> _acceptor;
+    const ServerHandler _handler;
+};
+
+}
+
+#endif //TGBOT_HTTPSERVER_H
diff --git a/include/tgbot/net/TgLongPoll.h b/include/tgbot/net/TgLongPoll.h
new file mode 100644
index 0000000..932fc6d
--- /dev/null
+++ b/include/tgbot/net/TgLongPoll.h
@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_TGLONGPOLL_H
+#define TGBOT_TGLONGPOLL_H
+
+#include "tgbot/Bot.h"
+#include "tgbot/Api.h"
+#include "tgbot/EventHandler.h"
+
+namespace TgBot {
+
+/**
+ * This class handles long polling and updates parsing.
+ * @ingroup net
+ */
+class TgLongPoll {
+
+public:
+    TgLongPoll(const Api* api, const EventHandler* eventHandler);
+    TgLongPoll(const Bot& bot);
+
+    /**
+     * Starts long poll. After new update will come, this method will parse it and send to EventHandler which invokes your listeners. Designed to be executed in a loop.
+     */
+    void start();
+
+private:
+    int32_t _lastUpdateId = 0;
+    const Api* _api;
+    const EventHandler* _eventHandler;
+};
+
+}
+
+#endif //TGBOT_TGLONGPOLL_H
diff --git a/include/tgbot/net/TgWebhookLocalServer.h b/include/tgbot/net/TgWebhookLocalServer.h
new file mode 100644
index 0000000..7835f28
--- /dev/null
+++ b/include/tgbot/net/TgWebhookLocalServer.h
@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_TGWEBHOOKTCPSERVER_H
+#define TGBOT_TGWEBHOOKTCPSERVER_H
+
+#include "tgbot/net/TgWebhookServer.h"
+
+namespace TgBot {
+
+/**
+ * This class setups HTTP server for receiving Telegram Update objects from unix socket.
+ * @ingroup net
+ */
+class TgWebhookLocalServer : public TgWebhookServer<boost::asio::local::stream_protocol> {
+
+public:
+    TgWebhookLocalServer(std::shared_ptr<boost::asio::basic_socket_acceptor<boost::asio::local::stream_protocol>>& acceptor, const std::string& path, EventHandler* eventHandler) = delete;
+
+    TgWebhookLocalServer(const std::string& path, const EventHandler* eventHandler) :
+        TgWebhookServer(std::shared_ptr<boost::asio::basic_socket_acceptor<boost::asio::local::stream_protocol>>(new boost::asio::local::stream_protocol::acceptor(_ioService, boost::asio::local::stream_protocol::endpoint(path))), path, eventHandler)
+    {
+    }
+
+    TgWebhookLocalServer(const std::string& path, const Bot& bot) : TgWebhookLocalServer(path, &bot.getEventHandler()) {
+
+    }
+};
+
+}
+
+#endif //TGBOT_TGWEBHOOKTCPSERVER_H
diff --git a/include/tgbot/net/TgWebhookServer.h b/include/tgbot/net/TgWebhookServer.h
new file mode 100644
index 0000000..a8155ff
--- /dev/null
+++ b/include/tgbot/net/TgWebhookServer.h
@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_TGHTTPSERVER_H
+#define TGBOT_TGHTTPSERVER_H
+
+#include "tgbot/Bot.h"
+#include "tgbot/EventHandler.h"
+#include "tgbot/TgTypeParser.h"
+#include "tgbot/net/HttpServer.h"
+
+namespace TgBot {
+
+template<typename Protocol>
+class TgWebhookServer : public HttpServer<Protocol> {
+
+public:
+    TgWebhookServer(std::shared_ptr<boost::asio::basic_socket_acceptor<Protocol>>& acceptor, const ServerHandler& handler) = delete;
+
+    TgWebhookServer(std::shared_ptr<boost::asio::basic_socket_acceptor<Protocol>>& acceptor, const std::string& path, const EventHandler* eventHandler) :
+        HttpServer(acceptor, [this, eventHandler, &path](const std::string& data, const std::map<std::string, std::string>& headers) -> std::string {
+            if (headers["method"] == "POST" && headers["path"] == path) {
+                eventHandler->handleUpdate(TgTypeParser::getInstance().parseUpdate(TgTypeParser::getInstance().parseJson(data)));
+            }
+            return HttpParser::generateResponse("");
+        })
+    {
+    }
+
+    TgWebhookServer(std::shared_ptr<boost::asio::basic_socket_acceptor<Protocol>>& acceptor, const std::string& path, const Bot& bot) :
+        TgWebhookServer(acceptor, path, &bot.getEventHandler())
+    {
+    }
+};
+
+}
+
+#endif //TGBOT_TGHTTPSERVER_H
diff --git a/include/tgbot/net/TgWebhookTcpServer.h b/include/tgbot/net/TgWebhookTcpServer.h
new file mode 100644
index 0000000..cac2638
--- /dev/null
+++ b/include/tgbot/net/TgWebhookTcpServer.h
@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_TGWEBHOOKTCPSERVER_H
+#define TGBOT_TGWEBHOOKTCPSERVER_H
+
+#include "tgbot/net/TgWebhookServer.h"
+
+namespace TgBot {
+
+/**
+ * This class setups HTTP server for receiving Telegram Update objects from tcp connections.
+ * @ingroup net
+ */
+class TgWebhookTcpServer : public TgWebhookServer<boost::asio::ip::tcp> {
+
+public:
+    TgWebhookTcpServer(std::shared_ptr<boost::asio::basic_socket_acceptor<boost::asio::ip::tcp>>& acceptor, const std::string& path, EventHandler* eventHandler) = delete;
+
+    TgWebhookTcpServer(unsigned short port, const std::string& path, const EventHandler* eventHandler) :
+        TgWebhookServer(std::shared_ptr<boost::asio::basic_socket_acceptor<boost::asio::ip::tcp>>(new boost::asio::ip::tcp::acceptor(_ioService, boost::asio::ip::tcp::endpoint(boost::asio::ip::tcp::v4(), port))), path, eventHandler)
+    {
+    }
+
+    TgWebhookTcpServer(const std::string& path, const Bot& bot) : TgWebhookTcpServer(path, &bot.getEventHandler()) {
+    }
+};
+
+}
+
+#endif //TGBOT_TGWEBHOOKTCPSERVER_H
diff --git a/include/tgbot/net/Url.h b/include/tgbot/net/Url.h
new file mode 100644
index 0000000..818e934
--- /dev/null
+++ b/include/tgbot/net/Url.h
@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2015 Oleg Morozenkov
+ *
+ * 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.
+ */
+
+#ifndef TGBOT_CPP_URL_H
+#define TGBOT_CPP_URL_H
+
+#include <string>
+
+namespace TgBot {
+
+/**
+ * This class parses a string with the url
+ * @ingroup net
+ */
+class Url {
+
+public:
+    Url(const std::string& url);
+
+	/**
+	 * Protocol part of an url. Example: https://
+	 */
+    std::string protocol;
+
+	/**
+	 * Host part of an url. Example: www.example.com
+	 */
+    std::string host;
+
+	/**
+	 * Path part of an url including preceding '/' char. Example: /index.html
+	 */
+    std::string path;
+
+	/**
+	 * Query part of an url without '?' char. Example: a=1&b=2&c=3
+	 */
+    std::string query;
+
+	/**
+	 * Fragment part of an url without '#' char. Example: section1
+	 */
+    std::string fragment;
+};
+
+}
+
+#endif //TGBOT_CPP_URL_H