linkinpycli 0.0.1__tar.gz

linkinpycli-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.11.7"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Test
+        run: uv run pytest
+
+      - name: Build
+        run: uv run python -m build
+

linkinpycli-0.0.1/.gitignore

@@ -0,0 +1,181 @@
+.gitignore
+plan.md
+.DS_Store
+uv.lock
+# Ignore itself
+.gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packagin
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# PyPI configuration file
+.pypirc
+.gptignore
+.editorconfig
+.python-version

linkinpycli-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-merge-conflict
+      - id: check-case-conflict
+      - id: detect-private-key
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.8
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

linkinpycli-0.0.1/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [v0.0.1] - Date
+
+### Fixed
+
+
+### Added
+
+
+### Changed
+

linkinpycli-0.0.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,65 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our community include:
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others’ private information, such as a physical or email address, without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [contact email]. All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+**Community Impact**: A violation through a single incident or series of actions.
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
+**Consequence**: A permanent ban from any sort of public interaction within the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html)
+
+For answers to common questions about this code of conduct, see [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq).

linkinpycli-0.0.1/CONTRIBUTING.md

@@ -0,0 +1,79 @@
+# Contributing to linkinpycli
+
+Thanks for contributing. This guide keeps the local workflow simple and consistent.
+
+## Development Setup
+
+Clone the repository and enter it:
+
+```bash
+git clone https://github.com/YOUR_USERNAME/LinkinPyCLI.git
+cd LinkinPyCLI
+```
+
+Create the development environment:
+
+```bash
+uv sync
+uv run pre-commit install
+```
+
+## Daily Workflow
+
+Create a branch for your work:
+
+```bash
+git checkout -b feature/short-description
+```
+
+Run the main local checks before opening a pull request:
+
+```bash
+uv run pytest
+uv run ruff check .
+uv run ruff format .
+uv run python -m build
+```
+
+Or use the shorter `make` targets:
+
+```bash
+make test
+make lint
+make format
+make build
+```
+
+## Command Reference
+
+- `uv sync`: create or update the local environment from `pyproject.toml`
+- `uv run pytest`: run the test suite
+- `uv run ruff check .`: run lint checks
+- `uv run ruff format .`: format the codebase
+- `uv run python -m build`: verify the package builds correctly
+
+The repository also includes a `.python-version` file so local development and CI agree on the interpreter target.
+
+## Pull Requests
+
+Before opening a pull request, please make sure:
+
+- tests pass locally
+- linting and formatting are clean
+- the package builds successfully
+- docs are updated if the workflow or public API changed
+- notable changes are reflected in `CHANGELOG.md`
+
+## Code Style
+
+This project keeps the toolchain intentionally small:
+
+- Ruff for linting and formatting
+- Pytest for tests
+- pre-commit for git hook integration
+
+Prefer small, focused changes with clear commit messages and matching tests when behavior changes.
+
+## Getting Help
+
+Open an issue for bugs or feature requests, or contact the maintainers at bruno.msaraiva2@gmail.com if you need help.

linkinpycli-0.0.1/GETTING_STARTED.md

@@ -0,0 +1,74 @@
+# Getting Started
+
+This project uses `uv` to manage the local development environment.
+
+The `.python-version` file pins the interpreter version expected for local development and CI.
+
+## 1. Create the environment
+
+```bash
+uv sync
+```
+
+What it does:
+
+- creates a virtual environment if needed
+- installs the project in editable mode
+- installs the default development and test dependency groups
+
+## 2. Install git hooks
+
+```bash
+uv run pre-commit install
+```
+
+What it does:
+
+- enables local checks before each commit
+- runs formatting and lightweight validation automatically
+
+## 3. Run the tests
+
+```bash
+uv run pytest
+```
+
+What it does:
+
+- runs the test suite from `tests/`
+- confirms the package imports correctly from the `src/` layout
+
+## 4. Run linting and formatting
+
+```bash
+uv run ruff check .
+uv run ruff format .
+```
+
+What they do:
+
+- `ruff check .` finds lint issues
+- `ruff format .` applies consistent formatting
+
+## 5. Build the package
+
+```bash
+uv run python -m build
+```
+
+What it does:
+
+- creates distribution artifacts in `dist/`
+- verifies the package metadata and build configuration are valid
+
+## Optional Make Targets
+
+If you like `make`, these commands wrap the same workflow:
+
+```bash
+make sync
+make test
+make lint
+make format
+make build
+```

linkinpycli-0.0.1/LICENSE.txt

@@ -0,0 +1,22 @@
+
+The MIT License (MIT)
+
+Copyright (c) 2026 linkinpycli
+
+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.

linkinpycli-0.0.1/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: linkinpycli
+Version: 0.0.1
+Summary: CLI finder for LinkinPy integration
+Project-URL: Homepage, https://github.com/HenriquesLab/LinkinPy
+Project-URL: Repository, https://github.com/HenriquesLab/LinkinPy
+Project-URL: Issues, https://github.com/HenriquesLab/LinkinPy/issues
+Project-URL: Changelog, https://github.com/HenriquesLab/LinkinPy/blob/main/CHANGELOG.md
+Author-email: brunomsaraiva <bruno.msaraiva2@gmail.com>
+License-Expression: MIT
+License-File: LICENSE.txt
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# linkinpycli
+
+CLI finder for LinkinPy integration
+
+## Quick Start
+
+```bash
+uv sync
+uv run pytest
+```
+
+The project pins its local development interpreter in `.python-version` and keeps package metadata in `pyproject.toml`.
+
+## Common Commands
+
+```bash
+uv sync                  # create/update the local environment
+uv run pytest            # run the test suite
+uv run ruff check .      # lint the codebase
+uv run ruff format .     # format the codebase
+uv run python -m build   # build the source and wheel distributions
+uv run pre-commit install
+```
+
+If you prefer shorter aliases, the same workflow is available through `make`:
+
+```bash
+make sync
+make test
+make lint
+make format
+make build
+```
+
+## Project Layout
+
+```text
+src/linkinpycli/
+tests/
+pyproject.toml
+.python-version
+GETTING_STARTED.md
+CONTRIBUTING.md
+```
+
+## Documentation
+
+- Start with [GETTING_STARTED.md](GETTING_STARTED.md) for first-time setup
+- See [CONTRIBUTING.md](CONTRIBUTING.md) for the contributor workflow
+- Track user-facing changes in [CHANGELOG.md](CHANGELOG.md)

linkinpycli-0.0.1/README.md

@@ -0,0 +1,50 @@
+# linkinpycli
+
+CLI finder for LinkinPy integration
+
+## Quick Start
+
+```bash
+uv sync
+uv run pytest
+```
+
+The project pins its local development interpreter in `.python-version` and keeps package metadata in `pyproject.toml`.
+
+## Common Commands
+
+```bash
+uv sync                  # create/update the local environment
+uv run pytest            # run the test suite
+uv run ruff check .      # lint the codebase
+uv run ruff format .     # format the codebase
+uv run python -m build   # build the source and wheel distributions
+uv run pre-commit install
+```
+
+If you prefer shorter aliases, the same workflow is available through `make`:
+
+```bash
+make sync
+make test
+make lint
+make format
+make build
+```
+
+## Project Layout
+
+```text
+src/linkinpycli/
+tests/
+pyproject.toml
+.python-version
+GETTING_STARTED.md
+CONTRIBUTING.md
+```
+
+## Documentation
+
+- Start with [GETTING_STARTED.md](GETTING_STARTED.md) for first-time setup
+- See [CONTRIBUTING.md](CONTRIBUTING.md) for the contributor workflow
+- Track user-facing changes in [CHANGELOG.md](CHANGELOG.md)

linkinpycli-0.0.1/makefile

@@ -0,0 +1,41 @@
+.PHONY: help sync sync-dev test lint format check build docs
+
+help:
+	@echo "Available commands:"
+	@echo "  sync      Create/update the local environment with uv"
+	@echo "  sync-dev  Alias for sync"
+	@echo "  test      Run the test suite"
+	@echo "  lint      Run Ruff lint checks"
+	@echo "  format    Format the codebase with Ruff"
+	@echo "  check     Run lint, tests, and build"
+	@echo "  build     Build source and wheel distributions"
+	@echo "  docs      Generate API docs with pdoc"
+
+sync:
+	uv sync
+
+sync-dev:
+	uv sync
+
+test:
+	uv run pytest
+
+lint:
+	uv run ruff check .
+
+format:
+	uv run ruff format .
+
+check:
+	uv run ruff check .
+	uv run pytest
+	uv run python -m build
+
+build:
+	uv run python -m build
+
+docs:
+	rm -rf docs
+	uv run pdoc src/linkinpycli -o docs
+
+.DEFAULT_GOAL := help

linkinpycli-0.0.1/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling>=1.26.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "linkinpycli"
+version = "0.0.1"
+description = "CLI finder for LinkinPy integration"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE*"]
+authors = [
+    { name = "brunomsaraiva", email = "bruno.msaraiva2@gmail.com" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Operating System :: OS Independent",
+]
+dependencies = []
+
+[project.scripts]
+linkinpy-parse = "linkinpycli.linkinpycli:parse_linkinpy_scripts"
+
+[project.urls]
+Homepage = "https://github.com/HenriquesLab/LinkinPy"
+Repository = "https://github.com/HenriquesLab/LinkinPy"
+Issues = "https://github.com/HenriquesLab/LinkinPy/issues"
+Changelog = "https://github.com/HenriquesLab/LinkinPy/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "build>=1.2.2",
+    "pdoc>=15.0.0",
+    "pre-commit>=4.2.0",
+    "ruff>=0.11.0",
+]
+test = [
+    "pytest>=8.3.0",
+    "pytest-cov>=6.0.0",
+    "pytest-xdist>=3.6.1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/linkinpycli"]
+
+[tool.pytest.ini_options]
+addopts = "-ra"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["linkinpycli"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true
+
+[tool.uv]
+default-groups = ["dev", "test"]

linkinpycli-0.0.1/ruff.toml

@@ -0,0 +1,47 @@
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".ipynb_checkpoints",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pyenv",
+    ".pytest_cache",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    ".vscode",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "site-packages",
+    "venv",
+]
+line-length = 88
+indent-width = 4
+target-version = "py310"
+
+[lint]
+fixable = ["ALL"]
+unfixable = []
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+docstring-code-format = true
+docstring-code-line-length = "dynamic"
+
+[lint.pydocstyle]
+convention = "google"

linkinpycli-0.0.1/scripts.json

@@ -0,0 +1,83 @@
+{
+  "scripts": [
+    {
+      "name": "linkinpy-esrrf",
+      "entry_point": "linkinpynanopyx.linkinpy_nanopyx:cli",
+      "arguments": [
+        {
+          "name": "first",
+          "datatype": "str | Path",
+          "required": true,
+          "default": null
+        },
+        {
+          "name": "second",
+          "datatype": "str | Path",
+          "required": true,
+          "default": null
+        },
+        {
+          "name": "magnification",
+          "datatype": "int",
+          "required": false,
+          "default": 5
+        },
+        {
+          "name": "radius",
+          "datatype": "float",
+          "required": false,
+          "default": 1.5
+        },
+        {
+          "name": "sensitivity",
+          "datatype": "float",
+          "required": false,
+          "default": 1.0
+        },
+        {
+          "name": "frames_per_timepoint",
+          "datatype": "int",
+          "required": false,
+          "default": 0
+        },
+        {
+          "name": "temporal_correlation",
+          "datatype": "str",
+          "required": false,
+          "default": "AVG"
+        },
+        {
+          "name": "use_fht",
+          "datatype": "bool",
+          "required": false,
+          "default": false
+        },
+        {
+          "name": "doIntensityWeighting",
+          "datatype": "bool",
+          "required": false,
+          "default": true
+        },
+        {
+          "name": "macro_pixel_correction",
+          "datatype": "bool",
+          "required": false,
+          "default": true
+        },
+        {
+          "name": "pad_edges",
+          "datatype": "bool",
+          "required": false,
+          "default": false
+        },
+        {
+          "name": "_force_run_type",
+          "datatype": "str | None",
+          "required": false,
+          "default": null
+        }
+      ],
+      "callable": "linkinpynanopyx.linkinpy_nanopyx:linkinpy_esrrf"
+    }
+  ]
+}

linkinpycli-0.0.1/src/linkinpycli/crawler.py

@@ -0,0 +1,18 @@
+from importlib.metadata import EntryPoint, entry_points
+
+LINKINPY_SCRIPT_PREFIX = "linkinpy"
+
+
+def find_linkinpy_entry_points() -> list[EntryPoint]:
+    """Find all console-script entry points that start with 'linkinpy'."""
+    return [
+        ep
+        for ep in entry_points(group="console_scripts")
+        if ep.name.startswith(LINKINPY_SCRIPT_PREFIX)
+        and ep.name != "linkinpy-parse"
+    ]
+
+
+def find_linkinpy_scripts() -> list[str]:
+    """Find all console scripts that start with 'linkinpy'."""
+    return [ep.name for ep in find_linkinpy_entry_points()]

linkinpycli-0.0.1/src/linkinpycli/linkinpycli.py

@@ -0,0 +1,117 @@
+from __future__ import annotations
+
+import inspect
+import json
+from importlib import import_module
+from importlib.metadata import EntryPoint
+from pathlib import Path
+
+from .crawler import find_linkinpy_entry_points
+
+
+_IGNORED_SIGNATURE_PARAMETERS = {"argv", "args", "kwargs"}
+
+
+def _format_datatype(annotation: object) -> str:
+    if annotation is inspect.Signature.empty:
+        return "Any"
+    if isinstance(annotation, str):
+        return annotation.replace("pathlib.", "")
+    if getattr(annotation, "__module__", "") == "builtins":
+        return annotation.__name__
+    return str(annotation).replace("pathlib.", "")
+
+
+def _format_default(default: object) -> object:
+    if default is inspect.Signature.empty:
+        return None
+    if isinstance(default, (str, int, float, bool)) or default is None:
+        return default
+    return repr(default)
+
+
+def _signature_arguments(callable_object: object) -> list[dict[str, object]]:
+    signature = inspect.signature(callable_object)
+    arguments = []
+    for name, parameter in signature.parameters.items():
+        if name in _IGNORED_SIGNATURE_PARAMETERS:
+            continue
+        if parameter.kind in (
+            inspect.Parameter.VAR_POSITIONAL,
+            inspect.Parameter.VAR_KEYWORD,
+        ):
+            continue
+        arguments.append(
+            {
+                "name": name,
+                "datatype": _format_datatype(parameter.annotation),
+                "required": parameter.default is inspect.Signature.empty,
+                "default": _format_default(parameter.default),
+            }
+        )
+    return arguments
+
+
+def _entry_point_reference(entry_point: EntryPoint) -> str:
+    return f"{entry_point.module}:{entry_point.attr}"
+
+
+def _resolve_callable(entry_point: EntryPoint) -> object:
+    module = import_module(entry_point.module)
+    entry_callable = entry_point.load()
+    entry_arguments = _signature_arguments(entry_callable)
+    if entry_arguments:
+        return entry_callable
+
+    expected_name = entry_point.name.replace("-", "_")
+    expected_callable = getattr(module, expected_name, None)
+    if callable(expected_callable):
+        return expected_callable
+
+    linkinpy_callables = [
+        obj
+        for name, obj in inspect.getmembers(module, inspect.isfunction)
+        if name.startswith("linkinpy") and name not in {"linkinpy_parse"}
+    ]
+    if len(linkinpy_callables) == 1:
+        return linkinpy_callables[0]
+
+    return entry_callable
+
+
+def _script_details(entry_point: EntryPoint) -> dict[str, object]:
+    details: dict[str, object] = {
+        "name": entry_point.name,
+        "entry_point": _entry_point_reference(entry_point),
+        "arguments": [],
+    }
+    try:
+        callable_object = _resolve_callable(entry_point)
+        details["callable"] = (
+            f"{callable_object.__module__}:{callable_object.__name__}"
+        )
+        details["arguments"] = _signature_arguments(callable_object)
+    except Exception as exc:
+        details["error"] = str(exc)
+    return details
+
+
+def parse_linkinpy_scripts() -> None:
+    """Find LinkinPy console scripts and write their argument metadata to scripts.json."""
+    scripts = [
+        _script_details(entry_point)
+        for entry_point in find_linkinpy_entry_points()
+    ]
+    output_path = Path.cwd() / "scripts.json"
+    output_path.write_text(
+        json.dumps({"scripts": scripts}, indent=2) + "\n",
+        encoding="utf-8",
+    )
+    print(f"Saved {len(scripts)} scripts to {output_path}")
+
+
+class LinkinPyCLI:
+    """Minimal example class generated by the template."""
+
+    def run(self) -> int:
+        return 1

linkinpycli-0.0.1/t.py

@@ -0,0 +1,18 @@
+from importlib.metadata import entry_points
+
+prefix = "linkinpy"
+
+matches = []
+
+for ep in entry_points(group="console_scripts"):
+    if ep.name.startswith(prefix):
+        matches.append(
+            {
+                "script": ep.name,
+                "function": f"{ep.module}:{ep.attr}",
+                "callable": ep.load(),
+            }
+        )
+
+for m in matches:
+    print(m["script"], "->", m["function"])

linkinpycli-0.0.1/tests/test_LinkinPyCLI.py

@@ -0,0 +1,6 @@
+from linkinpycli.linkinpycli import LinkinPyCLI
+
+def test_LinkinPyCLI() -> None:
+    my_class = LinkinPyCLI()
+    example_output = my_class.run()
+    assert example_output == 1