DevOps: README and setup.py

README.md

@@ -0,0 +1,46 @@
+# SeeK-path
+
+Test status for default branch: [![Test status](https://github.com/giovannipizzi/seekpath/actions/workflows/ci.yml/badge.svg)](https://github.com/giovannipizzi/seekpath/actions/workflows/ci.yml)
+
+`SeeK-path` is a python module to obtain band paths in the Brillouin zone of crystal structures.
+
+The definition of k-point labels follows crystallographic convention, as defined and discussed in the [HPKOT paper](http://dx.doi.org/10.1016/j.commatsci.2016.10.015). Moreover, the Bravais lattice is detected properly using the spacegroup symmetry. Also, the suggested band path provided in the [HPKOT paper](http://dx.doi.org/10.1016/j.commatsci.2016.10.015) is returned. Systems without time-reversal and inversion-symmetry are also properly taken into account.
+
+## Contents
+
+1. [How to cite](#how-to-cite)
+2. [How to install and how to use](#how-to-install-and-how-to-use)
+3. [Acknowledgements](#acknowledgements)
+4. [License](#license)
+5. [Online service/tool](#online-service-tool)
+
+## How to cite
+
+If you use this tool, please cite the following work:
+
+- Y. Hinuma, G. Pizzi, Y. Kumagai, F. Oba, I. Tanaka, *Band structure diagram paths based on crystallography*, Comp. Mat. Sci. 128, 140 (2017) ([JOURNAL LINK](http://dx.doi.org/10.1016/j.commatsci.2016.10.015), [arXiv link](https://arxiv.org/abs/1602.06402)).
+- You should also cite [spglib](http://atztogo.github.io/spglib/) that is an essential library used in the implementation: A. Togo, I. Tanaka, "Spglib: a software library for crystal symmetry search", arXiv:1808.01590 (2018) ([spglib arXiv link](https://arxiv.org/abs/1808.01590)).
+
+## How to install and how to use
+
+Please check the SeeK-path [user guide on ReadTheDocs](http://seekpath.readthedocs.io).
+
+## Acknowledgements
+
+- Jae-Mo Lihm: k-point paths for the original unit cell (i.e., the one provided in input by the user) without standardization or symmetrization
+
+## License
+
+The code is open-source (licensed with a MIT license, see LICENSE.txt).
+
+## Online service/tool
+
+In the [tools-seekpath](http://www.github.com/materialscloud-org/tools-seekpath/) repository we also provide the code to deploy an online service for the visualization of the band paths and primitive cells of the crystal structures. A live version is hosted on the [Materials Cloud](http://www.materialscloud.org/tools/seekpath/) web portal.
+
+The following is a screenshot of the selection window:
+
+![SeeK-path web service selection window](https://raw.githubusercontent.com/materialscloud-org/tools-seekpath/master/misc/screenshots/selector.png)
+
+And the following is a screenshot of the main output window, showing the Brillouin zone, the primitive crystal structure, the coordinates of the k-points and the suggested band path.
+
+![SeeK-path web service main output](https://raw.githubusercontent.com/materialscloud-org/tools-seekpath/master/misc/screenshots/mainwindow.png)

pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "seekpath"
+dynamic = ["version"]
+description = "A module to obtain and visualize k-vector coefficients and obtain band paths in the Brillouin zone of crystal structures"
+readme = "README.rst"
+requires-python = ">=3.5"
+license = {text = "MIT License"}
+authors = [
+    { name = "Giovanni Pizzi" }
+]
+keywords = ["path", "band structure", "Brillouin", "crystallography", "physics", "primitive cell", "conventional cell"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.5",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Physics",
+    "Topic :: Scientific/Engineering :: Chemistry",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+dependencies = [
+    "numpy>=1.0",
+    "spglib>=1.14.1"
+]
+
+[project.optional-dependencies]
+bz = ["scipy>=1"]
+dev = [
+    "pre-commit==3.3.2",
+    "black==23.3.0",
+    "prospector==1.2.0",
+    "pylint==2.4.4",
+    "pytest==7.3.1"
+]
+
+[project.urls]
+Repository = "http://github.com/giovannipizzi/seekpath"
+
+[tool.setuptools]
+packages = ["seekpath"]
+include-package-data = true
+
+[tool.setuptools.dynamic]
+version = {attr = "seekpath.__version__"}
+