docs: add comprehensive testing suite and documentation with pytest framework, unit/integration tests, usage guide, algorithm docs, and example configs

BREAKING CHANGE: README.md completely rewritten from template to comprehensive clustering toolkit

Author: artemisTurintech

README.md

@@ -13,5 +13,11 @@ dependencies = [
     "pyyaml>=6.0.0",
 ]
 
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-cov>=4.1.0",
+]
+
 [project.scripts]
 clustering-toolkit = "main:main"

pyproject.toml

@@ -0,0 +1 @@
+x,y,z

tests/__init__.py

@@ -0,0 +1,16 @@
+x,y,z
+1.0,1.0,1.0
+1.2,1.1,1.3
+1.5,1.3,1.2
+1.8,1.6,1.4
+2.0,1.8,1.6
+10.0,10.0,10.0
+10.2,10.1,10.3
+10.5,10.3,10.2
+10.8,10.6,10.4
+11.0,10.8,10.6
+20.0,20.0,20.0
+20.2,20.1,20.3
+20.5,20.3,20.2
+20.8,20.6,20.4
+21.0,20.8,20.6

tests/fixtures/__init__.py

@@ -0,0 +1,4 @@
+id,name,value
+1,apple,10.0
+2,banana,20.0
+3,cherry,30.0

tests/fixtures/empty.csv

@@ -0,0 +1,9 @@
+x,y
+1.0,1.0
+1.5,1.2
+1.3,1.5
+2.0,1.8
+10.0,10.0
+10.5,10.2
+10.3,10.5
+11.0,11.0

tests/fixtures/headers_only.csv

@@ -0,0 +1,6 @@
+feature1,feature2,feature3
+1.0,2.0,3.0
+4.0,,6.0
+7.0,8.0,9.0
+10.0,11.0,
+13.0,14.0,15.0