diff options
| author | CoprDistGit <infra@openeuler.org> | 2023-05-18 05:19:25 +0000 |
|---|---|---|
| committer | CoprDistGit <infra@openeuler.org> | 2023-05-18 05:19:25 +0000 |
| commit | a6c20841ed8f5975d4acb8a9e61db98ed6c4b5ad (patch) | |
| tree | ef4bc7aee414004769c52b935dec2133ab6c3ee1 | |
| parent | cc370308903ca7341a278c37b35d54c2bde79b0a (diff) | |
automatic import of python-rstcloth
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-rstcloth.spec | 416 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 418 insertions, 0 deletions
@@ -0,0 +1 @@ +/rstcloth-0.5.3.tar.gz diff --git a/python-rstcloth.spec b/python-rstcloth.spec new file mode 100644 index 0000000..5d4a528 --- /dev/null +++ b/python-rstcloth.spec @@ -0,0 +1,416 @@ +%global _empty_manifest_terminate_build 0 +Name: python-rstcloth +Version: 0.5.3 +Release: 1 +Summary: A simple Python API for generating RestructuredText. +License: MIT +URL: https://github.com/thclark/rstcloth +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/7a/a7/3241d3714bc3adaaa980d8d90b8885fe61167f346a47ef90b2134c24a25f/rstcloth-0.5.3.tar.gz +BuildArch: noarch + +Requires: python3-sphinx +Requires: python3-Pygments +Requires: python3-PyYAML +Requires: python3-sphinx-rtd-theme +Requires: python3-sphinx-tabs +Requires: python3-sphinx-charts +Requires: python3-sphinx-math-dollar +Requires: python3-tabulate + +%description + +[](https://codecov.io/gh/thclark/rstcloth) +[](https://badge.fury.io/py/rstcloth) +[](https://github.com/pre-commit/pre-commit) +[](https://github.com/ambv/black) +[](https://rstcloth.readthedocs.io/en/latest/?badge=latest) + +# RstCloth + +reStructuredText is a powerful human-centric markup language that is +well defined, flexible, with powerful tools that make writing and +maintaining text easy and pleasurable. Humans can edit +reStructuredText without the aide of complex editing tools, and the +resulting source is easy to manipulate and process. + +As an alternative and a supplement, RstCloth is a Python API for +writing well formed reStructuredText programatically. + +Find the [project documentation here](https://rstcloth.readthedocs.io) + +## Developer notes + +Repo is based on [thclark/python-library-template](https://github.com/thclark/python-library-template): + +- vscode `.devcontainer` +- black style +- sphinx docs with some examples and automatic build +- pre-commit hooks +- tox tests +- github actions ci + cd +- code coverage + +### Using VSCode + +Check out the repo and use the remote `.devcontainer` to start developing, with everything installed out of the box. + +### In other IDEs + +Use `poetry --extras docs` to install the project and get started. You also You need to install pre-commit to get the hooks working. Do: + +``` +pip install pre-commit +pre-commit install && pre-commit install -t commit-msg +``` + +Once that's done, each time you make a commit, a wide range of checks are made and the project file formats are applied. + +Upon failure, the commit will halt. **Re-running the commit will automatically fix most issues** except: + +- The flake8 checks... hopefully over time Black (which fixes most things automatically already) will negate need for it. +- You'll have to fix documentation yourself prior to a successful commit (there's no auto fix for that!!). + +You can run pre-commit hooks without making a commit, too, like: + +``` +pre-commit run black --all-files +``` + +or + +``` +# -v gives verbose output, useful for figuring out why docs won't build +pre-commit run build-docs -v +``` + +### Contributing + +- Please raise an issue on the board (or add your \$0.02 to an existing issue) so the maintainers know + what's happening and can advise / steer you. + +- Create a fork of rstcloth, undertake your changes on a new branch, (see `.pre-commit-config.yaml` for branch naming conventions). + +- To make life easy for us, use our conventional commits pattern (if you've got pre-commit installed correctly, it'll guide you on your first commit) to make your commits (if not, we'll try to preserve your history, but might have to squashmerge which would lose your contribution history) + +- Adopt a Test Driven Development approach to implementing new features or fixing bugs. + +- Ask the `rstcloth` maintainers _where_ to make your pull request. We'll create a version branch, according to the + roadmap, into which you can make your PR. We'll help review the changes and improve the PR. + +- Once checks have passed, test coverage of the new code is >=95%, documentation is updated and the Review is passed, we'll merge into the version branch. + +### Release process + +Releases are automated using conventional-commits and GitHub Actions. + +## Documents + +### Building documents automatically + +In the VSCode `.devcontainer`, the RestructuredText extension should build the docs live for you (right click the `.rst` file and hit "Open Preview"). + +On each commit, the documentation will build automatically in a pre-configured environment. The way pre-commit works, you won't be allowed to make the commit unless the documentation builds, +this way we avoid getting broken documentation pushed to the main repository on any commit sha, so we can rely on +builds working. + +### Building documents manually + +**If you did need to build the documentation** + +Install `doxgen`. On a mac, that's `brew install doxygen`; other systems may differ. + +Install sphinx and other requirements for building the docs: + +``` +poetry install --extras docs +``` + +Run the build process: + +``` +sphinx-build -b html docs/source docs/build +``` + + +%package -n python3-rstcloth +Summary: A simple Python API for generating RestructuredText. +Provides: python-rstcloth +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-rstcloth + +[](https://codecov.io/gh/thclark/rstcloth) +[](https://badge.fury.io/py/rstcloth) +[](https://github.com/pre-commit/pre-commit) +[](https://github.com/ambv/black) +[](https://rstcloth.readthedocs.io/en/latest/?badge=latest) + +# RstCloth + +reStructuredText is a powerful human-centric markup language that is +well defined, flexible, with powerful tools that make writing and +maintaining text easy and pleasurable. Humans can edit +reStructuredText without the aide of complex editing tools, and the +resulting source is easy to manipulate and process. + +As an alternative and a supplement, RstCloth is a Python API for +writing well formed reStructuredText programatically. + +Find the [project documentation here](https://rstcloth.readthedocs.io) + +## Developer notes + +Repo is based on [thclark/python-library-template](https://github.com/thclark/python-library-template): + +- vscode `.devcontainer` +- black style +- sphinx docs with some examples and automatic build +- pre-commit hooks +- tox tests +- github actions ci + cd +- code coverage + +### Using VSCode + +Check out the repo and use the remote `.devcontainer` to start developing, with everything installed out of the box. + +### In other IDEs + +Use `poetry --extras docs` to install the project and get started. You also You need to install pre-commit to get the hooks working. Do: + +``` +pip install pre-commit +pre-commit install && pre-commit install -t commit-msg +``` + +Once that's done, each time you make a commit, a wide range of checks are made and the project file formats are applied. + +Upon failure, the commit will halt. **Re-running the commit will automatically fix most issues** except: + +- The flake8 checks... hopefully over time Black (which fixes most things automatically already) will negate need for it. +- You'll have to fix documentation yourself prior to a successful commit (there's no auto fix for that!!). + +You can run pre-commit hooks without making a commit, too, like: + +``` +pre-commit run black --all-files +``` + +or + +``` +# -v gives verbose output, useful for figuring out why docs won't build +pre-commit run build-docs -v +``` + +### Contributing + +- Please raise an issue on the board (or add your \$0.02 to an existing issue) so the maintainers know + what's happening and can advise / steer you. + +- Create a fork of rstcloth, undertake your changes on a new branch, (see `.pre-commit-config.yaml` for branch naming conventions). + +- To make life easy for us, use our conventional commits pattern (if you've got pre-commit installed correctly, it'll guide you on your first commit) to make your commits (if not, we'll try to preserve your history, but might have to squashmerge which would lose your contribution history) + +- Adopt a Test Driven Development approach to implementing new features or fixing bugs. + +- Ask the `rstcloth` maintainers _where_ to make your pull request. We'll create a version branch, according to the + roadmap, into which you can make your PR. We'll help review the changes and improve the PR. + +- Once checks have passed, test coverage of the new code is >=95%, documentation is updated and the Review is passed, we'll merge into the version branch. + +### Release process + +Releases are automated using conventional-commits and GitHub Actions. + +## Documents + +### Building documents automatically + +In the VSCode `.devcontainer`, the RestructuredText extension should build the docs live for you (right click the `.rst` file and hit "Open Preview"). + +On each commit, the documentation will build automatically in a pre-configured environment. The way pre-commit works, you won't be allowed to make the commit unless the documentation builds, +this way we avoid getting broken documentation pushed to the main repository on any commit sha, so we can rely on +builds working. + +### Building documents manually + +**If you did need to build the documentation** + +Install `doxgen`. On a mac, that's `brew install doxygen`; other systems may differ. + +Install sphinx and other requirements for building the docs: + +``` +poetry install --extras docs +``` + +Run the build process: + +``` +sphinx-build -b html docs/source docs/build +``` + + +%package help +Summary: Development documents and examples for rstcloth +Provides: python3-rstcloth-doc +%description help + +[](https://codecov.io/gh/thclark/rstcloth) +[](https://badge.fury.io/py/rstcloth) +[](https://github.com/pre-commit/pre-commit) +[](https://github.com/ambv/black) +[](https://rstcloth.readthedocs.io/en/latest/?badge=latest) + +# RstCloth + +reStructuredText is a powerful human-centric markup language that is +well defined, flexible, with powerful tools that make writing and +maintaining text easy and pleasurable. Humans can edit +reStructuredText without the aide of complex editing tools, and the +resulting source is easy to manipulate and process. + +As an alternative and a supplement, RstCloth is a Python API for +writing well formed reStructuredText programatically. + +Find the [project documentation here](https://rstcloth.readthedocs.io) + +## Developer notes + +Repo is based on [thclark/python-library-template](https://github.com/thclark/python-library-template): + +- vscode `.devcontainer` +- black style +- sphinx docs with some examples and automatic build +- pre-commit hooks +- tox tests +- github actions ci + cd +- code coverage + +### Using VSCode + +Check out the repo and use the remote `.devcontainer` to start developing, with everything installed out of the box. + +### In other IDEs + +Use `poetry --extras docs` to install the project and get started. You also You need to install pre-commit to get the hooks working. Do: + +``` +pip install pre-commit +pre-commit install && pre-commit install -t commit-msg +``` + +Once that's done, each time you make a commit, a wide range of checks are made and the project file formats are applied. + +Upon failure, the commit will halt. **Re-running the commit will automatically fix most issues** except: + +- The flake8 checks... hopefully over time Black (which fixes most things automatically already) will negate need for it. +- You'll have to fix documentation yourself prior to a successful commit (there's no auto fix for that!!). + +You can run pre-commit hooks without making a commit, too, like: + +``` +pre-commit run black --all-files +``` + +or + +``` +# -v gives verbose output, useful for figuring out why docs won't build +pre-commit run build-docs -v +``` + +### Contributing + +- Please raise an issue on the board (or add your \$0.02 to an existing issue) so the maintainers know + what's happening and can advise / steer you. + +- Create a fork of rstcloth, undertake your changes on a new branch, (see `.pre-commit-config.yaml` for branch naming conventions). + +- To make life easy for us, use our conventional commits pattern (if you've got pre-commit installed correctly, it'll guide you on your first commit) to make your commits (if not, we'll try to preserve your history, but might have to squashmerge which would lose your contribution history) + +- Adopt a Test Driven Development approach to implementing new features or fixing bugs. + +- Ask the `rstcloth` maintainers _where_ to make your pull request. We'll create a version branch, according to the + roadmap, into which you can make your PR. We'll help review the changes and improve the PR. + +- Once checks have passed, test coverage of the new code is >=95%, documentation is updated and the Review is passed, we'll merge into the version branch. + +### Release process + +Releases are automated using conventional-commits and GitHub Actions. + +## Documents + +### Building documents automatically + +In the VSCode `.devcontainer`, the RestructuredText extension should build the docs live for you (right click the `.rst` file and hit "Open Preview"). + +On each commit, the documentation will build automatically in a pre-configured environment. The way pre-commit works, you won't be allowed to make the commit unless the documentation builds, +this way we avoid getting broken documentation pushed to the main repository on any commit sha, so we can rely on +builds working. + +### Building documents manually + +**If you did need to build the documentation** + +Install `doxgen`. On a mac, that's `brew install doxygen`; other systems may differ. + +Install sphinx and other requirements for building the docs: + +``` +poetry install --extras docs +``` + +Run the build process: + +``` +sphinx-build -b html docs/source docs/build +``` + + +%prep +%autosetup -n rstcloth-0.5.3 + +%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-rstcloth -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Thu May 18 2023 Python_Bot <Python_Bot@openeuler.org> - 0.5.3-1 +- Package Spec generated @@ -0,0 +1 @@ +beaa5bc897b3794c220617e37524ca15 rstcloth-0.5.3.tar.gz |