lindera-python 1.3.0__tar.gz → 1.3.1__tar.gz

{lindera_python-1.3.0 → lindera_python-1.3.1}/Cargo.lock

@@ -2,15 +2,6 @@
 # It is not intended for manual editing.
 version = 4
 
-[[package]]
-name = "addr2line"
-version = "0.24.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dfbe277e56a376000877090da837660b4427aad530e3028d44e0bffe4f89a1c1"
-dependencies = [
- "gimli",
-]
-
 [[package]]
 name = "adler2"
 version = "2.0.0"
@@ -97,21 +88,6 @@ version = "1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"
 
-[[package]]
-name = "backtrace"
-version = "0.3.74"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8d82cb332cdfaed17ae235a638438ac4d4839913cc2af585c3c6746e8f8bee1a"
-dependencies = [
- "addr2line",
- "cfg-if",
- "libc",
- "miniz_oxide",
- "object",
- "rustc-demangle",
- "windows-targets",
-]
-
 [[package]]
 name = "base64"
 version = "0.22.1"
@@ -540,12 +516,6 @@ dependencies = [
  "wasm-bindgen",
 ]
 
-[[package]]
-name = "gimli"
-version = "0.31.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "07e28edb80900c19c28f1072f2e8aeca7fa06b23cd4169cefe1af5aa3260783f"
-
 [[package]]
 name = "glob"
 version = "0.3.3"
@@ -876,17 +846,6 @@ dependencies = [
  "cfg-if",
 ]
 
-[[package]]
-name = "io-uring"
-version = "0.7.9"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d93587f37623a1a17d94ef2bc9ada592f5465fe7732084ab7beefabe5c77c0c4"
-dependencies = [
- "bitflags 2.6.0",
- "cfg-if",
- "libc",
-]
-
 [[package]]
 name = "ipnet"
 version = "2.10.1"
@@ -947,9 +906,9 @@ checksum = "1171693293099992e19cddea4e8b849964e9846f4acee11b3948bcc337be8776"
 
 [[package]]
 name = "lindera"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "737cdbd7df815d8cf5982bc9bbd30344c4964d041f8067c0ab6fbc3db0c924e4"
+checksum = "f0e109baf46c2494539663466a49d54bd62f655a4356757269b72d1e1019ff2c"
 dependencies = [
  "anyhow",
  "bincode",
@@ -979,9 +938,9 @@ dependencies = [
 
 [[package]]
 name = "lindera-cc-cedict"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "84620141298ea1060835800f116db105596f39ba5fe10bce397133e6cdd981d9"
+checksum = "965ef21c68d3f5453076366a58d05c154e639a5d1e9b0d86a048a6a3486fb1cc"
 dependencies = [
  "anyhow",
  "bincode",
@@ -995,9 +954,9 @@ dependencies = [
 
 [[package]]
 name = "lindera-dictionary"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "609fd8f72a2ffc1b2a71e9bdb73f723d3c0f676255c37a14b3f4f02981c59437"
+checksum = "d493e407b18951da7852d2b021b1f7e001a2963accb17a321c8fd48b60a9e343"
 dependencies = [
  "anyhow",
  "bincode",
@@ -1030,9 +989,9 @@ dependencies = [
 
 [[package]]
 name = "lindera-ipadic"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "292173f5cea3aa09af01f1b8e163f66e6be3fef7b81466e0efaae3314df56c58"
+checksum = "567746f82c01052e05539f2731ce2ad62eddebe5ae96453e9534a87bc9cfafc9"
 dependencies = [
  "anyhow",
  "bincode",
@@ -1046,9 +1005,9 @@ dependencies = [
 
 [[package]]
 name = "lindera-ipadic-neologd"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7bac14263d5d3b0ac7674c0d2321b987230df96f5b3df59d2015491598d6102d"
+checksum = "350f17ced5cbf2964ee29ddef1094703fd1df7c20d464dec6106b7b7ee038030"
 dependencies = [
  "anyhow",
  "bincode",
@@ -1062,9 +1021,9 @@ dependencies = [
 
 [[package]]
 name = "lindera-ko-dic"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5c1e5bde25a381e689466669f3a6e14e05b55a3fa6b60b98701ae12ca6fba330"
+checksum = "d2dda2995055967b409c4d1f311b7db796a3279c78607838325f8892a1542960"
 dependencies = [
  "anyhow",
  "bincode",
@@ -1078,7 +1037,7 @@ dependencies = [
 
 [[package]]
 name = "lindera-python"
-version = "1.3.0"
+version = "1.3.1"
 dependencies = [
  "lindera",
  "num_cpus",
@@ -1089,9 +1048,9 @@ dependencies = [
 
 [[package]]
 name = "lindera-unidic"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "139acd137f64722a1f754f4ed8e824c59ea9b4a0547633444ec94720ebd1efc9"
+checksum = "e6a03bdf3acbd493e95ac182fef6194c09556a04dcbebbaeddca47d5ae6ec5f6"
 dependencies = [
  "anyhow",
  "bincode",
@@ -1222,15 +1181,6 @@ dependencies = [
  "libc",
 ]
 
-[[package]]
-name = "object"
-version = "0.36.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "aedf0a2d09c573ed1d8d85b30c119153926a2b36dce0ab28322c09a117a4683e"
-dependencies = [
- "memchr",
-]
-
 [[package]]
 name = "once_cell"
 version = "1.21.3"
@@ -1293,9 +1243,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3"
-version = "0.26.0"
+version = "0.27.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7ba0117f4212101ee6544044dae45abe1083d30ce7b29c4b5cbdfa2354e07383"
+checksum = "37a6df7eab65fc7bee654a421404947e10a0f7085b6951bf2ea395f4659fb0cf"
 dependencies = [
  "indoc",
  "libc",
@@ -1310,18 +1260,18 @@ dependencies = [
 
 [[package]]
 name = "pyo3-build-config"
-version = "0.26.0"
+version = "0.27.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4fc6ddaf24947d12a9aa31ac65431fb1b851b8f4365426e182901eabfb87df5f"
+checksum = "f77d387774f6f6eec64a004eac0ed525aab7fa1966d94b42f743797b3e395afb"
 dependencies = [
  "target-lexicon",
 ]
 
 [[package]]
 name = "pyo3-ffi"
-version = "0.26.0"
+version = "0.27.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "025474d3928738efb38ac36d4744a74a400c901c7596199e20e45d98eb194105"
+checksum = "2dd13844a4242793e02df3e2ec093f540d948299a6a77ea9ce7afd8623f542be"
 dependencies = [
  "libc",
  "pyo3-build-config",
@@ -1329,9 +1279,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros"
-version = "0.26.0"
+version = "0.27.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2e64eb489f22fe1c95911b77c44cc41e7c19f3082fc81cce90f657cdc42ffded"
+checksum = "eaf8f9f1108270b90d3676b8679586385430e5c0bb78bb5f043f95499c821a71"
 dependencies = [
  "proc-macro2",
  "pyo3-macros-backend",
@@ -1341,9 +1291,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros-backend"
-version = "0.26.0"
+version = "0.27.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "100246c0ecf400b475341b8455a9213344569af29a3c841d29270e53102e0fcf"
+checksum = "70a3b2274450ba5288bc9b8c1b69ff569d1d61189d4bff38f8d22e03d17f932b"
 dependencies = [
  "heck",
  "proc-macro2",
@@ -1595,12 +1545,6 @@ dependencies = [
  "hashbrown",
 ]
 
-[[package]]
-name = "rustc-demangle"
-version = "0.1.24"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "719b953e2095829ee67db738b3bfa9fa368c94900df327b3f07fe6e794d2fe1f"
-
 [[package]]
 name = "rustc-hash"
 version = "2.1.1"
@@ -2028,27 +1972,24 @@ checksum = "cda74da7e1a664f795bb1f8a87ec406fb89a02522cf6e50620d016add6dbbf5c"
 
 [[package]]
 name = "tokio"
-version = "1.47.1"
+version = "1.48.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "89e49afdadebb872d3145a5638b59eb0691ea23e46ca484037cfab3b76b95038"
+checksum = "ff360e02eab121e0bc37a2d3b4d4dc622e6eda3a8e5253d5435ecf5bd4c68408"
 dependencies = [
- "backtrace",
  "bytes",
- "io-uring",
  "libc",
  "mio",
  "pin-project-lite",
- "slab",
  "socket2 0.6.0",
  "tokio-macros",
- "windows-sys 0.59.0",
+ "windows-sys 0.61.2",
 ]
 
 [[package]]
 name = "tokio-macros"
-version = "2.5.0"
+version = "2.6.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6e06d43f1345a3bcd39f6a56dbb7dcab2ba47e68e8ac134855e7e2bdbaf8cab8"
+checksum = "af407857209536a95c8e56f8231ef2c2e2aff839b22e07a1ffcbc617e9db9fa5"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2387,9 +2328,9 @@ dependencies = [
 
 [[package]]
 name = "windows-link"
-version = "0.2.0"
+version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "45e46c0661abb7180e7b9c281db115305d49ca1709ab8242adf09666d2173c65"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
 
 [[package]]
 name = "windows-result"
@@ -2442,6 +2383,15 @@ dependencies = [
  "windows-targets",
 ]
 
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link",
+]
+
 [[package]]
 name = "windows-targets"
 version = "0.52.6"

{lindera_python-1.3.0 → lindera_python-1.3.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "lindera-python"
-version = "1.3.0"
+version = "1.3.1"
 edition = "2024"
 description = "Python binding for Lindera."
 documentation = "https://docs.rs/lindera-python"
@@ -39,9 +39,9 @@ train = ["lindera/train"] # Enable training functionality
 default = ["train"] # No directories included
 
 [dependencies]
-pyo3 = { version = "0.26.0", features = ["extension-module"] }
+pyo3 = { version = "0.27.1", features = ["extension-module"] }
 serde = { version = "1.0.228", features = ["derive"] }
 serde_json = "1.0.145"
 num_cpus = "1.17.0"
 
-lindera = "1.4.0"
+lindera = "1.4.1"

{lindera_python-1.3.0 → lindera_python-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lindera-python
-Version: 1.3.0
+Version: 1.3.1
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9

{lindera_python-1.3.0 → lindera_python-1.3.1}/poetry.lock

@@ -125,14 +125,14 @@ dev = ["pyTest", "pyTest-cov"]
 
 [[package]]
 name = "iniconfig"
-version = "2.1.0"
+version = "2.3.0"
 description = "brain-dead simple config-ini parsing"
 optional = false
-python-versions = ">=3.8"
+python-versions = ">=3.10"
 groups = ["dev"]
 files = [
-    {file = "iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760"},
-    {file = "iniconfig-2.1.0.tar.gz", hash = "sha256:3abbd2e30b36733fee78f9c7f7308f2d0050e88f0087fd25c2645f63c773e1c7"},
+    {file = "iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12"},
+    {file = "iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730"},
 ]
 
 [[package]]
@@ -405,14 +405,14 @@ dev = ["argcomplete", "attrs (>=19.2)", "hypothesis (>=3.56)", "mock", "requests
 
 [[package]]
 name = "pytokens"
-version = "0.1.10"
-description = "A Fast, spec compliant Python 3.12+ tokenizer that runs on older Pythons."
+version = "0.2.0"
+description = "A Fast, spec compliant Python 3.13+ tokenizer that runs on older Pythons."
 optional = false
 python-versions = ">=3.8"
 groups = ["dev"]
 files = [
-    {file = "pytokens-0.1.10-py3-none-any.whl", hash = "sha256:db7b72284e480e69fb085d9f251f66b3d2df8b7166059261258ff35f50fb711b"},
-    {file = "pytokens-0.1.10.tar.gz", hash = "sha256:c9a4bfa0be1d26aebce03e6884ba454e842f186a59ea43a6d3b25af58223c044"},
+    {file = "pytokens-0.2.0-py3-none-any.whl", hash = "sha256:74d4b318c67f4295c13782ddd9abcb7e297ec5630ad060eb90abf7ebbefe59f8"},
+    {file = "pytokens-0.2.0.tar.gz", hash = "sha256:532d6421364e5869ea57a9523bf385f02586d4662acbcc0342afd69511b4dd43"},
 ]
 
 [package.extras]

{lindera_python-1.3.0 → lindera_python-1.3.1}/pyproject.toml

@@ -3,7 +3,7 @@ module-name = "lindera"
 
 [project]
 name = "lindera-python"
-version = "1.3.0"
+version = "1.3.1"
 description = "Python binding for Lindera (no embedded dictionaries)"
 authors = [{ name = "Minoru Osuka", email = "minoru.osuka@gmail.com" }]
 license = { text = "MIT" }

lindera_python-1.3.1/src/dictionary.rs

@@ -0,0 +1,302 @@
+//! Dictionary management for morphological analysis.
+//!
+//! This module provides functionality for building, loading, and managing dictionaries
+//! used in morphological analysis.
+//!
+//! # Dictionary Types
+//!
+//! - **Dictionary**: Main dictionary for morphological analysis
+//! - **UserDictionary**: Custom user-defined dictionary for additional words
+//!
+//! # Examples
+//!
+//! ```python
+//! import lindera
+//!
+//! # Load a pre-built dictionary
+//! dictionary = lindera.load_dictionary("ipadic")
+//!
+//! # Build a custom dictionary
+//! metadata = lindera.Metadata()
+//! lindera.build_dictionary("/path/to/input", "/path/to/output", metadata)
+//!
+//! # Build a user dictionary
+//! lindera.build_user_dictionary("ipadic", "user.csv", "/path/to/output")
+//! ```
+
+use std::path::Path;
+
+use pyo3::{exceptions::PyValueError, prelude::*};
+
+use lindera::dictionary::{
+    Dictionary, DictionaryBuilder, Metadata, UserDictionary,
+    load_dictionary as lindera_load_dictionary,
+    load_user_dictionary as lindera_load_user_dictionary,
+};
+
+use crate::metadata::PyMetadata;
+
+/// A morphological analysis dictionary.
+///
+/// Contains the data structures needed for tokenization and morphological analysis.
+///
+/// # Examples
+///
+/// ```python
+/// # Load a dictionary
+/// dictionary = lindera.load_dictionary("ipadic")
+///
+/// # Access metadata
+/// print(dictionary.metadata_name())
+/// print(dictionary.metadata_encoding())
+/// ```
+#[pyclass(name = "Dictionary")]
+#[derive(Clone)]
+pub struct PyDictionary {
+    pub inner: Dictionary,
+}
+
+#[pymethods]
+impl PyDictionary {
+    /// Returns the name of the dictionary metadata.
+    pub fn metadata_name(&self) -> String {
+        self.inner.metadata.name.clone()
+    }
+
+    /// Returns the character encoding of the dictionary.
+    pub fn metadata_encoding(&self) -> String {
+        self.inner.metadata.encoding.clone()
+    }
+
+    /// Returns the full metadata object of the dictionary.
+    pub fn metadata(&self) -> PyMetadata {
+        PyMetadata::from(self.inner.metadata.clone())
+    }
+
+    fn __str__(&self) -> String {
+        "Dictionary".to_string()
+    }
+
+    fn __repr__(&self) -> String {
+        "Dictionary()".to_string()
+    }
+}
+
+impl PyDictionary {
+    // Internal helper function to create PyDictionary from Lindera Dictionary
+    pub fn new(dictionary: Dictionary) -> Self {
+        Self { inner: dictionary }
+    }
+}
+
+/// A user-defined dictionary for custom words.
+///
+/// User dictionaries allow you to add custom words and their morphological features
+/// that are not present in the main dictionary.
+///
+/// # Examples
+///
+/// ```python
+/// # Build a user dictionary
+/// lindera.build_user_dictionary("ipadic", "user.csv", "/path/to/output")
+///
+/// # Load it
+/// metadata = lindera.Metadata()
+/// user_dict = lindera.load_user_dictionary("/path/to/output", metadata)
+/// ```
+#[pyclass(name = "UserDictionary")]
+#[derive(Clone)]
+pub struct PyUserDictionary {
+    pub inner: UserDictionary,
+}
+
+#[pymethods]
+impl PyUserDictionary {
+    fn __str__(&self) -> String {
+        "UserDictionary".to_string()
+    }
+
+    fn __repr__(&self) -> String {
+        "UserDictionary()".to_string()
+    }
+}
+
+impl PyUserDictionary {
+    // Internal helper function to create PyUserDictionary from Lindera UserDictionary
+    pub fn new(user_dictionary: UserDictionary) -> Self {
+        Self {
+            inner: user_dictionary,
+        }
+    }
+}
+
+/// Builds a dictionary from source files.
+///
+/// # Arguments
+///
+/// * `input_dir` - Directory containing dictionary source files.
+/// * `output_dir` - Directory where the built dictionary will be saved.
+/// * `metadata` - Metadata configuration for the dictionary.
+///
+/// # Errors
+///
+/// Returns an error if the input directory doesn't exist or if the build fails.
+///
+/// # Examples
+///
+/// ```python
+/// metadata = lindera.Metadata(name="custom", encoding="UTF-8")
+/// lindera.build_dictionary("/path/to/input", "/path/to/output", metadata)
+/// ```
+#[pyfunction]
+#[pyo3(signature = (input_dir, output_dir, metadata))]
+pub fn build_dictionary(input_dir: &str, output_dir: &str, metadata: PyMetadata) -> PyResult<()> {
+    let input_path = Path::new(input_dir);
+    let output_path = Path::new(output_dir);
+
+    if !input_path.exists() {
+        return Err(PyValueError::new_err(format!(
+            "Input directory does not exist: {input_dir}"
+        )));
+    }
+
+    let builder = DictionaryBuilder::new(metadata.into());
+
+    builder
+        .build_dictionary(input_path, output_path)
+        .map_err(|e| PyValueError::new_err(format!("Failed to build dictionary: {e}")))?;
+
+    Ok(())
+}
+
+/// Builds a user dictionary from a CSV file.
+///
+/// # Arguments
+///
+/// * `_kind` - Dictionary kind (currently unused, reserved for future use).
+/// * `input_file` - Path to the CSV file containing user dictionary entries.
+/// * `output_dir` - Directory where the built user dictionary will be saved.
+/// * `metadata` - Optional metadata configuration. If None, default values are used.
+///
+/// # CSV Format
+///
+/// The CSV file should contain entries in the format specified by the dictionary schema.
+/// Typically: surface,reading,pronunciation
+///
+/// # Errors
+///
+/// Returns an error if the input file doesn't exist or if the build fails.
+///
+/// # Examples
+///
+/// ```python
+/// # Build with default metadata
+/// lindera.build_user_dictionary("ipadic", "user.csv", "/path/to/output")
+///
+/// # Build with custom metadata
+/// metadata = lindera.Metadata()
+/// lindera.build_user_dictionary("ipadic", "user.csv", "/path/to/output", metadata)
+/// ```
+#[pyfunction]
+#[pyo3(signature = (_kind, input_file, output_dir, metadata=None))]
+pub fn build_user_dictionary(
+    _kind: &str,
+    input_file: &str,
+    output_dir: &str,
+    metadata: Option<crate::metadata::PyMetadata>,
+) -> PyResult<()> {
+    let input_path = Path::new(input_file);
+    let output_path = Path::new(output_dir);
+
+    if !input_path.exists() {
+        return Err(PyValueError::new_err(format!(
+            "Input file does not exist: {input_file}"
+        )));
+    }
+
+    // Use provided metadata or create default
+    let meta = match metadata {
+        Some(py_metadata) => {
+            let lindera_meta: Metadata = py_metadata.into();
+            lindera_meta
+        }
+        None => Metadata::default(),
+    };
+
+    let builder = DictionaryBuilder::new(meta);
+
+    // Build user dictionary from CSV
+    builder
+        .build_user_dictionary(input_path, output_path)
+        .map_err(|e| PyValueError::new_err(format!("Failed to build user dictionary: {e}")))?;
+
+    Ok(())
+}
+
+/// Loads a dictionary from the specified URI.
+///
+/// # Arguments
+///
+/// * `uri` - URI to the dictionary. Can be a file path or embedded dictionary name.
+///
+/// # Supported URIs
+///
+/// - File paths: `/path/to/dictionary`
+/// - Embedded dictionaries: `ipadic`, `unidic`, `ko-dic`, `cc-cedict`
+///
+/// # Returns
+///
+/// A loaded `Dictionary` object.
+///
+/// # Errors
+///
+/// Returns an error if the dictionary cannot be loaded from the specified URI.
+///
+/// # Examples
+///
+/// ```python
+/// # Load an embedded dictionary
+/// dict = lindera.load_dictionary("ipadic")
+///
+/// # Load from file path
+/// dict = lindera.load_dictionary("/path/to/dictionary")
+/// ```
+#[pyfunction]
+#[pyo3(signature = (uri))]
+pub fn load_dictionary(uri: &str) -> PyResult<PyDictionary> {
+    lindera_load_dictionary(uri)
+        .map_err(|e| PyValueError::new_err(format!("Failed to load dictionary from '{uri}': {e}")))
+        .map(PyDictionary::new)
+}
+
+/// Loads a user dictionary from the specified URI.
+///
+/// # Arguments
+///
+/// * `uri` - URI to the user dictionary directory.
+/// * `metadata` - Metadata configuration for the user dictionary.
+///
+/// # Returns
+///
+/// A loaded `UserDictionary` object.
+///
+/// # Errors
+///
+/// Returns an error if the user dictionary cannot be loaded.
+///
+/// # Examples
+///
+/// ```python
+/// metadata = lindera.Metadata()
+/// user_dict = lindera.load_user_dictionary("/path/to/user_dict", metadata)
+/// ```
+#[pyfunction]
+#[pyo3(signature = (uri, metadata))]
+pub fn load_user_dictionary(uri: &str, metadata: PyMetadata) -> PyResult<PyUserDictionary> {
+    let meta: Metadata = metadata.into();
+    lindera_load_user_dictionary(uri, &meta)
+        .map_err(|e| {
+            PyValueError::new_err(format!("Failed to load user dictionary from '{uri}': {e}"))
+        })
+        .map(PyUserDictionary::new)
+}