mirror of
https://github.com/tiennm99/serena.git
synced 2026-10-11 03:13:51 +00:00
Dominik Jain
6707cd9b7e
The repository is licensed per component. SolidLSP (src/solidlsp,
test/solidlsp, test/resources) remains MIT-licensed and independently
reusable; the Serena application (src/serena, src/interprompt, scripts,
test/serena, docs) is licensed under GPL-3.0-or-later starting with the v2
licensing transition. The change is not retroactive: all releases and
commits up to v1.7.0 / 74c38a65 (tag mit-final) remain available under MIT.
Since MIT is GPL-compatible, a distribution combining both (such as the
serena-agent package) is as a whole subject to GPL-3.0-or-later, while the
SolidLSP files themselves stay MIT and can be extracted and used separately
under MIT terms. The distribution metadata therefore declares
GPL-3.0-or-later, with both license texts shipped alongside it.
Serena originally began under the GPL (v2) and was switched to MIT in
May 2025 following community requests. We consider that change a mistake;
the substantial changes in v2 make this the appropriate time to revert it.
We want the best version of Serena to remain free.
Changes:
* LICENSE is now the licensing overview; canonical license texts live in
LICENSES/ (MIT.txt is the previous LICENSE verbatim, GPL-3.0-or-later.txt
is the unmodified FSF text)
* pyproject.toml declares the PEP 639 license expression
"GPL-3.0-or-later" and bundles LICENSE and LICENSES/* as license files;
the deprecated MIT classifier is dropped and flake.nix declares gpl3Plus;
README has per-component license badges and a License section
* SPDX-License-Identifier headers in all Python sources under src/ and
scripts/, added by the new idempotent scripts/add_spdx_headers.py, which
gen_prompt_factory.py also uses to keep the header on the generated
module; existing third-party notices are preserved
* CLA.md: Contributor License Agreement (contributor retains copyright;
grants a perpetual, irrevocable license including relicensing under any
terms, incl. proprietary/commercial; patent grant; authority
representations), to be enforced repository-wide via cla-assistant.io
* CONTRIBUTING.md, PR template and a new docs page explain the licensing
boundary and the CLA workflow
78 lines
2.6 KiB
Python
78 lines
2.6 KiB
Python
"""
|
|
Demonstrates FindImplementationsTool on the Go test repository.
|
|
"""
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
import json
|
|
from pathlib import Path
|
|
from pprint import pprint
|
|
|
|
from serena.agent import SerenaAgent
|
|
from serena.config.serena_config import LanguageBackend, ProjectConfig, RegisteredProject, SerenaConfig
|
|
from serena.constants import REPO_ROOT
|
|
from serena.project import Project
|
|
from serena.tools import FindImplementationsTool
|
|
from solidlsp.ls_config import LanguageServerId
|
|
|
|
SEPARATOR = "=" * 80
|
|
GO_TEST_REPO = Path(REPO_ROOT) / "test" / "resources" / "repos" / "go" / "test_repo"
|
|
|
|
|
|
def make_agent(project_root: Path, language: LanguageServerId, project_name: str) -> SerenaAgent:
|
|
"""Create an LSP-backed Serena agent for a single explicit project."""
|
|
serena_config = SerenaConfig.from_config_file()
|
|
serena_config.web_dashboard = False
|
|
serena_config.language_backend = LanguageBackend.LSP
|
|
|
|
project = Project(
|
|
project_root=str(project_root),
|
|
project_config=ProjectConfig(
|
|
project_name=project_name,
|
|
language_servers=[language],
|
|
ignored_paths=[],
|
|
excluded_tools=[],
|
|
read_only=False,
|
|
ignore_all_files_in_gitignore=True,
|
|
initial_prompt="",
|
|
encoding="utf-8",
|
|
),
|
|
serena_config=serena_config,
|
|
)
|
|
serena_config.projects = [RegisteredProject.from_project_instance(project)]
|
|
return SerenaAgent(project=project_name, serena_config=serena_config)
|
|
|
|
|
|
def print_section(title: str) -> None:
|
|
"""Print a visibly separated section header."""
|
|
print(f"\n{SEPARATOR}")
|
|
print(title)
|
|
print(SEPARATOR)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
agent = make_agent(GO_TEST_REPO, LanguageServerId.GO, "demo_go_test_repo")
|
|
|
|
try:
|
|
# letting the language server finish startup
|
|
agent.execute_task(lambda: None)
|
|
|
|
# running the implementation lookup
|
|
find_implementations_tool = agent.get_tool(FindImplementationsTool)
|
|
result = agent.execute_task(
|
|
lambda: find_implementations_tool.apply(
|
|
name_path="Greeter/FormatGreeting",
|
|
relative_path="main.go",
|
|
include_info=True,
|
|
)
|
|
)
|
|
|
|
print_section("Find Implementations Result")
|
|
implementations = json.loads(result)
|
|
pprint(implementations, width=200)
|
|
|
|
# validating the demonstrated result
|
|
assert any(implementation["name_path"] == "(ConsoleGreeter).FormatGreeting" for implementation in implementations), result
|
|
print("\nVerified implementation target: (ConsoleGreeter).FormatGreeting")
|
|
finally:
|
|
agent.shutdown()
|