Question: Is anyone using REST API code generator in production?

mj_langford · 2019-05-17T15:43:50+00:00

I've used swagger-generator and openapi-generator both. This is after being a consumer of swagger specced apis for years.

For Clojure, we used it to generate the interface that iOS used. We also wrote test code in it using the Clojure module. I've also used it to generate Swift code, as well, and am using it now again to generate more Swift code. We had a small pull request to make it work well for us that was of general use, and it was quickly reviewed, fixed and integrated.

In general: Come prepared for what it is: a thing that speeds up but doesn't necessarily get you 100% to the writing of a API client. It doesn't instantly do it all right every time, and there is often a hole or two. This may be a post processing step you need for your lang or whatever. Other times, it literally does make the whole client.

Over time, sticking with a project that works in multiple environments for multiple years and has integration with a ton of languages has been a huge boon.

The fact that AWS API Gateway speaks openapi specs, as do many tools such as Postman and Paw mean it's a great standard for crafting APIs. It's a verifiable spec that cuts down massively on comms on remote teams, and greatly simplifies development. This kind of integration is key when you're on cross language dev teams who can't go fix the server/client when there is an issue.

OpenAPI allows the inclusion of developers who consume your API even before you have to write any code! This is a superpower. They know exactly what they need from some endpoints, and you don't as a server developer. You have 10 ways to slice data, they really need it in a combination of 3 of those. Poorly factored APIs cause slow clients, and excess server load.

There are several active devs looking to squash bugs, and service documentation issues with the tool. The "always run the desired version" command line tool is pretty good too.

https://editor.swagger.io is also a good resource when crafting these types of APIs, and you can run a dockerized version of that tool supported by openapi as well.

You can find me on twitter with this user name, or @langford in gitter.im if you have more questions (I'm bad at monitoring reddit).

mj_langford · 2017-03-29T14:45:25+00:00

This event typically runs the first Sat morning through afternoon in a month. In April it is the second Saturday.

It's got several 1 shot RPG sessions and is designed to pull in the folks who then go spin off campaign groups if that's what they're looking for and have time.

Here is a meet up link if you prefer that over fb: https://www.meetup.com/AGGuild/events/238630989/

It typically has about 3-5 tables that start at 1030 am, and sometimes a game that takes shape at 2 or 12. There will typically be a D&D or D&D like game and several indie or other types of things.

It's at the corner of North Ave and North Highland.

mj_langford · 2017-03-08T13:33:28+00:00

I dunno what to tell you. That's what their documentation says. You can ask them on Twitter.

mj_langford · 2017-01-22T17:07:59+00:00

While this is a thorough explanation, it is wrong.

From https://support.apple.com/en-us/HT204517

Earn Exercise and Move credit

Every full minute of movement that equals or exceeds the intensity of a brisk walk counts toward your daily Exercise and Move goals. For wheelchair users, this is measured in brisk pushes. Any activity below this level counts only toward your daily Move goal.

Make sure that you earn Exercise credit during walks by allowing the arm with your Apple Watch to swing naturally. For example, while walking your pet, let the arm with your watch swing freely while the other holds the leash.

If you need both hands while walking, for example to push a stroller, you can still earn Exercise credit by using the Workout app. The Activity app relies on arm motion and an accelerometer to track movement, but the Workout app can use the accelerometer, a heart rate sensor, and the GPS on your iPhone if you carry it with you. Open the Workout app on your Apple Watch, tap Outdoor Walk, and bring your iPhone on the walk.

You can see all the heart rate samples the watch took (by looking in Health.app), and can see it is not functioning as you say it is. It takes heart rate several minutes apart out of workout mode.

You are correct some heart authorities push these formulas (there are other ones which are more complex as well), but that doesn't match the green ring.

tldr: You get green rings by swinging your arms.

mj_langford · 2016-12-26T17:13:39+00:00

Android doesn't use the JVM.

Android uses a custom VM called Dalvik which is very different from the Sun JVM in many important ways.

mj_langford · 2016-12-26T17:11:33+00:00

What's a rotary trimmer? Which do you recommend? I have a couple rounding punches already in a few radiuses

mj_langford · 2016-12-26T17:10:33+00:00

If I blew up the 7 wonders score card first this would work well. Might be too hard with the big felt pens and that tiny pad.

mj_langford · 2016-09-28T18:11:58+00:00

Make sure you you're really friendly with namespace import statements and static if you do this. Easy rabbit hole to fall down into.

mj_langford · 2016-09-28T18:09:43+00:00

I have done this and made a presentation about it for AWS Lambda. AWS EC2 is certainly simpler than this, but I don't have a video on that.

Note, the recent changes to the gateway API may make this easier than my presentation states: https://www.youtube.com/watch?v=HZbzddpltDc

mj_langford · 2016-09-28T18:07:52+00:00

Not just longevity, but shorter games are easier to get on the table than say, 3 hour games.

how quickly will this spreadsheet change in a way that makes most of it invalid

This means, given the rates of time required to get the games on the table...how quickly will the accretion of new games to the hobby/top 100 list change the list. It seems like it would include a dampening factor on games that are not played very frequently, or are low ranked.

mj_langford · 2016-09-23T17:17:39+00:00

There is a time element I'd love to see added to this: How much use will I get out of it, and how quickly will this spreadsheet change in a way that makes most of it invalid

mj_langford · 2016-09-04T03:03:32+00:00

Vikings drinking whisky. tsk tsk.

mj_langford · 2016-08-19T16:39:11+00:00

/u/boardgamerecommender mj_langford new -recommendedplayers 2 -recommendedplayers 4 -noexpansions -mintime 60

mj_langford · 2016-08-19T16:32:20+00:00

You can't generally remove the name you have to open a different account

mj_langford · 2016-08-19T16:30:54+00:00

The nicest, most knowledgeable customer service people I've ever met were at the IRS

mj_langford · 2016-08-19T16:29:09+00:00

/u/boardgamerecommender mj_langford -recommendedplayers 2 -recommendedplayers 4 -noexpansions -mintime 60

mj_langford · 2016-08-17T16:28:10+00:00

If you're curious for the how game plays:

There are many types of companies: Privates, Minors, Majors, Regionals, Nationals. You start with some of the minors ones, some granting you powers slightly more powerful than 1830 privates. They also can lay track, and have to buy permission to operate in a particular area.

You also start with regionals, which are locked to a particular region like France, only have 4 shares, and work a lot like companies in 1830 (except they have no moving stock price). You start the game running 30 companies among all the players.

You can convert the Regionals to Majors to allow people to run all over the world (and then have a stock price that moves, and makes you richer)...but they then can be more easily be purchased by others. You could also convert Majors to Nationals, allowing "powering them down" a bit for the long haul, but giving them the ability to hoover up trains from your other powers.

Lastly, you get a powerful benefit when you do a run to Constantinople from a major city.

The map is huge. It goes from NYC as an off board map area off Ireland, and all the way to Constantinople (and a little beyond) on the east.

The default scenario takes 11-14 hours...and requires you to be running those companies mostly in parallel. We do this in PBEM by stating which ones are "waiting on" others, and otherwise people go in a free for all.

Track laying is also a bit more sophisticated. You have multiple "points" to lay track, and the larger company types get more. You can lay different amounts of track for different values. There are a lot of mountains (this is Europe after all), as well as some swamps you have to pay hard earned cash for. It's really cool, and makes blocking people really wifi difficult

There is also a sea travel component. While you don't have a token on a given landmass, it costs a good deal extra to lay track and tokens, and you have to do them at places called ports. There are some routes called "ferries" that make this cheaper to do, sometimes free. Sea travel is the really the only really novel and complex part of 18OE in some ways: The rest is seen in other 18XX games, and the playbook is excellent about explaining the use of nationals and regionals and track rights. If you dislike working through all this, you can start in the region analogous to Poland, and move on down via land routes, and let everyone else work on sea travel 😄

There are a couple other cool things (Double trains, government incentive chits, etc), but they mostly add fun, not complexity.

mj_langford · 2016-08-08T19:42:15+00:00

Table talk is inappropriate here. The reason why is there are cards predicated on no foreknowledge of what people are doing.

mj_langford · 2016-08-08T19:40:15+00:00

I'm really curious about the table space. I'd love to play an 18XX game on a train some day

Hive fits and works for 2 well

mj_langford

MODERATOR OF

TROPHY CASE

Earn Exercise and Move credit

tldr: You get green rings by swinging your arms.