{"id":18733493,"url":"https://github.com/queryverse/fstfiles.jl","last_synced_at":"2026-01-24T09:01:36.516Z","repository":{"id":74502598,"uuid":"109731202","full_name":"queryverse/FstFiles.jl","owner":"queryverse","description":"FileIO.jl integration for fst files","archived":false,"fork":false,"pushed_at":"2017-11-06T18:13:29.000Z","size":7,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-19T23:43:47.710Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/queryverse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-11-06T18:06:17.000Z","updated_at":"2019-06-14T01:37:31.000Z","dependencies_parsed_at":"2023-04-05T09:31:33.834Z","dependency_job_id":null,"html_url":"https://github.com/queryverse/FstFiles.jl","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/queryverse/FstFiles.jl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFstFiles.jl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFstFiles.jl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFstFiles.jl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFstFiles.jl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/queryverse","download_url":"https://codeload.github.com/queryverse/FstFiles.jl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/queryverse%2FFstFiles.jl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28721975,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T08:27:05.734Z","status":"ssl_error","status_checked_at":"2026-01-24T08:27:01.197Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T15:09:57.135Z","updated_at":"2026-01-24T09:01:36.511Z","avatar_url":"https://github.com/queryverse.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FstFiles\n\n[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)\n[![Build Status](https://travis-ci.org/davidanthoff/FstFiles.jl.svg?branch=master)](https://travis-ci.org/davidanthoff/FstFiles.jl)\n[![Build status](https://ci.appveyor.com/api/projects/status/vipuru7kaepv5f5o/branch/master?svg=true)](https://ci.appveyor.com/project/davidanthoff/fstfiles-jl/branch/master)\n[![FstFiles](http://pkg.julialang.org/badges/FstFiles_0.6.svg)](http://pkg.julialang.org/?pkg=FstFiles)\n[![codecov.io](http://codecov.io/github/davidanthoff/FstFiles.jl/coverage.svg?branch=master)](http://codecov.io/github/davidanthoff/FstFiles.jl?branch=master)\n\n## Overview\n\nThis package provides load support for [fst](http://www.fstpackage.org/)\nfiles under the [FileIO.jl](https://github.com/JuliaIO/FileIO.jl) package.\n\n## Installation\n\nUse ``Pkg.add(\"FstFiles\")`` in Julia to install FstFiles and its dependencies.\n\n## Usage\n\n### Load a fst file\n\nTo read a fst file into a ``DataFrame``, use the following julia code:\n\n````julia\nusing FileIO, FstFiles, DataFrames\n\ndf = DataFrame(load(\"data.fst\"))\n````\n\nThe call to ``load`` returns a ``struct`` that is an [IterableTable.jl](https://github.com/davidanthoff/IterableTables.jl), so it can be passed to any function that can handle iterable tables, i.e. all the sinks in [IterableTable.jl](https://github.com/davidanthoff/IterableTables.jl). Here are some examples of materializing a fst file into data structures that are not a ``DataFrame``:\n\n````julia\nusing FileIO, FstFiles, DataTables, IndexedTables, TimeSeries, Temporal, Gadfly\n\n# Load into a DataTable\ndt = DataTable(load(\"data.fst\"))\n\n# Load into an IndexedTable\nit = IndexedTable(load(\"data.fst\"))\n\n# Load into a TimeArray\nta = TimeArray(load(\"data.fst\"))\n\n# Load into a TS\nts = TS(load(\"data.fst\"))\n\n# Plot directly with Gadfly\nplot(load(\"data.fst\"), x=:a, y=:b, Geom.line)\n````\n\n### Save a fst file\n\nThe following code saves any iterable table as a fst file:\n````julia\nusing FileIO, FstFiles\n\nsave(\"output.fst\", it)\n````\nThis will work as long as ``it`` is any of the types supported as sources in [IterableTables.jl](https://github.com/davidanthoff/IterableTables.jl).\n\n### Using the pipe syntax\n\nBoth ``load`` and ``save`` also support the pipe syntax. For example, to load a fst file into a ``DataFrame``, one can use the following code:\n\n````julia\nusing FileIO, FstFiles, DataFrame\n\ndf = load(\"data.fst\") |\u003e DataFrame\n````\n\nTo save an iterable table, one can use the following form:\n\n````julia\nusing FileIO, FstFiles, DataFrame\n\ndf = # Aquire a DataFrame somehow\n\ndf |\u003e save(\"output.fst\")\n````\n\nThe pipe syntax is especially useful when combining it with [Query.jl](https://github.com/davidanthoff/Query.jl) queries, for example one can easily load a fst file, pipe it into a query, then pipe it to the ``save`` function to store the results in a new file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqueryverse%2Ffstfiles.jl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqueryverse%2Ffstfiles.jl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqueryverse%2Ffstfiles.jl/lists"}