Metadata-Version: 2.4
Name: mp_locate
Version: 0.1.3
Summary: A utility to recursively locate files by name.
Author: Eduardo Moreno Neto
Author-email: eduardo.mmorenoneto@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# mp_locate

**mp_locate** is a simple Python library for finding files by name recursively from a base directory.

## ✨ Features
- Recursive file search
- Configurable base path (or use the current directory)
- Support for returning single or multiple found files

## ⚡ Installation
```bash
pip install mp_locate
```

Or install locally:
```bash
pip install -e .
```

## 📄 Usage example
```python
from mp_locate import find_file

# Find the first file with the specified name
path = find_file("data.csv")

# Return all found paths
all = find_file("data.csv", return_all=True)
```

## ✉ License
MIT. See the `LICENSE` file for more details.

# mp_locate Portuguese

**mp_locate** é uma biblioteca Python simples para localizar arquivos por nome de forma recursiva a partir de um diretório base.

## ✨ Características
- Busca recursiva por arquivos
- Caminho base configurável (ou usa o diretório atual)
- Suporte a retorno único ou múltiplos arquivos encontrados

## ⚡ Instalação
```bash
pip install mp_locate
```

Ou instale localmente:
```bash
pip install -e .
```

## 📄 Exemplo de uso
```python
from mp_locate import find_file

# Localizar o primeiro arquivo com nome especificado
caminho = find_file("dados.csv")

# Retornar todos os caminhos encontrados
todos = find_file("dados.csv", retornar_todos=True)
```

## ✉ Licença
MIT. Veja o arquivo `LICENSE` para mais detalhes.
