<p align="center">
<a href="https://datapane.com">
<img src="https://datapane-cdn.com/static/v1/datapane-logo-dark.svg.br" width="250px" alt="Datapane" />
</a>
</p>
<p align="center">
<a href="https://datapane.com">Home</a> |
<a href="https://docs.datapane.com">Docs</a> |
<a href="https://datapane.com/gallery">Gallery</a> |
<a href="https://github.com/datapane/examples">Examples</a> |
<a href="https://forum.datapane.com">Discuss</a>
</p>
<p align='center'>
<a href="https://github.com/datapane/datapane/">
<img src="https://img.shields.io/github/stars/datapane/datapane?style=social" alt="GitHub Stars" />
</a>
<a href="https://pypi.org/project/datapane/">
<img src="https://img.shields.io/pypi/dm/datapane?label=pip%20downloads" alt="Pip Downloads" />
</a>
<a href="https://pypi.org/project/datapane/">
<img src="https://img.shields.io/pypi/v/datapane?color=blue" alt="Latest release" />
</a>
<a href="https://anaconda.org/conda-forge/datapane">
<img alt="Conda (channel only)" src="https://img.shields.io/conda/vn/conda-forge/datapane">
</a>
</p>
<p align='center'>
<h1 align='center'>Build interactive reports in seconds using Python.</h1>
</p>
Datapane makes it simple to build interactive reports in seconds using Python.
Import Datapane's Python library into your script or notebook and build reports programmatically by wrapping components such as:
- Pandas DataFrames
- Plots from Python visualization libraries such as Bokeh, Altair, Plotly, and Folium
- Markdown and text
- Files, such as images, PDFs, JSON data, etc.
- Interactive forms which run backend Python functions
Datapane reports are interactive and can also contain pages, tabs, drop downs, and more. Once created, reports can be exported as HTML, shared as standalone files, or embedded into your own application, where your viewers can interact with your data and visualizations.
## Gallery
Check out example reports in our gallery and view their source:
- https://datapane.com/gallery
- https://github.com/datapane/examples
## Getting Started
Check out our [Quickstart](https://docs.datapane.com/quickstart) to build a report in 3m.
### Installing Datapane
The best way to install Datapane is through pip or conda.
#### pip
```
$ pip3 install -U datapane
```
#### conda
```
$ conda install -c conda-forge "datapane>=0.16.1"
```
Datapane also works well in hosted Jupyter environments such as Colab or Binder, where you can install as follows:
```
!pip3 install --quiet datapane
```
## Examples
### 📊 Share plots, data, and more as reports
Create reports from pandas DataFrames, plots from your favorite libraries, and text.
<p>
<img width='485px' align='left' alt="Simple Datapane app example with text, plot and table" src="https://user-images.githubusercontent.com/3541695/176251650-f49ea9f8-3cd4-4eda-8e78-ccba77e8e02f.png">
<p>
```python
import altair as alt
from vega_datasets import data
import datapane as dp
df = data.iris()
fig = (
alt.Chart(df)
.mark_point()
.encode(
x="petalLength:Q",
y="petalWidth:Q",
color="species:N"
)
)
view = dp.Blocks(
dp.Plot(fig),
dp.DataTable(df)
)
dp.save_report(view, path="my_app.html")
```
</p>
### 🎛 Layout using interactive blocks
Add dropdowns, selects, grid, pages, and 10+ other interactive blocks.
<p>
<img width='485px' align='left' alt="Complex layout" src="https://user-images.githubusercontent.com/3541695/176288321-44f7e76f-5032-434b-a3b0-ed7e3911b5d5.png">
<p>
```python
...
view = dp.Blocks(
dp.Formula("x^2 + y^2 = z^2"),
dp.Group(
dp.BigNumber(
heading="Number of percentage points",
value="84%",
change="2%",
is_upward_change=True
),
dp.BigNumber(
heading="Simple Statistic", value=100
), columns=2
),
dp.Select(
dp.Plot(fig, label="Chart"),
dp.DataTable(df, label="Data")
),
)
dp.save_report(view, path="layout_example.html")
```
## Next Steps
- [Quickstart](https://docs.datapane.com/quickstart) - build a report in 3m
- [Visit our Forums](https://forum.datapane.com/) - leave feedback, get help, ask questions and request features
- [View Examples](https://github.com/datapane/examples)
- [Read the documentation](https://docs.datapane.com)
## Analytics
By default, the Datapane Python library collects error reports and usage telemetry.
This is used by us to help make the product better and to fix bugs.
If you would like to disable this, simply create a file called `no_analytics` in your `datapane` config directory, e.g.
### Linux
```bash
$ mkdir -p ~/.config/datapane && touch ~/.config/datapane/no_analytics
```
### macOS
```bash
$ mkdir -p ~/Library/Application\ Support/datapane && touch ~/Library/Application\ Support/datapane/no_analytics
```
### Windows (PowerShell)
```powershell
PS> mkdir ~/AppData/Roaming/datapane -ea 0
PS> ni ~/AppData/Roaming/datapane/no_analytics -ea 0
```
You may need to try `~/AppData/Local` instead of `~/AppData/Roaming` on certain Windows configurations depending on the type of your user-account.
Raw data
{
"_id": null,
"home_page": "https://www.datapane.com",
"name": "datapane",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.0,<4.0.0",
"maintainer_email": "",
"keywords": "data,analysis,jupyter,pandas,altair",
"author": "Datapane Team",
"author_email": "dev@datapane.com",
"download_url": "https://files.pythonhosted.org/packages/4a/44/73164e4f57a1f5b943440e7e365969bb333cf212f51440dde448dcd12203/datapane-0.16.7.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"https://datapane.com\">\n <img src=\"https://datapane-cdn.com/static/v1/datapane-logo-dark.svg.br\" width=\"250px\" alt=\"Datapane\" />\n </a>\n</p>\n<p align=\"center\">\n <a href=\"https://datapane.com\">Home</a> |\n <a href=\"https://docs.datapane.com\">Docs</a> |\n <a href=\"https://datapane.com/gallery\">Gallery</a> |\n <a href=\"https://github.com/datapane/examples\">Examples</a> |\n <a href=\"https://forum.datapane.com\">Discuss</a>\n</p>\n<p align='center'>\n <a href=\"https://github.com/datapane/datapane/\">\n <img src=\"https://img.shields.io/github/stars/datapane/datapane?style=social\" alt=\"GitHub Stars\" />\n </a>\n <a href=\"https://pypi.org/project/datapane/\">\n <img src=\"https://img.shields.io/pypi/dm/datapane?label=pip%20downloads\" alt=\"Pip Downloads\" />\n </a>\n <a href=\"https://pypi.org/project/datapane/\">\n <img src=\"https://img.shields.io/pypi/v/datapane?color=blue\" alt=\"Latest release\" />\n </a>\n <a href=\"https://anaconda.org/conda-forge/datapane\">\n <img alt=\"Conda (channel only)\" src=\"https://img.shields.io/conda/vn/conda-forge/datapane\">\n </a>\n</p>\n\n<p align='center'>\n <h1 align='center'>Build interactive reports in seconds using Python.</h1>\n</p>\n\nDatapane makes it simple to build interactive reports in seconds using Python.\n\nImport Datapane's Python library into your script or notebook and build reports programmatically by wrapping components such as:\n\n- Pandas DataFrames\n- Plots from Python visualization libraries such as Bokeh, Altair, Plotly, and Folium\n- Markdown and text\n- Files, such as images, PDFs, JSON data, etc.\n- Interactive forms which run backend Python functions\n\nDatapane reports are interactive and can also contain pages, tabs, drop downs, and more. Once created, reports can be exported as HTML, shared as standalone files, or embedded into your own application, where your viewers can interact with your data and visualizations.\n\n## Gallery\n\nCheck out example reports in our gallery and view their source:\n\n- https://datapane.com/gallery\n- https://github.com/datapane/examples\n\n## Getting Started\n\nCheck out our [Quickstart](https://docs.datapane.com/quickstart) to build a report in 3m.\n\n### Installing Datapane\n\nThe best way to install Datapane is through pip or conda.\n\n#### pip\n\n```\n$ pip3 install -U datapane\n```\n\n#### conda\n\n```\n$ conda install -c conda-forge \"datapane>=0.16.1\"\n```\n\nDatapane also works well in hosted Jupyter environments such as Colab or Binder, where you can install as follows:\n\n```\n!pip3 install --quiet datapane\n```\n\n## Examples\n\n### \ud83d\udcca Share plots, data, and more as reports\n\nCreate reports from pandas DataFrames, plots from your favorite libraries, and text.\n\n<p>\n\n<img width='485px' align='left' alt=\"Simple Datapane app example with text, plot and table\" src=\"https://user-images.githubusercontent.com/3541695/176251650-f49ea9f8-3cd4-4eda-8e78-ccba77e8e02f.png\">\n\n<p>\n\n```python\nimport altair as alt\nfrom vega_datasets import data\nimport datapane as dp\n\ndf = data.iris()\nfig = (\n alt.Chart(df)\n .mark_point()\n .encode(\n x=\"petalLength:Q\",\n y=\"petalWidth:Q\",\n color=\"species:N\"\n )\n)\nview = dp.Blocks(\n dp.Plot(fig),\n dp.DataTable(df)\n)\ndp.save_report(view, path=\"my_app.html\")\n```\n\n</p>\n\n### \ud83c\udf9b Layout using interactive blocks\n\nAdd dropdowns, selects, grid, pages, and 10+ other interactive blocks.\n\n<p>\n\n<img width='485px' align='left' alt=\"Complex layout\" src=\"https://user-images.githubusercontent.com/3541695/176288321-44f7e76f-5032-434b-a3b0-ed7e3911b5d5.png\">\n\n<p>\n\n```python\n...\n\nview = dp.Blocks(\n dp.Formula(\"x^2 + y^2 = z^2\"),\n dp.Group(\n dp.BigNumber(\n heading=\"Number of percentage points\",\n value=\"84%\",\n change=\"2%\",\n is_upward_change=True\n ),\n dp.BigNumber(\n heading=\"Simple Statistic\", value=100\n ), columns=2\n ),\n dp.Select(\n dp.Plot(fig, label=\"Chart\"),\n dp.DataTable(df, label=\"Data\")\n ),\n)\ndp.save_report(view, path=\"layout_example.html\")\n```\n\n## Next Steps\n\n- [Quickstart](https://docs.datapane.com/quickstart) - build a report in 3m\n- [Visit our Forums](https://forum.datapane.com/) - leave feedback, get help, ask questions and request features\n- [View Examples](https://github.com/datapane/examples)\n- [Read the documentation](https://docs.datapane.com)\n\n## Analytics\n\nBy default, the Datapane Python library collects error reports and usage telemetry.\nThis is used by us to help make the product better and to fix bugs.\nIf you would like to disable this, simply create a file called `no_analytics` in your `datapane` config directory, e.g.\n\n### Linux\n\n```bash\n$ mkdir -p ~/.config/datapane && touch ~/.config/datapane/no_analytics\n```\n\n### macOS\n\n```bash\n$ mkdir -p ~/Library/Application\\ Support/datapane && touch ~/Library/Application\\ Support/datapane/no_analytics\n```\n\n### Windows (PowerShell)\n\n```powershell\nPS> mkdir ~/AppData/Roaming/datapane -ea 0\nPS> ni ~/AppData/Roaming/datapane/no_analytics -ea 0\n```\n\nYou may need to try `~/AppData/Local` instead of `~/AppData/Roaming` on certain Windows configurations depending on the type of your user-account.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Datapane client library and CLI tool",
"version": "0.16.7",
"project_urls": {
"Documentation": "https://docs.datapane.com",
"Homepage": "https://www.datapane.com",
"Repository": "https://github.com/datapane/datapane"
},
"split_keywords": [
"data",
"analysis",
"jupyter",
"pandas",
"altair"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6e2a512a266b402d5865ea9ac98ca727f16583a4778ef46b5a3781b5b7f16c07",
"md5": "073ae470e95476f763d62820a00d9ceb",
"sha256": "dff781c94b584d1e8c07650305cb600a48b2c58d6890a4a1f2019888486390fa"
},
"downloads": -1,
"filename": "datapane-0.16.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "073ae470e95476f763d62820a00d9ceb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.0,<4.0.0",
"size": 224714,
"upload_time": "2023-07-18T15:43:17",
"upload_time_iso_8601": "2023-07-18T15:43:17.486583Z",
"url": "https://files.pythonhosted.org/packages/6e/2a/512a266b402d5865ea9ac98ca727f16583a4778ef46b5a3781b5b7f16c07/datapane-0.16.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4a4473164e4f57a1f5b943440e7e365969bb333cf212f51440dde448dcd12203",
"md5": "6f80853c8e28a9fdd1b83c40fe7c9736",
"sha256": "93893074b60ba4550b2c4bd48f1752df5a5ddf04cccfc7fd877afcfc5966e85e"
},
"downloads": -1,
"filename": "datapane-0.16.7.tar.gz",
"has_sig": false,
"md5_digest": "6f80853c8e28a9fdd1b83c40fe7c9736",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.0,<4.0.0",
"size": 185670,
"upload_time": "2023-07-18T15:43:19",
"upload_time_iso_8601": "2023-07-18T15:43:19.531366Z",
"url": "https://files.pythonhosted.org/packages/4a/44/73164e4f57a1f5b943440e7e365969bb333cf212f51440dde448dcd12203/datapane-0.16.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-18 15:43:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "datapane",
"github_project": "datapane",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "datapane"
}
JSON
