WiP: Make Xpeccy packageable, XDG spec compliance

3rdparty/xdgpp/.builds/archlinux.yml

@@ -0,0 +1,14 @@
+image: archlinux
+packages:
+  - gcc
+  - clang
+  - catch2
+sources:
+  - https://git.sr.ht/~danyspin97/xdgpp
+tasks:
+  - test-gcc: |
+      cd xdgpp
+      CXX=g++ make clean && make test -j2
+  - test-clang: |
+      cd xdgpp
+      CXX=clang++ make clean && make test -j2

3rdparty/xdgpp/.clang-format

@@ -0,0 +1,5 @@
+---
+Language:        Cpp
+# BasedOnStyle:  Google
+AccessModifierOffset: -4
+IndentWidth:     4

3rdparty/xdgpp/.clang-tidy

@@ -0,0 +1,37 @@
+---
+Checks:          'clang-diagnostic-*,clang-analyzer-*,misc-*,modernize-*,performance-*,readability-*,portability-*,cppcoreguidelines-*,bugprone-*,hicpp-*'
+WarningsAsErrors: ''
+HeaderFilterRegex: ''
+AnalyzeTemporaryDtors: false
+FormatStyle:     none
+CheckOptions:
+  - key:             cert-dcl16-c.NewSuffixes
+    value:           'L;LL;LU;LLU'
+  - key:             cert-oop54-cpp.WarnOnlyIfThisHasSuspiciousField
+    value:           '0'
+  - key:             cppcoreguidelines-explicit-virtual-functions.IgnoreDestructors
+    value:           '1'
+  - key:             cppcoreguidelines-non-private-member-variables-in-classes.IgnoreClassesWithAllMemberVariablesBeingPublic
+    value:           '1'
+  - key:             google-readability-braces-around-statements.ShortStatementLines
+    value:           '1'
+  - key:             google-readability-function-size.StatementThreshold
+    value:           '800'
+  - key:             google-readability-namespace-comments.ShortNamespaceLines
+    value:           '10'
+  - key:             google-readability-namespace-comments.SpacesBeforeComments
+    value:           '2'
+  - key:             llvm-qualified-auto.AddConstToQualified
+    value:           '0'
+  - key:             modernize-loop-convert.MaxCopySize
+    value:           '16'
+  - key:             modernize-loop-convert.MinConfidence
+    value:           reasonable
+  - key:             modernize-pass-by-value.IncludeStyle
+    value:           google
+  - key:             modernize-replace-auto-ptr.IncludeStyle
+    value:           google
+  - key:             modernize-use-nullptr.NullMacros
+    value:           'NULL'
+...
+

3rdparty/xdgpp/.gitignore

@@ -0,0 +1,2 @@
+*.o
+xdg_test

3rdparty/xdgpp/LICENSE

@@ -0,0 +1,20 @@
+Copyright © 2020 Danilo Spinella <oss@danyspin97.org>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

3rdparty/xdgpp/Makefile

@@ -0,0 +1,21 @@
+CXX?=g++
+CXXFLAGS?=
+DEFAULT_CXXFLAGS:=-std=c++17 -Werror -Wall
+CXXFLAGS+=$(DEFAULT_CXXFLAGS)
+CATCH2_CXXFLAGS:=-DCATCH_CONFIG_MAIN -DCATCH_CONFIG_FAST_COMPILE
+CXXFLAGS+=$(CATCH2_CXXFLAGS)
+INCLUDES:=-I.
+NAME:=xdg_test
+
+SOURCES=xdg_test.cpp
+OBJ=$(SOURCES:.cpp=.o)
+
+xdg_test: $(OBJ)
+	$(CXX) $(CXXFLAGS) $(INCLUDES) $^ -o $(NAME)
+
+test: xdg_test
+	./xdg_test
+
+.PHONY: clean
+clean:
+	rm -f $(OBJ) $(NAME)

3rdparty/xdgpp/README.md

@@ -0,0 +1,70 @@
+# xdgpp
+
+[![builds.sr.ht status](https://builds.sr.ht/~danyspin97/xdgpp.svg)](https://builds.sr.ht/~danyspin97/xdgpp?)
+![Liberapay receiving](https://img.shields.io/liberapay/receives/danyspin97?logo=liberapay)
+
+C++17 header-only implementation of the [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html).
+
+## Installation
+
+Copy `xdg.hpp` into your source tree.
+
+## Usage
+
+```cpp
+#include <iostream>
+
+#include "xdg.hpp"
+
+int main() {
+    std::cout << "$XDG_DATA_HOME = " << xdg::DataHomeDir() << std::endl;
+    std::cout << "$XDG_CONFIG_HOME = " << xdg::ConfigHomeDir() << std::endl;
+    std::cout << "$XDG_CACHE_HOME = " << xdg::CacheHomeDir() << std::endl;
+
+    auto data_dirs = xdg::DataDirs();
+    std::cout << "$XDG_DATA_DIRS = \"" << data_dirs.front().c_str();
+    for (int i = 1; i < data_dirs.size(); i++) {
+        std::cout << ":" << data_dirs.at(i).c_str();
+    }
+    std::cout << "\"" << std::endl;
+
+    auto config_dirs = xdg::ConfigDirs();
+    std::cout << "$XDG_CONFIG_DIRS = \"" << config_dirs.front().c_str();
+    for (int i = 1; i < config_dirs.size(); i++) {
+        std::cout << ":" << config_dirs.at(i).c_str();
+    }
+    std::cout << "\"" << std::endl;
+
+    // XDG_RUNTIME_DIR might not be set, the API returns a std::optional
+    auto runtime_dir = xdg::RuntimeDir();
+    if (runtime_dir) {
+        std::cout << "$XDG_RUNTIME_DIR = " << runtime_dir.value();
+    }
+
+    return 0;
+}
+```
+
+Alternatively you can create and use an instance of `xdg::BaseDirectories` like:
+
+```cpp
+#include <iostream>
+
+#include "xdg.hpp"
+
+int main() {
+    xdg::BaseDirectories dirs;
+    std::cout << "$XDG_DATA_HOME = " << dirs.DataHome() << std::endl;
+}
+```
+
+## Contributing
+
+Pull requests are welcome.
+
+**xdgpp** follows the [Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html); run `clang-format` on changes to automatically format the code.
+
+## License
+
+**xdgpp** is licensed under [the Mit License](https://mit-license.org/).
+