curl-programming-lang 1.4.1__tar.gz → 1.4.2__tar.gz

{curl_programming_lang-1.4.1/curl_programming_lang.egg-info → curl_programming_lang-1.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: curl-programming-lang
-Version: 1.4.1
+Version: 1.4.2
 Summary: Curl is an open-source programming language built on Python technology
 Author: Ritvik Gautam
 License: Apache-2.0
@@ -47,9 +47,10 @@ git clone https://github.com/gautamritvik/Curl-Programming.git
 cd Curl-Programming
 pip install -e .
 ```
+
 ---
 
-## Running the Curl terminal
+## Running the Curl terminal (REPL)
 
 ```
 curlang
@@ -61,6 +62,15 @@ curlang
 curlang [YOUR-FILE].curl
 ```
 
+## CLI flags
+
+```
+curlang --version    show version
+curlang --license    show license
+curlang --credits    show credits
+curlang --help       show help
+```
+
 ---
 
 ## Syntax Reference
@@ -81,7 +91,7 @@ pcType{"Hello, " + var{name} + "!"}\
 Prompts the user for input. The result is accessed anywhere with `input{ans}`.
 
 ```
-pcAsk{"What is your name?">>}\
+pcAsk{"What is your name? >>"}\
 pcType{"You said: " + input{ans}}\
 ```
 
@@ -198,12 +208,51 @@ import{"math", m}\
 
 ### AI — `pcAI`
 
-*(Stub — reserved for future AI integration.)*
+`pcAI` is a **built-in AI module** — no import required. It supports conversation history, system prompts, and an interactive chat mode.
+
+Configure it with environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `CURL_AI_KEY` or `OPENAI_API_KEY` | *(none)* | Your API key |
+| `CURL_AI_BASE_URL` | `https://api.openai.com/v1` | API base URL |
+| `CURL_AI_MODEL` | `gpt-4o-mini` | Model name |
+
+Works with **OpenAI**, **OpenRouter**, **Ollama**, or any OpenAI-compatible API.
+
+**Ask a question:**
+
+```
+var{reply, pcAI.ask{"What is the capital of France?"}}\
+pcType{var{reply}}\
+```
+
+**Set a persona (system prompt):**
+
+```
+pcAI.context{"You are a friendly pirate who answers in rhymes."}\
+var{reply, pcAI.ask{"What is 2 + 2?"}}\
+pcType{var{reply}}\
+```
+
+**Interactive chat loop** (type `exit` to quit):
+
+```
+pcAI.chat{""}\
+```
+
+**Other methods:**
 
 ```
-pcAI{".on", "You are a helpful assistant", "profanityControl"}\
+var{s, pcAI.summarize{"some long text"}}\
+var{a, pcAI.analyze{"some data"}}\
+var{mood, pcAI.sentiment{"I love this!"}}\
+var{t, pcAI.translate{"Bonjour — translate to English"}}\
+pcAI.reset{""}\
 ```
 
+> Conversation history is kept across `pcAI.ask` calls and auto-compacts when it gets long.
+
 ---
 
 ## Symbols
@@ -221,6 +270,9 @@ pcAI{".on", "You are a helpful assistant", "profanityControl"}\
 | `!=` | Not equals |
 | `=` | Assignment |
 | `+` | Concatenation / addition |
+| `-` | Subtraction |
+| `*` | Multiplication |
+| `/` | Division |
 
 ---
 
@@ -246,6 +298,16 @@ func{sayBye}\
 
 ---
 
+## Example AI program
+
+```
+pcAI.context{"You are a helpful tutor."}\
+var{answer, pcAI.ask{"Explain what a variable is in one sentence."}}\
+pcType{var{answer}}\
+```
+
+---
+
 ## License
 
 This project is licensed under the Apache License 2.0 (OSI-approved).

{curl_programming_lang-1.4.1 → curl_programming_lang-1.4.2}/README.md

@@ -28,9 +28,10 @@ git clone https://github.com/gautamritvik/Curl-Programming.git
 cd Curl-Programming
 pip install -e .
 ```
+
 ---
 
-## Running the Curl terminal
+## Running the Curl terminal (REPL)
 
 ```
 curlang
@@ -42,6 +43,15 @@ curlang
 curlang [YOUR-FILE].curl
 ```
 
+## CLI flags
+
+```
+curlang --version    show version
+curlang --license    show license
+curlang --credits    show credits
+curlang --help       show help
+```
+
 ---
 
 ## Syntax Reference
@@ -62,7 +72,7 @@ pcType{"Hello, " + var{name} + "!"}\
 Prompts the user for input. The result is accessed anywhere with `input{ans}`.
 
 ```
-pcAsk{"What is your name?">>}\
+pcAsk{"What is your name? >>"}\
 pcType{"You said: " + input{ans}}\
 ```
 
@@ -179,12 +189,51 @@ import{"math", m}\
 
 ### AI — `pcAI`
 
-*(Stub — reserved for future AI integration.)*
+`pcAI` is a **built-in AI module** — no import required. It supports conversation history, system prompts, and an interactive chat mode.
+
+Configure it with environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `CURL_AI_KEY` or `OPENAI_API_KEY` | *(none)* | Your API key |
+| `CURL_AI_BASE_URL` | `https://api.openai.com/v1` | API base URL |
+| `CURL_AI_MODEL` | `gpt-4o-mini` | Model name |
+
+Works with **OpenAI**, **OpenRouter**, **Ollama**, or any OpenAI-compatible API.
+
+**Ask a question:**
+
+```
+var{reply, pcAI.ask{"What is the capital of France?"}}\
+pcType{var{reply}}\
+```
+
+**Set a persona (system prompt):**
+
+```
+pcAI.context{"You are a friendly pirate who answers in rhymes."}\
+var{reply, pcAI.ask{"What is 2 + 2?"}}\
+pcType{var{reply}}\
+```
+
+**Interactive chat loop** (type `exit` to quit):
+
+```
+pcAI.chat{""}\
+```
+
+**Other methods:**
 
 ```
-pcAI{".on", "You are a helpful assistant", "profanityControl"}\
+var{s, pcAI.summarize{"some long text"}}\
+var{a, pcAI.analyze{"some data"}}\
+var{mood, pcAI.sentiment{"I love this!"}}\
+var{t, pcAI.translate{"Bonjour — translate to English"}}\
+pcAI.reset{""}\
 ```
 
+> Conversation history is kept across `pcAI.ask` calls and auto-compacts when it gets long.
+
 ---
 
 ## Symbols
@@ -202,6 +251,9 @@ pcAI{".on", "You are a helpful assistant", "profanityControl"}\
 | `!=` | Not equals |
 | `=` | Assignment |
 | `+` | Concatenation / addition |
+| `-` | Subtraction |
+| `*` | Multiplication |
+| `/` | Division |
 
 ---
 
@@ -227,6 +279,16 @@ func{sayBye}\
 
 ---
 
+## Example AI program
+
+```
+pcAI.context{"You are a helpful tutor."}\
+var{answer, pcAI.ask{"Explain what a variable is in one sentence."}}\
+pcType{var{answer}}\
+```
+
+---
+
 ## License
 
 This project is licensed under the Apache License 2.0 (OSI-approved).

{curl_programming_lang-1.4.1 → curl_programming_lang-1.4.2}/ai_module.py

@@ -111,20 +111,18 @@ OTHER LANGUAGE BLOCKS:
       console.log("hi")
   }\\
 
-AI MODULE (import first):
-  import{"ai", ai}\\
-  ai.context{"You are a pirate."}\\   — set bot persona (resets history)
-  var{r, ai.ask{"What is 2+2?"}}\\    — ask a question (history kept)
+AI MODULE (built-in, no import needed):
+  pcAI.context{"You are a pirate."}\\   — set bot persona (resets history)
+  var{r, pcAI.ask{"What is 2+2?"}}\\    — ask a question (history kept)
   pcType{var{r}}\\
-  ai.chat{""}\\                        — start interactive chat loop (type exit to quit)
-  ai.reset{""}\\                       — clear conversation history
-  ai.summarize{"some long text"}\\
-  ai.analyze{"some data"}\\
-  ai.sentiment{"I love this!"}\\       — returns: positive / negative / neutral
-  ai.translate{"Bonjour to English"}\\
+  pcAI.chat{""}\\                        — start interactive chat loop (type exit to quit)
+  pcAI.reset{""}\\                       — clear conversation history
+  pcAI.summarize{"some long text"}\\
+  pcAI.analyze{"some data"}\\
+  pcAI.sentiment{"I love this!"}\\       — returns: positive / negative / neutral
+  pcAI.translate{"Bonjour to English"}\\
 
 IMPORTS:
-  import{"ai", ai}\\                   — built-in AI module
   import{"math", m}\\                  — any Python stdlib or installed package
 
 === END OF CURL REFERENCE ===

{curl_programming_lang-1.4.1 → curl_programming_lang-1.4.2/curl_programming_lang.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: curl-programming-lang
-Version: 1.4.1
+Version: 1.4.2
 Summary: Curl is an open-source programming language built on Python technology
 Author: Ritvik Gautam
 License: Apache-2.0
@@ -47,9 +47,10 @@ git clone https://github.com/gautamritvik/Curl-Programming.git
 cd Curl-Programming
 pip install -e .
 ```
+
 ---
 
-## Running the Curl terminal
+## Running the Curl terminal (REPL)
 
 ```
 curlang
@@ -61,6 +62,15 @@ curlang
 curlang [YOUR-FILE].curl
 ```
 
+## CLI flags
+
+```
+curlang --version    show version
+curlang --license    show license
+curlang --credits    show credits
+curlang --help       show help
+```
+
 ---
 
 ## Syntax Reference
@@ -81,7 +91,7 @@ pcType{"Hello, " + var{name} + "!"}\
 Prompts the user for input. The result is accessed anywhere with `input{ans}`.
 
 ```
-pcAsk{"What is your name?">>}\
+pcAsk{"What is your name? >>"}\
 pcType{"You said: " + input{ans}}\
 ```
 
@@ -198,12 +208,51 @@ import{"math", m}\
 
 ### AI — `pcAI`
 
-*(Stub — reserved for future AI integration.)*
+`pcAI` is a **built-in AI module** — no import required. It supports conversation history, system prompts, and an interactive chat mode.
+
+Configure it with environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `CURL_AI_KEY` or `OPENAI_API_KEY` | *(none)* | Your API key |
+| `CURL_AI_BASE_URL` | `https://api.openai.com/v1` | API base URL |
+| `CURL_AI_MODEL` | `gpt-4o-mini` | Model name |
+
+Works with **OpenAI**, **OpenRouter**, **Ollama**, or any OpenAI-compatible API.
+
+**Ask a question:**
+
+```
+var{reply, pcAI.ask{"What is the capital of France?"}}\
+pcType{var{reply}}\
+```
+
+**Set a persona (system prompt):**
+
+```
+pcAI.context{"You are a friendly pirate who answers in rhymes."}\
+var{reply, pcAI.ask{"What is 2 + 2?"}}\
+pcType{var{reply}}\
+```
+
+**Interactive chat loop** (type `exit` to quit):
+
+```
+pcAI.chat{""}\
+```
+
+**Other methods:**
 
 ```
-pcAI{".on", "You are a helpful assistant", "profanityControl"}\
+var{s, pcAI.summarize{"some long text"}}\
+var{a, pcAI.analyze{"some data"}}\
+var{mood, pcAI.sentiment{"I love this!"}}\
+var{t, pcAI.translate{"Bonjour — translate to English"}}\
+pcAI.reset{""}\
 ```
 
+> Conversation history is kept across `pcAI.ask` calls and auto-compacts when it gets long.
+
 ---
 
 ## Symbols
@@ -221,6 +270,9 @@ pcAI{".on", "You are a helpful assistant", "profanityControl"}\
 | `!=` | Not equals |
 | `=` | Assignment |
 | `+` | Concatenation / addition |
+| `-` | Subtraction |
+| `*` | Multiplication |
+| `/` | Division |
 
 ---
 
@@ -246,6 +298,16 @@ func{sayBye}\
 
 ---
 
+## Example AI program
+
+```
+pcAI.context{"You are a helpful tutor."}\
+var{answer, pcAI.ask{"Explain what a variable is in one sentence."}}\
+pcType{var{answer}}\
+```
+
+---
+
 ## License
 
 This project is licensed under the Apache License 2.0 (OSI-approved).

{curl_programming_lang-1.4.1 → curl_programming_lang-1.4.2}/interpreter.py

@@ -7,7 +7,7 @@ def execute(ast, env=None):
         env = {
             "variables": {},
             "functions": {},
-            "imports": {},
+            "imports": {"pcAI": CurlAIModule()},  # built-in, no import needed
             "last_input": None,
         }
     for stmt in ast:

{curl_programming_lang-1.4.1 → curl_programming_lang-1.4.2}/parser.py

@@ -82,6 +82,10 @@ class Parser:
         if token[0] == IDENTIFIER and self.peek() and self.peek()[0] == DOT:
             return self.parse_method_call_stmt()
 
+        # pcAI.method{arg}\  — built-in AI module, no import needed
+        if token[0] == KEYWORD and token[1] == "pcAI" and self.peek() and self.peek()[0] == DOT:
+            return self.parse_pcai_method_call_stmt()
+
         if token[0] != KEYWORD:
             raise SyntaxError(f"Expected a Curl keyword, got {token[0]} {repr(token[1])}")
 
@@ -217,6 +221,16 @@ class Parser:
         self.consume(LINE_END)
         return {"type": "method_call", "module": module, "method": method, "arg": arg}
 
+    def parse_pcai_method_call_stmt(self):
+        self.consume(KEYWORD, "pcAI")
+        self.consume(DOT)
+        method = self.consume(IDENTIFIER)[1]
+        self.consume(LBRACE)
+        arg = self.parse_concat_expr()
+        self.consume(RBRACE)
+        self.consume(LINE_END)
+        return {"type": "method_call", "module": "pcAI", "method": method, "arg": arg}
+
     def parse_import(self):
         self.consume(KEYWORD, "import")
         self.consume(LBRACE)
@@ -281,6 +295,16 @@ class Parser:
         if token[0] == KEYWORD:
             kw = token[1]
 
+            # pcAI.method{arg} as an expression — e.g. var{x, pcAI.ask{"prompt"}}\
+            if kw == "pcAI" and self.peek() and self.peek()[0] == DOT:
+                self.pos += 1  # consume pcAI
+                self.consume(DOT)
+                method = self.consume(IDENTIFIER)[1]
+                self.consume(LBRACE)
+                arg = self.parse_concat_expr()
+                self.consume(RBRACE)
+                return {"type": "method_call", "module": "pcAI", "method": method, "arg": arg}
+
             if kw == "var":
                 self.pos += 1
                 self.consume(LBRACE)

{curl_programming_lang-1.4.1 → curl_programming_lang-1.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "curl-programming-lang"
-version = "1.4.1"
+version = "1.4.2"
 description = "Curl is an open-source programming language built on Python technology"
 readme = "README.md"
 requires-python = ">=3.7"