Metadata-Version: 1.2
Name: badgr_lite
Version: 1.0.1
Summary: Automate awarding Badgr (or equivalent) badges to recipients without the overhead of badgr-server
Home-page: https://github.com/glenjarvis/badgr_lite
Author: Glen Jarvis
Author-email: glen@glenjarvis.com
License: MIT license
Description: ==========
        badgr-lite
        ==========
        
        Automate awarding Open Badges to recipients without the overhead of a server
        
        .. image:: https://img.shields.io/pypi/v/badgr_lite.svg
             :target: https://pypi.python.org/pypi/badgr_lite
             :alt: PyPI Status
        
        
        .. image:: https://img.shields.io/travis/glenjarvis/badgr-lite.svg?branch=develop
             :target: https://travis-ci.org/glenjarvis/badgr-lite?branch=develop
             :alt: Build Status
        
        
        .. image:: https://codecov.io/gh/glenjarvis/badgr-lite/branch/develop/graph/badge.svg?branch=develop
             :target: https://codecov.io/gh/glenjarvis/badgr-lite?branch=develop
             :alt: Code Coverage Status
        
        
        .. image:: https://readthedocs.org/projects/badgr-lite/badge/?version=latest
             :target: https://badgr-lite.readthedocs.io/en/latest/?badge=latest
             :alt: Documentation Status
        
        
        .. image:: https://pyup.io/repos/github/glenjarvis/badgr-lite/shield.svg
             :target: https://pyup.io/repos/github/glenjarvis/badgr-lite/
             :alt: Updates
        
        
        
        Quick Start
        -----------
        
        Manage your badges (with `Badgr`_ ), but automate the award and retrieval of
        badges with `badger-lite <https://github.com/glenjarvis/badgr-lite>`_.
        
        1. Create an account on either `Badgr`_ or an equivalent server.
        
        2. Use your `Badgr`_ (or equivalent) username and password
           to generate OAuth tokens for use with your project:
        
          .. code-block:: bash
        
            curl -X POST 'https://api.badgr.io/o/token' -d "username=YOUREMAIL&password=YOURPASSWORD" > token.json
        
        3. Install the `badgr-lite` package:
        
          .. code-block:: bash
        
            pip install badgr-lite
        
          Or (using the newly recommended way from Python.org:
        
          .. code-block:: bash
        
            pipenv install badgr-lite
        
        
        Now you can award badges through either the Command Line (CLI) or Library (SDK).
        
        
        .. _Badgr: https://badgr.io/
        
        
        Command Line Example
        --------------------
        
        Sample Command Help:
        
          .. code-block:: bash
        
            $ badgr --help
            Usage: badgr [OPTIONS] COMMAND [ARGS]...
        
              Automate Badgr tasks without the overhead of badgr-server
        
            Options:
              --token-file PATH  File holding token credentials
              --help             Show this message and exit.
        
            Commands:
              award-badge  Award badge with BADGE_ID to RECIPIENT.
              list-badges  Pull and print a list of badges from server
        
        
        ``--token-file`` can be omitted if ``token.json`` filename is in current directory.
        
          .. code-block:: bash
        
            $ badgr --token-file token.json list-badges
        
            dTjxL52HQBiSgIp5JuVq5w  https://badgr.io/public/assertions/dTjxL52HQBiSgIp5JuVq5w       Bay Area Python Interest Group TDD Participant
            6YhFytMUQb2loOMEy63gQA  https://badgr.io/public/assertions/6YhFytMUQb2loOMEy63gQA       Bay Area Python Interest Group TDD Quizmaster
            zzExTDvOTnOx_R3YhwPf3A  https://badgr.io/public/assertions/zzExTDvOTnOx_R3YhwPf3A       Test Driven Development Fundamentals Champion
            zNjcY70FSn603SO9vMGhBA  https://badgr.io/public/assertions/zNjcY70FSn603SO9vMGhBA       Install Python with Virtual Environments
            ZN0CIo4NR7-GgrliDJzoTw  https://badgr.io/public/assertions/ZN0CIo4NR7-GgrliDJzoTw       Fivvr badge
        
        
          .. code-block:: bash
        
            $ badgr --token-file token.json award-badge --badge-id 2TfNNqMLT8CoAhfGKqSv6Q --recipient recipient@example.com
        
            IfK18iLWSNWhvnQxLPHSxA  https://badgr.io/public/assertions/IfK18iLWSNWhvnQxLPHSxA       <No name>
        
        
        Library Examples
        ----------------
        
        One could patch together curl commands to interact with the Badgr server
        (although badgr-lite does make it much faster to get started).  However, the
        real benefit of Badgr-Lite is directly using its library in whatever tool that
        you are using to automate award assignments (e.g., Django server, Flask server,
        etc.).
        
        
          .. code-block:: python
        
            >>> from badgr_lite.models import BadgrLite
            >>> badge_id = '2TfNNqMLT8CoAhfGKqSv6Q'
            >>> badge_data = {
            ...     "recipient": {
            ...         "identity": "recipient@example.com",
            ...     },
            ... }
            >>> badgr = BadgrLite(token_filename='./token.json')
            >>> badge = badgr.award_badge(badge_id, badge_data)
            >>> print(badge)
            q8nKaXMHTICZj7qhKEwutg  https://badgr.io/public/assertions/q8nKaXMHTICZj7qhKEwutg      <No name>
        
        
          .. warning::
        
             Do *not* check the ``token.json`` file into your code repository. This is a secret file and should
             be handled like any other file that stores passwords or secrets.
        
        
        Purpose
        -------
        
        `Open Badges <https://openbadges.org/>`_ are images with credential data baked
        into them. They are liked a digitally signed certificate that is also an image
        that can be displayed on the web. They can be validated for authenticity and
        are a nice award to grant to people for jobs well done, passing quizzes and
        much more.
        
        Mozilla recently partnered with `Concentric Sky
        <https://www.concentricsky.com/>`_. They built `Badgr`_ which makes badge
        management so much easier (and less buggy).
        
        At the time this project was created, however, there was no easy way to
        automate the award of badges (e.g., on your own website) without having to
        build a full and complicated `badgr-server
        <https://github.com/concentricsky/badgr-server>`_ of your own.
        
        This `badgr-lite`_ project solves that problem.
        
        
        Tutorial
        --------
        If you are new to Open Badges and want to see how to use them (and automate
        them with this project), go to `this tutorial
        <https://badgr-lite.readthedocs.io/en/latest/tutorial.html>`_.
        
        
        * Free software: MIT license
        * Documentation: https://badgr-lite.readthedocs.io.
        
        
        =======
        History
        =======
        
        1.0.1 (2019-11-22)
        ------------------
        
        * Bump Python support to 3.8 / `Pull request #65 <https://github.com/glenjarvis/badgr-lite/pull/65>`_
        * Refactor models.py for clarity / `Pull request #64 <https://github.com/glenjarvis/badgr-lite/pull/64>`_
        * Update pluggy to 0.13.1 / `Pull request #62 <https://github.com/glenjarvis/badgr-lite/pull/62>`_
        * Update twine to 3.0.0 / `Pull request #60 <https://github.com/glenjarvis/badgr-lite/pull/60>`_
        * Update tox to 3.14.1 / `Pull request #59 <https://github.com/glenjarvis/badgr-lite/pull/59>`_
        * Update urllib3 to 1.25.7 / `Pull request #58 <https://github.com/glenjarvis/badgr-lite/pull/58>`_
        * Update tqdm to 4.38.0 / `Pull request #57 <https://github.com/glenjarvis/badgr-lite/pull/57>`_
        * Update astroid to 2.3.3 / `Pull request #56 <https://github.com/glenjarvis/badgr-lite/pull/56>`_
        * Update six to 1.13.0 / `Pull request #55 <https://github.com/glenjarvis/badgr-lite/pull/55>`_
        * Update pyparsing to 2.4.3 / `Pull request #53 <https://github.com/glenjarvis/badgr-lite/pull/53>`_
        * Remove Python 3.5 caveat in README / `Pull request #52 <https://github.com/glenjarvis/badgr-lite/pull/52>`_
        * Update vcrpy to 2.1.1 / `Pull request #51 <https://github.com/glenjarvis/badgr-lite/pull/51>`_
        * Update tqdm to 4.37.0 / `Pull request #50 <https://github.com/glenjarvis/badgr-lite/pull/50>`_
        * Update typing-extensions to 3.7.4.1 / `Pull request #48 <https://github.com/glenjarvis/badgr-lite/pull/48>`_
        * Update sphinx to 2.2.1 / `Pull request #46 <https://github.com/glenjarvis/badgr-lite/pull/46>`_
        * Update virtualenv to 16.7.7 / `Pull request #45 <https://github.com/glenjarvis/badgr-lite/pull/45>`_
        * Update mypy-extensions to 0.4.3 / `Pull request #42 <https://github.com/glenjarvis/badgr-lite/pull/42>`_
        * Update mypy 0.740 / `Pull request #40 <https://github.com/glenjarvis/badgr-lite/pull/40>`_
        * Update virtualenv to 16.7.6 / `Pull request #39 <https://github.com/glenjarvis/badgr-lite/pull/39>`_
        * Reorder README shields / `Pull request #36 <https://github.com/glenjarvis/badgr-lite/pull/36>`_
        * Add code coverage / `Pull request #35 <https://github.com/glenjarvis/badgr-lite/pull/35>`_
        * Promote package to production level quality / `Pull request #33 <https://github.com/glenjarvis/badgr-lite/pull/33>`_
        * Update shield so travis looks at develop branch / `Pull request #31 <https://github.com/glenjarvis/badgr-lite/pull/31>`_
        * Update dependencies / `Pull request #30 <https://github.com/glenjarvis/badgr-lite/pull/30>`_
        * Update mypy-extensions to 0.4.2 / `Pull request #29 <https://github.com/glenjarvis/badgr-lite/pull/29>`_
        
        1.0.0 (2019-10-03)
        ------------------
            
        * Remove Travis support for Python 3.5 / `Pull request #27 <https://github.com/glenjarvis/badgr-lite/pull/27>`_
        * Update snowballstemmer to 2.0.0 / `Pull request #24 <https://github.com/glenjarvis/badgr-lite/pull/24>`_
        * [Fixes: #25] Remove support for Python 3.5 / `Pull request #26 <https://github.com/glenjarvis/badgr-lite/pull/26>`_
        * Update astroid to 2.3.1 / `Pull request #22 <https://github.com/glenjarvis/badgr-lite/pull/22>`_
        * [Fixes #20] Upgrade tox to 3.14.0 / `Pull request #21 <https://github.com/glenjarvis/badgr-lite/pull/21>`_
        * [Fixes #18] Fix README shields / `Pull request #19 <https://github.com/glenjarvis/badgr-lite/pull/19>`_
        
        0.0.1 (2019-09-26)
        ------------------
        
        * First release on PyPI.
        
Keywords: OpenBadge
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
