Add selectors for submitting, submitSucceeded and submitFailed

docs/api/Selectors.md

@@ -17,7 +17,10 @@ import {
   isDirty,
   isPristine,
   isValid,
-  isInvalid
+  isInvalid,
+  isSubmitting,
+  hasSubmitSucceeded,
+  hasSubmitFailed
 } from 'redux-form'
 
 MyComponent = connect(
@@ -28,7 +31,10 @@ MyComponent = connect(
     dirty: isDirty('myForm')(state),
     pristine: isPristine('myForm')(state),
     valid: isValid('myForm')(state),
-    invalid: isInvalid('myForm')(state)
+    invalid: isInvalid('myForm')(state),
+    submitting: isSubmitting('myForm')(state),
+    submitSucceeded: hasSubmitSucceeded('myForm')(state),
+    submitFailed: hasSubmitFailed('myForm')(state)
   })
 )(MyComponent)
 ```
@@ -66,3 +72,15 @@ of `isInvalid`.
 
 > Returns `true` if the form is invalid, i.e. has sync, async, or submission errors. The opposite
 of `isValid`.
+
+### `isSubmitting(formName:String)` returns `(state) => submitting:boolean`
+
+> Returns `true` if the form is submitting.
+
+### `hasSubmitSucceeded(formName:String)` returns `(state) => submitSucceeded:boolean`
+
+> Returns `true` if the form has previously been successfully submitted.
+
+### `hasSubmitFailed(formName:String)` returns `(state) => submitFailed:boolean`
+
+> Returns `true` if the form has previously failed to submit.

src/createAll.js

@@ -12,6 +12,9 @@ import createIsDirty from './selectors/isDirty'
 import createIsInvalid from './selectors/isInvalid'
 import createIsPristine from './selectors/isPristine'
 import createIsValid from './selectors/isValid'
+import createIsSubmitting from './selectors/isSubmitting'
+import createHasSubmitSucceeded from './selectors/hasSubmitSucceeded'
+import createHasSubmitFailed from './selectors/hasSubmitFailed'
 import FormSection from './FormSection'
 import SubmissionError from './SubmissionError'
 import propTypes from './propTypes'
@@ -34,6 +37,9 @@ const createAll = structure => ({
   isInvalid: createIsInvalid(structure),
   isPristine: createIsPristine(structure),
   isValid: createIsValid(structure),
+  isSubmitting: createIsSubmitting(structure),
+  hasSubmitSucceeded: createHasSubmitSucceeded(structure),
+  hasSubmitFailed: createHasSubmitFailed(structure),
   propTypes,
   reduxForm: createReduxForm(structure),
   reducer: createReducer(structure),

src/immutable.js

@@ -29,6 +29,9 @@ export const {
   isInvalid,
   isPristine,
   isValid,
+  isSubmitting,
+  hasSubmitSucceeded,
+  hasSubmitFailed,
   propTypes,
   reducer,
   reduxForm,

src/index.js

@@ -31,6 +31,9 @@ export const {
   isInvalid,
   isPristine,
   isValid,
+  isSubmitting,
+  hasSubmitSucceeded,
+  hasSubmitFailed,
   propTypes,
   reducer,
   reduxForm,

src/selectors/__tests__/hasSubmitFailed.spec.js

@@ -0,0 +1,47 @@
+import createHasSubmitFailed from '../hasSubmitFailed'
+import plain from '../../structure/plain'
+import plainExpectations from '../../structure/plain/expectations'
+import immutable from '../../structure/immutable'
+import immutableExpectations from '../../structure/immutable/expectations'
+import addExpectations from '../../__tests__/addExpectations'
+
+const describeHasSubmitFailed = (name, structure, expect) => {
+  const hasSubmitFailed = createHasSubmitFailed(structure)
+
+  const { fromJS, getIn } = structure
+
+  describe(name, () => {
+    it('should return a function XXX', () => {
+      expect(hasSubmitFailed('foo')).toBeA('function')
+    })
+
+    it('should return false when value not present', () => {
+      expect(hasSubmitFailed('foo')(fromJS({
+        form: {}
+      }))).toBe(false)
+    })
+
+    it('should return true when submitting', () => {
+      expect(hasSubmitFailed('foo')(fromJS({
+        form: {
+          foo: {
+            submitFailed: true
+          }
+        }
+      }))).toBe(true)
+    })
+
+    it('should use getFormState if provided', () => {
+      expect(hasSubmitFailed('foo', state => getIn(state, 'someOtherSlice'))(fromJS({
+        someOtherSlice: {
+          foo: {
+            submitFailed: true
+          }
+        }
+      }))).toBe(true)
+    })
+  })
+}
+
+describeHasSubmitFailed('hasSubmitFailed.plain', plain, addExpectations(plainExpectations))
+describeHasSubmitFailed('hasSubmitFailed.immutable', immutable, addExpectations(immutableExpectations))

src/selectors/__tests__/hasSubmitSucceeded.spec.js

@@ -0,0 +1,47 @@
+import createHasSubmitSucceeded from '../hasSubmitSucceeded'
+import plain from '../../structure/plain'
+import plainExpectations from '../../structure/plain/expectations'
+import immutable from '../../structure/immutable'
+import immutableExpectations from '../../structure/immutable/expectations'
+import addExpectations from '../../__tests__/addExpectations'
+
+const describeHasSubmitSucceeded = (name, structure, expect) => {
+  const hasSubmitSucceeded = createHasSubmitSucceeded(structure)
+
+  const { fromJS, getIn } = structure
+
+  describe(name, () => {
+    it('should return a function XXX', () => {
+      expect(hasSubmitSucceeded('foo')).toBeA('function')
+    })
+
+    it('should return false when value not present', () => {
+      expect(hasSubmitSucceeded('foo')(fromJS({
+        form: {}
+      }))).toBe(false)
+    })
+
+    it('should return true when submitting', () => {
+      expect(hasSubmitSucceeded('foo')(fromJS({
+        form: {
+          foo: {
+            submitSucceeded: true
+          }
+        }
+      }))).toBe(true)
+    })
+
+    it('should use getFormState if provided', () => {
+      expect(hasSubmitSucceeded('foo', state => getIn(state, 'someOtherSlice'))(fromJS({
+        someOtherSlice: {
+          foo: {
+            submitSucceeded: true
+          }
+        }
+      }))).toBe(true)
+    })
+  })
+}
+
+describeHasSubmitSucceeded('hasSubmitSucceeded.plain', plain, addExpectations(plainExpectations))
+describeHasSubmitSucceeded('hasSubmitSucceeded.immutable', immutable, addExpectations(immutableExpectations))

src/selectors/__tests__/isSubmitting.spec.js

@@ -0,0 +1,47 @@
+import createIsSubmitting from '../isSubmitting'
+import plain from '../../structure/plain'
+import plainExpectations from '../../structure/plain/expectations'
+import immutable from '../../structure/immutable'
+import immutableExpectations from '../../structure/immutable/expectations'
+import addExpectations from '../../__tests__/addExpectations'
+
+const describeIsSubmitting = (name, structure, expect) => {
+  const isSubmitting = createIsSubmitting(structure)
+
+  const { fromJS, getIn } = structure
+
+  describe(name, () => {
+    it('should return a function XXX', () => {
+      expect(isSubmitting('foo')).toBeA('function')
+    })
+
+    it('should return false when value not present', () => {
+      expect(isSubmitting('foo')(fromJS({
+        form: {}
+      }))).toBe(false)
+    })
+
+    it('should return true when submitting', () => {
+      expect(isSubmitting('foo')(fromJS({
+        form: {
+          foo: {
+            submitting: true
+          }
+        }
+      }))).toBe(true)
+    })
+
+    it('should use getFormState if provided', () => {
+      expect(isSubmitting('foo', state => getIn(state, 'someOtherSlice'))(fromJS({
+        someOtherSlice: {
+          foo: {
+            submitting: true
+          }
+        }
+      }))).toBe(true)
+    })
+  })
+}
+
+describeIsSubmitting('isSubmitting.plain', plain, addExpectations(plainExpectations))
+describeIsSubmitting('isSubmitting.immutable', immutable, addExpectations(immutableExpectations))

src/selectors/hasSubmitFailed.js

@@ -0,0 +1,8 @@
+const createHasSubmitFailed = ({ getIn }) =>
+  (form, getFormState = state => getIn(state, 'form')) =>
+    state => {
+      const formState = getFormState(state)
+      return getIn(formState, `${form}.submitFailed`) || false
+    }
+
+export default createHasSubmitFailed

src/selectors/hasSubmitSucceeded.js

@@ -0,0 +1,8 @@
+const createHasSubmitSucceeded = ({ getIn }) =>
+  (form, getFormState = state => getIn(state, 'form')) =>
+    state => {
+      const formState = getFormState(state)
+      return getIn(formState, `${form}.submitSucceeded`) || false
+    }
+
+export default createHasSubmitSucceeded

src/selectors/isSubmitting.js

@@ -0,0 +1,8 @@
+const createIsSubmitting = ({ getIn }) =>
+  (form, getFormState = state => getIn(state, 'form')) =>
+    state => {
+      const formState = getFormState(state)
+      return getIn(formState, `${form}.submitting`) || false
+    }
+
+export default createIsSubmitting