weechat-xmpp/README.org
Tony Olagbaiye ac949c6b7b
fix readme
2021-06-26 00:17:15 +01:00

3.2 KiB

weechat-xmpp

file:https://api.travis-ci.org/bqv/weechat-xmpp.svg?branch=master file:https://coveralls.io/repos/github/bqv/weechat-xmpp/badge.svg?branch=master https://img.shields.io/github/issues/bqv/weechat-xmpp.svg https://img.shields.io/github/issues-closed/bqv/weechat-xmpp.svg https://img.shields.io/github/license/bqv/weechat-xmpp.svg https://img.shields.io/badge/weechat--extras-xmpp-blue.svg

Status: Aaaaaaaaaaaaaaaaa
Location: http://github.com/bqv/weechat-xmpp
Version: 0.1.0
Disclaimer: I'm lazy

Description

A weechat plugin in C to extend the chat client to support XMPP and ideally a maximal set of XEPs.

Usage

  1. Start with /xmpp register for instructions on how to obtain a token, or if you already have a token, use /xmpp register <token>.
  2. Use /xmpp connect <workspace-name> with the name returned by register

Installing

Place xmpp.so in the appropriate place for weechat plugins.

Dependencies

  • libstrophe (static, submodule)
  • json-c (static, submodule)
  • weechat (>= v1.7)

Building

git clone git://github.com/bqv/weechat-xmpp.git
cd weechat-xmpp
make
make install

Do NOT run make install as root, it installs the plugin to your local weechat plugins directory

Development

I use emacs for development of this, although I am also a fan of vim. My debug build process involves static analysis with clang and cppcheck, and dynamic analysis with address-sanitizer and leak-sanitizer. My debug evaluation process involves gdb/mi run with the arguments -ex "handle SIGPIPE nostop noprint pass" --args weechat -a 2>asan.log since part of weechat and it's default plugins use SIGPIPE as control.

I have no real requests for style of pull requests besides a wish that you keep vaguely to the style I have adopted for this project.

Happy coding!

Tasks

TODO [A] Implement basic functionality (milestone v0.1)

TODO [A] Implement essential events (milestone v0.2)

TODO [B] Implement completion engine (milestone v0.3)

TODO [#D] Close all issues (milestone v1.0)

Contributing

Your contributions are always welcome! Please submit a pull request or create an issue to add a new or missing feature.

License

weechat-xmpp is licensed under the Mozilla Public License Version 2.0 available here and in LICENSE.