Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions python-installer/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
Apache License 2.0

Copyright 2026 Tcode-Motion and TechScript contributors.

This package is distributed under the Apache License, Version 2.0. The complete license text is available in the repository root LICENSE file and at:

https://www.apache.org/licenses/LICENSE-2.0
224 changes: 224 additions & 0 deletions python-installer/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,224 @@
# TechScript — Python Installer

<div align="center">

[![PyPI](https://img.shields.io/pypi/v/techscript?style=for-the-badge&color=0DF28B)](https://pypi.org/project/techscript/)
[![Python](https://img.shields.io/pypi/pyversions/techscript?style=for-the-badge)](https://pypi.org/project/techscript/)
[![License](https://img.shields.io/badge/license-Apache--2.0-green?style=for-the-badge)](../LICENSE)
[![GitHub](https://img.shields.io/badge/GitHub-Tcode--Motion%2Ftechscript-black?style=for-the-badge)](https://github.com/Tcode-Motion/techscript)

**The official Python-based installer for the TechScript 2.0 programming language.**

</div>

---

## What This Package Does

This is a **lightweight bootstrapper only** — it contains no compiler binaries.

When you run `techscript install`, it:
1. Detects your OS and CPU architecture
2. Fetches the correct native binary from [GitHub Releases](https://github.com/Tcode-Motion/techscript/releases/latest)
3. Installs it into your PATH
4. Verifies the installation by running `tsc version`

> **The actual TechScript compiler remains distributed via GitHub Releases.**
> This PyPI package is under 200 KB and contains only Python code.

---

## Supported Platforms

| Platform | Architecture | Status |
|---|---|---|
| Windows | x64 | ✅ Supported |
| Windows | ARM64 | ✅ Supported |
| Linux | x64 | ✅ Supported |
| Linux | ARM64 | ✅ Supported |
| macOS | Intel (x64) | ✅ Supported |
| macOS | Apple Silicon (ARM64) | ✅ Supported |
| Android Termux | ARM64 | ✅ Supported |
| Android Termux | ARMv7 | 🔄 Optional |

---

## Installation

### Via pip (Recommended)

```bash
pip install techscript
techscript install
```

### Via curl — Linux / macOS

```bash
curl -fsSL https://raw.githubusercontent.com/Tcode-Motion/techscript/main/scripts/install.sh | bash
```

### Via installer.exe — Windows

Download `TechScript_Setup.exe` from [GitHub Releases](https://github.com/Tcode-Motion/techscript/releases/latest).

### Via Termux — Android

```bash
pkg update
pkg install curl python
# Option 1: Python installer
pip install techscript
techscript install

# Option 2: Shell installer
curl -fsSL https://raw.githubusercontent.com/Tcode-Motion/techscript/main/scripts/install.sh | bash
```

### Via Homebrew — macOS *(coming soon)*

```bash
brew install tcode-motion/tap/techscript
```

### Via Winget — Windows *(coming soon)*

```powershell
winget install Tcode-Motion.TechScript
```

### Via Scoop — Windows *(coming soon)*

```powershell
scoop install techscript
```

---

## Usage

### Install the compiler

```bash
techscript install
```

### Force reinstall / update

```bash
techscript install --force
```

### Check installed version

```bash
techscript version
```

### Check for updates

```bash
techscript check
```

### Uninstall

```bash
techscript uninstall
```

### Forward commands to tsc

```bash
# These are equivalent:
techscript run myfile.txs
tsc run myfile.txs
```

---

## Quick Start

After installing:

```bash
# Create a new project
tsc new hello_world
cd hello_world

# Run it
tsc run
```

Your first `src/main.txs`:

```txs
say "Hello, World! 🌍"
name = ask "What is your name? "
say $"Welcome, {name}! You are running TechScript 2.0."
```

---

## Install Locations

| Platform | Location |
|---|---|
| Windows | `%LOCALAPPDATA%\TechScript\bin\tsc.exe` |
| Linux / macOS | `~/.local/bin/tsc` |
| Termux | `$PREFIX/bin/tsc` |

---

## Debug Mode

Enable verbose output and Python tracebacks:

```bash
techscript install --debug
```

---

## Requirements

- Python 3.8 or newer
- Internet access (to download the compiler binary)
- The `requests` library (installed automatically)

---

## Development

```bash
git clone https://github.com/Tcode-Motion/techscript
cd techscript/python-installer

# Install in editable mode
pip install -e .

# Run tests
python -m pytest tests/ -v

# Build wheel and sdist
python -m build
```

---

## Links

| Resource | Link |
|---|---|
| 🌐 Website | [techscript.is-a.dev](https://techscript.is-a.dev) |
| 📦 GitHub | [Tcode-Motion/techscript](https://github.com/Tcode-Motion/techscript) |
| 🐍 PyPI | [pypi.org/project/techscript](https://pypi.org/project/techscript/) |
| 💻 VS Code Extension | [marketplace.visualstudio.com](https://marketplace.visualstudio.com/items?itemName=tanmoy.techscript) |
| 🐛 Issues | [GitHub Issues](https://github.com/Tcode-Motion/techscript/issues) |
| 💬 Discussions | [GitHub Discussions](https://github.com/Tcode-Motion/techscript/discussions) |

---

## License

Apache License 2.0 — Copyright 2026 [Tcode-Motion](https://github.com/Tcode-Motion)
57 changes: 57 additions & 0 deletions python-installer/pyproject.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "techscript"
version = "2.0.0.1"
description = "Official installer and launcher for the TechScript 2.0 programming language toolchain"
readme = "README.md"
license = { file = "LICENSE" }
requires-python = ">=3.8"
authors = [
{ name = "Tcode-Motion", email = "tcode.motion@gmail.com" }
]
keywords = ["techscript", "compiler", "installer", "tsc", "programming-language"]
classifiers = [
"Development Status :: 5 - Production/Stable",
"Environment :: Console",
"Intended Audience :: Developers",
"License :: OSI Approved :: Apache Software License",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Topic :: Software Development :: Compilers",
"Topic :: System :: Installation/Setup",
]
dependencies = [
"requests>=2.28.0",
]

[project.urls]
Homepage = "https://techscript.is-a.dev"
Repository = "https://github.com/Tcode-Motion/techscript"
Issues = "https://github.com/Tcode-Motion/techscript/issues"
Changelog = "https://github.com/Tcode-Motion/techscript/blob/main/CHANGELOG.md"

[project.scripts]
techscript = "techscript.__main__:main"

[tool.hatch.build.targets.wheel]
packages = ["techscript"]

[tool.hatch.build.targets.sdist]
include = [
"techscript/",
"tests/",
"README.md",
"LICENSE",
"pyproject.toml",
]

[project.optional-dependencies]
dev = ["build", "hatchling"]
17 changes: 17 additions & 0 deletions python-installer/techscript/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
"""
TechScript 2.0 — Official Python Installer / Bootstrapper

Detects your platform, downloads the correct native binary from GitHub Releases,
and installs the `tsc` compiler into the right location on your PATH.

Usage:
techscript install # Install or update the compiler
techscript install --force # Force reinstall
techscript uninstall # Remove the compiler
techscript version # Show installed version
techscript check # Check for updates
"""

__version__ = "2.0.0.1"
__author__ = "Tcode-Motion"
__repo__ = "https://github.com/Tcode-Motion/techscript"
Loading
Loading