Skip to content

Commit

Permalink
Rename pivot to swiv
Browse files Browse the repository at this point in the history
  • Loading branch information
cheddar committed Nov 23, 2016
1 parent a636f91 commit 95f040c
Show file tree
Hide file tree
Showing 128 changed files with 307 additions and 322 deletions.
7 changes: 3 additions & 4 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,9 +1,8 @@
.DS_Store
/.idea/workspace.xml
/.idea/tasks.xml
/.idea/encodings.xml
.idea

/.sass-cache/
/imply-pivot-*.tgz
/imply-swiv-*.tgz
/node_modules/
/build/
/public/
Expand Down
1 change: 1 addition & 0 deletions .idea/misc.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion .npmignore
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# === Webstorm ===
/.idea/
/.sass-cache/
/imply-pivot-*.tgz
/imply-swiv-*.tgz
/assets/data/*-large.*
/webstorm
/resources/
Expand Down
24 changes: 11 additions & 13 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Change Log

For updates follow [@implydata](https://twitter.com/implydata) on Twitter.

## 0.9.39

- Fixed numeric dimension extent computation
Expand Down Expand Up @@ -177,16 +175,16 @@ For updates follow [@implydata](https://twitter.com/implydata) on Twitter.

- Complete refactor of settings architecture
- Settings can be updated at runtime
- Pivot can connect to multiple clusters
- Pivot can connect to Postgres and MySQL
- Swiv can connect to multiple clusters
- Swiv can connect to Postgres and MySQL
- Full support of Druid 0.9.1
- Auth module versioning
- Command line flag changes (see [writeup](docs/pivot-0.9.x-migration.md))
- Druid Request decorator changes (see [writeup](docs/pivot-0.9.x-migration.md))
- Ability to [generate programmatic links](docs/generating-links-into-pivot.md) into Pivot
- Command line flag changes (see [writeup](docs/swiv-0.9.x-migration.md))
- Druid Request decorator changes (see [writeup](docs/swiv-0.9.x-migration.md))
- Ability to [generate programmatic links](docs/generating-links-into-swiv.md) into Swiv
- Ability to configure `serverHost`
- Auto refresh icon rotation
- Pivot is npm shrinkwrapped
- Swiv is npm shrinkwrapped
- Better dimension / measure panel scaling

## 0.8.42
Expand Down Expand Up @@ -223,7 +221,7 @@ For updates follow [@implydata](https://twitter.com/implydata) on Twitter.
## 0.8.35

- Two splits with scrolling in bar chart
- Pivot will only query within server root
- Swiv will only query within server root

## 0.8.34

Expand All @@ -236,7 +234,7 @@ For updates follow [@implydata](https://twitter.com/implydata) on Twitter.

## 0.8.32

- Configurable server root (default: `/pivot`)
- Configurable server root (default: `/swiv`)

## 0.8.31

Expand Down Expand Up @@ -332,7 +330,7 @@ For updates follow [@implydata](https://twitter.com/implydata) on Twitter.

## 0.8.12

- New [customization options](https://github.com/implydata/pivot/blob/master/docs/configuration.md#customization)
- New [customization options](https://github.com/yahoo/swiv/blob/master/docs/configuration.md#customization)
- Updated favicon PNGs

## 0.8.11
Expand All @@ -345,7 +343,7 @@ For updates follow [@implydata](https://twitter.com/implydata) on Twitter.

## 0.8.9

- New plywood fixes startup [bug](https://github.com/implydata/pivot/issues/150).
- New plywood fixes startup [bug](https://github.com/yahoo/swiv/issues/150).

## 0.8.8

Expand Down Expand Up @@ -376,7 +374,7 @@ For updates follow [@implydata](https://twitter.com/implydata) on Twitter.

## 0.8.2

- Added UI loader and chucked up main pivot JS blob into two
- Added UI loader and chucked up main swiv JS blob into two
- Added ability to [decorate requests](/docs/security.md)

## 0.8.1
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@

- Bug reports, feature requests, and any sort of feedback is very welcome.
- Pull requests fixing bugs are very welcome as well.
- For pull requests involving any changes to the UI, please discuss them first on the [Imply user group](https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!forum/imply-user-group).
- For pull requests involving any changes to the UI, please discuss them first in a github issue.
2 changes: 1 addition & 1 deletion NOTICE
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Pivot
Swiv

-------------------------------------------------------------------------------

Expand Down
70 changes: 31 additions & 39 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,24 @@
This is the code from the last known OSS release of pivot
# Swiv

# Pivot

Pivot is a web-based exploratory visualization UI for [Druid](https://github.com/druid-io/druid) built on top of
Swiv is a web-based exploratory visualization UI for [Druid](https://github.com/druid-io/druid) built on top of
[Plywood](https://github.com/implydata/plywood).

Pivot is best used with the [Imply Analytics Platform](http://imply.io/product)
which can be downloaded from [imply.io/download](http://imply.io/download) and comes with the stable version of Pivot.
Alternatively nightly standalone Pivot versions can be installed through npm.

The project is currently undergoing rapid development.
Swiv is best used with [Druid](http://druid.io).
Internal and external APIs may change with little notice.

## Features

**Drag-and-drop UI**

![Drag to Split](https://github.com/implydata/pivot/raw/master/docs/images/drag-and-drop.gif)
![Drag to Split](https://github.com/yahoo/swiv/raw/master/docs/images/drag-and-drop.gif)

**Contextual exploration**

![Time Highlight](https://github.com/implydata/pivot/raw/master/docs/images/explore.gif)
![Time Highlight](https://github.com/yahoo/swiv/raw/master/docs/images/explore.gif)

**Comparisons**

![Time Highlight](https://github.com/implydata/pivot/raw/master/docs/images/compare.gif)
![Time Highlight](https://github.com/yahoo/swiv/raw/master/docs/images/compare.gif)

## Usage

Expand All @@ -42,56 +36,56 @@ brew install node
Next simply run:

```
npm i -g imply-pivot
npm i -g yahoo-swiv
```

**That's it.** You are ready to Pivot.
**That's it.** You are ready to Swiv.


### Example

Start off by running an example (static) dataset:

```
pivot --examples
swiv --examples
```

### Run with Druid

Next connect Pivot to your broker by simply pointing it to your broker host
Next connect Swiv to your broker by simply pointing it to your broker host

```
pivot --druid your.druid.broker.host:8082
swiv --druid your.druid.broker.host:8082
```

Pivot will automatically introspect your Druid cluster and figure out your dimensions and measures.
Swiv will automatically introspect your Druid cluster and figure out your dimensions and measures.

**Note:** if Pivot starts up and gives you a query error it is most likely because it could not properly introspect your schema.
You probably have some *hyperUnique* column that Pivot is trying to SUM over.
You will have to provide Pivot with a config file as in the nest section.
**Note:** if Swiv starts up and gives you a query error it is most likely because it could not properly introspect your schema.
You probably have some *hyperUnique* column that Swiv is trying to SUM over.
You will have to provide Swiv with a config file as in the nest section.

### Create a config

In general Pivot will never know your schema as well as you.
To get a better experience you should create a [config](https://github.com/implydata/pivot/blob/master/docs/configuration.md) and provide it to Pivot.
The fastest way to create a config is to have Pivot do it for you.
In general Swiv will never know your schema as well as you.
To get a better experience you should create a [config](https://github.com/yahoo/swiv/blob/master/docs/configuration.md) and provide it to Swiv.
The fastest way to create a config is to have Swiv do it for you.

```
pivot --druid your.druid.broker.host:8082 --print-config --with-comments > config.yaml
swiv --druid your.druid.broker.host:8082 --print-config --with-comments > config.yaml
```

The `--print-config` option will make Pivot run through its regular introspection and then, instead of tarting a server, dump the YAML onto the stdout and exit.
The `--print-config` option will make Swiv run through its regular introspection and then, instead of tarting a server, dump the YAML onto the stdout and exit.

```
pivot --config config.yaml
swiv --config config.yaml
```

Now open the config in your favorite editor and adjust to taste.
Make sure to read through the [documentation](https://github.com/implydata/pivot/blob/master/docs/configuration.md) about the possible configuration options.
Make sure to read through the [documentation](https://github.com/yahoo/swiv/blob/master/docs/configuration.md) about the possible configuration options.

## Development

Here are the steps to clone Pivot and run it as a developer.
Here are the steps to clone Swiv and run it as a developer.

Firstly make sure you have the latest node (>= 5.5.x) and gulp installed:

Expand All @@ -102,11 +96,11 @@ npm i -g gulp
Clone the project

```
git clone git@github.com:implydata/pivot.git
cd pivot
git clone git@github.com:yahoo/swiv.git
cd swiv
```

Inside the pivot folder run:
Inside the swiv folder run:

```
npm install
Expand All @@ -116,18 +110,18 @@ gulp
Finally you have to create a `config.yaml` file. (or use the sample)

```
./bin/pivot --druid your.druid.broker.host:8082 --print-config --with-comments > config.yaml
./bin/swiv --druid your.druid.broker.host:8082 --print-config --with-comments > config.yaml
```

The `--with-comments` flag adds docs about what goes into the config.

Then you are ready to

```
./bin/pivot --config config.yaml
./bin/swiv --config config.yaml
```

We use [WebStorm 2016.1](https://www.jetbrains.com/webstorm/) to develop Pivot and the checked in `.idea` directory contains
We use [WebStorm 2016.1](https://www.jetbrains.com/webstorm/) to develop Swiv and the checked in `.idea` directory contains
all of the auto formatting and code styles. You are free to use any editor as all the build scripts are editor agnostic.

Running `gulp watch` will build the project and start all the automated watchers.
Expand All @@ -138,7 +132,7 @@ Running `gulp watch` will build the project and start all the automated watchers

- Exclusion filters
- Full support of Druid 0.9.1
- Pivot can connect to multiple clusters, also Postgres and MySQL
- Swiv can connect to multiple clusters, also Postgres and MySQL
- Continuous dimension filtering and splitting
- Support for Druid Theta sketches (for countDistinct())
- Horizontal bars in Table
Expand All @@ -158,6 +152,4 @@ For a full list of changes see our [CHANGELOG](CHANGELOG.md)

## Questions & Support

For updates about new and upcoming features follow [@implydata](https://twitter.com/implydata) on Twitter.

Please file bugs and feature requests by opening and issue on GitHub and direct all questions to our [user groups](https://groups.google.com/forum/#!forum/imply-user-group).
Please file bugs and feature requests by opening an issue on GitHub, also questions can be asked via GitHub issues.
2 changes: 1 addition & 1 deletion assets/favicon/manifest.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "Pivot",
"name": "Swiv",
"icons": [
{
"src": "\/favicon\/android-chrome-36x36.png?v=3",
Expand Down
File renamed without changes.
Loading

0 comments on commit 95f040c

Please sign in to comment.