###For sphinx
sphinx-quickstart docs
Separate source and build directories (y/n) [n]: y
sys.path.insert(0, os.path.abspath('../../..')) in source/conf.py
extensions = ['sphinx.ext.autodoc','sphinx.ext.viewcode']
html_theme = 'classic'


in docs folder:
sphinx-apidoc -f -o source/ ../jarvis/ 
make html



##For pypi
https://gist.github.com/gboeing/dcfaf5e13fad16fc500717a3a324ec17
Make ~/.pypirc
++++++++++++++++++++++
[distutils]
index-servers = pypi

[pypi]
repository = https://upload.pypi.org/legacy/
username = abc
password = xyz
+++++++++++++++++++++++++

python setup.py sdist bdist_wheel --universal
twine check dist/*
twine  upload dist/*





###covergae
#!/bin/bash
pytest
coverage run -m pytest
coverage report -m



###Version change
Change version in setup.py and jarvis/__init__.py


###Linting
flake8 --ignore E203,W503 *.py
black -l 79 *.py
pycodestyle --ignore E203,W503 *.py


###Delete a branch
git push origin --delete develop



###XML related
# debug using xmllint --valid --noout JVASP-1002.xml
# xmllint --format JVASP-1002.xml>out.xml
# https://www.luxonsoftware.com/converter/xmltoxsd
# https://extendsclass.com/xml-schema-validator.html



#MD to RST after tree command
tree --dirsfirst --noreport -I README.md | sed 's/^/    /' > README.md
