284 lines
7.5 KiB
Markdown
284 lines
7.5 KiB
Markdown
GIST
|
|
====
|
|
|
|
GIST is an open-source application to share code.
|
|
https://www.deblan.io/post/517/gist-est-dans-la-place
|
|
|
|
![Gist](https://upload.deblan.org/u/2015-05/554e2c12.png "Gist")
|
|
|
|
Requirements
|
|
------------
|
|
|
|
* PHP >= 5.4
|
|
* GIT
|
|
* MySQL, PostgreSQL or SQLite
|
|
* Composer (php)
|
|
* Bower (node)
|
|
|
|
Installation
|
|
------------
|
|
|
|
$ git clone https://gitlab.deblan.org/deblan/gist
|
|
$ cd gist
|
|
$ make
|
|
$ mv propel-dist.yaml propel.yaml
|
|
$ # EDIT propel.yaml (dsn)
|
|
$ make propel
|
|
|
|
Screencast: https://asciinema.org/a/19814
|
|
|
|
### Git
|
|
|
|
Git can maybe be downloaded from your system's repositories.
|
|
|
|
$ git config --global user.email "you@example.com"
|
|
$ git config --global user.name "Your Name"
|
|
|
|
### Composer
|
|
|
|
Composer can maybe be downloaded from your system's repositories.
|
|
Else, follow the next instructions:
|
|
|
|
#### Download
|
|
|
|
# With cURL
|
|
curl -sS https://getcomposer.org/installer | php
|
|
|
|
# With Wget
|
|
wget -O - -q https://getcomposer.org/installer | php
|
|
|
|
You can now use it with `php composer.phar [arguments]`.
|
|
|
|
#### Executable
|
|
|
|
mv composer.phar composer
|
|
chmod +x composer
|
|
|
|
Use it with `./composer [arguments]`.
|
|
|
|
#### Install
|
|
|
|
Assuming `~/bin` exists ans is in `$PATH`.
|
|
|
|
mv composer ~/bin
|
|
|
|
#### Dependencies Installation (from `composer.lock`)
|
|
|
|
composer install
|
|
|
|
#### Dependencies Update (will change `composer.lock`)
|
|
|
|
composer update
|
|
|
|
### Bower
|
|
|
|
|
|
#### Install
|
|
|
|
npm install -g bower
|
|
|
|
#### Dependencies Installation (from `bower.json`)
|
|
|
|
bower install
|
|
|
|
#### Dependencies Update
|
|
|
|
bower install
|
|
|
|
Makefile
|
|
--------
|
|
|
|
A Makefile is provided to automate some tasks.
|
|
|
|
* `make` will install application's dependencies via Composer and Bower,
|
|
* `make optimize` will run Composer's autoloader dump script with classmap
|
|
* `make update` will update the application
|
|
* `make propel` will generate propel's files
|
|
* `make run` will run development server on http://127.0.0.1:8080/
|
|
|
|
API
|
|
---
|
|
|
|
### Create a new gist
|
|
|
|
**POST** /{locale}/api/create
|
|
Params:
|
|
|
|
* ```form[title]```: String (required, can be empty)
|
|
* ```form[type]```: String (required)
|
|
Values: html, css, javascript, php, sql, xml, yaml, perl, c, asp, python, bash, actionscript3, text
|
|
* ```form[content]```: String (required)
|
|
|
|
#### Responses:
|
|
|
|
* Code ```200```: A json which contains gist's information. Example:
|
|
```javascript
|
|
{
|
|
"url": "https:\/\/gist.deblan.org\/en\/view\/55abcfa7771e0\/f4afbf72967dd95e3461490dcaa310d728d6a97d",
|
|
"gist": {
|
|
"Id": 66,
|
|
"Title": "test prod",
|
|
"Cipher": false,
|
|
"Type": "javascript",
|
|
"File": "55abcfa7771e0",
|
|
"CreatedAt": "2015-07-19T16:26:15Z",
|
|
"UpdatedAt": "2015-07-19T16:26:15Z"
|
|
}
|
|
}
|
|
```
|
|
* Code ```405```: Method Not Allowed
|
|
* Code ```400```: Bad Request
|
|
|
|
### Update an existing Gist
|
|
|
|
**POST** /{locale}/api/update/{id}
|
|
Params:
|
|
|
|
* ```{id}```: Gist Id (required)
|
|
* ```form[content]```: String (required)
|
|
|
|
#### Responses:
|
|
|
|
* Code ```200```: A json which contains gist's information. Example:
|
|
```javascript
|
|
{
|
|
"url": "https:\/\/gist.deblan.org\/en\/view\/55abcfa7771e0\/abcgi72967dd95e3461490dcaa310d728d6adef",
|
|
"gist": {
|
|
"Id": 66,
|
|
"Title": "test prod",
|
|
"Cipher": false,
|
|
"Type": "javascript",
|
|
"File": "55abcfa7771e0",
|
|
"CreatedAt": "2015-07-19T16:26:15Z",
|
|
"UpdatedAt": "2015-07-19T16:30:15Z"
|
|
}
|
|
}
|
|
```
|
|
* Code ```405```: Method Not Allowed
|
|
* Code ```400```: Bad Request
|
|
|
|
Console
|
|
-------
|
|
|
|
### Create and update gists:
|
|
|
|
```
|
|
$ ./app/console --help create
|
|
Usage:
|
|
create [options] [--] <input> [<type>]
|
|
|
|
Arguments:
|
|
input Input
|
|
type Type [default: "text"]
|
|
|
|
Options:
|
|
-t, --title=TITLE Title of the gist
|
|
-u, --show-url Display only the gist url
|
|
-i, --show-id Display only the gist Id
|
|
-h, --help Display this help message
|
|
-q, --quiet Do not output any message
|
|
-V, --version Display this application version
|
|
--ansi Force ANSI output
|
|
--no-ansi Disable ANSI output
|
|
-n, --no-interaction Do not ask any interactive question
|
|
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
|
|
|
|
Help:
|
|
Provides a client to create a gist using the API.
|
|
|
|
Arguments:
|
|
input
|
|
Identify the source of the content: path of the file (eg: /path/to/file) or standard input (-)
|
|
|
|
type
|
|
Defines the type of code: html, css, javascript, php, sql, xml, yaml, perl, c, asp, python, bash, actionscript3, text
|
|
Default value: text
|
|
|
|
Options:
|
|
--title, -t
|
|
Defines a title
|
|
|
|
--show-id, -i
|
|
Display only the Id of the gist
|
|
|
|
--show-url, -u
|
|
Display only the url of the gist
|
|
|
|
$ ./app/console --help update
|
|
Usage:
|
|
update [options] [--] <input>
|
|
|
|
Arguments:
|
|
input Input
|
|
|
|
Options:
|
|
--gist=GIST Id or File of the gist
|
|
-u, --show-url Display only the gist url
|
|
-i, --show-id Display only the gist Id
|
|
-h, --help Display this help message
|
|
-q, --quiet Do not output any message
|
|
-V, --version Display this application version
|
|
--ansi Force ANSI output
|
|
--no-ansi Disable ANSI output
|
|
-n, --no-interaction Do not ask any interactive question
|
|
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
|
|
|
|
Help:
|
|
Provides a client to create a gist using the API.
|
|
|
|
Arguments:
|
|
input
|
|
Identify the source of the content: path of the file (eg: /path/to/file) or standard input (-)
|
|
|
|
type
|
|
Defines the type of code: html, css, javascript, php, sql, xml, yaml, perl, c, asp, python, bash, actionscript3, text
|
|
Default value: text
|
|
|
|
Options:
|
|
--gist
|
|
Defines the Gist to update by using its Id or its File
|
|
|
|
--show-id, -i
|
|
Display only the Id of the gist
|
|
|
|
--show-url, -u
|
|
Display only the url of the gist
|
|
```
|
|
|
|
### Show stats
|
|
|
|
```
|
|
$ app/console stats
|
|
Gists statistics
|
|
|
|
+--------------------+-----------------+---------+-------+
|
|
| Without encryption | With encryption | Commits | Total |
|
|
+--------------------+-----------------+---------+-------+
|
|
| 132 | 19 | 178 | 151 |
|
|
+--------------------+-----------------+---------+-------+
|
|
|
|
Details by type
|
|
|
|
+------------+--------------------+-----------------+---------+-------+
|
|
| Type | Without encryption | With encryption | Commits | Total |
|
|
+------------+--------------------+-----------------+---------+-------+
|
|
| bash | 20 | 3 | 28 | 23 |
|
|
| c | 0 | 1 | 1 | 1 |
|
|
| css | 3 | 0 | 4 | 3 |
|
|
| html | 31 | 3 | 44 | 34 |
|
|
| javascript | 11 | 0 | 12 | 11 |
|
|
| php | 22 | 2 | 27 | 24 |
|
|
| python | 2 | 1 | 3 | 3 |
|
|
| sql | 2 | 0 | 3 | 2 |
|
|
| text | 31 | 6 | 43 | 37 |
|
|
| xml | 7 | 2 | 9 | 9 |
|
|
| yaml | 3 | 1 | 4 | 4 |
|
|
+------------+--------------------+-----------------+---------+-------+
|
|
|
|
```
|
|
|
|
### Personal instance
|
|
|
|
If you install Gist on your server, you have to modify the ```base_uri``` of the API.
|
|
Edit ```app/bootstrap.php.d/60-api.php``` and replace ```https://gist.deblan.org/```.
|