prft


Nameprft JSON
Version 1.2.1 PyPI version JSON
download
home_pageNone
SummaryA tool to generate a file tree structure of a project with .gitignore support
upload_time2024-11-18 06:39:40
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT License
keywords file tree structure file tree file structure
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Project File Tree (prft)

prft is a Python library designed to easily generate and display the file structure of a project, with support for .gitignore patterns. It allows you to quickly visualize the organization of files and directories within a specified project directory.

## Features
-	Generates a clear and visual representation of your project’s file structure.
-	Supports .gitignore and other ignore files, so you only see files relevant to the project.
-	Allows hiding hidden files (dotfiles) for a cleaner output.
-   Easy to use for ChatGPT.

## Installation
Install prft via pip:
```bash
pip install prft
```

## Usage
Use prft in the terminal to display a project’s file structure.

**Basic Command**
```bash
prft path_to_project
```

You can also use . to specify the current directory if you are in the project directory:

```bash
prft .
```

### Options
- **--no-ignore**: Show all files, including those listed in .gitignore.
- **--no-dot**: Include hidden files (dotfiles) in the output.
- **--prefix** "some prefix": Use your own prefix (" " by default)

**Example:**
```bash
prft path_to_project --no-ignore --no-dot
```

### Example Output

Running prft in a sample project directory might produce output like this:
```
project/
├── src/
│   ├── main.py
│   ├── utils.py
│   └── config/
│       └── settings.py
├── .gitignore
├── README.md
└── requirements.txt
```
This output shows a hierarchical view of the files and directories in *path_to_project*, ignoring files specified in .gitignore (unless `--no-ignore` is used).

## License

This project is licensed under the MIT License.

## Author

Created by [trum-ok](https://github.com/Trum-ok) :p

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "prft",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "Arkadii Artamonov <artamarkan@gmail.com>",
    "keywords": "file, tree, structure, file tree, file structure",
    "author": null,
    "author_email": "Arkadii Artamonov <artamarkan@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/06/7b/4fb04d30bfe87d49eedf14c1be25c6ea51aec20dc7cacaa8d419a30c9ca5/prft-1.2.1.tar.gz",
    "platform": null,
    "description": "# Project File Tree (prft)\n\nprft is a Python library designed to easily generate and display the file structure of a project, with support for .gitignore patterns. It allows you to quickly visualize the organization of files and directories within a specified project directory.\n\n## Features\n-\tGenerates a clear and visual representation of your project\u2019s file structure.\n-\tSupports .gitignore and other ignore files, so you only see files relevant to the project.\n-\tAllows hiding hidden files (dotfiles) for a cleaner output.\n-   Easy to use for ChatGPT.\n\n## Installation\nInstall prft via pip:\n```bash\npip install prft\n```\n\n## Usage\nUse prft in the terminal to display a project\u2019s file structure.\n\n**Basic Command**\n```bash\nprft path_to_project\n```\n\nYou can also use . to specify the current directory if you are in the project directory:\n\n```bash\nprft .\n```\n\n### Options\n- **--no-ignore**: Show all files, including those listed in .gitignore.\n- **--no-dot**: Include hidden files (dotfiles) in the output.\n- **--prefix** \"some prefix\": Use your own prefix (\" \" by default)\n\n**Example:**\n```bash\nprft path_to_project --no-ignore --no-dot\n```\n\n### Example Output\n\nRunning prft in a sample project directory might produce output like this:\n```\nproject/\n\u251c\u2500\u2500 src/\n\u2502   \u251c\u2500\u2500 main.py\n\u2502   \u251c\u2500\u2500 utils.py\n\u2502   \u2514\u2500\u2500 config/\n\u2502       \u2514\u2500\u2500 settings.py\n\u251c\u2500\u2500 .gitignore\n\u251c\u2500\u2500 README.md\n\u2514\u2500\u2500 requirements.txt\n```\nThis output shows a hierarchical view of the files and directories in *path_to_project*, ignoring files specified in .gitignore (unless `--no-ignore` is used).\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Author\n\nCreated by [trum-ok](https://github.com/Trum-ok) :p\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "A tool to generate a file tree structure of a project with .gitignore support",
    "version": "1.2.1",
    "project_urls": null,
    "split_keywords": [
        "file",
        " tree",
        " structure",
        " file tree",
        " file structure"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "bc9a4217397fcffebeb9b336cd69275238cd307e5abdc692a0f5c1535fe6068c",
                "md5": "2ffee4a87f0634c50efaf1672068ce20",
                "sha256": "8042f7fbcc7aa08f86406ca97bc9eb21d199ab315cd4ee85a6ca16e2a7df4181"
            },
            "downloads": -1,
            "filename": "prft-1.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2ffee4a87f0634c50efaf1672068ce20",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 4548,
            "upload_time": "2024-11-18T06:39:38",
            "upload_time_iso_8601": "2024-11-18T06:39:38.673622Z",
            "url": "https://files.pythonhosted.org/packages/bc/9a/4217397fcffebeb9b336cd69275238cd307e5abdc692a0f5c1535fe6068c/prft-1.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "067b4fb04d30bfe87d49eedf14c1be25c6ea51aec20dc7cacaa8d419a30c9ca5",
                "md5": "1a494bda4cdc81c844ff209550b82c82",
                "sha256": "08b66a352d2fe85ba187cbb85ec1f6460af2463b4e1b9b0383372f7ee810c0b2"
            },
            "downloads": -1,
            "filename": "prft-1.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "1a494bda4cdc81c844ff209550b82c82",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 4046,
            "upload_time": "2024-11-18T06:39:40",
            "upload_time_iso_8601": "2024-11-18T06:39:40.163448Z",
            "url": "https://files.pythonhosted.org/packages/06/7b/4fb04d30bfe87d49eedf14c1be25c6ea51aec20dc7cacaa8d419a30c9ca5/prft-1.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-18 06:39:40",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "prft"
}
        
Elapsed time: 0.93983s