semvec/pypi-packages huggingface dataset:
code-navigation-python 0.0.3
A python package written in rust for code navigation features like text search, fuzzy search and go to definition/references
License: Apache
Requires Python: >=3.8

```markdown
# Code Navigation Python Package

This Python package provides functionality for indexing and searching code repositories using Rust and PyO3. The package supports text search, fuzzy search, and retrieving token information and hoverable ranges from the code.

## Installation

To install the package, use the following command:

```sh
pip install code_navigation_python
```

## Usage

### Import the Package

```python
import code_navigation_python
```

### Functions

#### `go_to`

Retrieves token information for a given position in a file.

##### Parameters
- `root_path_str` (str): The root path of the repository.
- `index_path_str` (str): The path where the index is stored.
- `relative_path` (str): The relative path of the file.
- `line` (int): The line number.
- `start_index` (int): The start index in the line.
- `end_index` (int): The end index in the line.

##### Returns
- `str`: Token information.

##### Example

```python
result = code_navigation_python.go_to("/path/to/repo", "/path/to/index", "src/main.rs", 10, 0, 5)
print(result)
```

#### `text_search`

Performs a text search in the code repository.

##### Parameters
- `root_path_str` (str): The root path of the repository.
- `index_path_str` (str): The path where the index is stored.
- `query` (str): The search query.
- `case_sensitive` (bool): Whether the search should be case sensitive.

##### Returns
- `str`: Search results.

##### Example

```python
result = code_navigation_python.text_search("/path/to/repo", "/path/to/index", "search term", True)
print(result)
```

#### `get_hoverable_ranges`

Retrieves the hoverable ranges for a given file.

##### Parameters
- `root_path_str` (str): The root path of the repository.
- `index_path_str` (str): The path where the index is stored.
- `relative_path` (str): The relative path of the file.

##### Returns
- `str`: Hoverable ranges in JSON format.

##### Example

```python
result = code_navigation_python.get_hoverable_ranges("/path/to/repo", "/path/to/index", "src/main.rs")
print(result)
```

## License

This project is licensed under the Apache License.
```