{"id":17305457,"url":"https://github.com/kovah/devlorem","last_synced_at":"2025-02-25T06:14:46.658Z","repository":{"id":2382000,"uuid":"46404416","full_name":"Kovah/DevLorem","owner":"Kovah","description":"No more 'Lorem ipsum', get some real quotes or speeches for your free text with this generator!","archived":false,"fork":false,"pushed_at":"2025-02-11T07:50:40.000Z","size":1431,"stargazers_count":67,"open_issues_count":0,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-02-11T08:43:30.723Z","etag":null,"topics":["development","generator","golang","lorem-ipsum","lorem-ipsum-generator","placeholder","quotes"],"latest_commit_sha":null,"homepage":"https://devlorem.kovah.de","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kovah.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"kovah","patreon":"kovah","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"kovah","issuehunt":null,"otechie":null,"custom":null}},"created_at":"2015-11-18T08:08:13.000Z","updated_at":"2025-02-11T07:50:37.000Z","dependencies_parsed_at":"2024-02-05T19:29:50.086Z","dependency_job_id":"ebe948a1-d6a5-42b6-a8d1-d47dab0a52ec","html_url":"https://github.com/Kovah/DevLorem","commit_stats":{"total_commits":107,"total_committers":4,"mean_commits":26.75,"dds":0.08411214953271029,"last_synced_commit":"a8a4599c602c975db2dd6d178b33f9a35efef798"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kovah%2FDevLorem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kovah%2FDevLorem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kovah%2FDevLorem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kovah%2FDevLorem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kovah","download_url":"https://codeload.github.com/Kovah/DevLorem/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240612553,"owners_count":19829027,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["development","generator","golang","lorem-ipsum","lorem-ipsum-generator","placeholder","quotes"],"created_at":"2024-10-15T11:55:48.794Z","updated_at":"2025-02-25T06:14:46.622Z","avatar_url":"https://github.com/Kovah.png","language":"Go","funding_links":["https://github.com/sponsors/kovah","https://patreon.com/kovah","https://liberapay.com/kovah"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eDevLorem\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\u003cb\u003eReal quotes ready to copy and paste. No more \"Lorem ipsum dolor\".\u003c/b\u003e\u003cbr\u003eGet some quotes from President Obama, \nSamuel L Jackson, Daisy Ridley or Morgan Freeman!\u003c/p\u003e\n\n\u003cp\u003e\u0026nbsp;\u003c/p\u003e\n\n\u003cimg src=\"/preview.png\" alt=\"DevLorem Preview\"\u003e\n\n\u003cp\u003e\u0026nbsp;\u003c/p\u003e\n\n\u003e [!NOTE]\n\u003e DevLorem is no longer actively maintained, but continues to work and can be used. The app may be upgraded later if needed in the future.\n\n\n## About DevLorem\n\nDevLorem is a small tool that generates Lorem Ipsum paragraphs from movie quotes, based on the different actors.  \nIt can be used as a command line tool, or can be run as a website that offers both a user interface to generate the\nparagraphs and an API.\n\n\n---\n\n\n## Download DevLorem\n\nThe latest version of the tool can be found on the [releases page](https://github.com/Kovah/DevLorem/releases).\nPlease download the archive file of the latest release suitable for your operating system. Unpack the zip and make the\nbinary executable.  \nAlternatively, you can use the Docker image. Details about the usage can be found further down.\n\n\n## The command line tool\n\nThe command line tool can be used to quickly generate paragraphs within your terminal or in scripts. It is available\nas the `generate` command and has some optional parameters.\n\n```\ndevlorem generate\n```\n\nUsage:  \n  devlorem generate [flags]\n\nFlags:  \n  -f, --format string        Format of the returned paragraphs, either json or text (default json)  \n  -h, --help                 help for generate  \n  -n, --number int           Number of paragraphs returned (default 5)  \n  -p, --paragraphs           Show paragraph tags (\u003cp\u003e and \u003c/p\u003e) in the generated paragraphs\n\n\n#### Examples\n\n* `devlorem generate` would get you 5 quotes in JSON without `\u003cp\u003e` tags\n* `devlorem generate -n 15 -p` would get you 15 quotes in JSON including the `\u003cp\u003e` tags\n* `devlorem generate -n 30 -p -f text` would get you 30 quotes as plain text including the `\u003cp\u003e` tags\n* `devlorem generate -n 60 -f text` would get you 60 quotes as plain text without `\u003cp\u003e` tags\n\n\n---\n\n\n## The website (user interface + API)\n\nThe DevLorem executable ships with a built-in web server including all static assets. You can start the web server by\nusing the `serve` command. By default, the started web server listens to port 80 on your host.\n\n```\n$ devlorem serve\nStarting HTTP server for DevLorem...\n```\n\nYou can now open DevLorem in your browser under `http://localhost`.\n\nIf you want to use another port, you can use the optional bind flag. To change the port, specify the port including\npreceding colon. In the following example we tell DevLorem to use the port 8090:\n\n```\ndevlorem serve -b :8090\n```\n\n\n### Usage of the website API\n\nOnce the web server is started, the DevLorem API is available too. In the following examples I assume that you have set\nup DevLorem behind a proxy with the domain `your-domain.com` and HTTPS configured.\n\nRequired URL structure:\n`https://your-domain.com/api/[int]`\n\n* The results will be returns as Json by default.\n* The maximum allowed amount of quotes is `99`.\n* Append `paragraphs=true` as a query parameter to show paragraph tags in the output.\n* Append `format=text` as a query parameter to get plain text output.\n\n\n#### Examples\n\n* `https://your-domain.com/api/5` would get you 5 quotes in JSON without `\u003cp\u003e` tags\n* `https://your-domain.com/api/15?paragraphs=true` would get you 15 quotes in JSON including the `\u003cp\u003e` tags\n* `https://your-domain.com/api/30?paragraphs=true\u0026format=text` would get you 30 quotes as plain text including the `\u003cp\u003e` tags\n* `https://your-domain.com/api/60?format=text` would get you 60 quotes as plain text without `\u003cp\u003e` tags\n\n\n---\n\n\n## The DevLorem Docker image\n\nDevLorem is also available as a [Docker image](https://hub.docker.com/r/kovah/devlorem). It is built using Alpine\nLinux and is less than 10 MB large.\n\nTo use the command line tool, run the Docker image with the `generate` command. More details about the tool can be\nfound in the command line documentation above.\n\n```\ndocker run --rm kovah/devlorem generate\n```\n\nTo use the website, you have to additionally forward a port. Please notice that DevLorem does not support HTTPS\nconnections, so you probably need a proxy in front of it.  \nYou can start the web server by using the `serve` command. More details about the command can be found in the website \ndocumentation above.\n\n```\ndocker run --rm -p 80:80 kovah/devlorem serve\n```\n\n\n---\n\n\n## Contribution\n\nWant to contribute more source texts? Please create a pull request for the new file that should follow the exact same \nstyling like the ones that are already available:\n\n* Filename must contain the name (lowercase, spaces replaced with dashes).\n* The JSON structure must match the existing files.\n* Do not use any \u003cp\u003e tags in the quotes.\n\n\n---\n\n\n## Development and Compilation\n\n### Development\n\nYou need the following packages on your machine to be able to work on DevLorem and compile the binary:\n\n* github.com/spf13/cobra\n* github.com/gorilla/mux\n* github.com/GeertJohan/go.rice\n* github.com/GeertJohan/go.rice/rice\n\nThis can be done by running `go mod download` in the current project directory.\n\nTo test the package, compile it and then run the resulting executable. I recommend using Goland\nfor local development. \n\n\n### Compilation\n\nTo compile the binary and run it locally in the same folder, run the following command:\n\n```\nnpm run build-prod\ngo build\n```\n\nTo generate a single binary without any dependencies, you have to generate the needed content file for that:\n```\nrice embed-go\n# then run the build command\ngo build\n```\n\nTo test the current source code, run the following command:\n```\ngo test -run ''\n```\n\n\n---\n\n\nDevLorem is a project by [Kovah](https://kovah.de) | [Contributors](https://github.com/Kovah/DevLorem/graphs/contributors)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkovah%2Fdevlorem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkovah%2Fdevlorem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkovah%2Fdevlorem/lists"}