humanscript 0.1.0

A human-readable programming language for web and mobile app generation.

WhiteLion HumanScript programing Language

HumanScript is a simplified, human-readable programming language designed for generating web and mobile applications. It allows developers and non-developers alike to create projects using straightforward commands, which are then converted into code files for modern frameworks like React and React Native.

Table of Contents Features Installation Usage Supported Commands Example Commands Using the Command Line Directory Structure Running Tests Contributing License Features Human-readable commands to generate web and mobile projects. Automatic creation of React and React Native project files, including component templates and styles. Supports both unit tests and integration tests. Easily customizable project templates. Installation To install and set up HumanScript, follow these steps:

Clone the repository:

bash Copy code git clone https://github.com/yourusername/humanscript.git cd humanscript Install dependencies:

Make sure you have Python installed (version 3.6 or higher). Install the required Python packages: bash Copy code pip install -r requirements.txt If you encounter issues with pip permissions, try: bash Copy code python.exe -m pip install --upgrade pip --user pip install -r requirements.txt --user Install TensorFlow Manually (If Needed):

If you encounter issues installing TensorFlow, try: bash Copy code pip install tensorflow Install Node.js (for running React/React Native projects):

Download and install Node.js if it is not already installed. Once Node.js is installed, proceed with the next steps. Generate the output directories (if not already present):

Create the directories for the web and mobile projects: bash Copy code mkdir -p output/WebApp mkdir -p output/MobileApp Install JavaScript dependencies:

For web projects: bash Copy code cd output/WebApp npm install react react-dom react-scripts --save For mobile projects: bash Copy code cd ../MobileApp npm install react-native --save Handling NPM Vulnerabilities (Optional):

Fix vulnerabilities automatically: bash Copy code npm audit fix For a more aggressive approach, use: bash Copy code npm audit fix --force Usage Supported Commands HumanScript currently supports the following commands:

generate mobile: Generates a React Native mobile app with basic components and styles. generate web: Generates a React web app with basic components and styles. execute : Executes a list of commands from a specified file. Example Commands Here are some example commands that can be used with HumanScript:

Generate a Mobile App

plaintext Copy code generate mobile Generate a Web App

plaintext Copy code generate web Execute Commands from a File Create a file named commands.txt with the following content:

plaintext Copy code generate mobile generate web Then run:

bash Copy code python parser.py execute commands.txt Using the Command Line You can run HumanScript commands from the command line using the provided parser.py script. Here are some examples:

Generate a Mobile App

bash Copy code python parser.py "generate mobile" Generate a Web App

bash Copy code python parser.py "generate web" Execute Commands from a File

bash Copy code python parser.py execute commands.txt Configuring the Generated Templates You can customize the generated templates by providing additional data. For example:

python Copy code

Example data for customizing templates

data = { "header": "Welcome to My App", "title": "My Application" } This data will be used to populate placeholders in the generated code files.

Directory Structure The HumanScript project is organized as follows:

bash Copy code project_root/ ├── mobile_templates.py # Code for generating mobile app templates ├── web_templates.py # Code for generating web app templates ├── parser.py # Command parsing and execution logic ├── requirements.txt # Python dependencies for the project ├── tests/ # Directory for unit and integration tests │ ├── init.py # Initializes the 'tests' package │ ├── test_interpreter.py # Unit tests for the interpreter logic │ └── test_integration.py # Integration tests for end-to-end functionality └── README.md # Documentation for the HumanScript project Running Tests To ensure that everything is working correctly, you can run the provided unit tests and integration tests:

Run the unit tests:

bash Copy code python -m unittest tests/test_interpreter.py Run the integration tests:

bash Copy code python -m unittest tests/test_integration.py Run all tests:

bash Copy code python -m unittest discover -s tests Contributing We welcome contributions to HumanScript! If you'd like to contribute, please follow these steps:

Fork the repository and clone it locally. Create a new branch for your feature or bugfix. Commit your changes with descriptive commit messages. Push to your fork and create a pull request. Wait for review and address any feedback. License This project is licensed under the MIT License. See the LICENSE file for details.

Changes Made: Added troubleshooting steps for upgrading pip and installing TensorFlow. Provided instructions for creating output directories before installing npm packages. Addressed handling of npm vulnerabilities and outdated packages. #\x00 \x00w\x00h\x00i\x00t\x00e\x00L\x00i\x00o\x00n\x00_\x00h\x00u\x00m\x00a\x00n\x00s\x00c\x00r\x00i\x00p\x00t\x00 \x00 \x00