https://github.com/saravanabalagi/filenumutils
Python tools for finding last file or folder number in a directory based on extension, prefix or suffix.
https://github.com/saravanabalagi/filenumutils
file-numbers file-pattern folder-management folder-pattern last-file-number
Last synced: about 1 month ago
JSON representation
Python tools for finding last file or folder number in a directory based on extension, prefix or suffix.
- Host: GitHub
- URL: https://github.com/saravanabalagi/filenumutils
- Owner: saravanabalagi
- License: mit
- Created: 2019-11-21T17:35:09.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-08T02:58:04.000Z (over 2 years ago)
- Last Synced: 2025-04-21T23:24:43.194Z (2 months ago)
- Topics: file-numbers, file-pattern, folder-management, folder-pattern, last-file-number
- Language: Python
- Homepage: https://pypi.org/project/filenumutils
- Size: 44.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# filenumutils
Python tools to find last file/folder number in a int indexed file/folder with specified extension, prefix and/or suffix. Also allows to get/create next folder, e.g if dir contains `train_00` and `train_01`, it creates `train_02`.
## Installation
Simply install using `pip`
```sh
pip install filenumutils
```
## Usage
Assuming the current working directory has the following structure
```
current_dir
├─ train_00
├─ train_01
├─ train_03
├─ train_04
├─ model_00.py
├─ model_01.py
└─ model_02.py
```
### Get Last Folder / File Number
```python
from filenumutils import get_last_folder_number, get_last_file_number
get_last_folder_number(prefix="model_") # Output: 4
get_last_file_number(prefix="train_") # Output: 2
```
If no such file/folder with given prefix exists, it outputs -1
### Get Next Folder / File Name
```python
from filenumutils import get_next_file, get_next_folder
get_next_file(prefix="model_") # Output: model_03.py
get_next_folder(prefix="test_") # Output: test_00
get_next_folder(prefix="train_", create=True) # Output: train_05 (Folder is created)
```
If no such folder with given prefix exists, it outputs `prefix_00`.
Also, it will automatically stick to the existing numbering pattern.
For eg, if the folders were [`train_0000`, `train_0001`],
```python
get_next_folder(prefix="train_", create=True) # Output: train_0000 (Folder is created)
```
### More Options
| Attribute | Default | Description |
| --- | --- | --- |
| `path` | Current Directory | Do operations in the given directory |
| `prefix` | "" | Match only files with given prefix |
| `suffix` | "" | Match only files with given extension/suffix |
| `default_number_width` | 2 | When no numbering pattern is found, output number will be `default_number_width` digits |
| `full_path` | True | By default, returns `new_folder_name`. If True, returns `path/new_folder_name`. |
## Contributing
Pull requests are very welcome.
1. Fork the repo
1. Create new branch with feature name as branch name
1. Check if things work with a jupyter notebook
1. Raise a pull request
## Licence
Please see attached [Licence](LICENCE)