# UtilsDSP
Variedades de funciones útiles para trabajar con Python, sin tener que escribrirlas una y otras vez cada vez que se necesitan en algún proyecto.
Orientadas principalmente para ejecutar scripts de Python desde CLI o en cuadernos de Google Colab y Jupyter.
Tabla de contenido
- [UtilsDSP](#utilsdsp)
- [Install](#install)
- [Usage/Examples](#usageexamples)
- [Operaciones con rutas](#operaciones-con-rutas)
- [Operaciones con directorios](#operaciones-con-directorios)
- [Operaciones con archivos](#operaciones-con-archivos)
- [Operaciones de saneamiento](#operaciones-de-saneamiento)
- [Tamaño de archivos y directorios](#tamaño-de-archivos-y-directorios)
- [Comprimir archivos y directorios](#comprimir-archivos-y-directorios)
- [Otras funciones útiles](#otras-funciones-útiles)
- [Operaciones con listas](#operaciones-con-listas)
- [Operaciones con Diccionarios](#operaciones-con-diccionarios)
- [Organizar directorios](#organizar-directorios)
- [Descargar archivos desde internet](#descargar-archivos-desde-internet)
- [Documentation](#documentation)
- [License](#license)
- [Authors](#authors)
## Install
La instalación vía `pip` es sencilla, solo ejecutar la siguiente línea en la terminal del proyecto de Python.
```bash
pip install utilsdsp
```
## Usage/Examples
Su uso es bastante simple, una vez instalado solo se debe importar la función o funciones necesarias de la siguiente forma:
```py
from utilsdsp import compress, uncompress
```
### Operaciones con rutas
- `obtain_current_path` - Obtener la ruta donde se está ejecutando el script
- `obtain_absolute_path` - Obtener la ruta absoluta
- `change_current_path` - Cambiar la ruta actual de ejecución del script
- `validate_path` - Válidar sí la ruta existe
- `join_path` - Unir rutas en una sola
- `obtain_default_path` - Obtener la ruta absoluta por defecto _(PC o Google Colab)_
- `obtain_downloads_path` - Obtener la ruta para guardar las descargas
- `rename_exists_file` - Renombrar un archivo sí existe en el destino
### Operaciones con directorios
- `create_dir` - Crear directorio
- `create_downloads_dir` - Crear el directorio de las descargas
- `create_symbolic_link` - Crear enlace simbólico
- `delete_dir` - Eliminar un directorio o archivo
- `del_empty_dirs` - Borrar recursivamente los sub-directorios vacios
- `select_dir_content` - Seleccionar contenido de un directorio
- `move_dirs` - Mover archivo(s) y directorio(s) hacia otro directorio
- `copy_dirs` - Copiar archivo(s) y directorio(s) hacia otro directorio
- `rename_dir` - Renombrar un archivo o directorio
### Operaciones con archivos
- `read_text_file` - Leer un archivo de texto
- `write_text_file` - Guardar texto en un archivo
### Operaciones de saneamiento
- `truncate_filename` - Truncar el nombre del archivo o directorio
- `sanitize_filename` - Sanear el nombre de un archivo o directorio
### Tamaño de archivos y directorios
- `natural_size` - Convertir los bytes a medidas más legibles _(KB, MB, etc)_
- `obtain_size` - Obtener tamaño de un archivo o directorio
### Comprimir archivos y directorios
- `compress` - Comprimir un directorio o archivo
- `uncompress` - Descomprimir un archivo _(zip, tar, gztar, bztar, xztar)_
### Otras funciones útiles
- `obtain_url_from_html` - Obtener la URL desde un archivo HTML
- `create_headers_decorates` - Crear un encabezado decorado
- `clear_output` - Limpiar salida en la Terminal según el SO
- `calc_img_dimensions` - Calcular las dimensiones de una imagen
- `obtain_similar_vars` - Obtener el valor o nombre de variables similares
### Operaciones con listas
- `remove_repeated_elements` - Eliminar elementos repetidos
### Operaciones con Diccionarios
- `join_list_to_dict` - Unir dos listas en un diccionario
### Organizar directorios
- `move_to_root` - Mover archivos de los sub-directorios hacia el directorio raíz
- `move_files_to_subdir` - Mover archivos hacia un sub-directorio dentro de los sub-directorios de nivel 1
- `organize_files_by_type` - Organizar los archivos en directorios según su tipo
- `organize_files_by_name` - Organizar los archivos en directorios según su nombre
### Descargar archivos desde internet
- `validate_and_resquest` - Comprobar sí una URL es válida y accesible
- `download_file` - Descargar un archivo desde internet
- `download_files` - Descargar multiples archivos simultáneos desde internet
## Documentation
En desarrollo
## License
[MIT](LICENSE)
## Authors
- [@dunieskysp](https://github.com/dunieskysp)
Raw data
{
"_id": null,
"home_page": "https://github.com/dunieskysp/utils_dsp",
"name": "utilsdsp",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "python, utilsdsp",
"author": "Duniesky Salazar P\u00e9rez",
"author_email": "<duniesky.salazar@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d3/62/bdd9665e2d4cc2987594bbc66e522d8b7b7b2b0513b1a468ad744b5113b2/utilsdsp-0.1.3.tar.gz",
"platform": null,
"description": "# UtilsDSP\r\n\r\nVariedades de funciones \u00fatiles para trabajar con Python, sin tener que escribrirlas una y otras vez cada vez que se necesitan en alg\u00fan proyecto.\r\n\r\nOrientadas principalmente para ejecutar scripts de Python desde CLI o en cuadernos de Google Colab y Jupyter.\r\n\r\nTabla de contenido\r\n\r\n- [UtilsDSP](#utilsdsp)\r\n - [Install](#install)\r\n - [Usage/Examples](#usageexamples)\r\n - [Operaciones con rutas](#operaciones-con-rutas)\r\n - [Operaciones con directorios](#operaciones-con-directorios)\r\n - [Operaciones con archivos](#operaciones-con-archivos)\r\n - [Operaciones de saneamiento](#operaciones-de-saneamiento)\r\n - [Tama\u00f1o de archivos y directorios](#tama\u00f1o-de-archivos-y-directorios)\r\n - [Comprimir archivos y directorios](#comprimir-archivos-y-directorios)\r\n - [Otras funciones \u00fatiles](#otras-funciones-\u00fatiles)\r\n - [Operaciones con listas](#operaciones-con-listas)\r\n - [Operaciones con Diccionarios](#operaciones-con-diccionarios)\r\n - [Organizar directorios](#organizar-directorios)\r\n - [Descargar archivos desde internet](#descargar-archivos-desde-internet)\r\n - [Documentation](#documentation)\r\n - [License](#license)\r\n - [Authors](#authors)\r\n\r\n## Install\r\n\r\nLa instalaci\u00f3n v\u00eda `pip` es sencilla, solo ejecutar la siguiente l\u00ednea en la terminal del proyecto de Python.\r\n\r\n```bash\r\n pip install utilsdsp\r\n```\r\n\r\n## Usage/Examples\r\n\r\nSu uso es bastante simple, una vez instalado solo se debe importar la funci\u00f3n o funciones necesarias de la siguiente forma:\r\n\r\n```py\r\nfrom utilsdsp import compress, uncompress\r\n```\r\n\r\n### Operaciones con rutas\r\n\r\n- `obtain_current_path` - Obtener la ruta donde se est\u00e1 ejecutando el script\r\n- `obtain_absolute_path` - Obtener la ruta absoluta\r\n- `change_current_path` - Cambiar la ruta actual de ejecuci\u00f3n del script\r\n- `validate_path` - V\u00e1lidar s\u00ed la ruta existe\r\n- `join_path` - Unir rutas en una sola\r\n- `obtain_default_path` - Obtener la ruta absoluta por defecto _(PC o Google Colab)_\r\n- `obtain_downloads_path` - Obtener la ruta para guardar las descargas\r\n- `rename_exists_file` - Renombrar un archivo s\u00ed existe en el destino\r\n\r\n### Operaciones con directorios\r\n\r\n- `create_dir` - Crear directorio\r\n- `create_downloads_dir` - Crear el directorio de las descargas\r\n- `create_symbolic_link` - Crear enlace simb\u00f3lico\r\n- `delete_dir` - Eliminar un directorio o archivo\r\n- `del_empty_dirs` - Borrar recursivamente los sub-directorios vacios\r\n- `select_dir_content` - Seleccionar contenido de un directorio\r\n- `move_dirs` - Mover archivo(s) y directorio(s) hacia otro directorio\r\n- `copy_dirs` - Copiar archivo(s) y directorio(s) hacia otro directorio\r\n- `rename_dir` - Renombrar un archivo o directorio\r\n\r\n### Operaciones con archivos\r\n\r\n- `read_text_file` - Leer un archivo de texto\r\n- `write_text_file` - Guardar texto en un archivo\r\n\r\n### Operaciones de saneamiento\r\n\r\n- `truncate_filename` - Truncar el nombre del archivo o directorio\r\n- `sanitize_filename` - Sanear el nombre de un archivo o directorio\r\n\r\n### Tama\u00f1o de archivos y directorios\r\n\r\n- `natural_size` - Convertir los bytes a medidas m\u00e1s legibles _(KB, MB, etc)_\r\n- `obtain_size` - Obtener tama\u00f1o de un archivo o directorio\r\n\r\n### Comprimir archivos y directorios\r\n\r\n- `compress` - Comprimir un directorio o archivo\r\n- `uncompress` - Descomprimir un archivo _(zip, tar, gztar, bztar, xztar)_\r\n\r\n### Otras funciones \u00fatiles\r\n\r\n- `obtain_url_from_html` - Obtener la URL desde un archivo HTML\r\n- `create_headers_decorates` - Crear un encabezado decorado\r\n- `clear_output` - Limpiar salida en la Terminal seg\u00fan el SO\r\n- `calc_img_dimensions` - Calcular las dimensiones de una imagen\r\n- `obtain_similar_vars` - Obtener el valor o nombre de variables similares\r\n\r\n### Operaciones con listas\r\n\r\n- `remove_repeated_elements` - Eliminar elementos repetidos\r\n\r\n### Operaciones con Diccionarios\r\n\r\n- `join_list_to_dict` - Unir dos listas en un diccionario\r\n\r\n### Organizar directorios\r\n\r\n- `move_to_root` - Mover archivos de los sub-directorios hacia el directorio ra\u00edz\r\n- `move_files_to_subdir` - Mover archivos hacia un sub-directorio dentro de los sub-directorios de nivel 1\r\n- `organize_files_by_type` - Organizar los archivos en directorios seg\u00fan su tipo\r\n- `organize_files_by_name` - Organizar los archivos en directorios seg\u00fan su nombre\r\n\r\n### Descargar archivos desde internet\r\n\r\n- `validate_and_resquest` - Comprobar s\u00ed una URL es v\u00e1lida y accesible\r\n- `download_file` - Descargar un archivo desde internet\r\n- `download_files` - Descargar multiples archivos simult\u00e1neos desde internet\r\n\r\n## Documentation\r\n\r\nEn desarrollo\r\n\r\n## License\r\n\r\n[MIT](LICENSE)\r\n\r\n## Authors\r\n\r\n- [@dunieskysp](https://github.com/dunieskysp)\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Algunas funciones \u00fatiles",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/dunieskysp/utils_dsp"
},
"split_keywords": [
"python",
" utilsdsp"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2ee9f869ef455023417adb602e681e5acd5851cc48cb19ca0d52dc5da8166741",
"md5": "c918111fac14e79a3ddf244f2a82aad8",
"sha256": "bf8b2bed083d2fb345217a4d8f511a22033f49defb0e312687a79f9394220b1e"
},
"downloads": -1,
"filename": "utilsdsp-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c918111fac14e79a3ddf244f2a82aad8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 27859,
"upload_time": "2025-02-06T17:34:07",
"upload_time_iso_8601": "2025-02-06T17:34:07.414996Z",
"url": "https://files.pythonhosted.org/packages/2e/e9/f869ef455023417adb602e681e5acd5851cc48cb19ca0d52dc5da8166741/utilsdsp-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d362bdd9665e2d4cc2987594bbc66e522d8b7b7b2b0513b1a468ad744b5113b2",
"md5": "6ba5130c595a9afdb82867b9534aa226",
"sha256": "5af611140e8ef8d7cc25f12977141fb40243b9bf0b767bde79122e88e22fda0a"
},
"downloads": -1,
"filename": "utilsdsp-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "6ba5130c595a9afdb82867b9534aa226",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 23315,
"upload_time": "2025-02-06T17:34:10",
"upload_time_iso_8601": "2025-02-06T17:34:10.047093Z",
"url": "https://files.pythonhosted.org/packages/d3/62/bdd9665e2d4cc2987594bbc66e522d8b7b7b2b0513b1a468ad744b5113b2/utilsdsp-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-06 17:34:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dunieskysp",
"github_project": "utils_dsp",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "utilsdsp"
}
JSON
