tensorflow / tensorflow/datasets

Incremental versioning as complement to semver

Open
#3,340 0 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Python
Stars
4.6k
Forks
1.6k
Avg merge
3h 54m
Merged PRs (30d)
1

Description

When we have changing data (e.g. scheduled training jobs on application data) and want to snapshot it with TFDS into a nice, workable and highly performant format for model training, we currently need to bump the semver tag manually.

Could we introduce an alternative versioning scheme with auto-incrementing per execution of tfds build?

E.g. let dataset builders configure something like tfds.core.Version(tfds.core.VersioningScheme.AUTOINCREMENT) such that tfds build my_dataset writes artifacts to data_dir/my_dataset/config/1 and a subsequent tfds build my_dataset writes artifacts to data_dir/my_dataset/config/2

I could try a proposal PR if this sounds acceptable. I also understand if you'd rather stay committed to semver, of course, but having auto-incrementing versioning could make TFDS easier to integrate with TFX so it might be worth pursuing (semi-related https://github.com/tensorflow/datasets/issues/2082).

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the existing tfds.core.Version entry point and the behavior of tfds build my_dataset, then read the related issue 2082. Done would require an agreed versioning design and a proposal PR covering automatic per-build artifact versions and compatibility with existing semver behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
python, tensorflow
Domain
data-engineering, machine-learning
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.