{"id":13836913,"url":"https://github.com/nilslice/gotv-example","last_synced_at":"2026-03-03T23:02:53.692Z","repository":{"id":82692236,"uuid":"80760908","full_name":"nilslice/gotv-example","owner":"nilslice","description":"example project built for an instructional video feb. 2 2017","archived":false,"fork":false,"pushed_at":"2017-02-02T19:32:05.000Z","size":1728,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-10T12:57:48.649Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nilslice.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-02-02T19:31:35.000Z","updated_at":"2018-08-19T12:32:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"bb05b7e6-3200-46b1-8955-e32d53dde96d","html_url":"https://github.com/nilslice/gotv-example","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nilslice/gotv-example","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilslice%2Fgotv-example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilslice%2Fgotv-example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilslice%2Fgotv-example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilslice%2Fgotv-example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nilslice","download_url":"https://codeload.github.com/nilslice/gotv-example/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilslice%2Fgotv-example/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30064791,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T18:21:05.932Z","status":"ssl_error","status_checked_at":"2026-03-03T18:20:59.341Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T15:00:57.066Z","updated_at":"2026-03-03T23:02:53.671Z","avatar_url":"https://github.com/nilslice.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"![My friend, \"Gotoro\"](ponzu-banner.png)\n\n# Ponzu\nPonzu is a powerful and efficient open-source HTTP server framework and CMS. It \nprovides automatic, free, and secure HTTP/2 over TLS (certificates obtained via \n[Let's Encrypt](https://letsencrypt.org)), a useful CMS and scaffolding to \ngenerate content editors, and a fast HTTP API on which to build modern applications.\n\nPonzu is released under the BSD-3-Clause license (see LICENSE).\n(c) [Boss Sauce Creative, LLC](https://bosssauce.it)\n\n## Why?\nWith the rise in popularity of web/mobile apps connected to JSON HTTP APIs, better \ntools to support the development of content servers and management systems are necessary. \nPonzu fills the void where you want to reach for Wordpress to get a great CMS, or Rails for\nrapid development, but need a fast JSON response in a high-concurrency environment. \n\n**Because you want to turn this:**  \n```bash\n$ ponzu generate content song title:\"string\" artist:\"string\" rating:\"int\" opinion:\"string\" spotify_url:\"string\"\n```\n\n**Into this:** \n\n![song go-rt](https://cloud.githubusercontent.com/assets/7517515/20726600/2ecd96a8-b62b-11e6-8589-c00c630ea6cc.png)\n\n**What's inside**  \n:ballot_box_with_check: Automatic \u0026 Free SSL/TLS*  \n:ballot_box_with_check: HTTP/2 and Server Push  \n:ballot_box_with_check: Rapid development with CLI-controlled code generators  \n:ballot_box_with_check: User-friendly, extensible CMS and administration dashboard  \n:ballot_box_with_check: Simple deployment - single binary + assets, embedded DB ([BoltDB](https://github.com/boltdb/bolt))  \n:ballot_box_with_check: Fast, helpful framework while maintaining control \n\n*TLS:\n - Development: self-signed certificates auto-generated\n - Production: auto-renewing certificates fetched from [Let's Encrypt](https://letsencrypt.org)  \n\n## Wiki\nFor more detailed information, check out the [wiki](https://github.com/ponzu-cms/ponzu/wiki)\n\n## Installation\n\n```\n$ go get github.com/ponzu-cms/ponzu/...\n```\n\n## Requirements\nGo 1.8+\n\nSince HTTP/2 Server Push is used, Go 1.8+ is required. However, it is not \nrequired of clients conntecing to a Ponzu server to make HTTP/2 requests. \n\n## Usage\n\n```bash\n$ ponzu [flags] command \u003cparams\u003e\n```\n\n## Commands\n\n### new\n\nCreates a 'ponzu' directory, or one by the name supplied as a parameter \nimmediately following the 'new' option in the $GOPATH/src directory. Note: \n'new' depends on the program 'git' and possibly a network connection. If \nthere is no local repository to clone from at the local machine's $GOPATH, \n'new' will attempt to clone the 'github.com/ponzu-cms/ponzu' package from \nover the network.\n\nExample:\n```bash\n$ ponzu new myProject\n\u003e New ponzu project created at $GOPATH/src/myProject\n```\n\nErrors will be reported, but successful commands return nothing.\n\n---\n\n### generate, gen, g\n\nGenerate boilerplate code for various Ponzu components, such as `content`.\n\nExample:\n```bash\n            generator      struct fields and built-in types...\n             |              |\n             v              v    \n$ ponzu gen content review title:\"string\" body:\"string\" rating:\"int\" tags:\"[]string\"\n                     ^\n                     |\n                    struct type\n```\n\nThe command above will generate the file `content/review.go` with boilerplate\nmethods, as well as struct definition, and cooresponding field tags like:\n\n```go\ntype Review struct {\n\tTitle  string   `json:\"title\"`\n\tBody   string   `json:\"body\"`\n\tRating int      `json:\"rating\"`\n\tTags   []string `json:\"tags\"`\n}\n```\n\nThe generate command will intelligently parse more sophisticated field names\nsuch as 'field_name' and convert it to 'FieldName' and vice versa, only where \nappropriate as per common Go idioms. Errors will be reported, but successful \ngenerate commands return nothing.\n\n---\n\n### build\n\nFrom within your Ponzu project directory, running build will copy and move \nthe necessary files from your workspace into the vendored directory, and \nwill build/compile the project to then be run. \n\nOptional flags:\n- `-gocmd` sets the binary used when executing `go build` within `ponzu` build step\n\nExample:\n```bash\n$ ponzu build\n(or)\n$ ponzu -gocmd=go1.8rc1 build # useful for testing\n```\n\nErrors will be reported, but successful build commands return nothing.\n\n---\n\n### run\n\nStarts the HTTP server for the JSON API, Admin System, or both.\nThe segments, separated by a comma, describe which services to start, either \n'admin' (Admin System / CMS backend) or 'api' (JSON API), and, optionally, \nif the server should utilize TLS encryption - served over HTTPS, which is\nautomatically managed using Let's Encrypt (https://letsencrypt.org) \n\nOptional flags:\n- `-port` sets the port on which the server listens for HTTP requests [defaults to 8080]\n- `-httpsport` sets the port on which the server listens for HTTPS requests [defaults to 443]\n- `--https` enables auto HTTPS management via Let's Encrypt (port is always 443)\n- `--devhttps` generates self-signed SSL certificates for development-only (port is 10443)\n\nExample: \n```bash\n$ ponzu run\n(or)\n$ ponzu -port=8080 --https run admin,api\n(or) \n$ ponzu run admin\n(or)\n$ ponzu -port=8888 run api\n(or)\n$ ponzu --devhttps run\n```\nDefaults to `$ ponzu -port=8080 run admin,api` (running Admin \u0026 API on port 8080, without TLS)\n\n*Note:* \nAdmin and API cannot run on separate processes unless you use a copy of the\ndatabase, since the first process to open it receives a lock. If you intend\nto run the Admin and API on separate processes, you must call them with the\n'ponzu' command independently.\n\n---\n\n### upgrade\n\nWill backup your own custom project code (like content, addons, uploads, etc) so\nwe can safely re-clone Ponzu from the latest version you have or from the network \nif necessary. Before running `$ ponzu upgrade`, you should update the `ponzu`\npackage by running `$ go get -u github.com/ponzu-cms/ponzu/...` \n\nExample:\n```bash\n$ ponzu upgrade\n```\n\n---\n\n### version, v\n\nPrints the version of Ponzu your project is using. Must be called from within a \nPonzu project directory. By passing the `--cli` flag, the `version` command will \nprint the version of the Ponzu CLI you have installed.\n\nExample:\n```bash\n$ ponzu version\n\u003e Ponzu v0.7.1\n(or)\n$ ponzu --cli version\n\u003e Ponzu v0.7.2\n```\n\n---\n\n## Contributing\n\n1. Checkout branch ponzu-dev\n2. Make code changes\n3. Test changes to ponzu-dev branch\n    - make a commit to ponzu-dev\n    - to manually test, you will need to use a new copy (ponzu new path/to/code), but pass the --dev flag so that ponzu generates a new copy from the ponzu-dev branch, not master by default (i.e. `$ponzu --dev new /path/to/code`)\n    - build and run with $ ponzu build and $ ponzu run\n4. To add back to master: \n    - first push to origin ponzu-dev\n    - create a pull request \n    - will then be merged into master\n\n_A typical contribution workflow might look like:_\n```bash\n# clone the repository and checkout ponzu-dev\n$ git clone https://github.com/ponzu-cms/ponzu path/to/local/ponzu # (or your fork)\n$ git checkout ponzu-dev\n\n# install ponzu with go get or from your own local path\n$ go get github.com/ponzu-cms/ponzu/...\n# or\n$ cd /path/to/local/ponzu \n$ go install ./...\n\n# edit files, add features, etc\n$ git add -A\n$ git commit -m 'edited files, added features, etc'\n\n# now you need to test the feature.. make a new ponzu project, but pass --dev flag\n$ ponzu --dev new /path/to/new/project # will create $GOPATH/src/path/to/new/project\n\n# build \u0026 run ponzu from the new project directory\n$ cd /path/to/new/project\n$ ponzu build \u0026\u0026 ponzu run\n\n# push to your origin:ponzu-dev branch and create a PR at ponzu-cms/ponzu\n$ git push origin ponzu-dev\n# ... go to https://github.com/ponzu-cms/ponzu and create a PR\n```\n\n**Note:** if you intend to work on your own fork and contribute from it, you will\nneed to also pass `-fork=path/to/your/fork` (using OS-standard filepath structure),\nwhere `path/to/your/fork` _must_ be within `$GOPATH/src`, and you are working from a branch\ncalled `ponzu-dev`. \n\nFor example: \n```bash\n# ($GOPATH/src is implied in the fork path, do not add it yourself)\n$ ponzu --dev -fork=github.com/nilslice/ponzu new /path/to/new/project\n```\n\n\n## Credits\n- [golang.org/x/text/unicode/norm](https://golang.org/x/text/unicode/norm)\n- [golang.org/x/text/transform](https://golang.org/x/text/transform)\n- [golang.org/x/crypto/bcrypt](https://golang.org/x/crypto/bcrypt)\n- [github.com/nilslice/jwt](https://github.com/nilslice/jwt)\n- [github.com/nilslice/email](https://github.com/nilslice/email)\n- [github.com/gorilla/schema](https://github.com/gorilla/schema)\n- [github.com/satori/go.uuid](https://github.com/satori/go.uuid)\n- [github.com/tidwall/gjson](https://github.com/tidwall/gjson)\n- [github.com/tidwall/sjson](https://github.com/tidwall/sjson)\n- [github.com/boltdb/bolt](https://github.com/boltdb/bolt)\n- [Materialnote Editor](https://github.com/Cerealkillerway/materialNote)\n- [Materialize.css](https://github.com/Dogfalo/materialize)\n- [jQuery](https://github.com/jquery/jquery)\n- [Chart.js](https://github.com/chartjs/Chart.js)\n\n\n### Logo\nThe Go gopher was designed by Renee French. (http://reneefrench.blogspot.com)\nThe design is licensed under the Creative Commons 3.0 Attributions license.\nRead this article for more details: http://blog.golang.org/gopher\n\nThe Go gopher vector illustraition by Hugo Arganda [@argandas](https://twitter.com/argandas) (http://about.me/argandas)\n\n\"Gotoro\", the sushi chef, is a modification of Hugo Arganda's illustration by Steve Manuel (https://github.com/nilslice).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnilslice%2Fgotv-example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnilslice%2Fgotv-example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnilslice%2Fgotv-example/lists"}