diff options
author | CoprDistGit <infra@openeuler.org> | 2023-04-10 16:47:50 +0000 |
---|---|---|
committer | CoprDistGit <infra@openeuler.org> | 2023-04-10 16:47:50 +0000 |
commit | 16bcdec384202db8d663742d57fbf7b7f72e8b83 (patch) | |
tree | 7a7ed0ef82a3f3f19f408f016e47a66ebdeeccf4 | |
parent | 59cdecbb5d172235fece6408ff3d6e7d7b305220 (diff) |
automatic import of python-altair-saver
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | python-altair-saver.spec | 403 | ||||
-rw-r--r-- | sources | 1 |
3 files changed, 405 insertions, 0 deletions
@@ -0,0 +1 @@ +/altair_saver-0.5.0.tar.gz diff --git a/python-altair-saver.spec b/python-altair-saver.spec new file mode 100644 index 0000000..fd18a1e --- /dev/null +++ b/python-altair-saver.spec @@ -0,0 +1,403 @@ +%global _empty_manifest_terminate_build 0 +Name: python-altair-saver +Version: 0.5.0 +Release: 1 +Summary: Altair extension for saving charts to various formats. +License: MIT +URL: http://github.com/altair-viz/altair_saver/ +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/ad/80/21a2928d4f857bf3d7c0dae46b1fe0b5b0b70057f844ee0d5d090effb5fe/altair_saver-0.5.0.tar.gz +BuildArch: noarch + +Requires: python3-altair +Requires: python3-altair-data-server +Requires: python3-altair-viewer +Requires: python3-selenium + +%description +# Altair Saver + +[](https://github.com/altair-viz/altair_saver/actions?query=workflow%3Abuild) +[](https://github.com/altair-viz/altair_saver/actions?query=workflow%3Alint) +[](https://github.com/psf/black) +[](https://colab.research.google.com/github/altair-viz/altair_saver/blob/master/AltairSaver.ipynb) + + +This packge provides extensions to [Altair](http://altair-viz.github.io) for saving charts +to a variety of output types. Supported output formats are: + +- ``.json``/``.vl.json``: Vega-Lite JSON specification +- ``.vg.json``: Vega JSON specification +- ``.html``: HTML output +- ``.png``: PNG image +- ``.svg``: SVG image +- ``.pdf``: PDF image + +## Usage +The ``altair_saver`` library has a single public function, ``altair_saver.save()``. +Given an Altair chart named ``chart``, you can use it as follows: +```python +from altair_saver import save + +save(chart, "chart.vl.json") # Vega-Lite JSON specification +save(chart, "chart.vg.json") # Vega JSON specification +save(chart, "chart.html") # HTML document +save(chart, "chart.html", inline=True) # HTML document with all JS code included inline +save(chart, "chart.png") # PNG Image +save(chart, "chart.svg") # SVG Image +save(chart, "chart.pdf") # PDF Image +``` + +### Renderer +Additionally, altair_saver provides an [Altair Renderer](https://altair-viz.github.io/user_guide/display_frontends.html#altair-s-renderer-framework) +entrypoint that can display the above outputs directly in Jupyter notebooks. +For example, you can specify a vega-lite mimetype (supported by JupyterLab, nteract, and other +platforms) with a PNG fallback for other frontends as follows: +```python +alt.renderers.enable('altair_saver', ['vega-lite', 'png']) +``` + +## Installation +The ``altair_saver`` package can be installed with: +``` +$ pip install altair_saver +``` +Saving as ``vl.json`` and as ``html`` requires no additional setup. + +To install with conda, use +``` +$ conda install -c conda-forge altair_saver +``` +The conda package installs the *NodeJS* dependencies described below, so charts can be +saved to ``png``, ``svg``, and ``pdf`` without additional setup. + +### Additional Requirements + +Output to ``png``, ``svg``, and ``pdf`` requires execution of Javascript code, which +``altair_saver`` can do via one of two backends. + +#### Selenium +The *selenium* backend supports the following formats: + +- `.vg.json` +- `.png` +- `.svg`. + +To be used, it requires the [Selenium](https://selenium.dev/selenium/docs/api/py/) Python package, +and a properly configured installation of either [chromedriver](https://chromedriver.chromium.org/) or +[geckodriver](https://firefox-source-docs.mozilla.org/testing/geckodriver/). + +On Linux systems, this can be setup as follows: +```bash +$ pip install selenium +$ apt-get install chromium-chromedriver +``` +Using conda, the required packages can be installed as follows (a compatible version of +[Google Chrome](https://www.google.com/chrome/) must be installed separately): +```bash +$ conda install -c python-chromedriver-binary +``` +Selenium supports [other browsers](https://selenium-python.readthedocs.io/installation.html) as well, +but altair-saver is currently only tested with Chrome. + +#### NodeJS +The *nodejs* backend supports the following formats: + +- `.vg.json` +- `.png` +- `.svg` +- `.pdf` + +It requires [NodeJS](https://nodejs.org/), along with the [vega-lite](https://www.npmjs.com/package/vega-lite), +[vega-cli](https://www.npmjs.com/package/vega-cli), and [canvas](https://www.npmjs.com/package/canvas) packages. + +First install NodeJS either by [direct download](https://nodejs.org/en/download/) or via a +[package manager](https://nodejs.org/en/download/package-manager/), and then use the `npm` tool +to install the required packages: +```bash +$ npm install vega-lite vega-cli canvas +``` +Using conda, node and the required packages can be installed as follows: +```bash +$ conda install -c conda-forge vega-cli vega-lite-cli +``` +These packages are included automatically when installing ``altair_saver`` via conda-forge. + + + + +%package -n python3-altair-saver +Summary: Altair extension for saving charts to various formats. +Provides: python-altair-saver +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-altair-saver +# Altair Saver + +[](https://github.com/altair-viz/altair_saver/actions?query=workflow%3Abuild) +[](https://github.com/altair-viz/altair_saver/actions?query=workflow%3Alint) +[](https://github.com/psf/black) +[](https://colab.research.google.com/github/altair-viz/altair_saver/blob/master/AltairSaver.ipynb) + + +This packge provides extensions to [Altair](http://altair-viz.github.io) for saving charts +to a variety of output types. Supported output formats are: + +- ``.json``/``.vl.json``: Vega-Lite JSON specification +- ``.vg.json``: Vega JSON specification +- ``.html``: HTML output +- ``.png``: PNG image +- ``.svg``: SVG image +- ``.pdf``: PDF image + +## Usage +The ``altair_saver`` library has a single public function, ``altair_saver.save()``. +Given an Altair chart named ``chart``, you can use it as follows: +```python +from altair_saver import save + +save(chart, "chart.vl.json") # Vega-Lite JSON specification +save(chart, "chart.vg.json") # Vega JSON specification +save(chart, "chart.html") # HTML document +save(chart, "chart.html", inline=True) # HTML document with all JS code included inline +save(chart, "chart.png") # PNG Image +save(chart, "chart.svg") # SVG Image +save(chart, "chart.pdf") # PDF Image +``` + +### Renderer +Additionally, altair_saver provides an [Altair Renderer](https://altair-viz.github.io/user_guide/display_frontends.html#altair-s-renderer-framework) +entrypoint that can display the above outputs directly in Jupyter notebooks. +For example, you can specify a vega-lite mimetype (supported by JupyterLab, nteract, and other +platforms) with a PNG fallback for other frontends as follows: +```python +alt.renderers.enable('altair_saver', ['vega-lite', 'png']) +``` + +## Installation +The ``altair_saver`` package can be installed with: +``` +$ pip install altair_saver +``` +Saving as ``vl.json`` and as ``html`` requires no additional setup. + +To install with conda, use +``` +$ conda install -c conda-forge altair_saver +``` +The conda package installs the *NodeJS* dependencies described below, so charts can be +saved to ``png``, ``svg``, and ``pdf`` without additional setup. + +### Additional Requirements + +Output to ``png``, ``svg``, and ``pdf`` requires execution of Javascript code, which +``altair_saver`` can do via one of two backends. + +#### Selenium +The *selenium* backend supports the following formats: + +- `.vg.json` +- `.png` +- `.svg`. + +To be used, it requires the [Selenium](https://selenium.dev/selenium/docs/api/py/) Python package, +and a properly configured installation of either [chromedriver](https://chromedriver.chromium.org/) or +[geckodriver](https://firefox-source-docs.mozilla.org/testing/geckodriver/). + +On Linux systems, this can be setup as follows: +```bash +$ pip install selenium +$ apt-get install chromium-chromedriver +``` +Using conda, the required packages can be installed as follows (a compatible version of +[Google Chrome](https://www.google.com/chrome/) must be installed separately): +```bash +$ conda install -c python-chromedriver-binary +``` +Selenium supports [other browsers](https://selenium-python.readthedocs.io/installation.html) as well, +but altair-saver is currently only tested with Chrome. + +#### NodeJS +The *nodejs* backend supports the following formats: + +- `.vg.json` +- `.png` +- `.svg` +- `.pdf` + +It requires [NodeJS](https://nodejs.org/), along with the [vega-lite](https://www.npmjs.com/package/vega-lite), +[vega-cli](https://www.npmjs.com/package/vega-cli), and [canvas](https://www.npmjs.com/package/canvas) packages. + +First install NodeJS either by [direct download](https://nodejs.org/en/download/) or via a +[package manager](https://nodejs.org/en/download/package-manager/), and then use the `npm` tool +to install the required packages: +```bash +$ npm install vega-lite vega-cli canvas +``` +Using conda, node and the required packages can be installed as follows: +```bash +$ conda install -c conda-forge vega-cli vega-lite-cli +``` +These packages are included automatically when installing ``altair_saver`` via conda-forge. + + + + +%package help +Summary: Development documents and examples for altair-saver +Provides: python3-altair-saver-doc +%description help +# Altair Saver + +[](https://github.com/altair-viz/altair_saver/actions?query=workflow%3Abuild) +[](https://github.com/altair-viz/altair_saver/actions?query=workflow%3Alint) +[](https://github.com/psf/black) +[](https://colab.research.google.com/github/altair-viz/altair_saver/blob/master/AltairSaver.ipynb) + + +This packge provides extensions to [Altair](http://altair-viz.github.io) for saving charts +to a variety of output types. Supported output formats are: + +- ``.json``/``.vl.json``: Vega-Lite JSON specification +- ``.vg.json``: Vega JSON specification +- ``.html``: HTML output +- ``.png``: PNG image +- ``.svg``: SVG image +- ``.pdf``: PDF image + +## Usage +The ``altair_saver`` library has a single public function, ``altair_saver.save()``. +Given an Altair chart named ``chart``, you can use it as follows: +```python +from altair_saver import save + +save(chart, "chart.vl.json") # Vega-Lite JSON specification +save(chart, "chart.vg.json") # Vega JSON specification +save(chart, "chart.html") # HTML document +save(chart, "chart.html", inline=True) # HTML document with all JS code included inline +save(chart, "chart.png") # PNG Image +save(chart, "chart.svg") # SVG Image +save(chart, "chart.pdf") # PDF Image +``` + +### Renderer +Additionally, altair_saver provides an [Altair Renderer](https://altair-viz.github.io/user_guide/display_frontends.html#altair-s-renderer-framework) +entrypoint that can display the above outputs directly in Jupyter notebooks. +For example, you can specify a vega-lite mimetype (supported by JupyterLab, nteract, and other +platforms) with a PNG fallback for other frontends as follows: +```python +alt.renderers.enable('altair_saver', ['vega-lite', 'png']) +``` + +## Installation +The ``altair_saver`` package can be installed with: +``` +$ pip install altair_saver +``` +Saving as ``vl.json`` and as ``html`` requires no additional setup. + +To install with conda, use +``` +$ conda install -c conda-forge altair_saver +``` +The conda package installs the *NodeJS* dependencies described below, so charts can be +saved to ``png``, ``svg``, and ``pdf`` without additional setup. + +### Additional Requirements + +Output to ``png``, ``svg``, and ``pdf`` requires execution of Javascript code, which +``altair_saver`` can do via one of two backends. + +#### Selenium +The *selenium* backend supports the following formats: + +- `.vg.json` +- `.png` +- `.svg`. + +To be used, it requires the [Selenium](https://selenium.dev/selenium/docs/api/py/) Python package, +and a properly configured installation of either [chromedriver](https://chromedriver.chromium.org/) or +[geckodriver](https://firefox-source-docs.mozilla.org/testing/geckodriver/). + +On Linux systems, this can be setup as follows: +```bash +$ pip install selenium +$ apt-get install chromium-chromedriver +``` +Using conda, the required packages can be installed as follows (a compatible version of +[Google Chrome](https://www.google.com/chrome/) must be installed separately): +```bash +$ conda install -c python-chromedriver-binary +``` +Selenium supports [other browsers](https://selenium-python.readthedocs.io/installation.html) as well, +but altair-saver is currently only tested with Chrome. + +#### NodeJS +The *nodejs* backend supports the following formats: + +- `.vg.json` +- `.png` +- `.svg` +- `.pdf` + +It requires [NodeJS](https://nodejs.org/), along with the [vega-lite](https://www.npmjs.com/package/vega-lite), +[vega-cli](https://www.npmjs.com/package/vega-cli), and [canvas](https://www.npmjs.com/package/canvas) packages. + +First install NodeJS either by [direct download](https://nodejs.org/en/download/) or via a +[package manager](https://nodejs.org/en/download/package-manager/), and then use the `npm` tool +to install the required packages: +```bash +$ npm install vega-lite vega-cli canvas +``` +Using conda, node and the required packages can be installed as follows: +```bash +$ conda install -c conda-forge vega-cli vega-lite-cli +``` +These packages are included automatically when installing ``altair_saver`` via conda-forge. + + + + +%prep +%autosetup -n altair-saver-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-altair-saver -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Mon Apr 10 2023 Python_Bot <Python_Bot@openeuler.org> - 0.5.0-1 +- Package Spec generated @@ -0,0 +1 @@ +acd8816c7b85eeb6d58e33bc587d913e altair_saver-0.5.0.tar.gz |