tox: initial tox setup

.pylintrc

@@ -2,6 +2,7 @@
 max-line-length=180
 
 [MASTER]
+ignore-paths=src/nasdaq_protocols/_version.py
 disable=
     C0114, #missing-module-docstring
     C0115, #missing-class-docstring

LICENSE → docs/LICENSE.rst

@@ -1,4 +1,5 @@
 MIT License
+===========
 
 Copyright (c) 2024 Nasdaq
 

docs/conf.py

@@ -35,4 +35,3 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 # https://www.sphinx-doc.org/en/master/usage/theming.html [themes]
 html_theme = 'agogo'
-html_static_path = ['_static']

docs/developer_guide.rst

@@ -0,0 +1,31 @@
+Developer's Guide
+=================
+
+This guide is intended for developers who want to contribute to the
+development of the `nasdaq-protocols` library.
+
+
+Guidelines
+----------
+Before merging to main, please ensure that the following guidelines are met:
+
+- All existing tests are passing.
+- New tests are added when needed.
+- Pylint reports no errors, 10/10
+- Code is documented and docstrings are added when needed.
+- Documentation is included in the rst files.
+
+
+Building
+________
+.. code-block:: console
+
+    $ tox r
+
+`tox r` will execute all of the following.
+
+- `tox -e lint` - Runs linter and validates the code
+- `tox -e test` - Runs the pytest test cases
+- `tox -e build` - Builds the package sdist and wheel
+- `tox -e doc` - Builds the documentation
+

docs/index.rst

@@ -15,6 +15,8 @@ Welcome to nasdaq-protocols's documentation!
    install
    api_reference
    user_guide
+   developer_guide
+   LICENSE
 
 
 Indices and tables

pyproject.toml

@@ -12,10 +12,13 @@ classifiers = [
     'Topic :: Software Development :: Libraries :: Python Modules'
 ]
 
-dynamic = ["version", "dependencies"]
+dependencies = [
+    'attrs>=23.1'
+]
+
+dynamic = ["version"]
 
 [tool.setuptools.dynamic]
-dependencies = {file = ["requirements.txt"]}
 version = {attr = "nasdaq_protocols/_version.version"}
 
 [tool.setuptools_scm]

tox.ini

@@ -0,0 +1,37 @@
+[tox]
+requires =
+    tox>4
+    virtualenv>20.2
+env_list =
+    lint
+    test
+    build
+    doc
+
+[testenv:lint]
+description = Run pylint
+deps = pylint
+commands = pylint --fail-under=10.0 "--ignore-patterns=.*egg-info.*,.*test.*" src/*
+
+
+[testenv:test]
+description = Run pytest
+deps =
+    pytest
+    pytest-asyncio
+    pytest-sugar
+commands = pytest
+
+
+[testenv:build]
+description = Build package
+deps = build
+commands = python -m build
+
+
+[testenv:doc]
+description = Build documenation
+deps = sphinx
+commands = make html
+change_dir = docs
+allowlist_externals = make