fix: resolve Python 3.14 SegFault and modernize PyO3 implementation

.gitignore

@@ -0,0 +1,35 @@
+# --- Rust ---
+/target
+# Usually Cargo.lock is committed for reproducible builds, 
+# but uncomment the next line if you prefer to ignore it:
+# Cargo.lock
+
+# --- Python ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.pyd
+.venv/
+env/
+venv/
+ENV/
+build/
+dist/
+*.egg-info/
+.python-version
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# --- UV ---
+# uv.lock is recommended to be committed for projects
+# uv.lock
+
+# --- IDEs & OS ---
+.vscode/
+.idea/
+.DS_Store
+*.swp
+*.swo
+*~

Cargo.toml

@@ -7,12 +7,12 @@ edition = "2021"
 crate-type = ["cdylib"]
 
 [dependencies]
-pyo3 = { version = "0.18", features = ["extension-module"] }
+pyo3 = { version = "0.28.2", features = ["abi3-py39"] }
 rust-stemmers = "1.2.0"
 rayon = "1.6"
 
 [dev-dependencies]
-pyo3 = { version = "0.18", features = ["extension-module"] }
+pyo3 = { version = "0.28.2", features = ["abi3-py39"] }
 
 [profile.release]
 opt-level = 3

py_rust_stemmers/__init__.py

@@ -0,0 +1,3 @@
+from .py_rust_stemmers import SnowballStemmer  # type: ignore
+
+__all__ = ["SnowballStemmer"]

py_rust_stemmers/__init__.pyi

@@ -0,0 +1,55 @@
+from typing import Iterable, List, TypeVar
+
+_S = TypeVar("_S", bound=str)
+
+class SnowballStemmer:
+    """
+    A fast and parallel Snowball stemmer implemented in Rust.
+    """
+    def __init__(self, lang: str) -> None:
+        """
+        Create a new SnowballStemmer for the specified language.
+
+        Args:
+            lang: The language to use (e.g., 'english', 'spanish').
+
+        Raises:
+            ValueError: If the language is not supported.
+        """
+        ...
+
+    def stem_word(self, input: str) -> str:
+        """
+        Stem a single word.
+
+        Args:
+            input: The word to stem.
+
+        Returns:
+            The stemmed word.
+        """
+        ...
+
+    def stem_words(self, inputs: Iterable[_S]) -> List[str]:
+        """
+        Stem an iterable of words sequentially.
+
+        Args:
+            inputs: An iterable of words to stem.
+
+        Returns:
+            A list of stemmed words.
+        """
+        ...
+
+    def stem_words_parallel(self, inputs: Iterable[_S]) -> List[str]:
+        """
+        Stem an iterable of words in parallel using Rayon.
+
+        Args:
+            inputs: An iterable of words to stem.
+
+        Returns:
+            A list of stemmed words.
+        """
+        ...

pyproject.toml

@@ -2,13 +2,37 @@
 name = "py_rust_stemmers"
 version = "0.1.5"
 description = "Fast and parallel snowball stemmer"
-
-# Include a long description
 readme = "README.md"
+requires-python = ">=3.9"
+authors = [{ name = "Qdrant", email = "info@qdrant.com" }]
+license = { text = "MIT" }
+repository = "https://github.com/ElissonRodrigues/py-rust-stemmers"
+classifiers = [
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Text Processing :: Linguistic",
+]
 
 [build-system]
 requires = ["maturin>=0.12"]
 build-backend = "maturin"
 
+[tool.maturin]
+features = ["pyo3/abi3-py39"]
 
-# Other fields like authors, dependencies, etc.
+[dependency-groups]
+dev = [
+    "pytest",
+    "tqdm",
+    "snowballstemmer",
+    "puccinialin", # Necessary for build in this environment
+]