{"id":20740796,"url":"https://github.com/mgeisler/lipsum","last_synced_at":"2025-04-12T09:18:09.713Z","repository":{"id":21806091,"uuid":"94088309","full_name":"mgeisler/lipsum","owner":"mgeisler","description":"Lorem ipsum generator for Rust","archived":false,"fork":false,"pushed_at":"2025-02-01T07:49:25.000Z","size":174,"stargazers_count":61,"open_issues_count":9,"forks_count":17,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-12T09:18:00.329Z","etag":null,"topics":["lorem-ipsum","markov-chain","random-text"],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/mgeisler.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-06-12T11:25:18.000Z","updated_at":"2025-03-29T14:26:57.000Z","dependencies_parsed_at":"2024-03-13T21:25:41.814Z","dependency_job_id":"68f2e04b-788e-44d0-88d5-5ccadbc50b87","html_url":"https://github.com/mgeisler/lipsum","commit_stats":{"total_commits":152,"total_committers":5,"mean_commits":30.4,"dds":"0.046052631578947345","last_synced_commit":"e584c541d00a00a9c19725354b0f9f890b1640b2"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgeisler%2Flipsum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgeisler%2Flipsum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgeisler%2Flipsum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgeisler%2Flipsum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mgeisler","download_url":"https://codeload.github.com/mgeisler/lipsum/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248543837,"owners_count":21121838,"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":["lorem-ipsum","markov-chain","random-text"],"created_at":"2024-11-17T06:29:59.556Z","updated_at":"2025-04-12T09:18:09.666Z","avatar_url":"https://github.com/mgeisler.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lorem Ipsum\n\n[![](https://github.com/mgeisler/lipsum/actions/workflows/build.yml/badge.svg)][build-status]\n[![](https://codecov.io/gh/mgeisler/lipsum/branch/master/graph/badge.svg)][codecov]\n[![](https://img.shields.io/crates/v/lipsum.svg)][crates-io]\n[![](https://docs.rs/lipsum/badge.svg)][api-docs]\n\nLipsum is a small Rust library for generating pseudo-Latin [lorem\nipsum filler text][lorem ipsum]. This is a standard placeholder text\nused in publishing. It starts with:\n\n\u003e Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do\n\u003e eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim\n\u003e ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut\n\u003e aliquip ex ea commodo consequat…\n\nThe text is generated using a [Markov chain] that has been trained on\nthe first book in Cicero's work _De finibus bonorum et malorum_ (_On\nthe ends of good and evil_), of which the lorem ipsum text is a\nscrambled subset.\n\n## Usage\n\nAdd this to your `Cargo.toml`:\n\n```toml\n[dependencies]\nlipsum = \"0.9\"\n```\n\n## Documentation\n\nPlease see the **[API documentation][api-docs]**.\n\n## Getting Started\n\nUse the `lipsum` function to generate lorem ipsum text:\n\n```rust\nuse lipsum::lipsum;\n\nfn main() {\n    // Print 25 random words of lorem ipsum text.\n    println!(\"{}\", lipsum(25));\n}\n```\n\nThis generates the lorem ipsum text show above:\n\n\u003e Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do\n\u003e eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim\n\u003e ad minim veniam, quis nostrud exercitation ullamco…\n\nThe text becomes random after 18 words, so you might not see exactly\nthe same text.\n\nUse `lipsum_title` instead if you just need a short text suitable for\na document title or a section heading. The text generated by that\nfunction looks like this:\n\n\u003e Refugiendi et Omnino Rerum\n\nSmall words are kept uncapitalized and punctuation is stripped from\nall words.\n\n## Release History\n\nThis is a changelog with the most important changes in each release.\n\n### Version 0.9.1 (2024-03-13)\n\n* [#100](https://github.com/mgeisler/lipsum/pull/100): Add\n  `lipsum_title_with_rng` function.\n* [#102](https://github.com/mgeisler/lipsum/pull/102): Document MSRV in\n  `Cargo.toml`.\n* [#103](https://github.com/mgeisler/lipsum/pull/103): Enable dependabot\n  updates.\n\n### Version 0.9.0 (2023-03-28)\n\n* [#90](https://github.com/mgeisler/lipsum/pull/90): Test minimum\n  supported Rust version (Rust 1.56) in CI\n* [#91](https://github.com/mgeisler/lipsum/pull/91): Remove dependency\n  on system randomness\n\n### Version 0.8.2 (2022-06-06)\n\n* [#84](https://github.com/mgeisler/lipsum/pull/84): Fix build error\n  on Rust 1.56. Thanks @WorldSEnder for the report.\n\n### Version 0.8.1 (2022-04-19)\n\n* [#73](https://github.com/mgeisler/lipsum/pull/73): Add\n  `lipsum_from_seed` and tweak capitalization. Thanks @reknih!\n* [#77](https://github.com/mgeisler/lipsum/pull/77): Update to Rust\n  2021 edition.\n\n### Version 0.8.0 (2021-05-30)\n\nThe random number generator has been separated from the `MarkovChain`\nimplementation to allow using the same trained model to generate\nmultiple outputs with different seeds. Thanks @Diggsey!\n\n### Version 0.7.0 (2020-07-08)\n\n-   The code has been updated to the [Rust 2018 edition][rust-2018].\n\n-   Each new release will only support the latest stable version of\n    Rust. Trying to support older Rust versions has proven to be a\n    fool's errand: our dependencies keep releasing new patch versions\n    that require newer and newer versions of Rust.\n\n-   [#65](https://github.com/mgeisler/lipsum/pull/65): A new\n    `lipsum_words_from_seed` function was added. It generates random but\n    deterministic lorem ipsum text. This is useful in unit tests when\n    you need fixed inputs.\n\n### Version 0.6.0 (2018-12-09)\n\nThe new `lipsum_words` function can be used to generate random lorem\nipsum text that doesn't always start with \"Lorem ipsum\".\n\nDependencies were updated and the oldest supported version of Rust is\nnow 1.22.\n\n### Version 0.5.0 (2018-04-22)\n\nThe new `lipsum_title` function can be used to generate a short string\nsuitable for a document title or a section heading.\n\nDependencies were updated and the oldest supported version of Rust is\nnow 1.17.\n\n### Version 0.4.0 (2017-09-24)\n\nThe `generate` and `generate_from` now always generate proper\nsentences, meaning that they generate sentences that start with a\ncapital letter and end with `.` or some other punctuation character.\nUse `iter` and `iter_from` directly if you need more control.\n\n### Version 0.3.0 (2017-07-28)\n\nPerformance is improved by about 50% when generating text, but\ntraining the Markov chain now takes about twice as long as before.\n\nThe `MarkovChain` struct has many new methods:\n\n-   `new_with_rng` makes it possible to specify the random number\n    generator used by the Markov chain. Use this to get deterministic\n    and thus reproducible output for tests. `MarkovChain` now owns the\n    RNG it uses and as a consequence, it has an extra type parameter.\n    This is a breaking change if you used struct directly in your code.\n\n-   `iter` and `into_from` return iterators over words in the Markov\n    chain. The `generate` and `generate_from` methods are now\n    straight-forward convenience wrappers for the iterators.\n\n-   `len` tells you the number of stats in the Markov chain and\n    `is_empty` tells you if the Markov chain is empty, meaning that it\n    hasn't been trained on anything yet.\n\n### Version 0.2.0 (2017-07-10)\n\nRust version 1.6.0 is now supported. This is checked with TravisCI.\n\n### Version 0.1.0 (2017-07-2)\n\nFirst public release.\n\n## License\n\nLipsum can be distributed according to the [MIT license][mit].\nContributions will be accepted under the same license.\n\n[build-status]: https://github.com/mgeisler/lipsum/actions/workflows/build.yml\n[codecov]: https://codecov.io/gh/mgeisler/lipsum\n[crates-io]: https://crates.io/crates/lipsum\n[api-docs]: https://docs.rs/lipsum/\n[lorem ipsum]: https://en.wikipedia.org/wiki/Lorem_ipsum\n[markov chain]: https://en.wikipedia.org/wiki/Markov_chain\n[rust-2018]: https://doc.rust-lang.org/edition-guide/rust-2018/\n[mit]: LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgeisler%2Flipsum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmgeisler%2Flipsum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgeisler%2Flipsum/lists"}