chemql-python 1.3.2__tar.gz → 1.4.0__tar.gz

{chemql_python-1.3.2/src/chemql_python.egg-info → chemql_python-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chemql-python
-Version: 1.3.2
+Version: 1.4.0
 Summary: A chemistry-focused query language and REPL
 Author-email: Mohammad Rakibul Islam <rakibulofficial1017@gmail.com>
 Requires-Python: >=3.10
@@ -19,7 +19,7 @@ SQL-inspired syntax, inspect elements and molecules, look up reactions,
 balance equations, and combine chemistry queries with Python and shell
 commands.
 
--   **Version:** `1.3.2`
+-   **Version:** `1.4.0`
 -   **PyPI distribution:** `chemql-python`
 -   **Python import / CLI name:** `chemql`
 -   **Author:** Mohammad Rakibul Islam
@@ -41,6 +41,9 @@ commands.
 -   [Functions, definitions, and
     macros](#functions-definitions-and-macros)
 -   [Structs and records](#structs-and-records)
+-   [Namespaces](#namespaces)
+-   [Standard library](#standard-library)
+-   [Built-in help](#built-in-help)
 -   [Shell integration and scripting](#shell-integration-and-scripting)
 -   [CLI options and history export](#cli-options-and-history-export)
 -   [Python API](#python-api)
@@ -644,11 +647,9 @@ command lists definitions in the current session.
 
 ## Structs and records
 
-ChemQL v1.3.0 includes named structured values, constructors, variables,
-and user-defined methods. This area is evolving; test advanced method
-dispatch and operator overloading in the exact build you use.
+ChemQL v1.4.0 allows required fields defined by a trailing exclamation mark `!` or the `required` keyword
 
-``` text
+```text
 struct Fruit
     name
     price
@@ -658,6 +659,18 @@ let apple = Fruit{name="Apple", price=35}
 apple
 apple.name
 apple.price
+let orange = Fruit{"Orange", 20} // you can use position rather than just keyword arguments
+let banana = Fruit{"Banana", price = 10} // or you can even mix
+
+```
+```text
+struct Vegetable
+    name!
+    required weight
+    price
+endstruct
+
+let apple = Vegetable{name="Carrot"} //this gives an error
 ```
 
 The implementation also supports defining methods on structured types.
@@ -665,6 +678,80 @@ Special methods such as `__add__` are intended for custom behaviour, but
 do not assume every Python data-model feature or operator dispatch path
 is fully implemented.
 
+## Namespaces
+
+Namespaces store functions, structs, records, variables, etc.
+
+To declare functions accessible in the global scope you must use the `public` keyword, everything is private by default, you may still add the `private` keyword for fun
+Example
+```text
+namespace math
+    public let PI = 3.14159265358979
+    public let E = 2.718281828459045
+    public 
+
+
+```
+
+## Standard library
+
+ChemQL loads reusable `.cql` packages with `load`. The loader searches the current
+directory and then the interpreter's adjacent `stdlib/` directory. Preserve the
+folder structure when extracting `chemql_stdlib.zip`.
+
+| Package | Purpose |
+| --- | --- |
+| `math` | `PI`, `E`, trigonometry, logarithms, factorial, `gcd`, `lcm`, and more |
+| `math::statistics` | `mean`, `median`, `mode`, `variance`, `stdev`, and quantiles |
+| `text` | String casing, trimming, splitting/joining, substring and regex helpers |
+| `collections` | `unique`, `flatten`, `zip`, `pairwise`, frequency counts, product |
+| `datetime` | Current date/time, ISO dates, timestamps, weekday and date arithmetic |
+| `json` | JSON serialization, pretty serialization, parsing and type inspection |
+
+```chemql
+load math
+math::sqrt{81}
+math::sin{math::radians{30}}
+
+load math::statistics
+math::statistics::mean{2, 4, 6}
+
+load text
+text::upper{"hello"}
+text::split{"red,green,blue", ","}
+text::regex_findall{"[A-Z][a-z]+", "Water and Sodium Chloride"}
+
+load collections
+collections::unique{1, 2, 1, 3}
+collections::frequencies{"red", "blue", "red"}
+
+load datetime
+datetime::date{2026, 10, 20}
+datetime::date_add_days{"2026-10-20", 7}
+
+load json
+json::loads{"{\"formula\": \"H2O\"}"}
+```
+
+These packages use Python's standard library only; they add no third-party dependencies.
+
+## Built-in help
+
+The help system includes a general index and topic/function pages:
+
+```chemql
+help
+help{read_csv}
+help{TooFewArguments}
+help{syntax}
+help{errors}
+help{files}
+help{chemistry}
+```
+
+Use `help{function_name}` for built-in documentation. The ANSI-colored help screen
+also includes a quick reference to the standard-library packages.
+
 ## Shell integration and scripting
 
 Backticks execute a command through the host system shell:

{chemql_python-1.3.2 → chemql_python-1.4.0}/README.md

@@ -6,7 +6,7 @@ SQL-inspired syntax, inspect elements and molecules, look up reactions,
 balance equations, and combine chemistry queries with Python and shell
 commands.
 
--   **Version:** `1.3.2`
+-   **Version:** `1.4.0`
 -   **PyPI distribution:** `chemql-python`
 -   **Python import / CLI name:** `chemql`
 -   **Author:** Mohammad Rakibul Islam
@@ -28,6 +28,9 @@ commands.
 -   [Functions, definitions, and
     macros](#functions-definitions-and-macros)
 -   [Structs and records](#structs-and-records)
+-   [Namespaces](#namespaces)
+-   [Standard library](#standard-library)
+-   [Built-in help](#built-in-help)
 -   [Shell integration and scripting](#shell-integration-and-scripting)
 -   [CLI options and history export](#cli-options-and-history-export)
 -   [Python API](#python-api)
@@ -631,11 +634,9 @@ command lists definitions in the current session.
 
 ## Structs and records
 
-ChemQL v1.3.0 includes named structured values, constructors, variables,
-and user-defined methods. This area is evolving; test advanced method
-dispatch and operator overloading in the exact build you use.
+ChemQL v1.4.0 allows required fields defined by a trailing exclamation mark `!` or the `required` keyword
 
-``` text
+```text
 struct Fruit
     name
     price
@@ -645,6 +646,18 @@ let apple = Fruit{name="Apple", price=35}
 apple
 apple.name
 apple.price
+let orange = Fruit{"Orange", 20} // you can use position rather than just keyword arguments
+let banana = Fruit{"Banana", price = 10} // or you can even mix
+
+```
+```text
+struct Vegetable
+    name!
+    required weight
+    price
+endstruct
+
+let apple = Vegetable{name="Carrot"} //this gives an error
 ```
 
 The implementation also supports defining methods on structured types.
@@ -652,6 +665,80 @@ Special methods such as `__add__` are intended for custom behaviour, but
 do not assume every Python data-model feature or operator dispatch path
 is fully implemented.
 
+## Namespaces
+
+Namespaces store functions, structs, records, variables, etc.
+
+To declare functions accessible in the global scope you must use the `public` keyword, everything is private by default, you may still add the `private` keyword for fun
+Example
+```text
+namespace math
+    public let PI = 3.14159265358979
+    public let E = 2.718281828459045
+    public 
+
+
+```
+
+## Standard library
+
+ChemQL loads reusable `.cql` packages with `load`. The loader searches the current
+directory and then the interpreter's adjacent `stdlib/` directory. Preserve the
+folder structure when extracting `chemql_stdlib.zip`.
+
+| Package | Purpose |
+| --- | --- |
+| `math` | `PI`, `E`, trigonometry, logarithms, factorial, `gcd`, `lcm`, and more |
+| `math::statistics` | `mean`, `median`, `mode`, `variance`, `stdev`, and quantiles |
+| `text` | String casing, trimming, splitting/joining, substring and regex helpers |
+| `collections` | `unique`, `flatten`, `zip`, `pairwise`, frequency counts, product |
+| `datetime` | Current date/time, ISO dates, timestamps, weekday and date arithmetic |
+| `json` | JSON serialization, pretty serialization, parsing and type inspection |
+
+```chemql
+load math
+math::sqrt{81}
+math::sin{math::radians{30}}
+
+load math::statistics
+math::statistics::mean{2, 4, 6}
+
+load text
+text::upper{"hello"}
+text::split{"red,green,blue", ","}
+text::regex_findall{"[A-Z][a-z]+", "Water and Sodium Chloride"}
+
+load collections
+collections::unique{1, 2, 1, 3}
+collections::frequencies{"red", "blue", "red"}
+
+load datetime
+datetime::date{2026, 10, 20}
+datetime::date_add_days{"2026-10-20", 7}
+
+load json
+json::loads{"{\"formula\": \"H2O\"}"}
+```
+
+These packages use Python's standard library only; they add no third-party dependencies.
+
+## Built-in help
+
+The help system includes a general index and topic/function pages:
+
+```chemql
+help
+help{read_csv}
+help{TooFewArguments}
+help{syntax}
+help{errors}
+help{files}
+help{chemistry}
+```
+
+Use `help{function_name}` for built-in documentation. The ANSI-colored help screen
+also includes a quick reference to the standard-library packages.
+
 ## Shell integration and scripting
 
 Backticks execute a command through the host system shell:

{chemql_python-1.3.2 → chemql_python-1.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "chemql-python"
-version = "1.3.2"
+version = "1.4.0"
 authors = [
     { name = "Mohammad Rakibul Islam", email = "rakibulofficial1017@gmail.com" }
 ]
@@ -28,4 +28,12 @@ package-dir = {"" = "src"}
 where = ["src"]
 
 [tool.setuptools.package-data]
-chemql = ["data/*.json", "data/THIRD_PARTY_LICENSES/*.txt", "html/*.html"]
+chemql = [
+    "data/*.json",
+    "data/THIRD_PARTY_LICENSES/*.txt",
+    "html/*.html",
+    "stdlib/**/*.cql",
+    "stdlib/*.cql",
+    "stdlib/**/*.md",
+    "stdlib/*.md",
+]