Skip to content

Commit e4d9942

Browse files
authored
[Geospatial]: Scaffolding for new parquet-geospatial crate (#8375)
# Which issue does this PR close? - Closes #8374. # Rationale for this change # What changes are included in this PR? # Are these changes tested? # Are there any user-facing changes?
1 parent ae8e6c6 commit e4d9942

File tree

4 files changed

+110
-0
lines changed

4 files changed

+110
-0
lines changed

Cargo.toml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,7 @@ members = [
3939
"arrow-select",
4040
"arrow-string",
4141
"parquet",
42+
"parquet-geospatial",
4243
"parquet-variant",
4344
"parquet-variant-compute",
4445
"parquet-variant-json",
@@ -102,6 +103,7 @@ arrow-string = { version = "56.2.0", path = "./arrow-string" }
102103
parquet = { version = "56.2.0", path = "./parquet", default-features = false }
103104

104105
# These crates have not yet been released and thus do not use the workspace version
106+
parquet-geospatial = { version = "0.1.0", path = "./parquet-geospatial" }
105107
parquet-variant = { version = "0.1.0", path = "./parquet-variant" }
106108
parquet-variant-json = { version = "0.1.0", path = "./parquet-variant-json" }
107109
parquet-variant-compute = { version = "0.1.0", path = "./parquet-variant-compute" }

parquet-geospatial/Cargo.toml

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Licensed to the Apache Software Foundation (ASF) under one
2+
# or more contributor license agreements. See the NOTICE file
3+
# distributed with this work for additional information
4+
# regarding copyright ownership. The ASF licenses this file
5+
# to you under the Apache License, Version 2.0 (the
6+
# "License"); you may not use this file except in compliance
7+
# with the License. You may obtain a copy of the License at
8+
#
9+
# http://www.apache.org/licenses/LICENSE-2.0
10+
#
11+
# Unless required by applicable law or agreed to in writing,
12+
# software distributed under the License is distributed on an
13+
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
# KIND, either express or implied. See the License for the
15+
# specific language governing permissions and limitations
16+
# under the License.
17+
18+
[package]
19+
name = "parquet-geospatial"
20+
# This package is still in development and thus the version does
21+
# not follow the versions of the rest of the crates in this repo.
22+
version = "0.1.0"
23+
license = { workspace = true }
24+
description = "Apache Parquet Geometry and Geography implementation in Rust"
25+
homepage = { workspace = true }
26+
repository = { workspace = true }
27+
authors = { workspace = true }
28+
keywords = ["arrow", "parquet", "geometry", "geography"]
29+
readme = "README.md"
30+
edition = { workspace = true }
31+
rust-version = { workspace = true }
32+
33+
[dependencies]
34+
35+
[lib]
36+
name = "parquet_geospatial"
37+
bench = false

parquet-geospatial/README.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
<!---
2+
Licensed to the Apache Software Foundation (ASF) under one
3+
or more contributor license agreements. See the NOTICE file
4+
distributed with this work for additional information
5+
regarding copyright ownership. The ASF licenses this file
6+
to you under the Apache License, Version 2.0 (the
7+
"License"); you may not use this file except in compliance
8+
with the License. You may obtain a copy of the License at
9+
10+
http://www.apache.org/licenses/LICENSE-2.0
11+
12+
Unless required by applicable law or agreed to in writing,
13+
software distributed under the License is distributed on an
14+
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15+
KIND, either express or implied. See the License for the
16+
specific language governing permissions and limitations
17+
under the License.
18+
-->
19+
20+
# Apache Parquet Geometry/Geography Rust Implementation
21+
22+
[![crates.io](https://img.shields.io/crates/v/parquet-geospatial.svg)](https://crates.io/crates/parquet-geospatial)
23+
[![docs.rs](https://img.shields.io/docsrs/parquet-geospatial.svg)](https://docs.rs/parquet/latest/parquet-geospatial/)
24+
25+
This crate contains an implementation of [Geometry and Geography Encoding] from
26+
[Apache Parquet]. This software is developed as part of the [Apache Arrow] project.
27+
28+
[Geometry and Geography Encoding]: https://github.com/apache/parquet-format/blob/master/Geospatial.md
29+
[Apache Parquet]: https://parquet.apache.org/
30+
[Apache Arrow]: https://arrow.apache.org/
31+
32+
Please see the [API documentation](https://docs.rs/parquet-geospatial/latest) for more details.
33+
34+
## 🚧 Work In Progress
35+
36+
NOTE: This crate is under active development and is not yet ready for production use.
37+
If you are interested in helping, you can find more information on the GitHub [Geometry issue]
38+
39+
[Geometry issue]: https://github.com/apache/arrow-rs/issues/8373
40+
41+
## License
42+
43+
Licensed under the Apache License, Version 2.0: <http://www.apache.org/licenses/LICENSE-2.0>.

parquet-geospatial/src/lib.rs

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
// Licensed to the Apache Software Foundation (ASF) under one
2+
// or more contributor license agreements. See the NOTICE file
3+
// distributed with this work for additional information
4+
// regarding copyright ownership. The ASF licenses this file
5+
// to you under the Apache License, Version 2.0 (the
6+
// "License"); you may not use this file except in compliance
7+
// with the License. You may obtain a copy of the License at
8+
//
9+
// http://www.apache.org/licenses/LICENSE-2.0
10+
//
11+
// Unless required by applicable law or agreed to in writing,
12+
// software distributed under the License is distributed on an
13+
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
// KIND, either express or implied. See the License for the
15+
// specific language governing permissions and limitations
16+
// under the License.
17+
18+
//! Implementation of [Geometry and Geography Encoding] from [Apache Parquet].
19+
//!
20+
//! [Geometry and Geography Encoding]: https://github.com/apache/parquet-format/blob/master/Geospatial.md
21+
//! [Apache Parquet]: https://parquet.apache.org/
22+
//!
23+
//! ## 🚧 Work In Progress
24+
//!
25+
//! This crate is under active development and is not yet ready for production use.
26+
//! If you are interested in helping, you can find more information on the GitHub [Geometry issue]
27+
//!
28+
//! [Geometry issue]: https://github.com/apache/arrow-rs/issues/8373

0 commit comments

Comments
 (0)