Commit Graph

205 Commits

Author SHA1 Message Date
Maxime Beauchemin
81fc3dfbee [build] fix pip install issues on OSX High Sierra (#6201)
* [build] fix pip install issues on OSX High Sierra

I think requirements.txt was out-of-sync as well.

Also had to:
export
  LDFLAGS="-L/usr/local/opt/openssl/lib"
export
  CPPFLAGS="-I/usr/local/opt/openssl/include"
export
  PKG_CONFIG_PATH="/usr/local/opt/openssl/lib/pkgconfig"

* Fix click
2018-10-29 10:33:51 -07:00
Max Goodridge
9580103c22 Fix typo in load-examples command (#6193) 2018-10-25 20:47:43 -07:00
Maxime Beauchemin
160e47720c
Deprecate support for Python < 3.6 (#5985)
* Deprecate support for Python < 3.6

This is a first step, beyond this we can:
* remove all from future imports
* remove 'six' lib as a dependency
* start using f-strings
* enjoy ourselves

* fix tox

* Rebasing

* fix
2018-10-05 13:44:45 -04:00
Alek Storm
549328f8f0 Clean up CONTRIBUTING.md: (#5911)
- Reorganize sections for better navigability
- Add table of contents
- Rework frontend assets section for clarity and DRY
- Rework translating section for clarity, add "Add Translations" contribution type
- Move release docs only useful for maintainers to RELEASING.md
- Other miscellaneous improvements
2018-09-19 10:01:51 -07:00
livinm
057c749471 Addded documentation for Teradata DB (#5885)
Documentation extension for PR5870
2018-09-13 08:01:37 -07:00
Maxime Beauchemin
517fea33b6
[docs] suggest using python3.6 in installation docs (#5834) 2018-09-10 08:48:03 -07:00
Ville Brofeldt
77fe9ef130 Force quoted column aliases for Oracle-like databases (#5686)
* Replace dataframe label override logic with table column override

* Add mutation to any_date_col

* Linting

* Add mutation to oracle and redshift

* Fine tune how and which labels are mutated

* Implement alias quoting logic for oracle-like databases

* Fix and align column and metric sqla_col methods

* Clean up typos and redundant logic

* Move new attribute to old location

* Linting

* Replace old sqla_col property references with function calls

* Remove redundant calls to mutate_column_label

* Move duplicated logic to common function

* Add db_engine_specs to all sqla_col calls

* Add missing mydb

* Add note about snowflake-sqlalchemy regression

* Make db_engine_spec mandatory in sqla_col

* Small refactoring and cleanup

* Remove db_engine_spec from get_from_clause call

* Make db_engine_spec mandatory in adhoc_metric_to_sa

* Remove redundant mutate_expression_label call

* Add missing db_engine_specs to adhoc_metric_to_sa

* Rename arg label_name to label in get_column_label()

* Rename label function and add docstring

* Remove redundant db_engine_spec args

* Rename col_label to label

* Remove get_column_name wrapper and make direct calls to db_engine_spec

* Remove unneeded db_engine_specs

* Rename sa_ vars to sqla_
2018-09-03 22:49:58 -07:00
Maxime Beauchemin
bddc9522e8 [docs] FAQ entry 'Does Superset work with [database engine]?' 2018-08-25 16:18:19 -07:00
Jillian Rowe
a39dfb9ff9 Add additional heatmap schemas (#5549)
* got skeleton started

* added d3-scale-chromatic to package.json

* got hex values instead of calling from a function

* got rid of d3-scale-chromatic - no longer needed

* added schemas to controls

* damn editor broken some line spacing

* commit

* fix style issues

* whyyyyy won't this build

* whyyyyy won't this build

* damn typo

* hahaha got editor to deal with style configs

* no i guess i didn't

* gotta get them all

* again

* trying to get docker build ot work

* updated installation docs with some osx instructions

* restoring yarn.lock not sure why it changed

* trying to fix indent

* trying again

* CODE STYLE CHANGES WORK

* removing some colors that are too close to white

* human readable labels for names

* human readable labels for names
2018-08-13 23:37:17 -07:00
Octavian
39ff9deb57 update python3 version for testing to 3.6 (#5562)
* update python version for testing to 3.6

* CONTRIBUTING.md states pull requests should work on py27, py36+

* CONTRIBUTING.md states pull requests should work on py27 and py36
2018-08-07 13:22:19 -07:00
Yoon
3df82d9da6 Modify Athena connection description (#5492) 2018-07-25 23:12:14 -07:00
Ville Brofeldt
670b145b1e Add Snowflake connection string instructions (#5443) 2018-07-20 15:19:18 -07:00
Zachary Friedman
976e815a6e RST formatting fix for Installation docs (#5346) 2018-07-04 17:03:41 -04:00
Zachary Friedman
6f4a2e3505 Fix typo in Start with Docker (#5348) 2018-07-04 17:02:03 -04:00
Ricardo Peironcely
a84f4304de Describe the use of custom OAuth2 authorization servers (#5220)
As Superset extends flask SecurityManager with its own implementation, it's not obvious how to connect Superset with OAuth2 authorization servers that are not covered under flask.
2018-06-19 08:48:48 -07:00
Xiao Hanyu
0a276ff75d Init docker for local development environment. (#4193)
This commit will try to dockerize superset in local development
environment.

The basic design is:
- Enable superset, redis and postgres service instead of using sqlite,
  just want to simulate production environment settings
- Use environment variables to config various app settings. It's easy to
  run and config superset to any environment if we use environment than
  traditional config files
- For local development environment, we just expose postgres and redis
  to local host machine thus you can connect local port via `psql` or
  `redis-cli`
- Wrap start up command in a standard `docker-entrypoint.sh`, and use
  `tail -f /dev/null` combined with manually `superset runserver -d` to
  make sure that code error didn't cause the container to fail.
- Use volumes to share code between host and container, thus you can use
  your favourite tools to modify code and your code will run in
  containerized environment
- Use volumes to persistent postgres and redis data, and also
  `node_modules` data.
  - If we don't cache `node_modules` in docker volume, then every time
    run docker build, the `node_modules` directory, will is about 500 MB
    large, will be sent to docker daemon, and make the build quite slow.
- Wrap initialization commands to a single script `docker-init.sh`

After this dockerize setup, any developers who want to contribute to
superset, just follow three easy steps:

```
git clone https://github.com/apache/incubator-superset/
cd incubator-superset
cp contrib/docker/{docker-build.sh,docker-compose.yml,docker-entrypoint.sh,docker-init.sh,Dockerfile} .
cp contrib/docker/superset_config.py superset/
bash -x docker-build.sh
docker-compose up -d
docker-compose exec superset bash
bash docker-init.sh
```
2018-06-09 21:26:41 -07:00
Ky-Anh Huynh
556ef44fac docs: Add new Athena URI scheme awsathena+rest:// (#5112)
See also some discussions on https://github.com/laughingman7743/PyAthenaJDBC/pull/62
2018-05-31 22:19:07 -07:00
Maxime Beauchemin
f21ba1aba7
[docs] add entry for Hive in installation.rst (#4942) 2018-05-07 15:26:19 -07:00
Vihar Kurama
a60d577b7d Update installation.rst (#4930) 2018-05-07 13:48:41 -07:00
Casper CY Chiang
976e43e681 Install superset in Kubernetes with helm chart (#4923)
* Add helm chart to install superset in kubernetes

* set resources into unlimited

* Add descriptions to Chart.yaml

* add an entry in docs/installation.rst
2018-05-03 17:35:38 -07:00
Maxime Beauchemin
fa4acb1bda
Add doc entry for BigQuery support (#4917)
closes https://github.com/apache/incubator-superset/issues/945
2018-05-01 21:28:27 -07:00
Ville Brofeldt
fa3da8c888 Implement Snowflake engine with supported time grains (#4882)
* Implement Snowflake engine with supported time grains

* Fix typo in second grain
2018-04-25 14:44:24 -07:00
Maxime Beauchemin
23a3365cd1
Update README with fresher screenshots (#4825)
* Improve screenshots in README.md

* Add border to images

* Add visualizations.png
2018-04-14 15:32:26 -07:00
Maxime Beauchemin
4c268ec678
[docs] many improvements to the documentation / cleanup (#4817)
* fixed RSTs so images will show up on github
* fresh screenshots on main page
* removing irrelevant portions
* moved a set of sections under 'Misc'
* rebuilt the Gallery with all screenshots
2018-04-13 10:23:27 -07:00
Riccardo Magliocchetti
daf9a3bfb5 docs: use proper dialect for redshift (#4823)
Use redshift+psycopg2 instead of the postgresql one.
2018-04-13 09:13:33 -07:00
Maxime Beauchemin
adda30bf66
Set longer CSRF token duration (one week) (#4741)
Default is one hour (3600), also this entry makes the setting a bit more
discoverable
http://flask-wtf.readthedocs.io/en/stable/config.html?highlight=csrf
2018-04-04 15:55:32 -07:00
John Bodley
b3442a7b53
[cli] Deprecating gunicorn/flower dependencies (#4451) 2018-03-30 09:28:16 -07:00
Maxime Beauchemin
1e0bcba568
Allowing config flag to turn off flask-compress (#4617) 2018-03-15 17:17:04 -07:00
Riccardo Magliocchetti
1d27fb30ff docs: fixup code blocks rendering (#4594) 2018-03-11 11:34:58 -07:00
Hugh A. Miles II
9478291bf6 Added Example snippet for setting up Redis cache (#4434)
* Added Example snippet for setting up Redis cache

* Update installation.rst

* Update installation.rst
2018-02-15 20:27:03 -08:00
Raffaele Spangaro
75a2b4f610 Update installation.rst for Ubuntu 16.04 LTS (#4321)
Ubuntu 16.04 by default install python2.7 alongside with python 3.5 and set python2.7 as default. If you have created a virtualenv with python3.5 compilation fails due to wrong python-dev library installed. 

If you install ``python3.5-dev`` the build for the wheel package of  ``cryptography`` run fine.
2018-01-31 18:03:16 -08:00
John Bodley
d57012067b [FAB] configuring updating of permissions (#4172) 2018-01-08 14:39:18 -08:00
zhao yongjie
9e053923d4 Adding Apache Kylin datasource for documentation (#4148) 2018-01-03 20:24:15 -08:00
Benedict Jin
82ed4878c4 Fix rst grammar problems (#4116) 2017-12-25 23:39:28 -08:00
rumbin
f10395b2f7 [doc] added setting X-Forwarded-Proto to https behind reverse proxy with ssl encryption; fixes #3655 (#3976) 2017-12-03 22:00:58 -08:00
Maxime Beauchemin
84a7730f47
[docs] making it clear sqlite shouldn't be used in a cluster (#3965) 2017-11-30 22:06:16 -08:00
Maxime Beauchemin
83e6807fa0
[docs] add StatsD setup instructions (#3813) 2017-11-10 17:54:56 -08:00
Prasanna Swaminathan
9500f0aae3 Fix typo in installation.rst (#3818)
`superser runserver` should be `superset runserver`
2017-11-09 20:22:45 -08:00
Stephanie Rivera
7fd9c82ae8 Update to reflect new version of cryptography (#3748)
update to 1.9

I have built and pip installed with latest cryptography.
2017-11-02 13:51:17 -07:00
Gábor Hermann
0bd2ac5353 Minor documentation fix (#3553) 2017-09-29 16:47:18 -07:00
Maxime Beauchemin
e66f68d36c Better installation docs (#3469) 2017-09-18 09:49:48 -07:00
Riccardo Magliocchetti
6962c76412 docs: athena can be installed from pypi (#3477)
As sqlalchemy support has been merged and available in a release
since a few.
2017-09-18 09:45:00 -07:00
fabianmenges
e22aecb0d1 Adding hook for CSRF exempting flask views. (#3435) 2017-09-14 20:54:18 -07:00
fabianmenges
fdee06bbf2 Adding hook for external password store for databases (#3436) 2017-09-13 20:59:03 -07:00
Riccardo Magliocchetti
ef7e9dd336 docs: use yarn in making your own build (#3235) 2017-08-04 09:31:36 -07:00
Riccardo Magliocchetti
747bf80474 docs: fixup installation examples code indentation (#3169) 2017-07-26 09:20:06 -07:00
timfeirg
17bd7512ff remove reference for CSRF_ENABLED, and use WTF_CSRF_ENABLED instead (#2946) 2017-06-12 13:17:59 -07:00
Anthony Bush
9b34600c8e Remove duplicate text (#2761) 2017-05-15 21:31:37 -07:00
Maxime Beauchemin
cb14640a82 Removing uneeded results_backends.py (#2717) 2017-05-04 23:41:10 -07:00
Marek Vavruša
9ff351532a Basic integration with ClickHouse (#1844)
* db_engine_specs: added engine spec for clickhouse

* models: group by time without join on subquery

if this is enabled, it will remove the subquery when grouping by time,
and group by time will be rewritten as group by timeslot, ...

this particularly fixes clickhouse backend

* docs: added clickhouse

* models: allow using secondary dttm columns as constraints

* superset/forms: configurable default slice since time

* superset/models: respect dialect quoting

* dttm handling, codeclimate tweaks
2017-05-03 13:57:39 -07:00
Maxime Beauchemin
b3e0b5b586 Specifying cryptography version in install docs 2017-04-26 14:20:27 -07:00
Maxime Beauchemin
d289783b67 Adding Vertica to installation docs (#2581) 2017-04-10 15:37:14 -07:00
rhunwicks
b97a8275d4 Clarify docs on Redis package required for caching (#2557) 2017-04-05 10:07:36 -07:00
dwa
243eeadfd6 installation instructions for AWS Athena (#2538) 2017-04-03 08:22:40 -07:00
Alex DeBrie
7b28bcef15 Fix documentation for adding a Redshift database (#2447)
When adding a Redshift database, the docs said to use a connection
string that started with `redshift+psycopg2://...`, but this results
in a Python error from how SQLAlchemy executes the `get_schema_names`
method (first reported [here](https://github.com/airbnb/superset/issues/2364#issuecomment-284705179)).

The fix is to use `postgresql+psycog2://...` for the Redshift connection
string.
2017-03-21 13:59:29 -07:00
Maxime Beauchemin
f6ffc00748 Allow running Flask Blueprints alongside Superset (#2337)
* Allowing environments to import Blueprints

* Docs entry

* Fix typos
2017-03-03 17:09:54 -08:00
Joel Donahue
e91bc9dfcc added gcc-c++ for RHEL OS dependencies (#2286) 2017-02-27 10:19:33 -08:00
Maxime Beauchemin
0296158100 [docs] more specific about python versions 2017-02-23 13:47:15 -08:00
Maxime Beauchemin
e84c6393b8 Correcting docs to run npm build instead of prod 2017-01-24 08:36:19 -08:00
mobcdi
98e83255e6 Added extra details around setting up admin user (#1937)
after running create-admin the user will be prompted to provide extra details and set the admin password
2017-01-10 09:06:38 -08:00
andreamelloncelli
861a3bd4ae docs: 8088 is the default port, no need to specify it (#1861)
* docs: 8088 is the default port, no need to specify it

* docs: hint to use a non default port
2017-01-04 14:43:56 -08:00
Rossouw Minnaar
2fb94a89e2 Add ADDITIONAL_MIDDLEWARE option to config (#1832)
Add documentation to explain ADDITIONAL_MIDDLEWARE
2016-12-14 09:39:59 -08:00
Riccardo Magliocchetti
205928e6df docs: fix python-redis link markup (#1683) 2016-11-25 14:09:14 -08:00
Maxime Beauchemin
84b98c234f Adding Greenplum to supported dbs 2016-11-14 15:46:24 -08:00
Maxime Beauchemin
90f00c5b29 Minor documentation touchups 2016-11-10 11:27:56 -08:00
Maxime Beauchemin
15b67b2c6c [WiP] rename project from Caravel to Superset (#1576)
* Change in files

* Renamin files and folders

* cleaning up a single piece of lint

* Removing boat picture from docs

* add superset word mark

* Update rename note in docs

* Fixing images

* Pinning datatables

* Fixing issues with mapbox-gl

* Forgot to rename one file

* Linting

* v0.13.0

* adding pyyaml to dev-reqs
2016-11-09 23:08:22 -08:00
Maxime Beauchemin
5944643da6 [sqllab] add support for Jinja templating (#1426)
* [sqllab] add support for Jinja templating

* Adressing comments

* Presto macros

* Progress

* Addressing coments
2016-10-26 11:09:27 -07:00
Maxime Beauchemin
0a3121c243 [doc] installation, load examples before init 2016-10-07 10:57:26 -07:00
Stefano Ordine
609ae22bda less number of default workers. (#1206) 2016-10-07 10:16:41 -07:00
Riccardo Magliocchetti
a8a16900e7 docs: add libsasl as system requirement on linux (#1257)
* docs: add libsasl as system requirement on linux

* docs: add openldap as system dependencies on linux too

Fix #1256
2016-10-05 13:00:38 -07:00
Riccardo Magliocchetti
e50b59e553 docs: document that gunicorn does not work on windows (#1258)
And suggest to use a supported platform instead.

Fix #1236
2016-10-05 12:14:09 -07:00
Maxime Beauchemin
140a055e4e [docs] add line in installation instructions 2016-10-05 08:56:55 -07:00
Maxime Beauchemin
5bf86d91ec [docs] suggest to upgrade pip and setuptools 2016-10-04 21:59:40 -07:00
Bob Ziuchkovski
d15a212e64 Add support for Werkzeug ProxyFix middleware (#1150)
Add an ENABLE_PROXY_FIX config param.  When set to True, insert the Werkzeug ProxyFix
middleware.  This middleware extracts and applies the X-Forwarded-* headers that are
inserted by common proxies and load balancers.  Fixes #1139.
2016-09-20 12:24:15 -07:00
Maxime Beauchemin
e8088d5c9a More improvements to SQL Lab (#1104)
* Handling timeouts

* Fixing timer on non-utc server

* Allowing async with results

* [bugfix] database is not selected

* Making sure the session is up and running

* Cleaning up query results and query objects

* Picking a groupby and metric field on visualize flow

* Showing local time in query history

* Using pull-left pull-right instead of grid layout for table metdata

Long column name were looking weird and icons were wrapping oddly

* Linting

* Eliminating east buttons under the sql editor

* Sort database dropdown by name

* Linting

* Allowing non-SELECT statements to run

* Adding a db config

* Making sqla checkout check cross-db
2016-09-19 15:28:10 -07:00
Maxime Beauchemin
c7467f544c Documenting making your own build (#990) 2016-08-19 15:27:35 -07:00
Riccardo Magliocchetti
a029eaa451 docs: add a faq about mapbox api key (#968)
Also add it to sample config

Fix #952
2016-08-17 08:04:39 -07:00
Adam Jones
88f4260777 Change default location for db and logs to ~/.caravel Fix #915 (#947) 2016-08-16 21:35:31 -07:00
Riccardo Magliocchetti
baf22c3c60 docs: make it clear that some config keys really need to be changed (#912) 2016-08-10 08:15:19 -07:00
Riccardo Magliocchetti
5a937f1d0b docs: simplify cryptography installation on Windows (#909)
As suggested here https://github.com/airbnb/caravel/issues/717#issuecomment-232741865
and confirmed there
https://cryptography.io/en/latest/installation/#on-windows
cryptography now ships a statically linked openssl.

Still am not sure we want to make installation on Windows easier :)
2016-08-10 08:14:42 -07:00
Riccardo Magliocchetti
b48101ca51 docs: recommend python3 and virtualenv (#901)
* docs: make it clear that python3 is the recommended version

* docs: recommend installing inside a virtualenv

And add a virtualenv primer.
2016-08-09 15:56:36 -07:00
Karl LIN
862042bb49 add redis cache hint to docs (#861) 2016-08-01 23:04:26 -07:00
Riccardo Magliocchetti
8b694ddd7a Fix caching in python3 (#806)
* caravel: fix visualization cache for python3

python3 wants bytes and not strings:

2016-07-22 10:36:09,474:INFO:root:Caching for the next 28800 seconds
2016-07-22 10:36:09,475:WARNING:root:Could not cache key 1eeb45f32960f0df0ad99a125bdaf199
2016-07-22 10:36:09,475:ERROR:root:'str' does not support the buffer interface
Traceback (most recent call last):
  File "/home/rm/caraveltest/venv/lib/python3.4/site-packages/caravel/viz.py", line 306, in get_json
    zlib.compress(self.json_dumps(payload)),
TypeError: 'str' does not support the buffer interface

Tested with memcached and pylibmc client library.

* docs: add note about using a proper memcached client library
2016-07-22 09:45:51 -07:00
Maxime Beauchemin
e813726afb Giving hingts that we support SparkSQL (#803) 2016-07-21 17:51:30 -07:00
Lech Jankovski
ff44e46d7b Add impyla to recommended packages for Impala (#649) 2016-06-21 09:41:24 -07:00
alanmcruickshank
5618df78f8 Added documentation of the health check endpoint (#644) 2016-06-20 09:24:49 -07:00
Maxime Beauchemin
04388a7b9b [docs] telling people to use gunicorn server 2016-06-16 09:16:10 -07:00
Riccardo Magliocchetti
eb208b921c config: there's no such thing as WEBSERVER_THREADS (#587)
The config option is CARAVEL_WORKERS. Bump example to 16 processes
to keep backward compatibility with the current default.
2016-06-09 16:44:13 -07:00
Giacomo Tagliabue
5f005d67e3 Add CORS support (#478)
* Add optional CORS

* make CORS an extra dependency

* add documentation
2016-06-02 12:34:36 -07:00
Maxime Beauchemin
91a3594be3 Fixing the thumbs and the galery (#346) 2016-04-13 22:32:03 -07:00
Maxime Beauchemin
3d1fc99353 Adding not in docs about connecting to dbs over SSL 2016-04-11 21:41:32 -07:00
Maxime Beauchemin
25831f0033 Making prod web server run by default 2016-04-08 22:09:01 -07:00
Maxime Beauchemin
0afa5d2cba Added FAQ and db dependencies to docs 2016-04-08 08:44:46 -07:00
Maxime Beauchemin
d933a21216 Prettyfying an image in the docs 2016-04-07 14:26:28 -07:00
Julian Nadeau
6b0b03e009 Fix localhost link in installation docs 2016-04-06 20:13:04 -07:00
Julian Nadeau
d122b37f5d Add python-pip to the install docs 2016-04-06 18:11:24 -07:00
Maxime Beauchemin
1756c27930 Adding upgrade instructions to docs 2016-04-06 18:02:40 -07:00
Maxime Beauchemin
92d588694b Improving the Installation docs 2016-04-06 08:46:32 -07:00
Maxime Beauchemin
062f2b81cf Datasource dropdown in Explore view 2016-04-06 08:23:27 -07:00
Maxime Beauchemin
034fd077e1 Doc formating fix 2016-04-04 10:36:51 -07:00
Maxime Beauchemin
93405dc23a Clarify SQLALCHEMY_DATABASE_URI in the docs 2016-04-01 16:41:02 -07:00
Maxime Beauchemin
481d821721 Tweaking docs 2016-04-01 08:37:19 -07:00
Maxime Beauchemin
7b111b790e Adding an OS dependencies section to the install docs 2016-04-01 08:33:28 -07:00
Maxime Beauchemin
b164244cd8 Renaming forgotten doc file 2016-03-29 21:24:01 -07:00
Maxime Beauchemin
d8192eca0a Introducing a caching layer 2016-03-22 18:11:10 -07:00