{"id":27051,"library":"hyperleaup","title":"Hyperleaup","description":"Create and publish Tableau Hyper files from Apache Spark DataFrames and Spark SQL. Current version 0.1.2, beta-level with monthly-ish releases on PyPI.","status":"active","version":"0.1.2","language":"python","source_language":"en","source_url":"https://github.com/goodwillpunning/hyperleaup","tags":["tableau","hyper","spark","pyspark","data-export"],"install":[{"cmd":"pip install hyperleaup","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core dependency for Spark DataFrame operations; version >=3.2.2","package":"pyspark","optional":false},{"reason":"Required to create Tableau Hyper files","package":"tableauhyperapi","optional":false}],"imports":[{"note":null,"wrong":null,"symbol":"HyperFile","correct":"from hyperleaup import HyperFile"},{"note":null,"wrong":null,"symbol":"Creator","correct":"from hyperleaup import Creator"}],"quickstart":{"code":"from pyspark.sql import SparkSession\nfrom hyperleaup import HyperFile\n\nspark = SparkSession.builder.appName(\"example\").getOrCreate()\ndf = spark.createDataFrame([(1, \"a\"), (2, \"b\")], [\"id\", \"value\"])\nhyper = HyperFile()\nhyper.save(df, \"output.hyper\")\nprint(\"Hyper file created successfully.\")","lang":"python","description":"Creates a simple Hyper file from a Spark DataFrame."},"warnings":[{"fix":"Explicitly set `timestamp_with_timezone=True` when creating HyperFile if your data contains timestamps with timezone.","message":"In v0.1.1, changed default `timestamp_with_timezone` to False to maintain backward compatibility; setting to True may be needed to avoid type mismatch errors.","severity":"breaking","affected_versions":"0.1.1+"},{"fix":"Run `pip install pyspark tableauhyperapi` before using hyperleaup.","message":"Hyperleaup is tightly coupled to PySpark and Tableau Hyper API. Ensure both are installed and compatible.","severity":"gotcha","affected_versions":"all"},{"fix":"Use default creation mode unless you are on Databricks and understand the implications.","message":"The `LARGEFILE` creation mode is experimental and only works with Databricks File System (DBFS). Do not use on other distributed file systems.","severity":"gotcha","affected_versions":"0.1.2"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Set `timestamp_with_timezone=True` in HyperFile/Creator constructor.","cause":"Timestamp column in Spark DataFrame is timestamp without timezone, but Hyper expects timestamptz.","error":"HyperException: Type 'timestamp' is incompatible to type 'timestamptz' of column 'last_updated' in Parquet file."},{"fix":"Install via `pip install hyperleaup` and ensure you import as `from hyperleaup import HyperFile`.","cause":"Package was renamed or not installed.","error":"ModuleNotFoundError: No module named 'hyperleaup'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}