Code Monkey home page Code Monkey logo

docflow's Introduction

Build Status

DocFlow

A Discord Bot written by Members of the Programming Server to evaluate code and browse documentation.

To Be Done

  • Basic Bot framework, using the commands extension of discord.py
  • Code Evaluation using Coliru
  • Documentation search for various languages

Setup

This Project requires a Python 3.6 Interpreter as well as the following packages:

Usage of a virtual environment is highly recommended.
You can setup these using the following commands:

# Create a virtual environment, activate it
python3 -m venv venv
source venv/bin/activate

# Install discord.py from GitHub
python3 -m pip install -U git+https://github.com/Rapptz/discord.py@rewrite

Usage

You need to set a DISCORD_TOKEN environment variable for the Bot to connect to Discord. An easy way to do this by using a Virtual Environment is shown [here](TODO: create wiki page). To start the bot, simply use the following commands:

# If the virtual environment is not activated yet:
source venv/bin/activate

# Run application
python3 run.py

# When you're done with using it, use `deactivate` to leave the venv
deactivate

To run the tests, you need pytest and pylint installed. Installation is pretty straightforward:

pip3 install pytest
pip3 install pylint

Contributing

The master branch must always be working without any bugs, so adding new features, fixing bugs, refactoring code or other changes must be worked on within branches. For discussion and getting your branch merged, please use Pull Requests. Also, please make sure to use descriptive commit messages so other collaborators can understand your changes easier. Each commit should represent one idea. Please view this for a more detailed description of the GitHub Flow.

Pull Requests are validated through the tests in test using Travis, make sure that they pass before submitting one. Additionally, make sure your code conforms to PEP8. Tools like autopep8 ease this process a lot.

docflow's People

Contributors

jchristgit avatar max-kamps avatar robstolarz 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.