Merge branch 'master' into add_close

Author: zoziha

.github/workflows/fpm-deployment.yml

@@ -33,7 +33,7 @@ jobs:
     - name: Install fpm latest release
       uses: fortran-lang/setup-fpm@v3
       with:
-        github-token: ${{ secrets.GITHUB_TOKEN }}
+        fpm-version: 'v0.4.0'
 
     - name: Run fpm test ⚙
       run: |

CHANGELOG.md

@@ -0,0 +1,102 @@
+# Unreleased
+
+
+# Version 0.1.0
+
+Full release notes available at [v0.1.0] tag.
+
+[v0.1.0]: https://github.com/fortran-lang/stdlib/releases/tag/v0.1.0
+
+- new module `stdlib_ascii`
+  [#32](https://github.com/fortran-lang/stdlib/pull/32)
+- new module `stdlib_bitsets`
+  [#239](https://github.com/fortran-lang/stdlib/pull/239)
+  - new derived types `bitset_64` and `bitset_large`
+  - new abstract base class `bitset_type`
+- new module `stdlib_error`
+  [#53](https://github.com/fortran-lang/stdlib/pull/53)
+- new module `stdlib_io`
+  - new procedures `loadtxt` and `savetxt`
+    [#23](https://github.com/fortran-lang/stdlib/pull/23)
+    [#37](https://github.com/fortran-lang/stdlib/pull/37)
+  - new procedure `open`
+    [#71](https://github.com/fortran-lang/stdlib/pull/71)
+    [#77](https://github.com/fortran-lang/stdlib/pull/77)
+- new module `stdlib_kinds`
+  [#63](https://github.com/fortran-lang/stdlib/pull/63)
+- new module `stdlib_linalg`
+  - new procedures `diag`, `eye` and `trace`
+    [#170](https://github.com/fortran-lang/stdlib/pull/170)
+  - new procedure `outer_product`
+    [#432](https://github.com/fortran-lang/stdlib/pull/432)
+- new module `stdlib_logger`
+  - new derived type `logger_type`
+    [#228](https://github.com/fortran-lang/stdlib/pull/228)
+    [#261](https://github.com/fortran-lang/stdlib/pull/261)
+- new module `stdlib_math`
+  - new procedure `clip`
+    [#355](https://github.com/fortran-lang/stdlib/pull/355)
+  - new procedures `linspace` and `logspace`
+    [#420](https://github.com/fortran-lang/stdlib/pull/420)
+  - new procedure `arange`
+    [#480](https://github.com/fortran-lang/stdlib/pull/480)
+  - new procedure `gcd`
+    [#539](https://github.com/fortran-lang/stdlib/pull/539)
+- new module `stdlib_optval`
+  [#73](https://github.com/fortran-lang/stdlib/pull/73)
+  [#96](https://github.com/fortran-lang/stdlib/pull/96)
+  [#139](https://github.com/fortran-lang/stdlib/pull/139)
+- new module `stdlib_quadrature`
+  - new procedures `trapz`, `trapz_weights`, `simps` and `simps_weights`
+    [#146](https://github.com/fortran-lang/stdlib/pull/146)
+  - new procedures `gauss_legendre`, `gauss_legendre_lobatto`
+    [#313](https://github.com/fortran-lang/stdlib/pull/313)
+- new module `stdlib_random`
+  [#271](https://github.com/fortran-lang/stdlib/pull/271)
+- new module `stdlib_sorting`
+  - new procedures `sort`, `ord_sort` and `sort_index`
+    [#408](https://github.com/fortran-lang/stdlib/pull/408)
+- new module `stdlib_specialfunctions`
+  - new procedures `legendre` and `dlegendre`
+    [#313](https://github.com/fortran-lang/stdlib/pull/313)
+- new module `stdlib_stats`
+  - new procedure `mean`
+    [#124](https://github.com/fortran-lang/stdlib/pull/124)
+    [#130](https://github.com/fortran-lang/stdlib/pull/130)
+    [#132](https://github.com/fortran-lang/stdlib/pull/132)
+  - new procedure `var`
+    [#144](https://github.com/fortran-lang/stdlib/pull/144)
+  - new procedure `moment`
+    [#153](https://github.com/fortran-lang/stdlib/pull/153)
+  - new procedure `corr`
+    [#191](https://github.com/fortran-lang/stdlib/pull/191)
+  - new procedure `median`
+    [#426](https://github.com/fortran-lang/stdlib/pull/426)
+- new module `stdlib_string_type`
+  - new derived types `string_type`
+    [#320](https://github.com/fortran-lang/stdlib/pull/320)
+  - new procedure `move`
+    [#467](https://github.com/fortran-lang/stdlib/pull/467)
+- new module `stdlib_stringlist_type`
+  - new derived types `stringlist_type` and `stringlist_index_type`
+    [#470](https://github.com/fortran-lang/stdlib/pull/470)
+- new module `stdlib_strings`
+  - new procedure `to_string`
+    [#444](https://github.com/fortran-lang/stdlib/pull/444)
+  - new procedures `strip` and `chomp`
+    [#343](https://github.com/fortran-lang/stdlib/pull/343)
+  - new procedures `starts_with` and `ends_with`
+    [#384](https://github.com/fortran-lang/stdlib/pull/384)
+  - new procedure `slice`
+    [#414](https://github.com/fortran-lang/stdlib/pull/414)
+  - new procedure `find`
+    [#433](https://github.com/fortran-lang/stdlib/pull/433)
+  - new procedure `replace_all`
+    [#436](https://github.com/fortran-lang/stdlib/pull/436)
+  - new procedures `padl` and `padr`
+    [#441](https://github.com/fortran-lang/stdlib/pull/441)
+  - new procedure `count`
+    [#453](https://github.com/fortran-lang/stdlib/pull/453)
+- new module `stdlib_system`
+  - new procedure `sleep`
+    [#54](https://github.com/fortran-lang/stdlib/pull/54)

CMakeLists.txt

@@ -1,7 +1,7 @@
 cmake_minimum_required(VERSION 3.14.0)
 project(fortran_stdlib
         LANGUAGES Fortran
-        VERSION 0
+        VERSION 0.1.0
         DESCRIPTION "Community driven and agreed upon de facto standard library for Fortran"
 )
 enable_testing()

ci/fpm-deployment.sh

@@ -24,7 +24,6 @@ include=(
 prune=(
   "$destdir/test/test_always_fail.f90"
   "$destdir/test/test_always_skip.f90"
-  "$destdir/test/test_mean_f03.f90"
   "$destdir/src/common.f90"
   "$destdir/src/f18estop.f90"
 )
@@ -43,7 +42,7 @@ find src/tests -name "*.dat" -exec cp {} "$destdir/" \;
 # Include additional files
 cp "${include[@]}" "$destdir/"
 
-# Source file workarounds for fpm
+# Source file workarounds for fpm; ignore missing files
 rm "${prune[@]}"
 
 # List stdlib-fpm package contents

ci/fpm.toml

@@ -1,6 +1,9 @@
 name = "stdlib"
-version = "0.0.0"
+version = "0.1.0"
 license = "MIT"
 author = "stdlib contributors"
 maintainer = "@fortran-lang/stdlib"
 copyright = "2019-2021 stdlib contributors"
+
+[dev-dependencies]
+test-drive.git = "https://github.com/fortran-lang/test-drive"

config/CMakeLists.txt

@@ -10,6 +10,9 @@ if(NOT DEFINED CMAKE_INSTALL_MODULEDIR)
   )
 endif()
 
+list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
+set(CMAKE_MODULE_PATH "${CMAKE_MODULE_PATH}" PARENT_SCOPE)
+
 # Export a pkg-config file
 configure_file(
   "${CMAKE_CURRENT_SOURCE_DIR}/template.pc"

config/cmake/Findtest-drive.cmake

@@ -0,0 +1,178 @@
+# SPDX-Identifier: MIT
+
+#[[.rst:
+Find test-drive
+---------------
+
+Makes the test-drive project available.
+
+Imported Targets
+^^^^^^^^^^^^^^^^
+
+This module provides the following imported target, if found:
+
+``test-drive::test-drive``
+  The test-drive library
+
+
+Result Variables
+^^^^^^^^^^^^^^^^
+
+This module will define the following variables:
+
+``TEST_DRIVE_FOUND``
+  True if the test-drive library is available
+
+``TEST_DRIVE_SOURCE_DIR``
+  Path to the source directory of the test-drive project,
+  only set if the project is included as source.
+
+``TEST_DRIVE_BINARY_DIR``
+  Path to the binary directory of the test-drive project,
+  only set if the project is included as source.
+
+Cache variables
+^^^^^^^^^^^^^^^
+
+The following cache variables may be set to influence the library detection:
+
+``TEST_DRIVE_FIND_METHOD``
+  Methods to find or make the project available. Available methods are
+  - ``cmake``: Try to find via CMake config file
+  - ``pkgconf``: Try to find via pkg-config file
+  - ``subproject``: Use source in subprojects directory
+  - ``fetch``: Fetch the source from upstream
+
+``TEST_DRIVE_DIR``
+  Used for searching the CMake config file
+
+``TEST_DRIVE_SUBPROJECT``
+  Directory to find the test-drive subproject, relative to the project root
+
+#]]
+
+set(_lib "test-drive")
+set(_pkg "TEST_DRIVE")
+set(_url "https://github.com/fortran-lang/test-drive")
+
+if(NOT DEFINED "${_pkg}_FIND_METHOD")
+  if(DEFINED "${PROJECT_NAME}-dependency-method")
+    set("${_pkg}_FIND_METHOD" "${${PROJECT_NAME}-dependency-method}")
+  else()
+    set("${_pkg}_FIND_METHOD" "cmake" "pkgconf" "subproject" "fetch")
+  endif()
+  set("_${_pkg}_FIND_METHOD")
+endif()
+
+foreach(method ${${_pkg}_FIND_METHOD})
+  if(TARGET "${_lib}::${_lib}")
+    break()
+  endif()
+
+  if("${method}" STREQUAL "cmake")
+    message(STATUS "${_lib}: Find installed package")
+    if(DEFINED "${_pkg}_DIR")
+      set("_${_pkg}_DIR")
+      set("${_lib}_DIR" "${_pkg}_DIR")
+    endif()
+    find_package("${_lib}" CONFIG QUIET)
+    if("${_lib}_FOUND")
+      message(STATUS "${_lib}: Found installed package")
+      break()
+    endif()
+  endif()
+
+  if("${method}" STREQUAL "pkgconf")
+    find_package(PkgConfig QUIET)
+    pkg_check_modules("${_pkg}" QUIET "${_lib}")
+    if("${_pkg}_FOUND")
+      message(STATUS "Found ${_lib} via pkg-config")
+
+      add_library("${_lib}::${_lib}" INTERFACE IMPORTED)
+      target_link_libraries(
+        "${_lib}::${_lib}"
+        INTERFACE
+        "${${_pkg}_LINK_LIBRARIES}"
+        )
+      target_include_directories(
+        "${_lib}::${_lib}"
+        INTERFACE
+        "${${_pkg}_INCLUDE_DIRS}"
+        )
+
+      break()
+    endif()
+  endif()
+
+  if("${method}" STREQUAL "subproject")
+    if(NOT DEFINED "${_pkg}_SUBPROJECT")
+      set("_${_pkg}_SUBPROJECT")
+      set("${_pkg}_SUBPROJECT" "subprojects/${_lib}")
+    endif()
+    set("${_pkg}_SOURCE_DIR" "${PROJECT_SOURCE_DIR}/${${_pkg}_SUBPROJECT}")
+    set("${_pkg}_BINARY_DIR" "${PROJECT_BINARY_DIR}/${${_pkg}_SUBPROJECT}")
+    if(EXISTS "${${_pkg}_SOURCE_DIR}/CMakeLists.txt")
+      message(STATUS "Include ${_lib} from ${${_pkg}_SUBPROJECT}")
+      add_subdirectory(
+        "${${_pkg}_SOURCE_DIR}"
+        "${${_pkg}_BINARY_DIR}"
+      )
+
+      add_library("${_lib}::${_lib}" INTERFACE IMPORTED)
+      target_link_libraries("${_lib}::${_lib}" INTERFACE "${_lib}")
+
+      # We need the module directory in the subproject before we finish the configure stage
+      if(NOT EXISTS "${${_pkg}_BINARY_DIR}/include")
+        make_directory("${${_pkg}_BINARY_DIR}/include")
+      endif()
+
+      break()
+    endif()
+  endif()
+
+  if("${method}" STREQUAL "fetch")
+    message(STATUS "Retrieving ${_lib} from ${_url}")
+    include(FetchContent)
+    FetchContent_Declare(
+      "${_lib}"
+      GIT_REPOSITORY "${_url}"
+      GIT_TAG "HEAD"
+      )
+    FetchContent_MakeAvailable("${_lib}")
+
+    add_library("${_lib}::${_lib}" INTERFACE IMPORTED)
+    target_link_libraries("${_lib}::${_lib}" INTERFACE "${_lib}")
+
+    # We need the module directory in the subproject before we finish the configure stage
+    FetchContent_GetProperties("${_lib}" SOURCE_DIR "${_pkg}_SOURCE_DIR")
+    FetchContent_GetProperties("${_lib}" BINARY_DIR "${_pkg}_BINARY_DIR")
+    if(NOT EXISTS "${${_pkg}_BINARY_DIR}/include")
+      make_directory("${${_pkg}_BINARY_DIR}/include")
+    endif()
+
+    break()
+  endif()
+
+endforeach()
+
+if(TARGET "${_lib}::${_lib}")
+  set("${_pkg}_FOUND" TRUE)
+else()
+  set("${_pkg}_FOUND" FALSE)
+endif()
+
+if(DEFINED "_${_pkg}_SUBPROJECT")
+  unset("${_pkg}_SUBPROJECT")
+  unset("_${_pkg}_SUBPROJECT")
+endif()
+if(DEFINED "_${_pkg}_DIR")
+  unset("${_lib}_DIR")
+  unset("_${_pkg}_DIR")
+endif()
+if(DEFINED "_${_pkg}_FIND_METHOD")
+  unset("${_pkg}_FIND_METHOD")
+  unset("_${_pkg}_FIND_METHOD")
+endif()
+unset(_lib)
+unset(_pkg)
+unset(_url)

doc/changelog.md

@@ -0,0 +1,5 @@
+---
+title: Changelog
+---
+
+{!CHANGELOG.md!}

doc/specs/index.md

@@ -21,9 +21,10 @@ This is and index/directory of the specifications (specs) for each new module/fe
  - [math](./stdlib_math.html) - General purpose mathematical functions
  - [optval](./stdlib_optval.html) - Fallback value for optional arguments
  - [quadrature](./stdlib_quadrature.html) - Numerical integration
+ - [random](./stdlib_random.html) - Probability Distributions random number generator
  - [sorting](./stdlib_sorting.html) - Sorting of rank one arrays
  - [stats](./stdlib_stats.html) - Descriptive Statistics
- - [stats_distribution_PRNG](./stdlib_stats_distribution_PRNG.html) - Probability Distributions random number generator
+ - [stats_distributions_uniform](./stdlib_stats_distribution_uniform.html) - Uniform Probability Distribution
  - [string\_type](./stdlib_string_type.html) - Basic string support
  - [strings](./stdlib_strings.html) - String handling and manipulation routines
  - [stringlist_type](./stdlib_stringlist_type.html) - 1-Dimensional list of strings

doc/specs/stdlib_math.md

@@ -152,7 +152,7 @@ Experimental
 
 #### Class
 
-Function.
+Pure function.
 
 #### Argument(s)
 
@@ -224,7 +224,7 @@ Experimental
 
 #### Class
 
-Function.
+Pure function.
 
 #### Argument(s)