Skip to content

Latest commit

 

History

History
66 lines (39 loc) · 2.38 KB

CONTRIBUTING.md

File metadata and controls

66 lines (39 loc) · 2.38 KB

How To Contribute

Every open source project lives from the generous help by contributors that sacrifice their time and moodlepy is no different. To make participation as pleasant as possible, this project adheres to the Code of Conduct by contributor-covenant.

Setting things up

Setup

  1. Fork the moodlepy repository to your GitHub account.

  2. Clone your forked repository of moodlepy to your computer:

$ git clone https://github.com/<your username>/moodlepy
$ cd moodlepy
  1. Add a track to the original repository:
$ git remote add upstream https://github.com/moodlepy/moodlepy
  1. Install dependencies with poetry:
$ pip install poetry
$ poetry install --no-root
  1. Install pre-commit hooks:
$ pre-commit install

IDE

Recommended linter (linting) mypy and code formater yapf.

Finding something to do

If you already know what you'd like to work on, you can skip this section.

If you have an idea for something to do, first check if it's already been filed on the issue tracker. If so, add a comment to the issue saying you'd like to work on it, and we'll help you get started! Otherwise, please file a new issue and assign yourself to it.

Another great way to start contributing is by writing tests. Tests are really important because they help prevent developers from accidentally breaking existing code, allowing them to build cool things faster.

That being said, we want to mention that we are very hesitant about adding new requirements to our projects. If you intend to do this, please state this in an issue and get a verification from the maintainer.

Implementing function

Currently we are using moodle sandbox as webdocumentation source.

Login as admin

Log in to moodle sandbox with username admin password sandbox.

Enabling Web Services

  1. Open Site admiistration > Plugins > Web Services > Overview
  2. Enable web services. Check the checkbox and Save changes.

Open API Documentation for webservice

Open Site admiistration > Plugins > Web Services > API Documentation (API Documentation)