Git Product home page Git Product logo

handy's Introduction

handyBuild Status

中文版

A C++11 non-blocking network library

multi platform support

  • Linux: ubuntu14 64bit g++4.8.1 tested

  • MacOSX: LLVM version 6.1.0 tested

elegant program exit

programmer can write operations for exit

can use valgrind to check memory leak

high performance

  • use epoll on Linux

  • use kqueue on MacOSX

performance report

elegant

only 10 lines can finish a complete server

Usage

Quick start

 make && make install

sample --echo-server

#include <handy/handy.h>
using namespace handy;

int main(int argc, const char* argv[]) {
    EventBase base;
    Signal::signal(SIGINT, [&]{ base.exit(); });
    TcpServerPtr svr = TcpServer::startServer(&base, "", 2099);
    exitif(svr == NULL, "start tcp server failed");
    svr->onConnRead([](const TcpConnPtr& con) {
        con->send(con->getInput());
    });
    base.loop();
}

half sync half async pattern

processing I/O asynchronously and Request synchronously can greatly simplify the coding of business processing

example can be found examples/hsha.cc

openssl supported

asynchronously handle the openssl connection. if you have installed openssl, then make will automatically download handy-ssl. ssl support files are in handy-ssl because of license.

protobuf supported

examples can be found in directory protobuf

contents

  • handy--------handy library
  • examples----
  • ssl------------openssl support and examples
  • protobuf-----protobuf support and examples
  • test-----------handy test case

Advanced build option

Build handy shared library and examples:

$ git clone https://github.com/yedf/handy
$ cd handy && mkdir build && cd build
$ cmake -DBUILD_HANDY_SHARED_LIBRARY=ON -DBUILD_HANDY_EXAMPLES=ON -DCMAKE_INSTALL_PREFIX=/tmp/handy ..
$ make -j4
$ make install
$ ls /tmp/handy
bin  include  lib64
$ ls /tmp/handy/bin/
10m-cli  10m-svr  codec-cli  codec-svr  daemon  echo  hsha  http-hello  idle-close  reconnect  safe-close  stat  timer  udp-cli  udp-hsha  udp-svr  write-on-empty
$ ls /tmp/handy/lib64/
libhandy_s.a  libhandy.so

As a static library in your own programs:

  • add handy as a git submodule to say a folder called vendor
  • in your CMakeLists.txt
add_subdirectory("vendor/handy" EXCLUDE_FROM_ALL)

add_executable(${PROJECT_NAME} main.cpp)

target_include_directories(${PROJECT_NAME} PUBLIC
    "vendor/handy"
)

target_link_libraries(${PROJECT_NAME} PUBLIC
    handy_s
)

license

Use of this source code is governed by a BSD-style license that can be found in the License file.

email

[email protected]

handy's People

Contributors

bingtaoli avatar busyluo avatar chunyi1994 avatar dq5070410 avatar huntinux avatar jovany-wang avatar kyle45 avatar linanwx avatar luozhengyi avatar mamil avatar ranqiyu avatar saidinesh5 avatar wangqing1218 avatar yedf2 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.