chandas 0.0.3

Metrical analysis tools for indic languages in general, and sanskrit in particular

Chandas
=======

|Build Status| |Documentation Status|

For users
=========

- `Autogenerated Docs on readthedocs (might be
broken) <http://chandas.readthedocs.io/en/latest/>`__.
- Manually and periodically generated docs
`here <https://sanskrit-coders.github.io/chandas/build/html/>`__
- For detailed examples and help, please see individual module files in
this package.

Installation or upgrade:
------------------------

- ``sudo pip install chandas -U``
- ``sudo pip install git+https://github.com/sanskrit-coders/chandas/@master -U``
- `Web <https://pypi.python.org/pypi/chandas>`__.

Usage
-----

For more examples, see tests.

Metre Identification
~~~~~~~~~~~~~~~~~~~~

::

from chandas import identify
pattern_lines = "निर्दिष्टाङ् कुलपतिना स पर्णशालाम् अध्यास्य प्रयतपरिग्रहद्वितीयः ।\nतच्छिष्याध्ययननिवेदितावसानां सव्ँविष्टः कुशशयने निशान् निनाय ॥".split("\n")
id_result = identify.identifier.IdentifyFromPatternLines(pattern_lines)
assert id_result['exact'] == "Praharṣiṇī"

Syllabization
~~~~~~~~~~~~~

::

from chandas import syllabize
syllabize.get_syllables(u"ॐ मणि पद्मे ऽहम्") == "ओम् म णि पद् मे हम्"
syllabize.get_graphemes(u"बिक्रममेरोनामहो") == "बि क् र म मे रो ना म हो".split(" ")

Shared test data
----------------

Please feel free to use test data published here to test your own
modules:

- `syllabizationTests.json <https://github.com/sanskrit-coders/chandas/blob/master/src/test/data/syllabizationTests.json>`__

For contributors
================

Intro and acknowledgement
-------------------------

We copy much code from `shreevatsa's
repo <https://github.com/shreevatsa/sanskrit/>`__.

Contact
-------

Have a problem or question? Please head to
`github <https://github.com/sanskrit-coders/chandas>`__.

Packaging
---------

- ~/.pypirc should have your pypi login credentials.

::

python setup.py bdist_wheel
twine upload dist/* --skip-existing

Build documentation
-------------------

- sphinx html docs can be generated with ``cd docs; make html``

Testing
-------

Run ``pytest`` in the root directory.

Auxiliary tools
---------------

- |Build Status|
- |Documentation Status|
- `pyup <https://pyup.io/account/repos/github/sanskrit-coders/chandas/>`__

.. |Build Status| image:: https://travis-ci.org/sanskrit-coders/chandas.svg?branch=master
:target: https://travis-ci.org/sanskrit-coders/chandas
.. |Documentation Status| image:: https://readthedocs.org/projects/chandas/badge/?version=latest
:target: http://chandas.readthedocs.io/en/latest/?badge=latest
.. |Documentation Status| image:: https://readthedocs.org/projects/indic-transliteration/badge/?version=latest
:target: http://indic-transliteration.readthedocs.io/en/latest/?badge=latest