# TreeScript FileTreeBuilder
Script for Building File Trees.
- Makes your dreams come true.
## How To
1. Prepare Your TreeScript Designs.
- Initial and Final TreeScripts.
- Build New Project Package/Module.
2. Logical Order of TreeScript Builder Operations.
3. Run TreeScript Builder from the CommandLine.
- Apply combinations of Operations to build TreeScript Workflows.
# Project Technical Details:
## File Tree Builder
Execute the File Tree Builder with the `ftb` command.
- Creates Files and Directories
- If DataLabels are present, a DataDirectory is required.
### File Tree Trimmer (Remover)
Execute the File Tree Remover by adding the `--trim` argument.
- Removes Files and Empty Directories.
- DataLabels require DataDirectory.
- Files are exported to the DataDirectory.
## Default Input Reader
Before the Reader receives TreeScript, the input is filtered so comments and empty lines are not ever seen by the Reader.
The Default Input Reader processes one line at a time and calculates multiple file tree node properties that it stores in dataclass objects.
It calculates for each node:
- Name
- File or directory status
- Depth in tree
- (optional) DataArgument
## Builder Data Feature
The Builder provides one additional feature that goes beyond creation of the File Tree. This feature enables Files to be created with data inserted immediately.
### Input Data Argument
The Data Argument specifies what will be inserted into the file that is created. The Data Argument is provided in the Input File, immediately after the File Name (separated by a space). There are two types of Data Arguments:
- DataLabel
- InlineContent
### Builder DataLabel Feature
A `DataLabel` is a link to Text content to be inserted into the file.
- DataLabel is present in both the DataDirectory, and the TreeScript File.
## Tree Trim Data Directory Feature
The Remover provides an additional feature beyond the removal of files in the Tree. This feature enables Files to be saved to a Data Directory when they are removed. Rather than destroying the file data, it is moved to a new directory.
## To-Do Features
### Builder File Inline Content (TODO)
`Inline Content` is written in the Tree Node Structure Input file itself. To distinguish `DataContent` from a `DataLabel`, the Content must begin with a special character.
Options for the DataContent character are under consideration.
- Less than bracket is a good option: <
- Star char is an alternative: *
This feature is a neat mid-sized improvement that may open up opportunities for more workflow flexibility.
- Adding a new file late in the process.
- such as after data directory is already prepared, and you review TS and notice a little thing missing.
- value-adding option that helps you build files faster, more convenient than the DataDirectory.
- Workflows that use TreeScript.
- Easier To Plan, and Communicate What You Did.
- Package Restructuring, Migrations.
- Test Environment Setup
- FileSystem Inventory
Raw data
{
"_id": null,
"home_page": "https://github.com/DK96-OS/treescript-builder",
"name": "treescript-builder",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "TreeScript, Files, Directory",
"author": "DK96-OS",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/d0/c9/14ab4bff69c0bf82723194b9ccb55a3ae55756cf839f1b3d805eb818dd94/treescript_builder-0.1.2.tar.gz",
"platform": null,
"description": "# TreeScript FileTreeBuilder\nScript for Building File Trees.\n - Makes your dreams come true.\n\n## How To\n1. Prepare Your TreeScript Designs.\n - Initial and Final TreeScripts.\n - Build New Project Package/Module.\n2. Logical Order of TreeScript Builder Operations.\n3. Run TreeScript Builder from the CommandLine.\n - Apply combinations of Operations to build TreeScript Workflows.\n\n# Project Technical Details:\n\n## File Tree Builder\nExecute the File Tree Builder with the `ftb` command.\n- Creates Files and Directories\n- If DataLabels are present, a DataDirectory is required.\n\n### File Tree Trimmer (Remover)\nExecute the File Tree Remover by adding the `--trim` argument.\n- Removes Files and Empty Directories.\n- DataLabels require DataDirectory.\n - Files are exported to the DataDirectory. \n\n## Default Input Reader\nBefore the Reader receives TreeScript, the input is filtered so comments and empty lines are not ever seen by the Reader.\nThe Default Input Reader processes one line at a time and calculates multiple file tree node properties that it stores in dataclass objects.\n\nIt calculates for each node:\n- Name\n- File or directory status\n- Depth in tree\n- (optional) DataArgument\n\n## Builder Data Feature\nThe Builder provides one additional feature that goes beyond creation of the File Tree. This feature enables Files to be created with data inserted immediately.\n\n### Input Data Argument\nThe Data Argument specifies what will be inserted into the file that is created. The Data Argument is provided in the Input File, immediately after the File Name (separated by a space). There are two types of Data Arguments:\n- DataLabel\n- InlineContent\n\n### Builder DataLabel Feature\nA `DataLabel` is a link to Text content to be inserted into the file.\n - DataLabel is present in both the DataDirectory, and the TreeScript File.\n\n## Tree Trim Data Directory Feature\nThe Remover provides an additional feature beyond the removal of files in the Tree. This feature enables Files to be saved to a Data Directory when they are removed. Rather than destroying the file data, it is moved to a new directory.\n\n\n## To-Do Features \n\n### Builder File Inline Content (TODO)\n`Inline Content` is written in the Tree Node Structure Input file itself. To distinguish `DataContent` from a `DataLabel`, the Content must begin with a special character.\n\nOptions for the DataContent character are under consideration.\n- Less than bracket is a good option: < \n- Star char is an alternative: *\n\nThis feature is a neat mid-sized improvement that may open up opportunities for more workflow flexibility.\n - Adding a new file late in the process.\n - such as after data directory is already prepared, and you review TS and notice a little thing missing.\n - value-adding option that helps you build files faster, more convenient than the DataDirectory.\n - Workflows that use TreeScript.\n - Easier To Plan, and Communicate What You Did.\n - Package Restructuring, Migrations.\n - Test Environment Setup\n - FileSystem Inventory\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Builds File Trees from TreeScript. If DataLabels are present in TreeScript, a DataDirectory argument is required.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/DK96-OS/treescript-builder",
"Issues": "https://github.com/DK96-OS/treescript-builder/issues",
"Source Code": "https://github.com/DK96-OS/treescript-builder"
},
"split_keywords": [
"treescript",
" files",
" directory"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e985c9dbbc51279cba5567e96b6fec57ec2a2b7c5f6627ae899dc93d5e62b327",
"md5": "9194f640394e2b2a987c40864833e64f",
"sha256": "b7862150179a5425f12307f6f7d6e91f6c567dcbbd274978d718415502068bda"
},
"downloads": -1,
"filename": "treescript_builder-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9194f640394e2b2a987c40864833e64f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 24865,
"upload_time": "2025-07-13T04:42:51",
"upload_time_iso_8601": "2025-07-13T04:42:51.109278Z",
"url": "https://files.pythonhosted.org/packages/e9/85/c9dbbc51279cba5567e96b6fec57ec2a2b7c5f6627ae899dc93d5e62b327/treescript_builder-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d0c914ab4bff69c0bf82723194b9ccb55a3ae55756cf839f1b3d805eb818dd94",
"md5": "f753c32c09700018774866d213a83e55",
"sha256": "d288c0f8d94b8738917793a9a0cb0443455db9a392a09fb173c1691d3a593ae9"
},
"downloads": -1,
"filename": "treescript_builder-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "f753c32c09700018774866d213a83e55",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 18442,
"upload_time": "2025-07-13T04:42:52",
"upload_time_iso_8601": "2025-07-13T04:42:52.418957Z",
"url": "https://files.pythonhosted.org/packages/d0/c9/14ab4bff69c0bf82723194b9ccb55a3ae55756cf839f1b3d805eb818dd94/treescript_builder-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-13 04:42:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DK96-OS",
"github_project": "treescript-builder",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "treescript-builder"
}
JSON
