Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/openpeeps/find

(WIP) Finds files and directories based on different criteria via an intuitive fluent interface
https://github.com/openpeeps/find

files filesystem find finder iterator nim nim-language openpeep

Last synced: 17 days ago
JSON representation

(WIP) Finds files and directories based on different criteria via an intuitive fluent interface

Awesome Lists containing this project

README

        




Finds files and directories based on different criteria
via an intuitive fluent interface. 👑 Written in Nim language


nimble install find


API reference


Github Actions Github Actions

## 😍 Key Features
- [x] Fluent Interface
- [x] `Driver` Local Filesystem
- [ ] `Driver` SSH via libssh
- [ ] `Driver` FTP/SFTP
- [ ] `Driver` WebDAV
- [x] Open Source | `MIT` License
- [x] Written in Nim language

## Examples

Get all `.txt` files from directory
```nim
let res: Results = finder("./examples").name("*.txt").get
```

Get all `.txt` files from directory using `size` criteria
```nim
let res = finder("./examples").name("*.txt").size(< 10.mb).get
for file in res.files():
echo file.getSize
```

Find files using regular expression
```nim
let res = finder("./examples").name(re"20[\w-]+\.txt").get
for file in res.files:
echo file.getName
```

For more examples check [/tests](https://github.com/openpeeps/find/tree/main/tests) | [API reference](https://openpeeps.github.io/find/)

### ❤ Contributions & Support
- 🐛 Found a bug? [Create a new Issue](https://github.com/openpeeps/find/issues)
- 👋 Wanna help? [Fork it!](https://github.com/openpeeps/find/fork)
- 😎 [Get €20 in cloud credits from Hetzner](https://hetzner.cloud/?ref=Hm0mYGM9NxZ4)
- 🥰 [Donate via PayPal address](https://www.paypal.com/donate/?hosted_button_id=RJK3ZTDWPL55C)

### 🎩 License
Find | MIT license. [Made by Humans from OpenPeeps](https://github.com/openpeep).

Copyright © 2023 OpenPeeps & Contributors — All rights reserved.