coconut-develop 3.2.0.post0.dev9__tar.gz → 3.2.0.post0.dev12__tar.gz

{coconut_develop-3.2.0.post0.dev9 → coconut_develop-3.2.0.post0.dev12}/.claude/settings.local.json

@@ -13,16 +13,21 @@
       "Bash(python3:*)",
       "Bash(gh:*)",
       "Bash(pip:*)",
-      "Bash(conda:*)",
-      "Bash(xonsh:*)",
-      "Bash(make test-tests:*)",
-      "WebFetch(domain:coconut.readthedocs.io)",
+      "Bash(log \")",
+      "Bash(test:*)",
+      "Bash(done)",
       "WebFetch(domain:github.com)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "WebFetch(domain:gist.github.com)",
+      "WebFetch(domain:coconut.readthedocs.io)",
       "WebFetch(domain:peps.python.org)",
       "WebFetch(domain:pypi.org)",
       "WebFetch(domain:discuss.python.org)",
       "WebFetch(domain:doc.pypy.org)",
-      "WebFetch(domain:raw.githubusercontent.com)"
+      "Bash(git status:*)",
+      "Bash(make test-tests:*)",
+      "Bash(conda:*)",
+      "Bash(xonsh:*)"
     ]
   }
 }

{coconut_develop-3.2.0.post0.dev9 → coconut_develop-3.2.0.post0.dev12}/DOCS.md

@@ -1165,7 +1165,7 @@ depth: 1
 
 Coconut provides fully-featured, functional pattern-matching through its `match` statements. Coconut `match` syntax is a strict superset of [Python's `match` syntax](https://peps.python.org/pep-0636/).
 
-_Note: In describing Coconut's pattern-matching syntax, this section focuses on `match` statements, but Coconut's pattern-matching can also be used in many other places, such as [pattern-matching function definition](#pattern-matching-functions), [`case` statements](#case), [destructuring assignment](#destructuring-assignment), [`match data`](#match-data), and [`match for`](#match-for)._
+_Note: In describing Coconut's pattern-matching syntax, this section focuses on `match` statements, but Coconut's pattern-matching can also be used in many other places, such as [pattern-matching function definition](#pattern-matching-functions), [`case` statements](#case), [destructuring assignment](#destructuring-assignment), [`match data`](#match-data), [`match for`](#match-for), and [match comprehensions](#match-comprehensions)._
 
 ##### Overview
 
@@ -1743,6 +1743,37 @@ async with my_generator() as agen:
 ```
 
 
+### `lazy import`
+
+Coconut supports [PEP 810](https://peps.python.org/pep-0810/) lazy import syntax on all Python versions. Lazy imports defer module loading until the imported name is first used, rather than executing the import immediately. This can improve startup time and reduce memory usage, especially in modules with large dependency graphs.
+
+Coconut supports all standard lazy import forms:
+```coconut
+lazy import module_name
+lazy import module_name as alias
+lazy from module import name
+lazy from module import name as alias
+lazy from module import name1, name2
+```
+
+When a lazy import is encountered, Coconut creates a proxy object instead of immediately loading the module. The actual import only occurs when the name is first accessed (e.g. by accessing an attribute). Import errors are also deferred—if the module doesn't exist, the `ImportError` will be raised at the point of first use, not at the import statement.
+
+##### Example
+
+**Coconut:**
+```coconut
+lazy import json
+lazy from collections import OrderedDict
+
+# json is not loaded yet
+data = json.dumps({"key": "value"})  # json is loaded here
+od = OrderedDict()  # collections is loaded here
+```
+
+**Python:**
+_Only supported on Python 3.15+._
+
+
 ### Handling Keyword/Variable Name Overlap
 
 In Coconut, the following keywords are also valid variable names:
@@ -2214,6 +2245,41 @@ _General showcase of how the different concatenation operators work using `numpy
 **Python:** _The equivalent Python array literals can be seen in the printed representations in each example._
 
 
+### Match Comprehensions
+
+Coconut supports [pattern-matching](#match) in comprehensions, where the pattern is matched against each item in the iterable. The syntax is
+```coconut
+[<expr> [match] for <pattern> in <iterable>]
+```
+which is equivalent to
+```coconut
+[(def (<pattern>) => <expr>)(item) for item in <iterable>]
+```
+
+The `match` keyword is optional, just as in [`match for`](#match-for) loops. Match comprehensions work with all comprehension types: list, set, dict, and generator comprehensions. If the pattern does not match an element, a [`MatchError`](#matcherror) is raised.
+
+##### Example
+
+**Coconut:**
+```coconut
+data Pair(a, b)
+pairs = [Pair(1, 2), Pair(3, 4)]
+result = [a + b for Pair(a, b) in pairs]
+```
+
+**Python:**
+```python
+# using coconut's Pair data type
+result = []
+for p in pairs:
+    match p:
+        case Pair(a, b):
+            result.append(a + b)
+        case _:
+            raise MatchError(...)
+```
+
+
 ### Lazy Lists
 
 Coconut supports the creation of lazy lists, where the contents in the list will be treated as an iterator and not evaluated until they are needed. Unlike normal iterators, however, lazy lists can be iterated over multiple times and still return the same result. Lazy lists can be created in Coconut simply by surrounding a comma-separated list of items with `(|` and `|)` (so-called "banana brackets") instead of `[` and `]` for a list or `(` and `)` for a tuple.

{coconut_develop-3.2.0.post0.dev9 → coconut_develop-3.2.0.post0.dev12}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: coconut-develop
-Version: 3.2.0.post0.dev9
+Version: 3.2.0.post0.dev12
 Summary: Simple, elegant, Pythonic functional programming.
 Home-page: http://coconut-lang.org
 Author: Evan Hubinger
 Author-email: evanjhub@gmail.com
 License: Apache-2.0
-Keywords: functional,programming,language,compiler,pattern,pattern-matching,algebraic,data type,data types,lambda,lambdas,lazy,evaluation,lazy list,lazy lists,tail,recursion,call,recursive,recursive_iterator,infix,function,composition,compose,partial,application,currying,curry,pipeline,pipe,unicode,operator,operators,frozenset,literal,syntax,destructuring,assignment,fold,datamaker,prepattern,iterator,generator,none,coalesce,coalescing,statement,lru_cache,memoization,backport,typing,embed,PEP 622,overrides,islice,itertools,functools,TYPE_CHECKING,Expected,breakpoint,help,reduce,takewhile,dropwhile,tee,count,makedata,consume,process_map,thread_map,addpattern,recursive_generator,fmap,starmap,reiterable,scan,groupsof,memoize,zip_longest,override,flatten,ident,call,safe_call,flip,const,lift,lift_apart,all_equal,collectby,mapreduce,multi_enumerate,cartesian_product,multiset,cycle,windowsof,and_then,and_then_await,async_map,py_chr,py_dict,py_hex,py_input,py_int,py_map,py_object,py_oct,py_open,py_print,py_range,py_str,py_super,py_zip,py_filter,py_reversed,py_enumerate,py_raw_input,py_xrange,py_repr,py_breakpoint,py_min,py_max,_namedtuple_of,reveal_type,reveal_locals,MatchError,CoconutWarning,__fmap__,__iter_getitem__,data,match,case,cases,where,final,addpattern,then,operator,type,copyclosure,λ
+Keywords: functional,programming,language,compiler,pattern,pattern-matching,algebraic,data type,data types,lambda,lambdas,evaluation,lazy list,lazy lists,tail,recursion,call,recursive,recursive_iterator,infix,function,composition,compose,partial,application,currying,curry,pipeline,pipe,unicode,operator,operators,frozenset,literal,syntax,destructuring,assignment,fold,datamaker,prepattern,iterator,generator,none,coalesce,coalescing,statement,lru_cache,memoization,backport,typing,embed,PEP 622,overrides,islice,itertools,functools,TYPE_CHECKING,Expected,breakpoint,help,reduce,takewhile,dropwhile,tee,count,makedata,consume,process_map,thread_map,addpattern,recursive_generator,fmap,starmap,reiterable,scan,groupsof,memoize,zip_longest,override,flatten,ident,call,safe_call,flip,const,lift,lift_apart,all_equal,collectby,mapreduce,multi_enumerate,cartesian_product,multiset,cycle,windowsof,and_then,and_then_await,async_map,py_chr,py_dict,py_hex,py_input,py_int,py_map,py_object,py_oct,py_open,py_print,py_range,py_str,py_super,py_zip,py_filter,py_reversed,py_enumerate,py_raw_input,py_xrange,py_repr,py_breakpoint,py_min,py_max,_namedtuple_of,reveal_type,reveal_locals,MatchError,CoconutWarning,__fmap__,__iter_getitem__,data,match,case,cases,where,final,addpattern,then,operator,type,copyclosure,lazy,λ
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development
@@ -220,27 +220,6 @@ Requires-Dist: pytest>=7; (python_version >= "3.6" and python_version < "3.8") a
 Requires-Dist: pytest<8.1,>=8.0; python_version >= "3.8" and extra == "tests"
 Requires-Dist: pexpect>=4; extra == "tests"
 Requires-Dist: pytest_remotedata>=0.3; extra == "tests"
-Requires-Dist: ipython>=5.4; python_version < "3" and extra == "tests"
-Requires-Dist: ipython<7.10,>=7.9; (python_version >= "3" and python_version < "3.7") and extra == "tests"
-Requires-Dist: ipython>=7.34; (python_version >= "3.7" and python_version < "3.8") and extra == "tests"
-Requires-Dist: ipython>=8.12; (python_version >= "3.8" and python_version < "3.9") and extra == "tests"
-Requires-Dist: ipython>=8.18; (python_version >= "3.9" and python_version < "3.11") and extra == "tests"
-Requires-Dist: ipython>=9; python_version >= "3.11" and extra == "tests"
-Requires-Dist: ipykernel>=4.10; python_version < "3" and extra == "tests"
-Requires-Dist: ipykernel>=5.5; (python_version >= "3" and python_version < "3.8") and extra == "tests"
-Requires-Dist: ipykernel>=6; (python_version >= "3.8" and python_version < "3.10") and extra == "tests"
-Requires-Dist: ipykernel>=7; python_version >= "3.10" and extra == "tests"
-Requires-Dist: jupyter-client>=5.3; python_version < "3.5" and extra == "tests"
-Requires-Dist: jupyter-client<6.1.13,>=6.1.12; (python_version >= "3.5" and python_version < "3.6") and extra == "tests"
-Requires-Dist: jupyter-client>=7.1.2; python_version >= "3.6" and extra == "tests"
-Requires-Dist: jedi<0.18,>=0.17; python_version < "3.9" and extra == "tests"
-Requires-Dist: jedi>=0.19; python_version >= "3.9" and extra == "tests"
-Requires-Dist: pywinpty<0.6,>=0.5; (python_version < "3" and os_name == "nt") and extra == "tests"
-Requires-Dist: jupyter>=1.1; extra == "tests"
-Requires-Dist: jupyter-console>=5.2; python_version < "3.5" and extra == "tests"
-Requires-Dist: jupyter-console>=6.1; (python_version >= "3.5" and python_version < "3.7") and extra == "tests"
-Requires-Dist: jupyter-console>=6.6; python_version >= "3.7" and extra == "tests"
-Requires-Dist: papermill>=1.2; extra == "tests"
 Provides-Extra: dev
 Requires-Dist: ipython>=5.4; python_version < "3" and extra == "dev"
 Requires-Dist: ipython<7.10,>=7.9; (python_version >= "3" and python_version < "3.7") and extra == "dev"

{coconut_develop-3.2.0.post0.dev9 → coconut_develop-3.2.0.post0.dev12}/__coconut__/__init__.pyi

@@ -89,6 +89,9 @@ try:
 except ImportError:
     def _deprecated(message: _t.Text) -> _t.Callable[[_T], _T]: ...  # type: ignore
 
+import importlib as _importlib
+_coconut_lazy_module = _importlib.import_module
+
 import _coconut as __coconut  # we mock _coconut as a package since mypy doesn't handle namespace classes very well
 _coconut = __coconut
 

{coconut_develop-3.2.0.post0.dev9 → coconut_develop-3.2.0.post0.dev12}/_coconut/__init__.pyi

@@ -147,6 +147,7 @@ any = _builtins.any
 bool = _builtins.bool
 bytes = _builtins.bytes
 dict = _builtins.dict
+dir = _builtins.dir
 enumerate = _builtins.enumerate
 filter = _builtins.filter
 float = _builtins.float

{coconut_develop-3.2.0.post0.dev9 → coconut_develop-3.2.0.post0.dev12}/coconut/__coconut__.pyi

@@ -1,2 +1,2 @@
 from __coconut__ import *
-from __coconut__ import _coconut_tail_call, _coconut_tco, _coconut_call_set_names, _coconut_handle_cls_kwargs, _coconut_handle_cls_stargs, _namedtuple_of, _coconut, _coconut_Expected, _coconut_MatchError, _coconut_SupportsAdd, _coconut_SupportsMinus, _coconut_SupportsMul, _coconut_SupportsPow, _coconut_SupportsTruediv, _coconut_SupportsFloordiv, _coconut_SupportsMod, _coconut_SupportsAnd, _coconut_SupportsXor, _coconut_SupportsOr, _coconut_SupportsLshift, _coconut_SupportsRshift, _coconut_SupportsMatmul, _coconut_SupportsInv, _coconut_Expected, _coconut_MatchError, _coconut_iter_getitem, _coconut_base_compose, _coconut_forward_compose, _coconut_back_compose, _coconut_forward_star_compose, _coconut_back_star_compose, _coconut_forward_dubstar_compose, _coconut_back_dubstar_compose, _coconut_pipe, _coconut_star_pipe, _coconut_dubstar_pipe, _coconut_back_pipe, _coconut_back_star_pipe, _coconut_back_dubstar_pipe, _coconut_none_pipe, _coconut_none_star_pipe, _coconut_none_dubstar_pipe, _coconut_bool_and, _coconut_bool_or, _coconut_none_coalesce, _coconut_minus, _coconut_map, _coconut_partial, _coconut_complex_partial, _coconut_get_function_match_error, _coconut_base_pattern_func, _coconut_addpattern, _coconut_sentinel, _coconut_assert, _coconut_raise, _coconut_mark_as_match, _coconut_reiterable, _coconut_self_match_types, _coconut_dict_merge, _coconut_exec, _coconut_comma_op, _coconut_arr_concat_op, _coconut_mk_anon_namedtuple, _coconut_matmul, _coconut_py_str, _coconut_flatten, _coconut_multiset, _coconut_back_none_pipe, _coconut_back_none_star_pipe, _coconut_back_none_dubstar_pipe, _coconut_forward_none_compose, _coconut_back_none_compose, _coconut_forward_none_star_compose, _coconut_back_none_star_compose, _coconut_forward_none_dubstar_compose, _coconut_back_none_dubstar_compose, _coconut_call_or_coefficient, _coconut_in, _coconut_not_in, _coconut_attritemgetter, _coconut_if_op, _coconut_CoconutWarning
+from __coconut__ import _coconut_tail_call, _coconut_tco, _coconut_call_set_names, _coconut_handle_cls_kwargs, _coconut_handle_cls_stargs, _namedtuple_of, _coconut, _coconut_Expected, _coconut_MatchError, _coconut_SupportsAdd, _coconut_SupportsMinus, _coconut_SupportsMul, _coconut_SupportsPow, _coconut_SupportsTruediv, _coconut_SupportsFloordiv, _coconut_SupportsMod, _coconut_SupportsAnd, _coconut_SupportsXor, _coconut_SupportsOr, _coconut_SupportsLshift, _coconut_SupportsRshift, _coconut_SupportsMatmul, _coconut_SupportsInv, _coconut_Expected, _coconut_MatchError, _coconut_iter_getitem, _coconut_base_compose, _coconut_forward_compose, _coconut_back_compose, _coconut_forward_star_compose, _coconut_back_star_compose, _coconut_forward_dubstar_compose, _coconut_back_dubstar_compose, _coconut_pipe, _coconut_star_pipe, _coconut_dubstar_pipe, _coconut_back_pipe, _coconut_back_star_pipe, _coconut_back_dubstar_pipe, _coconut_none_pipe, _coconut_none_star_pipe, _coconut_none_dubstar_pipe, _coconut_bool_and, _coconut_bool_or, _coconut_none_coalesce, _coconut_minus, _coconut_map, _coconut_partial, _coconut_complex_partial, _coconut_get_function_match_error, _coconut_base_pattern_func, _coconut_addpattern, _coconut_sentinel, _coconut_assert, _coconut_raise, _coconut_mark_as_match, _coconut_reiterable, _coconut_self_match_types, _coconut_dict_merge, _coconut_exec, _coconut_comma_op, _coconut_arr_concat_op, _coconut_mk_anon_namedtuple, _coconut_matmul, _coconut_py_str, _coconut_flatten, _coconut_multiset, _coconut_back_none_pipe, _coconut_back_none_star_pipe, _coconut_back_none_dubstar_pipe, _coconut_forward_none_compose, _coconut_back_none_compose, _coconut_forward_none_star_compose, _coconut_back_none_star_compose, _coconut_forward_none_dubstar_compose, _coconut_back_none_dubstar_compose, _coconut_call_or_coefficient, _coconut_in, _coconut_not_in, _coconut_attritemgetter, _coconut_if_op, _coconut_CoconutWarning, _coconut_lazy_module