# Frictionless Framework
We are excited to announce our new high-level Python framework, frictionless-py: https://github.com/frictionlessdata/frictionless-py (opens new window). Frictionless-py was created to simplify overall user-experience for working with Frictionless Data in Python. It provides several high-level improvements in addition to many low-level fixes. Read more details below, or watch this intro video by Frictionless developer Evgeny: https://youtu.be/VPnC8cc6ly0 (opens new window)
# Why did we write new Python code?
Frictionless Data has been in development for almost a decade, with global users and projects spanning domains from science to government to finance. However, our main Python libraries (
tabulator) were originally built with some inconsistencies that have confused users over the years. We had started redoing our documentation for our existing code, and realized we had a larger issue on our hands - mainly that the disparate Python libraries had overlapping functionalities and we were not able to clearly articulate how they all fit together to form a bigger picture. We realized that overall, the existing user experience was not where we wanted it to be. Evgeny, the Frictionless Data technical lead developer, had been thinking about ways to improve the Python code for a while, and the outcome of that work is
# What happens to the old Python code (
tabulator-py)? How does this affect current users?
Datapackage-py (see details (opens new window)),
tableschema-py (see details (opens new window)),
tabulator-py (see details (opens new window)) still exist, will not be altered, and will be maintained. If your project is using this code, these changes are not breaking and there is no action you need to take at this point. However, we will be focusing new development on
frictionless-py, and encourage you to consider starting to experiment with or work with
frictionless-py during the last months of 2020 and migrate to it starting from 2021 (here is our migration guide) (opens new window). The one important thing to note is that
goodtables-py has been subsumed by
frictionless-py (since version 3 of Goodtables). We will continue to bug-fix
[email protected] in this branch (opens new window) and it is also still available on PyPi (opens new window) as it was before. Please note that
[email protected] version’s API is not stable as we are continuing to work on it at the moment. We will release
[email protected] by the end of 2020 to be the first SemVer/stable version.
# What does
Frictionless-py has four main functions for working with data: describe, extract, validate, and transform. These are inspired by typical data analysis and data management methods.
Describe your data: You can infer, edit and save metadata of your data tables. This is a first step for ensuring data quality and usability. Frictionless metadata includes general information about your data like textual description, as well as field types and other tabular data details.
Extract your data: You can read your data using a unified tabular interface. Data quality and consistency are guaranteed by a schema. Frictionless supports various file protocols like HTTP, FTP, and S3 and data formats like CSV, XLS, JSON, SQL, and others.
Validate your data: You can validate data tables, resources, and datasets. Frictionless generates a unified validation report, as well as supports a lot of options to customize the validation process.
Transform your data: You can clean, reshape, and transfer your data tables and datasets. Frictionless provides a pipeline capability and a lower-level interface to work with the data.
- Powerful Python framework
- Convenient command-line interface
- Low memory consumption for data of any size
- Reasonable performance on big data
- Support for compressed files
- Custom checks and formats
- Fully pluggable architecture
- The included API server
- More than 1000+ tests
# How can users get started?
We recommend that you begin by reading the Getting Started Guide (opens new window) and the Introduction Guide (opens new window). We also have in depth documentation for Describing Data (opens new window), Extracting Data (opens new window), Validating Data (opens new window), and Transforming Data (opens new window).
# How can you give us feedback?
What do you think? Let us know your thoughts, suggestions, or issues by joining us in our community chat on Discord (opens new window) or by opening an issue in the
frictionless-py repo: https://github.com/frictionlessdata/frictionless-py/issues (opens new window).
# Where’s the documentation?
Are you a new user? Start here: Getting Started (opens new window) & Introduction Guide (opens new window)
Are you an existing user? Start here: Migration Guide (opens new window)
The full list of documentation can be found here: https://github.com/frictionlessdata/frictionless-py#documentation (opens new window)
# What’s the difference between
frictionless is our new generation software while
goodtables are our previous generation software.
Frictionless has a lot of improvements over them. Please see this issue for the full answer and a code example: https://github.com/frictionlessdata/frictionless-py/issues/428 (opens new window)
# I’ve spotted a bug - where do I report it?
Let us know by opening an issue in the
frictionless-py repo: https://github.com/frictionlessdata/frictionless-py/issues (opens new window). For
datapackage issues, please use the corresponding issue tracker and we will triage it for you. Thanks!
# I have a question - where do I get help?
You can ask us questions in our Discord chat and someone from the main developer team or from the community will help you. Here is an invitation link: https://discord.com/invite/j9DNFNw (opens new window). We also have a Twitter account (@frictionlessd8a) (opens new window) and community calls where you can come meet the team and ask questions: http://frictionlessdata.io/events/ (opens new window).
# I want to help - how do I contribute?
Amazing, thank you! We always welcome community contributions. Start here (https://frictionlessdata.io/contribute/ (opens new window)) and here (https://github.com/frictionlessdata/frictionless-py/blob/master/CONTRIBUTING.md (opens new window)) and you can also reach out to Evgeny (@roll) or Lilly (@lwinfree) on GitHub if you need help.
# Additional Links/Resources
- Intro to
frictionless-pyvideo: https://youtu.be/VPnC8cc6ly0 (opens new window)
frictionless-pyrepository: https://github.com/frictionlessdata/frictionless-py (opens new window)
- Frictionless Data website: https://frictionlessdata.io/ (opens new window)