Add basic CMake support for the iceberg library (#3)

Author: wgtmac

CMakeLists.txt

@@ -0,0 +1,63 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+cmake_minimum_required(VERSION 3.25)
+
+if(NOT CMAKE_BUILD_TYPE)
+  set(CMAKE_BUILD_TYPE Debug)
+endif()
+
+list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake_modules")
+
+project(
+  iceberg
+  VERSION 0.1.0
+  DESCRIPTION "Iceberg C++ Project"
+  LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+
+option(ICEBERG_BUILD_STATIC "Build static library" ON)
+option(ICEBERG_BUILD_SHARED "Build shared library" OFF)
+option(ICEBERG_BUILD_TESTS "Build tests" ON)
+
+include(CMakePackageConfigHelpers)
+include(CMakeParseArguments)
+include(BuildUtils)
+include(ExternalProject)
+include(FindPackageHandleStandardArgs)
+include(GNUInstallDirs)
+
+set(ICEBERG_API_DIR "${CMAKE_SOURCE_DIR}/api")
+set(ICEBERG_INSTALL_LIBDIR "${CMAKE_INSTALL_LIBDIR}")
+set(ICEBERG_INSTALL_BINDIR "${CMAKE_INSTALL_BINDIR}")
+set(ICEBERG_INSTALL_INCLUDEDIR "${CMAKE_INSTALL_INCLUDEDIR}")
+set(ICEBERG_INSTALL_CMAKEDIR "${CMAKE_INSTALL_LIBDIR}/cmake")
+set(ICEBERG_INSTALL_DOCDIR "share/doc/${PROJECT_NAME}")
+
+add_subdirectory(api)
+add_subdirectory(src)
+
+if(ICEBERG_BUILD_TESTS)
+  enable_testing()
+  add_subdirectory(test)
+endif()
+
+install(FILES LICENSE NOTICE DESTINATION ${ICEBERG_INSTALL_DOCDIR})

README.md

@@ -21,6 +21,34 @@
 
 C++ implementation of [Apache Iceberg™](https://iceberg.apache.org/).
 
+## Requirements
+
+- CMake 3.25 or higher
+- C++20 compliant compiler
+
+## Build
+
+### Build and Install Core Libraries
+
+```bash
+cd iceberg-cpp
+mkdir build && cd build
+cmake .. -DCMAKE_INSTALL_PREFIX=/tmp/iceberg -DICEBERG_BUILD_STATIC=ON -DICEBERG_BUILD_SHARED=ON
+cmake --build .
+cmake --install .
+```
+
+### Build Examples
+
+After installing the core libraries, you can build the examples:
+
+```bash
+cd iceberg-cpp/example
+mkdir build && cd build
+cmake .. -DCMAKE_PREFIX_PATH=/tmp/iceberg
+cmake --build .
+```
+
 ## Contribute
 
 Apache Iceberg is an active open-source project, governed under the Apache Software Foundation (ASF). Iceberg-cpp is open to people who want to contribute to it. Here are some ways to get involved:

api/CMakeLists.txt

@@ -0,0 +1,22 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+install(
+  DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/iceberg"
+  DESTINATION "${ICEBERG_INSTALL_INCLUDEDIR}"
+  FILES_MATCHING
+  PATTERN "*.h")

api/iceberg/puffin.h

@@ -0,0 +1,34 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+#pragma once
+
+#include <memory>
+#include <string_view>
+
+namespace iceberg {
+
+class Puffin {
+public:
+  virtual ~Puffin() = default;
+  virtual std::string_view print() const = 0;
+  static std::unique_ptr<Puffin> create();
+};
+
+} // namespace iceberg

api/iceberg/table.h

@@ -0,0 +1,34 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+#pragma once
+
+#include <memory>
+#include <string_view>
+
+namespace iceberg {
+
+class Table {
+public:
+  virtual ~Table() = default;
+  virtual std::string_view print() const = 0;
+  static std::unique_ptr<Table> create();
+};
+
+} // namespace iceberg