Skip to main content

Lots of helper functions and useful widgets.

Project description

pypi Downloads Documentation Status

Overview:

This package contains various useful helper functions. You can read up on all the fancy things at readthedocs.io.

Installation:

  • Install the package via pip:

    pip install ai-django-core

    or via pipenv:

    pipenv install ai-django-core

  • Add module to INSTALLED_APPS:

    INSTALLED_APPS = (
        ...
        'ai_django_core',
    )
    

Contribute

Add functionality

  • Clone the project locally

  • Create a new branch for your feature

  • Change the dependency in your requirements.txt to a local (editable) one that points to your local file system:

    -e /Users/awesome-developer/Documents/workspace/ai-django-core
    
  • Ensure the code passes the tests

  • Run:

    python setup.py develop

  • Create a pull request

Run tests

  • Check coverage

    pytest --cov=.

  • Run tests

    pytest

Update documentation

  • To generate new auto-docs for new modules run: sphinx-apidoc -o ./docs/modules/ ./ai_django_core/ (in the current setup an auto doc for the anti virus module is not supported due to installation and import problems. Since it might be removed in the future, that should be fine for now).
  • To build the documentation run: sphinx-build docs/ docs/_build/html/ or go into the docs folder and run: make html. Open docs/_build/html/index.html to see the documentation.

Translation files

How to create translation file:

  • Navigate to ai_django_core/ai_django_core (the inner directory!)
  • django-admin makemessages -l de
  • Have a look at the new/changed files within ai_django_core/ai_django_core/locale

How to compile translation files:

  • Navigate to ai_django_core/ai_django_core (the inner directory!)
  • django-admin compilemessages
  • Have a look at the new/changed files within ai_django_core/ai_django_core/locale

Publish to ReadTheDocs.io

  • Fetch the latest changes in github mirror and push them
  • Trigger new build at ReadTheDocs.io (follow instructions in admin panel at RTD)

Publish to PyPi

  • Update documentation about new/changed functionality

  • Update the Changelog

  • Increment version in main __init__.py

  • Create pull request / merge to master

  • Run:

    • Make sure you have all the required packages installed pip install twine wheel
    • Create a file in your home directory: ~/.pypirc
    [distutils]
    index-servers=
        pypi
        testpypi
    
    [pypi]
    repository: https://upload.pypi.org/legacy/
    username: ambient-innovation
    
    [testpypi]
    repository: https://test.pypi.org/legacy/
    username: ambient-innovation
    
    • Empty dist directory
    • Create distribution python setup.py sdist bdist_wheel
    • Upload to Test-PyPi twine upload --repository testpypi dist/*
    • Check at Test-PyPi if it looks nice
    • Upload to real PyPi twine upload dist/*

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ai-django-core, version 5.3.0
Filename, size File type Python version Upload date Hashes
Filename, size ai_django_core-5.3.0-py3-none-any.whl (87.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ai-django-core-5.3.0.tar.gz (50.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page