nihonshufyi 0.1.0__tar.gz

nihonshufyi-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+*.pyo
+dist/
+*.egg-info/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/

nihonshufyi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FYIPedia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nihonshufyi-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: nihonshufyi
+Version: 0.1.0
+Summary: Sake knowledge API client — search sake grades, breweries, and terms from NihonshuFYI.
+Project-URL: Homepage, https://nihonshufyi.com
+Project-URL: Documentation, https://nihonshufyi.com/developers/
+Project-URL: Repository, https://github.com/fyipedia/nihonshufyi
+Project-URL: Issues, https://github.com/fyipedia/nihonshufyi/issues
+Project-URL: Changelog, https://github.com/fyipedia/nihonshufyi/releases
+Author: FYIPedia
+License-Expression: MIT
+License-File: LICENSE
+Keywords: brewery,daiginjo,japanese-rice-wine,junmai,koji,nihonshu,prefecture,rice,sake,umami
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: all
+Requires-Dist: httpx>=0.27; extra == 'all'
+Requires-Dist: mcp>=1.0; extra == 'all'
+Requires-Dist: rich>=13.0; extra == 'all'
+Requires-Dist: typer>=0.15; extra == 'all'
+Provides-Extra: api
+Requires-Dist: httpx>=0.27; extra == 'api'
+Provides-Extra: cli
+Requires-Dist: rich>=13.0; extra == 'cli'
+Requires-Dist: typer>=0.15; extra == 'cli'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# nihonshufyi
+
+Sake knowledge API client for developers — search sake grades, breweries, and terminology from [NihonshuFYI](https://nihonshufyi.com).
+
+## Install
+
+```bash
+pip install nihonshufyi[api]     # API client (httpx)
+pip install nihonshufyi[cli]     # + CLI (typer, rich)
+pip install nihonshufyi[mcp]     # + MCP server
+pip install nihonshufyi[all]     # Everything
+```
+
+## Quick Start
+
+```python
+from nihonshufyi.api import NihonshuFYI
+
+with NihonshuFYI() as api:
+    results = api.search("junmai daiginjo")
+    print(results)
+```
+
+## CLI
+
+```bash
+nihonshufyi search "junmai daiginjo"
+nihonshufyi search "niigata"
+nihonshufyi search "yamada nishiki"
+```
+
+## MCP Server
+
+```bash
+# Add to Claude Desktop config
+python -m nihonshufyi.mcp_server
+```
+
+Tools: `sake_search`
+
+## API Client
+
+```python
+from nihonshufyi.api import NihonshuFYI
+
+with NihonshuFYI() as api:
+    # Search sakes, breweries, glossary terms
+    results = api.search("junmai daiginjo")
+```
+
+## Links
+
+- [NihonshuFYI](https://nihonshufyi.com) — Sake encyclopedia with grades, breweries, and terminology
+- [PyPI](https://pypi.org/project/nihonshufyi/)
+- [GitHub](https://github.com/fyipedia/nihonshufyi)
+- [FYIPedia](https://fyipedia.com) — Open-source developer tools ecosystem

nihonshufyi-0.1.0/README.md

@@ -0,0 +1,56 @@
+# nihonshufyi
+
+Sake knowledge API client for developers — search sake grades, breweries, and terminology from [NihonshuFYI](https://nihonshufyi.com).
+
+## Install
+
+```bash
+pip install nihonshufyi[api]     # API client (httpx)
+pip install nihonshufyi[cli]     # + CLI (typer, rich)
+pip install nihonshufyi[mcp]     # + MCP server
+pip install nihonshufyi[all]     # Everything
+```
+
+## Quick Start
+
+```python
+from nihonshufyi.api import NihonshuFYI
+
+with NihonshuFYI() as api:
+    results = api.search("junmai daiginjo")
+    print(results)
+```
+
+## CLI
+
+```bash
+nihonshufyi search "junmai daiginjo"
+nihonshufyi search "niigata"
+nihonshufyi search "yamada nishiki"
+```
+
+## MCP Server
+
+```bash
+# Add to Claude Desktop config
+python -m nihonshufyi.mcp_server
+```
+
+Tools: `sake_search`
+
+## API Client
+
+```python
+from nihonshufyi.api import NihonshuFYI
+
+with NihonshuFYI() as api:
+    # Search sakes, breweries, glossary terms
+    results = api.search("junmai daiginjo")
+```
+
+## Links
+
+- [NihonshuFYI](https://nihonshufyi.com) — Sake encyclopedia with grades, breweries, and terminology
+- [PyPI](https://pypi.org/project/nihonshufyi/)
+- [GitHub](https://github.com/fyipedia/nihonshufyi)
+- [FYIPedia](https://fyipedia.com) — Open-source developer tools ecosystem

nihonshufyi-0.1.0/pyproject.toml

@@ -0,0 +1,88 @@
+[project]
+name = "nihonshufyi"
+version = "0.1.0"
+description = "Sake knowledge API client — search sake grades, breweries, and terms from NihonshuFYI."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "FYIPedia" }]
+keywords = [
+    "sake",
+    "nihonshu",
+    "japanese-rice-wine",
+    "junmai",
+    "daiginjo",
+    "brewery",
+    "koji",
+    "umami",
+    "prefecture",
+    "rice",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "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",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+    "Environment :: Console",
+]
+dependencies = []
+
+[project.optional-dependencies]
+api = ["httpx>=0.27"]
+cli = ["typer>=0.15", "rich>=13.0"]
+mcp = ["mcp>=1.0"]
+all = ["nihonshufyi[api,cli,mcp]"]
+
+[project.scripts]
+nihonshufyi = "nihonshufyi.cli:app"
+
+[project.entry-points."mcp.servers"]
+nihonshufyi = "nihonshufyi.mcp_server:mcp"
+
+[project.urls]
+Homepage = "https://nihonshufyi.com"
+Documentation = "https://nihonshufyi.com/developers/"
+Repository = "https://github.com/fyipedia/nihonshufyi"
+Issues = "https://github.com/fyipedia/nihonshufyi/issues"
+Changelog = "https://github.com/fyipedia/nihonshufyi/releases"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nihonshufyi"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
+ignore = ["RUF022"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+
+[dependency-groups]
+dev = [
+    "httpx>=0.27",
+    "mcp>=1.0",
+    "mypy>=1.19.1",
+    "pytest>=9.0.2",
+    "rich>=13.0",
+    "ruff>=0.15.4",
+    "typer>=0.15",
+]

nihonshufyi-0.1.0/skills/sake-tools/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: sake-tools
+description: Search sake grades, breweries, rice varieties, and yeast strains with polishing ratios and parallel fermentation science data.
+---
+
+# Sake Tools
+
+Sake search and reference powered by [nihonshufyi](https://nihonshufyi.com/) -- a comprehensive sake knowledge platform covering grades, breweries, rice varieties, and the unique heiko fukuhakko (parallel fermentation) process.
+
+## Setup
+
+Install the MCP server:
+
+```bash
+pip install "nihonshufyi[mcp]"
+```
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+    "mcpServers": {
+        "nihonshufyi": {
+            "command": "python",
+            "args": ["-m", "nihonshufyi.mcp_server"]
+        }
+    }
+}
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `sake_search` | Search sake grades, breweries, rice varieties, yeast strains, and terminology |
+
+## When to Use
+
+- Looking up sake grades and their polishing ratios (Junmai Daiginjo ≤50%, Ginjo ≤60%, etc.)
+- Researching sake rice varieties (Yamada Nishiki, Gohyakumangoku, Omachi, etc.)
+- Exploring regional brewery (kura) characteristics across Japan's 47 prefectures
+- Understanding fermentation science (koji, moromi, heiko fukuhakko)
+- Finding serving temperature recommendations (reishu, hiya, nurukan, atsukan)
+
+## Links
+
+- [Sake Grades](https://nihonshufyi.com/grades/)
+- [Breweries](https://nihonshufyi.com/breweries/)
+- [Rice Varieties](https://nihonshufyi.com/rice/)
+- [API Documentation](https://nihonshufyi.com/developers/)
+- [PyPI Package](https://pypi.org/project/nihonshufyi/)

nihonshufyi-0.1.0/src/nihonshufyi/__init__.py

@@ -0,0 +1,14 @@
+"""nihonshufyi — Sake knowledge API client for developers.
+
+Search sake grades, breweries, and terminology from NihonshuFYI.
+
+Usage::
+
+    from nihonshufyi.api import NihonshuFYI
+
+    with NihonshuFYI() as api:
+        results = api.search("junmai daiginjo")
+        print(results)
+"""
+
+__version__ = "0.1.0"

nihonshufyi-0.1.0/src/nihonshufyi/api.py

@@ -0,0 +1,64 @@
+"""HTTP API client for nihonshufyi.com REST endpoints.
+
+Requires the ``api`` extra: ``pip install nihonshufyi[api]``
+
+Usage::
+
+    from nihonshufyi.api import NihonshuFYI
+
+    with NihonshuFYI() as api:
+        results = api.search("junmai daiginjo")
+        print(results)
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+
+class NihonshuFYI:
+    """API client for the nihonshufyi.com REST API.
+
+    Args:
+        base_url: API base URL. Defaults to ``https://nihonshufyi.com``.
+        timeout: Request timeout in seconds. Defaults to ``10.0``.
+    """
+
+    def __init__(
+        self,
+        base_url: str = "https://nihonshufyi.com",
+        timeout: float = 10.0,
+    ) -> None:
+        self._client = httpx.Client(base_url=base_url, timeout=timeout)
+
+    # -- HTTP helpers ----------------------------------------------------------
+
+    def _get(self, path: str, **params: Any) -> dict[str, Any]:
+        resp = self._client.get(path, params={k: v for k, v in params.items() if v is not None})
+        resp.raise_for_status()
+        result: dict[str, Any] = resp.json()
+        return result
+
+    # -- Endpoints -------------------------------------------------------------
+
+    def search(self, query: str) -> dict[str, Any]:
+        """Search sakes, breweries, and glossary terms.
+
+        Args:
+            query: Search term (e.g. ``"junmai daiginjo"``, ``"niigata"``).
+        """
+        return self._get("/api/search/", q=query)
+
+    # -- Context manager -------------------------------------------------------
+
+    def close(self) -> None:
+        """Close the underlying HTTP connection."""
+        self._client.close()
+
+    def __enter__(self) -> NihonshuFYI:
+        return self
+
+    def __exit__(self, *_: object) -> None:
+        self.close()

nihonshufyi-0.1.0/src/nihonshufyi/cli.py

@@ -0,0 +1,54 @@
+"""Command-line interface for nihonshufyi.
+
+Requires the ``cli`` extra: ``pip install nihonshufyi[cli]``
+
+Usage::
+
+    nihonshufyi search "junmai daiginjo"
+"""
+
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+app = typer.Typer(
+    name="nihonshufyi",
+    help="Sake knowledge API client — search sake grades, breweries, and terms from NihonshuFYI.",
+    no_args_is_help=True,
+)
+console = Console()
+
+
+@app.command()
+def search(
+    query: str = typer.Argument(help="Search term (e.g. 'junmai daiginjo', 'niigata')"),
+) -> None:
+    """Search sakes, breweries, and glossary terms."""
+    from nihonshufyi.api import NihonshuFYI
+
+    with NihonshuFYI() as api:
+        results = api.search(query)
+
+    table = Table(title=f"Search: {query}")
+    table.add_column("Type", style="cyan", no_wrap=True)
+    table.add_column("Name")
+    table.add_column("Detail")
+
+    items = results.get("results", [])
+    if not items:
+        console.print(f"[yellow]No results found for '{query}'[/yellow]")
+        return
+
+    for item in items:
+        item_type = item.get("type", "unknown")
+        name = item.get("name", item.get("title", ""))
+        detail = item.get("description", item.get("slug", ""))
+        table.add_row(item_type, str(name), str(detail))
+
+    console.print(table)
+
+
+if __name__ == "__main__":
+    app()

nihonshufyi-0.1.0/src/nihonshufyi/mcp_server.py

@@ -0,0 +1,67 @@
+"""MCP server for nihonshufyi — sake knowledge tools for AI assistants.
+
+Requires the ``mcp`` extra: ``pip install nihonshufyi[mcp]``
+
+Run as a standalone server::
+
+    python -m nihonshufyi.mcp_server
+
+Or configure in ``claude_desktop_config.json``::
+
+    {
+        "mcpServers": {
+            "nihonshufyi": {
+                "command": "python",
+                "args": ["-m", "nihonshufyi.mcp_server"]
+            }
+        }
+    }
+"""
+
+from __future__ import annotations
+
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP("nihonshufyi")
+
+
+@mcp.tool()
+def sake_search(query: str) -> str:
+    """Search for sakes, breweries, and terminology on NihonshuFYI.
+
+    Search across sake grades (junmai, daiginjo, honjozo), breweries,
+    prefectures, rice varieties, yeast strains, serving temperatures,
+    and glossary terms.
+
+    Args:
+        query: Search term (e.g. "junmai daiginjo", "niigata", "yamada nishiki").
+    """
+    from nihonshufyi.api import NihonshuFYI
+
+    with NihonshuFYI() as api:
+        results = api.search(query)
+
+    items = results.get("results", [])
+    if not items:
+        return f"No results found for '{query}'."
+
+    lines = [
+        f"## Sake Search: {query}",
+        "",
+        f"Found {len(items)} result(s):",
+        "",
+        "| Type | Name | Detail |",
+        "|------|------|--------|",
+    ]
+
+    for item in items:
+        item_type = item.get("type", "unknown")
+        name = item.get("name", item.get("title", ""))
+        detail = item.get("description", item.get("slug", ""))
+        lines.append(f"| {item_type} | {name} | {detail} |")
+
+    return "\n".join(lines)
+
+
+if __name__ == "__main__":
+    mcp.run()

nihonshufyi-0.1.0/tests/test_api.py

@@ -0,0 +1,38 @@
+"""Tests for nihonshufyi.api — client initialization and URL construction."""
+
+from nihonshufyi.api import NihonshuFYI
+
+
+class TestNihonshuFYIInit:
+    def test_default_base_url(self) -> None:
+        client = NihonshuFYI()
+        assert str(client._client.base_url) == "https://nihonshufyi.com"
+        client.close()
+
+    def test_custom_base_url(self) -> None:
+        client = NihonshuFYI(base_url="https://example.com")
+        assert str(client._client.base_url) == "https://example.com"
+        client.close()
+
+    def test_default_timeout(self) -> None:
+        client = NihonshuFYI()
+        assert client._client.timeout.connect == 10.0
+        client.close()
+
+    def test_custom_timeout(self) -> None:
+        client = NihonshuFYI(timeout=30.0)
+        assert client._client.timeout.connect == 30.0
+        client.close()
+
+    def test_context_manager(self) -> None:
+        with NihonshuFYI() as api:
+            assert str(api._client.base_url) == "https://nihonshufyi.com"
+
+
+class TestURLConstruction:
+    def test_search_url(self) -> None:
+        client = NihonshuFYI()
+        request = client._client.build_request("GET", "/api/search/", params={"q": "junmai"})
+        assert "/api/search/" in str(request.url)
+        assert "q=junmai" in str(request.url)
+        client.close()