| # the whole enchilada... | |
| / | |
| ^ | |
| ( | |
| rate\( | |
| ( | |
| ( | |
| 1[ ]+(hour|minute|day)) | |
| | | |
| ([0-9]+[ ]+(hours|minutes|days) |
Unfortunately, most useful tools for generating static documentation from a swagger spec are no longer maintained or only support swagger's 2.0 format -- we are using the 3.0 format.
The only tool I could find was swagger-codegen, which is built in and requires dependencies in (gag) Java.
Codegen allows us to generate a single-page static document:
| # configuring our local server for auth via Google | |
| OIDCRedirectURI /example/redirect_uri | |
| OIDCCryptoPassphrase some-big-fancy-secret-passphrase | |
| OIDCProviderMetadataURL https://accounts.google.com/.well-known/openid-configuration | |
| # ensure the provider (Google in this case) gives us the user email | |
| OIDCScope "openid email" | |
| # credentials from the Google API console | |
| OIDCClientID 123456789012-somelonghashedid.apps.googleusercontent.com |
| ### Keybase proof | |
| I hereby claim: | |
| * I am evank on github. | |
| * I am evanskaufman (https://keybase.io/evanskaufman) on keybase. | |
| * I have a public key whose fingerprint is A841 C275 E509 6657 3814 0689 6508 E211 586F 8E5A | |
| To claim this, I am signing this object: |
| # -S key=value | |
| cap staging deploy -S branch=42-super-awesome-feature-branch |
| <phpunit> | |
| <testsuites> | |
| <testsuite name="Unit"> | |
| <directory>../src/*/Bundle/*Bundle/Tests</directory> | |
| <exclude>src/*/Bundle/*Bundle/Tests/Functional</exclude> | |
| </testsuite> | |
| </phpunit> |
| [user] | |
| email = you@yourprovider.com | |
| name = The name you want showing up in commits | |
| [core] | |
| editor = vi | |
| [push] | |
| default = current |
| # WHY would we need this? For a situation where loading File::Basename isn't possible | |
| # For example, in a BEGIN block, to tinker with @INC. | |
| sub basename { | |
| my $file = shift; | |
| $file =~ s!^(?:.*/)?(.+?)(?:\.[^.]*)?$!$1!; | |
| return $file; | |
| } | |
| sub dirname { |
| # remove the branch "branch-name" from the remote "origin" | |
| git push origin :branch-name |
| #!/bin/sh | |
| # 1. takes $0 (the currently running script) | |
| # 2. puts it through `readlink -f` to resolve any symlinks | |
| # 3. puts it through `dirname` to remove the filename | |
| working_dir=$(dirname $(readlink -f $0)) | |
| # so if i symlink a script from /home/ekaufman/myinit.sh to /etc/init.d/mything then even if I | |
| # execute /etc/init.d/mything, ${working_dir} will be "/home/ekaufman" |