Skip to main content

A simple Python program that generates an ASCII representation of a directory tree.

Project description

English Español


ENGLISH

Overview

Treefolder is a simple Python program that generates an ASCII representation of a directory tree. The function takes 2 parameters -i or -n and also the name of any folder that you want to ignore on the representation of the tree. For example:

  • python tree.py -i sass images: This will ignore all the base folders and also sass and images folder.
  • python tree.py -n .git: This will ignore only the folder .git

** If installed using pip, the commands are treefolder -i args or treefolder -n args. **

Features

  • Directory Tree Generation: Creates an ASCII tree representation of a specified directory.
  • Ignore Folders: Option to ignore specific folders or use a predefined list of common folders to ignore.
  • GUI Folder Selection: Uses a graphical interface to select the folder to generate the tree for.

How It Works

  1. Folder Selection: Users select a folder using a graphical file dialog.
  2. Tree Generation: The program generates an ASCII tree representation of the selected folder, optionally ignoring specified folders.
  3. Output: The generated tree is printed to the console.

Setup Instructions

Prerequisites

  • Python 3.x
  • Required Python libraries: os, argparse, tkinter

Installation

  1. Clone the repository:
    • git clone https://github.com/Aperezortega/Treefolder.git
    • cd treefolder
    • pip install -r requirements.txt

o

  1. Install from PyPI:
    • pip install treefolder

Usage

  1. Run the script:
    • python treefolder.py
  2. Select a folder: A file dialog will appear to select the folder.
  3. View the tree: The ASCII tree representation will be printed in the console.

Customization

  • Ignored Folders: Modify the base_ignored_folders list in the script to add or remove default ignored folders.
  • Command Line Arguments: Use -i or --ignore to specify additional folders to ignore, or -n or --no-ignore to specify folders to ignore exclusively.

ESPAÑOL

Descripción General

Treefolder es un programa simple en Python que genera una representación ASCII de un árbol de directorios. La función acepta 2 parámetros -i o -n y también el nombre de cualquier carpeta que desees ignorar en la representación del árbol. Por ejemplo: python tree.py -i sass images: Esto ignorará todas las carpetas base y también las carpetas sass e images. python tree.py -n .git: Esto ignorará solo la carpeta .git.

** Si se installa usando pip los comandos serían treefolder -i args o treefolder -n args**

Características

  • Generación de Árbol de Directorios: Crea una representación en ASCII de un árbol de directorios especificado.
  • Ignorar Carpetas: Opción para ignorar carpetas específicas o usar una lista predefinida de carpetas comunes para ignorar.
  • Selección de Carpeta con GUI: Utiliza una interfaz gráfica para seleccionar la carpeta para generar el árbol.

Cómo Funciona

  1. Selección de Carpeta: Los usuarios seleccionan una carpeta usando un cuadro de diálogo de archivos gráfico.
  2. Generación de Árbol: El programa genera una representación en ASCII del árbol de la carpeta seleccionada, ignorando opcionalmente las carpetas especificadas.
  3. Salida: El árbol generado se imprime en la consola.

Instrucciones de Configuración

Requisitos Previos

  • Python 3.x
  • Bibliotecas de Python requeridas: os, argparse, tkinter

Instalación

  1. Clone the repository:
    • git clone https://github.com/Aperezortega/Treefolder.git
    • cd treefolder
    • pip install -r requirements.txt

o

  1. Install from PyPI:
    • pip install treefolder

Uso

  1. Ejecutar el script:
    • python treefolder.py
  2. Seleccionar una carpeta: Aparecerá un cuadro de diálogo para seleccionar la carpeta.
  3. Ver el árbol: La representación en ASCII del árbol se imprimirá en la consola.

Personalización

  • Carpetas Ignoradas: Modifique la lista base_ignored_folders en el script para agregar o eliminar carpetas ignoradas por defecto.
  • Argumentos de Línea de Comandos: Use -i o --ignore para especificar carpetas adicionales a ignorar, o -n o --no-ignore para especificar carpetas a ignorar exclusivamente.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

treefolder-1.0.0.tar.gz (16.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

treefolder-1.0.0-py3-none-any.whl (16.7 kB view details)

Uploaded Python 3

File details

Details for the file treefolder-1.0.0.tar.gz.

File metadata

  • Download URL: treefolder-1.0.0.tar.gz
  • Upload date:
  • Size: 16.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for treefolder-1.0.0.tar.gz
Algorithm Hash digest
SHA256 86024af1ead41018cd32555a0949c4ddd83bacb3e107b32a81c259f1476dd5ba
MD5 cf3738b63ebb2c83019d16160f55cdd7
BLAKE2b-256 542249753de57ac438112d79e3748822a1622f6172f6e12879b09498056499b7

See more details on using hashes here.

File details

Details for the file treefolder-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: treefolder-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 16.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for treefolder-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 14b0110c17e5b7b4b79c0cf7c3161214429bc4b7b9ec690e1beec1b7ce0a5046
MD5 8189eb7a6559df62b0eab9ebf3e70992
BLAKE2b-256 c4987349debd818137c07cfb36dd7284b8ff73b9c8681bb519d30b7d54d9bb3a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page