Git Product home page Git Product logo

edx-notes-api's Introduction

Part of edX code.

edX Student Notes API build-status coverage-status

This is a backend store for edX Student Notes.

Overview

The edX Notes API is designed to be compatible with the Annotator.

Getting Started

  1. Install ElasticSearch 7.8.0.

  2. Install the requirements:

    $ make develop
    
  3. Create index and put mapping:

    $ make create-index
    
  4. Run the server:

    $ make run
    

Configuration:

CLIENT_ID - OAuth2 Client ID, which is to be found in aud field of IDTokens which authorize users

CLIENT_SECRET - secret with which IDTokens should be encoded

ES_DISABLED - set to True when you need to run the service without ElasticSearch support.
e.g if it became corrupted and you're rebuilding the index, while still serving users through MySQL

ELASTICSEARCH_DSL['default']['hosts'] - Your ElasticSearch host

Running Tests

Run make validate install the requirements, run the tests, and run lint.

How To Resync The Index

edX Notes Store uses Django elasticsearch DSL which comes with several management commands.

Please read more about search_index management commands here.

License

The code in this repository is licensed under version 3 of the AGPL unless otherwise noted.

Please see LICENSE.txt for details.

How To Contribute

Contributions are very welcome.

Please read How To Contribute for details.

Even though it was written with edx-platform in mind, the guidelines should be followed for Open edX code in general.

Reporting Security Issues

Please do not report security issues in public. Please email [email protected]

Mailing List and IRC Channel

You can discuss this code on the edx-code Google Group or in the edx-code IRC channel on Freenode.

edx-notes-api's People

Contributors

coryleeio avatar nikolayborovenskiy avatar syed-awais-ali avatar adzuci avatar bderusha avatar pwnage101 avatar muhammad-ammar avatar olmar avatar tymofij avatar robrap avatar arbabkhalil avatar nadeemshahzad avatar syedimranhassan avatar awais786 avatar cpennington avatar azarembok avatar usamasadiq avatar edx-requirements-bot avatar mraarif avatar dan-f avatar dianakhuang avatar iamsobanjaved avatar jdmulloy avatar attiyaishaque avatar uzairr avatar jawayria avatar ehteshamkafeel avatar ayub-khan avatar ali-d-akbar avatar nedbat 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.