taps2 0.6.0 → 0.6.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +5 -5
- data/README.md.orig +113 -0
- data/lib/taps/version.rb +1 -1
- metadata +2 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: f33ad00f7467f12aeb539e59d454daa830a769a2
|
|
4
|
+
data.tar.gz: ebc6a6ddd76245ad458cce1ecfcbfa1196c57389
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 4c9687e6406aa14c42712546ade68b9ad4083b22b4d64431be2ce97d327abe52a2588cc1f6fcbeae297a3451c8c2b56571e62d85477161f20e6b24f813815514
|
|
7
|
+
data.tar.gz: 2c696448904b2e53f3bf0512415454a83eea30ee8e0c14e1c2d467ecbae6fbe744ff81c6749269b7350f6e6f86e7846bf9905ef969be10d8cf16d8aab202e504
|
data/README.md
CHANGED
|
@@ -8,16 +8,16 @@ A simple database agnostic import/export app to transfer data to/from a remote d
|
|
|
8
8
|
|
|
9
9
|
Renamed gem
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
$ gem install taps2
|
|
12
12
|
|
|
13
|
-
By default, Taps will attempt to create a SQLite3 database for sessions. Unless you specify a different database type, you'll need to install
|
|
13
|
+
By default, Taps will attempt to create a SQLite3 database for sessions. Unless you specify a different database type, you'll need to install SQLite3. (See _Environment Variables_ for alternative session databases.)
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
$ gem install sqlite3
|
|
16
16
|
|
|
17
17
|
Install the gems to support databases you want to work with, such as MySQL or PostgreSQL.
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
|
|
19
|
+
$ gem install mysql2
|
|
20
|
+
$ gem install pg
|
|
21
21
|
|
|
22
22
|
## Configuration: Environment Variables
|
|
23
23
|
|
data/README.md.orig
ADDED
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# Taps (2) -- simple database import/export app
|
|
2
|
+
|
|
3
|
+
A simple database agnostic import/export app to transfer data to/from a remote database.
|
|
4
|
+
|
|
5
|
+
<<<<<<< HEAD:README.rdoc
|
|
6
|
+
*Forked and updated* with fixes and improvements. Integrates fixes and updates from {taps-taps}[https://github.com/wijet/taps] and {tapsicle}[https://github.com/jiffyondemand/tapsicle] forks.
|
|
7
|
+
=======
|
|
8
|
+
*Forked and updated* with fixes and improvements. Integrates fixes and updates from [taps-taps](https://github.com/wijet/taps) and [tapsicle](https://github.com/jiffyondemand/tapsicle) forks.
|
|
9
|
+
>>>>>>> Rename executable to `taps2`:README.md
|
|
10
|
+
|
|
11
|
+
## Installation
|
|
12
|
+
|
|
13
|
+
Renamed gem
|
|
14
|
+
|
|
15
|
+
$ gem install taps2
|
|
16
|
+
|
|
17
|
+
By default, Taps will attempt to create a SQLite3 database for sessions. Unless you specify a different database type, you'll need to install SQLite3. (See _Environment Variables_ for alternative session databases.)
|
|
18
|
+
|
|
19
|
+
$ gem install sqlite3
|
|
20
|
+
|
|
21
|
+
Install the gems to support databases you want to work with, such as MySQL or PostgreSQL.
|
|
22
|
+
|
|
23
|
+
$ gem install mysql2
|
|
24
|
+
$ gem install pg
|
|
25
|
+
|
|
26
|
+
## Configuration: Environment Variables
|
|
27
|
+
|
|
28
|
+
_All environment variables are optional._
|
|
29
|
+
|
|
30
|
+
The `TAPS_DATABASE_URL` variable specifies the database URI where session data is stored on CLI or Server.
|
|
31
|
+
The `DATABASE_URL` variable is a fallback (and compatible with Heroku) if `TAPS_DATABASE_URL` is not specified.
|
|
32
|
+
By default, Taps will create a SQLite3 database.
|
|
33
|
+
|
|
34
|
+
The `TAPS_LOGIN` and `TAPS_PASSWORD` variables are used for default Basic Authentication.
|
|
35
|
+
|
|
36
|
+
The `TAPS_YAML_ENGINE` variable lets you specify a YAML engine such as "psych".
|
|
37
|
+
|
|
38
|
+
The `NO_DEFAULT_DATABASE_URL` variable allows you to require a database URI be sent in the `body` of the request that initiates a Taps session. (Default behavior will use the database URI specified when starting the server.)
|
|
39
|
+
|
|
40
|
+
The `NO_DUMP_MARSHAL_ERRORS` variable allows you to disable dumping of marshalled data that caused an error.
|
|
41
|
+
|
|
42
|
+
The `NO_DEFLATE` variable allows you to disable gzip compression (`Rack::Deflater`) on the server.
|
|
43
|
+
|
|
44
|
+
## Usage: Server
|
|
45
|
+
|
|
46
|
+
Here's how you start a taps server
|
|
47
|
+
|
|
48
|
+
$ taps2 server postgres://localdbuser:localdbpass@localhost/dbname httpuser httppassword
|
|
49
|
+
|
|
50
|
+
You can also specify an encoding in the database url
|
|
51
|
+
|
|
52
|
+
$ taps2 server mysql://localdbuser:localdbpass@localhost/dbname?encoding=latin1 httpuser httppassword
|
|
53
|
+
|
|
54
|
+
## Usage: Client
|
|
55
|
+
|
|
56
|
+
When you want to pull down a database from a taps server
|
|
57
|
+
|
|
58
|
+
$ taps2 pull postgres://dbuser:dbpassword@localhost/dbname http://httpuser:httppassword@example.com:5000
|
|
59
|
+
|
|
60
|
+
or when you want to push a local database to a taps server
|
|
61
|
+
|
|
62
|
+
$ taps2 push postgres://dbuser:dbpassword@localhost/dbname http://httpuser:httppassword@example.com:5000
|
|
63
|
+
|
|
64
|
+
or when you want to transfer a list of tables
|
|
65
|
+
|
|
66
|
+
$ taps2 push postgres://dbuser:dbpassword@localhost/dbname http://httpuser:httppassword@example.com:5000 --tables logs,tags
|
|
67
|
+
|
|
68
|
+
or when you want to transfer tables that start with a word
|
|
69
|
+
|
|
70
|
+
$ taps2 push postgres://dbuser:dbpassword@localhost/dbname http://httpuser:httppassword@example.com:5000 --filter '^log_'
|
|
71
|
+
|
|
72
|
+
## Troubleshooting
|
|
73
|
+
|
|
74
|
+
* "Error: invalid byte sequence for encoding" can be resolved by adding `encoding` to database URI (https://github.com/ricardochimal/taps/issues/110)
|
|
75
|
+
* *Example:* `taps2 server mysql://root@localhost/example_database?encoding=UTF8 httpuser httppassword`
|
|
76
|
+
* SQLite3 database URI may require three slashes (e.g. `sqlite3:///path/to/file.db`)
|
|
77
|
+
* Make sure to use an absolute/full path to the file on the server
|
|
78
|
+
|
|
79
|
+
## Known Issues
|
|
80
|
+
|
|
81
|
+
* Foreign key constraints get lost in the schema transfer
|
|
82
|
+
* Indexes may drop the "order" (https://github.com/ricardochimal/taps/issues/111)
|
|
83
|
+
* String fields with only numbers may get parsed as a number and lose leading zeros or add decimals (https://github.com/ricardochimal/taps/issues/106)
|
|
84
|
+
* Tables without primary keys will be incredibly slow to transfer. This is due to it being inefficient having large offset values in queries.
|
|
85
|
+
* Multiple schemas are currently not supported (https://github.com/ricardochimal/taps/issues/97)
|
|
86
|
+
* Taps does not drop tables when overwriting database (https://github.com/ricardochimal/taps/issues/94)
|
|
87
|
+
* Oracle database classes not fully supported (https://github.com/ricardochimal/taps/issues/89)
|
|
88
|
+
* Some blank default values may be converted to NULL in MySQL table schemas (https://github.com/ricardochimal/taps/issues/88)
|
|
89
|
+
* Conversion of column data types can cause side effects when going from one database type to another
|
|
90
|
+
* MySQL `bigint` converts to PostgreSQL `string` (https://github.com/ricardochimal/taps/issues/77)
|
|
91
|
+
* Passwords in database URI can cause issues with special characters (https://github.com/ricardochimal/taps/issues/74)
|
|
92
|
+
|
|
93
|
+
## Feature Requests
|
|
94
|
+
|
|
95
|
+
* Allow a single Taps server to serve data from different databases (https://github.com/ricardochimal/taps/issues/103)
|
|
96
|
+
|
|
97
|
+
## Meta
|
|
98
|
+
|
|
99
|
+
<<<<<<< HEAD:README.rdoc
|
|
100
|
+
Maintained by {Joel Van Horn}[http://github.com/joelvh]
|
|
101
|
+
=======
|
|
102
|
+
Maintained by [Joel Van Horn](http://github.com/joelvh)
|
|
103
|
+
>>>>>>> Rename executable to `taps2`:README.md
|
|
104
|
+
|
|
105
|
+
Written by Ricardo Chimal, Jr. (ricardo at heroku dot com) and Adam Wiggins (adam at heroku dot com)
|
|
106
|
+
|
|
107
|
+
Early research and inspiration by Blake Mizerany
|
|
108
|
+
|
|
109
|
+
Released under the MIT License: http://www.opensource.org/licenses/mit-license.php
|
|
110
|
+
|
|
111
|
+
http://github.com/ricardochimal/taps
|
|
112
|
+
|
|
113
|
+
Special Thanks to Sequel for making this tool possible http://sequel.rubyforge.org/
|
data/lib/taps/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: taps2
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.6.
|
|
4
|
+
version: 0.6.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Ricardo Chimal, Jr.
|
|
@@ -177,6 +177,7 @@ extensions: []
|
|
|
177
177
|
extra_rdoc_files: []
|
|
178
178
|
files:
|
|
179
179
|
- README.md
|
|
180
|
+
- README.md.orig
|
|
180
181
|
- bin/schema2
|
|
181
182
|
- bin/schema2.cmd
|
|
182
183
|
- bin/taps2
|