Introduce a "tokio" to allow pulling a trait-only build by AdamGS · Pull Request #644 · apache/arrow-rs-object-store

AdamGS · 2026-02-16T12:54:32Z

Which issue does this PR close?

Closes #.

Rationale for this change

This change allows users to pull a trait-only build that doesn't require tokio, keeping it very lightweight (its one of the top 3 slowest dependencies to build when building without default features, next to syn and futures-util).

I've also considered making the http dependency optional, and I think it might be possible to make url optional too, but I'm not sure what's the desired balance here and figured its worth getting some feedback first.

Running cargo tree -e normal --no-default-features on this branch shows:

object_store v0.13.1 (/Users/adamgs/code/object-store)
object_store v0.13.1 (/Users/adamgs/code/object-store)
├── async-trait v0.1.89 (proc-macro)
│   ├── proc-macro2 v1.0.105
│   │   └── unicode-ident v1.0.22
│   ├── quote v1.0.43
│   │   └── proc-macro2 v1.0.105 (*)
│   └── syn v2.0.114
│       ├── proc-macro2 v1.0.105 (*)
│       ├── quote v1.0.43 (*)
│       └── unicode-ident v1.0.22
├── bytes v1.11.0
├── chrono v0.4.43
│   ├── iana-time-zone v0.1.64
│   │   └── core-foundation-sys v0.8.7
│   └── num-traits v0.2.19
├── futures v0.3.31
│   ├── futures-channel v0.3.31
│   │   ├── futures-core v0.3.31
│   │   └── futures-sink v0.3.31
│   ├── futures-core v0.3.31
│   ├── futures-executor v0.3.31
│   │   ├── futures-core v0.3.31
│   │   ├── futures-task v0.3.31
│   │   └── futures-util v0.3.31
│   │       ├── futures-channel v0.3.31 (*)
│   │       ├── futures-core v0.3.31
│   │       ├── futures-io v0.3.31
│   │       ├── futures-macro v0.3.31 (proc-macro)
│   │       │   ├── proc-macro2 v1.0.105 (*)
│   │       │   ├── quote v1.0.43 (*)
│   │       │   └── syn v2.0.114 (*)
│   │       ├── futures-sink v0.3.31
│   │       ├── futures-task v0.3.31
│   │       ├── memchr v2.7.6
│   │       ├── pin-project-lite v0.2.16
│   │       ├── pin-utils v0.1.0
│   │       └── slab v0.4.11
│   ├── futures-io v0.3.31
│   ├── futures-sink v0.3.31
│   ├── futures-task v0.3.31
│   └── futures-util v0.3.31 (*)
├── http v1.4.0
│   ├── bytes v1.11.0
│   └── itoa v1.0.17
├── humantime v2.3.0
├── itertools v0.14.0
│   └── either v1.15.0
├── parking_lot v0.12.5
│   ├── lock_api v0.4.14
│   │   └── scopeguard v1.2.0
│   └── parking_lot_core v0.9.12
│       ├── cfg-if v1.0.4
│       ├── libc v0.2.180
│       └── smallvec v1.15.1
├── percent-encoding v2.3.2
├── thiserror v2.0.17
│   └── thiserror-impl v2.0.17 (proc-macro)
│       ├── proc-macro2 v1.0.105 (*)
│       ├── quote v1.0.43 (*)
│       └── syn v2.0.114 (*)
└── url v2.5.8
    ├── form_urlencoded v1.2.2
    │   └── percent-encoding v2.3.2
    ├── idna v1.1.0
    │   ├── idna_adapter v1.2.1
    │   │   ├── icu_normalizer v2.1.1
    │   │   │   ├── icu_collections v2.1.1
    │   │   │   │   ├── displaydoc v0.2.5 (proc-macro)
    │   │   │   │   │   ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │   ├── quote v1.0.43 (*)
    │   │   │   │   │   └── syn v2.0.114 (*)
    │   │   │   │   ├── potential_utf v0.1.4
    │   │   │   │   │   └── zerovec v0.11.5
    │   │   │   │   │       ├── yoke v0.8.1
    │   │   │   │   │       │   ├── stable_deref_trait v1.2.1
    │   │   │   │   │       │   ├── yoke-derive v0.8.1 (proc-macro)
    │   │   │   │   │       │   │   ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │       │   │   ├── quote v1.0.43 (*)
    │   │   │   │   │       │   │   ├── syn v2.0.114 (*)
    │   │   │   │   │       │   │   └── synstructure v0.13.2
    │   │   │   │   │       │   │       ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │       │   │       ├── quote v1.0.43 (*)
    │   │   │   │   │       │   │       └── syn v2.0.114 (*)
    │   │   │   │   │       │   └── zerofrom v0.1.6
    │   │   │   │   │       │       └── zerofrom-derive v0.1.6 (proc-macro)
    │   │   │   │   │       │           ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │       │           ├── quote v1.0.43 (*)
    │   │   │   │   │       │           ├── syn v2.0.114 (*)
    │   │   │   │   │       │           └── synstructure v0.13.2 (*)
    │   │   │   │   │       ├── zerofrom v0.1.6 (*)
    │   │   │   │   │       └── zerovec-derive v0.11.2 (proc-macro)
    │   │   │   │   │           ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │           ├── quote v1.0.43 (*)
    │   │   │   │   │           └── syn v2.0.114 (*)
    │   │   │   │   ├── yoke v0.8.1 (*)
    │   │   │   │   ├── zerofrom v0.1.6 (*)
    │   │   │   │   └── zerovec v0.11.5 (*)
    │   │   │   ├── icu_normalizer_data v2.1.1
    │   │   │   ├── icu_provider v2.1.1
    │   │   │   │   ├── displaydoc v0.2.5 (proc-macro) (*)
    │   │   │   │   ├── icu_locale_core v2.1.1
    │   │   │   │   │   ├── displaydoc v0.2.5 (proc-macro) (*)
    │   │   │   │   │   ├── litemap v0.8.1
    │   │   │   │   │   ├── tinystr v0.8.2
    │   │   │   │   │   │   ├── displaydoc v0.2.5 (proc-macro) (*)
    │   │   │   │   │   │   └── zerovec v0.11.5 (*)
    │   │   │   │   │   ├── writeable v0.6.2
    │   │   │   │   │   └── zerovec v0.11.5 (*)
    │   │   │   │   ├── writeable v0.6.2
    │   │   │   │   ├── yoke v0.8.1 (*)
    │   │   │   │   ├── zerofrom v0.1.6 (*)
    │   │   │   │   ├── zerotrie v0.2.3
    │   │   │   │   │   ├── displaydoc v0.2.5 (proc-macro) (*)
    │   │   │   │   │   ├── yoke v0.8.1 (*)
    │   │   │   │   │   └── zerofrom v0.1.6 (*)
    │   │   │   │   └── zerovec v0.11.5 (*)
    │   │   │   ├── smallvec v1.15.1
    │   │   │   └── zerovec v0.11.5 (*)
    │   │   └── icu_properties v2.1.2
    │   │       ├── icu_collections v2.1.1 (*)
    │   │       ├── icu_locale_core v2.1.1 (*)
    │   │       ├── icu_properties_data v2.1.2
    │   │       ├── icu_provider v2.1.1 (*)
    │   │       ├── zerotrie v0.2.3 (*)
    │   │       └── zerovec v0.11.5 (*)
    │   ├── smallvec v1.15.1
    │   └── utf8_iter v1.0.4
    └── percent-encoding v2.3.2

While currently on main it prints:

object_store v0.13.1 (/Users/adamgs/code/object-store)
├── async-trait v0.1.89 (proc-macro)
│   ├── proc-macro2 v1.0.105
│   │   └── unicode-ident v1.0.22
│   ├── quote v1.0.43
│   │   └── proc-macro2 v1.0.105 (*)
│   └── syn v2.0.114
│       ├── proc-macro2 v1.0.105 (*)
│       ├── quote v1.0.43 (*)
│       └── unicode-ident v1.0.22
├── bytes v1.11.0
├── chrono v0.4.43
│   ├── iana-time-zone v0.1.64
│   │   └── core-foundation-sys v0.8.7
│   └── num-traits v0.2.19
├── futures v0.3.31
│   ├── futures-channel v0.3.31
│   │   ├── futures-core v0.3.31
│   │   └── futures-sink v0.3.31
│   ├── futures-core v0.3.31
│   ├── futures-executor v0.3.31
│   │   ├── futures-core v0.3.31
│   │   ├── futures-task v0.3.31
│   │   └── futures-util v0.3.31
│   │       ├── futures-channel v0.3.31 (*)
│   │       ├── futures-core v0.3.31
│   │       ├── futures-io v0.3.31
│   │       ├── futures-macro v0.3.31 (proc-macro)
│   │       │   ├── proc-macro2 v1.0.105 (*)
│   │       │   ├── quote v1.0.43 (*)
│   │       │   └── syn v2.0.114 (*)
│   │       ├── futures-sink v0.3.31
│   │       ├── futures-task v0.3.31
│   │       ├── memchr v2.7.6
│   │       ├── pin-project-lite v0.2.16
│   │       ├── pin-utils v0.1.0
│   │       └── slab v0.4.11
│   ├── futures-io v0.3.31
│   ├── futures-sink v0.3.31
│   ├── futures-task v0.3.31
│   └── futures-util v0.3.31 (*)
├── http v1.4.0
│   ├── bytes v1.11.0
│   └── itoa v1.0.17
├── humantime v2.3.0
├── itertools v0.14.0
│   └── either v1.15.0
├── parking_lot v0.12.5
│   ├── lock_api v0.4.14
│   │   └── scopeguard v1.2.0
│   └── parking_lot_core v0.9.12
│       ├── cfg-if v1.0.4
│       ├── libc v0.2.180
│       └── smallvec v1.15.1
├── percent-encoding v2.3.2
├── thiserror v2.0.17
│   └── thiserror-impl v2.0.17 (proc-macro)
│       ├── proc-macro2 v1.0.105 (*)
│       ├── quote v1.0.43 (*)
│       └── syn v2.0.114 (*)
├── tokio v1.49.0
│   ├── bytes v1.11.0
│   ├── pin-project-lite v0.2.16
│   └── tokio-macros v2.6.0 (proc-macro)
│       ├── proc-macro2 v1.0.105 (*)
│       ├── quote v1.0.43 (*)
│       └── syn v2.0.114 (*)
├── tracing v0.1.44
│   ├── pin-project-lite v0.2.16
│   ├── tracing-attributes v0.1.31 (proc-macro)
│   │   ├── proc-macro2 v1.0.105 (*)
│   │   ├── quote v1.0.43 (*)
│   │   └── syn v2.0.114 (*)
│   └── tracing-core v0.1.36
│       └── once_cell v1.21.3
└── url v2.5.8
    ├── form_urlencoded v1.2.2
    │   └── percent-encoding v2.3.2
    ├── idna v1.1.0
    │   ├── idna_adapter v1.2.1
    │   │   ├── icu_normalizer v2.1.1
    │   │   │   ├── icu_collections v2.1.1
    │   │   │   │   ├── displaydoc v0.2.5 (proc-macro)
    │   │   │   │   │   ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │   ├── quote v1.0.43 (*)
    │   │   │   │   │   └── syn v2.0.114 (*)
    │   │   │   │   ├── potential_utf v0.1.4
    │   │   │   │   │   └── zerovec v0.11.5
    │   │   │   │   │       ├── yoke v0.8.1
    │   │   │   │   │       │   ├── stable_deref_trait v1.2.1
    │   │   │   │   │       │   ├── yoke-derive v0.8.1 (proc-macro)
    │   │   │   │   │       │   │   ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │       │   │   ├── quote v1.0.43 (*)
    │   │   │   │   │       │   │   ├── syn v2.0.114 (*)
    │   │   │   │   │       │   │   └── synstructure v0.13.2
    │   │   │   │   │       │   │       ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │       │   │       ├── quote v1.0.43 (*)
    │   │   │   │   │       │   │       └── syn v2.0.114 (*)
    │   │   │   │   │       │   └── zerofrom v0.1.6
    │   │   │   │   │       │       └── zerofrom-derive v0.1.6 (proc-macro)
    │   │   │   │   │       │           ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │       │           ├── quote v1.0.43 (*)
    │   │   │   │   │       │           ├── syn v2.0.114 (*)
    │   │   │   │   │       │           └── synstructure v0.13.2 (*)
    │   │   │   │   │       ├── zerofrom v0.1.6 (*)
    │   │   │   │   │       └── zerovec-derive v0.11.2 (proc-macro)
    │   │   │   │   │           ├── proc-macro2 v1.0.105 (*)
    │   │   │   │   │           ├── quote v1.0.43 (*)
    │   │   │   │   │           └── syn v2.0.114 (*)
    │   │   │   │   ├── yoke v0.8.1 (*)
    │   │   │   │   ├── zerofrom v0.1.6 (*)
    │   │   │   │   └── zerovec v0.11.5 (*)
    │   │   │   ├── icu_normalizer_data v2.1.1
    │   │   │   ├── icu_provider v2.1.1
    │   │   │   │   ├── displaydoc v0.2.5 (proc-macro) (*)
    │   │   │   │   ├── icu_locale_core v2.1.1
    │   │   │   │   │   ├── displaydoc v0.2.5 (proc-macro) (*)
    │   │   │   │   │   ├── litemap v0.8.1
    │   │   │   │   │   ├── tinystr v0.8.2
    │   │   │   │   │   │   ├── displaydoc v0.2.5 (proc-macro) (*)
    │   │   │   │   │   │   └── zerovec v0.11.5 (*)
    │   │   │   │   │   ├── writeable v0.6.2
    │   │   │   │   │   └── zerovec v0.11.5 (*)
    │   │   │   │   ├── writeable v0.6.2
    │   │   │   │   ├── yoke v0.8.1 (*)
    │   │   │   │   ├── zerofrom v0.1.6 (*)
    │   │   │   │   ├── zerotrie v0.2.3
    │   │   │   │   │   ├── displaydoc v0.2.5 (proc-macro) (*)
    │   │   │   │   │   ├── yoke v0.8.1 (*)
    │   │   │   │   │   └── zerofrom v0.1.6 (*)
    │   │   │   │   └── zerovec v0.11.5 (*)
    │   │   │   ├── smallvec v1.15.1
    │   │   │   └── zerovec v0.11.5 (*)
    │   │   └── icu_properties v2.1.2
    │   │       ├── icu_collections v2.1.1 (*)
    │   │       ├── icu_locale_core v2.1.1 (*)
    │   │       ├── icu_properties_data v2.1.2
    │   │       ├── icu_provider v2.1.1 (*)
    │   │       ├── zerotrie v0.2.3 (*)
    │   │       └── zerovec v0.11.5 (*)
    │   ├── smallvec v1.15.1
    │   └── utf8_iter v1.0.4
    └── percent-encoding v2.3.2

What changes are included in this PR?

Introduces a new "tokio" feature, which is enabled by default through both the "fs" feature and "cloud" feature. The feature pulls in both tokio and tracing, and enables all provided middlewares (retry, throttling, buffered::*, and LimitStore).

Are there any user-facing changes?

For users pulling the crate without default features, they won't be able to use all the middlewares mentioned above.

Signed-off-by: Adam Gutglick <adamgsal@gmail.com>

crepererum · 2026-02-16T13:37:07Z

Looks clean, thank you. One suggestions: Could you add a small note about the tokio feature and the fact that the core trait don't require tokio to this paragraph here:

arrow-rs-object-store/src/lib.rs

Lines 70 to 98 in 030f29d

    
           //! # Available [`ObjectStore`] Implementations 
        
           //! 
        
           //! By default, this crate provides the following implementations: 
        
           //! 
        
           //! * Memory: [`InMemory`](memory::InMemory) 
        
           //! 
        
           //! Feature flags are used to enable support for other implementations: 
        
           //! 
        
           #![cfg_attr( 
        
               feature = "fs", 
        
               doc = "* Local filesystem: [`LocalFileSystem`](local::LocalFileSystem)" 
        
           )] 
        
           #![cfg_attr( 
        
               feature = "gcp", 
        
               doc = "* [`gcp`]: [Google Cloud Storage](https://cloud.google.com/storage/) support. See [`GoogleCloudStorageBuilder`](gcp::GoogleCloudStorageBuilder)" 
        
           )] 
        
           #![cfg_attr( 
        
               feature = "aws", 
        
               doc = "* [`aws`]: [Amazon S3](https://aws.amazon.com/s3/). See [`AmazonS3Builder`](aws::AmazonS3Builder)" 
        
           )] 
        
           #![cfg_attr( 
        
               feature = "azure", 
        
               doc = "* [`azure`]: [Azure Blob Storage](https://azure.microsoft.com/en-gb/services/storage/blobs/). See [`MicrosoftAzureBuilder`](azure::MicrosoftAzureBuilder)" 
        
           )] 
        
           #![cfg_attr( 
        
               feature = "http", 
        
               doc = "* [`http`]: [HTTP/WebDAV Storage](https://datatracker.ietf.org/doc/html/rfc2518). See [`HttpBuilder`](http::HttpBuilder)" 
        
           )] 
        
           //!

Based on your cargo tree output, I think we may want to double-check our usage of the futures umbrella crate at some point.

AdamGS · 2026-02-16T13:40:18Z

will do, also happy to shave down the futures dependency in this PR

AdamGS · 2026-02-16T14:02:58Z

Pushed the docs change, this is how it looks:

AdamGS · 2026-02-16T14:24:31Z

Ok I also have a commit splitting the futures dependency into the required subcrates, would you like to have it as part of this PR or as a separate one?

crepererum · 2026-02-18T10:32:17Z

Ok I also have a commit splitting the futures dependency into the required subcrates, would you like to have it as part of this PR or as a separate one?

Let's do that as a separate follow-up PR.

crepererum

thank you

michaelkirk · 2026-04-17T22:01:27Z

Thanks for the crate!

For the record, this broke our build. Since this is a pre-1.0 crate, I would appreciate it if you'd bump the minor version (0.MINOR.PATCH) before releasing changes like this in the future.

nyurik · 2026-04-17T22:20:58Z

would it be possible to add semver checker to the CI? object-store is becoming massively important and offers a great abstraction over all providers, so version stability would really help. Thanks again for amazing work!

in 0.13.2, object_store made tokio optional in a patch release See: apache/arrow-rs-object-store#644 Ideally this would have been in a object_store 0.14.0 release. --------- Co-authored-by: Yuri Astrakhan <yuriastrakhan@gmail.com>

crepererum · 2026-04-27T09:49:00Z

Please continue the "semver breaking" discussion in #677.

Introduce a "tokio" to allow pulling a trait-only build

c323805

Signed-off-by: Adam Gutglick <adamgsal@gmail.com>

AdamGS mentioned this pull request Feb 16, 2026

Introduce a platform agnostic sleep future #514

Closed

crepererum approved these changes Feb 18, 2026

View reviewed changes

crepererum merged commit 8140480 into apache:main Feb 18, 2026
10 checks passed

AdamGS mentioned this pull request Feb 18, 2026

Minimize futures dependency into relevant sub-crates #646

Merged

crepererum mentioned this pull request Mar 31, 2026

object_store 0.13.2 breaks backward compatibility in patch release #677

Open

michaelkirk mentioned this pull request Apr 17, 2026

chore: update object_store dependency and fix build stadiamaps/pmtiles-rs#119

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Introduce a "tokio" to allow pulling a trait-only build#644

Introduce a "tokio" to allow pulling a trait-only build#644
crepererum merged 1 commit into
apache:mainfrom
AdamGS:adamg/no-tokio-feature-set

AdamGS commented Feb 16, 2026

Uh oh!

crepererum commented Feb 16, 2026 •

edited

Loading

Uh oh!

AdamGS commented Feb 16, 2026

Uh oh!

AdamGS commented Feb 16, 2026

Uh oh!

AdamGS commented Feb 16, 2026

Uh oh!

crepererum commented Feb 18, 2026

Uh oh!

crepererum left a comment

Uh oh!

Uh oh!

michaelkirk commented Apr 17, 2026

Uh oh!

nyurik commented Apr 17, 2026

Uh oh!

crepererum commented Apr 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

AdamGS commented Feb 16, 2026

Which issue does this PR close?

Rationale for this change

What changes are included in this PR?

Are there any user-facing changes?

Uh oh!

crepererum commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

AdamGS commented Feb 16, 2026

Uh oh!

AdamGS commented Feb 16, 2026

Uh oh!

AdamGS commented Feb 16, 2026

Uh oh!

crepererum commented Feb 18, 2026

Uh oh!

crepererum left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

michaelkirk commented Apr 17, 2026

Uh oh!

nyurik commented Apr 17, 2026

Uh oh!

crepererum commented Apr 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

crepererum commented Feb 16, 2026 •

edited

Loading