ramsey/uuid-console

A console application for generating UUIDs with ramsey/uuid.

2.0.0 2022-12-21 21:48 UTC

Requires

• php: ^7.4 || ^8.0
• ramsey/uuid: ^3.9.7 || ^4
• symfony/console: ^5.0 || ^6.0

Requires (Dev)

• captainhook/plugin-composer: ^5.3
• ergebnis/composer-normalize: ^2.28.3
• moontoast/math: ^1.2
• php-parallel-lint/php-console-highlighter: ^1.0
• php-parallel-lint/php-parallel-lint: ^1.3
• phpcsstandards/phpcsutils: ^1.0.0-alpha4
• phpstan/extension-installer: ^1.2
• phpstan/phpstan: ^1.9
• phpstan/phpstan-phpunit: ^1.3
• phpunit/phpunit: ^9.5
• psalm/plugin-phpunit: ^0.18.4
• ramsey/coding-standard: ^2.0.3
• ramsey/conventional-commits: ^1.3
• roave/security-advisories: dev-latest
• spatie/phpunit-snapshot-assertions: ^4.2
• vimeo/psalm: ^5.4

MIT

• Ben Ramsey

• cli
• console
• uuid
• identifier
• guid

README

A console application for generating UUIDs with ramsey/uuid

About

ramsey/uuid-console is a console application for generating UUIDs with ramsey/uuid.

This project adheres to a code of conduct. By participating in this project and its community, you are expected to uphold this code.

Installation

Install this package as a dependency using Composer.

composer require ramsey/uuid-console

This will install a reference to the console tool in ./vendor/bin/uuid.

Usage

If installed in your project, you may execute the console application from the command line:

$ ./vendor/bin/uuid

If installed globally using Composer, ensure your global Composer installation is in your PATH (it's usually somewhere like ~/.composer/vendor/bin). Then, you may execute it:

$ uuid

Please be aware that some systems may already have a command line application named uuid installed, so this might create a conflict if anything using your PATH expects the other uuid tool.

You can generate UUIDs:

$ ./vendor/bin/uuid generate
afe1296a-660b-11e5-bd9f-3c15c2caed47

By default, the application generates version 1 (time-based) UUIDs, but you may specify other versions:

$ ./vendor/bin/uuid generate 4
54478f1d-8b9d-4bf9-8767-1a23010d48a7

You may also decode UUIDs to get information about them:

$ ./vendor/bin/uuid decode afe1296a-660b-11e5-bd9f-3c15c2caed47
 ========= ========== =========================================
  encode:   STR:       afe1296a-660b-11e5-bd9f-3c15c2caed47
            INT:       233784006064090443909084029429027106119
  decode:   variant:   RFC 4122
            version:   1 (time and node based)
            content:   time:  2015-09-28T18:06:49+00:00
                       clock: 15775 (usually random)
                       node:  3c:15:c2:ca:ed:47
 ========= ========== =========================================

For help, just type ./vendor/bin/uuid and read the help information.

Contributing

Contributions are welcome! To contribute, please familiarize yourself with CONTRIBUTING.md.

Coordinated Disclosure

Keeping user information safe and secure is a top priority, and we welcome the contribution of external security researchers. If you believe you've found a security issue in software that is maintained in this repository, please read SECURITY.md for instructions on submitting a vulnerability report.

Copyright and License

The ramsey/uuid-console library is copyright © Ben Ramsey and licensed for use under the MIT License (MIT). Please see LICENSE for more information.