java-functional-lsp 0.1.0__tar.gz

java_functional_lsp-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default owners for all files
+* @aviadshiber

java_functional_lsp-0.1.0/.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,42 @@
+---
+name: Bug Report
+about: Report a bug in java-functional-lsp
+title: ""
+labels: bug
+assignees: ""
+---
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To reproduce
+
+Steps to reproduce the behavior:
+
+```bash
+# Example: what Java code triggers the issue?
+```
+
+## Expected behavior
+
+What you expected to happen.
+
+## Actual behavior
+
+What actually happened. Include the full diagnostic output if applicable:
+
+```
+<paste output here>
+```
+
+## Environment
+
+- **java-functional-lsp version**: (`pip show java-functional-lsp`)
+- **Python version**: (`python --version`)
+- **OS**: (e.g., macOS 14.2, Ubuntu 22.04)
+- **Editor/LSP client**: (e.g., Claude Code, VS Code)
+
+## Additional context
+
+Add any other context about the problem here.

java_functional_lsp-0.1.0/.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,31 @@
+---
+name: Feature Request
+about: Suggest a new rule or improvement
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+## Problem
+
+A clear description of the problem you're trying to solve. Example: "I want the linter to detect ..."
+
+## Proposed solution
+
+Describe the rule or improvement:
+
+```java
+// Example Java code that should be flagged
+```
+
+## Suggested diagnostic message
+
+What should the warning say?
+
+## Alternatives considered
+
+Any alternative solutions or features you've considered.
+
+## Additional context
+
+Add any other context, references to functional programming best practices, or examples here.

java_functional_lsp-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+## What
+
+Brief description of the change.
+
+## Why
+
+Why is this change needed? Link to any related issues.
+
+Closes #
+
+## Checklist
+
+- [ ] Tests added/updated
+- [ ] `uv run ruff check src/ tests/` passes
+- [ ] `uv run mypy src/` passes
+- [ ] `uv run pytest` passes
+- [ ] Documentation updated (if applicable)

java_functional_lsp-0.1.0/.github/SECURITY.md

@@ -0,0 +1,24 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in java-functional-lsp, please report it responsibly.
+
+**Email**: [aviadshiber@gmail.com](mailto:aviadshiber@gmail.com)
+
+Please include:
+- Description of the vulnerability
+- Steps to reproduce
+- Potential impact
+
+You will receive an acknowledgment within 48 hours and a detailed response within 7 days.
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| Latest  | Yes       |
+
+## Scope
+
+This policy covers the `java-functional-lsp` tool itself.

java_functional_lsp-0.1.0/.github/dependabot.yml

@@ -0,0 +1,21 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "deps"
+    labels:
+      - "dependencies"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "ci"
+    labels:
+      - "ci"
+    open-pull-requests-limit: 5

java_functional_lsp-0.1.0/.github/release-drafter.yml

@@ -0,0 +1,28 @@
+name-template: "v$RESOLVED_VERSION"
+tag-template: "v$RESOLVED_VERSION"
+categories:
+  - title: "New Rules"
+    labels: ["rule", "enhancement", "feature"]
+  - title: "Bug Fixes"
+    labels: ["bug", "fix"]
+  - title: "Dependencies"
+    labels: ["dependencies"]
+  - title: "Documentation"
+    labels: ["documentation"]
+  - title: "CI/CD"
+    labels: ["ci"]
+  - title: "Other Changes"
+    labels: ["*"]
+change-template: "- $TITLE @$AUTHOR (#$NUMBER)"
+version-resolver:
+  major:
+    labels: ["breaking"]
+  minor:
+    labels: ["enhancement", "feature", "rule"]
+  patch:
+    labels: ["bug", "fix", "dependencies"]
+  default: patch
+template: |
+  ## Changes
+  $CHANGES
+  **Full Changelog**: https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION

java_functional_lsp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,26 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - name: Install build dependencies
+        run: pip install build
+      - name: Build package
+        run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

java_functional_lsp-0.1.0/.github/workflows/release-drafter.yml

@@ -0,0 +1,19 @@
+name: Release Drafter
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    types: [opened, reopened, synchronize]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  update-release-draft:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: release-drafter/release-drafter@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

java_functional_lsp-0.1.0/.github/workflows/stale.yml

@@ -0,0 +1,31 @@
+name: Stale Issues
+
+on:
+  schedule:
+    - cron: "0 6 * * 1"
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v10
+        with:
+          stale-issue-message: >
+            This issue has been automatically marked as stale because it has not
+            had recent activity. It will be closed in 14 days if no further
+            activity occurs. If this issue is still relevant, please comment
+            to keep it open.
+          stale-pr-message: >
+            This PR has been automatically marked as stale because it has not
+            had recent activity. It will be closed in 14 days if no further
+            activity occurs.
+          days-before-stale: 60
+          days-before-close: 14
+          stale-issue-label: "stale"
+          stale-pr-label: "stale"
+          exempt-issue-labels: "pinned,security"
+          exempt-pr-labels: "pinned"

java_functional_lsp-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,36 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Install dependencies
+        run: uv sync
+      - name: Lint
+        run: uv run ruff check src/ tests/
+      - name: Format check
+        run: uv run ruff format --check src/ tests/
+      - name: Type check
+        run: uv run mypy src/
+      - name: Test
+        run: uv run pytest -q
+        env:
+          NO_COLOR: "1"

java_functional_lsp-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+.uv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+htmlcov/
+.coverage
+*.egg
+*.zip
+# Claude Code
+.claude/

java_functional_lsp-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing to java-functional-lsp
+
+## Prerequisites
+
+- Python 3.10+
+- [uv](https://docs.astral.sh/uv/) (recommended) or pip
+
+## Setup
+
+```bash
+git clone https://github.com/aviadshiber/java-functional-lsp.git
+cd java-functional-lsp
+uv sync
+```
+
+## Making Changes
+
+1. Branch from `main` with a descriptive name (e.g., `feat/new-rule`, `fix/false-positive`)
+2. Follow existing code patterns in `src/java_functional_lsp/analyzers/`
+3. Add tests for new rules or behavior changes
+4. Ensure all checks pass before submitting
+
+## Pull Request Guidelines
+
+- Keep PRs focused — one rule or one fix per PR
+- Write a clear description of what and why
+- All CI checks must pass
+- Maintainer review is required
+
+## Code Style
+
+- **Ruff** for linting and formatting (line length: 120)
+- **mypy** in strict mode for type checking
+- **pytest** for tests with coverage reporting
+
+```bash
+uv run ruff check src/ tests/
+uv run ruff format src/ tests/
+uv run mypy src/
+uv run pytest
+```
+
+## Adding a New Rule
+
+1. Choose the appropriate analyzer in `src/java_functional_lsp/analyzers/`
+2. Add the detection logic using tree-sitter node walking (see `base.py` helpers)
+3. Add the rule ID and message to the module's `_MESSAGES` dict
+4. Add tests in `tests/test_<analyzer>.py`
+5. Update the rules table in `README.md`
+
+## Reporting Issues
+
+- Use the [bug report template](https://github.com/aviadshiber/java-functional-lsp/issues/new?template=bug-report.md)
+- Use the [feature request template](https://github.com/aviadshiber/java-functional-lsp/issues/new?template=feature-request.md)
+- For security issues, see [SECURITY.md](.github/SECURITY.md)

java_functional_lsp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aviad S.
+
+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.

java_functional_lsp-0.1.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: java-functional-lsp
+Version: 0.1.0
+Summary: Java LSP server enforcing functional programming best practices — null safety, immutability, no exceptions
+Project-URL: Homepage, https://github.com/aviadshiber/java-functional-lsp
+Project-URL: Repository, https://github.com/aviadshiber/java-functional-lsp
+Project-URL: Bug Tracker, https://github.com/aviadshiber/java-functional-lsp/issues
+Project-URL: Changelog, https://github.com/aviadshiber/java-functional-lsp/releases
+Author: Aviad S.
+License: MIT
+License-File: LICENSE
+Keywords: functional-programming,java,linter,lombok,lsp,tree-sitter,vavr
+Classifier: Development Status :: 3 - Alpha
+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: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Requires-Dist: pygls>=1.3.0
+Requires-Dist: tree-sitter-java>=0.23.0
+Requires-Dist: tree-sitter>=0.23.0
+Description-Content-Type: text/markdown
+
+# java-functional-lsp
+
+[![CI](https://github.com/aviadshiber/java-functional-lsp/actions/workflows/test.yml/badge.svg)](https://github.com/aviadshiber/java-functional-lsp/actions/workflows/test.yml)
+[![PyPI version](https://img.shields.io/pypi/v/java-functional-lsp)](https://pypi.org/project/java-functional-lsp/)
+[![Python](https://img.shields.io/pypi/pyversions/java-functional-lsp)](https://pypi.org/project/java-functional-lsp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A Java Language Server that enforces functional programming best practices. Designed for teams using **Vavr**, **Lombok**, and **Spring** with a functional-first approach.
+
+## What it checks
+
+| Rule | Detects | Suggests |
+|------|---------|----------|
+| `null-literal-arg` | `null` passed as method argument | `Option.none()` or default value |
+| `null-return` | `return null` | `Option.of()`, `Option.none()`, or `Either` |
+| `null-assignment` | `Type x = null` | `Option<Type>` |
+| `null-field-assignment` | Field initialized to `null` | `Option<T>` with `Option.none()` |
+| `throw-statement` | `throw new XxxException(...)` | `Either.left()` or `Try.of()` |
+| `catch-rethrow` | catch block that wraps + rethrows | `Try.of().toEither()` |
+| `mutable-variable` | Local variable reassignment | Final variables + functional transforms |
+| `imperative-loop` | `for`/`while` loops | `.map()`/`.filter()`/`.flatMap()`/`.foldLeft()` |
+| `mutable-dto` | `@Data` or `@Setter` on class | `@Value` (immutable) |
+| `imperative-option-unwrap` | `if (opt.isDefined()) { opt.get() }` | `map()`/`flatMap()`/`fold()` |
+| `field-injection` | `@Autowired` on field | Constructor injection |
+| `component-annotation` | `@Component`/`@Service`/`@Repository` | `@Configuration` + `@Bean` |
+
+## Install
+
+```bash
+pip install java-functional-lsp
+```
+
+Or from source:
+
+```bash
+pip install git+https://github.com/aviadshiber/java-functional-lsp.git
+```
+
+## Usage with Claude Code
+
+Install the `deeperdive-java-linter` plugin from the DeeperDive marketplace, which registers this server as a Java LSP.
+
+Or manually add to your Claude Code config:
+
+```json
+{
+  "lspServers": {
+    "java-functional": {
+      "command": "java-functional-lsp",
+      "extensionToLanguage": { ".java": "java" }
+    }
+  }
+}
+```
+
+## Configuration
+
+Create `.deeperdive-linter.json` in your project root to customize rules:
+
+```json
+{
+  "rules": {
+    "null-literal-arg": "warning",
+    "throw-statement": "info",
+    "imperative-loop": "hint",
+    "mutable-dto": "off"
+  }
+}
+```
+
+Severity levels: `error`, `warning`, `info`, `hint`, `off`.
+All rules default to `warning` when not configured.
+
+## How it works
+
+Uses [tree-sitter](https://tree-sitter.github.io/) with the Java grammar for fast, incremental AST parsing. No Java compiler or classpath needed — analysis runs on raw source files.
+
+The server speaks the Language Server Protocol (LSP) via stdio, making it compatible with any LSP client.
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/aviadshiber/java-functional-lsp.git
+cd java-functional-lsp
+uv sync
+
+# Run checks
+uv run ruff check src/ tests/
+uv run ruff format --check src/ tests/
+uv run mypy src/
+uv run pytest
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
+
+## License
+
+MIT

java_functional_lsp-0.1.0/README.md

@@ -0,0 +1,99 @@
+# java-functional-lsp
+
+[![CI](https://github.com/aviadshiber/java-functional-lsp/actions/workflows/test.yml/badge.svg)](https://github.com/aviadshiber/java-functional-lsp/actions/workflows/test.yml)
+[![PyPI version](https://img.shields.io/pypi/v/java-functional-lsp)](https://pypi.org/project/java-functional-lsp/)
+[![Python](https://img.shields.io/pypi/pyversions/java-functional-lsp)](https://pypi.org/project/java-functional-lsp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A Java Language Server that enforces functional programming best practices. Designed for teams using **Vavr**, **Lombok**, and **Spring** with a functional-first approach.
+
+## What it checks
+
+| Rule | Detects | Suggests |
+|------|---------|----------|
+| `null-literal-arg` | `null` passed as method argument | `Option.none()` or default value |
+| `null-return` | `return null` | `Option.of()`, `Option.none()`, or `Either` |
+| `null-assignment` | `Type x = null` | `Option<Type>` |
+| `null-field-assignment` | Field initialized to `null` | `Option<T>` with `Option.none()` |
+| `throw-statement` | `throw new XxxException(...)` | `Either.left()` or `Try.of()` |
+| `catch-rethrow` | catch block that wraps + rethrows | `Try.of().toEither()` |
+| `mutable-variable` | Local variable reassignment | Final variables + functional transforms |
+| `imperative-loop` | `for`/`while` loops | `.map()`/`.filter()`/`.flatMap()`/`.foldLeft()` |
+| `mutable-dto` | `@Data` or `@Setter` on class | `@Value` (immutable) |
+| `imperative-option-unwrap` | `if (opt.isDefined()) { opt.get() }` | `map()`/`flatMap()`/`fold()` |
+| `field-injection` | `@Autowired` on field | Constructor injection |
+| `component-annotation` | `@Component`/`@Service`/`@Repository` | `@Configuration` + `@Bean` |
+
+## Install
+
+```bash
+pip install java-functional-lsp
+```
+
+Or from source:
+
+```bash
+pip install git+https://github.com/aviadshiber/java-functional-lsp.git
+```
+
+## Usage with Claude Code
+
+Install the `deeperdive-java-linter` plugin from the DeeperDive marketplace, which registers this server as a Java LSP.
+
+Or manually add to your Claude Code config:
+
+```json
+{
+  "lspServers": {
+    "java-functional": {
+      "command": "java-functional-lsp",
+      "extensionToLanguage": { ".java": "java" }
+    }
+  }
+}
+```
+
+## Configuration
+
+Create `.deeperdive-linter.json` in your project root to customize rules:
+
+```json
+{
+  "rules": {
+    "null-literal-arg": "warning",
+    "throw-statement": "info",
+    "imperative-loop": "hint",
+    "mutable-dto": "off"
+  }
+}
+```
+
+Severity levels: `error`, `warning`, `info`, `hint`, `off`.
+All rules default to `warning` when not configured.
+
+## How it works
+
+Uses [tree-sitter](https://tree-sitter.github.io/) with the Java grammar for fast, incremental AST parsing. No Java compiler or classpath needed — analysis runs on raw source files.
+
+The server speaks the Language Server Protocol (LSP) via stdio, making it compatible with any LSP client.
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/aviadshiber/java-functional-lsp.git
+cd java-functional-lsp
+uv sync
+
+# Run checks
+uv run ruff check src/ tests/
+uv run ruff format --check src/ tests/
+uv run mypy src/
+uv run pytest
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
+
+## License
+
+MIT