Metadata-Version: 2.2
Name: autostruct-tool
Version: 0.1.2
Summary: A tool to create directory structures from text files
Home-page: https://github.com/amandeepsingh29/autostruct
Author: Amandeep Singh
Author-email: amandeep.singh.dsc@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: requires-python
Dynamic: summary

# AutoStruct

## Tagline

**Organize. Scaffold. Develop.**

## Motto

**From Blueprint to Code in One Command.**

## Overview

AutoStruct is a powerful command-line tool that transforms a simple text file into a complete directory structure for your project. Designed for developers who value efficiency and organization, AutoStruct automates the tedious task of manual project scaffolding, so you can focus on what truly mattersâ€”coding!

## Core Features

### Quick Setup

- Generate complex directory trees with a single command.

### Flexible Formatting

- Define both directories and files using an intuitive, plain text format.

### Cross-Platform

- Works seamlessly on any operating system with Python 3.6+.

### No External Dependencies

- Built entirely with Python's standard libraries, ensuring hassle-free installation.

## Benefits

- **Time Saving:** Automate repetitive folder and file creation to start coding faster.
- **Consistency:** Maintain a standardized project structure across all your projects.
- **Simplified Workflow:** Easily set up new projects with a predefined scaffold.
- **Error Reduction:** Minimize manual mistakes in creating directories and files.
- **Enhanced Productivity:** Focus on development instead of spending time on setup.

## Getting Started

### Installation

Install AutoStruct from PyPI:

```bash
pip install autostruct-tool==0.1.2
```

**Note:** The package is named `autostruct-tool` on PyPI, but the command-line tool is accessed via the `autostruct` command.

## How It Works

1. **Plan:** Create a structure file (e.g., `structure.txt`) that defines your projectâ€™s layout.
2. **Generate:** Run the command in your terminal to generate the directories and files.
3. **Develop:** Open your newly created project structure and start coding!

### Example Structure File

```plaintext
my_project/
â”‚â”€â”€ my_project/
â”‚   â”‚â”€â”€ __init__.py
â”‚   â”‚â”€â”€ main.py
â”‚   â”‚â”€â”€ utils.py
â”‚â”€â”€ tests/
â”‚â”€â”€ docs/
â”‚â”€â”€ README.md
â”‚â”€â”€ requirements.txt
â”‚â”€â”€ LICENSE
```

### Generated Project Structure

```plaintext
my_project/
â”‚â”€â”€ my_project/
â”‚   â”‚â”€â”€ __init__.py
â”‚   â”‚â”€â”€ main.py
â”‚   â”‚â”€â”€ utils.py
â”‚â”€â”€ tests/
â”‚â”€â”€ docs/
â”‚â”€â”€ README.md
â”‚â”€â”€ requirements.txt
â”‚â”€â”€ LICENSE
```

## Development

Interested in contributing or modifying AutoStruct? Follow these steps to set up your development environment:

### Clone the Repository:

```bash
git clone https://github.com/amandeepsingh29/autostruct.git
cd autostruct
```

### Set Up a Virtual Environment:

```bash
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
```

### Install in Editable Mode:

```bash
pip install -e .
```

### Run Tests:

(When tests are added in the future, run them with your preferred test runner, e.g., `pytest`.)

## License

This project is licensed under the MIT License. See the LICENSE file for details.

## Contact

For any questions, suggestions, or issues, please open an issue on GitHub or contact the project maintainer, **Amandeep Singh**.

ðŸš€ **Happy Coding!**

