feat: omit objects with empty values

[n1ru4l]

Fixes #23

This is the quickest fix I could find

[janpio]

Isn't this a bit broad, possibly also removing stuff that should not be removed but fail as the param really should be there or the value really should be set?

We will definitely need some tests around this to be confident enough that this is working as intended I would say :/

[n1ru4l]

@janpio IMHO it does not make sense to set a value to null/undefined. And if the perpetrator intended to so he could simply set the value to "null" instead of null (or "undefined" instead of undefined.

However I can see your concern about breaking some stuff.

Maybe we could ship this with a option e.g. (dropNullAndUndefined: boolean)?

[n1ru4l]

@janpio I added some tests and fixed the implementation, also you will now have to pass dropUndefinedOrNull to writeSync, otherwise undefined and null values will be handled how they are atm

[janpio]

Having tests is great - thanks for making the changes.
I'll let someone with more JS experience review the actual code.

[brody4hire]

I am not a super expert with Xcode projects, will review the best I can.

I would favor renaming the option to something more meaningful, such as "dropFrameworksWithEmptyPath".

Otherwise it looks good, thanks for contributing the test cases as well.

[n1ru4l]

@brodybits dropFrameworksWithEmptyPath would be misleading because it changes the writer to drop more than just paths a.k.a every value that is null or undefined.

[brody4hire]

As I said I am not an Xcode expert so it would help if you could better explain the actual problem and proposed change in behavior.

I find "NullOrUndefined" to be a bit ugly for the exported API. Also "dropUndefinedOrNull" does not give me a clear idea of what it actually does.

[n1ru4l]

@brodybits Maybe dropUndefinedOrNullValues would be better 😅.

The problem is explained here: #23

My take on the solution is a broader approach, which not only works for the path "property".

In my opinion it makes sense to omit a key from "writing" that has undefined or null as a value instead of setting it to a stringified version of undefined or null.

I do not think that anyone who is currently using this library intends to set any property value to undefined or null. Nevertheless if anyone wants to achieve it he could simply set the value to String(undefined)" or String(null) (which has currently the same effect, like a described in my earlier comment).

However because I like the idea of having no breaking changes in patch/feature versions, I introduced the functionality to omit properties whose value is undefined or null behind an option that has to be enabled first.

Example:

Input Object:

const group = {
  name: "Frameworks",
  path: undefined,
  someOtherKey: null,
  foo: String(undefined),
  bar: String(null)
}

Result without option disabled/current master:

8E63D5C4EFE34B3BAE93815F /* Frameworks */ = {
			name = Frameworks;
			path = undefined;
			someOtherKey = null;
			foo = undefined; 
			bar = null; 
		};

Result with option enabled:

8E63D5C4EFE34B3BAE93815F /* Frameworks */ = {
			name = Frameworks;
			foo = undefined; 
			bar = null;
		};

If you come up with a better name I will rename the option.

Here are some of my suggestions:

• dropUndefinedOrNull
• dropUndefinedOrNullValues
• omitEmptyValues

[brody4hire]

I would probably favor omitEmptyValues.

[n1ru4l]

@brodybits Done.

[dpogue]

👍 from me

[hayouni]

for the file cordova-node-xcode/lib/pbxProject.js
in the function pbxProject.prototype.addBuildPhase:
we miss 2 parameter in the buildPhase object:
buildPhase = {
isa: buildPhaseType,
buildActionMask: 2147483647,
files: [],
inputFileListPaths: [],
outputFileListPaths: [],
runOnlyForDeploymentPostprocessing: 0
}
can you fix this please i'm stuck here, help help ...... 😄