PHP 7.3 and more
* Added CI for PHP 7.3 * Dropped CI for HHVM (was running into too many issues out of no where) * Reworked CI distros where I could * Bumped copyright year * Cleaned up the README, fixed spacing, dumped some of the wordiness
This commit is contained in:
GitHub
parent
24b768a630
commit
e41f4f7630
5 changed files with 45 additions and 51 deletions
21
.travis.yml
21
.travis.yml
|
|
@ -1,5 +1,5 @@
|
|||
language: php
|
||||
dist: trusty
|
||||
dist: bionic
|
||||
sudo: required
|
||||
|
||||
matrix:
|
||||
|
|
@ -7,26 +7,33 @@ matrix:
|
|||
- php: 5.3
|
||||
dist: precise
|
||||
- php: 5.4
|
||||
dist: trusty
|
||||
- php: 5.5
|
||||
dist: trusty
|
||||
- php: 5.6
|
||||
dist: trusty
|
||||
- php: 7.0
|
||||
dist: xenial
|
||||
env: PHPUNIT=5.7
|
||||
- php: 7.1
|
||||
- php: 7.2
|
||||
- php: hhvm
|
||||
env: HHVM=true
|
||||
- php: 7.3
|
||||
|
||||
install:
|
||||
- composer install
|
||||
- if [[ $HHVM == true ]]; then composer require "phpunit/phpunit:5.7"; fi
|
||||
- if [[ $PHPUNIT == 5.7 ]]; then composer require "phpunit/phpunit:5.7"; fi
|
||||
|
||||
before_script:
|
||||
- mkdir -p build/logs
|
||||
- cd tests
|
||||
|
||||
script:
|
||||
- if [[ $HHVM == true ]]; then ../vendor/bin/phpunit --colors --coverage-clover ../build/logs/clover.xml .; fi
|
||||
- if [[ $HHVM != true ]]; then phpunit --colors --coverage-clover ../build/logs/clover.xml .; fi
|
||||
|
||||
- |
|
||||
if [[ $PHPUNIT == 5.7 ]]; then
|
||||
../vendor/bin/phpunit --colors --coverage-clover ../build/logs/clover.xml .
|
||||
else
|
||||
phpunit --colors --coverage-clover ../build/logs/clover.xml .
|
||||
fi
|
||||
|
||||
after_success:
|
||||
- cd ..
|
||||
|
|
|
|||
2
LICENSE
2
LICENSE
|
|
@ -1,6 +1,6 @@
|
|||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2014, 2015, 2016, 2017, 2018 Josh Sherman
|
||||
Copyright (c) 2014, 2015, 2016, 2017, 2018, 2019 Josh Sherman
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
|
|
|
|||
65
README.md
65
README.md
|
|
@ -4,36 +4,14 @@
|
|||
[](https://coveralls.io/github/joshtronic/php-loremipsum?branch=master)
|
||||
[](https://packagist.org/packages/joshtronic/php-loremipsum)
|
||||
|
||||
Lorem ipsum generator in PHP without dependencies. Compatible with PHP 5.3+ as
|
||||
well as HHVM.
|
||||
Lorem ipsum generator in PHP without dependencies. Compatible with PHP 5.3+.
|
||||
|
||||
## Origins
|
||||
|
||||
Once upon a time, I was attempting to find a lorem ipsum generator over on
|
||||
[Packagist](https://packagist.org/search/?q=lorem%20ipsum). I was presented
|
||||
with many options, and some of those options were good. Unfortunately, the
|
||||
bulk of those options depended on Symphony or the Zend Framework. This
|
||||
wouldn’t have been a big deal but under the circumstances, I wanted something
|
||||
that was not tightly coupled to these frameworks because I wanted to use the
|
||||
generator in my _own_ framework.
|
||||
|
||||
I had decided to use
|
||||
[badcow/lorem-ipsum](https://packagist.org/packages/badcow/lorem-ipsum)
|
||||
because it did not have any dependencies nor did it rely on any external APIs.
|
||||
As I started to use the library, I found that I was going to have to fight
|
||||
with it to get it to do what I wanted. After digging through the code, I
|
||||
realized that I was going to end up gutting most of it to bend it to my will.
|
||||
I know when you overhaul someone’s code the liklihood of them accepting a pull
|
||||
request goes down dramatically, hence building this library while taking cues
|
||||
from it’s predecessor.
|
||||
|
||||
Also, the aforementioned package had a bunch of “setter” and “getter” methods
|
||||
that were grossing me out :scream:
|
||||
[](https://www.patreon.com/joshtronic)
|
||||
|
||||
## Installation
|
||||
|
||||
The preferred installation method is via `composer`. First add the following
|
||||
to your `composer.json`
|
||||
The preferred installation method is via `composer`. First add the following to
|
||||
your `composer.json`:
|
||||
|
||||
```json
|
||||
"require": {
|
||||
|
|
@ -41,7 +19,7 @@ to your `composer.json`
|
|||
}
|
||||
```
|
||||
|
||||
Then run `composer update`
|
||||
Then run `composer update`.
|
||||
|
||||
## Usage
|
||||
|
||||
|
|
@ -58,21 +36,21 @@ echo '1 word: ' . $lipsum->word();
|
|||
echo '5 words: ' . $lipsum->words(5);
|
||||
```
|
||||
|
||||
### Generating sentences
|
||||
### Generating Sentences
|
||||
|
||||
```php
|
||||
echo '1 sentence: ' . $lipsum->sentence();
|
||||
echo '5 sentences: ' . $lipsum->sentences(5);
|
||||
```
|
||||
|
||||
### Generating paragraphs
|
||||
### Generating Paragraphs
|
||||
|
||||
```php
|
||||
echo '1 paragraph: ' . $lipsum->paragraph();
|
||||
echo '5 paragraphs: ' . $lipsum->paragraphs(5);
|
||||
```
|
||||
|
||||
### Wrapping text with HTML tags
|
||||
### Wrapping Text with HTML Tags
|
||||
|
||||
If you would like to wrap the generated text with a tag, pass it as the second
|
||||
parameter:
|
||||
|
|
@ -99,7 +77,7 @@ echo $lipsum->words(3, '<li><a href="$1">$1</a></li>');
|
|||
// Generates: <li><a href="...">...</a></li><li><a href="...">...</a></li><li><a href="...">...</a></li>
|
||||
```
|
||||
|
||||
### Return as an array
|
||||
### Return as an Array
|
||||
|
||||
Perhaps you want an array instead of a string:
|
||||
|
||||
|
|
@ -117,16 +95,25 @@ print_r($lipsum->wordsArray(5, 'li'));
|
|||
|
||||
## Assumptions
|
||||
|
||||
Instead of having an option as to whether or not a string should start the
|
||||
generated output with “Lorem ipsum dolor sit amet, consectetur adipiscing
|
||||
elit.” a few assumptions are baked in. The first string generated will always
|
||||
start with the traditional “Lorem ipsum…”. Subsequent strings may contain
|
||||
The first string generated will always start with the traditional "Lorem ipsum
|
||||
dolor sit amet, consectetur adipiscing elit". Subsequent strings may contain
|
||||
those words but will not explicitly start with them.
|
||||
|
||||
## Contributing
|
||||
|
||||
Suggestions and bug reports are always welcome, but karma points are earned
|
||||
for pull requests.
|
||||
Suggestions and bug reports are always welcome, but karma points are earned for
|
||||
pull requests.
|
||||
|
||||
Unit tests are required for all contributions. You can run the test suite
|
||||
from the `tests` directory simply by running `phpunit .`
|
||||
Unit tests are required for all contributions. You can run the test suite from
|
||||
the `tests` directory simply by running `phpunit .`
|
||||
|
||||
## Credits
|
||||
|
||||
`php-loremipsum` was originally inspired by
|
||||
[badcow/lorem-ipsum](https://packagist.org/packages/badcow/lorem-ipsum) with a
|
||||
goal of being a dependency free lorem ipsum generator with flexible generation
|
||||
options.
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
{
|
||||
"name": "joshtronic/php-loremipsum",
|
||||
"description": "Lorem ipsum generator in PHP without dependencies",
|
||||
"version": "1.0.3",
|
||||
"version": "1.0.4",
|
||||
"type": "library",
|
||||
"keywords": [
|
||||
"lorem",
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@
|
|||
* Redistribution of these files must retain the above copyright notice.
|
||||
*
|
||||
* @author Josh Sherman <hello@joshtronic.com>
|
||||
* @copyright Copyright 2014, 2015, 2016, 2017, 2018 Josh Sherman
|
||||
* @copyright Copyright 2014, 2015, 2016, 2017, 2018, 2019 Josh Sherman
|
||||
* @license http://www.opensource.org/licenses/mit-license.html
|
||||
* @link https://github.com/joshtronic/php-loremipsum
|
||||
*/
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue