unfolder 0.1.0__tar.gz

unfolder-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+
+Copyright (c) 2026 Unfolder Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

unfolder-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: unfolder
+Version: 0.1.0
+Summary: A downloadable collection of 19 text files.
+Author: Unfolder Contributors
+License: MIT
+Keywords: text-files,file-collection,downloader,resources
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Unfolder
+
+A downloadable collection of 19 text files.
+
+## Installation
+
+```bash
+pip install unfolder
+```
+
+## Download the complete folder
+
+```bash
+python -m unfolder download
+```
+
+This creates an `unfolder` directory in the current working directory and extracts all 19 `.txt` files into it.
+
+## Download to a specific location
+
+```bash
+unfolder download --destination "C:/Users/YourName/Desktop/my-text-files"
+```
+
+The destination is the exact folder where the text files will be placed. It is created automatically if it does not exist.
+
+You can also use the module form on systems where the command-line script is not on `PATH`:
+
+```bash
+python -m unfolder download --destination "./my-text-files"
+```
+
+## Python import
+
+```python
+import unfolder
+
+folder = unfolder.download()
+print(f"Files are available in: {folder}")
+```
+
+Choose a custom destination from Python:
+
+```python
+import unfolder
+
+folder = unfolder.download("./my-text-files")
+```
+
+Existing files are skipped by default. To replace them:
+
+```python
+unfolder.download("./my-text-files", overwrite=True)
+```
+
+## Notes
+
+- The collection contains 19 plain-text (`.txt`) files.
+- The files are bundled with the package, so no separate download server or internet connection is needed when extracting them.
+- Importing `unfolder` does not create or download files. Call `unfolder.download()` when you want to extract the collection.

unfolder-0.1.0/README.md

@@ -0,0 +1,60 @@
+# Unfolder
+
+A downloadable collection of 19 text files.
+
+## Installation
+
+```bash
+pip install unfolder
+```
+
+## Download the complete folder
+
+```bash
+python -m unfolder download
+```
+
+This creates an `unfolder` directory in the current working directory and extracts all 19 `.txt` files into it.
+
+## Download to a specific location
+
+```bash
+unfolder download --destination "C:/Users/YourName/Desktop/my-text-files"
+```
+
+The destination is the exact folder where the text files will be placed. It is created automatically if it does not exist.
+
+You can also use the module form on systems where the command-line script is not on `PATH`:
+
+```bash
+python -m unfolder download --destination "./my-text-files"
+```
+
+## Python import
+
+```python
+import unfolder
+
+folder = unfolder.download()
+print(f"Files are available in: {folder}")
+```
+
+Choose a custom destination from Python:
+
+```python
+import unfolder
+
+folder = unfolder.download("./my-text-files")
+```
+
+Existing files are skipped by default. To replace them:
+
+```python
+unfolder.download("./my-text-files", overwrite=True)
+```
+
+## Notes
+
+- The collection contains 19 plain-text (`.txt`) files.
+- The files are bundled with the package, so no separate download server or internet connection is needed when extracting them.
+- Importing `unfolder` does not create or download files. Call `unfolder.download()` when you want to extract the collection.

unfolder-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "unfolder"
+version = "0.1.0"
+description = "A downloadable collection of 19 text files."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Unfolder Contributors" }]
+keywords = ["text-files", "file-collection", "downloader", "resources"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+]
+
+[project.scripts]
+unfolder = "unfolder.__main__:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+unfolder = ["data/*.txt"]

unfolder-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

unfolder-0.1.0/src/unfolder/__init__.py

@@ -0,0 +1,6 @@
+"""Unfolder: a downloadable collection of 19 text files."""
+
+from .downloader import download
+
+__all__ = ["download"]
+__version__ = "0.1.0"

unfolder-0.1.0/src/unfolder/__main__.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+import argparse
+
+from . import __version__, download
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="unfolder",
+        description="Extract the Unfolder collection of text files.",
+    )
+    parser.add_argument("--version", action="version", version=f"unfolder {__version__}")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    download_parser = subparsers.add_parser("download", help="Extract all bundled text files")
+    download_parser.add_argument(
+        "--destination",
+        "-d",
+        default=None,
+        help="Target folder (default: ./unfolder)",
+    )
+    download_parser.add_argument(
+        "--overwrite",
+        action="store_true",
+        help="Overwrite files that already exist",
+    )
+
+    args = parser.parse_args()
+    if args.command == "download":
+        download(args.destination, overwrite=args.overwrite)
+
+
+if __name__ == "__main__":
+    main()

unfolder-0.1.0/src/unfolder/data/LDR_DHT22_COMBINED.txt

@@ -0,0 +1,82 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+
+sketch.ino:
+
+
+#include <DHT.h>
+
+#define DHTPIN 4
+#define DHTTYPE DHT22
+#define LDRPIN 34
+
+DHT dht(DHTPIN, DHTTYPE);
+
+void setup() {
+  Serial.begin(115200);
+  dht.begin();
+}
+
+void loop() {
+  float temperature = dht.readTemperature();
+  float humidity = dht.readHumidity();
+
+  int light = analogRead(LDRPIN);
+
+  Serial.println("--------------------");
+
+  Serial.print("Temperature: ");
+  Serial.print(temperature);
+  Serial.println(" C");
+
+  Serial.print("Humidity: ");
+  Serial.print(humidity);
+  Serial.println(" %");
+
+  Serial.print("Light Reading: ");
+  Serial.println(light);
+
+  if (light > 500) {
+    Serial.println("Room: DARK");
+    Serial.println("Status: COMFY");
+  } else {
+    Serial.println("Room: BRIGHT");
+    Serial.println("Status: NOT COMFORTABLE");
+  }
+
+  delay(2000);
+}
+
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    { "type": "board-esp32-devkit-c-v4", "id": "esp", "top": 0, "left": 0, "attrs": {} },
+    { "type": "wokwi-dht22", "id": "dht1", "top": 0.3, "left": -111, "attrs": {} },
+    {
+      "type": "wokwi-photoresistor-sensor",
+      "id": "ldr1",
+      "top": -73.6,
+      "left": 77.6,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    [ "esp:TX", "$serialMonitor:RX", "", [] ],
+    [ "esp:RX", "$serialMonitor:TX", "", [] ],
+    [ "dht1:VCC", "esp:3V3", "red", [] ],
+    [ "dht1:GND", "esp:GND.1", "black", [] ],
+    [ "dht1:SDA", "esp:4", "green", [] ],
+    [ "ldr1:VCC", "esp:3V3", "red", [] ],
+    [ "ldr1:GND", "esp:GND.1", "black", [] ],
+    [ "ldr1:AO", "esp:34", "blue", [] ]
+  ],
+  "dependencies": {
+  }
+}

unfolder-0.1.0/src/unfolder/data/Q01_DHT_Sensor.txt

@@ -0,0 +1,77 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+1.Develop an ESP32 program to read temperature and humidity values using a DHT22 sensor and display the readings using serial communication.
+
+sketch.ino:
+
+#include "DHT.h"
+
+#define DHTPIN 4
+#define DHTTYPE DHT22
+
+DHT dht(DHTPIN, DHTTYPE);
+
+void setup() {
+  Serial.begin(115200);
+
+  dht.begin();
+
+  Serial.println("DHT22 Sensor Started");
+}
+
+void loop() {
+  float humidity = dht.readHumidity();
+  float temperature = dht.readTemperature();
+
+  if (isnan(humidity) || isnan(temperature)) {
+    Serial.println("Failed to read from DHT22 sensor!");
+    delay(2000);
+    return;
+  }
+
+  Serial.print("Temperature: ");
+  Serial.print(temperature);
+  Serial.println(" °C");
+
+  Serial.print("Humidity: ");
+  Serial.print(humidity);
+  Serial.println(" %");
+
+  Serial.println("--------------------");
+
+  delay(2000);
+}
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    {
+      "type": "board-esp32-devkit-c-v4",
+      "id": "esp",
+      "top": 0,
+      "left": 0,
+      "attrs": {}
+    },
+    {
+      "type": "wokwi-dht22",
+      "id": "dht",
+      "top": -20,
+      "left": 200,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    ["esp:TX", "$serialMonitor:RX", "", []],
+    ["esp:RX", "$serialMonitor:TX", "", []],
+    ["dht:VCC", "esp:3V3", "red", []],
+    ["dht:GND", "esp:GND.1", "black", []],
+    ["dht:SDA", "esp:4", "green", []]
+  ],
+  "dependencies": {}
+}

unfolder-0.1.0/src/unfolder/data/Q02_LDR_Sensor.txt

@@ -0,0 +1,70 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+2.Develop an ESP32 program to read light intensity using an LDR module and display the readings using serial communication.
+
+sketch.ino:
+
+
+#define LDR_PIN 34
+
+void setup() {
+  Serial.begin(115200);
+
+  Serial.println("LDR Sensor Started");
+}
+
+void loop() {
+  int lightValue = analogRead(LDR_PIN);
+
+  Serial.print("Light Intensity: ");
+  Serial.println(lightValue);
+
+  if (lightValue < 1500) {
+    Serial.println("Low Light");
+  }
+  else if (lightValue < 3000) {
+    Serial.println("Medium Light");
+  }
+  else {
+    Serial.println("High Light");
+  }
+
+  Serial.println("--------------------");
+
+  delay(1000);
+}
+
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    {
+      "type": "board-esp32-devkit-c-v4",
+      "id": "esp",
+      "top": 0,
+      "left": 0,
+      "attrs": {}
+    },
+    {
+      "type": "wokwi-photoresistor-sensor",
+      "id": "ldr",
+      "top": -20,
+      "left": 200,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    ["esp:TX", "$serialMonitor:RX", "", []],
+    ["esp:RX", "$serialMonitor:TX", "", []],
+    ["ldr:VCC", "esp:3V3", "red", []],
+    ["ldr:GND", "esp:GND.1", "black", []],
+    ["ldr:AO", "esp:34", "green", []]
+  ],
+  "dependencies": {}
+}

unfolder-0.1.0/src/unfolder/data/Q03_PIR_Sensor.txt

@@ -0,0 +1,64 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+3.Develop an ESP32 program to detect motion using a PIR sensor and display the detection status using serial communication.
+
+sketch.ino:
+
+
+#define PIR_PIN 4
+
+void setup() {
+  Serial.begin(115200);
+
+  pinMode(PIR_PIN, INPUT);
+
+  Serial.println("PIR Motion Detection Started");
+}
+
+void loop() {
+  int motion = digitalRead(PIR_PIN);
+
+  if (motion == HIGH) {
+    Serial.println("Motion Detected!");
+  }
+  else {
+    Serial.println("No Motion");
+  }
+
+  delay(1000);
+}
+
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    {
+      "type": "board-esp32-devkit-c-v4",
+      "id": "esp",
+      "top": 0,
+      "left": 0,
+      "attrs": {}
+    },
+    {
+      "type": "wokwi-pir-motion-sensor",
+      "id": "pir",
+      "top": -20,
+      "left": 200,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    ["esp:TX", "$serialMonitor:RX", "", []],
+    ["esp:RX", "$serialMonitor:TX", "", []],
+    ["pir:VCC", "esp:3V3", "red", []],
+    ["pir:GND", "esp:GND.1", "black", []],
+    ["pir:OUT", "esp:4", "green", []]
+  ],
+  "dependencies": {}
+}