survy 0.1.0__tar.gz

survy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ha Hoang Hao
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

survy-0.1.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: survy
+Version: 0.1.0
+Summary: Process, transform and analyze survey-format data with clean and simple API.
+Author-email: Ha Hoang Hao <hhhao.vn@gmail.com>
+Project-URL: Homepage, https://github.com/hoanghaoha/survy
+Project-URL: Repository, https://github.com/hoanghaoha/survy
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: polars[excel]>=1.37.1
+Requires-Dist: numpy>2.0.0
+Requires-Dist: pyreadstat>1.3.0
+Requires-Dist: statsmodels>=0.14.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Dynamic: license-file
+
+# survy
+
+[![PyPI version](https://img.shields.io/pypi/v/survy.svg)](https://pypi.org/project/survy/)
+[![License](https://img.shields.io/pypi/l/survy.svg)](LICENSE)
+[![Python](https://img.shields.io/pypi/pyversions/survy.svg)](https://pypi.org/project/survy/)
+[![CI](https://github.com/hoanghaoha/survy/actions/workflows/ci.yml/badge.svg)](https://github.com/hoanghaoha/survy/actions)
+
+**Process, transform, and analyze survey-format data with a clean and simple API.**
+
+---
+
+## 📦 Overview
+
+`survy` is a lightweight Python library built for working efficiently with survey data.
+It simplifies the full workflow—from raw data ingestion to transformation and analysis—while preserving survey-specific structures like multiselect questions.
+
+---
+
+## ✨ Features
+
+* 🔹 Multiselect as a first-class concept
+* 🔹 Read & write multiple formats: CSV, Excel, JSON, SPSS, etc.
+* 🔹 Clean, minimal, and expressive API
+* 🔹 Built-in tools for validation, tracking, and analysis
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install survy
+```
+
+---
+
+## ⚡ Quick Demo
+
+### Sample data 
+
+`data.csv`
+```csv
+id,Q1,Q2_1,Q2_2,Q2_3
+1,a,a,b,
+2,b,a,,c
+3,a,,b,c
+```
+
+`data_compact.csv`
+```csv
+id,Q1,Q2
+1,a,a;b
+2,b,a
+3,a,b;c
+```
+
+---
+
+### Load and analyze
+
+```python
+import survy
+
+# Load dataset with compact multiselect column
+survey = survy.read_csv("data.csv")
+#or
+survey = survy.read_csv(
+    "data_compact.csv",
+    compact_ids=["Q2"],
+    compact_separator=";"
+)
+
+# Inspect variable
+q1 = survey["Q1"]
+print(q1.frequencies)
+
+# Crosstab analysis
+crosstab = survy.crosstab(survey["Q1"], survey["Q2"])
+print(crosstab)
+```
+
+---
+
+## 📥 Usage
+
+### Load data
+
+```python
+survey = survy.read_csv("data.csv")
+```
+
+With compact multiselect:
+
+```python
+survey = survy.read_csv(
+    "data.csv",
+    compact_ids=["Q2"],
+    compact_separator=";"
+)
+```
+
+---
+
+### Get DataFrame
+
+```python
+survey.get_df(select_dtype="text", multiselect_dtype="compact")
+```
+
+---
+
+### Work with variables
+
+```python
+q1 = survey["Q1"]
+
+print(q1.vtype)
+print(q1.value_indices)
+print(q1.base)
+print(q1.frequencies)
+```
+
+---
+
+### Update variables
+
+```python
+q1.label = "Question 1"
+q1.value_indices = {"b": 1, "a": 2}
+```
+
+Batch update:
+
+```python
+survey.update([
+    {
+        "id": "Q1",
+        "label": "Question 1",
+        "value_indices": {"b": 1, "a": 2}
+    }
+])
+```
+
+---
+
+### Export
+
+```python
+survey.to_csv("output.csv")
+survey.to_spss("output.sav")
+```
+
+---
+
+### Analyze
+
+```python
+crosstab = survy.crosstab(survey["Q1"], survey["Q2"])
+print(crosstab)
+```
+
+---
+
+## 🧠 Design Philosophy
+
+* Keep survey logic explicit (variables, labels, value mappings)
+* Treat multiselect questions as a core data type
+* Provide a clean abstraction over high-performance data processing
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome!
+Feel free to open issues or submit pull requests.
+
+---
+
+## 📄 License
+
+MIT License
+
+---
+
+## 🔗 References
+
+* Powered by **Polars** for fast data processing
+
+---

survy-0.1.0/README.md

@@ -0,0 +1,188 @@
+# survy
+
+[![PyPI version](https://img.shields.io/pypi/v/survy.svg)](https://pypi.org/project/survy/)
+[![License](https://img.shields.io/pypi/l/survy.svg)](LICENSE)
+[![Python](https://img.shields.io/pypi/pyversions/survy.svg)](https://pypi.org/project/survy/)
+[![CI](https://github.com/hoanghaoha/survy/actions/workflows/ci.yml/badge.svg)](https://github.com/hoanghaoha/survy/actions)
+
+**Process, transform, and analyze survey-format data with a clean and simple API.**
+
+---
+
+## 📦 Overview
+
+`survy` is a lightweight Python library built for working efficiently with survey data.
+It simplifies the full workflow—from raw data ingestion to transformation and analysis—while preserving survey-specific structures like multiselect questions.
+
+---
+
+## ✨ Features
+
+* 🔹 Multiselect as a first-class concept
+* 🔹 Read & write multiple formats: CSV, Excel, JSON, SPSS, etc.
+* 🔹 Clean, minimal, and expressive API
+* 🔹 Built-in tools for validation, tracking, and analysis
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install survy
+```
+
+---
+
+## ⚡ Quick Demo
+
+### Sample data 
+
+`data.csv`
+```csv
+id,Q1,Q2_1,Q2_2,Q2_3
+1,a,a,b,
+2,b,a,,c
+3,a,,b,c
+```
+
+`data_compact.csv`
+```csv
+id,Q1,Q2
+1,a,a;b
+2,b,a
+3,a,b;c
+```
+
+---
+
+### Load and analyze
+
+```python
+import survy
+
+# Load dataset with compact multiselect column
+survey = survy.read_csv("data.csv")
+#or
+survey = survy.read_csv(
+    "data_compact.csv",
+    compact_ids=["Q2"],
+    compact_separator=";"
+)
+
+# Inspect variable
+q1 = survey["Q1"]
+print(q1.frequencies)
+
+# Crosstab analysis
+crosstab = survy.crosstab(survey["Q1"], survey["Q2"])
+print(crosstab)
+```
+
+---
+
+## 📥 Usage
+
+### Load data
+
+```python
+survey = survy.read_csv("data.csv")
+```
+
+With compact multiselect:
+
+```python
+survey = survy.read_csv(
+    "data.csv",
+    compact_ids=["Q2"],
+    compact_separator=";"
+)
+```
+
+---
+
+### Get DataFrame
+
+```python
+survey.get_df(select_dtype="text", multiselect_dtype="compact")
+```
+
+---
+
+### Work with variables
+
+```python
+q1 = survey["Q1"]
+
+print(q1.vtype)
+print(q1.value_indices)
+print(q1.base)
+print(q1.frequencies)
+```
+
+---
+
+### Update variables
+
+```python
+q1.label = "Question 1"
+q1.value_indices = {"b": 1, "a": 2}
+```
+
+Batch update:
+
+```python
+survey.update([
+    {
+        "id": "Q1",
+        "label": "Question 1",
+        "value_indices": {"b": 1, "a": 2}
+    }
+])
+```
+
+---
+
+### Export
+
+```python
+survey.to_csv("output.csv")
+survey.to_spss("output.sav")
+```
+
+---
+
+### Analyze
+
+```python
+crosstab = survy.crosstab(survey["Q1"], survey["Q2"])
+print(crosstab)
+```
+
+---
+
+## 🧠 Design Philosophy
+
+* Keep survey logic explicit (variables, labels, value mappings)
+* Treat multiselect questions as a core data type
+* Provide a clean abstraction over high-performance data processing
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome!
+Feel free to open issues or submit pull requests.
+
+---
+
+## 📄 License
+
+MIT License
+
+---
+
+## 🔗 References
+
+* Powered by **Polars** for fast data processing
+
+---

survy-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "survy"
+version = "0.1.0"
+description = "Process, transform and analyze survey-format data with clean and simple API."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+  "polars[excel]>=1.37.1",
+  "numpy>2.0.0",
+  "pyreadstat>1.3.0",
+  "statsmodels>=0.14.0",
+]
+authors = [{ name = "Ha Hoang Hao", email = "hhhao.vn@gmail.com" }]
+
+[project.optional-dependencies]
+dev = ["pytest", "ruff", "coverage"]
+
+[project.urls]
+Homepage = "https://github.com/hoanghaoha/survy"
+Repository = "https://github.com/hoanghaoha/survy"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["src/surpy"]

survy-0.1.0/setup.cfg

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

survy-0.1.0/src/survy/__init__.py

@@ -0,0 +1,27 @@
+from survy.io.polars import read_polars
+from survy.io.csv import read_csv, to_csv
+from survy.io.excel import read_excel, to_excel
+from survy.io.json import read_json, to_json
+from survy.io.spss import to_spss
+
+
+from survy.survey.survey import Survey
+from survy.variable.variable import Variable, VarType
+
+from survy.analyze.crosstab.functions import crosstab
+
+
+__all__ = [
+    "read_polars",
+    "read_csv",
+    "read_excel",
+    "read_json",
+    "to_csv",
+    "to_excel",
+    "to_json",
+    "to_spss",
+    "Survey",
+    "Variable",
+    "VarType",
+    "crosstab",
+]

survy-0.1.0/src/survy/analyze/__init__.py

@@ -0,0 +1,4 @@
+from survy.analyze.crosstab.functions import crosstab
+
+
+__all__ = ["crosstab"]