automatic import of python-pystow

3 files changed, 732 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..bc181ab 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/pystow-0.5.0.tar.gz
diff --git a/python-pystow.spec b/python-pystow.spec
new file mode 100644
index 0000000..0803a15
--- /dev/null
+++ b/python-pystow.spec
@@ -0,0 +1,730 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-pystow
+Version:	0.5.0
+Release:	1
+Summary:	Easily pick a place to store data for your python package.
+License:	MIT
+URL:		https://github.com/cthoyt/pystow
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/8e/c5/bf813c5fd5649769cc0ddf4a6bd072e24482a7a2cfe843005ffdabca7cd2/pystow-0.5.0.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-click
+Requires:	python3-requests
+Requires:	python3-tqdm
+Requires:	python3-pickle5
+Requires:	python3-boto3
+Requires:	python3-sphinx
+Requires:	python3-sphinx-rtd-theme
+Requires:	python3-sphinx-click
+Requires:	python3-sphinx-autodoc-typehints
+Requires:	python3-sphinx-automodapi
+Requires:	python3-pandas
+Requires:	python3-rdflib
+Requires:	python3-coverage
+Requires:	python3-pytest
+Requires:	python3-requests-file
+Requires:	python3-lxml
+
+%description
+<h1 align="center">
+  PyStow
+</h1>
+
+<p align="center">
+  <a href="https://github.com/cthoyt/pystow/actions">
+    <img src="https://github.com/cthoyt/pystow/workflows/Tests/badge.svg" alt="Build status" height="20" />
+  </a>
+
+  <a href="https://pypi.org/project/pystow">
+    <img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/pystow">
+  </a>
+
+  <a href='https://opensource.org/licenses/MIT'>
+    <img src='https://img.shields.io/badge/License-MIT-blue.svg' alt='License'/>
+  </a>
+
+  <a href='https://pystow.readthedocs.io/en/latest/?badge=latest'>
+    <img src='https://readthedocs.org/projects/pystow/badge/?version=latest' alt='Documentation Status' />
+  </a>
+
+  <a href="https://zenodo.org/badge/latestdoi/318194121">
+    <img src="https://zenodo.org/badge/318194121.svg" alt="DOI">
+  </a>
+
+  <a href="https://github.com/psf/black">
+    <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code style: black">
+  </a>
+</p>
+
+👜 Easily pick a place to store data for your python code.
+
+## 🚀 Getting Started
+
+Get a directory for your application.
+
+```python
+import pystow
+
+# Get a directory (as a pathlib.Path) for ~/.data/pykeen
+pykeen_directory = pystow.join('pykeen')
+
+# Get a subdirectory (as a pathlib.Path) for ~/.data/pykeen/experiments
+pykeen_experiments_directory = pystow.join('pykeen', 'experiments')
+
+# You can go as deep as you want
+pykeen_deep_directory = pystow.join('pykeen', 'experiments', 'a', 'b', 'c')
+```
+
+If you reuse the same directory structure a lot, you can save them in a module:
+
+```python
+import pystow
+
+pykeen_module = pystow.module("pykeen")
+
+# Access the module's directory with .base
+assert pystow.join("pykeen") == pystow.module("pykeen").base
+
+# Get a subdirectory (as a pathlib.Path) for ~/.data/pykeen/experiments
+pykeen_experiments_directory = pykeen_module.join('experiments')
+
+# You can go as deep as you want past the original "pykeen" module
+pykeen_deep_directory = pykeen_module.join('experiments', 'a', 'b', 'c')
+```
+
+Get a file path for your application by adding the `name` keyword argument. This is made explicit so PyStow knows which
+parent directories to automatically create. This works with `pystow` or any module you create with `pystow.module`.
+
+```python
+import pystow
+
+# Get a directory (as a pathlib.Path) for ~/.data/indra/database.tsv
+indra_database_path = pystow.join('indra', 'database', name='database.tsv')
+```
+
+Ensure a file from the internet is available in your application's directory:
+
+```python
+import pystow
+
+url = 'https://raw.githubusercontent.com/pykeen/pykeen/master/src/pykeen/datasets/nations/test.txt'
+path = pystow.ensure('pykeen', 'datasets', 'nations', url=url)
+```
+
+Ensure a tabular data file from the internet and load it for usage (requires `pip install pandas`):
+
+```python
+import pystow
+import pandas as pd
+
+url = 'https://raw.githubusercontent.com/pykeen/pykeen/master/src/pykeen/datasets/nations/test.txt'
+df: pd.DataFrame = pystow.ensure_csv('pykeen', 'datasets', 'nations', url=url)
+```
+
+Ensure a comma-separated tabular data file from the internet and load it for usage (requires `pip install pandas`):
+
+```python
+import pystow
+import pandas as pd
+
+url = 'https://raw.githubusercontent.com/cthoyt/pystow/main/tests/resources/test_1.csv'
+df: pd.DataFrame = pystow.ensure_csv('pykeen', 'datasets', 'nations', url=url, read_csv_kwargs=dict(sep=","))
+```
+
+Ensure a RDF file from the internet and load it for usage (requires `pip install rdflib`)
+
+```python
+import pystow
+import rdflib
+
+url = 'https://ftp.expasy.org/databases/rhea/rdf/rhea.rdf.gz'
+rdf_graph: rdflib.Graph = pystow.ensure_rdf('rhea', url=url)
+```
+
+Also see `pystow.ensure_excel()`, `pystow.ensure_rdf()`, `pystow.ensure_zip_df()`, and `pystow.ensure_tar_df()`.
+
+If your data comes with a lot of different files in an archive,
+you can ensure the archive is downloaded and get specific files from it:
+
+```python
+import numpy as np
+import pystow
+
+url = "https://cloud.enterprise.informatik.uni-leipzig.de/index.php/s/LHPbMCre7SLqajB/download/MultiKE_D_Y_15K_V1.zip"
+# the path inside the archive to the file you want
+inner_path = "MultiKE/D_Y_15K_V1/721_5fold/1/20210219183115/ent_embeds.npy"
+with pystow.ensure_open_zip("kiez", url=url, inner_path=inner_path) as file:
+    emb = np.load(file)
+```
+
+Also see `pystow.module.ensure_open_lzma()`, `pystow.module.ensure_open_tarfile()` and `pystow.module.ensure_open_gz()`.
+
+## ⚙️️ Configuration
+
+By default, data is stored in the `$HOME/.data` directory. By default, the `<app>` app will create the
+`$HOME/.data/<app>` folder.
+
+If you want to use an alternate folder name to `.data` inside the home directory, you can set the `PYSTOW_NAME`
+environment variable. For example, if you set `PYSTOW_NAME=mydata`, then the following code for the `pykeen` app will
+create the `$HOME/mydata/pykeen/` directory:
+
+```python
+import os
+import pystow
+
+# Only for demonstration purposes. You should set environment
+# variables either with your .bashrc or in the command line REPL.
+os.environ['PYSTOW_NAME'] = 'mydata'
+
+# Get a directory (as a pathlib.Path) for ~/mydata/pykeen
+pykeen_directory = pystow.join('pykeen')
+```
+
+If you want to specify a completely custom directory that isn't relative to your home directory, you can set
+the `PYSTOW_HOME` environment variable. For example, if you set `PYSTOW_HOME=/usr/local/`, then the following code for
+the `pykeen` app will create the `/usr/local/pykeen/` directory:
+
+```python
+import os
+import pystow
+
+# Only for demonstration purposes. You should set environment
+# variables either with your .bashrc or in the command line REPL.
+os.environ['PYSTOW_HOME'] = '/usr/local/'
+
+# Get a directory (as a pathlib.Path) for /usr/local/pykeen
+pykeen_directory = pystow.join('pykeen')
+```
+
+Note: if you set `PYSTOW_HOME`, then `PYSTOW_NAME` is disregarded.
+
+### X Desktop Group (XDG) Compatibility
+
+While PyStow's main goal is to make application data less opaque and less
+hidden, some users might want to use the
+[XDG specifications](http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html)
+for storing their app data.
+
+If you set the environment variable  `PYSTOW_USE_APPDIRS` to `true` or `True`, then the
+[`appdirs`](https://pypi.org/project/appdirs/) package will be used to choose
+the base directory based on the `user data dir` option. This can still be
+overridden by `PYSTOW_HOME`.
+
+## 🚀 Installation
+
+The most recent release can be installed from
+[PyPI](https://pypi.org/project/pystow/) with:
+
+```bash
+$ pip install pystow
+```
+
+Note, as of v0.3.0, Python 3.6 isn't officially supported (its
+end-of-life was in December 2021). For the time being, `pystow` might still
+work on py36, but this is only coincidental.
+
+The most recent code and data can be installed directly from GitHub with:
+
+```bash
+$ pip install git+https://github.com/cthoyt/pystow.git
+```
+
+To install in development mode, use the following:
+
+```bash
+$ git clone git+https://github.com/cthoyt/pystow.git
+$ cd pystow
+$ pip install -e .
+```
+
+## ⚖️ License
+
+The code in this package is licensed under the MIT License.
+
+
+%package -n python3-pystow
+Summary:	Easily pick a place to store data for your python package.
+Provides:	python-pystow
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-pystow
+<h1 align="center">
+  PyStow
+</h1>
+
+<p align="center">
+  <a href="https://github.com/cthoyt/pystow/actions">
+    <img src="https://github.com/cthoyt/pystow/workflows/Tests/badge.svg" alt="Build status" height="20" />
+  </a>
+
+  <a href="https://pypi.org/project/pystow">
+    <img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/pystow">
+  </a>
+
+  <a href='https://opensource.org/licenses/MIT'>
+    <img src='https://img.shields.io/badge/License-MIT-blue.svg' alt='License'/>
+  </a>
+
+  <a href='https://pystow.readthedocs.io/en/latest/?badge=latest'>
+    <img src='https://readthedocs.org/projects/pystow/badge/?version=latest' alt='Documentation Status' />
+  </a>
+
+  <a href="https://zenodo.org/badge/latestdoi/318194121">
+    <img src="https://zenodo.org/badge/318194121.svg" alt="DOI">
+  </a>
+
+  <a href="https://github.com/psf/black">
+    <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code style: black">
+  </a>
+</p>
+
+👜 Easily pick a place to store data for your python code.
+
+## 🚀 Getting Started
+
+Get a directory for your application.
+
+```python
+import pystow
+
+# Get a directory (as a pathlib.Path) for ~/.data/pykeen
+pykeen_directory = pystow.join('pykeen')
+
+# Get a subdirectory (as a pathlib.Path) for ~/.data/pykeen/experiments
+pykeen_experiments_directory = pystow.join('pykeen', 'experiments')
+
+# You can go as deep as you want
+pykeen_deep_directory = pystow.join('pykeen', 'experiments', 'a', 'b', 'c')
+```
+
+If you reuse the same directory structure a lot, you can save them in a module:
+
+```python
+import pystow
+
+pykeen_module = pystow.module("pykeen")
+
+# Access the module's directory with .base
+assert pystow.join("pykeen") == pystow.module("pykeen").base
+
+# Get a subdirectory (as a pathlib.Path) for ~/.data/pykeen/experiments
+pykeen_experiments_directory = pykeen_module.join('experiments')
+
+# You can go as deep as you want past the original "pykeen" module
+pykeen_deep_directory = pykeen_module.join('experiments', 'a', 'b', 'c')
+```
+
+Get a file path for your application by adding the `name` keyword argument. This is made explicit so PyStow knows which
+parent directories to automatically create. This works with `pystow` or any module you create with `pystow.module`.
+
+```python
+import pystow
+
+# Get a directory (as a pathlib.Path) for ~/.data/indra/database.tsv
+indra_database_path = pystow.join('indra', 'database', name='database.tsv')
+```
+
+Ensure a file from the internet is available in your application's directory:
+
+```python
+import pystow
+
+url = 'https://raw.githubusercontent.com/pykeen/pykeen/master/src/pykeen/datasets/nations/test.txt'
+path = pystow.ensure('pykeen', 'datasets', 'nations', url=url)
+```
+
+Ensure a tabular data file from the internet and load it for usage (requires `pip install pandas`):
+
+```python
+import pystow
+import pandas as pd
+
+url = 'https://raw.githubusercontent.com/pykeen/pykeen/master/src/pykeen/datasets/nations/test.txt'
+df: pd.DataFrame = pystow.ensure_csv('pykeen', 'datasets', 'nations', url=url)
+```
+
+Ensure a comma-separated tabular data file from the internet and load it for usage (requires `pip install pandas`):
+
+```python
+import pystow
+import pandas as pd
+
+url = 'https://raw.githubusercontent.com/cthoyt/pystow/main/tests/resources/test_1.csv'
+df: pd.DataFrame = pystow.ensure_csv('pykeen', 'datasets', 'nations', url=url, read_csv_kwargs=dict(sep=","))
+```
+
+Ensure a RDF file from the internet and load it for usage (requires `pip install rdflib`)
+
+```python
+import pystow
+import rdflib
+
+url = 'https://ftp.expasy.org/databases/rhea/rdf/rhea.rdf.gz'
+rdf_graph: rdflib.Graph = pystow.ensure_rdf('rhea', url=url)
+```
+
+Also see `pystow.ensure_excel()`, `pystow.ensure_rdf()`, `pystow.ensure_zip_df()`, and `pystow.ensure_tar_df()`.
+
+If your data comes with a lot of different files in an archive,
+you can ensure the archive is downloaded and get specific files from it:
+
+```python
+import numpy as np
+import pystow
+
+url = "https://cloud.enterprise.informatik.uni-leipzig.de/index.php/s/LHPbMCre7SLqajB/download/MultiKE_D_Y_15K_V1.zip"
+# the path inside the archive to the file you want
+inner_path = "MultiKE/D_Y_15K_V1/721_5fold/1/20210219183115/ent_embeds.npy"
+with pystow.ensure_open_zip("kiez", url=url, inner_path=inner_path) as file:
+    emb = np.load(file)
+```
+
+Also see `pystow.module.ensure_open_lzma()`, `pystow.module.ensure_open_tarfile()` and `pystow.module.ensure_open_gz()`.
+
+## ⚙️️ Configuration
+
+By default, data is stored in the `$HOME/.data` directory. By default, the `<app>` app will create the
+`$HOME/.data/<app>` folder.
+
+If you want to use an alternate folder name to `.data` inside the home directory, you can set the `PYSTOW_NAME`
+environment variable. For example, if you set `PYSTOW_NAME=mydata`, then the following code for the `pykeen` app will
+create the `$HOME/mydata/pykeen/` directory:
+
+```python
+import os
+import pystow
+
+# Only for demonstration purposes. You should set environment
+# variables either with your .bashrc or in the command line REPL.
+os.environ['PYSTOW_NAME'] = 'mydata'
+
+# Get a directory (as a pathlib.Path) for ~/mydata/pykeen
+pykeen_directory = pystow.join('pykeen')
+```
+
+If you want to specify a completely custom directory that isn't relative to your home directory, you can set
+the `PYSTOW_HOME` environment variable. For example, if you set `PYSTOW_HOME=/usr/local/`, then the following code for
+the `pykeen` app will create the `/usr/local/pykeen/` directory:
+
+```python
+import os
+import pystow
+
+# Only for demonstration purposes. You should set environment
+# variables either with your .bashrc or in the command line REPL.
+os.environ['PYSTOW_HOME'] = '/usr/local/'
+
+# Get a directory (as a pathlib.Path) for /usr/local/pykeen
+pykeen_directory = pystow.join('pykeen')
+```
+
+Note: if you set `PYSTOW_HOME`, then `PYSTOW_NAME` is disregarded.
+
+### X Desktop Group (XDG) Compatibility
+
+While PyStow's main goal is to make application data less opaque and less
+hidden, some users might want to use the
+[XDG specifications](http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html)
+for storing their app data.
+
+If you set the environment variable  `PYSTOW_USE_APPDIRS` to `true` or `True`, then the
+[`appdirs`](https://pypi.org/project/appdirs/) package will be used to choose
+the base directory based on the `user data dir` option. This can still be
+overridden by `PYSTOW_HOME`.
+
+## 🚀 Installation
+
+The most recent release can be installed from
+[PyPI](https://pypi.org/project/pystow/) with:
+
+```bash
+$ pip install pystow
+```
+
+Note, as of v0.3.0, Python 3.6 isn't officially supported (its
+end-of-life was in December 2021). For the time being, `pystow` might still
+work on py36, but this is only coincidental.
+
+The most recent code and data can be installed directly from GitHub with:
+
+```bash
+$ pip install git+https://github.com/cthoyt/pystow.git
+```
+
+To install in development mode, use the following:
+
+```bash
+$ git clone git+https://github.com/cthoyt/pystow.git
+$ cd pystow
+$ pip install -e .
+```
+
+## ⚖️ License
+
+The code in this package is licensed under the MIT License.
+
+
+%package help
+Summary:	Development documents and examples for pystow
+Provides:	python3-pystow-doc
+%description help
+<h1 align="center">
+  PyStow
+</h1>
+
+<p align="center">
+  <a href="https://github.com/cthoyt/pystow/actions">
+    <img src="https://github.com/cthoyt/pystow/workflows/Tests/badge.svg" alt="Build status" height="20" />
+  </a>
+
+  <a href="https://pypi.org/project/pystow">
+    <img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/pystow">
+  </a>
+
+  <a href='https://opensource.org/licenses/MIT'>
+    <img src='https://img.shields.io/badge/License-MIT-blue.svg' alt='License'/>
+  </a>
+
+  <a href='https://pystow.readthedocs.io/en/latest/?badge=latest'>
+    <img src='https://readthedocs.org/projects/pystow/badge/?version=latest' alt='Documentation Status' />
+  </a>
+
+  <a href="https://zenodo.org/badge/latestdoi/318194121">
+    <img src="https://zenodo.org/badge/318194121.svg" alt="DOI">
+  </a>
+
+  <a href="https://github.com/psf/black">
+    <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code style: black">
+  </a>
+</p>
+
+👜 Easily pick a place to store data for your python code.
+
+## 🚀 Getting Started
+
+Get a directory for your application.
+
+```python
+import pystow
+
+# Get a directory (as a pathlib.Path) for ~/.data/pykeen
+pykeen_directory = pystow.join('pykeen')
+
+# Get a subdirectory (as a pathlib.Path) for ~/.data/pykeen/experiments
+pykeen_experiments_directory = pystow.join('pykeen', 'experiments')
+
+# You can go as deep as you want
+pykeen_deep_directory = pystow.join('pykeen', 'experiments', 'a', 'b', 'c')
+```
+
+If you reuse the same directory structure a lot, you can save them in a module:
+
+```python
+import pystow
+
+pykeen_module = pystow.module("pykeen")
+
+# Access the module's directory with .base
+assert pystow.join("pykeen") == pystow.module("pykeen").base
+
+# Get a subdirectory (as a pathlib.Path) for ~/.data/pykeen/experiments
+pykeen_experiments_directory = pykeen_module.join('experiments')
+
+# You can go as deep as you want past the original "pykeen" module
+pykeen_deep_directory = pykeen_module.join('experiments', 'a', 'b', 'c')
+```
+
+Get a file path for your application by adding the `name` keyword argument. This is made explicit so PyStow knows which
+parent directories to automatically create. This works with `pystow` or any module you create with `pystow.module`.
+
+```python
+import pystow
+
+# Get a directory (as a pathlib.Path) for ~/.data/indra/database.tsv
+indra_database_path = pystow.join('indra', 'database', name='database.tsv')
+```
+
+Ensure a file from the internet is available in your application's directory:
+
+```python
+import pystow
+
+url = 'https://raw.githubusercontent.com/pykeen/pykeen/master/src/pykeen/datasets/nations/test.txt'
+path = pystow.ensure('pykeen', 'datasets', 'nations', url=url)
+```
+
+Ensure a tabular data file from the internet and load it for usage (requires `pip install pandas`):
+
+```python
+import pystow
+import pandas as pd
+
+url = 'https://raw.githubusercontent.com/pykeen/pykeen/master/src/pykeen/datasets/nations/test.txt'
+df: pd.DataFrame = pystow.ensure_csv('pykeen', 'datasets', 'nations', url=url)
+```
+
+Ensure a comma-separated tabular data file from the internet and load it for usage (requires `pip install pandas`):
+
+```python
+import pystow
+import pandas as pd
+
+url = 'https://raw.githubusercontent.com/cthoyt/pystow/main/tests/resources/test_1.csv'
+df: pd.DataFrame = pystow.ensure_csv('pykeen', 'datasets', 'nations', url=url, read_csv_kwargs=dict(sep=","))
+```
+
+Ensure a RDF file from the internet and load it for usage (requires `pip install rdflib`)
+
+```python
+import pystow
+import rdflib
+
+url = 'https://ftp.expasy.org/databases/rhea/rdf/rhea.rdf.gz'
+rdf_graph: rdflib.Graph = pystow.ensure_rdf('rhea', url=url)
+```
+
+Also see `pystow.ensure_excel()`, `pystow.ensure_rdf()`, `pystow.ensure_zip_df()`, and `pystow.ensure_tar_df()`.
+
+If your data comes with a lot of different files in an archive,
+you can ensure the archive is downloaded and get specific files from it:
+
+```python
+import numpy as np
+import pystow
+
+url = "https://cloud.enterprise.informatik.uni-leipzig.de/index.php/s/LHPbMCre7SLqajB/download/MultiKE_D_Y_15K_V1.zip"
+# the path inside the archive to the file you want
+inner_path = "MultiKE/D_Y_15K_V1/721_5fold/1/20210219183115/ent_embeds.npy"
+with pystow.ensure_open_zip("kiez", url=url, inner_path=inner_path) as file:
+    emb = np.load(file)
+```
+
+Also see `pystow.module.ensure_open_lzma()`, `pystow.module.ensure_open_tarfile()` and `pystow.module.ensure_open_gz()`.
+
+## ⚙️️ Configuration
+
+By default, data is stored in the `$HOME/.data` directory. By default, the `<app>` app will create the
+`$HOME/.data/<app>` folder.
+
+If you want to use an alternate folder name to `.data` inside the home directory, you can set the `PYSTOW_NAME`
+environment variable. For example, if you set `PYSTOW_NAME=mydata`, then the following code for the `pykeen` app will
+create the `$HOME/mydata/pykeen/` directory:
+
+```python
+import os
+import pystow
+
+# Only for demonstration purposes. You should set environment
+# variables either with your .bashrc or in the command line REPL.
+os.environ['PYSTOW_NAME'] = 'mydata'
+
+# Get a directory (as a pathlib.Path) for ~/mydata/pykeen
+pykeen_directory = pystow.join('pykeen')
+```
+
+If you want to specify a completely custom directory that isn't relative to your home directory, you can set
+the `PYSTOW_HOME` environment variable. For example, if you set `PYSTOW_HOME=/usr/local/`, then the following code for
+the `pykeen` app will create the `/usr/local/pykeen/` directory:
+
+```python
+import os
+import pystow
+
+# Only for demonstration purposes. You should set environment
+# variables either with your .bashrc or in the command line REPL.
+os.environ['PYSTOW_HOME'] = '/usr/local/'
+
+# Get a directory (as a pathlib.Path) for /usr/local/pykeen
+pykeen_directory = pystow.join('pykeen')
+```
+
+Note: if you set `PYSTOW_HOME`, then `PYSTOW_NAME` is disregarded.
+
+### X Desktop Group (XDG) Compatibility
+
+While PyStow's main goal is to make application data less opaque and less
+hidden, some users might want to use the
+[XDG specifications](http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html)
+for storing their app data.
+
+If you set the environment variable  `PYSTOW_USE_APPDIRS` to `true` or `True`, then the
+[`appdirs`](https://pypi.org/project/appdirs/) package will be used to choose
+the base directory based on the `user data dir` option. This can still be
+overridden by `PYSTOW_HOME`.
+
+## 🚀 Installation
+
+The most recent release can be installed from
+[PyPI](https://pypi.org/project/pystow/) with:
+
+```bash
+$ pip install pystow
+```
+
+Note, as of v0.3.0, Python 3.6 isn't officially supported (its
+end-of-life was in December 2021). For the time being, `pystow` might still
+work on py36, but this is only coincidental.
+
+The most recent code and data can be installed directly from GitHub with:
+
+```bash
+$ pip install git+https://github.com/cthoyt/pystow.git
+```
+
+To install in development mode, use the following:
+
+```bash
+$ git clone git+https://github.com/cthoyt/pystow.git
+$ cd pystow
+$ pip install -e .
+```
+
+## ⚖️ License
+
+The code in this package is licensed under the MIT License.
+
+
+%prep
+%autosetup -n pystow-0.5.0
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-pystow -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Tue Apr 11 2023 Python_Bot <Python_Bot@openeuler.org> - 0.5.0-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..b6a1e4c
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+c418328d96cdac64a987d7429ecf2ddf  pystow-0.5.0.tar.gz