lam-cli 0.1.7__py3-none-any.whl → 1.0.0__py3-none-any.whl

lam/utils.py

@@ -0,0 +1,22 @@
+import json
+import logging
+import os
+from typing import Optional, Tuple
+
+logger = logging.getLogger(__name__)
+
+
+def process_input(input: str) -> Tuple[str, Optional[str]]:
+    """Process and validate input data"""
+    if os.path.isfile(input):
+        logger.debug("Loading input from file: %s", input)
+        with open(input, 'r') as file:
+            return file.read(), None
+            
+    try:
+        json.loads(input)
+        logger.debug("Validated inline JSON input")
+        return input, None
+    except json.JSONDecodeError as e:
+        logger.error("Invalid JSON input: %s", str(e))
+        return str(e), None

lam_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: lam-cli
+Version: 1.0.0
+Summary: Secure data transformation tool supporting JQ and JavaScript (Bun)
+Home-page: https://github.com/laminar-run/lam
+Author: Laminar Run, Inc.
+Author-email: connect@laminar.run
+License: GPLv3
+Project-URL: Documentation, https://docs.laminar.run
+Project-URL: Source, https://github.com/laminar-run/lam
+Project-URL: Issue Tracker, https://github.com/laminar-run/lam/issues
+Keywords: laminar,api,integration,transformation,json,jq,javascript,bun
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: backoff>=2.2.1
+Requires-Dist: certifi>=2024.12.14
+Requires-Dist: charset-normalizer>=3.3.2
+Requires-Dist: click>=8.1.7
+Requires-Dist: idna>=3.7
+Requires-Dist: logtail-python>=0.2.2
+Requires-Dist: monotonic>=1.6
+Requires-Dist: msgpack>=1.0.8
+Requires-Dist: posthog>=3.4.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: requests>=2.32.3
+Requires-Dist: six>=1.16.0
+Requires-Dist: urllib3>=2.2.2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# LAM
+LAM is a data transformation tool designed for Laminar's API integration platform.
+
+## Overview
+LAM enables you to write efficient transformations for your API data using either JavaScript (Bun) or Python. It's designed to be secure, fast, and easy to integrate into your Laminar workflows.
+
+## Features
+- **Dual Engine Support**: Choose between JavaScript (Bun runtime) for fast execution or Python for complex data processing
+- **Built-in Libraries**: Access lodash and date-fns in JavaScript, comprehensive Python standard library modules
+- **Security**: Runs in sandboxed environments with strict resource limits and security restrictions
+- **Performance**: Uses Bun runtime for JavaScript and sandboxed Python interpreter
+- **Monitoring**: Built-in execution statistics and error tracking
+
+## Execution Environments
+
+### Bun JavaScript Runtime (js)
+**Configuration**:
+- **Engine**: Bun
+- **Timeout**: 5 seconds
+- **Execution**: Isolated with `--no-fetch --smol --silent` flags
+- **Storage**: No localStorage/sessionStorage support
+- **Modules**: Shared node_modules directory
+
+**Available Libraries**:
+- **lodash** (^4.17.21): Utility library for array/object manipulation, data transformations (Global: `_`)
+- **date-fns** (^2.30.0): Modern date utility library with `format`, `parseISO` functions
+
+**Transform Function Signature**:
+```js
+(input) => { /* transform logic */ return result; }
+```
+
+### Python Interpreter with Sandboxing (py)
+**Configuration**:
+- **Engine**: Python interpreter
+- **Timeout**: 5 seconds
+- **Memory Limit**: 100MB
+- **CPU Limit**: 5 seconds (RLIMIT_CPU)
+- **Virtual Memory**: 100MB (RLIMIT_AS)
+- **Execution**: Isolated with `-I` flag (ignores environment/site packages)
+
+**Security Restrictions**:
+- **Blocked Modules**: subprocess, sys, os, shutil, pathlib, importlib, builtins, _thread, ctypes, socket, pickle, multiprocessing
+- **Blocked Functions**: __import__, eval, exec, globals, locals, getattr, setattr, delattr, compile, open
+- **Blocked Patterns**: __subclasses__, dunder attributes access
+
+**Available Standard Library Modules**:
+- **json**: JSON encoder and decoder
+- **datetime**: Date and time handling
+- **time**: Time-related functions
+- **math**: Mathematical functions and constants
+- **statistics**: Statistical functions (mean, median, mode, standard deviation)
+- **collections**: Counter, defaultdict, OrderedDict, deque
+- **itertools**: Efficient looping, combinations, permutations
+- **functools**: reduce, partial, lru_cache
+- **re**: Regular expression operations
+- **copy**: Shallow and deep copy operations
+- **decimal**: Precise decimal calculations
+- **csv**: CSV file reading and writing
+- **io**: StringIO, BytesIO for in-memory files
+- **dataclasses**: Data classes for storing data
+- **typing**: Type hints support
+- **enum**: Support for enumerations
+- **random**: Random number generation
+- **uuid**: UUID generation
+- **hashlib**: Secure hash and message digest algorithms
+- **base64**: Base64 encoding and decoding
+- **urllib**: URL handling modules
+- **urllib.parse**: URL parsing utilities
+- **html**: HTML processing utilities
+- **xml**: XML processing
+- **xml.etree**: XML ElementTree API
+- **xml.etree.ElementTree**: XML parsing and creation
+- **string**: String constants and classes
+- **textwrap**: Text wrapping and filling
+- **operator**: Standard operators as functions
+- **bisect**: Array bisection algorithm
+- **heapq**: Heap queue algorithm
+- **array**: Efficient arrays of numeric values
+- **unicodedata**: Unicode character database
+- **locale**: Internationalization services
+- **calendar**: Calendar-related functions
+- **zoneinfo**: Time zone support (Python 3.9+)
+- **struct**: Pack and unpack binary data
+- **binascii**: Binary/ASCII conversions
+- **codecs**: Encode and decode data
+- **difflib**: Sequence comparison utilities
+- **pprint**: Pretty-printer for data structures
+- **reprlib**: Alternate repr() implementation
+- **abc**: Abstract base classes
+- **contextlib**: Context management utilities
+- **secrets**: Cryptographically secure random numbers
+- **fractions**: Rational numbers
+- **numbers**: Numeric abstract base classes
+
+**Safe Built-in Functions**:
+`abs`, `all`, `any`, `bool`, `chr`, `dict`, `divmod`, `enumerate`, `filter`, `float`, `format`, `frozenset`, `hash`, `hex`, `int`, `isinstance`, `issubclass`, `iter`, `len`, `list`, `map`, `max`, `min`, `next`, `oct`, `ord`, `pow`, `print`, `range`, `repr`, `reversed`, `round`, `set`, `slice`, `sorted`, `str`, `sum`, `tuple`, `type`, `zip`
+
+**Transform Function Signature**:
+```py
+def transform(input_data):
+    # transform logic
+    return result
+```
+
+## Examples
+
+### JavaScript (Bun) Transformations
+Perfect for fast data manipulation with familiar syntax:
+
+```javascript
+(input) => {
+    // Use lodash for data manipulation
+    const processed = _.map(input.data, item => ({
+        id: item.id,
+        formattedDate: format(parseISO(item.date), 'MMM dd, yyyy'),
+        value: item.value * 2
+    }));
+
+    return {
+        processed,
+        summary: {
+            total: _.sumBy(processed, 'value'),
+            count: processed.length
+        }
+    };
+}
+```
+
+### Python Transformations
+Ideal for complex data processing and statistical analysis:
+
+```python
+def transform(input_data):
+    import statistics
+    from collections import Counter
+    
+    # Process numerical data
+    values = [item["value"] for item in input_data["data"] if "value" in item]
+    
+    return {
+        "statistics": {
+            "mean": statistics.mean(values) if values else 0,
+            "median": statistics.median(values) if values else 0,
+            "count": len(values)
+        },
+        "frequency": dict(Counter(item["category"] for item in input_data["data"])),
+        "processedAt": datetime.now().isoformat()
+    }
+```
+
+## Integration with Laminar
+LAM is designed to work seamlessly with Laminar's integration platform:
+
+1. **Flows**: Add data transformations to your API flows
+2. **Automation**: Schedule and automate data processing
+3. **Monitoring**: Track execution statistics and errors
+
+## Getting Started
+
+### Using LAM in Laminar
+1. Create a new flow in [Laminar](https://app.laminar.run)
+2. Add a transformation step
+3. Choose your engine (JavaScript or Python)
+4. Write your transformation function
+5. Deploy and monitor
+
+## Resources
+- [Laminar Documentation](https://docs.laminar.run)
+- [Sign up for Laminar](https://app.laminar.run)
+
+## Support
+Get help with LAM:
+- [Contact Support](mailto:connect@laminar.run)

lam_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+lam/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+lam/core.py,sha256=ckcHNRyfhly9D9kpbeJQUPhpPYwCEM7tq9ATU4XZAR0,2645
+lam/lam.py,sha256=Ge7nqJwqysTEIuVLYW0ECl34PT3mNvA_yWnZ1keg9lo,5065
+lam/utils.py,sha256=l98xstNeiz7JdAhbwkaEwJTi2KSPnMxluS5ObUM4Bm4,626
+lam/engines/__init__.py,sha256=o7DFSvAE0GQ2BOewiqFLAEjU_3LmWQLhaPrnfs1mLmw,809
+lam/engines/base.py,sha256=I4UIfzqkRwdGIyW98GPXgxLsqNqjes0Mqx01DdCO2ho,1980
+lam/engines/javascript.py,sha256=DIyjzrgMo0pEENsOHflhnstEpu_74rBwyIEffYXPuYo,10828
+lam/engines/jq.py,sha256=jnm8w9s9CRtiSW_JzfgQWyapNnQGrYw8EDZGUGJoDjY,2565
+lam/engines/python.py,sha256=iJpk2NVVGoLmQbnNEsiKuy8GxaYgOLFUnqF9Pyzo8ng,32134
+lam_cli-1.0.0.dist-info/licenses/LICENSE,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
+lam_cli-1.0.0.dist-info/METADATA,sha256=MfEKmeB19-fsTeAIZinh0y9nHA0DiXPsxMlSjkSkd4I,8437
+lam_cli-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lam_cli-1.0.0.dist-info/entry_points.txt,sha256=iJSsJitcGMikKJ3Q9KNWxEy911oTrSxGSO1HiwcBrKE,40
+lam_cli-1.0.0.dist-info/top_level.txt,sha256=WyM7-Ig60qQH9meqS293pEd83jrMtbvGJM8ALZOQCtA,4
+lam_cli-1.0.0.dist-info/RECORD,,

{lam_cli-0.1.7.dist-info → lam_cli-1.0.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.3.1)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

lam_cli-0.1.7.dist-info/METADATA

@@ -1,53 +0,0 @@
-Metadata-Version: 2.4
-Name: lam-cli
-Version: 0.1.7
-Summary: Secure data transformation tool supporting JQ and JavaScript (Bun)
-Home-page: https://github.com/laminar-run/lam
-Author: Laminar Run, Inc.
-Author-email: connect@laminar.run
-License: GPLv3
-Project-URL: Documentation, https://docs.laminar.run
-Project-URL: Source, https://github.com/laminar-run/lam
-Project-URL: Issue Tracker, https://github.com/laminar-run/lam/issues
-Keywords: laminar,api,integration,transformation,json,jq,javascript,bun
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
-Classifier: Topic :: Software Development :: Build Tools
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: backoff>=2.2.1
-Requires-Dist: certifi>=2024.12.14
-Requires-Dist: charset-normalizer>=3.3.2
-Requires-Dist: click>=8.1.7
-Requires-Dist: idna>=3.7
-Requires-Dist: logtail-python>=0.2.2
-Requires-Dist: monotonic>=1.6
-Requires-Dist: msgpack>=1.0.8
-Requires-Dist: posthog>=3.4.0
-Requires-Dist: psutil>=5.9.0
-Requires-Dist: python-dateutil>=2.8.2
-Requires-Dist: requests>=2.32.3
-Requires-Dist: six>=1.16.0
-Requires-Dist: urllib3>=2.2.2
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary

lam_cli-0.1.7.dist-info/RECORD

@@ -1,8 +0,0 @@
-lam/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lam/lam.py,sha256=jlK7-O--3nQSdGKy7YnIeWA8ToiJ2Q46TpnEuEqpFSk,38306
-lam_cli-0.1.7.dist-info/licenses/LICENSE,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
-lam_cli-0.1.7.dist-info/METADATA,sha256=jVVE7ktM1tzCIjNlG3UYb_fKDaziInoqF71FgdJpmJk,1917
-lam_cli-0.1.7.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-lam_cli-0.1.7.dist-info/entry_points.txt,sha256=iJSsJitcGMikKJ3Q9KNWxEy911oTrSxGSO1HiwcBrKE,40
-lam_cli-0.1.7.dist-info/top_level.txt,sha256=WyM7-Ig60qQH9meqS293pEd83jrMtbvGJM8ALZOQCtA,4
-lam_cli-0.1.7.dist-info/RECORD,,