Metadata-Version: 2.4
Name: human-language
Version: 0.1.5
Summary: A custom programming language with plain English syntax
Home-page: https://github.com/kieltech75-hue/Human
Author: KielTech
Author-email: KielTech <info@kieltech.com>
License: MIT
Project-URL: Homepage, https://github.com/kieltech75-hue/human-language
Project-URL: Repository, https://github.com/kieltech75-hue/human-language
Project-URL: Issues, https://github.com/kieltech75-hue/human-language/issues
Keywords: language,interpreter,compiler,programming
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Interpreters
Classifier: Topic :: Software Development :: Compilers
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pygls>=1.0.0
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python


# Human Programming Language

![CI](https://github.com/kieltech2/Human/actions/workflows/ci.yml/badge.svg)

**Created and owned by KielTech**

A human-friendly programming language with plain English syntax.

## Overview

**Human** is an interpreted/compiled language that prioritizes readability and naturalness. It uses plain English constructs with minimal keywords.

## File Extension

`.hm` - Human Language files

## Quick Example

```
print "Hello, World!"

set age to 25
if age is greater than 18
    print "You are an adult"
end if

define greet with name
    print "Hello, " + name + "!"
end define

greet "Alice"
```

## Installation & Usage

### Install Human

Install the published runtime from PyPI:

```bash
pip install human-language
```

### Run a program

```bash
human program.hm
```

### Start the REPL

```bash
human --repl
```

### Quick Hello World

```hm
print "Hello, World!"
```

### Standalone release download

A standalone Windows runtime is now available from the GitHub release for `v0.1.4`:

https://github.com/kieltech75-hue/Human/releases/tag/v0.1.4

Download the `human.exe` asset directly:

https://github.com/kieltech75-hue/Human/releases/download/v0.1.4/human.exe

`human.exe` is self-contained and requires no Python install.

### Android packaging

Build an Android APK using the provided helper:

```bash
human --package-apk --spec buildozer.spec --target debug
```

## Key Features

- Natural English-style syntax for control flow, functions, and declarations
- Built-in data types: strings, numbers, lists, dictionaries, booleans
- Imports for reusable `.hm` modules
- Simple class-style objects and method calls
- File I/O, environment access, and logging
- HTTP helpers for services and web endpoints
- Python interoperability via `py_import` and `py_call`
- REPL with package manager commands and debugging helpers

## Common commands

- `human program.hm` — execute a Human program
- `human --repl` — launch the interactive REPL
- `human --package-native <source.hm> --dist <output-dir>` — build a native executable
- `human --package-native <source.hm> --dist <output-dir> --bundle-python --name <app-name>` — build a self-contained executable
- `human --package-apk --spec buildozer.spec --target debug` — build an Android APK

## REPL package manager commands

- `:install <package> [--global]` — install a local or Git-hosted Human module
- `:list-packages [--global]` — list installed Human packages
- `:remove <package> [--global]` — remove an installed package
- `:pkg-info <package>` — show the package install path
- `:reload <module>` — reload an imported module
- `:paths` — show trusted module search roots
- `:vars` — show current REPL variables
- `:stack` — show the current VM stack
- `:pc` — show the current VM program counter
- `:debug <file>` — launch the interactive debugger for a file
- `:license` — display license text

## Examples

Run the AI example:

```bash
human examples/ai_app.hm
```

Run the web app example:

```bash
human examples/web_app.hm
```

Run the production website example with sessions, templates, logging, static assets, and deployment hooks:

```bash
human examples/production_web_app.hm
```

## Syntax Highlighting

The Human VS Code extension provides syntax highlighting, bracket matching, and `.hm` file support.

Install the published extension from the Visual Studio Marketplace or use the local VSIX package from this repository.

## Learn more

For additional usage examples and reference guides, see:

- `INSTALLATION.md`
- `QUICKSTART.md`
- `QUICK_REFERENCE.md`
- `SYNTAX.md`

