f2a 0.1.0__tar.gz

f2a-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,126 @@
+# ──────────────────────────────────────────────────────────────
+#  PyPI auto-deploy workflow
+#  Trigger: push to the deploy branch
+#  Condition: only deploy if not yet published on PyPI, or version bumped
+# ──────────────────────────────────────────────────────────────
+name: Publish to PyPI
+
+on:
+  push:
+    branches:
+      - deploy
+
+jobs:
+  # ── Step 1: Version check ─────────────────────────────────
+  check-version:
+    runs-on: ubuntu-latest
+    outputs:
+      should_publish: ${{ steps.decide.outputs.should_publish }}
+      local_version: ${{ steps.local.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Read local version
+        id: local
+        run: |
+          VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "📦 Local version: $VERSION"
+
+      - name: Check PyPI for existing version
+        id: pypi
+        run: |
+          LOCAL="${{ steps.local.outputs.version }}"
+          # PyPI JSON API — returns 404 if the package does not exist
+          HTTP_CODE=$(curl -s -o /tmp/pypi.json -w "%{http_code}" \
+            "https://pypi.org/pypi/f2a/json")
+
+          if [ "$HTTP_CODE" = "404" ]; then
+            echo "pypi_version=NONE" >> "$GITHUB_OUTPUT"
+            echo "🆕 Package not yet on PyPI"
+          else
+            PYPI_VER=$(python -c "
+          import json, pathlib
+          data = json.loads(pathlib.Path('/tmp/pypi.json').read_text())
+          print(data['info']['version'])
+          ")
+            echo "pypi_version=$PYPI_VER" >> "$GITHUB_OUTPUT"
+            echo "📡 PyPI version: $PYPI_VER"
+          fi
+
+      - name: Decide whether to publish
+        id: decide
+        run: |
+          LOCAL="${{ steps.local.outputs.version }}"
+          PYPI="${{ steps.pypi.outputs.pypi_version }}"
+
+          if [ "$PYPI" = "NONE" ]; then
+            echo "should_publish=true" >> "$GITHUB_OUTPUT"
+            echo "✅ First publish — will deploy $LOCAL"
+          elif [ "$LOCAL" != "$PYPI" ]; then
+            echo "should_publish=true" >> "$GITHUB_OUTPUT"
+            echo "✅ Version bumped ($PYPI → $LOCAL) — will deploy"
+          else
+            echo "should_publish=false" >> "$GITHUB_OUTPUT"
+            echo "⏭️ Version $LOCAL already on PyPI — skipping"
+          fi
+
+  # ── Step 2: Tests ─────────────────────────────────────────
+  test:
+    needs: check-version
+    if: needs.check-version.outputs.should_publish == 'true'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+          pip install beautifulsoup4 html5lib
+
+      - name: Run tests
+        run: pytest git_action/tests/ -v --tb=short
+
+  # ── Step 3: Build & Deploy ────────────────────────────────
+  publish:
+    needs: [check-version, test]
+    if: needs.check-version.outputs.should_publish == 'true'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # Trusted Publisher (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: python -m pip install --upgrade pip build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # Uses Trusted Publisher, so no API token required.
+        # You must register GitHub Actions as a Trusted Publisher in the PyPI project settings.
+        # To use a manual token instead, uncomment below:
+        # with:
+        #   password: ${{ secrets.PYPI_API_TOKEN }}

f2a-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# f2a — .gitignore
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test & Coverage
+.pytest_cache/
+htmlcov/
+.coverage
+coverage.xml
+
+# Manual test folder
+test/
+
+# Output
+examples/output/
+examples/sample_data.csv
+*.html
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/

f2a-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 f2a 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. 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.

f2a-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: f2a
+Version: 0.1.0
+Summary: File to Analysis — Automatically perform descriptive statistical analysis and visualization from any data source
+Project-URL: Homepage, https://github.com/CocoRoF/f2a
+Project-URL: Documentation, https://github.com/CocoRoF/f2a#readme
+Project-URL: Repository, https://github.com/CocoRoF/f2a
+Project-URL: Issues, https://github.com/CocoRoF/f2a/issues
+Author: CocoRoF
+License: MIT
+License-File: LICENSE
+Keywords: data-analysis,eda,huggingface,statistics,visualization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: scipy>=1.11
+Requires-Dist: seaborn>=0.13
+Provides-Extra: all
+Requires-Dist: datasets>=2.14; extra == 'all'
+Requires-Dist: duckdb>=0.9; extra == 'all'
+Requires-Dist: jinja2>=3.1; extra == 'all'
+Requires-Dist: lxml>=4.9; extra == 'all'
+Requires-Dist: odfpy>=1.4; extra == 'all'
+Requires-Dist: openpyxl>=3.1; extra == 'all'
+Requires-Dist: pyarrow>=12.0; extra == 'all'
+Requires-Dist: pyreadstat>=1.2; extra == 'all'
+Requires-Dist: rich>=13.0; extra == 'all'
+Requires-Dist: tables>=3.8; extra == 'all'
+Provides-Extra: arrow
+Requires-Dist: pyarrow>=12.0; extra == 'arrow'
+Provides-Extra: dev
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: isort>=5.12; extra == 'dev'
+Requires-Dist: mypy>=1.5; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Provides-Extra: duckdb
+Requires-Dist: duckdb>=0.9; extra == 'duckdb'
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.1; extra == 'excel'
+Provides-Extra: hdf5
+Requires-Dist: tables>=3.8; extra == 'hdf5'
+Provides-Extra: hf
+Requires-Dist: datasets>=2.14; extra == 'hf'
+Provides-Extra: ods
+Requires-Dist: odfpy>=1.4; extra == 'ods'
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=12.0; extra == 'parquet'
+Provides-Extra: report
+Requires-Dist: jinja2>=3.1; extra == 'report'
+Provides-Extra: rich
+Requires-Dist: rich>=13.0; extra == 'rich'
+Provides-Extra: spss
+Requires-Dist: pyreadstat>=1.2; extra == 'spss'
+Provides-Extra: xml
+Requires-Dist: lxml>=4.9; extra == 'xml'
+Description-Content-Type: text/markdown
+
+# f2a — File to Analysis
+
+> A Python library that automatically performs descriptive statistical analysis and visualization from data sources
+
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## Installation
+
+```bash
+pip install f2a
+
+# With HuggingFace dataset support
+pip install f2a[hf]
+
+# All features
+pip install f2a[all]
+```
+
+## Quick Start
+
+```python
+import f2a
+
+# Analyze a local CSV file
+report = f2a.analyze("data/sales.csv")
+report.show()  # Print summary to console
+
+# Analyze a Hugging Face dataset
+report = f2a.analyze("hf://imdb")
+report.show()
+
+# Access detailed results
+report.stats.summary        # Summary statistics DataFrame
+report.stats.correlation     # Correlation matrix
+report.viz.plot_distributions()  # Distribution plots
+```
+
+## Supported Formats
+
+| Format | Extensions | Extra Install |
+|---|---|---|
+| CSV / TSV | `.csv`, `.tsv` | — |
+| JSON / JSONL | `.json`, `.jsonl` | — |
+| Parquet | `.parquet` | `pip install f2a[parquet]` |
+| Excel | `.xlsx`, `.xls` | `pip install f2a[excel]` |
+| SQLite | `.db`, `.sqlite3` | — |
+| Stata | `.dta` | — |
+| XML / HTML | `.xml`, `.html` | — |
+| HuggingFace | `hf://dataset_name` | `pip install f2a[hf]` |
+
+## Analysis Features
+
+- **Descriptive Statistics**: Mean, median, standard deviation, quantiles, mode, etc.
+- **Distribution Analysis**: Skewness, kurtosis, normality tests
+- **Correlation Analysis**: Pearson, Spearman, Cramér's V
+- **Missing Data Analysis**: Missing ratio, pattern analysis
+- **Visualization**: Histograms, boxplots, correlation heatmaps, missing data matrix
+
+## Development
+
+```bash
+git clone https://github.com/CocoRoF/f2a.git
+cd f2a
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT License — See [LICENSE](LICENSE) for details.