taps2 0.6.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|