Metadata-Version: 2.1
Name: truelearn
Version: 1.1.0
Summary: A Machine learning library that models and predicts learner engagement
Author: Sahanbull, KD-7, yuxqiu, deniselezi, aaneelshalman
License: MIT License
Project-URL: Homepage, https://truelearnai.github.io/
Project-URL: Documentation, https://truelearn.readthedocs.io/en/stable/
Project-URL: Issues, https://github.com/TrueLearnAI/truelearn/issues
Project-URL: Source, https://github.com/TrueLearnAI/truelearn
Keywords: machine learning,python,statistics,probability
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: Unix
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Education
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: LICENSE-3RD-PARTY
Requires-Dist: typing-extensions >=4.7.1
Requires-Dist: trueskill >=0.4.5
Requires-Dist: mpmath >=1.3.0
Requires-Dist: circlify >=0.15.0
Requires-Dist: scikit-learn >=1.0.2
Requires-Dist: matplotlib >=3.5.3
Requires-Dist: plotly ==5.14.1
Requires-Dist: wordcloud ==1.9.2
Requires-Dist: kaleido ==0.2.1 ; sys_platform != "win32"
Requires-Dist: kaleido ==0.1.0.post1 ; sys_platform == "win32"
Provides-Extra: dev
Requires-Dist: truelearn[docs,linters,tests] ; extra == 'dev'
Requires-Dist: black >=22.12.0 ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx >=5.3.0 ; extra == 'docs'
Requires-Dist: furo >=2023.03.27 ; extra == 'docs'
Requires-Dist: sphinx-copybutton >=0.5.1 ; extra == 'docs'
Requires-Dist: sphinx-gallery >=0.12.2 ; extra == 'docs'
Requires-Dist: Pillow >=9.4.0 ; extra == 'docs'
Provides-Extra: linters
Requires-Dist: prospector[with_bandit,with_mypy] ==1.8.4 ; extra == 'linters'
Provides-Extra: tests
Requires-Dist: pytest >=7.2.1 ; extra == 'tests'
Requires-Dist: pytest-cov >=4.0.0 ; extra == 'tests'
Requires-Dist: pytest-socket >=0.6.0 ; extra == 'tests'

|PyPi| |License| |Unit tests| |Static analysis| |codecov|

|FOSSA Status| |docs| |Black|


.. image:: https://raw.githubusercontent.com/truelearnai/truelearn/main/docs/images/TrueLearn_logo.svg
   :target: https://truelearnai.github.io/
   :alt: TrueLearn
   :width: 800
   :height: 160
   :align: center

|

**TrueLearn** is a machine learning library for predicting and modelling learner engagement with educational resources.

.. |PyPi| image:: https://img.shields.io/pypi/pyversions/truelearn?label=Python&style=flat
   :target: https://pypi.org/project/truelearn/
   :alt: PyPI - Python Version

.. |License| image:: https://img.shields.io/badge/License-MIT-blue
   :target: https://github.com/TrueLearnAI/truelearn/blob/main/LICENSE
   :alt: License

.. |Unit tests| image:: https://github.com/TrueLearnAI/truelearn/actions/workflows/unit_tests.yml/badge.svg
   :target: https://github.com/TrueLearnAI/truelearn/actions/workflows/unit_tests.yml
   :alt: Unit tests

.. |Static analysis| image:: https://github.com/TrueLearnAI/truelearn/actions/workflows/static_analysis.yml/badge.svg
   :target: https://github.com/TrueLearnAI/truelearn/actions/workflows/static_analysis.yml
   :alt: Static analysis

.. |codecov| image:: https://codecov.io/gh/TrueLearnAI/truelearn/branch/main/graph/badge.svg?token=69JZ051NAO
   :target: https://codecov.io/gh/TrueLearnAI/truelearn
   :alt: codecov

.. |FOSSA Status| image:: https://app.fossa.com/api/projects/git%2Bgithub.com%2FTrueLearnAI%2Ftruelearn.svg?type=small
   :target: https://app.fossa.com/projects/git%2Bgithub.com%2FTrueLearnAI%2Ftruelearn?ref=badge_small
   :alt: FOSSA Status

.. |docs| image:: https://readthedocs.org/projects/truelearn/badge/?version=latest
   :target: https://truelearn.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black
   :alt: Black


User Installation
#################

**Install from PyPI:** ::

   pip install -U truelearn

For more information on installation, see the `Getting Started guide <https://truelearn.readthedocs.io/en/stable/tutorial/quickstart.html>`_.

Documentation
#############

**Latest stable release** is available at: https://truelearn.readthedocs.io/en/stable/

**Development version** is available at: https://truelearn.readthedocs.io/en/latest/

Change Log
##########

See the `Change Log <https://truelearn.readthedocs.io/en/stable/index.html#change-log>`_
for a history of all the major changes to the truelearn.

Alternatively you can find it in the ``CHANGELOG.rst`` file found here:
https://github.com/TrueLearnAI/truelearn/blob/main/docs/changelog.rst

Contributing
############

Contributions are welcome, and they are greatly appreciated! Every little bit helps,
and credit will always be given.
Please see: `Contributing Guide <https://truelearn.readthedocs.io/en/latest/dev/index.html>`_ for more information!
We have listed a brief guide below.


Source Code
-----------

You can check out the latest the source code with the following command::

   git clone https://github.com/TrueLearnAI/truelearn.git


Installing TrueLearn from source
--------------------------------

After cloning the repository, you can install TrueLearn locally from source::

   pip install -e .[dev]

   # if you are using zsh
   pip install -e ".[dev]"

See the `Contributing Guide: Getting Started <https://truelearn.readthedocs.io/en/latest/dev/get_started.html>`_
for a more detailed explanation.


Testing
-------

After installation, you can run the tests from the source directory::

   pytest truelearn

See the `Contributing Guide: Testing guide <https://truelearn.readthedocs.io/en/latest/dev/testing.html>`_
for a more detailed explanation.


Before submitting a PR
----------------------

Please make sure you have followed the Guidelines outlined in the
`Contributing Guide: Before/During PR  <https://truelearn.readthedocs.io/en/latest/dev/before_pr.html>`_.
